Repository navigation
Organize command-surface and context roadmap governance - #594
Merged
Merged
Conversation
Audit all 1,866 pre-change pm items and 30,491 history events across every lifecycle status, then record current hierarchy, dedupe, graph, scale, SDK-first, immutable-history, and context-algorithm evidence on the canonical roadmap lineages.\n\nAdd pm-szdc as the single duplicate-checked gap for hiding runtime completion helper entrypoints from default agent discovery while preserving completion functionality, with linked files, docs, tests, dependencies, and isolated 125-test evidence.\n\nKeep the future execution sequence explicit across CLI grammar simplification, SDK-only universality, million-item context, digital-twin proof, and append-only audit guarantees.
![sourcery-ai[bot]](https://avatars.githubusercontent.com/in/48477?s=60&v=4){kind=small}
|
Warning Review limit reached
Next review available in: 50 minutes Enable usage-based reviews in Billing to review now. Otherwise, wait until the next included review is available. How can I continue?After more reviews become available, a review can be triggered using the To avoid repeated limits, reduce automatic review volume by pausing incremental auto-reviews earlier, using label-based review opt-in, excluding WIP or generated PR titles, or requesting reviews manually when the PR is ready. If your team needs uninterrupted high-volume reviews, an organization admin can enable usage-based reviews. How do review limits work?CodeRabbit enforces per-developer PR review limits for each organization. Most developers receive the normal plan review availability. For paid Pro and Pro+ PR reviews, CodeRabbit uses adaptive limits for sustained high-volume activity. When a developer's recent PR review activity reaches the 95th percentile or higher among CodeRabbit users, additional reviews become available more gradually as earlier reviews age out of the rolling window. Please refer docs for additional details. Review details⚙️ Run configurationConfiguration used: Repository UI (base), Organization UI (inherited) Review profile: ASSERTIVE Plan: Pro Run ID: 📒 Files selected for processing (3)
📝 WalkthroughWalkthroughThe change refreshes PM tracker timestamps and governance histories, adds roadmap and validation evidence, and introduces task ChangesTracker governance and planning
Estimated code review effort: 2 (Simple) | ~10 minutes 🚥 Pre-merge checks | ✅ 5✅ Passed checks (5 passed)
Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
Record the publication URL on the living milestone and focused completion-helper item, then revalidate changelog and immutable-history integrity on the updated tracker head.
unbraind
marked this pull request as ready for review
July 18, 2026 14:18
Owner
Author
|
@codex review /gemini review @gemini-code-assist review Please review the current head for tracker integrity, duplicate safety, roadmap organization, correctness of stated evidence, accidental private/sensitive content, and any actionable issue. |
|
To use Codex here, create a Codex account and connect to github. |
Merging this PR will degrade performance by 0.02%
|
| Benchmark | BASE |
HEAD |
Efficiency | |
|---|---|---|---|---|
| ❌ | createQueryFingerprint |
514.7 µs | 516.2 µs | -0.28% |
| ❌ | encodeQueryCursor |
101 µs | 101.1 µs | -0.03% |
| ❌ | build index (2000 docs x 80 words) |
161.4 ms | 161.4 ms | -0.03% |
| ❌ | tokenize + score query over 2000 docs |
7.5 ms | 7.5 ms | -0.02% |
| ❌ | stableStringify (nested contract) |
161.2 µs | 161.3 µs | -0.01% |
| ⚡ | decodeQueryCursor |
115.9 µs | 115.8 µs | +0.04% |
| ⚡ | jaccardSimilarity |
153.3 µs | 153.3 µs | +0.03% |
| ⚡ | normalizeLowercaseWhitespace |
135.8 µs | 135.8 µs | +0.02% |
| ⚡ | build index (200 docs x 40 words) |
8.4 ms | 8.4 ms | +0.02% |
| ⚡ | tokenizeAlphaNumeric |
367.3 µs | 367.3 µs | +0.01% |
| ⚡ | score query over 2000 docs |
5.6 ms | 5.6 ms | 0% |
Tip
Investigate this regression by commenting @codspeedbot fix this regression on this PR, or directly use the CodSpeed MCP with your agent.
Comparing agent/command-surface-context-roadmap-governance (060fa04) with main (3baca0a)
![gemini-code-assist[bot]](https://avatars.githubusercontent.com/in/956858?s=60&v=4){kind=small}
There was a problem hiding this comment.
Code Review
This pull request introduces a new task, pm-szdc, aimed at hiding runtime completion helper entrypoints from the default agent-facing command surface, updating several .toon files, history streams, and managed extensions. The review feedback correctly identifies critical syntax errors in the newly added history file .agents/pm/history/pm-szdc.jsonl on lines 1 and 10, where literal unescaped newlines are present within JSON string values, violating standard JSON syntax and the single-line requirement of the JSONL format.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
| @@ -0,0 +1,11 @@ | |||
| {"ts":"2026-07-18T14:04:52.766Z","author":"codex-ecosystem-planner","op":"create","patch":[{"op":"replace","path":"/body","value":"## Problem\\nThe default root help currently advertises three runtime data providers as if agents should invoke them directly: completion-statuses, completion-tags, and completion-types. This adds three nouns to the discovery surface without adding user capability.\\n\\n## Desired design\\nTreat these entrypoints like internal completion plumbing. The public # bash completion for pm\n# Source this file or add 'eval \"$(pm completion bash)\"' to ~/.bashrc\n\n_pm_completion_type_choices() {\n local now ttl cache_ts resolved\n now=\"$(date +%s 2>/dev/null || echo 0)\"\n ttl=\"${PM_COMPLETION_TYPE_TTL:-120}\"\n cache_ts=\"${PM_COMPLETION_TYPE_CACHE_TS:-0}\"\n if [[ -n \"${PM_COMPLETION_TYPE_CACHE:-}\" && \"$now\" -ne 0 && $((now - cache_ts)) -lt \"$ttl\" ]]; then\n printf '%s\\n' \"$PM_COMPLETION_TYPE_CACHE\"\n return 0\n fi\n resolved=\"$(pm completion-types 2>/dev/null)\"\n if [[ -z \"$resolved\" ]]; then\n resolved=\"Chore Decision Epic Event Feature Issue Meeting Milestone Plan Reminder Story Task\"\n fi\n PM_COMPLETION_TYPE_CACHE=\"$resolved\"\n PM_COMPLETION_TYPE_CACHE_TS=\"$now\"\n printf '%s\\n' \"$PM_COMPLETION_TYPE_CACHE\"\n}\n\n_pm_completion_status_choices() {\n local now ttl cache_ts resolved\n now=\"$(date +%s 2>/dev/null || echo 0)\"\n ttl=\"${PM_COMPLETION_STATUS_TTL:-120}\"\n cache_ts=\"${PM_COMPLETION_STATUS_CACHE_TS:-0}\"\n if [[ -n \"${PM_COMPLETION_STATUS_CACHE:-}\" && \"$now\" -ne 0 && $((now - cache_ts)) -lt \"$ttl\" ]]; then\n printf '%s\\n' \"$PM_COMPLETION_STATUS_CACHE\"\n return 0\n fi\n resolved=\"$(pm completion-statuses 2>/dev/null)\"\n if [[ -z \"$resolved\" ]]; then\n resolved=\"blocked canceled closed draft in_progress open\"\n fi\n PM_COMPLETION_STATUS_CACHE=\"$resolved\"\n PM_COMPLETION_STATUS_CACHE_TS=\"$now\"\n printf '%s\\n' \"$PM_COMPLETION_STATUS_CACHE\"\n}\n\n_pm_completion() {\n local cur prev words cword\n _init_completion 2>/dev/null || {\n cur=\"${COMP_WORDS[COMP_CWORD]}\"\n prev=\"${COMP_WORDS[COMP_CWORD-1]}\"\n cword=$COMP_CWORD\n }\n\n if [[ $cword -eq 1 ]]; then\n COMPREPLY=($(compgen -W \"init config extension package packages install upgrade create copy focus list list-all list-draft list-open list-in-progress list-blocked list-closed list-canceled aggregate context ctx get graph search eval next history history-redact history-repair history-compact schema profile activity restore update update-many close close-many delete append comments notes learnings files docs deps plan test test-all telemetry stats health validate gc contracts claim release start-task pause-task close-task meet event remind help\" -- \"$cur\"))\n return 0\n fi\n\n if [[ \"$prev\" == \"--type\" ]]; then\n COMPREPLY=($(compgen -W \"$(_pm_completion_type_choices)\" -- \"$cur\"))\n return 0\n fi\n\n if [[ \"$prev\" == \"--status\" ]]; then\n COMPREPLY=($(compgen -W \"$(_pm_completion_status_choices)\" -- \"$cur\"))\n return 0\n fi\n\n if [[ \"$prev\" == \"--tag\" || \"$prev\" == \"--tags\" ]]; then\n local now ttl cache_ts tag_values\n now=\"$(date +%s 2>/dev/null || echo 0)\"\n ttl=\"${PM_COMPLETION_TAG_TTL:-120}\"\n cache_ts=\"${PM_COMPLETION_TAG_CACHE_TS:-0}\"\n tag_values=\"${PM_COMPLETION_TAG_CACHE:-}\"\n if [[ -z \"$tag_values\" || \"$now\" -eq 0 || $((now - cache_ts)) -ge \"$ttl\" ]]; then\n tag_values=\"$(pm completion-tags 2>/dev/null)\"\n PM_COMPLETION_TAG_CACHE=\"$tag_values\"\n PM_COMPLETION_TAG_CACHE_TS=\"$now\"\n fi\n COMPREPLY=($(compgen -W \"$tag_values\" -- \"$cur\"))\n return 0\n fi\n\n local cmd=\"${COMP_WORDS[1]}\"\n\n case \"$cmd\" in\n list|list-all|list-draft|list-open|list-in-progress|list-blocked|list-closed|list-canceled)\n COMPREPLY=($(compgen -W \"--after --all --assignee --assignee_filter --assignee-filter --author --brief --compact --created-after --created-before --deadline-after --deadline-before --empty-body --fields --filter-ac-missing --filter-confidence-missing --filter-docs-missing --filter-estimate-missing --filter-estimates-missing --filter-files-missing --filter-metadata-missing --filter-release-missing --filter-resolution-missing --filter-reviewer-missing --filter-risk-missing --filter-sprint-missing --format --full --has-body --has-comments --has-deps --has-docs --has-files --has-learnings --has-linked-command --has-notes --has-tests --help --id-only --ids --include-body --json --limit --no-changed-fields --no-comments --no-deps --no-docs --no-extensions --no-files --no-learnings --no-linked-command --no-notes --no-pager --no-tests --no-truncate --offset --order --parent --path --pm-path --priority --profile --quiet --recent --release --sort --sprint --status --stream --tag --tags --today --tree --tree_depth --tree-depth --type --updated-after --updated-before\" -- \"$cur\"))\n ;;\n aggregate)\n COMPREPLY=($(compgen -W \"--group-by --count --completion --sum --avg --include-unparented --include_unparented --status --type --tag --priority --deadline-before --deadline-after --assignee --assignee-filter --assignee_filter --parent --sprint --release --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n create)\n COMPREPLY=($(compgen -W \"--ac --acceptance_criteria --acceptance-criteria --actual --actual_result --actual-result --add_tags --add-tags --affected_version --affected-version --allow-missing-parent --assignee --author --blocked_by --blocked_reason --blocked-by --blocked-reason --body --body-file --clear-comments --clear-deps --clear-docs --clear-events --clear-files --clear-learnings --clear-notes --clear-reminders --clear-tests --clear-type-options --comment --component --confidence --create_mode --create-mode --customer_impact --customer-impact --deadline --definition_of_ready --definition-of-ready --dep --description --doc --environment --estimate --estimated_minutes --estimated-minutes --event --expected --expected_result --expected-result --field --file --fixed_version --fixed-version --goal --help --id --id-only --impact --json --learning --message --no-changed-fields --no-extensions --no-pager --note --objective --order --outcome --parent --path --pm-path --priority --profile --quiet --rank --regression --release --reminder --reporter --repro_steps --repro-steps --resolution --reviewer --risk --schedule_preset --schedule-preset --severity --sprint --status --tag --tags --template --test --title --type --type_option --type-option --unblock_note --unblock-note --unset --value --why_now --why-now -b -d -p -s -t\" -- \"$cur\"))\n ;;\n copy)\n COMPREPLY=($(compgen -W \"--title --author --message --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n focus)\n COMPREPLY=($(compgen -W \"--clear --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n update)\n COMPREPLY=($(compgen -W \"--ac --acceptance_criteria --acceptance-criteria --actual --actual_result --actual-result --add_tags --add-tags --affected_version --affected-version --assignee --author --blocked_by --blocked_reason --blocked-by --blocked-reason --body --body-file --clear-comments --clear-deps --clear-docs --clear-events --clear-files --clear-learnings --clear-notes --clear-reminders --clear-tests --clear-type-options --close_reason --close-reason --comment --component --confidence --customer_impact --customer-impact --deadline --definition_of_ready --definition-of-ready --dep --dep_remove --dep-remove --description --doc --environment --estimate --estimated_minutes --estimated-minutes --event --expected --expected_result --expected-result --field --file --fixed_version --fixed-version --force --goal --help --id-only --impact --json --learning --message --no-changed-fields --no-extensions --no-pager --note --objective --order --outcome --parent --path --pm-path --priority --profile --quiet --rank --regression --release --reminder --remove_tags --remove-tags --replace-deps --replace-tests --reporter --repro_steps --repro-steps --resolution --reviewer --risk --severity --sprint --status --tag --tags --test --title --type --type_option --type-option --unblock_note --unblock-note --unset --value --why_now --why-now -b -d -p -s -t\" -- \"$cur\"))\n ;;\n update-many)\n COMPREPLY=($(compgen -W \"--ac --acceptance_criteria --acceptance-criteria --actual --actual_result --actual-result --add_tags --add-tags --affected_version --affected-version --author --body --clear-comments --clear-deps --clear-docs --clear-events --clear-files --clear-learnings --clear-notes --clear-reminders --clear-tests --clear-type-options --comment --component --confidence --customer_impact --customer-impact --deadline --definition_of_ready --definition-of-ready --dep --dep_remove --dep-remove --description --doc --dry-run --environment --estimate --estimated_minutes --estimated-minutes --event --expected --expected_result --expected-result --file --filter-ac-missing --filter-assignee --filter-assignee_filter --filter-assignee-filter --filter-confidence-missing --filter-created-after --filter-created-before --filter-deadline-after --filter-deadline-before --filter-empty-body --filter-estimate-missing --filter-estimates-missing --filter-has-body --filter-has-comments --filter-has-deps --filter-has-docs --filter-has-files --filter-has-learnings --filter-has-linked-command --filter-has-notes --filter-has-tests --filter-metadata-missing --filter-no-comments --filter-no-deps --filter-no-docs --filter-no-files --filter-no-learnings --filter-no-linked-command --filter-no-notes --filter-no-tests --filter-parent --filter-priority --filter-release --filter-release-missing --filter-resolution-missing --filter-reviewer-missing --filter-risk-missing --filter-sprint --filter-sprint-missing --filter-status --filter-tag --filter-type --filter-updated-after --filter-updated-before --fixed_version --fixed-version --force --goal --help --id-only --ids --impact --json --learning --limit --message --no-changed-fields --no-checkpoint --no-extensions --no-pager --note --objective --offset --order --outcome --path --pm-path --priority --profile --quiet --rank --regression --release --reminder --remove_tags --remove-tags --replace-deps --replace-tests --reporter --repro_steps --repro-steps --resolution --reviewer --risk --rollback --severity --sprint --tag --tags --test --title --type --type_option --type-option --unset --value --why_now --why-now -b -d -p -t\" -- \"$cur\"))\n ;;\n calendar|cal)\n COMPREPLY=($(compgen -W \"--assignee --assignee_filter --assignee-filter --author --date --format --from --full_period --full-period --help --id-only --include --json --limit --no-changed-fields --no-extensions --no-pager --occurrence-limit --past --path --pm-path --priority --profile --quiet --recurrence-lookahead-days --recurrence-lookback-days --release --sprint --status --tag --to --type --view\" -- \"$cur\"))\n ;;\n context|ctx)\n COMPREPLY=($(compgen -W \"--activity-limit --after --assignee --assignee_filter --assignee-filter --author --date --depth --explain_ranking --explain-ranking --fields --format --from --help --id-only --json --limit --max-items --no-changed-fields --no-extensions --no-pager --parent --past --path --pm-path --priority --profile --quiet --release --section --sprint --stale-threshold --tag --to --type\" -- \"$cur\"))\n ;;\n next)\n COMPREPLY=($(compgen -W \"--type --tag --priority --assignee --assignee-filter --assignee_filter --sprint --release --parent --limit --blocked-limit --blocked_limit --ready-only --ready_only --format --explain-ranking --explain_ranking --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n guide)\n COMPREPLY=($(compgen -W \"--list --format --depth --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author commands extensions harnesses quickstart release sdk skills workflows\" -- \"$cur\"))\n ;;\n search)\n COMPREPLY=($(compgen -W \"--after --assignee --author --compact --count --created-after --created-before --deadline-after --deadline-before --empty-body --fields --filter-confidence-missing --filter-docs-missing --filter-files-missing --filter-release-missing --filter-reviewer-missing --filter-risk-missing --filter-sprint-missing --format --full --has-body --has-comments --has-deps --has-docs --has-files --has-learnings --has-linked-command --has-notes --has-tests --help --highlight --hybrid --id-only --include-linked --json --limit --match-mode --min-score --mode --no-changed-fields --no-comments --no-deps --no-docs --no-extensions --no-files --no-learnings --no-linked-command --no-notes --no-pager --no-tests --parent --path --phrase-exact --pm-path --priority --profile --quiet --release --semantic --semantic-weight --sprint --status --tag --tags --title-exact --type --updated-after --updated-before\" -- \"$cur\"))\n ;;\n reindex)\n COMPREPLY=($(compgen -W \"--mode --progress --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n init)\n COMPREPLY=($(compgen -W \"--id-prefix --prefix --preset --type-preset -y --defaults --yes --author --agent-guidance --with-packages --workspace --force --verbose --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n config)\n COMPREPLY=($(compgen -W \"--criterion --clear-criteria --format --policy --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n extension)\n COMPREPLY=($(compgen -W \"init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate --init --scaffold --capability --install --uninstall --explore --list --manage --describe --markdown --output --reload --watch --doctor --catalog --adopt --adopt-all --activate --deactivate --project --local --global --gh --github --ref --detail --trace --runtime-probe --fix-managed-state --isolated --ignore-global --strict-exit --fail-on-warn --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n package|packages)\n COMPREPLY=($(compgen -W \"init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate --init --scaffold --capability --install --uninstall --explore --list --manage --describe --markdown --output --reload --watch --doctor --catalog --adopt --adopt-all --activate --deactivate --project --local --global --gh --github --ref --detail --trace --runtime-probe --fix-managed-state --isolated --ignore-global --strict-exit --fail-on-warn --declarative --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n comments)\n COMPREPLY=($(compgen -W \"--add --body --stdin --file --edit --delete --limit --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n notes)\n COMPREPLY=($(compgen -W \"--add --stdin --file --edit --delete --limit --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n learnings)\n COMPREPLY=($(compgen -W \"--add --stdin --file --edit --delete --limit --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n files)\n COMPREPLY=($(compgen -W \"discover --add --add-glob --remove --migrate --list --apply --note --append-stable --validate-paths --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n docs)\n COMPREPLY=($(compgen -W \"--add --add-glob --remove --migrate --note --validate-paths --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n append)\n COMPREPLY=($(compgen -W \"-b --body --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n deps)\n COMPREPLY=($(compgen -W \"--format --max-depth --collapse --summary --node-limit --edge-limit --token-budget --cursor --direction --kind --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n graph)\n COMPREPLY=($(compgen -W \"ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators plan --kind --max-depth --limit --after --direction --max-paths --sample --exempt-isolate --summary --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n test)\n COMPREPLY=($(compgen -W \"--add --add-json --remove --list --run --match --only-index --only-last --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n test-all)\n COMPREPLY=($(compgen -W \"--status --limit --offset --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n test-runs)\n COMPREPLY=($(compgen -W \"list status logs stop resume --status --limit --stream --tail --force --author --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n validate)\n COMPREPLY=($(compgen -W \"--check-metadata --metadata-profile --check-resolution --check-lifecycle --check-stale-blockers --dependency-cycle-severity --parent-cycle-severity --check-files --scan-mode --include-pm-internals --verbose-file-lists --verbose-diagnostics --all-affected-ids --strict-exit --fail-on-warn --fix-hints --auto-fix --dry-run --fix-scope --prune-missing --check-history-drift --check-command-references --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n health)\n COMPREPLY=($(compgen -W \"--strict-directories --strict-exit --fail-on-warn --check-only --check-telemetry --no-refresh --refresh-vectors --verbose-stale-items --brief --summary --skip-vectors --skip-integrity --skip-drift --full --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n history)\n COMPREPLY=($(compgen -W \"--limit --compact --full --diff --field --verify --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n history-compact)\n COMPREPLY=($(compgen -W \"--before --ids --all-over --closed --all-streams --min-entries --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n get)\n COMPREPLY=($(compgen -W \"--depth --full --fields --at --tree --tree-depth --tree_depth --format --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n history-redact)\n COMPREPLY=($(compgen -W \"--literal --regex --replacement --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n history-repair)\n COMPREPLY=($(compgen -W \"--all --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n schema)\n COMPREPLY=($(compgen -W \"list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset --description --default-status --folder --alias --role --order --type --commands --cli-flag --required --required-on-create --no-allow-unset --required-types --infer --min-count --apply --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n profile)\n COMPREPLY=($(compgen -W \"list show apply lint agile ops research --dry-run --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n plan)\n COMPREPLY=($(compgen -W \"create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize --title --description --scope --parent --related --blocks --blocked-by --blocked_by --harness --mode --resume-context --resume_context --tags --tag --priority --body --claim --from-search --from_search --template --step-title --step_title --step --step-body --step_body --step-owner --step_owner --step-status --step_status --step-evidence --step_evidence --step-blocked-reason --step_blocked_reason --step-replacement --step_replacement --depends-on --depends_on --link --link-kind --link_kind --link-note --link_note --promote-to-item-dep --promote_to_item_dep --allow-multiple-active --allow_multiple_active --file --test --doc --decision-text --decision_text --decision --decision-rationale --decision_rationale --decision-evidence --decision_evidence --discovery-text --discovery_text --discovery --validation-text --validation_text --validation --validation-command --validation_command --validation-expected --validation_expected --depth --field --fields --steps --materialize-type --materialize_type --materialize-parent --materialize_parent --materialize-tags --materialize_tags --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n activity)\n COMPREPLY=($(compgen -W \"--id --op --author --from --to --limit --compact --full --stream --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n contracts)\n COMPREPLY=($(compgen -W \"--action --command --summary --schema-only --flags-only --availability-only --runtime-only --active-only --full --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n gc)\n COMPREPLY=($(compgen -W \"--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n stats)\n COMPREPLY=($(compgen -W \"--storage --metadata-coverage --field-utilization --by-assignee --by-tag --by-priority --tag-prefix --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n close|close-task)\n COMPREPLY=($(compgen -W \"--author --message --validate-close --duplicate-of --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n close-many)\n COMPREPLY=($(compgen -W \"--filter-status --filter-type --filter-tag --filter-priority --filter-deadline-before --filter-deadline-after --filter-updated-after --filter-updated-before --filter-created-after --filter-created-before --filter-assignee --filter-assignee-filter --filter-assignee_filter --filter-parent --filter-sprint --filter-release --filter-reviewer-missing --filter-risk-missing --filter-confidence-missing --filter-sprint-missing --filter-release-missing --filter-has-notes --filter-no-notes --filter-has-learnings --filter-no-learnings --filter-has-files --filter-no-files --filter-has-docs --filter-no-docs --filter-has-tests --filter-no-tests --filter-has-comments --filter-no-comments --filter-has-deps --filter-no-deps --filter-has-body --filter-empty-body --filter-has-linked-command --filter-no-linked-command --ids --limit --offset --reason --resolution --expected-result --expected_result --expected --actual-result --actual_result --actual --validate-close --author --message --force --dry-run --rollback --no-checkpoint --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n release)\n COMPREPLY=($(compgen -W \"--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n delete)\n COMPREPLY=($(compgen -W \"--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n claim|restore|start-task|pause-task)\n COMPREPLY=($(compgen -W \"--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n meet|event)\n COMPREPLY=($(compgen -W \"--start --duration --end --location --timezone --all-day --parent --allow-missing-parent --tags --priority --body --description --author --message --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n remind)\n COMPREPLY=($(compgen -W \"--at --text --parent --allow-missing-parent --tags --priority --body --description --author --message --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n completion)\n COMPREPLY=($(compgen -W \"--eager-tags --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author bash zsh fish\" -- \"$cur\"))\n ;;\n templates)\n COMPREPLY=($(compgen -W \"save list show\" -- \"$cur\"))\n ;;\n *)\n COMPREPLY=($(compgen -W \"--json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author --version\" -- \"$cur\"))\n ;;\n esac\n return 0\n}\n\ncomplete -F _pm_completion pm noun remains discoverable; generated shell scripts keep a stable way to request live schema values; internal helpers are hidden from ordinary help/contracts/docs/MCP enumeration and may be routed beneath # bash completion for pm\n# Source this file or add 'eval \"$(pm completion bash)\"' to ~/.bashrc\n\n_pm_completion_type_choices() {\n local now ttl cache_ts resolved\n now=\"$(date +%s 2>/dev/null || echo 0)\"\n ttl=\"${PM_COMPLETION_TYPE_TTL:-120}\"\n cache_ts=\"${PM_COMPLETION_TYPE_CACHE_TS:-0}\"\n if [[ -n \"${PM_COMPLETION_TYPE_CACHE:-}\" && \"$now\" -ne 0 && $((now - cache_ts)) -lt \"$ttl\" ]]; then\n printf '%s\\n' \"$PM_COMPLETION_TYPE_CACHE\"\n return 0\n fi\n resolved=\"$(pm completion-types 2>/dev/null)\"\n if [[ -z \"$resolved\" ]]; then\n resolved=\"Chore Decision Epic Event Feature Issue Meeting Milestone Plan Reminder Story Task\"\n fi\n PM_COMPLETION_TYPE_CACHE=\"$resolved\"\n PM_COMPLETION_TYPE_CACHE_TS=\"$now\"\n printf '%s\\n' \"$PM_COMPLETION_TYPE_CACHE\"\n}\n\n_pm_completion_status_choices() {\n local now ttl cache_ts resolved\n now=\"$(date +%s 2>/dev/null || echo 0)\"\n ttl=\"${PM_COMPLETION_STATUS_TTL:-120}\"\n cache_ts=\"${PM_COMPLETION_STATUS_CACHE_TS:-0}\"\n if [[ -n \"${PM_COMPLETION_STATUS_CACHE:-}\" && \"$now\" -ne 0 && $((now - cache_ts)) -lt \"$ttl\" ]]; then\n printf '%s\\n' \"$PM_COMPLETION_STATUS_CACHE\"\n return 0\n fi\n resolved=\"$(pm completion-statuses 2>/dev/null)\"\n if [[ -z \"$resolved\" ]]; then\n resolved=\"blocked canceled closed draft in_progress open\"\n fi\n PM_COMPLETION_STATUS_CACHE=\"$resolved\"\n PM_COMPLETION_STATUS_CACHE_TS=\"$now\"\n printf '%s\\n' \"$PM_COMPLETION_STATUS_CACHE\"\n}\n\n_pm_completion() {\n local cur prev words cword\n _init_completion 2>/dev/null || {\n cur=\"${COMP_WORDS[COMP_CWORD]}\"\n prev=\"${COMP_WORDS[COMP_CWORD-1]}\"\n cword=$COMP_CWORD\n }\n\n if [[ $cword -eq 1 ]]; then\n COMPREPLY=($(compgen -W \"init config extension package packages install upgrade create copy focus list list-all list-draft list-open list-in-progress list-blocked list-closed list-canceled aggregate context ctx get graph search eval next history history-redact history-repair history-compact schema profile activity restore update update-many close close-many delete append comments notes learnings files docs deps plan test test-all telemetry stats health validate gc contracts claim release start-task pause-task close-task meet event remind help\" -- \"$cur\"))\n return 0\n fi\n\n if [[ \"$prev\" == \"--type\" ]]; then\n COMPREPLY=($(compgen -W \"$(_pm_completion_type_choices)\" -- \"$cur\"))\n return 0\n fi\n\n if [[ \"$prev\" == \"--status\" ]]; then\n COMPREPLY=($(compgen -W \"$(_pm_completion_status_choices)\" -- \"$cur\"))\n return 0\n fi\n\n if [[ \"$prev\" == \"--tag\" || \"$prev\" == \"--tags\" ]]; then\n local now ttl cache_ts tag_values\n now=\"$(date +%s 2>/dev/null || echo 0)\"\n ttl=\"${PM_COMPLETION_TAG_TTL:-120}\"\n cache_ts=\"${PM_COMPLETION_TAG_CACHE_TS:-0}\"\n tag_values=\"${PM_COMPLETION_TAG_CACHE:-}\"\n if [[ -z \"$tag_values\" || \"$now\" -eq 0 || $((now - cache_ts)) -ge \"$ttl\" ]]; then\n tag_values=\"$(pm completion-tags 2>/dev/null)\"\n PM_COMPLETION_TAG_CACHE=\"$tag_values\"\n PM_COMPLETION_TAG_CACHE_TS=\"$now\"\n fi\n COMPREPLY=($(compgen -W \"$tag_values\" -- \"$cur\"))\n return 0\n fi\n\n local cmd=\"${COMP_WORDS[1]}\"\n\n case \"$cmd\" in\n list|list-all|list-draft|list-open|list-in-progress|list-blocked|list-closed|list-canceled)\n COMPREPLY=($(compgen -W \"--after --all --assignee --assignee_filter --assignee-filter --author --brief --compact --created-after --created-before --deadline-after --deadline-before --empty-body --fields --filter-ac-missing --filter-confidence-missing --filter-docs-missing --filter-estimate-missing --filter-estimates-missing --filter-files-missing --filter-metadata-missing --filter-release-missing --filter-resolution-missing --filter-reviewer-missing --filter-risk-missing --filter-sprint-missing --format --full --has-body --has-comments --has-deps --has-docs --has-files --has-learnings --has-linked-command --has-notes --has-tests --help --id-only --ids --include-body --json --limit --no-changed-fields --no-comments --no-deps --no-docs --no-extensions --no-files --no-learnings --no-linked-command --no-notes --no-pager --no-tests --no-truncate --offset --order --parent --path --pm-path --priority --profile --quiet --recent --release --sort --sprint --status --stream --tag --tags --today --tree --tree_depth --tree-depth --type --updated-after --updated-before\" -- \"$cur\"))\n ;;\n aggregate)\n COMPREPLY=($(compgen -W \"--group-by --count --completion --sum --avg --include-unparented --include_unparented --status --type --tag --priority --deadline-before --deadline-after --assignee --assignee-filter --assignee_filter --parent --sprint --release --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n create)\n COMPREPLY=($(compgen -W \"--ac --acceptance_criteria --acceptance-criteria --actual --actual_result --actual-result --add_tags --add-tags --affected_version --affected-version --allow-missing-parent --assignee --author --blocked_by --blocked_reason --blocked-by --blocked-reason --body --body-file --clear-comments --clear-deps --clear-docs --clear-events --clear-files --clear-learnings --clear-notes --clear-reminders --clear-tests --clear-type-options --comment --component --confidence --create_mode --create-mode --customer_impact --customer-impact --deadline --definition_of_ready --definition-of-ready --dep --description --doc --environment --estimate --estimated_minutes --estimated-minutes --event --expected --expected_result --expected-result --field --file --fixed_version --fixed-version --goal --help --id --id-only --impact --json --learning --message --no-changed-fields --no-extensions --no-pager --note --objective --order --outcome --parent --path --pm-path --priority --profile --quiet --rank --regression --release --reminder --reporter --repro_steps --repro-steps --resolution --reviewer --risk --schedule_preset --schedule-preset --severity --sprint --status --tag --tags --template --test --title --type --type_option --type-option --unblock_note --unblock-note --unset --value --why_now --why-now -b -d -p -s -t\" -- \"$cur\"))\n ;;\n copy)\n COMPREPLY=($(compgen -W \"--title --author --message --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n focus)\n COMPREPLY=($(compgen -W \"--clear --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n update)\n COMPREPLY=($(compgen -W \"--ac --acceptance_criteria --acceptance-criteria --actual --actual_result --actual-result --add_tags --add-tags --affected_version --affected-version --assignee --author --blocked_by --blocked_reason --blocked-by --blocked-reason --body --body-file --clear-comments --clear-deps --clear-docs --clear-events --clear-files --clear-learnings --clear-notes --clear-reminders --clear-tests --clear-type-options --close_reason --close-reason --comment --component --confidence --customer_impact --customer-impact --deadline --definition_of_ready --definition-of-ready --dep --dep_remove --dep-remove --description --doc --environment --estimate --estimated_minutes --estimated-minutes --event --expected --expected_result --expected-result --field --file --fixed_version --fixed-version --force --goal --help --id-only --impact --json --learning --message --no-changed-fields --no-extensions --no-pager --note --objective --order --outcome --parent --path --pm-path --priority --profile --quiet --rank --regression --release --reminder --remove_tags --remove-tags --replace-deps --replace-tests --reporter --repro_steps --repro-steps --resolution --reviewer --risk --severity --sprint --status --tag --tags --test --title --type --type_option --type-option --unblock_note --unblock-note --unset --value --why_now --why-now -b -d -p -s -t\" -- \"$cur\"))\n ;;\n update-many)\n COMPREPLY=($(compgen -W \"--ac --acceptance_criteria --acceptance-criteria --actual --actual_result --actual-result --add_tags --add-tags --affected_version --affected-version --author --body --clear-comments --clear-deps --clear-docs --clear-events --clear-files --clear-learnings --clear-notes --clear-reminders --clear-tests --clear-type-options --comment --component --confidence --customer_impact --customer-impact --deadline --definition_of_ready --definition-of-ready --dep --dep_remove --dep-remove --description --doc --dry-run --environment --estimate --estimated_minutes --estimated-minutes --event --expected --expected_result --expected-result --file --filter-ac-missing --filter-assignee --filter-assignee_filter --filter-assignee-filter --filter-confidence-missing --filter-created-after --filter-created-before --filter-deadline-after --filter-deadline-before --filter-empty-body --filter-estimate-missing --filter-estimates-missing --filter-has-body --filter-has-comments --filter-has-deps --filter-has-docs --filter-has-files --filter-has-learnings --filter-has-linked-command --filter-has-notes --filter-has-tests --filter-metadata-missing --filter-no-comments --filter-no-deps --filter-no-docs --filter-no-files --filter-no-learnings --filter-no-linked-command --filter-no-notes --filter-no-tests --filter-parent --filter-priority --filter-release --filter-release-missing --filter-resolution-missing --filter-reviewer-missing --filter-risk-missing --filter-sprint --filter-sprint-missing --filter-status --filter-tag --filter-type --filter-updated-after --filter-updated-before --fixed_version --fixed-version --force --goal --help --id-only --ids --impact --json --learning --limit --message --no-changed-fields --no-checkpoint --no-extensions --no-pager --note --objective --offset --order --outcome --path --pm-path --priority --profile --quiet --rank --regression --release --reminder --remove_tags --remove-tags --replace-deps --replace-tests --reporter --repro_steps --repro-steps --resolution --reviewer --risk --rollback --severity --sprint --tag --tags --test --title --type --type_option --type-option --unset --value --why_now --why-now -b -d -p -t\" -- \"$cur\"))\n ;;\n calendar|cal)\n COMPREPLY=($(compgen -W \"--assignee --assignee_filter --assignee-filter --author --date --format --from --full_period --full-period --help --id-only --include --json --limit --no-changed-fields --no-extensions --no-pager --occurrence-limit --past --path --pm-path --priority --profile --quiet --recurrence-lookahead-days --recurrence-lookback-days --release --sprint --status --tag --to --type --view\" -- \"$cur\"))\n ;;\n context|ctx)\n COMPREPLY=($(compgen -W \"--activity-limit --after --assignee --assignee_filter --assignee-filter --author --date --depth --explain_ranking --explain-ranking --fields --format --from --help --id-only --json --limit --max-items --no-changed-fields --no-extensions --no-pager --parent --past --path --pm-path --priority --profile --quiet --release --section --sprint --stale-threshold --tag --to --type\" -- \"$cur\"))\n ;;\n next)\n COMPREPLY=($(compgen -W \"--type --tag --priority --assignee --assignee-filter --assignee_filter --sprint --release --parent --limit --blocked-limit --blocked_limit --ready-only --ready_only --format --explain-ranking --explain_ranking --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n guide)\n COMPREPLY=($(compgen -W \"--list --format --depth --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author commands extensions harnesses quickstart release sdk skills workflows\" -- \"$cur\"))\n ;;\n search)\n COMPREPLY=($(compgen -W \"--after --assignee --author --compact --count --created-after --created-before --deadline-after --deadline-before --empty-body --fields --filter-confidence-missing --filter-docs-missing --filter-files-missing --filter-release-missing --filter-reviewer-missing --filter-risk-missing --filter-sprint-missing --format --full --has-body --has-comments --has-deps --has-docs --has-files --has-learnings --has-linked-command --has-notes --has-tests --help --highlight --hybrid --id-only --include-linked --json --limit --match-mode --min-score --mode --no-changed-fields --no-comments --no-deps --no-docs --no-extensions --no-files --no-learnings --no-linked-command --no-notes --no-pager --no-tests --parent --path --phrase-exact --pm-path --priority --profile --quiet --release --semantic --semantic-weight --sprint --status --tag --tags --title-exact --type --updated-after --updated-before\" -- \"$cur\"))\n ;;\n reindex)\n COMPREPLY=($(compgen -W \"--mode --progress --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n init)\n COMPREPLY=($(compgen -W \"--id-prefix --prefix --preset --type-preset -y --defaults --yes --author --agent-guidance --with-packages --workspace --force --verbose --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n config)\n COMPREPLY=($(compgen -W \"--criterion --clear-criteria --format --policy --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n extension)\n COMPREPLY=($(compgen -W \"init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate --init --scaffold --capability --install --uninstall --explore --list --manage --describe --markdown --output --reload --watch --doctor --catalog --adopt --adopt-all --activate --deactivate --project --local --global --gh --github --ref --detail --trace --runtime-probe --fix-managed-state --isolated --ignore-global --strict-exit --fail-on-warn --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n package|packages)\n COMPREPLY=($(compgen -W \"init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate --init --scaffold --capability --install --uninstall --explore --list --manage --describe --markdown --output --reload --watch --doctor --catalog --adopt --adopt-all --activate --deactivate --project --local --global --gh --github --ref --detail --trace --runtime-probe --fix-managed-state --isolated --ignore-global --strict-exit --fail-on-warn --declarative --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n comments)\n COMPREPLY=($(compgen -W \"--add --body --stdin --file --edit --delete --limit --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n notes)\n COMPREPLY=($(compgen -W \"--add --stdin --file --edit --delete --limit --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n learnings)\n COMPREPLY=($(compgen -W \"--add --stdin --file --edit --delete --limit --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n files)\n COMPREPLY=($(compgen -W \"discover --add --add-glob --remove --migrate --list --apply --note --append-stable --validate-paths --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n docs)\n COMPREPLY=($(compgen -W \"--add --add-glob --remove --migrate --note --validate-paths --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n append)\n COMPREPLY=($(compgen -W \"-b --body --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n deps)\n COMPREPLY=($(compgen -W \"--format --max-depth --collapse --summary --node-limit --edge-limit --token-budget --cursor --direction --kind --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n graph)\n COMPREPLY=($(compgen -W \"ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators plan --kind --max-depth --limit --after --direction --max-paths --sample --exempt-isolate --summary --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n test)\n COMPREPLY=($(compgen -W \"--add --add-json --remove --list --run --match --only-index --only-last --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n test-all)\n COMPREPLY=($(compgen -W \"--status --limit --offset --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n test-runs)\n COMPREPLY=($(compgen -W \"list status logs stop resume --status --limit --stream --tail --force --author --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n validate)\n COMPREPLY=($(compgen -W \"--check-metadata --metadata-profile --check-resolution --check-lifecycle --check-stale-blockers --dependency-cycle-severity --parent-cycle-severity --check-files --scan-mode --include-pm-internals --verbose-file-lists --verbose-diagnostics --all-affected-ids --strict-exit --fail-on-warn --fix-hints --auto-fix --dry-run --fix-scope --prune-missing --check-history-drift --check-command-references --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n health)\n COMPREPLY=($(compgen -W \"--strict-directories --strict-exit --fail-on-warn --check-only --check-telemetry --no-refresh --refresh-vectors --verbose-stale-items --brief --summary --skip-vectors --skip-integrity --skip-drift --full --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n history)\n COMPREPLY=($(compgen -W \"--limit --compact --full --diff --field --verify --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n history-compact)\n COMPREPLY=($(compgen -W \"--before --ids --all-over --closed --all-streams --min-entries --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n get)\n COMPREPLY=($(compgen -W \"--depth --full --fields --at --tree --tree-depth --tree_depth --format --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n history-redact)\n COMPREPLY=($(compgen -W \"--literal --regex --replacement --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n history-repair)\n COMPREPLY=($(compgen -W \"--all --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n schema)\n COMPREPLY=($(compgen -W \"list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset --description --default-status --folder --alias --role --order --type --commands --cli-flag --required --required-on-create --no-allow-unset --required-types --infer --min-count --apply --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n profile)\n COMPREPLY=($(compgen -W \"list show apply lint agile ops research --dry-run --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n plan)\n COMPREPLY=($(compgen -W \"create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize --title --description --scope --parent --related --blocks --blocked-by --blocked_by --harness --mode --resume-context --resume_context --tags --tag --priority --body --claim --from-search --from_search --template --step-title --step_title --step --step-body --step_body --step-owner --step_owner --step-status --step_status --step-evidence --step_evidence --step-blocked-reason --step_blocked_reason --step-replacement --step_replacement --depends-on --depends_on --link --link-kind --link_kind --link-note --link_note --promote-to-item-dep --promote_to_item_dep --allow-multiple-active --allow_multiple_active --file --test --doc --decision-text --decision_text --decision --decision-rationale --decision_rationale --decision-evidence --decision_evidence --discovery-text --discovery_text --discovery --validation-text --validation_text --validation --validation-command --validation_command --validation-expected --validation_expected --depth --field --fields --steps --materialize-type --materialize_type --materialize-parent --materialize_parent --materialize-tags --materialize_tags --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n activity)\n COMPREPLY=($(compgen -W \"--id --op --author --from --to --limit --compact --full --stream --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n contracts)\n COMPREPLY=($(compgen -W \"--action --command --summary --schema-only --flags-only --availability-only --runtime-only --active-only --full --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n gc)\n COMPREPLY=($(compgen -W \"--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n stats)\n COMPREPLY=($(compgen -W \"--storage --metadata-coverage --field-utilization --by-assignee --by-tag --by-priority --tag-prefix --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n close|close-task)\n COMPREPLY=($(compgen -W \"--author --message --validate-close --duplicate-of --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n close-many)\n COMPREPLY=($(compgen -W \"--filter-status --filter-type --filter-tag --filter-priority --filter-deadline-before --filter-deadline-after --filter-updated-after --filter-updated-before --filter-created-after --filter-created-before --filter-assignee --filter-assignee-filter --filter-assignee_filter --filter-parent --filter-sprint --filter-release --filter-reviewer-missing --filter-risk-missing --filter-confidence-missing --filter-sprint-missing --filter-release-missing --filter-has-notes --filter-no-notes --filter-has-learnings --filter-no-learnings --filter-has-files --filter-no-files --filter-has-docs --filter-no-docs --filter-has-tests --filter-no-tests --filter-has-comments --filter-no-comments --filter-has-deps --filter-no-deps --filter-has-body --filter-empty-body --filter-has-linked-command --filter-no-linked-command --ids --limit --offset --reason --resolution --expected-result --expected_result --expected --actual-result --actual_result --actual --validate-close --author --message --force --dry-run --rollback --no-checkpoint --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n release)\n COMPREPLY=($(compgen -W \"--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n delete)\n COMPREPLY=($(compgen -W \"--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n claim|restore|start-task|pause-task)\n COMPREPLY=($(compgen -W \"--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n meet|event)\n COMPREPLY=($(compgen -W \"--start --duration --end --location --timezone --all-day --parent --allow-missing-parent --tags --priority --body --description --author --message --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n remind)\n COMPREPLY=($(compgen -W \"--at --text --parent --allow-missing-parent --tags --priority --body --description --author --message --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n completion)\n COMPREPLY=($(compgen -W \"--eager-tags --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author bash zsh fish\" -- \"$cur\"))\n ;;\n templates)\n COMPREPLY=($(compgen -W \"save list show\" -- \"$cur\"))\n ;;\n *)\n COMPREPLY=($(compgen -W \"--json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author --version\" -- \"$cur\"))\n ;;\n esac\n return 0\n}\n\ncomplete -F _pm_completion pm verbs or an explicit internal registry.\\n\\n## Verification\\nMeasure root-help and compact-contract token deltas; snapshot the generated bash/zsh/fish scripts; execute each completion path against built-in plus custom types/statuses/tags; prove old helper spellings remain compatibility aliases or internal entrypoints until the grammar migration policy permits removal.\\n\\n## Duplicate check\\nAll-status exact-title searches for each helper returned zero items. Focused all-term search for runtime resolved shell completion helper hiding found only closed general help/completion work and no focused open owner. Related scopes are pm-e2bq (tiered help), pm-mu8m (generated completion/contracts surfaces), and pm-lp4j (internal worker hiding)."},{"op":"add","path":"/metadata/id","value":"pm-szdc"},{"op":"add","path":"/metadata/title","value":"Hide runtime completion helper entrypoints from the default agent-facing command surface"},{"op":"add","path":"/metadata/description","value":"The live 2026-07-18 root command census exposes completion-statuses, completion-tags, and completion-types as ordinary top-level commands even though they are runtime plumbing used by generated shell completion scripts. Preserve every completion capability and explicit internal invocation path, but hide these helpers from default help, compact contracts, docs, MCP discovery, and the canonical grammar budget."},{"op":"add","path":"/metadata/type","value":"Task"},{"op":"add","path":"/metadata/status","value":"open"},{"op":"add","path":"/metadata/priority","value":2},{"op":"add","path":"/metadata/tags","value":["agent-ux","area:cli","area:contracts","completion","internal-command","simplification","token-efficiency"]},{"op":"add","path":"/metadata/created_at","value":"2026-07-18T14:04:52.766Z"},{"op":"add","path":"/metadata/updated_at","value":"2026-07-18T14:04:52.766Z"},{"op":"add","path":"/metadata/author","value":"codex-ecosystem-planner"},{"op":"add","path":"/metadata/estimated_minutes","value":120},{"op":"add","path":"/metadata/acceptance_criteria","value":"Default pm --help and compact contracts do not list completion-statuses, completion-tags, or completion-types; generated bash/zsh/fish completion still resolves runtime statuses, tags, and types; an explicit internal or completion-plumbing discovery path remains testable; byte-for-byte completion behavior and exit semantics are preserved; snapshots, contracts, docs, and token-budget baselines prove zero feature loss and reduced default surface."},{"op":"add","path":"/metadata/parent","value":"pm-n7rr"},{"op":"add","path":"/metadata/risk","value":"low"},{"op":"add","path":"/metadata/confidence","value":"high"},{"op":"add","path":"/metadata/dependencies","value":[{"id":"pm-e2bq","kind":"related","created_at":"2026-07-18T14:04:52.766Z","author":"codex-ecosystem-planner"},{"id":"pm-lp4j","kind":"related","created_at":"2026-07-18T14:04:52.766Z","author":"codex-ecosystem-planner"},{"id":"pm-mu8m","kind":"related","created_at":"2026-07-18T14:04:52.766Z","author":"codex-ecosystem-planner"}]}],"before_hash":"3cc22dff72be7b14824654a7a64ea62b04799939b2fee54c1b5f52ca60bf6df0","after_hash":"258a300e61c5152ec550f6f9624ad645b5d75f219bac9ffc3481ab8db8c772cc","message":""} | |||
There was a problem hiding this comment.
This line contains literal unescaped newlines inside the JSON string value for the /body path. Literal control characters (like newlines) are syntactically invalid in JSON strings. Additionally, JSONL (JSON Lines) format strictly requires each JSON object to be contained entirely on a single line. All newlines within string values must be escaped as \n.
| {"ts":"2026-07-18T14:11:16.492Z","author":"codex-ecosystem-planner","op":"test_run_track","patch":[{"op":"replace","path":"/metadata/updated_at","value":"2026-07-18T14:11:16.492Z"},{"op":"add","path":"/metadata/test_runs","value":[{"run_id":"test-local-mrqg36v5-oo4quu","kind":"test","status":"passed","started_at":"2026-07-18T14:10:59.860Z","finished_at":"2026-07-18T14:11:16.481Z","recorded_at":"2026-07-18T14:11:16.481Z","passed":1,"failed":0,"skipped":0}]}],"before_hash":"70bd2b27b7e7bd9dc874954adda97f854b04211f2a2bf6266622f89a23cecc79","after_hash":"cd24e8d91cc2ae1f5c00b22e41f0c7ac1745fa7fa8d26aeaca0b877b00ef29fb","message":"Track test run summary (test-local-mrqg36v5-oo4quu)"} | ||
| {"ts":"2026-07-18T14:12:45.309Z","author":"codex-ecosystem-planner","op":"comment_add","patch":[{"op":"add","path":"/metadata/comments/1","value":{"created_at":"2026-07-18T14:12:45.306Z","author":"codex-ecosystem-planner","text":"Planning verification: focused linked suite passed 3 files / 125 tests in an isolated tracker context. Post-mutation all-status validation is ok with zero history drift; graph remains zero-actionable with no active isolates; exact/fuzzy duplicate result remains limited to the already-canceled accidental probe cluster and parent-scope duplicates remain zero. This item intentionally stays open for future implementation."}},{"op":"replace","path":"/metadata/updated_at","value":"2026-07-18T14:12:45.309Z"}],"before_hash":"cd24e8d91cc2ae1f5c00b22e41f0c7ac1745fa7fa8d26aeaca0b877b00ef29fb","after_hash":"097835db1ddb06e22cedd8785b855b5290797837ec1db7fa615c4c1f32d567b5"} | ||
| {"ts":"2026-07-18T14:12:45.991Z","author":"codex-ecosystem-planner","op":"learning_add","patch":[{"op":"replace","path":"/metadata/updated_at","value":"2026-07-18T14:12:45.991Z"},{"op":"add","path":"/metadata/learnings","value":[{"created_at":"2026-07-18T14:12:45.990Z","author":"codex-ecosystem-planner","text":"Command-surface audits must classify visibility as well as capability: a runtime helper can be correct, tested, and required by shell completion while still being harmful in default agent discovery. Contracts need an explicit public, compatibility-alias, extension-owned, or internal-plumbing visibility class so generated help cannot re-promote helpers accidentally."}]}],"before_hash":"097835db1ddb06e22cedd8785b855b5290797837ec1db7fa615c4c1f32d567b5","after_hash":"006f28f63cbf565ac8d64e1b819815cca18ab21cef1ccc25282130a950dea119"} | ||
| {"ts":"2026-07-18T14:14:27.117Z","author":"codex-ecosystem-planner","op":"update","patch":[{"op":"replace","path":"/body","value":"## Problem\nThe default root help currently advertises three runtime data providers as if agents should invoke them directly: completion-statuses, completion-tags, and completion-types. This adds three nouns to the discovery surface without adding user capability.\n\n## Desired design\nTreat these entrypoints as internal completion plumbing. The public pm completion noun remains discoverable; generated shell scripts keep a stable way to request live schema values; internal helpers are hidden from ordinary help, contracts, docs, and MCP enumeration and may be routed beneath completion verbs or an explicit internal registry.\n\n## Verification\nMeasure root-help and compact-contract token deltas; snapshot generated bash, zsh, and fish scripts; execute each completion path against built-in plus custom types, statuses, and tags; prove old helper spellings remain compatibility aliases or internal entrypoints until the grammar migration policy permits removal.\n\n## Duplicate check\nAll-status exact-title searches for each helper returned zero items. Focused all-term search for runtime resolved shell completion helper hiding found only closed general help/completion work and no focused open owner. Related scopes are pm-e2bq for tiered help, pm-mu8m for generated completion/contracts surfaces, and pm-lp4j for internal worker hiding."},{"op":"replace","path":"/metadata/updated_at","value":"2026-07-18T14:14:27.117Z"}],"before_hash":"006f28f63cbf565ac8d64e1b819815cca18ab21cef1ccc25282130a950dea119","after_hash":"969e1aae34761a41350acd7d10342dcd46ba336c4c1d065f48ac24255bb47071","message":"Correct body after shell-expanded completion example was detected during diff review"} |
There was a problem hiding this comment.
This line contains literal unescaped newlines inside the JSON string value for the /body path. Literal control characters (like newlines) are syntactically invalid in JSON strings. Additionally, JSONL (JSON Lines) format strictly requires each JSON object to be contained entirely on a single line. All newlines within string values must be escaped as \n.
Codecov Report✅ All modified and coverable lines are covered by tests. 📢 Thoughts on this report? Let us know! |
Greptile SummaryThis PR updates tracker roadmap and governance records for the command-surface and context roadmap pass. The main changes are:
Confidence Score: 5/5Safe to merge with minimal risk. The PR changes tracker metadata, roadmap notes, and matching history records only. The new task has parentage, acceptance criteria, linked evidence, test references, and history events. No runtime product code or behavior-changing configuration was modified. No files require special attention.
 T-Rex LogsWhat T-Rex did
Important Files Changed
Sequence Diagram%%{init: {'theme': 'neutral'}}%%
sequenceDiagram
participant Reviewer as Ecosystem review pass
participant Roadmap as pm-doxj roadmap
participant Epics as Canonical living epics
participant Task as pm-szdc task
participant History as JSONL history streams
Reviewer->>Roadmap: Record all-status corpus, validation, graph, duplicate evidence
Reviewer->>Epics: Add command-surface, SDK, scale, context, governance, history notes
Reviewer->>Task: Create focused completion-helper visibility gap
Task->>History: Append create, evidence, tests, learning, publication events
Epics->>History: Append corresponding note/comment history events
Roadmap->>History: Append verification and publication history events
%%{init: {'theme': 'base', 'themeVariables': {"darkMode": true, "background": "#0d1117", "primaryColor": "#21262d", "primaryTextColor": "#e6edf3", "primaryBorderColor": "#8b949e", "lineColor": "#8b949e", "textColor": "#e6edf3", "edgeLabelBackground": "#161b22", "actorBkg": "#21262d", "actorBorder": "#8b949e", "actorTextColor": "#e6edf3", "actorLineColor": "#8b949e", "signalColor": "#8b949e", "signalTextColor": "#e6edf3", "noteBkgColor": "#373320", "noteBorderColor": "#d4a72c", "noteTextColor": "#f0e6c0", "labelBoxBkgColor": "#21262d", "labelBoxBorderColor": "#8b949e", "labelTextColor": "#e6edf3", "loopTextColor": "#e6edf3", "activationBkgColor": "#30363d", "activationBorderColor": "#8b949e"}}}%%
sequenceDiagram
participant Reviewer as Ecosystem review pass
participant Roadmap as pm-doxj roadmap
participant Epics as Canonical living epics
participant Task as pm-szdc task
participant History as JSONL history streams
Reviewer->>Roadmap: Record all-status corpus, validation, graph, duplicate evidence
Reviewer->>Epics: Add command-surface, SDK, scale, context, governance, history notes
Reviewer->>Task: Create focused completion-helper visibility gap
Task->>History: Append create, evidence, tests, learning, publication events
Epics->>History: Append corresponding note/comment history events
Roadmap->>History: Append verification and publication history events
Reviews (2): Last reviewed commit: "Clarify completion and bulk-test grammar..." | Re-trigger Greptile |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 1
🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.
Inline comments:
In @.agents/pm/epics/pm-n7rr.toon:
- Around line 40-46: Update the charter’s target-surface list to include the
canonical `completion` and `test-all` surfaces identified in the census. If
either is intentionally excluded, explicitly document that the list omits
shell-only/helper or bulk spellings while preserving their availability through
shell completion and the appropriate bulk command family.
🪄 Autofix (Beta)
Fix all unresolved CodeRabbit comments on this PR:
- Push a commit to this branch (recommended)
- Create a new PR with the fixes
ℹ️ Review info
⚙️ Run configuration
Configuration used: Repository UI (base), Organization UI (inherited)
Review profile: ASSERTIVE
Plan: Pro
Run ID: 03df86d4-5ebf-4a47-b6fe-b3ff128fad8e
📒 Files selected for processing (17)
.agents/pm/epics/pm-33cw.toon.agents/pm/epics/pm-9rxu.toon.agents/pm/epics/pm-n7rr.toon.agents/pm/epics/pm-o2kc.toon.agents/pm/epics/pm-usfg.toon.agents/pm/extensions/.managed-extensions.json.agents/pm/features/pm-4k6b.toon.agents/pm/history/pm-33cw.jsonl.agents/pm/history/pm-4k6b.jsonl.agents/pm/history/pm-9rxu.jsonl.agents/pm/history/pm-doxj.jsonl.agents/pm/history/pm-n7rr.jsonl.agents/pm/history/pm-o2kc.jsonl.agents/pm/history/pm-szdc.jsonl.agents/pm/history/pm-usfg.jsonl.agents/pm/milestones/pm-doxj.toon.agents/pm/tasks/pm-szdc.toon
There was a problem hiding this comment.
Code Review
This pull request updates the project management roadmap and tracking files, including the creation of a new task (pm-szdc) to hide runtime completion helper entrypoints from the default command surface. A critical formatting issue was identified in the history file for the new task, where unescaped literal newlines break the JSON Lines format.
Important
The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.
| @@ -0,0 +1,11 @@ | |||
| {"ts":"2026-07-18T14:04:52.766Z","author":"codex-ecosystem-planner","op":"create","patch":[{"op":"replace","path":"/body","value":"## Problem\\nThe default root help currently advertises three runtime data providers as if agents should invoke them directly: completion-statuses, completion-tags, and completion-types. This adds three nouns to the discovery surface without adding user capability.\\n\\n## Desired design\\nTreat these entrypoints like internal completion plumbing. The public # bash completion for pm\n# Source this file or add 'eval \"$(pm completion bash)\"' to ~/.bashrc\n\n_pm_completion_type_choices() {\n local now ttl cache_ts resolved\n now=\"$(date +%s 2>/dev/null || echo 0)\"\n ttl=\"${PM_COMPLETION_TYPE_TTL:-120}\"\n cache_ts=\"${PM_COMPLETION_TYPE_CACHE_TS:-0}\"\n if [[ -n \"${PM_COMPLETION_TYPE_CACHE:-}\" && \"$now\" -ne 0 && $((now - cache_ts)) -lt \"$ttl\" ]]; then\n printf '%s\\n' \"$PM_COMPLETION_TYPE_CACHE\"\n return 0\n fi\n resolved=\"$(pm completion-types 2>/dev/null)\"\n if [[ -z \"$resolved\" ]]; then\n resolved=\"Chore Decision Epic Event Feature Issue Meeting Milestone Plan Reminder Story Task\"\n fi\n PM_COMPLETION_TYPE_CACHE=\"$resolved\"\n PM_COMPLETION_TYPE_CACHE_TS=\"$now\"\n printf '%s\\n' \"$PM_COMPLETION_TYPE_CACHE\"\n}\n\n_pm_completion_status_choices() {\n local now ttl cache_ts resolved\n now=\"$(date +%s 2>/dev/null || echo 0)\"\n ttl=\"${PM_COMPLETION_STATUS_TTL:-120}\"\n cache_ts=\"${PM_COMPLETION_STATUS_CACHE_TS:-0}\"\n if [[ -n \"${PM_COMPLETION_STATUS_CACHE:-}\" && \"$now\" -ne 0 && $((now - cache_ts)) -lt \"$ttl\" ]]; then\n printf '%s\\n' \"$PM_COMPLETION_STATUS_CACHE\"\n return 0\n fi\n resolved=\"$(pm completion-statuses 2>/dev/null)\"\n if [[ -z \"$resolved\" ]]; then\n resolved=\"blocked canceled closed draft in_progress open\"\n fi\n PM_COMPLETION_STATUS_CACHE=\"$resolved\"\n PM_COMPLETION_STATUS_CACHE_TS=\"$now\"\n printf '%s\\n' \"$PM_COMPLETION_STATUS_CACHE\"\n}\n\n_pm_completion() {\n local cur prev words cword\n _init_completion 2>/dev/null || {\n cur=\"${COMP_WORDS[COMP_CWORD]}\"\n prev=\"${COMP_WORDS[COMP_CWORD-1]}\"\n cword=$COMP_CWORD\n }\n\n if [[ $cword -eq 1 ]]; then\n COMPREPLY=($(compgen -W \"init config extension package packages install upgrade create copy focus list list-all list-draft list-open list-in-progress list-blocked list-closed list-canceled aggregate context ctx get graph search eval next history history-redact history-repair history-compact schema profile activity restore update update-many close close-many delete append comments notes learnings files docs deps plan test test-all telemetry stats health validate gc contracts claim release start-task pause-task close-task meet event remind help\" -- \"$cur\"))\n return 0\n fi\n\n if [[ \"$prev\" == \"--type\" ]]; then\n COMPREPLY=($(compgen -W \"$(_pm_completion_type_choices)\" -- \"$cur\"))\n return 0\n fi\n\n if [[ \"$prev\" == \"--status\" ]]; then\n COMPREPLY=($(compgen -W \"$(_pm_completion_status_choices)\" -- \"$cur\"))\n return 0\n fi\n\n if [[ \"$prev\" == \"--tag\" || \"$prev\" == \"--tags\" ]]; then\n local now ttl cache_ts tag_values\n now=\"$(date +%s 2>/dev/null || echo 0)\"\n ttl=\"${PM_COMPLETION_TAG_TTL:-120}\"\n cache_ts=\"${PM_COMPLETION_TAG_CACHE_TS:-0}\"\n tag_values=\"${PM_COMPLETION_TAG_CACHE:-}\"\n if [[ -z \"$tag_values\" || \"$now\" -eq 0 || $((now - cache_ts)) -ge \"$ttl\" ]]; then\n tag_values=\"$(pm completion-tags 2>/dev/null)\"\n PM_COMPLETION_TAG_CACHE=\"$tag_values\"\n PM_COMPLETION_TAG_CACHE_TS=\"$now\"\n fi\n COMPREPLY=($(compgen -W \"$tag_values\" -- \"$cur\"))\n return 0\n fi\n\n local cmd=\"${COMP_WORDS[1]}\"\n\n case \"$cmd\" in\n list|list-all|list-draft|list-open|list-in-progress|list-blocked|list-closed|list-canceled)\n COMPREPLY=($(compgen -W \"--after --all --assignee --assignee_filter --assignee-filter --author --brief --compact --created-after --created-before --deadline-after --deadline-before --empty-body --fields --filter-ac-missing --filter-confidence-missing --filter-docs-missing --filter-estimate-missing --filter-estimates-missing --filter-files-missing --filter-metadata-missing --filter-release-missing --filter-resolution-missing --filter-reviewer-missing --filter-risk-missing --filter-sprint-missing --format --full --has-body --has-comments --has-deps --has-docs --has-files --has-learnings --has-linked-command --has-notes --has-tests --help --id-only --ids --include-body --json --limit --no-changed-fields --no-comments --no-deps --no-docs --no-extensions --no-files --no-learnings --no-linked-command --no-notes --no-pager --no-tests --no-truncate --offset --order --parent --path --pm-path --priority --profile --quiet --recent --release --sort --sprint --status --stream --tag --tags --today --tree --tree_depth --tree-depth --type --updated-after --updated-before\" -- \"$cur\"))\n ;;\n aggregate)\n COMPREPLY=($(compgen -W \"--group-by --count --completion --sum --avg --include-unparented --include_unparented --status --type --tag --priority --deadline-before --deadline-after --assignee --assignee-filter --assignee_filter --parent --sprint --release --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n create)\n COMPREPLY=($(compgen -W \"--ac --acceptance_criteria --acceptance-criteria --actual --actual_result --actual-result --add_tags --add-tags --affected_version --affected-version --allow-missing-parent --assignee --author --blocked_by --blocked_reason --blocked-by --blocked-reason --body --body-file --clear-comments --clear-deps --clear-docs --clear-events --clear-files --clear-learnings --clear-notes --clear-reminders --clear-tests --clear-type-options --comment --component --confidence --create_mode --create-mode --customer_impact --customer-impact --deadline --definition_of_ready --definition-of-ready --dep --description --doc --environment --estimate --estimated_minutes --estimated-minutes --event --expected --expected_result --expected-result --field --file --fixed_version --fixed-version --goal --help --id --id-only --impact --json --learning --message --no-changed-fields --no-extensions --no-pager --note --objective --order --outcome --parent --path --pm-path --priority --profile --quiet --rank --regression --release --reminder --reporter --repro_steps --repro-steps --resolution --reviewer --risk --schedule_preset --schedule-preset --severity --sprint --status --tag --tags --template --test --title --type --type_option --type-option --unblock_note --unblock-note --unset --value --why_now --why-now -b -d -p -s -t\" -- \"$cur\"))\n ;;\n copy)\n COMPREPLY=($(compgen -W \"--title --author --message --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n focus)\n COMPREPLY=($(compgen -W \"--clear --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n update)\n COMPREPLY=($(compgen -W \"--ac --acceptance_criteria --acceptance-criteria --actual --actual_result --actual-result --add_tags --add-tags --affected_version --affected-version --assignee --author --blocked_by --blocked_reason --blocked-by --blocked-reason --body --body-file --clear-comments --clear-deps --clear-docs --clear-events --clear-files --clear-learnings --clear-notes --clear-reminders --clear-tests --clear-type-options --close_reason --close-reason --comment --component --confidence --customer_impact --customer-impact --deadline --definition_of_ready --definition-of-ready --dep --dep_remove --dep-remove --description --doc --environment --estimate --estimated_minutes --estimated-minutes --event --expected --expected_result --expected-result --field --file --fixed_version --fixed-version --force --goal --help --id-only --impact --json --learning --message --no-changed-fields --no-extensions --no-pager --note --objective --order --outcome --parent --path --pm-path --priority --profile --quiet --rank --regression --release --reminder --remove_tags --remove-tags --replace-deps --replace-tests --reporter --repro_steps --repro-steps --resolution --reviewer --risk --severity --sprint --status --tag --tags --test --title --type --type_option --type-option --unblock_note --unblock-note --unset --value --why_now --why-now -b -d -p -s -t\" -- \"$cur\"))\n ;;\n update-many)\n COMPREPLY=($(compgen -W \"--ac --acceptance_criteria --acceptance-criteria --actual --actual_result --actual-result --add_tags --add-tags --affected_version --affected-version --author --body --clear-comments --clear-deps --clear-docs --clear-events --clear-files --clear-learnings --clear-notes --clear-reminders --clear-tests --clear-type-options --comment --component --confidence --customer_impact --customer-impact --deadline --definition_of_ready --definition-of-ready --dep --dep_remove --dep-remove --description --doc --dry-run --environment --estimate --estimated_minutes --estimated-minutes --event --expected --expected_result --expected-result --file --filter-ac-missing --filter-assignee --filter-assignee_filter --filter-assignee-filter --filter-confidence-missing --filter-created-after --filter-created-before --filter-deadline-after --filter-deadline-before --filter-empty-body --filter-estimate-missing --filter-estimates-missing --filter-has-body --filter-has-comments --filter-has-deps --filter-has-docs --filter-has-files --filter-has-learnings --filter-has-linked-command --filter-has-notes --filter-has-tests --filter-metadata-missing --filter-no-comments --filter-no-deps --filter-no-docs --filter-no-files --filter-no-learnings --filter-no-linked-command --filter-no-notes --filter-no-tests --filter-parent --filter-priority --filter-release --filter-release-missing --filter-resolution-missing --filter-reviewer-missing --filter-risk-missing --filter-sprint --filter-sprint-missing --filter-status --filter-tag --filter-type --filter-updated-after --filter-updated-before --fixed_version --fixed-version --force --goal --help --id-only --ids --impact --json --learning --limit --message --no-changed-fields --no-checkpoint --no-extensions --no-pager --note --objective --offset --order --outcome --path --pm-path --priority --profile --quiet --rank --regression --release --reminder --remove_tags --remove-tags --replace-deps --replace-tests --reporter --repro_steps --repro-steps --resolution --reviewer --risk --rollback --severity --sprint --tag --tags --test --title --type --type_option --type-option --unset --value --why_now --why-now -b -d -p -t\" -- \"$cur\"))\n ;;\n calendar|cal)\n COMPREPLY=($(compgen -W \"--assignee --assignee_filter --assignee-filter --author --date --format --from --full_period --full-period --help --id-only --include --json --limit --no-changed-fields --no-extensions --no-pager --occurrence-limit --past --path --pm-path --priority --profile --quiet --recurrence-lookahead-days --recurrence-lookback-days --release --sprint --status --tag --to --type --view\" -- \"$cur\"))\n ;;\n context|ctx)\n COMPREPLY=($(compgen -W \"--activity-limit --after --assignee --assignee_filter --assignee-filter --author --date --depth --explain_ranking --explain-ranking --fields --format --from --help --id-only --json --limit --max-items --no-changed-fields --no-extensions --no-pager --parent --past --path --pm-path --priority --profile --quiet --release --section --sprint --stale-threshold --tag --to --type\" -- \"$cur\"))\n ;;\n next)\n COMPREPLY=($(compgen -W \"--type --tag --priority --assignee --assignee-filter --assignee_filter --sprint --release --parent --limit --blocked-limit --blocked_limit --ready-only --ready_only --format --explain-ranking --explain_ranking --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n guide)\n COMPREPLY=($(compgen -W \"--list --format --depth --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author commands extensions harnesses quickstart release sdk skills workflows\" -- \"$cur\"))\n ;;\n search)\n COMPREPLY=($(compgen -W \"--after --assignee --author --compact --count --created-after --created-before --deadline-after --deadline-before --empty-body --fields --filter-confidence-missing --filter-docs-missing --filter-files-missing --filter-release-missing --filter-reviewer-missing --filter-risk-missing --filter-sprint-missing --format --full --has-body --has-comments --has-deps --has-docs --has-files --has-learnings --has-linked-command --has-notes --has-tests --help --highlight --hybrid --id-only --include-linked --json --limit --match-mode --min-score --mode --no-changed-fields --no-comments --no-deps --no-docs --no-extensions --no-files --no-learnings --no-linked-command --no-notes --no-pager --no-tests --parent --path --phrase-exact --pm-path --priority --profile --quiet --release --semantic --semantic-weight --sprint --status --tag --tags --title-exact --type --updated-after --updated-before\" -- \"$cur\"))\n ;;\n reindex)\n COMPREPLY=($(compgen -W \"--mode --progress --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n init)\n COMPREPLY=($(compgen -W \"--id-prefix --prefix --preset --type-preset -y --defaults --yes --author --agent-guidance --with-packages --workspace --force --verbose --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n config)\n COMPREPLY=($(compgen -W \"--criterion --clear-criteria --format --policy --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n extension)\n COMPREPLY=($(compgen -W \"init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate --init --scaffold --capability --install --uninstall --explore --list --manage --describe --markdown --output --reload --watch --doctor --catalog --adopt --adopt-all --activate --deactivate --project --local --global --gh --github --ref --detail --trace --runtime-probe --fix-managed-state --isolated --ignore-global --strict-exit --fail-on-warn --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n package|packages)\n COMPREPLY=($(compgen -W \"init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate --init --scaffold --capability --install --uninstall --explore --list --manage --describe --markdown --output --reload --watch --doctor --catalog --adopt --adopt-all --activate --deactivate --project --local --global --gh --github --ref --detail --trace --runtime-probe --fix-managed-state --isolated --ignore-global --strict-exit --fail-on-warn --declarative --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n comments)\n COMPREPLY=($(compgen -W \"--add --body --stdin --file --edit --delete --limit --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n notes)\n COMPREPLY=($(compgen -W \"--add --stdin --file --edit --delete --limit --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n learnings)\n COMPREPLY=($(compgen -W \"--add --stdin --file --edit --delete --limit --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n files)\n COMPREPLY=($(compgen -W \"discover --add --add-glob --remove --migrate --list --apply --note --append-stable --validate-paths --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n docs)\n COMPREPLY=($(compgen -W \"--add --add-glob --remove --migrate --note --validate-paths --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n append)\n COMPREPLY=($(compgen -W \"-b --body --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n deps)\n COMPREPLY=($(compgen -W \"--format --max-depth --collapse --summary --node-limit --edge-limit --token-budget --cursor --direction --kind --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n graph)\n COMPREPLY=($(compgen -W \"ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators plan --kind --max-depth --limit --after --direction --max-paths --sample --exempt-isolate --summary --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n test)\n COMPREPLY=($(compgen -W \"--add --add-json --remove --list --run --match --only-index --only-last --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n test-all)\n COMPREPLY=($(compgen -W \"--status --limit --offset --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n test-runs)\n COMPREPLY=($(compgen -W \"list status logs stop resume --status --limit --stream --tail --force --author --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n validate)\n COMPREPLY=($(compgen -W \"--check-metadata --metadata-profile --check-resolution --check-lifecycle --check-stale-blockers --dependency-cycle-severity --parent-cycle-severity --check-files --scan-mode --include-pm-internals --verbose-file-lists --verbose-diagnostics --all-affected-ids --strict-exit --fail-on-warn --fix-hints --auto-fix --dry-run --fix-scope --prune-missing --check-history-drift --check-command-references --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n health)\n COMPREPLY=($(compgen -W \"--strict-directories --strict-exit --fail-on-warn --check-only --check-telemetry --no-refresh --refresh-vectors --verbose-stale-items --brief --summary --skip-vectors --skip-integrity --skip-drift --full --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n history)\n COMPREPLY=($(compgen -W \"--limit --compact --full --diff --field --verify --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n history-compact)\n COMPREPLY=($(compgen -W \"--before --ids --all-over --closed --all-streams --min-entries --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n get)\n COMPREPLY=($(compgen -W \"--depth --full --fields --at --tree --tree-depth --tree_depth --format --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n history-redact)\n COMPREPLY=($(compgen -W \"--literal --regex --replacement --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n history-repair)\n COMPREPLY=($(compgen -W \"--all --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n schema)\n COMPREPLY=($(compgen -W \"list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset --description --default-status --folder --alias --role --order --type --commands --cli-flag --required --required-on-create --no-allow-unset --required-types --infer --min-count --apply --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n profile)\n COMPREPLY=($(compgen -W \"list show apply lint agile ops research --dry-run --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n plan)\n COMPREPLY=($(compgen -W \"create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize --title --description --scope --parent --related --blocks --blocked-by --blocked_by --harness --mode --resume-context --resume_context --tags --tag --priority --body --claim --from-search --from_search --template --step-title --step_title --step --step-body --step_body --step-owner --step_owner --step-status --step_status --step-evidence --step_evidence --step-blocked-reason --step_blocked_reason --step-replacement --step_replacement --depends-on --depends_on --link --link-kind --link_kind --link-note --link_note --promote-to-item-dep --promote_to_item_dep --allow-multiple-active --allow_multiple_active --file --test --doc --decision-text --decision_text --decision --decision-rationale --decision_rationale --decision-evidence --decision_evidence --discovery-text --discovery_text --discovery --validation-text --validation_text --validation --validation-command --validation_command --validation-expected --validation_expected --depth --field --fields --steps --materialize-type --materialize_type --materialize-parent --materialize_parent --materialize-tags --materialize_tags --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n activity)\n COMPREPLY=($(compgen -W \"--id --op --author --from --to --limit --compact --full --stream --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n contracts)\n COMPREPLY=($(compgen -W \"--action --command --summary --schema-only --flags-only --availability-only --runtime-only --active-only --full --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n gc)\n COMPREPLY=($(compgen -W \"--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n stats)\n COMPREPLY=($(compgen -W \"--storage --metadata-coverage --field-utilization --by-assignee --by-tag --by-priority --tag-prefix --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n close|close-task)\n COMPREPLY=($(compgen -W \"--author --message --validate-close --duplicate-of --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n close-many)\n COMPREPLY=($(compgen -W \"--filter-status --filter-type --filter-tag --filter-priority --filter-deadline-before --filter-deadline-after --filter-updated-after --filter-updated-before --filter-created-after --filter-created-before --filter-assignee --filter-assignee-filter --filter-assignee_filter --filter-parent --filter-sprint --filter-release --filter-reviewer-missing --filter-risk-missing --filter-confidence-missing --filter-sprint-missing --filter-release-missing --filter-has-notes --filter-no-notes --filter-has-learnings --filter-no-learnings --filter-has-files --filter-no-files --filter-has-docs --filter-no-docs --filter-has-tests --filter-no-tests --filter-has-comments --filter-no-comments --filter-has-deps --filter-no-deps --filter-has-body --filter-empty-body --filter-has-linked-command --filter-no-linked-command --ids --limit --offset --reason --resolution --expected-result --expected_result --expected --actual-result --actual_result --actual --validate-close --author --message --force --dry-run --rollback --no-checkpoint --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n release)\n COMPREPLY=($(compgen -W \"--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n delete)\n COMPREPLY=($(compgen -W \"--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n claim|restore|start-task|pause-task)\n COMPREPLY=($(compgen -W \"--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n meet|event)\n COMPREPLY=($(compgen -W \"--start --duration --end --location --timezone --all-day --parent --allow-missing-parent --tags --priority --body --description --author --message --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n remind)\n COMPREPLY=($(compgen -W \"--at --text --parent --allow-missing-parent --tags --priority --body --description --author --message --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n completion)\n COMPREPLY=($(compgen -W \"--eager-tags --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author bash zsh fish\" -- \"$cur\"))\n ;;\n templates)\n COMPREPLY=($(compgen -W \"save list show\" -- \"$cur\"))\n ;;\n *)\n COMPREPLY=($(compgen -W \"--json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author --version\" -- \"$cur\"))\n ;;\n esac\n return 0\n}\n\ncomplete -F _pm_completion pm noun remains discoverable; generated shell scripts keep a stable way to request live schema values; internal helpers are hidden from ordinary help/contracts/docs/MCP enumeration and may be routed beneath # bash completion for pm\n# Source this file or add 'eval \"$(pm completion bash)\"' to ~/.bashrc\n\n_pm_completion_type_choices() {\n local now ttl cache_ts resolved\n now=\"$(date +%s 2>/dev/null || echo 0)\"\n ttl=\"${PM_COMPLETION_TYPE_TTL:-120}\"\n cache_ts=\"${PM_COMPLETION_TYPE_CACHE_TS:-0}\"\n if [[ -n \"${PM_COMPLETION_TYPE_CACHE:-}\" && \"$now\" -ne 0 && $((now - cache_ts)) -lt \"$ttl\" ]]; then\n printf '%s\\n' \"$PM_COMPLETION_TYPE_CACHE\"\n return 0\n fi\n resolved=\"$(pm completion-types 2>/dev/null)\"\n if [[ -z \"$resolved\" ]]; then\n resolved=\"Chore Decision Epic Event Feature Issue Meeting Milestone Plan Reminder Story Task\"\n fi\n PM_COMPLETION_TYPE_CACHE=\"$resolved\"\n PM_COMPLETION_TYPE_CACHE_TS=\"$now\"\n printf '%s\\n' \"$PM_COMPLETION_TYPE_CACHE\"\n}\n\n_pm_completion_status_choices() {\n local now ttl cache_ts resolved\n now=\"$(date +%s 2>/dev/null || echo 0)\"\n ttl=\"${PM_COMPLETION_STATUS_TTL:-120}\"\n cache_ts=\"${PM_COMPLETION_STATUS_CACHE_TS:-0}\"\n if [[ -n \"${PM_COMPLETION_STATUS_CACHE:-}\" && \"$now\" -ne 0 && $((now - cache_ts)) -lt \"$ttl\" ]]; then\n printf '%s\\n' \"$PM_COMPLETION_STATUS_CACHE\"\n return 0\n fi\n resolved=\"$(pm completion-statuses 2>/dev/null)\"\n if [[ -z \"$resolved\" ]]; then\n resolved=\"blocked canceled closed draft in_progress open\"\n fi\n PM_COMPLETION_STATUS_CACHE=\"$resolved\"\n PM_COMPLETION_STATUS_CACHE_TS=\"$now\"\n printf '%s\\n' \"$PM_COMPLETION_STATUS_CACHE\"\n}\n\n_pm_completion() {\n local cur prev words cword\n _init_completion 2>/dev/null || {\n cur=\"${COMP_WORDS[COMP_CWORD]}\"\n prev=\"${COMP_WORDS[COMP_CWORD-1]}\"\n cword=$COMP_CWORD\n }\n\n if [[ $cword -eq 1 ]]; then\n COMPREPLY=($(compgen -W \"init config extension package packages install upgrade create copy focus list list-all list-draft list-open list-in-progress list-blocked list-closed list-canceled aggregate context ctx get graph search eval next history history-redact history-repair history-compact schema profile activity restore update update-many close close-many delete append comments notes learnings files docs deps plan test test-all telemetry stats health validate gc contracts claim release start-task pause-task close-task meet event remind help\" -- \"$cur\"))\n return 0\n fi\n\n if [[ \"$prev\" == \"--type\" ]]; then\n COMPREPLY=($(compgen -W \"$(_pm_completion_type_choices)\" -- \"$cur\"))\n return 0\n fi\n\n if [[ \"$prev\" == \"--status\" ]]; then\n COMPREPLY=($(compgen -W \"$(_pm_completion_status_choices)\" -- \"$cur\"))\n return 0\n fi\n\n if [[ \"$prev\" == \"--tag\" || \"$prev\" == \"--tags\" ]]; then\n local now ttl cache_ts tag_values\n now=\"$(date +%s 2>/dev/null || echo 0)\"\n ttl=\"${PM_COMPLETION_TAG_TTL:-120}\"\n cache_ts=\"${PM_COMPLETION_TAG_CACHE_TS:-0}\"\n tag_values=\"${PM_COMPLETION_TAG_CACHE:-}\"\n if [[ -z \"$tag_values\" || \"$now\" -eq 0 || $((now - cache_ts)) -ge \"$ttl\" ]]; then\n tag_values=\"$(pm completion-tags 2>/dev/null)\"\n PM_COMPLETION_TAG_CACHE=\"$tag_values\"\n PM_COMPLETION_TAG_CACHE_TS=\"$now\"\n fi\n COMPREPLY=($(compgen -W \"$tag_values\" -- \"$cur\"))\n return 0\n fi\n\n local cmd=\"${COMP_WORDS[1]}\"\n\n case \"$cmd\" in\n list|list-all|list-draft|list-open|list-in-progress|list-blocked|list-closed|list-canceled)\n COMPREPLY=($(compgen -W \"--after --all --assignee --assignee_filter --assignee-filter --author --brief --compact --created-after --created-before --deadline-after --deadline-before --empty-body --fields --filter-ac-missing --filter-confidence-missing --filter-docs-missing --filter-estimate-missing --filter-estimates-missing --filter-files-missing --filter-metadata-missing --filter-release-missing --filter-resolution-missing --filter-reviewer-missing --filter-risk-missing --filter-sprint-missing --format --full --has-body --has-comments --has-deps --has-docs --has-files --has-learnings --has-linked-command --has-notes --has-tests --help --id-only --ids --include-body --json --limit --no-changed-fields --no-comments --no-deps --no-docs --no-extensions --no-files --no-learnings --no-linked-command --no-notes --no-pager --no-tests --no-truncate --offset --order --parent --path --pm-path --priority --profile --quiet --recent --release --sort --sprint --status --stream --tag --tags --today --tree --tree_depth --tree-depth --type --updated-after --updated-before\" -- \"$cur\"))\n ;;\n aggregate)\n COMPREPLY=($(compgen -W \"--group-by --count --completion --sum --avg --include-unparented --include_unparented --status --type --tag --priority --deadline-before --deadline-after --assignee --assignee-filter --assignee_filter --parent --sprint --release --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n create)\n COMPREPLY=($(compgen -W \"--ac --acceptance_criteria --acceptance-criteria --actual --actual_result --actual-result --add_tags --add-tags --affected_version --affected-version --allow-missing-parent --assignee --author --blocked_by --blocked_reason --blocked-by --blocked-reason --body --body-file --clear-comments --clear-deps --clear-docs --clear-events --clear-files --clear-learnings --clear-notes --clear-reminders --clear-tests --clear-type-options --comment --component --confidence --create_mode --create-mode --customer_impact --customer-impact --deadline --definition_of_ready --definition-of-ready --dep --description --doc --environment --estimate --estimated_minutes --estimated-minutes --event --expected --expected_result --expected-result --field --file --fixed_version --fixed-version --goal --help --id --id-only --impact --json --learning --message --no-changed-fields --no-extensions --no-pager --note --objective --order --outcome --parent --path --pm-path --priority --profile --quiet --rank --regression --release --reminder --reporter --repro_steps --repro-steps --resolution --reviewer --risk --schedule_preset --schedule-preset --severity --sprint --status --tag --tags --template --test --title --type --type_option --type-option --unblock_note --unblock-note --unset --value --why_now --why-now -b -d -p -s -t\" -- \"$cur\"))\n ;;\n copy)\n COMPREPLY=($(compgen -W \"--title --author --message --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n focus)\n COMPREPLY=($(compgen -W \"--clear --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n update)\n COMPREPLY=($(compgen -W \"--ac --acceptance_criteria --acceptance-criteria --actual --actual_result --actual-result --add_tags --add-tags --affected_version --affected-version --assignee --author --blocked_by --blocked_reason --blocked-by --blocked-reason --body --body-file --clear-comments --clear-deps --clear-docs --clear-events --clear-files --clear-learnings --clear-notes --clear-reminders --clear-tests --clear-type-options --close_reason --close-reason --comment --component --confidence --customer_impact --customer-impact --deadline --definition_of_ready --definition-of-ready --dep --dep_remove --dep-remove --description --doc --environment --estimate --estimated_minutes --estimated-minutes --event --expected --expected_result --expected-result --field --file --fixed_version --fixed-version --force --goal --help --id-only --impact --json --learning --message --no-changed-fields --no-extensions --no-pager --note --objective --order --outcome --parent --path --pm-path --priority --profile --quiet --rank --regression --release --reminder --remove_tags --remove-tags --replace-deps --replace-tests --reporter --repro_steps --repro-steps --resolution --reviewer --risk --severity --sprint --status --tag --tags --test --title --type --type_option --type-option --unblock_note --unblock-note --unset --value --why_now --why-now -b -d -p -s -t\" -- \"$cur\"))\n ;;\n update-many)\n COMPREPLY=($(compgen -W \"--ac --acceptance_criteria --acceptance-criteria --actual --actual_result --actual-result --add_tags --add-tags --affected_version --affected-version --author --body --clear-comments --clear-deps --clear-docs --clear-events --clear-files --clear-learnings --clear-notes --clear-reminders --clear-tests --clear-type-options --comment --component --confidence --customer_impact --customer-impact --deadline --definition_of_ready --definition-of-ready --dep --dep_remove --dep-remove --description --doc --dry-run --environment --estimate --estimated_minutes --estimated-minutes --event --expected --expected_result --expected-result --file --filter-ac-missing --filter-assignee --filter-assignee_filter --filter-assignee-filter --filter-confidence-missing --filter-created-after --filter-created-before --filter-deadline-after --filter-deadline-before --filter-empty-body --filter-estimate-missing --filter-estimates-missing --filter-has-body --filter-has-comments --filter-has-deps --filter-has-docs --filter-has-files --filter-has-learnings --filter-has-linked-command --filter-has-notes --filter-has-tests --filter-metadata-missing --filter-no-comments --filter-no-deps --filter-no-docs --filter-no-files --filter-no-learnings --filter-no-linked-command --filter-no-notes --filter-no-tests --filter-parent --filter-priority --filter-release --filter-release-missing --filter-resolution-missing --filter-reviewer-missing --filter-risk-missing --filter-sprint --filter-sprint-missing --filter-status --filter-tag --filter-type --filter-updated-after --filter-updated-before --fixed_version --fixed-version --force --goal --help --id-only --ids --impact --json --learning --limit --message --no-changed-fields --no-checkpoint --no-extensions --no-pager --note --objective --offset --order --outcome --path --pm-path --priority --profile --quiet --rank --regression --release --reminder --remove_tags --remove-tags --replace-deps --replace-tests --reporter --repro_steps --repro-steps --resolution --reviewer --risk --rollback --severity --sprint --tag --tags --test --title --type --type_option --type-option --unset --value --why_now --why-now -b -d -p -t\" -- \"$cur\"))\n ;;\n calendar|cal)\n COMPREPLY=($(compgen -W \"--assignee --assignee_filter --assignee-filter --author --date --format --from --full_period --full-period --help --id-only --include --json --limit --no-changed-fields --no-extensions --no-pager --occurrence-limit --past --path --pm-path --priority --profile --quiet --recurrence-lookahead-days --recurrence-lookback-days --release --sprint --status --tag --to --type --view\" -- \"$cur\"))\n ;;\n context|ctx)\n COMPREPLY=($(compgen -W \"--activity-limit --after --assignee --assignee_filter --assignee-filter --author --date --depth --explain_ranking --explain-ranking --fields --format --from --help --id-only --json --limit --max-items --no-changed-fields --no-extensions --no-pager --parent --past --path --pm-path --priority --profile --quiet --release --section --sprint --stale-threshold --tag --to --type\" -- \"$cur\"))\n ;;\n next)\n COMPREPLY=($(compgen -W \"--type --tag --priority --assignee --assignee-filter --assignee_filter --sprint --release --parent --limit --blocked-limit --blocked_limit --ready-only --ready_only --format --explain-ranking --explain_ranking --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n guide)\n COMPREPLY=($(compgen -W \"--list --format --depth --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author commands extensions harnesses quickstart release sdk skills workflows\" -- \"$cur\"))\n ;;\n search)\n COMPREPLY=($(compgen -W \"--after --assignee --author --compact --count --created-after --created-before --deadline-after --deadline-before --empty-body --fields --filter-confidence-missing --filter-docs-missing --filter-files-missing --filter-release-missing --filter-reviewer-missing --filter-risk-missing --filter-sprint-missing --format --full --has-body --has-comments --has-deps --has-docs --has-files --has-learnings --has-linked-command --has-notes --has-tests --help --highlight --hybrid --id-only --include-linked --json --limit --match-mode --min-score --mode --no-changed-fields --no-comments --no-deps --no-docs --no-extensions --no-files --no-learnings --no-linked-command --no-notes --no-pager --no-tests --parent --path --phrase-exact --pm-path --priority --profile --quiet --release --semantic --semantic-weight --sprint --status --tag --tags --title-exact --type --updated-after --updated-before\" -- \"$cur\"))\n ;;\n reindex)\n COMPREPLY=($(compgen -W \"--mode --progress --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n init)\n COMPREPLY=($(compgen -W \"--id-prefix --prefix --preset --type-preset -y --defaults --yes --author --agent-guidance --with-packages --workspace --force --verbose --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n config)\n COMPREPLY=($(compgen -W \"--criterion --clear-criteria --format --policy --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n extension)\n COMPREPLY=($(compgen -W \"init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate --init --scaffold --capability --install --uninstall --explore --list --manage --describe --markdown --output --reload --watch --doctor --catalog --adopt --adopt-all --activate --deactivate --project --local --global --gh --github --ref --detail --trace --runtime-probe --fix-managed-state --isolated --ignore-global --strict-exit --fail-on-warn --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n package|packages)\n COMPREPLY=($(compgen -W \"init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate --init --scaffold --capability --install --uninstall --explore --list --manage --describe --markdown --output --reload --watch --doctor --catalog --adopt --adopt-all --activate --deactivate --project --local --global --gh --github --ref --detail --trace --runtime-probe --fix-managed-state --isolated --ignore-global --strict-exit --fail-on-warn --declarative --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n comments)\n COMPREPLY=($(compgen -W \"--add --body --stdin --file --edit --delete --limit --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n notes)\n COMPREPLY=($(compgen -W \"--add --stdin --file --edit --delete --limit --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n learnings)\n COMPREPLY=($(compgen -W \"--add --stdin --file --edit --delete --limit --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n files)\n COMPREPLY=($(compgen -W \"discover --add --add-glob --remove --migrate --list --apply --note --append-stable --validate-paths --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n docs)\n COMPREPLY=($(compgen -W \"--add --add-glob --remove --migrate --note --validate-paths --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n append)\n COMPREPLY=($(compgen -W \"-b --body --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n deps)\n COMPREPLY=($(compgen -W \"--format --max-depth --collapse --summary --node-limit --edge-limit --token-budget --cursor --direction --kind --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n graph)\n COMPREPLY=($(compgen -W \"ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators plan --kind --max-depth --limit --after --direction --max-paths --sample --exempt-isolate --summary --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n test)\n COMPREPLY=($(compgen -W \"--add --add-json --remove --list --run --match --only-index --only-last --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n test-all)\n COMPREPLY=($(compgen -W \"--status --limit --offset --background --timeout --progress --env-set --env-clear --shared-host-safe --pm-context --override-linked-pm-context --fail-on-context-mismatch --fail-on-skipped --fail-on-empty-test-run --require-assertions-for-pm --check-context --auto-pm-context --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n test-runs)\n COMPREPLY=($(compgen -W \"list status logs stop resume --status --limit --stream --tail --force --author --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n validate)\n COMPREPLY=($(compgen -W \"--check-metadata --metadata-profile --check-resolution --check-lifecycle --check-stale-blockers --dependency-cycle-severity --parent-cycle-severity --check-files --scan-mode --include-pm-internals --verbose-file-lists --verbose-diagnostics --all-affected-ids --strict-exit --fail-on-warn --fix-hints --auto-fix --dry-run --fix-scope --prune-missing --check-history-drift --check-command-references --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n health)\n COMPREPLY=($(compgen -W \"--strict-directories --strict-exit --fail-on-warn --check-only --check-telemetry --no-refresh --refresh-vectors --verbose-stale-items --brief --summary --skip-vectors --skip-integrity --skip-drift --full --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n history)\n COMPREPLY=($(compgen -W \"--limit --compact --full --diff --field --verify --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n history-compact)\n COMPREPLY=($(compgen -W \"--before --ids --all-over --closed --all-streams --min-entries --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n get)\n COMPREPLY=($(compgen -W \"--depth --full --fields --at --tree --tree-depth --tree_depth --format --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n history-redact)\n COMPREPLY=($(compgen -W \"--literal --regex --replacement --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n history-repair)\n COMPREPLY=($(compgen -W \"--all --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n schema)\n COMPREPLY=($(compgen -W \"list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset --description --default-status --folder --alias --role --order --type --commands --cli-flag --required --required-on-create --no-allow-unset --required-types --infer --min-count --apply --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n profile)\n COMPREPLY=($(compgen -W \"list show apply lint agile ops research --dry-run --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n plan)\n COMPREPLY=($(compgen -W \"create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize --title --description --scope --parent --related --blocks --blocked-by --blocked_by --harness --mode --resume-context --resume_context --tags --tag --priority --body --claim --from-search --from_search --template --step-title --step_title --step --step-body --step_body --step-owner --step_owner --step-status --step_status --step-evidence --step_evidence --step-blocked-reason --step_blocked_reason --step-replacement --step_replacement --depends-on --depends_on --link --link-kind --link_kind --link-note --link_note --promote-to-item-dep --promote_to_item_dep --allow-multiple-active --allow_multiple_active --file --test --doc --decision-text --decision_text --decision --decision-rationale --decision_rationale --decision-evidence --decision_evidence --discovery-text --discovery_text --discovery --validation-text --validation_text --validation --validation-command --validation_command --validation-expected --validation_expected --depth --field --fields --steps --materialize-type --materialize_type --materialize-parent --materialize_parent --materialize-tags --materialize_tags --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n activity)\n COMPREPLY=($(compgen -W \"--id --op --author --from --to --limit --compact --full --stream --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n contracts)\n COMPREPLY=($(compgen -W \"--action --command --summary --schema-only --flags-only --availability-only --runtime-only --active-only --full --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author\" -- \"$cur\"))\n ;;\n gc)\n COMPREPLY=($(compgen -W \"--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n stats)\n COMPREPLY=($(compgen -W \"--storage --metadata-coverage --field-utilization --by-assignee --by-tag --by-priority --tag-prefix --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n close|close-task)\n COMPREPLY=($(compgen -W \"--author --message --validate-close --duplicate-of --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n close-many)\n COMPREPLY=($(compgen -W \"--filter-status --filter-type --filter-tag --filter-priority --filter-deadline-before --filter-deadline-after --filter-updated-after --filter-updated-before --filter-created-after --filter-created-before --filter-assignee --filter-assignee-filter --filter-assignee_filter --filter-parent --filter-sprint --filter-release --filter-reviewer-missing --filter-risk-missing --filter-confidence-missing --filter-sprint-missing --filter-release-missing --filter-has-notes --filter-no-notes --filter-has-learnings --filter-no-learnings --filter-has-files --filter-no-files --filter-has-docs --filter-no-docs --filter-has-tests --filter-no-tests --filter-has-comments --filter-no-comments --filter-has-deps --filter-no-deps --filter-has-body --filter-empty-body --filter-has-linked-command --filter-no-linked-command --ids --limit --offset --reason --resolution --expected-result --expected_result --expected --actual-result --actual_result --actual --validate-close --author --message --force --dry-run --rollback --no-checkpoint --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n release)\n COMPREPLY=($(compgen -W \"--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n delete)\n COMPREPLY=($(compgen -W \"--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n claim|restore|start-task|pause-task)\n COMPREPLY=($(compgen -W \"--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n meet|event)\n COMPREPLY=($(compgen -W \"--start --duration --end --location --timezone --all-day --parent --allow-missing-parent --tags --priority --body --description --author --message --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n remind)\n COMPREPLY=($(compgen -W \"--at --text --parent --allow-missing-parent --tags --priority --body --description --author --message --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help\" -- \"$cur\"))\n ;;\n completion)\n COMPREPLY=($(compgen -W \"--eager-tags --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author bash zsh fish\" -- \"$cur\"))\n ;;\n templates)\n COMPREPLY=($(compgen -W \"save list show\" -- \"$cur\"))\n ;;\n *)\n COMPREPLY=($(compgen -W \"--json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help --author --version\" -- \"$cur\"))\n ;;\n esac\n return 0\n}\n\ncomplete -F _pm_completion pm verbs or an explicit internal registry.\\n\\n## Verification\\nMeasure root-help and compact-contract token deltas; snapshot the generated bash/zsh/fish scripts; execute each completion path against built-in plus custom types/statuses/tags; prove old helper spellings remain compatibility aliases or internal entrypoints until the grammar migration policy permits removal.\\n\\n## Duplicate check\\nAll-status exact-title searches for each helper returned zero items. Focused all-term search for runtime resolved shell completion helper hiding found only closed general help/completion work and no focused open owner. Related scopes are pm-e2bq (tiered help), pm-mu8m (generated completion/contracts surfaces), and pm-lp4j (internal worker hiding)."},{"op":"add","path":"/metadata/id","value":"pm-szdc"},{"op":"add","path":"/metadata/title","value":"Hide runtime completion helper entrypoints from the default agent-facing command surface"},{"op":"add","path":"/metadata/description","value":"The live 2026-07-18 root command census exposes completion-statuses, completion-tags, and completion-types as ordinary top-level commands even though they are runtime plumbing used by generated shell completion scripts. Preserve every completion capability and explicit internal invocation path, but hide these helpers from default help, compact contracts, docs, MCP discovery, and the canonical grammar budget."},{"op":"add","path":"/metadata/type","value":"Task"},{"op":"add","path":"/metadata/status","value":"open"},{"op":"add","path":"/metadata/priority","value":2},{"op":"add","path":"/metadata/tags","value":["agent-ux","area:cli","area:contracts","completion","internal-command","simplification","token-efficiency"]},{"op":"add","path":"/metadata/created_at","value":"2026-07-18T14:04:52.766Z"},{"op":"add","path":"/metadata/updated_at","value":"2026-07-18T14:04:52.766Z"},{"op":"add","path":"/metadata/author","value":"codex-ecosystem-planner"},{"op":"add","path":"/metadata/estimated_minutes","value":120},{"op":"add","path":"/metadata/acceptance_criteria","value":"Default pm --help and compact contracts do not list completion-statuses, completion-tags, or completion-types; generated bash/zsh/fish completion still resolves runtime statuses, tags, and types; an explicit internal or completion-plumbing discovery path remains testable; byte-for-byte completion behavior and exit semantics are preserved; snapshots, contracts, docs, and token-budget baselines prove zero feature loss and reduced default surface."},{"op":"add","path":"/metadata/parent","value":"pm-n7rr"},{"op":"add","path":"/metadata/risk","value":"low"},{"op":"add","path":"/metadata/confidence","value":"high"},{"op":"add","path":"/metadata/dependencies","value":[{"id":"pm-e2bq","kind":"related","created_at":"2026-07-18T14:04:52.766Z","author":"codex-ecosystem-planner"},{"id":"pm-lp4j","kind":"related","created_at":"2026-07-18T14:04:52.766Z","author":"codex-ecosystem-planner"},{"id":"pm-mu8m","kind":"related","created_at":"2026-07-18T14:04:52.766Z","author":"codex-ecosystem-planner"}]}],"before_hash":"3cc22dff72be7b14824654a7a64ea62b04799939b2fee54c1b5f52ca60bf6df0","after_hash":"258a300e61c5152ec550f6f9624ad645b5d75f219bac9ffc3481ab8db8c772cc","message":""} | |||
There was a problem hiding this comment.
The JSON Lines format requires each line to be a single, valid JSON value. In this history entry, the "body" patch value contains literal newline characters (\n) rather than escaped newlines (\\n). This splits the single JSON object across multiple lines, corrupting the JSONL structure and causing parsers to fail. All newlines within JSON string values must be properly escaped.
Preserve public completion generation and test-all compatibility while distinguishing canonical user-facing nouns from internal runtime helper entrypoints. Record the clarification through immutable pm history with zero feature loss.
unbraind
added a commit
that referenced
this pull request
Jul 19, 2026
…reconciled clean (4e12 transaction waiver retired, 8ngt held open over kr3t, resolution 276 zero-leak); maintainer dogfood merge-safety wave filed as 14 items GH-595/598-604/606-609/611/612 (wc1r/9q2t/m3nl/wwfd/xdn6/gpo7/ol3p under g5sx, cxyv under 33cw, pibw under dj98, 4uqm/wrss/xh82 under mpbb, x29o/n1xx under usfg) with family map + execution order on g5sx; GH-610 mapped to i6pi as dup; GH-596/597 pm-links backfilled; census 1886n/3171e/242a zero actionable Co-Authored-By: Claude Fable 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_014XYPB6bCGL5t41DLywtcKW
Owner
Author
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
Why
The CLI currently exposes 73 top-level names. Every user capability already maps to an existing simplification slice or a proper extension-owned/noun-verb surface, except three completion plumbing commands that still appear as first-class root commands. The roadmap needed current, status-agnostic evidence without creating duplicate umbrella work.
Impact
This is tracker-only planning and governance. It does not implement the future CLI change or modify product code. It gives future agents a duplicate-safe execution map for command simplification, SDK ownership, token-efficient context, extreme scale, immutable audit history, federation, VCS/digital-twin exemplars, and governance.
Validation
npm install -g .,pm --version,pnpm buildpm list --status all --full --include-bodyandpm activity --fullinventorypm validate --check-resolution --check-history-drift --json(ok; zero history drift; unchanged owned historical warnings)pm health --check-only(unchanged five unknown-author events owned by pm-h90s)pm graph audit --json(zero actionable findings; zero active isolates)pnpm changelog:pm:checkpnpm security:scangit diff --checkSummary by cubic
Completed a full audit of the living roadmap (1,866 items, 30,491 history events) and refreshed epics for CLI simplification, SDK-first boundaries, million-item context ranking, and append-only history guarantees.
Added
pm-szdcand clarified completion vs bulk-test grammar to hide runtime helper entrypoints while keeping bash/zsh/fish completion and test-all working. Linked governance evidence to this PR and revalidated changelog and immutable history; tracker-only, no product code changes.Written for commit 060fa04. Summary will update on new commits.