@unbrained/pm-cli 2026.9.8 → 2026.9.10

package/dist/sdk/completion.js

@@ -1,5 +1,5 @@
-!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="56fd6790-568a-5c97-ab94-4b645aaa3718")}catch(e2){}})();import{EXIT_CODE,PmCliError}from"./runtime-primitives.js";import{listPmCommandsForTier}from"./agent-capability-contracts.js";import{SCAFFOLD_CAPABILITIES}from"./extension/scaffold.js";import{AGGREGATE_FLAG_CONTRACTS,APPEND_FLAG_CONTRACTS,CALENDAR_FLAG_CONTRACTS,CLOSE_MANY_FLAG_CONTRACTS,COMPLETION_FLAG_CONTRACTS,CONTRACTS_FLAG_CONTRACTS,CONTEXT_FLAG_CONTRACTS,COPY_FLAG_CONTRACTS,FOCUS_FLAG_CONTRACTS,MEET_FLAG_CONTRACTS,REMIND_FLAG_CONTRACTS,CREATE_FLAG_CONTRACTS,DEPS_FLAG_CONTRACTS,DUPLICATES_FLAG_CONTRACTS,EXTENSION_FLAG_CONTRACTS,GRAPH_FLAG_CONTRACTS,GET_FLAG_CONTRACTS,GUIDE_FLAG_CONTRACTS,GLOBAL_FLAG_CONTRACTS,HEALTH_FLAG_CONTRACTS,HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS,HISTORY_FLAG_CONTRACTS,INIT_FLAG_CONTRACTS,LIST_FILTER_FLAG_CONTRACTS,NEXT_FLAG_CONTRACTS,PM_COMMAND_ALIAS_CONTRACTS,PM_HISTORY_COMMAND_ALIASES,resolveSubcommandFlagContractsForCommand,PACKAGE_FLAG_CONTRACTS,PLAN_FLAG_CONTRACTS,SEARCH_FLAG_CONTRACTS,STATS_FLAG_CONTRACTS,EVENTS_FLAG_CONTRACTS,UPDATE_FLAG_CONTRACTS,UPDATE_MANY_FLAG_CONTRACTS,UPGRADE_FLAG_CONTRACTS,toCompletionFlagString}from"./cli-contracts.js";import{BUILTIN_ITEM_TYPE_VALUES,STATUS_VALUES}from"../types/index.js";import{listGuideTopicIds}from"./guide-topics.js";import{enrichCliFlagInvocationContracts}from"./flag-invocation-contracts.js";import{GLOBAL_VALUE_CONSUMING_FLAGS}from"./cli-contracts/bootstrap-command-scanner.js";const VALID_SHELLS=["bash","zsh","fish"];const DEFAULT_ITEM_TYPES=[...BUILTIN_ITEM_TYPE_VALUES];const DEFAULT_STATUS_VALUES=[...STATUS_VALUES];const HIDDEN_COMMAND_ALIASES=new Set(PM_COMMAND_ALIAS_CONTRACTS.filter(contract=>contract.hidden).map(contract=>contract.alias));const ALL_COMMANDS=listPmCommandsForTier("full").filter(command=>!HIDDEN_COMMAND_ALIASES.has(command));const LIST_FLAGS=toCompletionFlagString(LIST_FILTER_FLAG_CONTRACTS);const AGGREGATE_FLAGS=toCompletionFlagString(AGGREGATE_FLAG_CONTRACTS);const APPEND_FLAGS=toCompletionFlagString(APPEND_FLAG_CONTRACTS);const COPY_FLAGS=toCompletionFlagString(COPY_FLAG_CONTRACTS);const RESTORE_INVOCATIONS=enrichCliFlagInvocationContracts("restore",resolveSubcommandFlagContractsForCommand("restore"));const FOCUS_FLAGS=toCompletionFlagString(FOCUS_FLAG_CONTRACTS);const MEET_FLAGS=toCompletionFlagString(MEET_FLAG_CONTRACTS);const REMIND_FLAGS=toCompletionFlagString(REMIND_FLAG_CONTRACTS);const CREATE_FLAGS=toCompletionFlagString(CREATE_FLAG_CONTRACTS);const GET_FLAGS=toCompletionFlagString(GET_FLAG_CONTRACTS);const UPDATE_FLAGS=toCompletionFlagString(UPDATE_FLAG_CONTRACTS);const UPDATE_MANY_FLAGS=toCompletionFlagString(UPDATE_MANY_FLAG_CONTRACTS);const CLOSE_MANY_FLAGS=toCompletionFlagString(CLOSE_MANY_FLAG_CONTRACTS);const HISTORY_LEAVES=PM_HISTORY_COMMAND_ALIASES.map(entry=>entry.canonical_argv[1]).join(" ");const HISTORY_OPERATION_FLAGS=PM_HISTORY_COMMAND_ALIASES.map(entry=>({...entry,flags:toCompletionFlagString(resolveSubcommandFlagContractsForCommand(entry.alias))}));const HISTORY_FLAGS=toCompletionFlagString(HISTORY_FLAG_CONTRACTS);const HISTORY_AUTHOR_ACKNOWLEDGE_FLAGS=toCompletionFlagString(HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS,false);const EVENTS_FLAGS=toCompletionFlagString(EVENTS_FLAG_CONTRACTS);const CALENDAR_FLAGS=toCompletionFlagString(CALENDAR_FLAG_CONTRACTS);const CONTEXT_FLAGS=toCompletionFlagString(CONTEXT_FLAG_CONTRACTS);const NEXT_FLAGS=toCompletionFlagString(NEXT_FLAG_CONTRACTS);const DEPS_FLAGS=toCompletionFlagString(DEPS_FLAG_CONTRACTS);const DUPLICATES_FLAGS=toCompletionFlagString(DUPLICATES_FLAG_CONTRACTS);const GRAPH_FLAGS=toCompletionFlagString(GRAPH_FLAG_CONTRACTS);const GUIDE_FLAGS=toCompletionFlagString(GUIDE_FLAG_CONTRACTS);const SEARCH_FLAGS=toCompletionFlagString(SEARCH_FLAG_CONTRACTS);const STATS_FLAGS=toCompletionFlagString(STATS_FLAG_CONTRACTS);const HEALTH_FLAGS=toCompletionFlagString(HEALTH_FLAG_CONTRACTS);const INIT_FLAGS=toCompletionFlagString(INIT_FLAG_CONTRACTS);const CONTRACTS_FLAGS=toCompletionFlagString(CONTRACTS_FLAG_CONTRACTS);const PLAN_FLAGS=toCompletionFlagString(PLAN_FLAG_CONTRACTS);const PLAN_SUBCOMMANDS_LIST="create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize";const COMPLETION_FLAGS=toCompletionFlagString(COMPLETION_FLAG_CONTRACTS);const COMPLETION_SHELL_CHOICES=`${COMPLETION_FLAGS} bash zsh fish`;const GUIDE_TOPIC_CHOICES=joinCompletionValues(listGuideTopicIds());const EXTENSION_LIFECYCLE_ACTIONS="init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate migrate";const PACKAGE_LIFECYCLE_ACTIONS=`${EXTENSION_LIFECYCLE_ACTIONS} upgrade`;const EXTENSION_LIFECYCLE_FLAGS=toCompletionFlagString(EXTENSION_FLAG_CONTRACTS);const PACKAGE_LIFECYCLE_FLAGS=toCompletionFlagString(PACKAGE_FLAG_CONTRACTS);const UPGRADE_FLAGS=toCompletionFlagString(UPGRADE_FLAG_CONTRACTS);const MUTATION_FLAGS="--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";const DELETE_MUTATION_FLAGS="--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";const CLOSE_MUTATION_FLAGS="--author --message --validate-close --duplicate-of --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";const RELEASE_MUTATION_FLAGS="--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";const COMMAND_COMPLETION_DESCRIPTIONS=[["init","Initialize pm storage for the current workspace"],["config","Read or update pm settings"],["package","Manage package lifecycle operations"],["packages","Alias for package"],["create","Create a new project management item"],["copy","Copy an existing item to a new ID"],["focus","Set/clear/show the session focused parent for new items"],["list","List active items with optional filters"],["aggregate","Aggregate grouped item counts and numeric stats for governance queries"],["duplicates","Find bounded duplicate clusters across lifecycle statuses"],["guide","Browse local progressive-disclosure guides"],["calendar","Show calendar views for deadlines and reminders"],["cal","Alias for calendar"],["context","Show a token-efficient project context snapshot"],["ctx","Alias for context"],["get","Show item details by ID"],["next","Recommend the next actionable (unblocked, ready) work item"],["search","Search items with keyword, semantic, or hybrid modes"],["reindex","Rebuild search artifacts"],["history","Show item history entries"],["history-compact","Compact history streams into a synthetic baseline + retained tail"],["history-redact","Redact sensitive literals/patterns and recompute history hashes"],["history-repair","Re-anchor a drifted history chain so pm health/validate report ok"],["schema","Manage custom item types and statuses in .agents/pm/schema/*.json"],["profile","List, show, apply, and lint project profiles (archetype schema/config/template/package bundles)"],["plan","Agent-optimized Plan item workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)"],["activity","Show recent activity across items"],["restore","Restore an item to an earlier state"],["update","Update item fields and metadata"],["update-many","Bulk-update matched items with dry-run and rollback checkpoints"],["close","Close an item (reason requirement follows governance settings)"],["close-many","Bulk-close matched items with an optional shared reason and rollback checkpoint"],["delete","Delete an item and record the change"],["append","Append text to an item body"],["comments","List or add comments for an item"],["notes","List or add notes for an item"],["learnings","List or add learnings for an item"],["files","Manage linked files"],["docs","Manage linked docs"],["deps","Show dependency relationships for an item"],["graph","Bounded graph traversal, analytics, and governance-audit queries"],["test","Manage linked tests and optionally run them"],["test-all","Run linked tests across matching items"],["test-runs","Manage background linked-test runs"],["stats","Show project tracker statistics"],["health","Show project tracker health checks"],["validate","Run standalone validation checks"],["gc","Clean optional cache artifacts"],["contracts","Show machine-readable command and schema contracts"],["claim","Claim an item for active work"],["release","Release the active claim for an item"],["start-task","Lifecycle alias to claim and set in_progress"],["pause-task","Lifecycle alias to reopen and release claim"],["close-task","Lifecycle alias to close and release claim"],["meet","Shortcut to create a Meeting with scheduling defaults"],["event","Shortcut to create an Event with scheduling defaults"],["remind","Shortcut to create a Reminder from a point in time"],["templates","Manage reusable create templates"],["completion","Generate shell completion"],["help","Display help for a command"]];const FISH_COMMAND_DESCRIPTION_OVERRIDES=new Map([["calendar","Show deadline/reminder calendar views"],["schema","Inspect and manage runtime schema"],["profile","List, show, apply, and lint project profiles (archetype bundles)"],["plan","Agent-optimized Plan workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)"],["start-task","Lifecycle alias to claim and set in-progress"]]);const GLOBAL_FLAGS=GLOBAL_FLAG_CONTRACTS.flatMap(entry=>[entry.short,entry.flag,...entry.aliases??[]]).filter(value=>Boolean(value)).join(" ");const GLOBAL_COMPLETION_VALUE_PATTERNS=[...GLOBAL_VALUE_CONSUMING_FLAGS].join("|");const GLOBAL_COMPLETION_INLINE_PATTERNS=[...GLOBAL_VALUE_CONSUMING_FLAGS].map(flag=>`${flag}=*`).join("|");const GLOBAL_COMPLETION_SWITCH_PATTERNS=[...GLOBAL_FLAGS.split(" ").filter(flag=>!GLOBAL_VALUE_CONSUMING_FLAGS.has(flag)),"-h","-V"].join("|");function joinCompletionValues(values){return[...new Set(values.map(value=>value.trim()).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right)).join(" ")}function joinCompletionValuesInOrder(values){return[...new Set(values.map(value=>value.trim()).filter(value=>value.length>0))].join(" ")}function shellDoubleQuote(value){return value.replaceAll("\\","\\\\").replaceAll('"','\\"').replaceAll("$","\\$").replaceAll("`","\\`")}function completionTypeValues(itemTypes,runtime){return joinCompletionValuesInOrder(itemTypes.length>0?itemTypes:runtime.item_types??DEFAULT_ITEM_TYPES)}function completionStatusValues(runtime){return joinCompletionValues(runtime.statuses??DEFAULT_STATUS_VALUES)}function mergeFlagStrings(baseFlags,runtimeFlags){const merged=[...baseFlags.split(/\s+/u).filter(value=>value.length>0),...runtimeFlags??[]];return joinCompletionValues(merged)}function normalizeRuntimeCompletionFlags(runtimeFlags){const normalized=(runtimeFlags??[]).map(value=>value.trim()).filter(value=>value.startsWith("--")&&value.length>2).map(value=>`--${value.slice(2).replaceAll("_","-")}`);return[...new Set(normalized)].sort((left,right)=>left.localeCompare(right))}function renderZshRuntimeFieldFlagSpecs(runtimeFlags){const normalized=normalizeRuntimeCompletionFlags(runtimeFlags);if(normalized.length===0){return""}return`${normalized.map(flag=>`            '${flag}[Runtime schema field flag]:value' \\`).join("\n")}
-`}function renderZshArgumentSpecs(specs,options={}){const trailingContinuation=options.trailingContinuation??true;const lastSpecIndex=specs.length-1;return specs.map((spec,index)=>`            ${spec}${trailingContinuation||index!==lastSpecIndex?" \\":""}`).join("\n")}function renderZshCommandDescriptions(){return COMMAND_COMPLETION_DESCRIPTIONS.filter(([command])=>!HIDDEN_COMMAND_ALIASES.has(command)).map(([command,description])=>`    '${command}:${description}'`).join("\n")}function renderFishCommandDescriptions(){return COMMAND_COMPLETION_DESCRIPTIONS.filter(([command])=>command!=="help"&&!HIDDEN_COMMAND_ALIASES.has(command)).map(([command,description])=>{const fishDescription=FISH_COMMAND_DESCRIPTION_OVERRIDES.get(command)??description;return`complete -c pm -n __pm_no_subcommand -a ${command.padEnd(16)} -d '${fishDescription}'`}).join("\n")}function renderZshPresenceFilterSpecs(options){const missingSpecs=["reviewer-missing[Select only items missing reviewer]","risk-missing[Select only items missing risk]","confidence-missing[Select only items missing confidence]","sprint-missing[Select only items missing sprint]","release-missing[Select only items missing release]"];const contentMissingAliasSpecs=options.includeContentMissingAliases===true?["files-missing[Alias for --no-files]","docs-missing[Alias for --no-docs]"]:[];const pairedSpecs=[["has-notes[Select only items that have notes]","no-notes[Select only items with no notes]"],["has-learnings[Select only items that have learnings]","no-learnings[Select only items with no learnings]"],["has-files[Select only items that have linked files]","no-files[Select only items with no linked files]"],["has-docs[Select only items that have linked docs]","no-docs[Select only items with no linked docs]"],["has-tests[Select only items that have linked tests]","no-tests[Select only items with no linked tests]"],["has-comments[Select only items that have comments]","no-comments[Select only items with no comments]"],["has-deps[Select only items that have dependencies]","no-deps[Select only items with no dependencies]"],["has-body[Select only items with non-empty body]","empty-body[Select only items with empty body]"],["has-linked-command[Select only items that have a linked command]","no-linked-command[Select only items with no linked command]"]];return renderZshArgumentSpecs([...[...missingSpecs,...contentMissingAliasSpecs].map(spec=>`'--${options.missingPrefix}${spec}'`),...pairedSpecs.flatMap(([positive,negative])=>[`'--${options.pairedPrefix}${positive}'`,`'--${options.pairedPrefix}${negative}'`])])}const ZSH_MUTATION_COLLECTION_ARGUMENT_SPECS=["'--comment[Comment seed author=<value>,created_at=<iso|now>,text=<value>]:comment'","'--note[Note seed author=<value>,created_at=<iso|now>,text=<value>]:note'","'--learning[Learning seed author=<value>,created_at=<iso|now>,text=<value>]:learning'","'--file[Linked file path=<value>,scope=<project|global>,note=<text>]:file'","'--test[Linked test command=<value>,path=<value>,scope=<project|global>]:test'","'--doc[Linked doc path=<value>,scope=<project|global>,note=<text>]:doc'","'--reminder[Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>]:reminder'","'--event[Event entry start=<iso|relative>,end=<iso|relative>,recur_*]:event'","'--type-option[Type option key=value or key=<name>,value=<value>]:type_option'","'--unset[Clear scalar metadata field by name]:field'","'--replace-files[Atomically replace linked files with provided --file values]'","'--replace-docs[Atomically replace linked docs with provided --doc values]'","'--clear-deps[Clear dependency entries]'","'--clear-comments[Clear comments]'","'--clear-notes[Clear notes]'","'--clear-learnings[Clear learnings]'","'--clear-files[Clear linked files]'","'--clear-tests[Clear linked tests]'","'--clear-docs[Clear linked docs]'","'--clear-reminders[Clear reminders]'","'--clear-events[Clear events]'","'--clear-type-options[Clear type options]'"];function renderZshScheduleItemSpecs(kind){const leadingSpecs=kind==="reminder"?["'--at[Reminder time (default +1d)]:at'","'--text[Reminder text (defaults to title)]:text'"]:["'--start[Start time (ISO, now, or relative)]:start'","'--duration[Duration from start (default 1h)]:duration'","'--end[End time (overrides --duration)]:end'","'--location[Location]:location'","'--timezone[IANA timezone]:timezone'","'--all-day[Mark as an all-day event]'"];return renderZshArgumentSpecs([...leadingSpecs,"'--parent[Parent item id]:parent'","'--allow-missing-parent[Permit a parent id that does not exist yet]'","'--tags[Comma-separated tags]:tags'","'(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)'","'(-b --body)'{-b,--body}'[Item body]:body'","'(-d --description)'{-d,--description}'[Short description]:description'","'--author[Mutation author]:author'","'--message[History message]:message'","'--json[Output JSON]'","'--quiet[Suppress stdout]'"],{trailingContinuation:false})}function renderZshBulkSelectionFilterSpecs(action,statusChoices,typeChoices,tagChoices){return renderZshArgumentSpecs([`'--filter-status[Filter by status before ${action}]:(${statusChoices})'`,`'--filter-type[Filter by type before ${action}]:(${typeChoices})'`,`'--filter-tag[Filter by tag before ${action}]:(${tagChoices})'`,`'--filter-priority[Filter by priority before ${action}]:(0 1 2 3 4)'`,"'--filter-deadline-before[Filter by deadline upper bound]:deadline'","'--filter-deadline-after[Filter by deadline lower bound]:deadline'","'--filter-updated-after[Filter by updated_at lower bound (ISO/relative)]:timestamp'","'--filter-updated-before[Filter by updated_at upper bound (ISO/relative)]:timestamp'","'--filter-created-after[Filter by created_at lower bound (ISO/relative)]:timestamp'","'--filter-created-before[Filter by created_at upper bound (ISO/relative)]:timestamp'",`'--filter-assignee[Filter by assignee before ${action}]:assignee'`,"'--filter-assignee-filter[Filter assignee presence]:(assigned unassigned)'","'--filter-parent[Filter by parent item ID]:parent'","'--filter-sprint[Filter by sprint]:sprint'","'--filter-release[Filter by release]:release'"])}function renderFishRuntimeFieldFlagSpecs(commands,runtimeFlags){const normalizedFlags=normalizeRuntimeCompletionFlags(runtimeFlags).map(flag=>flag.slice(2));if(commands.length===0||normalizedFlags.length===0){return""}const lines=[];for(const command of commands){for(const flag of normalizedFlags){lines.push(`complete -c pm -n '__fish_seen_subcommand_from ${command}' -l ${flag} -d 'Runtime schema field flag' -r`)}}return`${lines.join("\n")}
+!(function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=new e.Error().stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="961951cf-e644-50ae-becc-205bea47225d")}catch(e2){}})();import{WORKFLOW_POLICY_ACTIONS}from"./cli-contracts/enum-contracts.js";import{EXIT_CODE,PmCliError}from"./runtime-primitives.js";import{listPmCommandsForTier}from"./agent-capability-contracts.js";import{SCAFFOLD_CAPABILITIES}from"./extension/scaffold.js";import{AGGREGATE_FLAG_CONTRACTS,APPEND_FLAG_CONTRACTS,CALENDAR_FLAG_CONTRACTS,CLOSE_MANY_FLAG_CONTRACTS,COMPLETION_FLAG_CONTRACTS,CONTRACTS_FLAG_CONTRACTS,CONTEXT_FLAG_CONTRACTS,COPY_FLAG_CONTRACTS,FOCUS_FLAG_CONTRACTS,MEET_FLAG_CONTRACTS,REMIND_FLAG_CONTRACTS,CREATE_FLAG_CONTRACTS,DEPS_FLAG_CONTRACTS,DUPLICATES_FLAG_CONTRACTS,EXTENSION_FLAG_CONTRACTS,GRAPH_FLAG_CONTRACTS,GET_FLAG_CONTRACTS,GUIDE_FLAG_CONTRACTS,GLOBAL_FLAG_CONTRACTS,HEALTH_FLAG_CONTRACTS,HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS,HISTORY_FLAG_CONTRACTS,INIT_FLAG_CONTRACTS,LIST_FILTER_FLAG_CONTRACTS,NEXT_FLAG_CONTRACTS,PM_COMMAND_ALIAS_CONTRACTS,PM_HISTORY_COMMAND_ALIASES,PM_NAMESPACED_COMMAND_ALIASES,resolveSubcommandFlagContractsForCommand,PACKAGE_FLAG_CONTRACTS,PLAN_FLAG_CONTRACTS,SEARCH_FLAG_CONTRACTS,STATS_FLAG_CONTRACTS,EVENTS_FLAG_CONTRACTS,UPDATE_FLAG_CONTRACTS,UPDATE_MANY_FLAG_CONTRACTS,UPGRADE_FLAG_CONTRACTS,toCompletionFlagString}from"./cli-contracts.js";import{BUILTIN_ITEM_TYPE_VALUES,STATUS_VALUES}from"../types/index.js";import{listGuideTopicIds}from"./guide-topics.js";import{enrichCliFlagInvocationContracts}from"./flag-invocation-contracts.js";import{GLOBAL_VALUE_CONSUMING_FLAGS}from"./cli-contracts/bootstrap-command-scanner.js";const VALID_SHELLS=["bash","zsh","fish"];const DEFAULT_ITEM_TYPES=[...BUILTIN_ITEM_TYPE_VALUES];const DEFAULT_STATUS_VALUES=[...STATUS_VALUES];const HIDDEN_COMMAND_ALIASES=new Set(PM_COMMAND_ALIAS_CONTRACTS.filter(contract=>contract.hidden).map(contract=>contract.alias));const ALL_COMMANDS=listPmCommandsForTier("full").filter(command=>!command.includes(" ")&&!HIDDEN_COMMAND_ALIASES.has(command));const LIST_FLAGS=toCompletionFlagString(LIST_FILTER_FLAG_CONTRACTS);const AGGREGATE_FLAGS=toCompletionFlagString(AGGREGATE_FLAG_CONTRACTS);const APPEND_FLAGS=toCompletionFlagString(APPEND_FLAG_CONTRACTS);const COPY_FLAGS=toCompletionFlagString(COPY_FLAG_CONTRACTS);const RESTORE_INVOCATIONS=enrichCliFlagInvocationContracts("restore",resolveSubcommandFlagContractsForCommand("restore"));const FOCUS_FLAGS=toCompletionFlagString(FOCUS_FLAG_CONTRACTS);const MEET_FLAGS=toCompletionFlagString(MEET_FLAG_CONTRACTS);const REMIND_FLAGS=toCompletionFlagString(REMIND_FLAG_CONTRACTS);const CREATE_FLAGS=toCompletionFlagString(CREATE_FLAG_CONTRACTS);const GET_FLAGS=toCompletionFlagString(GET_FLAG_CONTRACTS);const UPDATE_FLAGS=toCompletionFlagString(UPDATE_FLAG_CONTRACTS);const UPDATE_MANY_FLAGS=toCompletionFlagString(UPDATE_MANY_FLAG_CONTRACTS);const CLOSE_MANY_FLAGS=toCompletionFlagString(CLOSE_MANY_FLAG_CONTRACTS);const NAMESPACE_NOUNS=[...new Set(PM_NAMESPACED_COMMAND_ALIASES.map(entry=>entry.canonical_argv[0]))];const NAMESPACE_LEAVES=Object.fromEntries(NAMESPACE_NOUNS.map(noun=>[noun,PM_NAMESPACED_COMMAND_ALIASES.filter(entry=>entry.canonical_argv[0]===noun).map(entry=>entry.canonical_argv[1]).join(" ")]));const HISTORY_LEAVES=NAMESPACE_LEAVES.history;const HISTORY_OPERATION_FLAGS=PM_HISTORY_COMMAND_ALIASES.map(entry=>({...entry,flags:toCompletionFlagString(resolveSubcommandFlagContractsForCommand(entry.alias))}));const HISTORY_FLAGS=toCompletionFlagString(HISTORY_FLAG_CONTRACTS);const HISTORY_AUTHOR_ACKNOWLEDGE_FLAGS=toCompletionFlagString(HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS,false);const EVENTS_FLAGS=toCompletionFlagString(EVENTS_FLAG_CONTRACTS);const CALENDAR_FLAGS=toCompletionFlagString(CALENDAR_FLAG_CONTRACTS);const CONTEXT_FLAGS=toCompletionFlagString(CONTEXT_FLAG_CONTRACTS);const NEXT_FLAGS=toCompletionFlagString(NEXT_FLAG_CONTRACTS);const DEPS_FLAGS=toCompletionFlagString(DEPS_FLAG_CONTRACTS);const DUPLICATES_FLAGS=toCompletionFlagString(DUPLICATES_FLAG_CONTRACTS);const GRAPH_FLAGS=toCompletionFlagString(GRAPH_FLAG_CONTRACTS);const GUIDE_FLAGS=toCompletionFlagString(GUIDE_FLAG_CONTRACTS);const SEARCH_FLAGS=toCompletionFlagString(SEARCH_FLAG_CONTRACTS);const STATS_FLAGS=toCompletionFlagString(STATS_FLAG_CONTRACTS);const HEALTH_FLAGS=toCompletionFlagString(HEALTH_FLAG_CONTRACTS);const INIT_FLAGS=toCompletionFlagString(INIT_FLAG_CONTRACTS);const CONTRACTS_FLAGS=toCompletionFlagString(CONTRACTS_FLAG_CONTRACTS);const PLAN_FLAGS=toCompletionFlagString(PLAN_FLAG_CONTRACTS);const SCHEMA_SUBCOMMAND_CHOICES=`${WORKFLOW_POLICY_ACTIONS.join(" ")} list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset rename-type rename-field remap-status`;const PLAN_SUBCOMMANDS_LIST="create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize";const COMPLETION_FLAGS=toCompletionFlagString(COMPLETION_FLAG_CONTRACTS);const COMPLETION_SHELL_CHOICES=`${COMPLETION_FLAGS} bash zsh fish`;const GUIDE_TOPIC_CHOICES=joinCompletionValues(listGuideTopicIds());const EXTENSION_LIFECYCLE_ACTIONS="init scaffold install uninstall explore manage describe reload doctor catalog adopt adopt-all activate deactivate migrate";const PACKAGE_LIFECYCLE_ACTIONS=`${EXTENSION_LIFECYCLE_ACTIONS} upgrade`;const EXTENSION_LIFECYCLE_FLAGS=toCompletionFlagString(EXTENSION_FLAG_CONTRACTS);const PACKAGE_LIFECYCLE_FLAGS=toCompletionFlagString(PACKAGE_FLAG_CONTRACTS);const UPGRADE_FLAGS=toCompletionFlagString(UPGRADE_FLAG_CONTRACTS);const MUTATION_FLAGS="--author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";const DELETE_MUTATION_FLAGS="--dry-run --author --message --force --json --quiet --no-changed-fields --id-only --pm-path --path --no-extensions --no-pager --profile --help";const CLOSE_MUTATION_FLAGS=toCompletionFlagString(resolveSubcommandFlagContractsForCommand("close"));const CLOSE_TASK_MUTATION_FLAGS=toCompletionFlagString(resolveSubcommandFlagContractsForCommand("close-task"));const RELEASE_MUTATION_FLAGS=toCompletionFlagString(resolveSubcommandFlagContractsForCommand("release"));const CLAIM_MUTATION_FLAGS=toCompletionFlagString(resolveSubcommandFlagContractsForCommand("claim"));const COMMAND_COMPLETION_DESCRIPTIONS=[["init","Initialize pm storage for the current workspace"],["config","Read or update pm settings"],["package","Manage package lifecycle operations"],["packages","Alias for package"],["create","Create a new project management item"],["copy","Copy an existing item to a new ID"],["focus","Set/clear/show the session focused parent for new items"],["list","List active items with optional filters"],["aggregate","Aggregate grouped item counts and numeric stats for governance queries"],["duplicates","Find bounded duplicate clusters across lifecycle statuses"],["guide","Browse local progressive-disclosure guides"],["calendar","Show calendar views for deadlines and reminders"],["cal","Alias for calendar"],["context","Show a token-efficient project context snapshot"],["ctx","Alias for context"],["get","Show item details by ID"],["next","Recommend the next actionable (unblocked, ready) work item"],["search","Search items with keyword, semantic, or hybrid modes"],["reindex","Rebuild search artifacts"],["history","Show item history entries"],["history-compact","Compact history streams into a synthetic baseline + retained tail"],["history-redact","Redact sensitive literals/patterns and recompute history hashes"],["history-repair","Re-anchor a drifted history chain so pm health/validate report ok"],["schema","Manage custom item types and statuses in .agents/pm/schema/*.json"],["profile","List, show, apply, and lint project profiles (archetype schema/config/template/package bundles)"],["plan","Agent-optimized Plan item workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)"],["activity","Show recent activity across items"],["restore","Restore an item to an earlier state"],["update","Update item fields and metadata"],["update-many","Bulk-update matched items with dry-run and rollback checkpoints"],["close","Close an item (reason requirement follows governance settings)"],["close-many","Bulk-close matched items with an optional shared reason and rollback checkpoint"],["delete","Delete an item and record the change"],["append","Append text to an item body"],["comments","List or add comments for an item"],["notes","List or add notes for an item"],["learnings","List or add learnings for an item"],["files","Manage linked files"],["docs","Manage linked docs"],["deps","Show dependency relationships for an item"],["graph","Bounded graph traversal, analytics, and governance-audit queries"],["test","Manage linked tests and optionally run them"],["test-all","Run linked tests across matching items"],["test-runs","Manage background linked-test runs"],["stats","Show project tracker statistics"],["health","Show project tracker health checks"],["validate","Run standalone validation checks"],["gc","Clean optional cache artifacts"],["contracts","Show machine-readable command and schema contracts"],["claim","Claim an item for active work"],["release","Release the active claim for an item"],["start-task","Lifecycle alias to claim and set in_progress"],["pause-task","Lifecycle alias to reopen and release claim"],["close-task","Lifecycle alias to close and release claim"],["meet","Shortcut to create a Meeting with scheduling defaults"],["event","Shortcut to create an Event with scheduling defaults"],["remind","Shortcut to create a Reminder from a point in time"],["templates","Manage reusable create templates"],["completion","Generate shell completion"],["help","Display help for a command"]];const FISH_COMMAND_DESCRIPTION_OVERRIDES=new Map([["calendar","Show deadline/reminder calendar views"],["schema","Inspect and manage runtime schema"],["profile","List, show, apply, and lint project profiles (archetype bundles)"],["plan","Agent-optimized Plan workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)"],["start-task","Lifecycle alias to claim and set in-progress"]]);const GLOBAL_FLAGS=GLOBAL_FLAG_CONTRACTS.flatMap(entry=>[entry.short,entry.flag,...entry.aliases??[]]).filter(value=>Boolean(value)).join(" ");const GLOBAL_COMPLETION_VALUE_PATTERNS=[...GLOBAL_VALUE_CONSUMING_FLAGS].join("|");const GLOBAL_COMPLETION_INLINE_PATTERNS=[...GLOBAL_VALUE_CONSUMING_FLAGS].map(flag=>`${flag}=*`).join("|");const GLOBAL_COMPLETION_SWITCH_PATTERNS=[...GLOBAL_FLAGS.split(" ").filter(flag=>!GLOBAL_VALUE_CONSUMING_FLAGS.has(flag)),"-h","-V"].join("|");function joinCompletionValues(values){return[...new Set(values.map(value=>value.trim()).filter(value=>value.length>0))].sort((left,right)=>left.localeCompare(right)).join(" ")}function joinCompletionValuesInOrder(values){return[...new Set(values.map(value=>value.trim()).filter(value=>value.length>0))].join(" ")}function shellDoubleQuote(value){return value.replaceAll("\\","\\\\").replaceAll('"','\\"').replaceAll("$","\\$").replaceAll("`","\\`")}function completionTypeValues(itemTypes,runtime){return joinCompletionValuesInOrder(itemTypes.length>0?itemTypes:runtime.item_types??DEFAULT_ITEM_TYPES)}function completionStatusValues(runtime){return joinCompletionValues(runtime.statuses??DEFAULT_STATUS_VALUES)}function mergeFlagStrings(baseFlags,runtimeFlags){const merged=[...baseFlags.split(/\s+/u).filter(value=>value.length>0),...runtimeFlags??[]];return joinCompletionValues(merged)}function normalizeRuntimeCompletionFlags(runtimeFlags){const normalized=(runtimeFlags??[]).map(value=>value.trim()).filter(value=>value.startsWith("--")&&value.length>2).map(value=>`--${value.slice(2).replaceAll("_","-")}`);return[...new Set(normalized)].sort((left,right)=>left.localeCompare(right))}function renderZshRuntimeFieldFlagSpecs(runtimeFlags){const normalized=normalizeRuntimeCompletionFlags(runtimeFlags);if(normalized.length===0){return""}return`${normalized.map(flag=>`            '${flag}[Runtime schema field flag]:value' \\`).join("\n")}
+`}function renderZshArgumentSpecs(specs,options={}){const trailingContinuation=options.trailingContinuation??true;const lastSpecIndex=specs.length-1;return specs.map((spec,index)=>`            ${spec}${trailingContinuation||index!==lastSpecIndex?" \\":""}`).join("\n")}function renderZshCommandDescriptions(){return[...COMMAND_COMPLETION_DESCRIPTIONS,["ops","Workspace maintenance and diagnostics"]].filter(([command])=>!HIDDEN_COMMAND_ALIASES.has(command)).map(([command,description])=>`    '${command}:${description}'`).join("\n")}function renderFishCommandDescriptions(){return[...COMMAND_COMPLETION_DESCRIPTIONS,["ops","Workspace maintenance and diagnostics"]].filter(([command])=>command!=="help"&&!HIDDEN_COMMAND_ALIASES.has(command)).map(([command,description])=>{const fishDescription=FISH_COMMAND_DESCRIPTION_OVERRIDES.get(command)??description;return`complete -c pm -n __pm_no_subcommand -a ${command.padEnd(16)} -d '${fishDescription}'`}).join("\n")}function renderZshPresenceFilterSpecs(options){const missingSpecs=["reviewer-missing[Select only items missing reviewer]","risk-missing[Select only items missing risk]","confidence-missing[Select only items missing confidence]","sprint-missing[Select only items missing sprint]","release-missing[Select only items missing release]"];const contentMissingAliasSpecs=options.includeContentMissingAliases===true?["files-missing[Alias for --no-files]","docs-missing[Alias for --no-docs]"]:[];const pairedSpecs=[["has-notes[Select only items that have notes]","no-notes[Select only items with no notes]"],["has-learnings[Select only items that have learnings]","no-learnings[Select only items with no learnings]"],["has-files[Select only items that have linked files]","no-files[Select only items with no linked files]"],["has-docs[Select only items that have linked docs]","no-docs[Select only items with no linked docs]"],["has-tests[Select only items that have linked tests]","no-tests[Select only items with no linked tests]"],["has-comments[Select only items that have comments]","no-comments[Select only items with no comments]"],["has-deps[Select only items that have dependencies]","no-deps[Select only items with no dependencies]"],["has-body[Select only items with non-empty body]","empty-body[Select only items with empty body]"],["has-linked-command[Select only items that have a linked command]","no-linked-command[Select only items with no linked command]"]];return renderZshArgumentSpecs([...[...missingSpecs,...contentMissingAliasSpecs].map(spec=>`'--${options.missingPrefix}${spec}'`),...pairedSpecs.flatMap(([positive,negative])=>[`'--${options.pairedPrefix}${positive}'`,`'--${options.pairedPrefix}${negative}'`])])}const ZSH_MUTATION_COLLECTION_ARGUMENT_SPECS=["'--comment[Comment seed author=<value>,created_at=<iso|now>,text=<value>]:comment'","'--note[Note seed author=<value>,created_at=<iso|now>,text=<value>]:note'","'--learning[Learning seed author=<value>,created_at=<iso|now>,text=<value>]:learning'","'--file[Linked file path=<value>,scope=<project|global>,note=<text>]:file'","'--test[Linked test command=<value>,path=<value>,scope=<project|global>]:test'","'--doc[Linked doc path=<value>,scope=<project|global>,note=<text>]:doc'","'--reminder[Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>]:reminder'","'--event[Event entry start=<iso|relative>,end=<iso|relative>,recur_*]:event'","'--type-option[Type option key=value or key=<name>,value=<value>]:type_option'","'--unset[Clear scalar metadata field by name]:field'","'--replace-files[Atomically replace linked files with provided --file values]'","'--replace-docs[Atomically replace linked docs with provided --doc values]'","'--clear-deps[Clear dependency entries]'","'--clear-comments[Clear comments]'","'--clear-notes[Clear notes]'","'--clear-learnings[Clear learnings]'","'--clear-files[Clear linked files]'","'--clear-tests[Clear linked tests]'","'--clear-docs[Clear linked docs]'","'--clear-reminders[Clear reminders]'","'--clear-events[Clear events]'","'--clear-type-options[Clear type options]'"];function renderZshScheduleItemSpecs(kind){const leadingSpecs=kind==="reminder"?["'--at[Reminder time (default +1d)]:at'","'--text[Reminder text (defaults to title)]:text'"]:["'--start[Start time (ISO, now, or relative)]:start'","'--duration[Duration from start (default 1h)]:duration'","'--end[End time (overrides --duration)]:end'","'--location[Location]:location'","'--timezone[IANA timezone]:timezone'","'--all-day[Mark as an all-day event]'"];return renderZshArgumentSpecs([...leadingSpecs,"'--parent[Parent item id]:parent'","'--allow-missing-parent[Permit a parent id that does not exist yet]'","'--tags[Comma-separated tags]:tags'","'(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)'","'(-b --body)'{-b,--body}'[Item body]:body'","'(-d --description)'{-d,--description}'[Short description]:description'","'--author[Mutation author]:author'","'--message[History message]:message'","'--json[Output JSON]'","'--quiet[Suppress stdout]'"],{trailingContinuation:false})}function renderZshBulkSelectionFilterSpecs(action,statusChoices,typeChoices,tagChoices){return renderZshArgumentSpecs([`'--filter-status[Filter by status before ${action}]:(${statusChoices})'`,`'--filter-type[Filter by type before ${action}]:(${typeChoices})'`,`'--filter-tag[Filter by tag before ${action}]:(${tagChoices})'`,`'--filter-priority[Filter by priority before ${action}]:(0 1 2 3 4)'`,"'--filter-deadline-before[Filter by deadline upper bound]:deadline'","'--filter-deadline-after[Filter by deadline lower bound]:deadline'","'--filter-updated-after[Filter by updated_at lower bound (ISO/relative)]:timestamp'","'--filter-updated-before[Filter by updated_at upper bound (ISO/relative)]:timestamp'","'--filter-created-after[Filter by created_at lower bound (ISO/relative)]:timestamp'","'--filter-created-before[Filter by created_at upper bound (ISO/relative)]:timestamp'",`'--filter-assignee[Filter by assignee before ${action}]:assignee'`,"'--filter-assignee-filter[Filter assignee presence]:(assigned unassigned)'","'--filter-parent[Filter by parent item ID]:parent'","'--filter-sprint[Filter by sprint]:sprint'","'--filter-release[Filter by release]:release'"])}function renderFishRuntimeFieldFlagSpecs(commands,runtimeFlags){const normalizedFlags=normalizeRuntimeCompletionFlags(runtimeFlags).map(flag=>flag.slice(2));if(commands.length===0||normalizedFlags.length===0){return""}const lines=[];for(const command of commands){const predicate=NAMESPACE_NOUNS.includes(command)||PM_NAMESPACED_COMMAND_ALIASES.some(entry=>entry.alias===command)?"__pm_history_operation":"__fish_seen_subcommand_from";for(const flag of normalizedFlags){lines.push(`complete -c pm -n '${predicate} ${command}' -l ${flag} -d 'Runtime schema field flag' -r`)}}return`${lines.join("\n")}
 `}function renderBashDynamicChoiceResolver(kind,command,fallback){const envKind=kind.toUpperCase();const cacheVar=`PM_COMPLETION_${envKind}_CACHE`;const cacheTsVar=`PM_COMPLETION_${envKind}_CACHE_TS`;const ttlVar=`PM_COMPLETION_${envKind}_TTL`;const escapedFallback=shellDoubleQuote(fallback);return[`_pm_completion_${kind}_choices() {`,"  local now ttl cache_ts resolved",'  now="$(date +%s 2>/dev/null || echo 0)"',`  ttl="\${${ttlVar}:-120}"`,`  cache_ts="\${${cacheTsVar}:-0}"`,`  if [[ -n "\${${cacheVar}:-}" && "$now" -ne 0 && $((now - cache_ts)) -lt "$ttl" ]]; then`,`    printf '%s\\n' "$${cacheVar}"`,"    return 0","  fi",`  resolved="$(pm ${command} 2>/dev/null)"`,'  if [[ -z "$resolved" ]]; then',`    resolved="${escapedFallback}"`,"  fi",`  ${cacheVar}="$resolved"`,`  ${cacheTsVar}="$now"`,`  printf '%s\\n' "$${cacheVar}"`,"}"]}function renderZshDynamicChoiceResolver(kind,command,fallback){const envKind=kind.toUpperCase();const cacheVar=`PM_COMPLETION_${envKind}_CACHE`;const cacheTsVar=`PM_COMPLETION_${envKind}_CACHE_TS`;const ttlVar=`PM_COMPLETION_${envKind}_TTL`;const escapedFallback=shellDoubleQuote(fallback);return`
 _pm_${kind}_choices() {
   local now ttl cache_ts resolved
@@ -43,7 +43,7 @@ function __pm_${kind}_choices
   set -gx PM_COMPLETION_${envKind}_CACHE_TS $now
   printf '%s\\n' $resolved
 end
-`}function generateBashScript(itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const cmds=ALL_COMMANDS.join(" ");const useDynamicTypeExpansion=itemTypes.length===0;const typeValues=completionTypeValues(itemTypes,runtime);const statusValues=completionStatusValues(runtime);const tagValues=joinCompletionValues(tags);const listFlags=mergeFlagStrings(LIST_FLAGS,runtime.command_flags?.list);const createFlags=mergeFlagStrings(CREATE_FLAGS,runtime.command_flags?.create);const updateFlags=mergeFlagStrings(UPDATE_FLAGS,runtime.command_flags?.update);const updateManyFlags=mergeFlagStrings(UPDATE_MANY_FLAGS,runtime.command_flags?.["update-many"]);const searchFlags=mergeFlagStrings(SEARCH_FLAGS,runtime.command_flags?.search);const calendarFlags=mergeFlagStrings(CALENDAR_FLAGS,runtime.command_flags?.calendar);const contextFlags=mergeFlagStrings(CONTEXT_FLAGS,runtime.command_flags?.context);const useEagerTagExpansion=eagerTagExpansion||tags.length>0;const compgen=flags=>`$(compgen -W "${flags}" -- "$cur")`;return["# bash completion for pm",`# Source this file or add 'eval "$(pm completion bash)"' to ~/.bashrc`,"",...useDynamicTypeExpansion?[...renderBashDynamicChoiceResolver("type","completion-types",typeValues),""]:[],...renderBashDynamicChoiceResolver("status","completion-statuses",statusValues),"","_pm_completion() {","  local cur prev words cword","  _init_completion 2>/dev/null || {",'    cur="${COMP_WORDS[COMP_CWORD]}"','    prev="${COMP_WORDS[COMP_CWORD-1]}"',"    cword=$COMP_CWORD","  }","","  if [[ $cword -eq 1 ]]; then",`    COMPREPLY=(${compgen(cmds)})`,"    return 0","  fi","",'  if [[ "$prev" == "--type" ]]; then',useDynamicTypeExpansion?'    COMPREPLY=($(compgen -W "$(_pm_completion_type_choices)" -- "$cur"))':`    COMPREPLY=(${compgen(typeValues)})`,"    return 0","  fi","",'  if [[ "$prev" == "--status" ]]; then','    COMPREPLY=($(compgen -W "$(_pm_completion_status_choices)" -- "$cur"))',"    return 0","  fi","",...useEagerTagExpansion?['  if [[ ( "$prev" == "--tag" || "$prev" == "--tags" ) && ! ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',`    COMPREPLY=(${compgen(tagValues)})`,"    return 0","  fi"]:['  if [[ ( "$prev" == "--tag" || "$prev" == "--tags" ) && ! ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',"    local now ttl cache_ts tag_values",'    now="$(date +%s 2>/dev/null || echo 0)"','    ttl="${PM_COMPLETION_TAG_TTL:-120}"','    cache_ts="${PM_COMPLETION_TAG_CACHE_TS:-0}"','    tag_values="${PM_COMPLETION_TAG_CACHE:-}"','    if [[ -z "$tag_values" || "$now" -eq 0 || $((now - cache_ts)) -ge "$ttl" ]]; then','      tag_values="$(pm completion-tags 2>/dev/null)"','      PM_COMPLETION_TAG_CACHE="$tag_values"','      PM_COMPLETION_TAG_CACHE_TS="$now"',"    fi",'    COMPREPLY=($(compgen -W "$tag_values" -- "$cur"))',"    return 0","  fi"],"",'  if [[ "$prev" == "--tag" && ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',"    COMPREPLY=()","    return 0","  fi","",'  local cmd="" word_index=1 word',"  while (( word_index < cword )); do",'    word="${COMP_WORDS[word_index]}"','    case "${word//_/-}" in',`      ${GLOBAL_COMPLETION_VALUE_PATTERNS}) (( word_index += 2 )); continue ;;`,`      ${GLOBAL_COMPLETION_INLINE_PATTERNS}|${GLOBAL_COMPLETION_SWITCH_PATTERNS}) (( word_index++ )); continue ;;`,"      --) break ;;","    esac",'    if [[ -z "$cmd" ]]; then','      cmd="$word"','      [[ "$cmd" == "history" ]] || break',"    else",'      case "$word" in',...PM_HISTORY_COMMAND_ALIASES.map(entry=>`        ${entry.canonical_argv[1]}) cmd="${entry.alias}" ;;`),"      esac","      break","    fi","    (( word_index++ ))","  done",'  case "$cmd" in',...HISTORY_OPERATION_FLAGS.flatMap(entry=>[`    ${entry.alias})`,`      COMPREPLY=(${compgen(entry.flags)})`,"      return 0","      ;;"]),"    list)",`      COMPREPLY=(${compgen(listFlags)})`,"      ;;","    aggregate)",`      COMPREPLY=(${compgen(AGGREGATE_FLAGS)})`,"      ;;","    duplicates)",`      COMPREPLY=(${compgen(DUPLICATES_FLAGS)})`,"      ;;","    create)",`      COMPREPLY=(${compgen(createFlags)})`,"      ;;","    copy)",`      COMPREPLY=(${compgen(COPY_FLAGS)})`,"      ;;","    focus)",`      COMPREPLY=(${compgen(FOCUS_FLAGS)})`,"      ;;","    update)",`      COMPREPLY=(${compgen(updateFlags)})`,"      ;;","    update-many)",`      COMPREPLY=(${compgen(updateManyFlags)})`,"      ;;","    calendar|cal)",`      COMPREPLY=(${compgen(calendarFlags)})`,"      ;;","    context|ctx)",`      COMPREPLY=(${compgen(contextFlags)})`,"      ;;","    next)",`      COMPREPLY=(${compgen(NEXT_FLAGS)})`,"      ;;","    guide)",`      COMPREPLY=(${compgen(`${GUIDE_FLAGS} ${GUIDE_TOPIC_CHOICES}`)})`,"      ;;","    search)",`      COMPREPLY=(${compgen(searchFlags)})`,"      ;;","    reindex)",`      COMPREPLY=(${compgen("--mode --progress --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    init)",`      COMPREPLY=(${compgen(`${INIT_FLAGS} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    config)",`      COMPREPLY=(${compgen("--criterion --clear-criteria --format --policy --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    extension)",`      COMPREPLY=(${compgen(`${EXTENSION_LIFECYCLE_ACTIONS} ${EXTENSION_LIFECYCLE_FLAGS}`)})`,"      ;;","    package|packages)",`      COMPREPLY=(${compgen(`${PACKAGE_LIFECYCLE_ACTIONS} ${PACKAGE_LIFECYCLE_FLAGS} ${UPGRADE_FLAGS}`)})`,"      ;;","    comments)",`      COMPREPLY=(${compgen("--add --body --stdin --file --edit --delete --limit --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    notes)",`      COMPREPLY=(${compgen("--add --add-json --stdin --file --edit --delete --limit --since --event-type --include-meta --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    learnings)",`      COMPREPLY=(${compgen("--add --stdin --file --edit --delete --limit --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    files)",`      COMPREPLY=(${compgen("discover lookup --add --add-glob --remove --migrate --list --apply --note --append-stable --validate-paths --scope --limit --offset --no-truncate --strict-read --explain --lines --decision-depth --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    docs)",`      COMPREPLY=(${compgen("--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")})`,"      ;;","    append)",`      COMPREPLY=(${compgen(APPEND_FLAGS)})`,"      ;;","    deps)",`      COMPREPLY=(${compgen(DEPS_FLAGS)})`,"      ;;","    graph)",`      COMPREPLY=(${compgen(`ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators slack centrality articulation plan index ${GRAPH_FLAGS}`)})`,"      ;;","    test)",`      COMPREPLY=(${compgen("--add --add-json --remove --remove-index --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")})`,"      ;;","    test-all)",`      COMPREPLY=(${compgen("--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")})`,"      ;;","    test-runs)",`      COMPREPLY=(${compgen("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")})`,"      ;;","    validate)",`      COMPREPLY=(${compgen("--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")})`,"      ;;","    health)",`      COMPREPLY=(${compgen(HEALTH_FLAGS)})`,"      ;;","    history)","      if [[ $word_index -eq $cword ]]; then",`        COMPREPLY=(${compgen(`${HISTORY_FLAGS} ${HISTORY_LEAVES}`)})`,"      else",`        COMPREPLY=(${compgen(HISTORY_FLAGS)})`,"      fi","      ;;","    events)",`      COMPREPLY=(${compgen(EVENTS_FLAGS)})`,"      ;;","    history-author-acknowledge)",`      COMPREPLY=(${compgen(`${HISTORY_AUTHOR_ACKNOWLEDGE_FLAGS} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    get)",`      COMPREPLY=(${compgen(GET_FLAGS)})`,"      ;;","    schema)",`      COMPREPLY=(${compgen("list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset rename-type rename-field remap-status --description --default-status --folder --alias --role --order --type --commands --cli-flag --required --required-on-create --no-allow-unset --required-types --infer --min-count --apply --to --migration-id --dry-run --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    profile)",`      COMPREPLY=(${compgen("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")})`,"      ;;","    plan)",`      COMPREPLY=(${compgen(`${PLAN_SUBCOMMANDS_LIST} ${PLAN_FLAGS}`)})`,"      ;;","    contracts)",`      COMPREPLY=(${compgen(CONTRACTS_FLAGS)})`,"      ;;","    gc)",`      COMPREPLY=(${compgen("--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    stats)",`      COMPREPLY=(${compgen(STATS_FLAGS)})`,"      ;;","    close|close-task)",`      COMPREPLY=(${compgen(CLOSE_MUTATION_FLAGS)})`,"      ;;","    close-many)",`      COMPREPLY=(${compgen(CLOSE_MANY_FLAGS)})`,"      ;;","    release)",`      COMPREPLY=(${compgen(RELEASE_MUTATION_FLAGS)})`,"      ;;","    delete)",`      COMPREPLY=(${compgen(DELETE_MUTATION_FLAGS)})`,"      ;;","    claim|start-task|pause-task)",`      COMPREPLY=(${compgen(MUTATION_FLAGS)})`,"      ;;","    meet|event)",`      COMPREPLY=(${compgen(MEET_FLAGS)})`,"      ;;","    remind)",`      COMPREPLY=(${compgen(REMIND_FLAGS)})`,"      ;;","    completion)",`      COMPREPLY=(${compgen(COMPLETION_SHELL_CHOICES)})`,"      ;;","    templates)",`      COMPREPLY=(${compgen("save list show")})`,"      ;;","    *)",`      COMPREPLY=(${compgen(GLOBAL_FLAGS)})`,"      ;;","  esac",'  if [[ "$cmd" == "comments" || "$cmd" == "notes" || "$cmd" == "learnings" ]]; then',`    COMPREPLY+=(${compgen("--text")})`,"  fi","  return 0","}","","complete -F _pm_completion pm"].join("\n")}function generateZshScript(itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const useDynamicTypeExpansion=itemTypes.length===0;const typeFallbackChoices=completionTypeValues(itemTypes,runtime);const statusFallbackChoices=completionStatusValues(runtime);const typeChoices=useDynamicTypeExpansion?'${(f)"$(_pm_type_choices)"}':typeFallbackChoices;const statusChoices='${(f)"$(_pm_status_choices)"}';const guideTopicChoices=GUIDE_TOPIC_CHOICES;const tagChoices=joinCompletionValues(tags);const useEagerTagExpansion=eagerTagExpansion||tags.length>0;const zshTagChoices=useEagerTagExpansion?tagChoices:'${(f)"$(_pm_tag_choices)"}';const zshListRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.list);const zshCreateRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.create);const zshSearchRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.search);const zshCalendarRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.calendar);const zshContextRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.context);const zshPresenceFilterFlags=renderZshPresenceFilterSpecs({missingPrefix:"filter-",pairedPrefix:"",includeContentMissingAliases:true});const zshBulkPresenceFilterFlags=renderZshPresenceFilterSpecs({missingPrefix:"filter-",pairedPrefix:"filter-"});const zshMutationCollectionFlags=renderZshArgumentSpecs(ZSH_MUTATION_COLLECTION_ARGUMENT_SPECS);const dynamicTagResolver=useEagerTagExpansion?"":`
+`}function generateBashScript(itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const cmds=ALL_COMMANDS.join(" ");const useDynamicTypeExpansion=itemTypes.length===0;const typeValues=completionTypeValues(itemTypes,runtime);const statusValues=completionStatusValues(runtime);const tagValues=joinCompletionValues(tags);const listFlags=mergeFlagStrings(LIST_FLAGS,runtime.command_flags?.list);const createFlags=mergeFlagStrings(CREATE_FLAGS,runtime.command_flags?.create);const updateFlags=mergeFlagStrings(UPDATE_FLAGS,runtime.command_flags?.update);const updateManyFlags=mergeFlagStrings(UPDATE_MANY_FLAGS,runtime.command_flags?.["update-many"]);const searchFlags=mergeFlagStrings(SEARCH_FLAGS,runtime.command_flags?.search);const calendarFlags=mergeFlagStrings(CALENDAR_FLAGS,runtime.command_flags?.calendar);const contextFlags=mergeFlagStrings(CONTEXT_FLAGS,runtime.command_flags?.context);const useEagerTagExpansion=eagerTagExpansion||tags.length>0;const compgen=flags=>`$(compgen -W "${flags}" -- "$cur")`;return["# bash completion for pm",`# Source this file or add 'eval "$(pm completion bash)"' to ~/.bashrc`,"",...useDynamicTypeExpansion?[...renderBashDynamicChoiceResolver("type","completion-types",typeValues),""]:[],...renderBashDynamicChoiceResolver("status","completion-statuses",statusValues),"","_pm_completion() {","  local cur prev words cword","  _init_completion 2>/dev/null || {",'    cur="${COMP_WORDS[COMP_CWORD]}"','    prev="${COMP_WORDS[COMP_CWORD-1]}"',"    cword=$COMP_CWORD","  }","","  if [[ $cword -eq 1 ]]; then",`    COMPREPLY=(${compgen(cmds)})`,"    return 0","  fi","",'  if [[ "$prev" == "--type" ]]; then',useDynamicTypeExpansion?'    COMPREPLY=($(compgen -W "$(_pm_completion_type_choices)" -- "$cur"))':`    COMPREPLY=(${compgen(typeValues)})`,"    return 0","  fi","",'  if [[ "$prev" == "--status" ]]; then','    COMPREPLY=($(compgen -W "$(_pm_completion_status_choices)" -- "$cur"))',"    return 0","  fi","",...useEagerTagExpansion?['  if [[ ( "$prev" == "--tag" || "$prev" == "--tags" ) && ! ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',`    COMPREPLY=(${compgen(tagValues)})`,"    return 0","  fi"]:['  if [[ ( "$prev" == "--tag" || "$prev" == "--tags" ) && ! ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',"    local now ttl cache_ts tag_values",'    now="$(date +%s 2>/dev/null || echo 0)"','    ttl="${PM_COMPLETION_TAG_TTL:-120}"','    cache_ts="${PM_COMPLETION_TAG_CACHE_TS:-0}"','    tag_values="${PM_COMPLETION_TAG_CACHE:-}"','    if [[ -z "$tag_values" || "$now" -eq 0 || $((now - cache_ts)) -ge "$ttl" ]]; then','      tag_values="$(pm completion-tags 2>/dev/null)"','      PM_COMPLETION_TAG_CACHE="$tag_values"','      PM_COMPLETION_TAG_CACHE_TS="$now"',"    fi",'    COMPREPLY=($(compgen -W "$tag_values" -- "$cur"))',"    return 0","  fi"],"",'  if [[ "$prev" == "--tag" && ( ( "${COMP_WORDS[1]}" == "package" || "${COMP_WORDS[1]}" == "packages" ) && "${COMP_WORDS[2]}" == "upgrade" ) ]]; then',"    COMPREPLY=()","    return 0","  fi","",'  local cmd="" word_index=1 word',"  while (( word_index < cword )); do",'    word="${COMP_WORDS[word_index]}"','    case "${word//_/-}" in',`      ${GLOBAL_COMPLETION_VALUE_PATTERNS}) (( word_index += 2 )); continue ;;`,`      ${GLOBAL_COMPLETION_INLINE_PATTERNS}|${GLOBAL_COMPLETION_SWITCH_PATTERNS}) (( word_index++ )); continue ;;`,"      --) break ;;","    esac",'    if [[ -z "$cmd" ]]; then','      cmd="$word"','      [[ "$cmd" == "ctx" ]] && cmd="context"',`      case "$cmd" in ${NAMESPACE_NOUNS.join("|")}) ;; *) break ;; esac`,"    else",'      case "$cmd $word" in',...PM_NAMESPACED_COMMAND_ALIASES.map(entry=>`        "${entry.canonical}") cmd="${entry.alias}" ;;`),"      esac","      break","    fi","    (( word_index++ ))","  done",'  case "$cmd" in',...HISTORY_OPERATION_FLAGS.flatMap(entry=>[`    ${entry.alias})`,`      COMPREPLY=(${compgen(entry.flags)})`,"      return 0","      ;;"]),"    list)",`      COMPREPLY=(${compgen(listFlags)})`,"      ;;","    aggregate)",`      COMPREPLY=(${compgen(AGGREGATE_FLAGS)})`,"      ;;","    duplicates)",`      COMPREPLY=(${compgen(DUPLICATES_FLAGS)})`,"      ;;","    create)",`      COMPREPLY=(${compgen(createFlags)})`,"      ;;","    copy)",`      COMPREPLY=(${compgen(COPY_FLAGS)})`,"      ;;","    focus)",`      COMPREPLY=(${compgen(FOCUS_FLAGS)})`,"      ;;","    update)",`      COMPREPLY=(${compgen(updateFlags)})`,"      if [[ $word_index -eq $cword ]]; then",`        COMPREPLY+=(${compgen(NAMESPACE_LEAVES.update)})`,"      fi","      ;;","    update-many)",`      COMPREPLY=(${compgen(updateManyFlags)})`,"      ;;","    calendar|cal)",`      COMPREPLY=(${compgen(calendarFlags)})`,"      ;;","    context|ctx)",`      COMPREPLY=(${compgen(contextFlags)})`,"      if [[ $word_index -eq $cword ]]; then",`        COMPREPLY+=(${compgen(NAMESPACE_LEAVES.context)})`,"      fi","      ;;","    ops)",`      COMPREPLY=(${compgen(`${GLOBAL_FLAGS} ${NAMESPACE_LEAVES.ops}`)})`,"      ;;","    next)",`      COMPREPLY=(${compgen(NEXT_FLAGS)})`,"      ;;","    guide)",`      COMPREPLY=(${compgen(`${GUIDE_FLAGS} ${GUIDE_TOPIC_CHOICES}`)})`,"      ;;","    search)",`      COMPREPLY=(${compgen(searchFlags)})`,"      ;;","    reindex)",`      COMPREPLY=(${compgen("--mode --progress --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    init)",`      COMPREPLY=(${compgen(`${INIT_FLAGS} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    config)",`      COMPREPLY=(${compgen("--criterion --clear-criteria --format --policy --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    extension)",`      COMPREPLY=(${compgen(`${EXTENSION_LIFECYCLE_ACTIONS} ${EXTENSION_LIFECYCLE_FLAGS}`)})`,"      ;;","    package|packages)",`      COMPREPLY=(${compgen(`${PACKAGE_LIFECYCLE_ACTIONS} ${PACKAGE_LIFECYCLE_FLAGS} ${UPGRADE_FLAGS}`)})`,"      ;;","    comments)",`      COMPREPLY=(${compgen("--add --body --stdin --file --edit --delete --limit --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    notes)",`      COMPREPLY=(${compgen("--add --add-json --stdin --file --edit --delete --limit --since --event-type --include-meta --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    learnings)",`      COMPREPLY=(${compgen("--add --stdin --file --edit --delete --limit --full-history --if-absent --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    files)",`      COMPREPLY=(${compgen("discover lookup --add --add-glob --remove --migrate --list --apply --note --append-stable --validate-paths --scope --limit --offset --no-truncate --strict-read --explain --lines --decision-depth --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    docs)",`      COMPREPLY=(${compgen("--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")})`,"      ;;","    append)",`      COMPREPLY=(${compgen(APPEND_FLAGS)})`,"      ;;","    deps)",`      COMPREPLY=(${compgen(DEPS_FLAGS)})`,"      ;;","    graph)",`      COMPREPLY=(${compgen(`ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators slack centrality articulation plan index ${GRAPH_FLAGS}`)})`,"      ;;","    test)",`      COMPREPLY=(${compgen("--add --add-json --remove --remove-index --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")})`,"      ;;","    test-all)",`      COMPREPLY=(${compgen("--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")})`,"      ;;","    test-runs)",`      COMPREPLY=(${compgen("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")})`,"      ;;","    validate)",`      COMPREPLY=(${compgen("--check-completeness --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")})`,"      ;;","    health)",`      COMPREPLY=(${compgen(HEALTH_FLAGS)})`,"      ;;","    history)","      if [[ $word_index -eq $cword ]]; then",`        COMPREPLY=(${compgen(`${HISTORY_FLAGS} ${HISTORY_LEAVES}`)})`,"      else",`        COMPREPLY=(${compgen(HISTORY_FLAGS)})`,"      fi","      ;;","    events)",`      COMPREPLY=(${compgen(EVENTS_FLAGS)})`,"      ;;","    history-author-acknowledge)",`      COMPREPLY=(${compgen(`${HISTORY_AUTHOR_ACKNOWLEDGE_FLAGS} --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    get)",`      COMPREPLY=(${compgen(GET_FLAGS)})`,"      ;;","    schema)",'      if [[ "$prev" == "policy-mode" ]]; then',`        COMPREPLY=(${compgen("advise refuse")})`,"        return","      fi",`      COMPREPLY=(${compgen(`${SCHEMA_SUBCOMMAND_CHOICES} --definition --policy --message --description --default-status --folder --alias --role --order --type --commands --cli-flag --required --required-on-create --no-allow-unset --required-types --infer --min-count --apply --to --migration-id --dry-run --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help`)})`,"      ;;","    profile)",`      COMPREPLY=(${compgen("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")})`,"      ;;","    plan)",`      COMPREPLY=(${compgen(`${PLAN_SUBCOMMANDS_LIST} ${PLAN_FLAGS}`)})`,"      ;;","    contracts)",`      COMPREPLY=(${compgen(CONTRACTS_FLAGS)})`,"      ;;","    gc)",`      COMPREPLY=(${compgen("--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,"      ;;","    stats)",`      COMPREPLY=(${compgen(STATS_FLAGS)})`,"      ;;","    close-task)",`      COMPREPLY=(${compgen(CLOSE_TASK_MUTATION_FLAGS)})`,"      ;;","    close)",`      COMPREPLY=(${compgen(CLOSE_MUTATION_FLAGS)})`,'      if [[ "$cmd" == "close" && $word_index -eq $cword ]]; then',`        COMPREPLY+=(${compgen(NAMESPACE_LEAVES.close)})`,"      fi","      ;;","    close-many)",`      COMPREPLY=(${compgen(CLOSE_MANY_FLAGS)})`,"      ;;","    release)",`      COMPREPLY=(${compgen(RELEASE_MUTATION_FLAGS)})`,"      ;;","    delete)",`      COMPREPLY=(${compgen(DELETE_MUTATION_FLAGS)})`,"      ;;","    claim)",`      COMPREPLY=(${compgen(CLAIM_MUTATION_FLAGS)})`,"      ;;","    start-task|pause-task)",`      COMPREPLY=(${compgen(MUTATION_FLAGS)})`,"      ;;","    meet|event)",`      COMPREPLY=(${compgen(MEET_FLAGS)})`,"      ;;","    remind)",`      COMPREPLY=(${compgen(REMIND_FLAGS)})`,"      ;;","    completion)",`      COMPREPLY=(${compgen(COMPLETION_SHELL_CHOICES)})`,"      ;;","    templates)",`      COMPREPLY=(${compgen("save list show")})`,"      ;;","    *)",`      COMPREPLY=(${compgen(GLOBAL_FLAGS)})`,"      ;;","  esac",'  if [[ "$cmd" == "comments" || "$cmd" == "notes" || "$cmd" == "learnings" ]]; then',`    COMPREPLY+=(${compgen("--text")})`,"  fi","  return 0","}","","complete -F _pm_completion pm"].join("\n")}function generateZshScript(itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const useDynamicTypeExpansion=itemTypes.length===0;const typeFallbackChoices=completionTypeValues(itemTypes,runtime);const statusFallbackChoices=completionStatusValues(runtime);const typeChoices=useDynamicTypeExpansion?'${(f)"$(_pm_type_choices)"}':typeFallbackChoices;const statusChoices='${(f)"$(_pm_status_choices)"}';const guideTopicChoices=GUIDE_TOPIC_CHOICES;const tagChoices=joinCompletionValues(tags);const useEagerTagExpansion=eagerTagExpansion||tags.length>0;const zshTagChoices=useEagerTagExpansion?tagChoices:'${(f)"$(_pm_tag_choices)"}';const zshListRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.list);const zshCreateRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.create);const zshSearchRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.search);const zshCalendarRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.calendar);const zshContextRuntimeFieldFlags=renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.context);const zshPresenceFilterFlags=renderZshPresenceFilterSpecs({missingPrefix:"filter-",pairedPrefix:"",includeContentMissingAliases:true});const zshBulkPresenceFilterFlags=renderZshPresenceFilterSpecs({missingPrefix:"filter-",pairedPrefix:"filter-"});const zshMutationCollectionFlags=renderZshArgumentSpecs(ZSH_MUTATION_COLLECTION_ARGUMENT_SPECS);const dynamicTagResolver=useEagerTagExpansion?"":`
 _pm_tag_choices() {
   local now ttl cache_ts
   now=\${EPOCHSECONDS:-0}
@@ -76,7 +76,7 @@ _pm() {
   local context state line
   local -a words=("$words[@]")
   local CURRENT=$CURRENT
-  local word_index=2 history_seen=0 operation_index=0 word
+  local word_index=2 namespace_noun="" operation_index=0 word
   while (( word_index < CURRENT )); do
     word="$words[word_index]"
     case "\${word//_/-}" in
@@ -84,24 +84,27 @@ _pm() {
       ${GLOBAL_COMPLETION_INLINE_PATTERNS}|${GLOBAL_COMPLETION_SWITCH_PATTERNS}) (( word_index++ )); continue ;;
       --) break ;;
     esac
-    if (( history_seen == 0 )); then
-      [[ "$word" == "history" ]] || break
-      history_seen=1
+    if [[ -z "$namespace_noun" ]]; then
+      [[ "$word" == "ctx" ]] && word="context"
+      case "$word" in ${NAMESPACE_NOUNS.join("|")}) ;; *) break ;; esac
+      namespace_noun="$word"
     else
       operation_index=$word_index
       break
     fi
     (( word_index++ ))
   done
-  if (( history_seen && word_index == CURRENT )) && [[ "$words[CURRENT]" != -* ]]; then
+  if [[ -n "$namespace_noun" ]] && (( word_index == CURRENT )) && [[ "$words[CURRENT]" != -* ]]; then
     local -a history_commands
-    history_commands=(${HISTORY_LEAVES})
+    case "$namespace_noun" in
+${Object.entries(NAMESPACE_LEAVES).map(([noun,leaves])=>`      ${noun}) history_commands=(${leaves}) ;;`).join("\n")}
+    esac
     _describe 'history operation' history_commands
     return
   fi
   if (( operation_index > 0 )); then
-    case "$words[operation_index]" in
-${PM_HISTORY_COMMAND_ALIASES.map(entry=>`      ${entry.canonical_argv[1]}) words=("$words[1]" "${entry.alias}" "\${words[@]:$operation_index}"); (( CURRENT -= operation_index - 2 )) ;;`).join("\n")}
+    case "$namespace_noun $words[operation_index]" in
+${PM_NAMESPACED_COMMAND_ALIASES.map(entry=>`      "${entry.canonical}") words=("$words[1]" "${entry.alias}" "\${words[@]:$operation_index}"); (( CURRENT -= operation_index - 2 )) ;;`).join("\n")}
     esac
   fi
   _arguments -C \\
@@ -571,8 +574,16 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
         schema)
+          if [[ "\${words[CURRENT-1]}" == policy-mode ]]; then
+            compadd advise refuse
+            return
+          fi
           _arguments \\
-            '1:subcommand:(list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset rename-type rename-field remap-status)' \\
+            '1:subcommand:(${SCHEMA_SUBCOMMAND_CHOICES})' \\
+            '--definition[Policy definition or proposed fields JSON]:json' \\
+            '--policy[Approval policy id]:id' \\
+            '--message[History rationale]:text' \\
+            '--dry-run[Preview schema changes]' \\
             '--description[Human description for the custom item type, status, or field]:text' \\
             '--default-status[Default status hint for the custom item type]:status' \\
             '--folder[Storage folder for items of this custom type]:dir' \\
@@ -893,6 +904,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           ;;
         close)
           _arguments \\
+            '--release-assignment[Close and release assignment]' \\
             '--reason[Closure reason]:reason' \\
             '--close-reason[Alias for --reason]:close_reason' \\
             '--author[Mutation author]:author' \\
@@ -909,6 +921,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           ;;
         claim)
           _arguments \\
+            '--start[Claim and start work]' \\
             '--author[Mutation author]:author' \\
             '--message[History message]:message' \\
             '--force[Force override]' \\
@@ -930,6 +943,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           ;;
         release)
           _arguments \\
+            '--pause[Return to open and release ownership]' \\
             '--author[Mutation author]:author' \\
             '--message[History message]:message' \\
             '--force[Force override]' \\
@@ -968,6 +982,7 @@ ${renderZshArgumentSpecs(RESTORE_INVOCATIONS.map(flag=>`'${flag.flag}[${flag.des
           ;;
         validate)
           _arguments \\
+            '--check-completeness[Check declarative required fields]' \\
             '--check-metadata[Run metadata completeness checks]' \\
             '--metadata-profile[Select metadata validation profile for --check-metadata]:(core strict custom)' \\
             '--check-resolution[Run closed-item resolution metadata checks]' \\
@@ -1108,7 +1123,7 @@ ${renderZshArgumentSpecs(RESTORE_INVOCATIONS.map(flag=>`'${flag.flag}[${flag.des
   esac
 }
 
-compdef _pm pm`}function generateFishScript(itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const listCommandNames=ALL_COMMANDS.filter(command=>command==="list"||command.startsWith("list-"));const listCmds=listCommandNames.join(" ");const noSubcommandList=ALL_COMMANDS.join(" ");const useDynamicTypeExpansion=itemTypes.length===0;const typeFallbackChoices=completionTypeValues(itemTypes,runtime);const statusFallbackChoices=completionStatusValues(runtime);const typeChoices=useDynamicTypeExpansion?"(__pm_type_choices)":typeFallbackChoices;const statusChoices="(__pm_status_choices)";const guideTopicChoices=GUIDE_TOPIC_CHOICES;const tagChoices=joinCompletionValues(tags);const useEagerTagExpansion=eagerTagExpansion||tags.length>0;const fishTagChoices=useEagerTagExpansion?`'${tagChoices}'`:"'(__pm_tag_choices)'";const fishListRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(listCommandNames,runtime.command_flags?.list);const fishCreateRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["create"],runtime.command_flags?.create);const fishUpdateRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["update"],runtime.command_flags?.update);const fishUpdateManyRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["update-many"],runtime.command_flags?.["update-many"]);const fishSearchRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["search"],runtime.command_flags?.search);const fishCalendarRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["calendar","cal"],runtime.command_flags?.calendar);const fishContextRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["context","ctx"],runtime.command_flags?.context);const dynamicTagResolver=useEagerTagExpansion?"":`
+compdef _pm pm`}function generateFishScript(itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const listCommandNames=ALL_COMMANDS.filter(command=>command==="list"||command.startsWith("list-"));const listCmds=listCommandNames.join(" ");const noSubcommandList=ALL_COMMANDS.join(" ");const useDynamicTypeExpansion=itemTypes.length===0;const typeFallbackChoices=completionTypeValues(itemTypes,runtime);const statusFallbackChoices=completionStatusValues(runtime);const typeChoices=useDynamicTypeExpansion?"(__pm_type_choices)":typeFallbackChoices;const statusChoices="(__pm_status_choices)";const guideTopicChoices=GUIDE_TOPIC_CHOICES;const tagChoices=joinCompletionValues(tags);const useEagerTagExpansion=eagerTagExpansion||tags.length>0;const fishTagChoices=useEagerTagExpansion?`'${tagChoices}'`:"'(__pm_tag_choices)'";const fishListRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(listCommandNames,runtime.command_flags?.list);const fishCreateRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["create"],runtime.command_flags?.create);const fishUpdateRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["update"],runtime.command_flags?.update);const fishUpdateManyRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["update-many"],runtime.command_flags?.["update-many"]);const fishSearchRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["search"],runtime.command_flags?.search);const fishCalendarRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["calendar","cal"],runtime.command_flags?.calendar);const fishContextRuntimeFieldFlags=renderFishRuntimeFieldFlagSpecs(["context"],runtime.command_flags?.context);const dynamicTagResolver=useEagerTagExpansion?"":`
 function __pm_tag_choices
   set -l now (date +%s ^/dev/null)
   if test -z "$now"
@@ -1289,170 +1304,170 @@ complete -c pm -n '__fish_seen_subcommand_from copy' -l message -d 'History mess
 complete -c pm -n '__fish_seen_subcommand_from copy' -l force   -d 'Force ownership override'
 
 # focus flags
-complete -c pm -n '__fish_seen_subcommand_from focus' -l clear -d 'Clear the focused item'
+complete -c pm -n '__pm_history_operation focus' -l clear -d 'Clear the focused item'
 
 # update flags
-complete -c pm -n '__fish_seen_subcommand_from update' -s t -l title              -d 'Item title' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -s d -l description        -d 'Item description' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -s b -l body               -d 'Item body' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l body-file               -d 'Load the item body from a file' -r -F
-complete -c pm -n '__fish_seen_subcommand_from update' -s s -l status             -d 'Item status' -r -a '${statusChoices}'
-complete -c pm -n '__fish_seen_subcommand_from update' -l close-reason            -d 'Set close reason' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
-complete -c pm -n '__fish_seen_subcommand_from update' -l type                    -d 'Item type' -r -a '${typeChoices}'
-complete -c pm -n '__fish_seen_subcommand_from update' -l add-tags                -d 'Add tags additively without replacing existing' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l remove-tags             -d 'Remove tags from the existing list' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l add-ac                  -d 'Add one acceptance criterion without replacing existing' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l remove-ac               -d 'Remove one acceptance criterion by exact text' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l expected                -d 'Short alias for --expected-result' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l actual                  -d 'Short alias for --actual-result' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l comment                 -d 'Comment seed author=<value>,created_at=<iso|now>,text=<value>' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l note                    -d 'Note seed author=<value>,created_at=<iso|now>,text=<value>' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l learning                -d 'Learning seed author=<value>,created_at=<iso|now>,text=<value>' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l file                    -d 'Linked file path=<value>,scope=<project|global>,note=<text>' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l test                    -d 'Linked test command=<value>,path=<value>,scope=<project|global>' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l doc                     -d 'Linked doc path=<value>,scope=<project|global>,note=<text>' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l reminder                -d 'Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l event                   -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l type-option             -d 'Type option key=value or key=<name>,value=<value>' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l unset                   -d 'Clear scalar metadata field by name' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l replace-deps            -d 'Atomically replace dependencies with provided --dep values'
-complete -c pm -n '__fish_seen_subcommand_from update' -l replace-tests           -d 'Atomically replace linked tests with provided --test values'
-complete -c pm -n '__fish_seen_subcommand_from update' -l replace-files           -d 'Atomically replace linked files with provided --file values'
-complete -c pm -n '__fish_seen_subcommand_from update' -l replace-docs            -d 'Atomically replace linked docs with provided --doc values'
-complete -c pm -n '__fish_seen_subcommand_from update' -l clear-deps              -d 'Clear dependency entries'
-complete -c pm -n '__fish_seen_subcommand_from update' -l clear-comments          -d 'Clear comments'
-complete -c pm -n '__fish_seen_subcommand_from update' -l clear-notes             -d 'Clear notes'
-complete -c pm -n '__fish_seen_subcommand_from update' -l clear-learnings         -d 'Clear learnings'
-complete -c pm -n '__fish_seen_subcommand_from update' -l clear-files             -d 'Clear linked files'
-complete -c pm -n '__fish_seen_subcommand_from update' -l clear-tests             -d 'Clear linked tests'
-complete -c pm -n '__fish_seen_subcommand_from update' -l clear-docs              -d 'Clear linked docs'
-complete -c pm -n '__fish_seen_subcommand_from update' -l clear-reminders         -d 'Clear reminders'
-complete -c pm -n '__fish_seen_subcommand_from update' -l clear-events            -d 'Clear events'
-complete -c pm -n '__fish_seen_subcommand_from update' -l clear-type-options      -d 'Clear type options'
-complete -c pm -n '__fish_seen_subcommand_from update' -l author                  -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l message                 -d 'History message' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l force                   -d 'Force override'
+complete -c pm -n '__pm_history_operation update' -s t -l title              -d 'Item title' -r
+complete -c pm -n '__pm_history_operation update' -s d -l description        -d 'Item description' -r
+complete -c pm -n '__pm_history_operation update' -s b -l body               -d 'Item body' -r
+complete -c pm -n '__pm_history_operation update' -l body-file               -d 'Load the item body from a file' -r -F
+complete -c pm -n '__pm_history_operation update' -s s -l status             -d 'Item status' -r -a '${statusChoices}'
+complete -c pm -n '__pm_history_operation update' -l close-reason            -d 'Set close reason' -r
+complete -c pm -n '__pm_history_operation update' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
+complete -c pm -n '__pm_history_operation update' -l type                    -d 'Item type' -r -a '${typeChoices}'
+complete -c pm -n '__pm_history_operation update' -l add-tags                -d 'Add tags additively without replacing existing' -r
+complete -c pm -n '__pm_history_operation update' -l remove-tags             -d 'Remove tags from the existing list' -r
+complete -c pm -n '__pm_history_operation update' -l add-ac                  -d 'Add one acceptance criterion without replacing existing' -r
+complete -c pm -n '__pm_history_operation update' -l remove-ac               -d 'Remove one acceptance criterion by exact text' -r
+complete -c pm -n '__pm_history_operation update' -l expected                -d 'Short alias for --expected-result' -r
+complete -c pm -n '__pm_history_operation update' -l actual                  -d 'Short alias for --actual-result' -r
+complete -c pm -n '__pm_history_operation update' -l comment                 -d 'Comment seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__pm_history_operation update' -l note                    -d 'Note seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__pm_history_operation update' -l learning                -d 'Learning seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__pm_history_operation update' -l file                    -d 'Linked file path=<value>,scope=<project|global>,note=<text>' -r
+complete -c pm -n '__pm_history_operation update' -l test                    -d 'Linked test command=<value>,path=<value>,scope=<project|global>' -r
+complete -c pm -n '__pm_history_operation update' -l doc                     -d 'Linked doc path=<value>,scope=<project|global>,note=<text>' -r
+complete -c pm -n '__pm_history_operation update' -l reminder                -d 'Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>' -r
+complete -c pm -n '__pm_history_operation update' -l event                   -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
+complete -c pm -n '__pm_history_operation update' -l type-option             -d 'Type option key=value or key=<name>,value=<value>' -r
+complete -c pm -n '__pm_history_operation update' -l unset                   -d 'Clear scalar metadata field by name' -r
+complete -c pm -n '__pm_history_operation update' -l replace-deps            -d 'Atomically replace dependencies with provided --dep values'
+complete -c pm -n '__pm_history_operation update' -l replace-tests           -d 'Atomically replace linked tests with provided --test values'
+complete -c pm -n '__pm_history_operation update' -l replace-files           -d 'Atomically replace linked files with provided --file values'
+complete -c pm -n '__pm_history_operation update' -l replace-docs            -d 'Atomically replace linked docs with provided --doc values'
+complete -c pm -n '__pm_history_operation update' -l clear-deps              -d 'Clear dependency entries'
+complete -c pm -n '__pm_history_operation update' -l clear-comments          -d 'Clear comments'
+complete -c pm -n '__pm_history_operation update' -l clear-notes             -d 'Clear notes'
+complete -c pm -n '__pm_history_operation update' -l clear-learnings         -d 'Clear learnings'
+complete -c pm -n '__pm_history_operation update' -l clear-files             -d 'Clear linked files'
+complete -c pm -n '__pm_history_operation update' -l clear-tests             -d 'Clear linked tests'
+complete -c pm -n '__pm_history_operation update' -l clear-docs              -d 'Clear linked docs'
+complete -c pm -n '__pm_history_operation update' -l clear-reminders         -d 'Clear reminders'
+complete -c pm -n '__pm_history_operation update' -l clear-events            -d 'Clear events'
+complete -c pm -n '__pm_history_operation update' -l clear-type-options      -d 'Clear type options'
+complete -c pm -n '__pm_history_operation update' -l author                  -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation update' -l message                 -d 'History message' -r
+complete -c pm -n '__pm_history_operation update' -l force                   -d 'Force override'
 ${fishUpdateRuntimeFieldFlags}
 
 # update-many flags
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-status           -d 'Filter by status before applying updates' -r -a '${statusChoices}'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-type             -d 'Filter by type before applying updates' -r -a '${typeChoices}'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-tag              -d 'Filter by tag before applying updates' -r -a ${fishTagChoices}
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-priority         -d 'Filter by priority before applying updates' -r -a '0 1 2 3 4'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-deadline-before  -d 'Filter by deadline upper bound' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-deadline-after   -d 'Filter by deadline lower bound' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-updated-after    -d 'Filter by updated_at lower bound (ISO/relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-updated-before   -d 'Filter by updated_at upper bound (ISO/relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-created-after    -d 'Filter by created_at lower bound (ISO/relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-created-before   -d 'Filter by created_at upper bound (ISO/relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-assignee         -d 'Filter by assignee before applying updates' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-assignee-filter  -d 'Filter assignee presence' -r -a 'assigned unassigned'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-parent           -d 'Filter by parent item ID' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-sprint           -d 'Filter by sprint before applying updates' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-release          -d 'Filter by release before applying updates' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-ac-missing       -d 'Select only items missing acceptance_criteria'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-estimates-missing -d 'Select only items missing estimated_minutes'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-resolution-missing -d 'Select only terminal items missing resolution'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-metadata-missing  -d 'Select only items missing any tracked metadata'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-risk-missing       -d 'Select only items missing risk'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-confidence-missing -d 'Select only items missing confidence'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-sprint-missing     -d 'Select only items missing sprint'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-release-missing    -d 'Select only items missing release'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-notes          -d 'Select only items that have notes'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-notes           -d 'Select only items with no notes'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-learnings      -d 'Select only items that have learnings'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-learnings       -d 'Select only items with no learnings'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-files          -d 'Select only items that have linked files'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-files           -d 'Select only items with no linked files'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-docs           -d 'Select only items that have linked docs'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-docs            -d 'Select only items with no linked docs'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-tests          -d 'Select only items that have linked tests'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-tests           -d 'Select only items with no linked tests'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-comments       -d 'Select only items that have comments'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-comments        -d 'Select only items with no comments'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-deps           -d 'Select only items that have dependencies'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-deps            -d 'Select only items with no dependencies'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-body           -d 'Select only items with non-empty body'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-empty-body         -d 'Select only items with empty body'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-linked-command -d 'Select only items that have a linked command'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-linked-command  -d 'Select only items with no linked command'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l ids                     -d 'Explicit comma-separated ID allowlist' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l limit                   -d 'Limit matched item count' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l offset                  -d 'Skip first n matched rows' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l dry-run                 -d 'Preview updates without mutating'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l rollback                -d 'Rollback checkpoint ID' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l no-checkpoint           -d 'Disable checkpoint creation during apply mode'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -s t -l title              -d 'Item title' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -s d -l description        -d 'Item description' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -s b -l body               -d 'Item body' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l type                    -d 'Item type' -r -a '${typeChoices}'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l tags                    -d 'Comma-separated tags' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l add-tags                -d 'Add tags additively without replacing existing' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l remove-tags             -d 'Remove tags from the existing list' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l deadline                -d 'Deadline (ISO/date string or relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l estimate                -d 'Estimated minutes' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l acceptance-criteria     -d 'Acceptance criteria' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l add-ac                  -d 'Add one acceptance criterion without replacing existing' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l remove-ac               -d 'Remove one acceptance criterion by exact text' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l definition-of-ready     -d 'Definition of ready' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l order                   -d 'Planning order/rank' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l goal                    -d 'Goal identifier' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l objective               -d 'Objective identifier' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l value                   -d 'Business value summary' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l impact                  -d 'Business impact summary' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l outcome                 -d 'Expected outcome summary' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l why-now                 -d 'Why-now rationale' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l reviewer                -d 'Reviewer' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l risk                    -d 'Risk level' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l confidence              -d 'Confidence level' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l sprint                  -d 'Sprint identifier' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l release                 -d 'Release identifier' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l reporter                -d 'Issue reporter' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l severity                -d 'Issue severity' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l environment             -d 'Issue environment context' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l repro-steps             -d 'Issue reproduction steps' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l resolution              -d 'Issue resolution summary' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l expected-result         -d 'Issue expected behavior' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l actual-result           -d 'Issue observed behavior' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l expected                 -d 'Short alias for --expected-result' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l actual                   -d 'Short alias for --actual-result' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l affected-version        -d 'Affected version identifier' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l fixed-version           -d 'Fixed version identifier' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l component               -d 'Issue component ownership' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l regression              -d 'Regression marker true|false|1|0' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l customer-impact         -d 'Customer impact summary' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l dep                     -d 'Dependency seed id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l dep-remove              -d 'Dependency removal selector id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l replace-deps            -d 'Atomically replace dependencies with provided --dep values'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l replace-tests           -d 'Atomically replace linked tests with provided --test values'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l replace-files           -d 'Atomically replace linked files with provided --file values'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l replace-docs            -d 'Atomically replace linked docs with provided --doc values'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l comment                 -d 'Comment seed author=<value>,created_at=<iso|now>,text=<value>' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l note                    -d 'Note seed author=<value>,created_at=<iso|now>,text=<value>' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l learning                -d 'Learning seed author=<value>,created_at=<iso|now>,text=<value>' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l file                    -d 'Linked file path=<value>,scope=<project|global>,note=<text>' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l test                    -d 'Linked test command=<value>,path=<value>,scope=<project|global>' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l doc                     -d 'Linked doc path=<value>,scope=<project|global>,note=<text>' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l reminder                -d 'Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l event                   -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l type-option             -d 'Type option key=value or key=<name>,value=<value>' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l unset                   -d 'Clear scalar metadata field by name' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-deps              -d 'Clear dependency entries'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-comments          -d 'Clear comments'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-notes             -d 'Clear notes'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-learnings         -d 'Clear learnings'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-files             -d 'Clear linked files'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-tests             -d 'Clear linked tests'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-docs              -d 'Clear linked docs'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-reminders         -d 'Clear reminders'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-events            -d 'Clear events'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l clear-type-options      -d 'Clear type options'
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l author                  -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l message                 -d 'History message' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l force                   -d 'Force override'
+complete -c pm -n '__pm_history_operation update-many' -l filter-status           -d 'Filter by status before applying updates' -r -a '${statusChoices}'
+complete -c pm -n '__pm_history_operation update-many' -l filter-type             -d 'Filter by type before applying updates' -r -a '${typeChoices}'
+complete -c pm -n '__pm_history_operation update-many' -l filter-tag              -d 'Filter by tag before applying updates' -r -a ${fishTagChoices}
+complete -c pm -n '__pm_history_operation update-many' -l filter-priority         -d 'Filter by priority before applying updates' -r -a '0 1 2 3 4'
+complete -c pm -n '__pm_history_operation update-many' -l filter-deadline-before  -d 'Filter by deadline upper bound' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-deadline-after   -d 'Filter by deadline lower bound' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-updated-after    -d 'Filter by updated_at lower bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-updated-before   -d 'Filter by updated_at upper bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-created-after    -d 'Filter by created_at lower bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-created-before   -d 'Filter by created_at upper bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-assignee         -d 'Filter by assignee before applying updates' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-assignee-filter  -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__pm_history_operation update-many' -l filter-parent           -d 'Filter by parent item ID' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-sprint           -d 'Filter by sprint before applying updates' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-release          -d 'Filter by release before applying updates' -r
+complete -c pm -n '__pm_history_operation update-many' -l filter-ac-missing       -d 'Select only items missing acceptance_criteria'
+complete -c pm -n '__pm_history_operation update-many' -l filter-estimates-missing -d 'Select only items missing estimated_minutes'
+complete -c pm -n '__pm_history_operation update-many' -l filter-resolution-missing -d 'Select only terminal items missing resolution'
+complete -c pm -n '__pm_history_operation update-many' -l filter-metadata-missing  -d 'Select only items missing any tracked metadata'
+complete -c pm -n '__pm_history_operation update-many' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
+complete -c pm -n '__pm_history_operation update-many' -l filter-risk-missing       -d 'Select only items missing risk'
+complete -c pm -n '__pm_history_operation update-many' -l filter-confidence-missing -d 'Select only items missing confidence'
+complete -c pm -n '__pm_history_operation update-many' -l filter-sprint-missing     -d 'Select only items missing sprint'
+complete -c pm -n '__pm_history_operation update-many' -l filter-release-missing    -d 'Select only items missing release'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-notes          -d 'Select only items that have notes'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-notes           -d 'Select only items with no notes'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-learnings      -d 'Select only items that have learnings'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-learnings       -d 'Select only items with no learnings'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-files          -d 'Select only items that have linked files'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-files           -d 'Select only items with no linked files'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-docs           -d 'Select only items that have linked docs'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-docs            -d 'Select only items with no linked docs'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-tests          -d 'Select only items that have linked tests'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-tests           -d 'Select only items with no linked tests'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-comments       -d 'Select only items that have comments'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-comments        -d 'Select only items with no comments'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-deps           -d 'Select only items that have dependencies'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-deps            -d 'Select only items with no dependencies'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-body           -d 'Select only items with non-empty body'
+complete -c pm -n '__pm_history_operation update-many' -l filter-empty-body         -d 'Select only items with empty body'
+complete -c pm -n '__pm_history_operation update-many' -l filter-has-linked-command -d 'Select only items that have a linked command'
+complete -c pm -n '__pm_history_operation update-many' -l filter-no-linked-command  -d 'Select only items with no linked command'
+complete -c pm -n '__pm_history_operation update-many' -l ids                     -d 'Explicit comma-separated ID allowlist' -r
+complete -c pm -n '__pm_history_operation update-many' -l limit                   -d 'Limit matched item count' -r
+complete -c pm -n '__pm_history_operation update-many' -l offset                  -d 'Skip first n matched rows' -r
+complete -c pm -n '__pm_history_operation update-many' -l dry-run                 -d 'Preview updates without mutating'
+complete -c pm -n '__pm_history_operation update-many' -l rollback                -d 'Rollback checkpoint ID' -r
+complete -c pm -n '__pm_history_operation update-many' -l no-checkpoint           -d 'Disable checkpoint creation during apply mode'
+complete -c pm -n '__pm_history_operation update-many' -s t -l title              -d 'Item title' -r
+complete -c pm -n '__pm_history_operation update-many' -s d -l description        -d 'Item description' -r
+complete -c pm -n '__pm_history_operation update-many' -s b -l body               -d 'Item body' -r
+complete -c pm -n '__pm_history_operation update-many' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
+complete -c pm -n '__pm_history_operation update-many' -l type                    -d 'Item type' -r -a '${typeChoices}'
+complete -c pm -n '__pm_history_operation update-many' -l tags                    -d 'Comma-separated tags' -r
+complete -c pm -n '__pm_history_operation update-many' -l add-tags                -d 'Add tags additively without replacing existing' -r
+complete -c pm -n '__pm_history_operation update-many' -l remove-tags             -d 'Remove tags from the existing list' -r
+complete -c pm -n '__pm_history_operation update-many' -l deadline                -d 'Deadline (ISO/date string or relative)' -r
+complete -c pm -n '__pm_history_operation update-many' -l estimate                -d 'Estimated minutes' -r
+complete -c pm -n '__pm_history_operation update-many' -l acceptance-criteria     -d 'Acceptance criteria' -r
+complete -c pm -n '__pm_history_operation update-many' -l add-ac                  -d 'Add one acceptance criterion without replacing existing' -r
+complete -c pm -n '__pm_history_operation update-many' -l remove-ac               -d 'Remove one acceptance criterion by exact text' -r
+complete -c pm -n '__pm_history_operation update-many' -l definition-of-ready     -d 'Definition of ready' -r
+complete -c pm -n '__pm_history_operation update-many' -l order                   -d 'Planning order/rank' -r
+complete -c pm -n '__pm_history_operation update-many' -l goal                    -d 'Goal identifier' -r
+complete -c pm -n '__pm_history_operation update-many' -l objective               -d 'Objective identifier' -r
+complete -c pm -n '__pm_history_operation update-many' -l value                   -d 'Business value summary' -r
+complete -c pm -n '__pm_history_operation update-many' -l impact                  -d 'Business impact summary' -r
+complete -c pm -n '__pm_history_operation update-many' -l outcome                 -d 'Expected outcome summary' -r
+complete -c pm -n '__pm_history_operation update-many' -l why-now                 -d 'Why-now rationale' -r
+complete -c pm -n '__pm_history_operation update-many' -l reviewer                -d 'Reviewer' -r
+complete -c pm -n '__pm_history_operation update-many' -l risk                    -d 'Risk level' -r
+complete -c pm -n '__pm_history_operation update-many' -l confidence              -d 'Confidence level' -r
+complete -c pm -n '__pm_history_operation update-many' -l sprint                  -d 'Sprint identifier' -r
+complete -c pm -n '__pm_history_operation update-many' -l release                 -d 'Release identifier' -r
+complete -c pm -n '__pm_history_operation update-many' -l reporter                -d 'Issue reporter' -r
+complete -c pm -n '__pm_history_operation update-many' -l severity                -d 'Issue severity' -r
+complete -c pm -n '__pm_history_operation update-many' -l environment             -d 'Issue environment context' -r
+complete -c pm -n '__pm_history_operation update-many' -l repro-steps             -d 'Issue reproduction steps' -r
+complete -c pm -n '__pm_history_operation update-many' -l resolution              -d 'Issue resolution summary' -r
+complete -c pm -n '__pm_history_operation update-many' -l expected-result         -d 'Issue expected behavior' -r
+complete -c pm -n '__pm_history_operation update-many' -l actual-result           -d 'Issue observed behavior' -r
+complete -c pm -n '__pm_history_operation update-many' -l expected                 -d 'Short alias for --expected-result' -r
+complete -c pm -n '__pm_history_operation update-many' -l actual                   -d 'Short alias for --actual-result' -r
+complete -c pm -n '__pm_history_operation update-many' -l affected-version        -d 'Affected version identifier' -r
+complete -c pm -n '__pm_history_operation update-many' -l fixed-version           -d 'Fixed version identifier' -r
+complete -c pm -n '__pm_history_operation update-many' -l component               -d 'Issue component ownership' -r
+complete -c pm -n '__pm_history_operation update-many' -l regression              -d 'Regression marker true|false|1|0' -r
+complete -c pm -n '__pm_history_operation update-many' -l customer-impact         -d 'Customer impact summary' -r
+complete -c pm -n '__pm_history_operation update-many' -l dep                     -d 'Dependency seed id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>' -r
+complete -c pm -n '__pm_history_operation update-many' -l dep-remove              -d 'Dependency removal selector id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>' -r
+complete -c pm -n '__pm_history_operation update-many' -l replace-deps            -d 'Atomically replace dependencies with provided --dep values'
+complete -c pm -n '__pm_history_operation update-many' -l replace-tests           -d 'Atomically replace linked tests with provided --test values'
+complete -c pm -n '__pm_history_operation update-many' -l replace-files           -d 'Atomically replace linked files with provided --file values'
+complete -c pm -n '__pm_history_operation update-many' -l replace-docs            -d 'Atomically replace linked docs with provided --doc values'
+complete -c pm -n '__pm_history_operation update-many' -l comment                 -d 'Comment seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__pm_history_operation update-many' -l note                    -d 'Note seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__pm_history_operation update-many' -l learning                -d 'Learning seed author=<value>,created_at=<iso|now>,text=<value>' -r
+complete -c pm -n '__pm_history_operation update-many' -l file                    -d 'Linked file path=<value>,scope=<project|global>,note=<text>' -r
+complete -c pm -n '__pm_history_operation update-many' -l test                    -d 'Linked test command=<value>,path=<value>,scope=<project|global>' -r
+complete -c pm -n '__pm_history_operation update-many' -l doc                     -d 'Linked doc path=<value>,scope=<project|global>,note=<text>' -r
+complete -c pm -n '__pm_history_operation update-many' -l reminder                -d 'Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>' -r
+complete -c pm -n '__pm_history_operation update-many' -l event                   -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
+complete -c pm -n '__pm_history_operation update-many' -l type-option             -d 'Type option key=value or key=<name>,value=<value>' -r
+complete -c pm -n '__pm_history_operation update-many' -l unset                   -d 'Clear scalar metadata field by name' -r
+complete -c pm -n '__pm_history_operation update-many' -l clear-deps              -d 'Clear dependency entries'
+complete -c pm -n '__pm_history_operation update-many' -l clear-comments          -d 'Clear comments'
+complete -c pm -n '__pm_history_operation update-many' -l clear-notes             -d 'Clear notes'
+complete -c pm -n '__pm_history_operation update-many' -l clear-learnings         -d 'Clear learnings'
+complete -c pm -n '__pm_history_operation update-many' -l clear-files             -d 'Clear linked files'
+complete -c pm -n '__pm_history_operation update-many' -l clear-tests             -d 'Clear linked tests'
+complete -c pm -n '__pm_history_operation update-many' -l clear-docs              -d 'Clear linked docs'
+complete -c pm -n '__pm_history_operation update-many' -l clear-reminders         -d 'Clear reminders'
+complete -c pm -n '__pm_history_operation update-many' -l clear-events            -d 'Clear events'
+complete -c pm -n '__pm_history_operation update-many' -l clear-type-options      -d 'Clear type options'
+complete -c pm -n '__pm_history_operation update-many' -l author                  -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation update-many' -l message                 -d 'History message' -r
+complete -c pm -n '__pm_history_operation update-many' -l force                   -d 'Force override'
 ${fishUpdateManyRuntimeFieldFlags}
 
 # files flags
@@ -1548,36 +1563,36 @@ complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l format    -d 'Ou
 ${fishCalendarRuntimeFieldFlags}
 
 # context flags
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l date      -d 'Anchor date/time (ISO/date string or relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l from      -d 'Agenda lower bound (ISO/date string or relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l to        -d 'Agenda upper bound (ISO/date string or relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l past      -d 'Include past entries in bounded windows'
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l type      -d 'Filter by type' -r -a '${typeChoices}'
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l tag       -d 'Filter by tag' -r -a ${fishTagChoices}
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l priority  -d 'Filter by priority' -r -a '0 1 2 3 4'
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l assignee  -d 'Filter by assignee' -r
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l sprint    -d 'Filter by sprint' -r
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l release   -d 'Filter by release' -r
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l parent    -d 'Scope snapshot to one item subtree' -r
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l limit     -d 'Limit focus and agenda rows per section' -r
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l depth     -d 'Context depth' -r -a 'brief standard deep full'
-complete -c pm -n '__fish_seen_subcommand_from context ctx' -l format    -d 'Output override' -r -a 'markdown toon json'
+complete -c pm -n '__pm_history_operation context' -l date      -d 'Anchor date/time (ISO/date string or relative)' -r
+complete -c pm -n '__pm_history_operation context' -l from      -d 'Agenda lower bound (ISO/date string or relative)' -r
+complete -c pm -n '__pm_history_operation context' -l to        -d 'Agenda upper bound (ISO/date string or relative)' -r
+complete -c pm -n '__pm_history_operation context' -l past      -d 'Include past entries in bounded windows'
+complete -c pm -n '__pm_history_operation context' -l type      -d 'Filter by type' -r -a '${typeChoices}'
+complete -c pm -n '__pm_history_operation context' -l tag       -d 'Filter by tag' -r -a ${fishTagChoices}
+complete -c pm -n '__pm_history_operation context' -l priority  -d 'Filter by priority' -r -a '0 1 2 3 4'
+complete -c pm -n '__pm_history_operation context' -l assignee  -d 'Filter by assignee' -r
+complete -c pm -n '__pm_history_operation context' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__pm_history_operation context' -l sprint    -d 'Filter by sprint' -r
+complete -c pm -n '__pm_history_operation context' -l release   -d 'Filter by release' -r
+complete -c pm -n '__pm_history_operation context' -l parent    -d 'Scope snapshot to one item subtree' -r
+complete -c pm -n '__pm_history_operation context' -l limit     -d 'Limit focus and agenda rows per section' -r
+complete -c pm -n '__pm_history_operation context' -l depth     -d 'Context depth' -r -a 'brief standard deep full'
+complete -c pm -n '__pm_history_operation context' -l format    -d 'Output override' -r -a 'markdown toon json'
 ${fishContextRuntimeFieldFlags}
 
 # next flags
-complete -c pm -n '__fish_seen_subcommand_from next' -l type           -d 'Filter candidates by type' -r -a '${typeChoices}'
-complete -c pm -n '__fish_seen_subcommand_from next' -l tag            -d 'Filter candidates by tag' -r -a ${fishTagChoices}
-complete -c pm -n '__fish_seen_subcommand_from next' -l priority       -d 'Filter candidates by priority' -r -a '0 1 2 3 4'
-complete -c pm -n '__fish_seen_subcommand_from next' -l assignee       -d 'Filter candidates by assignee' -r
-complete -c pm -n '__fish_seen_subcommand_from next' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
-complete -c pm -n '__fish_seen_subcommand_from next' -l sprint         -d 'Filter candidates by sprint' -r
-complete -c pm -n '__fish_seen_subcommand_from next' -l release        -d 'Filter candidates by release' -r
-complete -c pm -n '__fish_seen_subcommand_from next' -l parent         -d 'Scope to one item subtree' -r
-complete -c pm -n '__fish_seen_subcommand_from next' -l limit          -d 'Limit ready rows' -r
-complete -c pm -n '__fish_seen_subcommand_from next' -l blocked-limit  -d 'Limit blocked rows' -r
-complete -c pm -n '__fish_seen_subcommand_from next' -l ready-only     -d 'Omit the blocked companion list'
-complete -c pm -n '__fish_seen_subcommand_from next' -l format         -d 'Output override' -r -a 'markdown toon json'
+complete -c pm -n '__pm_history_operation next' -l type           -d 'Filter candidates by type' -r -a '${typeChoices}'
+complete -c pm -n '__pm_history_operation next' -l tag            -d 'Filter candidates by tag' -r -a ${fishTagChoices}
+complete -c pm -n '__pm_history_operation next' -l priority       -d 'Filter candidates by priority' -r -a '0 1 2 3 4'
+complete -c pm -n '__pm_history_operation next' -l assignee       -d 'Filter candidates by assignee' -r
+complete -c pm -n '__pm_history_operation next' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__pm_history_operation next' -l sprint         -d 'Filter candidates by sprint' -r
+complete -c pm -n '__pm_history_operation next' -l release        -d 'Filter candidates by release' -r
+complete -c pm -n '__pm_history_operation next' -l parent         -d 'Scope to one item subtree' -r
+complete -c pm -n '__pm_history_operation next' -l limit          -d 'Limit ready rows' -r
+complete -c pm -n '__pm_history_operation next' -l blocked-limit  -d 'Limit blocked rows' -r
+complete -c pm -n '__pm_history_operation next' -l ready-only     -d 'Omit the blocked companion list'
+complete -c pm -n '__pm_history_operation next' -l format         -d 'Output override' -r -a 'markdown toon json'
 
 # guide flags
 complete -c pm -n '__fish_seen_subcommand_from guide' -l list      -d 'Show guide topic index'
@@ -1586,8 +1601,8 @@ complete -c pm -n '__fish_seen_subcommand_from guide' -l depth     -d 'Guide det
 complete -c pm -n '__fish_seen_subcommand_from guide' -a '${guideTopicChoices}' -d 'Guide topic'
 
 # reindex flags
-complete -c pm -n '__fish_seen_subcommand_from reindex' -l mode -d 'Reindex mode' -r -a 'keyword semantic hybrid'
-complete -c pm -n '__fish_seen_subcommand_from reindex' -l progress -d 'Emit progress updates to stderr'
+complete -c pm -n '__pm_history_operation reindex' -l mode -d 'Reindex mode' -r -a 'keyword semantic hybrid'
+complete -c pm -n '__pm_history_operation reindex' -l progress -d 'Emit progress updates to stderr'
 
 # get flags
 complete -c pm -n '__fish_seen_subcommand_from get' -l depth -d 'Detail depth' -r -a 'brief standard deep full'
@@ -1616,9 +1631,12 @@ function __pm_history_tokens
         printf '%s\\n' --
         return
     end
+    if test $positions -eq 0; and test "$token" = ctx
+      set token context
+    end
     printf '%s\\n' "$token"
     set positions (math $positions + 1)
-    if test $positions -eq 2; or test "$token" != history
+    if test $positions -eq 2; or not contains -- "$token" ${NAMESPACE_NOUNS.join(" ")}
       return
     end
   end
@@ -1630,13 +1648,14 @@ end
 # Match only the command positions, keeping item history separate from maintenance.
 function __pm_history_operation
   set -l tokens (__pm_history_tokens)
-  if test "$tokens[1]" = history; and contains -- "$tokens[2]" ${HISTORY_LEAVES}
-    test "$tokens[2]" = "$argv[2]"
-  else
-    test "$tokens[1]" = "$argv[1]"
+  switch "$tokens[1] $tokens[2]"
+${PM_NAMESPACED_COMMAND_ALIASES.map(entry=>`    case '${entry.canonical}'
+      contains -- '${entry.alias}' $argv
+      return`).join("\n")}
   end
+  contains -- "$tokens[1]" $argv
 end
-complete -c pm -n 'test (count (__pm_history_tokens)) -eq 1; and __pm_history_operation history' -a '${HISTORY_LEAVES}' -d 'History operation'
+${Object.entries(NAMESPACE_LEAVES).map(([noun,leaves])=>`complete -c pm -n 'test (count (__pm_history_tokens)) -eq 1; and __pm_history_operation ${noun}' -a '${leaves}' -d '${noun} operation'`).join("\n")}
 ${RESTORE_INVOCATIONS.map(flag=>`complete -c pm -n '__pm_history_operation restore restore' -l ${flag.flag.slice(2)}${flag.takes_value?" -r":""}`).join("\n")}
 
 # history / activity flags
@@ -1651,19 +1670,19 @@ complete -c pm -n '__pm_history_operation history'  -l provenance-filter -d 'Fil
 complete -c pm -n '__pm_history_operation history'  -l diff -d 'Include per-entry field-level before/after value diffs'
 complete -c pm -n '__pm_history_operation history'  -l field -d 'With --diff, show only entries that changed this field' -r
 complete -c pm -n '__pm_history_operation history'  -l verify -d 'Verify history hash chain and replay integrity'
-complete -c pm -n '__fish_seen_subcommand_from events' -l since -d 'Resume after a cursor or from an ISO timestamp' -r
-complete -c pm -n '__fish_seen_subcommand_from events' -l type -d 'Filter by mutation operation' -r
-complete -c pm -n '__fish_seen_subcommand_from events' -l author -d 'Filter by mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from events' -l item -d 'Filter by item or workspace stream' -r
-complete -c pm -n '__fish_seen_subcommand_from events' -l limit -d 'Maximum events, up to 1000' -r
-complete -c pm -n '__fish_seen_subcommand_from events' -l full -d 'Include complete authoritative history entries'
-complete -c pm -n '__fish_seen_subcommand_from events' -l provenance -d 'Include patch-free identity and agent provenance'
-complete -c pm -n '__fish_seen_subcommand_from events' -l provenance-summary -d 'Include bounded provenance completeness counts'
-complete -c pm -n '__fish_seen_subcommand_from events' -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
-complete -c pm -n '__fish_seen_subcommand_from events' -l agent-instance -d 'Filter by privacy-safe agent instance' -r
-complete -c pm -n '__fish_seen_subcommand_from events' -l provenance-filter -d 'Filter by exact declared provenance value' -r
-complete -c pm -n '__fish_seen_subcommand_from events' -l follow -d 'Continue emitting committed events'
-complete -c pm -n '__fish_seen_subcommand_from events' -l interval-ms -d 'Empty-read delay while following' -r
+complete -c pm -n '__pm_history_operation events' -l since -d 'Resume after a cursor or from an ISO timestamp' -r
+complete -c pm -n '__pm_history_operation events' -l type -d 'Filter by mutation operation' -r
+complete -c pm -n '__pm_history_operation events' -l author -d 'Filter by mutation author' -r
+complete -c pm -n '__pm_history_operation events' -l item -d 'Filter by item or workspace stream' -r
+complete -c pm -n '__pm_history_operation events' -l limit -d 'Maximum events, up to 1000' -r
+complete -c pm -n '__pm_history_operation events' -l full -d 'Include complete authoritative history entries'
+complete -c pm -n '__pm_history_operation events' -l provenance -d 'Include patch-free identity and agent provenance'
+complete -c pm -n '__pm_history_operation events' -l provenance-summary -d 'Include bounded provenance completeness counts'
+complete -c pm -n '__pm_history_operation events' -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
+complete -c pm -n '__pm_history_operation events' -l agent-instance -d 'Filter by privacy-safe agent instance' -r
+complete -c pm -n '__pm_history_operation events' -l provenance-filter -d 'Filter by exact declared provenance value' -r
+complete -c pm -n '__pm_history_operation events' -l follow -d 'Continue emitting committed events'
+complete -c pm -n '__pm_history_operation events' -l interval-ms -d 'Empty-read delay while following' -r
 complete -c pm -n '__pm_history_operation history-compact compact' -l before -d 'Compact entries strictly before this version number or ISO timestamp' -r
 complete -c pm -n '__pm_history_operation history-compact compact' -l id -d 'Item ID (alternative to positional ID)' -r
 complete -c pm -n '__pm_history_operation history-compact compact' -l ids -d 'Bulk: compact an explicit comma-separated list of item ids' -r
@@ -1699,7 +1718,12 @@ complete -c pm -n '__pm_history_operation history-repair repair' -l dry-run -d '
 complete -c pm -n '__pm_history_operation history-repair repair' -l author -d 'Mutation author' -r
 complete -c pm -n '__pm_history_operation history-repair repair' -l message -d 'Audit history message' -r
 complete -c pm -n '__pm_history_operation history-repair repair' -l force -d 'Force ownership/lock override'
-complete -c pm -n '__fish_seen_subcommand_from schema' -a 'list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset rename-type rename-field remap-status' -d 'Schema subcommand'
+complete -c pm -n '__fish_seen_subcommand_from schema' -a '${SCHEMA_SUBCOMMAND_CHOICES}' -d 'Schema subcommand'
+complete -c pm -n '__fish_seen_subcommand_from schema; and __fish_seen_subcommand_from policy-mode' -a 'advise refuse' -d 'Policy enforcement'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l definition -d 'Policy definition or proposed fields JSON' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l policy -d 'Approval policy id' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l message -d 'History rationale' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l dry-run -d 'Preview schema changes'
 complete -c pm -n '__fish_seen_subcommand_from schema' -l description -d 'Human description for the custom item type, status, or field' -r
 complete -c pm -n '__fish_seen_subcommand_from schema' -l default-status -d 'Default status hint for the custom item type' -r
 complete -c pm -n '__fish_seen_subcommand_from schema' -l folder -d 'Storage folder for items of this custom type' -r
@@ -1845,23 +1869,23 @@ complete -c pm -n '__fish_seen_subcommand_from test' -l message -d 'History mess
 complete -c pm -n '__fish_seen_subcommand_from test' -l force -d 'Force override'
 
 # test-all flags
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l status  -d 'Filter by status' -r -a 'open in_progress'
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l limit -d 'Limit matching items before running linked tests' -r
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l offset -d 'Skip matching items before running linked tests' -r
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l background -d 'Run linked tests in managed background mode'
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l timeout -d 'Default timeout seconds' -r
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l progress -d 'Emit linked-test progress to stderr'
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l env-set -d 'Set linked-test runtime environment values' -r
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l env-clear -d 'Clear linked-test runtime environment values' -r
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l shared-host-safe -d 'Apply shared-host-safe runtime defaults'
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l pm-context -d 'PM linked-test context mode' -r -a 'schema tracker auto'
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l override-linked-pm-context -d 'Force run-level --pm-context over per-linked-test metadata'
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l fail-on-context-mismatch -d 'Fail when context item counts mismatch'
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l fail-on-skipped -d 'Treat skipped linked tests as dependency failures'
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l fail-on-empty-test-run -d 'Treat empty linked-test selections as failures'
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l require-assertions-for-pm -d 'Require assertions for linked PM command tests'
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l check-context -d 'Preflight linked PM command context diagnostics before execution'
-complete -c pm -n '__fish_seen_subcommand_from test-all' -l auto-pm-context -d 'Auto-remediate tracker-read context mismatches using tracker context'
+complete -c pm -n '__pm_history_operation test-all' -l status  -d 'Filter by status' -r -a 'open in_progress'
+complete -c pm -n '__pm_history_operation test-all' -l limit -d 'Limit matching items before running linked tests' -r
+complete -c pm -n '__pm_history_operation test-all' -l offset -d 'Skip matching items before running linked tests' -r
+complete -c pm -n '__pm_history_operation test-all' -l background -d 'Run linked tests in managed background mode'
+complete -c pm -n '__pm_history_operation test-all' -l timeout -d 'Default timeout seconds' -r
+complete -c pm -n '__pm_history_operation test-all' -l progress -d 'Emit linked-test progress to stderr'
+complete -c pm -n '__pm_history_operation test-all' -l env-set -d 'Set linked-test runtime environment values' -r
+complete -c pm -n '__pm_history_operation test-all' -l env-clear -d 'Clear linked-test runtime environment values' -r
+complete -c pm -n '__pm_history_operation test-all' -l shared-host-safe -d 'Apply shared-host-safe runtime defaults'
+complete -c pm -n '__pm_history_operation test-all' -l pm-context -d 'PM linked-test context mode' -r -a 'schema tracker auto'
+complete -c pm -n '__pm_history_operation test-all' -l override-linked-pm-context -d 'Force run-level --pm-context over per-linked-test metadata'
+complete -c pm -n '__pm_history_operation test-all' -l fail-on-context-mismatch -d 'Fail when context item counts mismatch'
+complete -c pm -n '__pm_history_operation test-all' -l fail-on-skipped -d 'Treat skipped linked tests as dependency failures'
+complete -c pm -n '__pm_history_operation test-all' -l fail-on-empty-test-run -d 'Treat empty linked-test selections as failures'
+complete -c pm -n '__pm_history_operation test-all' -l require-assertions-for-pm -d 'Require assertions for linked PM command tests'
+complete -c pm -n '__pm_history_operation test-all' -l check-context -d 'Preflight linked PM command context diagnostics before execution'
+complete -c pm -n '__pm_history_operation test-all' -l auto-pm-context -d 'Auto-remediate tracker-read context mismatches using tracker context'
 
 # test-runs flags
 complete -c pm -n '__fish_seen_subcommand_from test-runs' -a 'list status logs stop resume' -d 'test-runs subcommand'
@@ -1873,19 +1897,19 @@ complete -c pm -n '__fish_seen_subcommand_from test-runs' -l force -d 'Force-sto
 complete -c pm -n '__fish_seen_subcommand_from test-runs' -l author -d 'Resume author' -r
 
 # gc flags
-complete -c pm -n '__fish_seen_subcommand_from gc' -l dry-run -d 'Preview cleanup targets without deleting files'
-complete -c pm -n '__fish_seen_subcommand_from gc' -l scope -d 'Limit cleanup to index/embeddings/runtime/locks scopes' -r
+complete -c pm -n '__pm_history_operation gc' -l dry-run -d 'Preview cleanup targets without deleting files'
+complete -c pm -n '__pm_history_operation gc' -l scope -d 'Limit cleanup to index/embeddings/runtime/locks scopes' -r
 
 # stats flags
-complete -c pm -n '__fish_seen_subcommand_from stats' -l include-empty -d 'Include registered zero-count type and status buckets'
-complete -c pm -n '__fish_seen_subcommand_from stats' -l storage -d 'Include aggregate history-stream storage metrics'
-complete -c pm -n '__fish_seen_subcommand_from stats' -l metadata-coverage -d 'Include metadata coverage percentages overall and by type'
-complete -c pm -n '__fish_seen_subcommand_from stats' -l field-utilization -d 'Include content-field utilization rates across all items'
-complete -c pm -n '__fish_seen_subcommand_from stats' -l by-assignee -d 'Lifecycle-bucketed breakdown grouped by assignee'
-complete -c pm -n '__fish_seen_subcommand_from stats' -l by-tag -d 'Lifecycle-bucketed breakdown grouped by tag'
-complete -c pm -n '__fish_seen_subcommand_from stats' -l by-priority -d 'Lifecycle-bucketed breakdown grouped by priority'
-complete -c pm -n '__fish_seen_subcommand_from stats' -l tag-prefix -d 'With --by-tag: only count tags with this prefix' -r
-complete -c pm -n '__fish_seen_subcommand_from stats' -l analytics -d 'Improvement ledger/history analytics JSON' -r
+complete -c pm -n '__pm_history_operation stats' -l include-empty -d 'Include registered zero-count type and status buckets'
+complete -c pm -n '__pm_history_operation stats' -l storage -d 'Include aggregate history-stream storage metrics'
+complete -c pm -n '__pm_history_operation stats' -l metadata-coverage -d 'Include metadata coverage percentages overall and by type'
+complete -c pm -n '__pm_history_operation stats' -l field-utilization -d 'Include content-field utilization rates across all items'
+complete -c pm -n '__pm_history_operation stats' -l by-assignee -d 'Lifecycle-bucketed breakdown grouped by assignee'
+complete -c pm -n '__pm_history_operation stats' -l by-tag -d 'Lifecycle-bucketed breakdown grouped by tag'
+complete -c pm -n '__pm_history_operation stats' -l by-priority -d 'Lifecycle-bucketed breakdown grouped by priority'
+complete -c pm -n '__pm_history_operation stats' -l tag-prefix -d 'With --by-tag: only count tags with this prefix' -r
+complete -c pm -n '__pm_history_operation stats' -l analytics -d 'Improvement ledger/history analytics JSON' -r
 
 # append flags
 complete -c pm -n '__fish_seen_subcommand_from append' -s b -l body -d 'Item body' -r
@@ -1894,22 +1918,25 @@ complete -c pm -n '__fish_seen_subcommand_from append' -l message -d 'History me
 complete -c pm -n '__fish_seen_subcommand_from append' -l force -d 'Force override'
 
 # close flags
-complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l author -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l message -d 'History message' -r
-complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l force -d 'Force override'
+complete -c pm -n '__pm_history_operation close' -l release-assignment -d 'Close and release assignment'
+complete -c pm -n '__pm_history_operation release' -l pause -d 'Return to open and release ownership'
+complete -c pm -n '__pm_history_operation claim' -l start -d 'Claim and start work'
+complete -c pm -n '__pm_history_operation claim release start-task pause-task close close-task delete' -l author -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation claim release start-task pause-task close close-task delete' -l message -d 'History message' -r
+complete -c pm -n '__pm_history_operation claim release start-task pause-task close close-task delete' -l force -d 'Force override'
 complete -c pm -n '__fish_seen_subcommand_from claim' -l if-available -d 'Skip work held by another author'
 complete -c pm -n '__fish_seen_subcommand_from claim' -l next -d 'Atomically claim the next actionable item'
 complete -c pm -n '__fish_seen_subcommand_from claim' -l token-budget -d 'Bound ranked candidate tokens' -r
 complete -c pm -n '__fish_seen_subcommand_from claim' -l explain-ranking -d 'Include ranking provenance'
-complete -c pm -n '__fish_seen_subcommand_from close close-task' -l validate-close -d 'Validate closure metadata mode' -r -a 'off warn strict'
-complete -c pm -n '__fish_seen_subcommand_from close' -l reason -d 'Closure reason' -r
-complete -c pm -n '__fish_seen_subcommand_from close' -l close-reason -d 'Alias for --reason' -r
-complete -c pm -n '__fish_seen_subcommand_from close' -l resolution -d 'Closure resolution summary' -r
-complete -c pm -n '__fish_seen_subcommand_from close' -l expected-result -d 'Expected behavior note' -r
-complete -c pm -n '__fish_seen_subcommand_from close' -l actual-result -d 'Observed behavior note' -r
-complete -c pm -n '__fish_seen_subcommand_from close' -l expected -d 'Short alias for --expected-result' -r
-complete -c pm -n '__fish_seen_subcommand_from close' -l actual -d 'Short alias for --actual-result' -r
-complete -c pm -n '__fish_seen_subcommand_from delete' -l dry-run -d 'Preview the item file that would be deleted without mutating'
+complete -c pm -n '__pm_history_operation close close-task' -l validate-close -d 'Validate closure metadata mode' -r -a 'off warn strict'
+complete -c pm -n '__pm_history_operation close' -l reason -d 'Closure reason' -r
+complete -c pm -n '__pm_history_operation close' -l close-reason -d 'Alias for --reason' -r
+complete -c pm -n '__pm_history_operation close' -l resolution -d 'Closure resolution summary' -r
+complete -c pm -n '__pm_history_operation close' -l expected-result -d 'Expected behavior note' -r
+complete -c pm -n '__pm_history_operation close' -l actual-result -d 'Observed behavior note' -r
+complete -c pm -n '__pm_history_operation close' -l expected -d 'Short alias for --expected-result' -r
+complete -c pm -n '__pm_history_operation close' -l actual -d 'Short alias for --actual-result' -r
+complete -c pm -n '__pm_history_operation delete' -l dry-run -d 'Preview the item file that would be deleted without mutating'
 
 # scheduling shortcut flags (meet/event/remind)
 complete -c pm -n '__fish_seen_subcommand_from meet event' -l start -d 'Start time (ISO, now, or relative)' -r
@@ -1930,84 +1957,85 @@ complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l author -d '
 complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l message -d 'History message' -r
 
 # close-many flags
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-status          -d 'Filter by status before closing' -r -a '${statusChoices}'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-type            -d 'Filter by type before closing' -r -a '${typeChoices}'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-tag             -d 'Filter by tag before closing' -r -a ${fishTagChoices}
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-priority        -d 'Filter by priority before closing' -r -a '0 1 2 3 4'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-deadline-before -d 'Filter by deadline upper bound' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-deadline-after  -d 'Filter by deadline lower bound' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-updated-after   -d 'Filter by updated_at lower bound (ISO/relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-updated-before  -d 'Filter by updated_at upper bound (ISO/relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-created-after   -d 'Filter by created_at lower bound (ISO/relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-created-before  -d 'Filter by created_at upper bound (ISO/relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-assignee        -d 'Filter by assignee before closing' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-parent          -d 'Filter by parent item ID' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-sprint          -d 'Filter by sprint before closing' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-release         -d 'Filter by release before closing' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-risk-missing       -d 'Select only items missing risk'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-confidence-missing -d 'Select only items missing confidence'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-sprint-missing     -d 'Select only items missing sprint'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-release-missing    -d 'Select only items missing release'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-notes          -d 'Select only items that have notes'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-notes           -d 'Select only items with no notes'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-learnings      -d 'Select only items that have learnings'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-learnings       -d 'Select only items with no learnings'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-files          -d 'Select only items that have linked files'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-files           -d 'Select only items with no linked files'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-docs           -d 'Select only items that have linked docs'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-docs            -d 'Select only items with no linked docs'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-tests          -d 'Select only items that have linked tests'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-tests           -d 'Select only items with no linked tests'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-comments       -d 'Select only items that have comments'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-comments        -d 'Select only items with no comments'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-deps           -d 'Select only items that have dependencies'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-deps            -d 'Select only items with no dependencies'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-body           -d 'Select only items with non-empty body'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-empty-body         -d 'Select only items with empty body'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-linked-command -d 'Select only items that have a linked command'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-linked-command  -d 'Select only items with no linked command'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l ids                    -d 'Explicit comma-separated ID allowlist' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l limit                  -d 'Limit matched item count' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l offset                 -d 'Skip first n matched rows' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l reason                 -d 'Optional shared close reason applied to every matched item' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l resolution             -d 'Shared closure resolution' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l expected-result        -d 'Shared expected-result note' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l actual-result          -d 'Shared actual-result note' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l expected               -d 'Short alias for --expected-result' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l actual                 -d 'Short alias for --actual-result' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l validate-close         -d 'Validate closure metadata per item' -r -a 'off warn strict'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l author                 -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l message                -d 'History message' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l force                  -d 'Re-close terminal matches and override ownership'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l dry-run                -d 'Preview matched items without mutating'
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l rollback               -d 'Rollback checkpoint ID' -r
-complete -c pm -n '__fish_seen_subcommand_from close-many' -l no-checkpoint          -d 'Disable checkpoint creation during apply mode'
+complete -c pm -n '__pm_history_operation close-many' -l filter-status          -d 'Filter by status before closing' -r -a '${statusChoices}'
+complete -c pm -n '__pm_history_operation close-many' -l filter-type            -d 'Filter by type before closing' -r -a '${typeChoices}'
+complete -c pm -n '__pm_history_operation close-many' -l filter-tag             -d 'Filter by tag before closing' -r -a ${fishTagChoices}
+complete -c pm -n '__pm_history_operation close-many' -l filter-priority        -d 'Filter by priority before closing' -r -a '0 1 2 3 4'
+complete -c pm -n '__pm_history_operation close-many' -l filter-deadline-before -d 'Filter by deadline upper bound' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-deadline-after  -d 'Filter by deadline lower bound' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-updated-after   -d 'Filter by updated_at lower bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-updated-before  -d 'Filter by updated_at upper bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-created-after   -d 'Filter by created_at lower bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-created-before  -d 'Filter by created_at upper bound (ISO/relative)' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-assignee        -d 'Filter by assignee before closing' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__pm_history_operation close-many' -l filter-parent          -d 'Filter by parent item ID' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-sprint          -d 'Filter by sprint before closing' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-release         -d 'Filter by release before closing' -r
+complete -c pm -n '__pm_history_operation close-many' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
+complete -c pm -n '__pm_history_operation close-many' -l filter-risk-missing       -d 'Select only items missing risk'
+complete -c pm -n '__pm_history_operation close-many' -l filter-confidence-missing -d 'Select only items missing confidence'
+complete -c pm -n '__pm_history_operation close-many' -l filter-sprint-missing     -d 'Select only items missing sprint'
+complete -c pm -n '__pm_history_operation close-many' -l filter-release-missing    -d 'Select only items missing release'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-notes          -d 'Select only items that have notes'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-notes           -d 'Select only items with no notes'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-learnings      -d 'Select only items that have learnings'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-learnings       -d 'Select only items with no learnings'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-files          -d 'Select only items that have linked files'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-files           -d 'Select only items with no linked files'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-docs           -d 'Select only items that have linked docs'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-docs            -d 'Select only items with no linked docs'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-tests          -d 'Select only items that have linked tests'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-tests           -d 'Select only items with no linked tests'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-comments       -d 'Select only items that have comments'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-comments        -d 'Select only items with no comments'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-deps           -d 'Select only items that have dependencies'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-deps            -d 'Select only items with no dependencies'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-body           -d 'Select only items with non-empty body'
+complete -c pm -n '__pm_history_operation close-many' -l filter-empty-body         -d 'Select only items with empty body'
+complete -c pm -n '__pm_history_operation close-many' -l filter-has-linked-command -d 'Select only items that have a linked command'
+complete -c pm -n '__pm_history_operation close-many' -l filter-no-linked-command  -d 'Select only items with no linked command'
+complete -c pm -n '__pm_history_operation close-many' -l ids                    -d 'Explicit comma-separated ID allowlist' -r
+complete -c pm -n '__pm_history_operation close-many' -l limit                  -d 'Limit matched item count' -r
+complete -c pm -n '__pm_history_operation close-many' -l offset                 -d 'Skip first n matched rows' -r
+complete -c pm -n '__pm_history_operation close-many' -l reason                 -d 'Optional shared close reason applied to every matched item' -r
+complete -c pm -n '__pm_history_operation close-many' -l resolution             -d 'Shared closure resolution' -r
+complete -c pm -n '__pm_history_operation close-many' -l expected-result        -d 'Shared expected-result note' -r
+complete -c pm -n '__pm_history_operation close-many' -l actual-result          -d 'Shared actual-result note' -r
+complete -c pm -n '__pm_history_operation close-many' -l expected               -d 'Short alias for --expected-result' -r
+complete -c pm -n '__pm_history_operation close-many' -l actual                 -d 'Short alias for --actual-result' -r
+complete -c pm -n '__pm_history_operation close-many' -l validate-close         -d 'Validate closure metadata per item' -r -a 'off warn strict'
+complete -c pm -n '__pm_history_operation close-many' -l author                 -d 'Mutation author' -r
+complete -c pm -n '__pm_history_operation close-many' -l message                -d 'History message' -r
+complete -c pm -n '__pm_history_operation close-many' -l force                  -d 'Re-close terminal matches and override ownership'
+complete -c pm -n '__pm_history_operation close-many' -l dry-run                -d 'Preview matched items without mutating'
+complete -c pm -n '__pm_history_operation close-many' -l rollback               -d 'Rollback checkpoint ID' -r
+complete -c pm -n '__pm_history_operation close-many' -l no-checkpoint          -d 'Disable checkpoint creation during apply mode'
 
 # validate flags
-complete -c pm -n '__fish_seen_subcommand_from validate' -l check-metadata -d 'Run metadata completeness checks'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l metadata-profile -d 'Select metadata validation profile for --check-metadata' -r -a 'core strict custom'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l check-resolution -d 'Run closed-item resolution metadata checks'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l check-lifecycle -d 'Run active-item lifecycle governance drift checks'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l check-stale-blockers -d 'Include stale blocker-pattern diagnostics in lifecycle checks'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l dependency-cycle-severity -d 'Set dependency-cycle warning policy for lifecycle checks' -r -a 'off warn error'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l parent-cycle-severity -d 'Set parent-hierarchy cycle warning policy for lifecycle checks' -r -a 'off warn error'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l check-files -d 'Run linked-file and orphaned-file checks'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l scan-mode -d 'Select file candidate scan mode for --check-files' -r -a 'default tracked-all tracked-all-strict'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l include-pm-internals -d 'Include PM storage internals in tracked-all candidate scans'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l verbose-file-lists -d 'Include full file-path lists for validate --check-files details'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l verbose-diagnostics -d 'Include full validate diagnostic ID lists instead of compact summaries'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l all-affected-ids -d 'Emit complete missing_* affected-ID lists with no truncation (implied by --json)'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l strict-exit -d 'Return non-zero exit when validation warnings are present'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l fail-on-warn -d 'Alias for --strict-exit'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l fix-hints -d 'Add a machine-executable fix_hints[] of pm commands to each failing check'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l auto-fix -d 'Apply the safe, deterministic subset of fix-hint remediations automatically'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l dry-run -d 'Preview planned --auto-fix/--prune-missing fixes without applying them'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l fix-scope -d 'Grant --auto-fix scopes (estimates/lifecycle must be named explicitly)' -r -a 'metadata resolution estimates lifecycle'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l prune-missing -d 'Remove stale linked-file/doc links classified as deleted'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l check-history-drift -d 'Run item/history hash drift checks'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l check-command-references -d 'Run linked-command PM-ID reference checks'
+complete -c pm -n '__pm_history_operation validate' -l check-completeness -d 'Check declarative required fields'
+complete -c pm -n '__pm_history_operation validate' -l check-metadata -d 'Run metadata completeness checks'
+complete -c pm -n '__pm_history_operation validate' -l metadata-profile -d 'Select metadata validation profile for --check-metadata' -r -a 'core strict custom'
+complete -c pm -n '__pm_history_operation validate' -l check-resolution -d 'Run closed-item resolution metadata checks'
+complete -c pm -n '__pm_history_operation validate' -l check-lifecycle -d 'Run active-item lifecycle governance drift checks'
+complete -c pm -n '__pm_history_operation validate' -l check-stale-blockers -d 'Include stale blocker-pattern diagnostics in lifecycle checks'
+complete -c pm -n '__pm_history_operation validate' -l dependency-cycle-severity -d 'Set dependency-cycle warning policy for lifecycle checks' -r -a 'off warn error'
+complete -c pm -n '__pm_history_operation validate' -l parent-cycle-severity -d 'Set parent-hierarchy cycle warning policy for lifecycle checks' -r -a 'off warn error'
+complete -c pm -n '__pm_history_operation validate' -l check-files -d 'Run linked-file and orphaned-file checks'
+complete -c pm -n '__pm_history_operation validate' -l scan-mode -d 'Select file candidate scan mode for --check-files' -r -a 'default tracked-all tracked-all-strict'
+complete -c pm -n '__pm_history_operation validate' -l include-pm-internals -d 'Include PM storage internals in tracked-all candidate scans'
+complete -c pm -n '__pm_history_operation validate' -l verbose-file-lists -d 'Include full file-path lists for validate --check-files details'
+complete -c pm -n '__pm_history_operation validate' -l verbose-diagnostics -d 'Include full validate diagnostic ID lists instead of compact summaries'
+complete -c pm -n '__pm_history_operation validate' -l all-affected-ids -d 'Emit complete missing_* affected-ID lists with no truncation (implied by --json)'
+complete -c pm -n '__pm_history_operation validate' -l strict-exit -d 'Return non-zero exit when validation warnings are present'
+complete -c pm -n '__pm_history_operation validate' -l fail-on-warn -d 'Alias for --strict-exit'
+complete -c pm -n '__pm_history_operation validate' -l fix-hints -d 'Add a machine-executable fix_hints[] of pm commands to each failing check'
+complete -c pm -n '__pm_history_operation validate' -l auto-fix -d 'Apply the safe, deterministic subset of fix-hint remediations automatically'
+complete -c pm -n '__pm_history_operation validate' -l dry-run -d 'Preview planned --auto-fix/--prune-missing fixes without applying them'
+complete -c pm -n '__pm_history_operation validate' -l fix-scope -d 'Grant --auto-fix scopes (estimates/lifecycle must be named explicitly)' -r -a 'metadata resolution estimates lifecycle'
+complete -c pm -n '__pm_history_operation validate' -l prune-missing -d 'Remove stale linked-file/doc links classified as deleted'
+complete -c pm -n '__pm_history_operation validate' -l check-history-drift -d 'Run item/history hash drift checks'
+complete -c pm -n '__pm_history_operation validate' -l check-command-references -d 'Run linked-command PM-ID reference checks'
 complete -c pm -n '__fish_seen_subcommand_from init' -l preset -d 'Governance preset for new setups' -r -a 'minimal default strict'
 complete -c pm -n '__fish_seen_subcommand_from init' -l id-prefix -d 'Set the item ID prefix' -r
 complete -c pm -n '__fish_seen_subcommand_from init' -l prefix -d 'Alias for --id-prefix' -r
@@ -2022,16 +2050,16 @@ complete -c pm -n '__fish_seen_subcommand_from config' -l criterion -d 'Criteria
 complete -c pm -n '__fish_seen_subcommand_from config' -l clear-criteria -d 'Clear config criteria-list key values'
 complete -c pm -n '__fish_seen_subcommand_from config' -l format -d 'Item format for item-format key' -r -a 'toon'
 complete -c pm -n '__fish_seen_subcommand_from config' -l policy -d 'Policy value for supported policy keys' -r
-complete -c pm -n '__fish_seen_subcommand_from health' -l strict-directories -d 'Treat optional item-type directories as required failures'
-complete -c pm -n '__fish_seen_subcommand_from health' -l check-only -d 'Run read-only health diagnostics without refreshing vectors'
-complete -c pm -n '__fish_seen_subcommand_from health' -l no-refresh -d 'Disable automatic vector refresh attempts during health checks'
-complete -c pm -n '__fish_seen_subcommand_from health' -l refresh-vectors -d 'Explicitly enable vector refresh attempts during health checks'
-complete -c pm -n '__fish_seen_subcommand_from health' -l verbose-stale-items -d 'Include full stale vectorization ID lists in health output'
-complete -c pm -n '__fish_seen_subcommand_from health' -l verbose-author-events -d 'Include complete actionable unknown-author coordinates'
-complete -c pm -n '__fish_seen_subcommand_from health' -l brief -d 'Emit compact health details for low-token agent checks'
-complete -c pm -n '__fish_seen_subcommand_from health' -l summary -d 'Emit one-line-style health status with check names and warning count'
-complete -c pm -n '__fish_seen_subcommand_from health' -l strict-exit -d 'Return non-zero exit when health warnings are present'
-complete -c pm -n '__fish_seen_subcommand_from health' -l fail-on-warn -d 'Alias for --strict-exit'
+complete -c pm -n '__pm_history_operation health' -l strict-directories -d 'Treat optional item-type directories as required failures'
+complete -c pm -n '__pm_history_operation health' -l check-only -d 'Run read-only health diagnostics without refreshing vectors'
+complete -c pm -n '__pm_history_operation health' -l no-refresh -d 'Disable automatic vector refresh attempts during health checks'
+complete -c pm -n '__pm_history_operation health' -l refresh-vectors -d 'Explicitly enable vector refresh attempts during health checks'
+complete -c pm -n '__pm_history_operation health' -l verbose-stale-items -d 'Include full stale vectorization ID lists in health output'
+complete -c pm -n '__pm_history_operation health' -l verbose-author-events -d 'Include complete actionable unknown-author coordinates'
+complete -c pm -n '__pm_history_operation health' -l brief -d 'Emit compact health details for low-token agent checks'
+complete -c pm -n '__pm_history_operation health' -l summary -d 'Emit one-line-style health status with check names and warning count'
+complete -c pm -n '__pm_history_operation health' -l strict-exit -d 'Return non-zero exit when health warnings are present'
+complete -c pm -n '__pm_history_operation health' -l fail-on-warn -d 'Alias for --strict-exit'
 
 # completion shell argument
 complete -c pm -n '__fish_seen_subcommand_from completion' -l eager-tags -d 'Embed current tracker tags directly in script output'