Tier Gira command discovery and simplify advanced orchestration entry points

[StatPan]

Goal

Reduce command-selection cost while preserving compatibility and agent handoff capabilities.

Scope

• Define command tiers for Assist, Managed Delivery, and Advanced Orchestration in registry, help, and guides.
• Make ticket handoff the single-issue agent entry point and dispatch goal the Goal-level entry point.
• Identify compatibility aliases and planner-engine mixed-state diagnostics without deleting existing commands.
• Add command-surface and user-journey regression coverage.

Non-goals

• Do not remove compatibility commands in this ticket.
• Do not redesign PM data structures or add a hosted UI.

Acceptance Criteria

• Default help and guide clearly separate daily Assist/Managed work from advanced Goal, Queue, and PM operations.
• Advanced entry points and compatibility paths are explicitly labelled.
• Goal status makes planning-engine mixed state visible, or the limitation is documented with a tracked follow-up.
• Human and agent golden paths are documented and covered by tests where applicable.

Doctor Impact

No doctor rule changes are expected; command discovery and documentation must retain existing doctor access.

Expected Delivery

• One focused documentation/CLI metadata PR with tests where available.

Verification

• Focused Go and documentation tests plus go test ./... before PR.

base_branch: main
base_source: branch_policy.repo_local_contract.default
branch_policy_mode: github-flow
target: default
work_branch: issue/937-tier-gira-command-discovery-and-simplify-advanced-orchestration-entry-points
work_branch_source: generated