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

[Chisanan232]

Description

Reworks the Python SDK Quick Start into a complete, illustrated, end-to-end
walkthrough, and removes the separate "Start Here — Golden Path" page added
earlier in this PR (its intent now lives inside the Quick Start).

The Quick Start is now one guided arc:

1. Install the SDK and confirm the version.
2. Start the governance runtime — the published
   ghcr.io/ai-agent-assembly/aa-runtime:v0.0.1-rc.6 sidecar enforcing a local
   policy.toml.
3. Connect and register the agent with init_assembly() (and the underlying
   RuntimeClient.connect/register).
4. Govern a tool call — the same call shown allowed, denied, and
   held for approval via query_policy(), and how a framework adapter raises
   ToolExecutionBlockedError on deny.
5. Interpret the outcome through the real exception hierarchy.
6. Observe the agent — real light/dark Fleet and Audit Log dashboard
   screenshots (the audit shot shows a policy deny).
7. Tune a policy and re-run (plus enforcement_mode="observe" dry-run).
8. Explore framework examples — the CI-generated framework-tabs block,
   preserved verbatim.

rc6 accuracy fixes (AAASM-4987 / AAASM-4988)

• Every import is a real published symbol verified against
  agent-assembly==0.0.1rc6 in a scratch venv: init_assembly, RuntimeClient
  (connect / register / query_policy), ToolExecutionBlockedError,
  PolicyError, MCPToolBlockedError, and PolicyViolationError (imported from
  agent_assembly.exceptions, since it is not re-exported at top level). No
  more LocalPolicyEngine / top-level PolicyViolationError ImportError traps.
• The deployment wiring is the real, verified limited-function self-host path:
  the published aa-runtime image enforcing a local policy.toml
  (blocked_actions → deny, requires_approval_actions → pending), with an
  honest note that the central gateway brain, populated data API, and dashboard
  data are SaaS-only.
• All version references point at 0.0.1rc6.

Type of Change

• 📚 Documentation update

Breaking Changes

• No

Related Issues

• Related JIRA ticket: AAASM-5016

Testing

• mkdocs build --strict passes in an isolated venv (imports, internal links,
  and both dashboard images resolve).
• Quick-start framework-tabs drift check green
  (scripts/generate_quickstart_tabs.py reports "Up to date").
• No tests required — docs-only change.

Checklist

• Code follows project style guidelines
• Self-review completed
• Documentation updated if needed
• All checks passing (strict docs build + tabs drift)

[Chisanan232]

📸 Added the operator dashboard Overview screenshot (light + dark) at the register/connect step — showing the agent appears the moment it registers (fleet count ticks up, three-layer posture goes live). Real dashboard UI, sample fixture data, captured via the dashboard's own 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 single-node team clusters wrap the budget-bar label over the cluster title. Not embedding a garbled image. mkdocs build --strict green; new images resolve.

[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. — mkdocs build --strict 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.

[Chisanan232]

🤖 Claude Code — PR review

CI: ✅ All green — Build documentation (PR, no deploy), Quick-start Tabs Drift Check, CodeQL all SUCCESS. No CodeCov/SonarCloud checks configured on this docs PR (docs-only; N/A). mergeStateStatus: BLOCKED is REVIEW_REQUIRED only (≥1 Pioneer approval), not a CI problem.

Scope (AAASM-5016): ✅ Matches. docs/quick-start.md is the reworked complete arc — install → start aa-runtime sidecar → connect/register (init_assembly / RuntimeClient.connect/register) → govern a tool call (allow / deny / hold-for-approval via query_policy, adapter ToolExecutionBlockedError) → interpret errors → observe (light/dark Overview + Fleet + Topology + Audit screenshots, audit shows a deny) → tune + enforcement_mode="observe" → framework examples. No separate "Golden Path" page against base (added+removed within the PR). Every import is a real rc.6 symbol (init_assembly, RuntimeClient, query_policy, ToolExecutionBlockedError, PolicyViolationError/MCPToolBlockedError/PolicyError/GatewayError from agent_assembly) — no LocalPolicyEngine / ImportError trap.

Side-effects: ✅ Docs + PNG assets only (docs/quick-start.md + 8 real PNGs 80–140 KB under docs/images/dashboard/). No code/build behavior changed. Image paths (images/dashboard/*.png#only-light/dark) resolve — strict mkdocs build is green in CI.

FE: N/A — static PNGs embedded in a docs page, not app front-end → Playwright N/A.

Verdict: READY — pending Pioneer approval.