feat: Add opt-in visual portfolio report for milestones, timeline, and work queues

[StatPan]

Closes #871

[StatPan]

Check

Visual QA: generated the self-contained report from live StatPan/gira state; inspected full-page Chromium screenshots at 1280x1000 and 390x844. Mobile overflow found during review was fixed. Final DOM smoke: horizontal overflow=false at both widths; first Tab focuses the skip link; one h1, five labelled sections, and milestone progressbar has accessible name/value. Local artifact and screenshots remained under /tmp and were not published.

Context:

• Ticket: Add opt-in visual portfolio report for milestones, timeline, and work queues #871
• Status: In review
• Linked PR: feat: Add opt-in visual portfolio report for milestones, timeline, and work queues #888
• Blockers: checks_pending
• Next: wait for required checks to finish or fix failing checks

[StatPan]

Check

Self-review packet for ticket #871 and PR #888.

• PR readiness: ready_for_finish
• Finish ready: true
• Diff summary: 10 files changed, +922/-0
  • README.md: +7/-0
  • docs-site/command-capabilities.md: +1/-0
  • docs-site/command-reference.md: +30/-0
  • docs/visual-portfolio-report.md: +61/-0
  • internal/cli/cli.go: +66/-0
  • internal/cli/cli_test.go: +58/-0
  • internal/gira/command_registry.go: +20/-0
  • internal/gira/testdata/visual_portfolio_report.golden.sha256: +1/-0
  • internal/gira/visual_portfolio_report.go: +539/-0
  • internal/gira/visual_portfolio_report_test.go: +139/-0
• Acceptance mapping candidates:
  • One documented read-only command can render a self-contained local HTML overview from stable Gira/GitHub state. -> README.md, docs-site/command-capabilities.md, docs-site/command-reference.md, internal/gira/command_registry.go, internal/gira/testdata/visual_portfolio_report.golden.sha256, internal/gira/visual_portfolio_report.go, internal/gira/visual_portfolio_report_test.go
  • The page includes milestone progress, timeline/gates, and blocked/review queue sections; it remains useful when one section has no data. -> internal/gira/testdata/visual_portfolio_report.golden.sha256
  • Every progress numerator/denominator and date is traceable to a named source contract and has documented semantics. -> manual verification required
  • Missing dates, unavailable outcome evidence, and partial repository access are shown as unknown/unsupported rather than inferred. -> manual verification required
  • Generation performs no GitHub mutation and never publishes, uploads, serves, or opens the artifact implicitly. -> manual verification required
  • Repository, milestone, and time-window filters are explicit and deterministic. -> manual verification required
  • Golden HTML/fixture tests, visual smoke evidence, keyboard/accessibility checks, and large-repository size/runtime budgets pass. -> docs/visual-portfolio-report.md, internal/gira/testdata/visual_portfolio_report.golden.sha256, internal/gira/visual_portfolio_report.go, internal/gira/visual_portfolio_report_test.go
  • Existing text/JSON/CSV reports remain compatible and continue to work without the visual renderer. -> docs/visual-portfolio-report.md, internal/gira/testdata/visual_portfolio_report.golden.sha256, internal/gira/visual_portfolio_report.go, internal/gira/visual_portfolio_report_test.go
• Risk areas: Go runtime code changed, documentation changed
• Full diff: gh pr diff 888 --repo StatPan/gira

Reviewer notes:

• Findings: none recorded by this self-review command.
• Test gaps: verify local and CI evidence before finish.
• Recommended action: continue normal review/check/finish flow.

Context:

• Ticket: Add opt-in visual portfolio report for milestones, timeline, and work queues #871
• Status: In review
• Linked PR: feat: Add opt-in visual portfolio report for milestones, timeline, and work queues #888
• Blockers: none
• Next: merge when policy checks pass