completion-coverage-matrix-v1.md

Completion Coverage Matrix v1 (Workspace Binaries)

Policy notes

• Inventory source of truth: bash scripts/workspace-bins.sh.
• Obligation rule for this matrix: all workspace binaries are required unless explicitly excluded as internal/example binaries.
• Explicit exclusion: cli-template is excluded because it is an example/template CLI and is out of scope for user-facing release contract migration (docs/plans/repo-completion-standard-rollout-plan.md).
• Explicit treatment: image-processing is required (user-facing CLI in README.md) and must ship clap-first thin completion adapters in both shells.
• Alias policy: alias families are required only for git-scope (gs*), git-cli (gx*), codex-cli (cx*), and fzf-cli (fx*) per AGENTS.md; other binaries have no alias requirement.
• Completion quality baseline for every required binary: subcommands + long/short flags + declared value candidates.
• Completion quality baseline for every required binary also requires context-aware filtering by cursor position (not global candidate dumps).
• Preferred implementation mode for every required binary: clap-first (clap + clap_complete) generated baseline completions, with thin shell adapters and optional dynamic value extensions only when needed.
• Runtime completion-mode toggles are not supported; adapters must stay clap-first and fail closed when generated completion cannot be loaded.
• Completion enforcement metadata is required for every required binary and must use: completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed.
• This matrix currently tracks asset coverage, obligation decisions, and completion enforcement metadata; deeper quality/export-command conformance is validated in rollout sprints and completion tests.

Matrix

Binary	Obligation	Zsh completion (completions/zsh)	Bash completion (completions/bash)	Alias requirement	Completion enforcement metadata	Rationale
agent-docs	required	present (_agent-docs)	present (agent-docs)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
api-gql	required	present (_api-gql)	present (api-gql)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
api-grpc	required	present (_api-grpc)	present (api-grpc)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
api-rest	required	present (_api-rest)	present (api-rest)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
api-test	required	present (_api-test)	present (api-test)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
api-websocket	required	present (_api-websocket)	present (api-websocket)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
cli-template	excluded	missing	missing	not required	not required (excluded)	Explicitly treated as internal/example template CLI and out of scope for user-facing release contract migration.
codex-cli	required	present (_codex-cli)	present (codex-cli)	required (cx*) and present in aliases.zsh + aliases.bash	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Alias family is mandated by policy; completion files exist in both shell directories.
fzf-cli	required	present (_fzf-cli)	present (fzf-cli)	required (fx*) and present in aliases.zsh + aliases.bash	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Alias family is mandated by policy; completion files exist in both shell directories.
gemini-cli	required	present (_gemini-cli)	present (gemini-cli)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
git-cli	required	present (_git-cli)	present (git-cli)	required (gx*) and present in aliases.zsh + aliases.bash	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Alias family is mandated by policy; completion files exist in both shell directories.
git-lock	required	present (_git-lock)	present (git-lock)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
git-scope	required	present (_git-scope)	present (git-scope)	required (gs*) and present in aliases.zsh + aliases.bash	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Alias family is mandated by policy; completion files exist in both shell directories.
git-summary	required	present (_git-summary)	present (git-summary)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
image-processing	required	present (_image-processing)	present (image-processing)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Explicitly treated as a user-facing CLI (not internal/example); completion is exported by image-processing completion <bash|zsh> and loaded through thin fail-closed shell adapters.
macos-agent	required	present (_macos-agent)	present (macos-agent)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
memo-cli	required	present (_memo-cli)	present (memo-cli)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
plan-issue	required	present (_plan-issue)	present (plan-issue)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Rust orchestration CLI entrypoint; completion is exported by plan-issue completion <bash|zsh> and loaded through thin fail-closed shell adapters.
plan-issue-local	required	present (_plan-issue-local)	present (plan-issue-local)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Local rehearsal binary paired with plan-issue; completion is exported by plan-issue-local completion <bash|zsh> and loaded through thin fail-closed shell adapters.
plan-tooling	required	present (_plan-tooling)	present (plan-tooling)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
screen-record	required	present (_screen-record)	present (screen-record)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.
semantic-commit	required	present (_semantic-commit)	present (semantic-commit)	not required	completion_mode=clap-first; completion_mode_toggles=forbidden; alternate_completion_dispatch=forbidden; generated_load_failure=fail-closed	Workspace binary; completion files exist in both shell directories.

Exclusion summary

• excluded: cli-template (explicit staged exclusion).
• No other workspace binary is excluded in this matrix.