[AAASM-5016] 📝 (docs): improve Quick Start — complete end-to-end + dashboard screenshots

[Chisanan232]

What & why

Reworks the node-sdk Quick Start into a complete, honest, illustrated
end-to-end walkthrough and removes the separate "Start Here / Golden Path"
page added earlier in this PR (its arc is folded into the Quick Start).

The Quick Start is now one guided arc: install → connect → allow → deny →
approval → interpret errors → observe (dashboard screenshots) → tune a policy
and re-run → examples → done.

Applied to both the unversioned source (docs/02-quick-start/) and the
served rc.6 snapshot (website/versioned_docs/version-0.0.1-rc.6/02-quick-start/)
so the live rc.6 site (docs.agent-assembly.com/node-sdk/quick-start/) updates.

rc.6 accuracy fixes (verified against published artifacts)

Verified against @agent-assembly/sdk@0.0.1-rc.6 (npm) and
ghcr.io/ai-agent-assembly/aa-gateway:v0.0.1-rc.6 (loaded both schemas):

• AAASM-4991 — default mode governs nothing. Documented that real
  enforcement requires mode: "napi-inprocess" and enforcementMode: "enforce"; the default mode: "auto" routes through an allow-all no-op
  client and never denies.
• AAASM-4992 — gatewayUrl is overloaded. Documented that in
  napi-inprocess mode it is the aa-runtime UDS socket path
  (/tmp/aa-runtime-<agentId>.sock, or AA_RUNTIME_SOCKET), not an http URL;
  registration uses AA_GATEWAY_ENDPOINT (default 127.0.0.1:50051).
• AAASM-4996 — policy schema. Replaced the rejected rule-list example with
  the real section-based schema. Verified: the rule-list shape is refused by
  the rc.6 gateway (unsupported rule-list policy schema (top-level 'rules:'));
  the section-based document loads cleanly and the gRPC server starts.
• Install pins @0.0.1-rc.6 and warns that the latest dist-tag is stale
  (currently rc.5).

Dashboard screenshots (OBSERVE step)

Embedded the real fleet + audit dashboard captures via Docusaurus ThemedImage
(light + dark), served from website/static/img/dashboard/ (shared by both the
unversioned and versioned pages). Honest captions/alt text; the audit shot's top
row is a policy deny.

Honesty / product-blocked step

• AAASM-4997 — approvals not exercisable in Node at rc.6. The page states
  plainly that the Node SDK has no approval channel yet, so a
  requires_approval tool fail-closes to a deny under enforce. No fake
  pending/approved flow is shown.

How to verify

• cd website && pnpm install --ignore-workspace && pnpm build — build succeeds;
  onBrokenLinks: "throw" validated all links/anchors and the four themed images
  resolve into build/img/dashboard/.
• Generated blocks unchanged: node ./scripts/generate-docs-metadata.mjs reports
  "no generated blocks required rewriting" (drift check green).

Jira

https://lightning-dust-mite.atlassian.net/browse/AAASM-5016

Closes AAASM-5016

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

[Chisanan232]

📸 Added the operator dashboard Overview screenshot (ThemedImage light + dark) at the register step in both the current docs/02-quick-start and the version-0.0.1-rc.6 versioned quick start — showing the agent appears the moment it registers. Real dashboard UI, sample fixture data (dashboard Playwright + fixture harness).

Topology was retried with a cleaner fixture but dropped — the graph has no D3 collision force, so intra-team nodes overlap and narrow single-node clusters wrap the budget-bar label over the cluster title. Not embedding a garbled image.

pnpm build (Docusaurus) green; overview images resolve on both pages.

[Chisanan232]

Pushed a new commit to this branch adding the operator dashboard Topology view (light + dark) at the observe step, alongside the existing Fleet/Audit shots. The screenshots were captured from the real dashboard UI after the topology node-overlap fix (AAASM-5018, agent-assembly PR #1647) — same fixture-harness pattern (fixed 1440×900, both themes, sample two-team fixture). Docs build verified locally. Not merging. Added to both the unversioned docs/02-quick-start/ and the version-0.0.1-rc.6 snapshot. Docusaurus pnpm build passes.

[Chisanan232]

Refreshed the Topology screenshot (topology-light.png / topology-dark.png, same paths) to the new edges view — the graph now draws the relationships between agents (per-kind delegation/call arrows plus curved cross-team connectors), landed in agent-assembly PR #1648 (AAASM-5019, the design-fidelity gap). Re-captured at 1440×900 in both themes via the fixture harness. Docs build verified locally after the swap. Image-only change; no text edits.

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[Chisanan232]

🤖 Claude Code — PR review

CI: ✅ All green — full test-matrix (18/20/22/24 × ubuntu/macos/windows), napi-build, publish-docs build, pre-commit, module smoke, SonarCloud Code Analysis SUCCESS, codecov/patch SUCCESS. mergeStateStatus: BLOCKED = REVIEW_REQUIRED only, not CI.

Scope (AAASM-5016): ✅ Matches. docs/02-quick-start/index.md (+ the rc.6 versioned snapshot) is the reworked arc — install → connect → allow → deny → approval → interpret errors → observe (ThemedImage light/dark Overview/Fleet/Topology/Audit) → tune + enforcementMode: "observe" → examples. No separate Golden Path page against base. Honest rc.6 accuracy: default mode: "auto" is an allow-all no-op; real enforcement needs mode: "napi-inprocess" + enforcementMode: "enforce"; gatewayUrl overloading documented; section-based policy schema (rule-list refused); requires_approval fail-closes to deny (no fake pending flow).

Side-effects: ✅ Docs + 8 real PNGs (website/static/img/dashboard/) only. No source/build change. Themed images resolve via useBaseUrl — pnpm build with onBrokenLinks: throw is green in CI.

FE: N/A — static PNGs in a Docusaurus page, not app FE → Playwright N/A.

Verdict: READY — pending Pioneer approval.