@unbrained/pm-cli 2026.9.19 → 2026.9.21

package/dist/sdk/completion.js

@@ -1,2161 +1,2 @@
-!(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]="6fd6ac84-b8ce-5b8c-8dc5-c94783671f12")}catch(e2){}})();import{PM_COMMAND_DESTINATION_CONTRACTS}from"./cli-contracts/grammar-contracts.js";import{WORKFLOW_POLICY_ACTIONS}from"./cli-contracts/enum-contracts.js";import{EXIT_CODE,PmCliError}from"./runtime-primitives.js";import{listPmCommandsForTier,resolvePmCommandVisibilityTier}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,resolvePmCommandOperation,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 ATTEST_INVOCATIONS=enrichCliFlagInvocationContracts("history-attest",resolveSubcommandFlagContractsForCommand("history-attest"));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_PREFIXES=[...new Set(PM_NAMESPACED_COMMAND_ALIASES.flatMap(entry=>entry.canonical_argv.slice(0,-1).map((_,index)=>entry.canonical_argv.slice(0,index+1).join(" "))))];const PACKAGE_NAMESPACE_OPERATIONS=new Set(PM_COMMAND_DESTINATION_CONTRACTS.filter(entry=>entry.disposition==="package_owned").map(entry=>resolvePmCommandOperation(entry.command)));const HISTORY_COMPLETION_ALIASES=PM_NAMESPACED_COMMAND_ALIASES.filter(entry=>entry.canonical_argv[0]==="history");const HISTORY_LEAVES=HISTORY_COMPLETION_ALIASES.map(entry=>entry.canonical_argv[1]).join(" ");function completionNamespaceLeaves(runtime){const available=new Set((runtime.namespace_commands??[]).map(resolvePmCommandOperation));const aliases=PM_NAMESPACED_COMMAND_ALIASES.filter(entry=>resolvePmCommandVisibilityTier(entry.canonical)!=="internal"&&(!PACKAGE_NAMESPACE_OPERATIONS.has(entry.alias)||available.has(entry.alias)));return Object.fromEntries(NAMESPACE_PREFIXES.map(prefix=>[prefix,[...new Set(aliases.filter(entry=>entry.canonical.startsWith(`${prefix} `)).map(entry=>entry.canonical_argv[prefix.split(" ").length]))].join(" ")]))}const HISTORY_OPERATION_FLAGS=HISTORY_COMPLETION_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"],["item","Manage item evidence, links, tests, and duplication"],["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
-  now=\${EPOCHSECONDS:-0}
-  ttl=\${${ttlVar}:-120}
-  cache_ts=\${${cacheTsVar}:-0}
-  if [[ -n "\${${cacheVar}:-}" && "$now" -ne 0 && $((now - cache_ts)) -lt "$ttl" ]]; then
-    print -r -- "$${cacheVar}"
-    return
-  fi
-  resolved="$(pm ${command} 2>/dev/null)"
-  if [[ -z "$resolved" ]]; then
-    resolved="${escapedFallback}"
-  fi
-  ${cacheVar}="$resolved"
-  ${cacheTsVar}="$now"
-  print -r -- "$${cacheVar}"
-}
-`}function renderFishDynamicChoiceResolver(kind,command,fallback){const envKind=kind.toUpperCase();const escapedFallback=fallback.replaceAll("'","\\'");return`
-function __pm_${kind}_choices
-  set -l now (date +%s ^/dev/null)
-  if test -z "$now"
-    set now 0
-  end
-  set -l ttl 120
-  if set -q PM_COMPLETION_${envKind}_TTL
-    set ttl $PM_COMPLETION_${envKind}_TTL
-  end
-  if set -q PM_COMPLETION_${envKind}_CACHE; and set -q PM_COMPLETION_${envKind}_CACHE_TS
-    set -l age (math "$now - $PM_COMPLETION_${envKind}_CACHE_TS")
-    if test $age -lt $ttl
-      printf '%s\\n' $PM_COMPLETION_${envKind}_CACHE
-      return
-    end
-  end
-  set -l resolved (pm ${command} ^/dev/null)
-  if test (count $resolved) -eq 0
-    set resolved '${escapedFallback}'
-  end
-  set -gx PM_COMPLETION_${envKind}_CACHE $resolved
-  set -gx PM_COMPLETION_${envKind}_CACHE_TS $now
-  printf '%s\\n' $resolved
-end
-`}function generateBashScript(itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const namespaceLeaves=completionNamespaceLeaves(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="" command_path="" 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"','      command_path="$cmd"',`      case "$cmd" in ${NAMESPACE_NOUNS.join("|")}) ;; *) break ;; esac`,"    else",'      case "$command_path $word" in',...PM_NAMESPACED_COMMAND_ALIASES.map(entry=>`        "${entry.canonical}") cmd="${entry.alias}"; command_path="${entry.canonical}" ;;`),"        *) break ;;","      esac",`      case "$command_path" in ${NAMESPACE_PREFIXES.map(prefix=>`"${prefix}"`).join("|")}) ;; *) (( word_index++ )); break ;; esac`,"    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(namespaceLeaves.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(namespaceLeaves.context)})`,"      fi","      ;;","    ops)",`      COMPREPLY=(${compgen(`${GLOBAL_FLAGS} ${namespaceLeaves.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(namespaceLeaves.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 [[ $word_index -eq $cword ]]; then",'    case "$command_path" in',...Object.entries(namespaceLeaves).filter(([prefix])=>["item","workspace","search"].includes(prefix.split(" ")[0])).map(([prefix,leaves])=>`      "${prefix}") COMPREPLY+=(${compgen(leaves)}) ;;`),"    esac","  fi",'  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 namespaceLeaves=completionNamespaceLeaves(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}
-  ttl=\${PM_COMPLETION_TAG_TTL:-120}
-  cache_ts=\${PM_COMPLETION_TAG_CACHE_TS:-0}
-  if [[ -n "\${PM_COMPLETION_TAG_CACHE:-}" && "$now" -ne 0 && $((now - cache_ts)) -lt "$ttl" ]]; then
-    print -r -- "$PM_COMPLETION_TAG_CACHE"
-    return
-  fi
-  PM_COMPLETION_TAG_CACHE="$(pm completion-tags 2>/dev/null)"
-  PM_COMPLETION_TAG_CACHE_TS="$now"
-  print -r -- "$PM_COMPLETION_TAG_CACHE"
-}
-`;return`#compdef pm
-# zsh completion for pm
-# Source this file or add 'eval "$(pm completion zsh)"' to ~/.zshrc
-
-_pm_commands() {
-  local -a commands
-  commands=(
-${renderZshCommandDescriptions()}
-  )
-  _describe 'command' commands
-}
-${dynamicTagResolver}
-${useDynamicTypeExpansion?renderZshDynamicChoiceResolver("type","completion-types",typeFallbackChoices):""}
-${renderZshDynamicChoiceResolver("status","completion-statuses",statusFallbackChoices)}
-
-_pm() {
-  local context state line
-  local -a words=("$words[@]")
-  local CURRENT=$CURRENT
-  local word_index=2 namespace_noun="" operation_path="" operation_index=0 word
-  while (( word_index < CURRENT )); do
-    word="$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 "$namespace_noun" ]]; then
-      [[ "$word" == "ctx" ]] && word="context"
-      case "$word" in ${NAMESPACE_NOUNS.join("|")}) ;; *) break ;; esac
-      namespace_noun="$word"
-    else
-      case "$namespace_noun $word" in
-${PM_NAMESPACED_COMMAND_ALIASES.map(entry=>`        "${entry.canonical}") namespace_noun="${entry.canonical}"; operation_path="$namespace_noun"; operation_index=$word_index ;;`).join("\n")}
-        *) break ;;
-      esac
-    fi
-    (( word_index++ ))
-  done
-  if [[ -n "$namespace_noun" ]] && (( word_index == CURRENT )) && [[ "$words[CURRENT]" != -* ]]; then
-    local -a history_commands
-    case "$namespace_noun" in
-${Object.entries(namespaceLeaves).map(([noun,leaves])=>`      "${noun}") history_commands=(${leaves}) ;;`).join("\n")}
-    esac
-    if (( \${#history_commands} > 0 )); then
-      _describe 'command operation' history_commands
-      return
-    fi
-  fi
-  if (( operation_index > 0 )); then
-    case "$operation_path" 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 \\
-    '--json[Output JSON instead of TOON]' \\
-    '--all[Reveal every public command and compatibility alias]' \\
-    '--quiet[Suppress stdout output]' \\
-    '--output-include[Retain comma-separated read fields or sections]:selectors' \\
-    '--output-limit[Set the universal read row ceiling]:limit' \\
-    '--output-budget[Set the universal estimated-token ceiling]:tokens' \\
-    '--output-format[Select the universal read encoding]:(toon json)' \\
-    '--output-session[Carry cross-call read budget and served-item state]:state' \\
-    '--output-row-contract[Include row schema metadata in read output]' \\
-    '--no-changed-fields[Omit changed_fields array from mutation output]' \\
-    '--pm-path[Explicit tracker storage path for this command]:path:_files -/' \\
-    '--path[Compatibility alias for --pm-path]:path:_files -/' \\
-    '--no-extensions[Disable extension loading]' \\
-    '--no-pager[Disable pager integration for help and long output]' \\
-    '--profile[Print deterministic timing diagnostics]' \\
-    '(-V --version)--version[Output the version number]' \\
-    '(-h --help)--help[Display help]' \\
-    '1: :_pm_commands' \\
-    '*:: :->args' && return 0
-
-  case $state in
-    args)
-      case $line[1] in
-        list)
-          _arguments \\
-            '*--status[Filter by status; repeatable, comma-separated, or all]:(${statusChoices})' \\
-            '--all[Include every lifecycle status]' \\
-            '--type[Filter by item type]:(${typeChoices})' \\
-            '--tag[Filter by tag]:(${zshTagChoices})' \\
-            '--tags[Alias for --tag]:(${zshTagChoices})' \\
-            '--priority[Filter by priority]:(0 1 2 3 4)' \\
-            '--deadline-before[Filter by deadline upper bound (ISO/date string or relative)]:date' \\
-            '--deadline-after[Filter by deadline lower bound (ISO/date string or relative)]:date' \\
-            '--today[Filter to items updated since local midnight today]' \\
-            '--recent[Filter to items updated in the last 7 days]' \\
-            '--updated-after[Filter by updated_at lower bound (ISO/relative)]:timestamp' \\
-            '--updated-before[Filter by updated_at upper bound (ISO/relative)]:timestamp' \\
-            '--created-after[Filter by created_at lower bound (ISO/relative)]:timestamp' \\
-            '--created-before[Filter by created_at upper bound (ISO/relative)]:timestamp' \\
-            '--assignee[Filter by assignee]:assignee' \\
-            '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
-            '--sprint[Filter by sprint]:sprint' \\
-            '--release[Filter by release]:release' \\
-${zshPresenceFilterFlags}
-            '--limit[Limit returned item count]:number' \\
-            '--offset[Skip the first n matching rows before limit]:number' \\
-            '--no-truncate[Return every matched row, overriding --limit]' \\
-            '--include-body[Include item body in each returned list row]' \\
-            '--compact[Render compact list projection fields]' \\
-            '--fields[Render custom comma-separated list fields]:fields' \\
-            '--tree[Render hierarchical subtree output rooted at --parent or top-level parents]' \\
-            '--tree-depth[Cap recursion depth for --tree (0 = root only)]:number' \\
-            '--sort[Sort field]:(priority deadline updated_at created_at title parent)' \\
-            '--order[Sort order (requires --sort)]:(asc desc)' \\
-            '--stream[Emit line-delimited JSON rows (requires --json)]' \\
-${zshListRuntimeFieldFlags}            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]' \\
-            '--pm-path[Explicit tracker storage path]:path:_files -/' \\
-            '--path[Compatibility alias for --pm-path]:path:_files -/'
-          ;;
-        aggregate)
-          _arguments \\
-            '--group-by[Comma-separated group-by fields (supported: parent,type,priority,status,assignee,tags,sprint,release)]:fields' \\
-            '--count[Return grouped counts]' \\
-            '--completion[Add open/in_progress/closed/other counts and completion percentage]' \\
-            '--sum[Numeric field to sum per group]:field' \\
-            '--avg[Numeric field to average per group]:field' \\
-            '--include-unparented[Include unparented rows when grouping by parent]' \\
-            '--status[Filter by status]:(${statusChoices})' \\
-            '--type[Filter by item type]:(${typeChoices})' \\
-            '--tag[Filter by tag]:(${zshTagChoices})' \\
-            '--priority[Filter by priority]:(0 1 2 3 4)' \\
-            '--deadline-before[Filter by deadline upper bound (ISO/date string or relative)]:date' \\
-            '--deadline-after[Filter by deadline lower bound (ISO/date string or relative)]:date' \\
-            '--assignee[Filter by assignee]:assignee' \\
-            '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
-            '--parent[Filter by parent item ID]:parent_id' \\
-            '--sprint[Filter by sprint]:sprint' \\
-            '--release[Filter by release]:release' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        duplicates)
-          _arguments \\
-            '*--status[Include lifecycle status (repeatable)]:(${statusChoices})' \\
-            '--since[Only inspect items created at or after this ISO timestamp]:timestamp' \\
-            '--threshold[Minimum similarity score from zero through one]:number' \\
-            '--limit[Maximum duplicate clusters]:number'
-          ;;
-        create)
-          _arguments \\
-            '(-t --title)'{-t,--title}'[Item title]:title' \\
-            '(-d --description)'{-d,--description}'[Item description]:description' \\
-            '--type[Item type]:(${typeChoices})' \\
-            '--create-mode[Create required-option policy mode]:(strict progressive)' \\
-            '--schedule-preset[Scheduling preset for Reminder/Meeting/Event]:(lightweight)' \\
-            '(-s --status)'{-s,--status}'[Item status]:(${statusChoices})' \\
-            '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
-            '--tags[Comma-separated tags]:tags' \\
-            '--add-tags[Add tags additively without replacing existing]:tags' \\
-            '(-b --body)'{-b,--body}'[Item body]:body' \\
-            '--body-file[Load the item body from a file]:body_file:_files' \\
-            '--deadline[Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)]:deadline' \\
-            '--estimate[Estimated minutes]:minutes' \\
-            '--acceptance-criteria[Acceptance criteria]:criteria' \\
-            '--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-deps[Atomically replace dependencies with provided --dep values]' \\
-            '--replace-tests[Atomically replace linked tests with provided --test 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]' \\
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--assignee[Assignee]:assignee' \\
-${zshCreateRuntimeFieldFlags}            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        copy)
-          _arguments \\
-            '--title[Override copied title]:title' \\
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--force[Force ownership override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        focus)
-          _arguments \\
-            '--clear[Clear the focused item]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        meet|event)
-          _arguments \\
-${renderZshScheduleItemSpecs("event")}
-          ;;
-        remind)
-          _arguments \\
-${renderZshScheduleItemSpecs("reminder")}
-          ;;
-        update)
-          _arguments \\
-            '(-t --title)'{-t,--title}'[Item title]:title' \\
-            '(-d --description)'{-d,--description}'[Item description]:description' \\
-            '(-b --body)'{-b,--body}'[Item body]:body' \\
-            '--body-file[Load the item body from a file]:body_file:_files' \\
-            '(-s --status)'{-s,--status}'[Item status]:(${statusChoices})' \\
-            '--close-reason[Set close reason]:close_reason' \\
-            '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
-            '--type[Item type]:(${typeChoices})' \\
-            '--tags[Comma-separated tags]:tags' \\
-            '--add-tags[Add tags additively without replacing existing]:tags' \\
-            '--remove-tags[Remove tags from the existing list]:tags' \\
-            '--add-ac[Add one acceptance criterion without replacing existing]:criteria' \\
-            '--remove-ac[Remove one acceptance criterion by exact text]:criteria' \\
-            '--expected[Short alias for --expected-result]:expected_result' \\
-            '--actual[Short alias for --actual-result]:actual_result' \\
-${zshMutationCollectionFlags}
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--force[Force override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        update-many)
-          _arguments \\
-${renderZshBulkSelectionFilterSpecs("applying updates",statusChoices,typeChoices,zshTagChoices)}
-            '--filter-ac-missing[Select only items missing acceptance_criteria]' \\
-            '--filter-estimates-missing[Select only items missing estimated_minutes]' \\
-            '--filter-resolution-missing[Select only terminal items missing resolution]' \\
-            '--filter-metadata-missing[Select only items missing any tracked metadata]' \\
-${zshBulkPresenceFilterFlags}
-            '--ids[Explicit comma-separated ID allowlist]:ids' \\
-            '--limit[Limit matched item count]:number' \\
-            '--offset[Skip first n matched rows]:number' \\
-            '--dry-run[Preview updates without mutating]' \\
-            '--rollback[Rollback checkpoint ID]:checkpoint_id' \\
-            '--no-checkpoint[Disable checkpoint creation during apply mode]' \\
-            '(-t --title)'{-t,--title}'[Item title]:title' \\
-            '(-d --description)'{-d,--description}'[Item description]:description' \\
-            '(-b --body)'{-b,--body}'[Item body]:body' \\
-            '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
-            '--type[Item type]:(${typeChoices})' \\
-            '--tags[Comma-separated tags]:tags' \\
-            '--add-tags[Add tags additively without replacing existing]:tags' \\
-            '--remove-tags[Remove tags from the existing list]:tags' \\
-            '--deadline[Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)]:deadline' \\
-            '--estimate[Estimated minutes]:minutes' \\
-            '--acceptance-criteria[Acceptance criteria]:criteria' \\
-            '--add-ac[Add one acceptance criterion without replacing existing]:criteria' \\
-            '--remove-ac[Remove one acceptance criterion by exact text]:criteria' \\
-            '--definition-of-ready[Definition of ready]:definition_of_ready' \\
-            '--order[Planning order/rank]:order' \\
-            '--goal[Goal identifier]:goal' \\
-            '--objective[Objective identifier]:objective' \\
-            '--value[Business value summary]:value' \\
-            '--impact[Business impact summary]:impact' \\
-            '--outcome[Expected outcome summary]:outcome' \\
-            '--why-now[Why-now rationale]:why_now' \\
-            '--reviewer[Reviewer]:reviewer' \\
-            '--risk[Risk level]:risk' \\
-            '--confidence[Confidence level]:confidence' \\
-            '--sprint[Sprint identifier]:sprint' \\
-            '--release[Release identifier]:release' \\
-            '--reporter[Issue reporter]:reporter' \\
-            '--severity[Issue severity]:severity' \\
-            '--environment[Issue environment context]:environment' \\
-            '--repro-steps[Issue reproduction steps]:repro_steps' \\
-            '--resolution[Issue resolution summary]:resolution' \\
-            '--expected-result[Issue expected behavior]:expected_result' \\
-            '--actual-result[Issue observed behavior]:actual_result' \\
-            '--expected[Short alias for --expected-result]:expected_result' \\
-            '--actual[Short alias for --actual-result]:actual_result' \\
-            '--affected-version[Affected version identifier]:affected_version' \\
-            '--fixed-version[Fixed version identifier]:fixed_version' \\
-            '--component[Issue component ownership]:component' \\
-            '--regression[Regression marker true|false|1|0]:regression' \\
-            '--customer-impact[Customer impact summary]:customer_impact' \\
-            '--dep[Dependency seed id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>]:dep' \\
-            '--dep-remove[Dependency removal selector id=<id>,kind=<kind>,author=<author>,created_at=<timestamp>]:dep_remove' \\
-            '--replace-deps[Atomically replace dependencies with provided --dep values]' \\
-            '--replace-tests[Atomically replace linked tests with provided --test values]' \\
-${zshMutationCollectionFlags}
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--force[Force override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        close-many)
-          _arguments \\
-${renderZshBulkSelectionFilterSpecs("closing",statusChoices,typeChoices,zshTagChoices)}
-${zshBulkPresenceFilterFlags}
-            '--ids[Explicit comma-separated ID allowlist]:ids' \\
-            '--limit[Limit matched item count]:number' \\
-            '--offset[Skip first n matched rows]:number' \\
-            '--reason[Optional shared close reason applied to every matched item]:reason' \\
-            '--resolution[Shared closure resolution]:resolution' \\
-            '--expected-result[Shared expected-result note]:expected_result' \\
-            '--actual-result[Shared actual-result note]:actual_result' \\
-            '--expected[Short alias for --expected-result]:expected_result' \\
-            '--actual[Short alias for --actual-result]:actual_result' \\
-            '--validate-close[Validate closure metadata per item]:(off warn strict)' \\
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--force[Re-close terminal matches and override ownership]' \\
-            '--dry-run[Preview matched items without mutating]' \\
-            '--rollback[Rollback checkpoint ID]:checkpoint_id' \\
-            '--no-checkpoint[Disable checkpoint creation during apply mode]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        calendar|cal)
-          _arguments \\
-            '--view[Calendar view]:(agenda day week month)' \\
-            '--date[Anchor date/time (ISO/date string or relative)]:date' \\
-            '--from[Agenda lower bound (ISO/date string or relative)]:date' \\
-            '--to[Agenda upper bound (ISO/date string or relative)]:date' \\
-            '--past[Include past entries]' \\
-            '--full-period[Include full anchored day/week/month period]' \\
-            '--type[Filter by type]:(${typeChoices})' \\
-            '--tag[Filter by tag]:(${zshTagChoices})' \\
-            '--priority[Filter by priority]:(0 1 2 3 4)' \\
-            '--status[Filter by status]:(${statusChoices})' \\
-            '--assignee[Filter by assignee]:assignee' \\
-            '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
-            '--sprint[Filter by sprint]:sprint' \\
-            '--release[Filter by release]:release' \\
-${zshCalendarRuntimeFieldFlags}            '--include[Include event sources]:(all deadlines reminders events scheduled)' \\
-            '--recurrence-lookahead-days[Bound open-ended recurrence lookahead]:days' \\
-            '--recurrence-lookback-days[Bound open-ended recurrence lookback]:days' \\
-            '--occurrence-limit[Cap occurrences per recurring event]:number' \\
-            '--limit[Limit returned events]:number' \\
-            '--format[Output override]:(markdown toon json)' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        context|ctx)
-          _arguments \\
-            '--date[Anchor date/time (ISO/date string or relative)]:date' \\
-            '--from[Agenda lower bound (ISO/date string or relative)]:date' \\
-            '--to[Agenda upper bound (ISO/date string or relative)]:date' \\
-            '--past[Include past entries in bounded windows]' \\
-            '--type[Filter by type]:(${typeChoices})' \\
-            '--tag[Filter by tag]:(${zshTagChoices})' \\
-            '--priority[Filter by priority]:(0 1 2 3 4)' \\
-            '--assignee[Filter by assignee]:assignee' \\
-            '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
-            '--sprint[Filter by sprint]:sprint' \\
-            '--release[Filter by release]:release' \\
-            '--parent[Scope snapshot to one item subtree]:id' \\
-            '--limit[Limit focus and agenda rows per section]:number' \\
-            '--depth[Context depth]:(brief standard deep full)' \\
-            '--format[Output override]:(markdown toon json)' \\
-${zshContextRuntimeFieldFlags}            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        next)
-          _arguments \\
-            '--type[Filter candidates by type]:(${typeChoices})' \\
-            '--tag[Filter candidates by tag]:(${zshTagChoices})' \\
-            '--priority[Filter candidates by priority]:(0 1 2 3 4)' \\
-            '--assignee[Filter candidates by assignee]:assignee' \\
-            '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
-            '--sprint[Filter candidates by sprint]:sprint' \\
-            '--release[Filter candidates by release]:release' \\
-            '--parent[Scope to one item subtree]:id' \\
-            '--limit[Limit ready rows]:number' \\
-            '--blocked-limit[Limit blocked rows]:number' \\
-            '--ready-only[Omit the blocked companion list]' \\
-            '--format[Output override]:(markdown toon json)' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        guide)
-          _arguments \\
-            '1:topic:(${guideTopicChoices})' \\
-            '--list[Show guide topic index]' \\
-            '--format[Output override]:(markdown toon json)' \\
-            '--depth[Guide detail depth]:(brief standard deep)' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        search)
-          _arguments \\
-            '--mode[Search mode]:(keyword semantic hybrid)' \\
-            '--match-mode[Token match mode]:(and or exact)' \\
-            '--min-score[Per-query minimum score threshold]:number' \\
-            '--count[Return only the match count]' \\
-            '--include-linked[Include linked content in scoring]' \\
-            '--highlight[Emit per-field matched-text snippets on each hit]' \\
-            '--limit[Max results]:number' \\
-            '--status[Filter by status (open/closed/canceled, csv)]:(${statusChoices})' \\
-            '--type[Filter by type]:(${typeChoices})' \\
-            '--tag[Filter by tag]:(${zshTagChoices})' \\
-            '--tags[Alias for --tag]:(${zshTagChoices})' \\
-            '--priority[Filter by priority]:(0 1 2 3 4)' \\
-            '--updated-after[Filter by updated_at lower bound]:value' \\
-            '--updated-before[Filter by updated_at upper bound]:value' \\
-            '--created-after[Filter by created_at lower bound]:value' \\
-            '--created-before[Filter by created_at upper bound]:value' \\
-            '--assignee[Filter by assignee]:value' \\
-            '--sprint[Filter by sprint]:value' \\
-            '--release[Filter by release]:value' \\
-            '--parent[Filter by parent item ID]:value' \\
-${zshPresenceFilterFlags}
-${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        reindex)
-          _arguments \\
-            '--mode[Reindex mode]:(keyword semantic hybrid)' \\
-            '--progress[Emit progress updates to stderr]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        history)
-          _arguments \\
-            '--limit[Max entries]:number' \\
-            '--compact[Condensed history projection]' \\
-            '--full[Show full history entries]' \\
-            '--provenance[Patch-free identity and agent provenance projection]' \\
-            '--provenance-summary[Include bounded provenance completeness counts]' \\
-            '*--harness[Filter by recorded or vocabulary-resolved harness]:harness' \\
-            '*--agent-instance[Filter by privacy-safe agent instance]:instance' \\
-            '*--provenance-filter[Filter by exact declared provenance value]:dimension=value' \\
-            '--diff[Include per-entry field-level before/after value diffs]' \\
-            '--field[With --diff, show only entries that changed this field]:field' \\
-            '--verify[Verify history hash chain and replay integrity]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        events)
-          _arguments \\
-            '--since[Resume after a cursor or from an ISO timestamp]:cursor_or_timestamp' \\
-            '*--type[Filter by mutation operation]:operation' \\
-            '*--author[Filter by mutation author]:author' \\
-            '*--item[Filter by item or workspace stream]:item' \\
-            '--limit[Maximum events, up to 1000]:number' \\
-            '--full[Include complete authoritative history entries]' \\
-            '--provenance[Include patch-free identity and agent provenance]' \\
-            '--provenance-summary[Include bounded provenance completeness counts]' \\
-            '*--harness[Filter by recorded or vocabulary-resolved harness]:harness' \\
-            '*--agent-instance[Filter by privacy-safe agent instance]:instance' \\
-            '*--provenance-filter[Filter by exact declared provenance value]:dimension=value' \\
-            '--follow[Continue emitting committed events]' \\
-            '--interval-ms[Empty-read delay while following]:milliseconds' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        history-attest)
-          _arguments \\
-${renderZshArgumentSpecs(ATTEST_INVOCATIONS.map(flag=>`'${flag.flag}[${flag.description}]${flag.takes_value?":value":""}'`),{trailingContinuation:false})}
-          ;;
-        history-compact)
-          _arguments \\
-            '--id[Item ID (alternative to positional ID)]:id' \\
-            '--before[Compact entries strictly before this version number or ISO timestamp]:before' \\
-            '--ids[Bulk: compact an explicit comma-separated list of item ids]:ids' \\
-            '--all-over[Bulk: compact every stream with more than N entries]:all-over' \\
-            '--closed[Bulk: compact only closed (terminal) items streams]' \\
-            '--all-streams[Bulk: compact every history stream regardless of lifecycle state]' \\
-            '--min-entries[Bulk: skip streams with at most N entries]:min-entries' \\
-            '--dry-run[Preview compaction impact without writing the history file]' \\
-            '--author[Mutation author]:author' \\
-            '--message[Audit history message]:message' \\
-            '--force[Force ownership/lock override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        history-author-acknowledge)
-          _arguments \\
-            '*--event[Actionable unknown-author event]:item_and_line' \\
-            '--all-actionable[Select every currently actionable event]' \\
-            '--dry-run[Preview a deterministic source-bound plan]' \\
-            '--plan-fingerprint[Apply the exact dry-run plan]:sha256' \\
-            '--limit[Maximum coordinate rows returned in the plan]:number' \\
-            '--attributed-author[Principal attributed by maintainer review]:author' \\
-            '--reviewer[Reviewer recording the disposition]:reviewer' \\
-            '--reason[Evidence-backed review rationale]:reason' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        get)
-          _arguments \\
-            '--depth[Detail depth]:(brief standard deep full)' \\
-            '--full[Explicit full item read]' \\
-            '--fields[Render custom comma-separated item fields]:fields' \\
-            '--tree[Include descendant subtree in result payload]' \\
-            '--tree-depth[Cap subtree depth for --tree (0 = root only)]:number' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        history-redact)
-          _arguments \\
-            '--id[Item ID (alternative to positional ID)]:id' \\
-            '--literal[Literal string matcher to redact from history/item payloads]:literal' \\
-            '--regex[Regex matcher to redact (/pattern/flags or raw pattern)]:regex' \\
-            '--replacement[Replacement text (defaults to [redacted])]:replacement' \\
-            '--dry-run[Preview redaction impact without writing files]' \\
-            '--author[Mutation author]:author' \\
-            '--message[Audit history message]:message' \\
-            '--force[Force ownership/lock override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        history-repair)
-          _arguments \\
-            '--id[Item ID (alternative to positional ID)]:id' \\
-            '--salvage-tail[Recover an invalid suffix after a verified prefix]' \\
-            '--normalize-provenance[Remove invalid provenance with aggregate evidence]' \\
-            '--all[Repair every drifted stream in one audited pass]' \\
-            '--dry-run[Preview the re-anchor impact without writing the history file]' \\
-            '--author[Mutation author]:author' \\
-            '--message[Audit history message]:message' \\
-            '--force[Force ownership/lock override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        schema)
-          if [[ "\${words[CURRENT-1]}" == policy-mode ]]; then
-            compadd advise refuse
-            return
-          fi
-          _arguments \\
-            '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' \\
-            '--alias[Alias for the custom type, status, or field flag (repeatable)]:name' \\
-            '--role[Lifecycle role for a custom status (repeatable)]:role' \\
-            '--order[Display/sort order for a custom status]:n' \\
-            '--type[Value type for a custom field]:type:(string number boolean string_array array object)' \\
-            '--commands[Commands a custom field is wired onto (repeatable)]:commands' \\
-            '--cli-flag[Override the auto-derived CLI flag for a custom field]:flag' \\
-            '--required[Mark a custom field as always required]' \\
-            '--required-on-create[Mark a custom field as required at create time]' \\
-            '--no-allow-unset[Disallow clearing a custom field via --unset]' \\
-            '--required-types[Restrict a custom field requirement to specific item types (repeatable)]:types' \\
-            '--infer[Infer item types from title-prefix conventions (add-type)]' \\
-            '--min-count[Minimum items sharing a prefix for --infer]:n' \\
-            '--apply[Register inferred types (with --infer)]' \\
-            '--author[Mutation author]:author' \\
-            '--force[Force ownership/lock override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        profile)
-          _arguments \\
-            '1:subcommand:(list show apply lint)' \\
-            '2:name:(agile ops research)' \\
-            '--dry-run[Preview the apply diff without writing any files]' \\
-            '--author[Mutation author]:author' \\
-            '--force[Force ownership/lock override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        plan)
-          _arguments \\
-            '1:subcommand:(create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize)' \\
-            '--title[Plan title]:title' \\
-            '--scope[Plan scope statement]:scope' \\
-            '--harness[Plan harness provenance]:harness:(codex claude-code cursor generic)' \\
-            '--mode[Plan mode]:mode:(draft research review approved executing paused completed superseded)' \\
-            '--resume-context[Resume context summary]:text' \\
-            '--step-title[Step title]:title' \\
-            '*--step[Step title (repeatable on create)]:title' \\
-            '--step-status[Step status]:status:(pending in_progress completed blocked skipped superseded)' \\
-            '--step-evidence[Step evidence]:text' \\
-            '--depends-on[Pm item id step depends on]:id' \\
-            '--link[Pm item id to link]:id' \\
-            '--link-kind[Link kind]:kind:(related blocks blocked_by depends_on discovered_from implements verifies supersedes)' \\
-            '--depth[Show depth]:depth:(brief standard deep)' \\
-            '--steps[Step ids/orders for materialize]:steps' \\
-            '--materialize-type[Item type for materialized steps]:type' \\
-            '--allow-multiple-active[Allow multiple in_progress steps]' \\
-            '--promote-to-item-dep[Also add link as top-level item dependency]' \\
-            '--author[Mutation author]:author' \\
-            '--message[Mutation message]:message' \\
-            '--force[Force ownership override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        activity)
-          _arguments \\
-            '--id[Filter by item ID]:id' \\
-            '--op[Filter by history operation]:op' \\
-            '--author[Filter by history author]:author' \\
-            '--from[Lower timestamp bound (ISO/date string or relative)]:date' \\
-            '--to[Upper timestamp bound (ISO/date string or relative)]:date' \\
-            '--limit[Max entries]:number' \\
-            '--unbounded[Return every matching activity entry]' \\
-            '--compact[Condensed activity projection]' \\
-            '--raw[Emit raw compact per-event activity output]' \\
-            '--full[Show full activity entries]' \\
-            '--provenance[Patch-free identity and agent provenance projection]' \\
-            '--provenance-summary[Include bounded provenance completeness counts]' \\
-            '*--harness[Filter by recorded or vocabulary-resolved harness]:harness' \\
-            '*--agent-instance[Filter by privacy-safe agent instance]:instance' \\
-            '*--provenance-filter[Filter by exact declared provenance value]:dimension=value' \\
-            '--stream[Emit line-delimited JSON rows (requires --json)]::mode:(rows ndjson jsonl)' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        contracts)
-          _arguments \\
-            '--action[Filter schema by tool action]:action' \\
-            '--command[Scope output to one command (narrow-by-default)]:command' \\
-            '--summary[Return compact command intent summary]' \\
-            '--schema-only[Return schema-only payload]' \\
-            '--flags-only[Return command flag contracts only]' \\
-            '--availability-only[Return action availability only]' \\
-            '--runtime-only[Include only actions invocable in the current runtime]' \\
-            '--active-only[Alias for --runtime-only]' \\
-            '--full[Include complete command and schema contract details]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        gc)
-          _arguments \\
-            '--dry-run[Preview cleanup targets without deleting files]' \\
-            '--scope[Limit cleanup to one or more scopes: index, embeddings, runtime, locks, checkpoints, transactions]:scope' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        stats)
-          _arguments \\
-            '--include-empty[Include registered zero-count type and status buckets]' \\
-            '--storage[Include aggregate history-stream storage metrics]' \\
-            '--metadata-coverage[Include metadata coverage percentages overall and by type]' \\
-            '--field-utilization[Include content-field utilization rates across all items]' \\
-            '--by-assignee[Lifecycle-bucketed breakdown grouped by assignee]' \\
-            '--by-tag[Lifecycle-bucketed breakdown grouped by tag]' \\
-            '--by-priority[Lifecycle-bucketed breakdown grouped by priority]' \\
-            '--tag-prefix[With --by-tag: only count tags with this prefix]:prefix' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        comments)
-          _arguments \\
-            '--add[Add one entry (plain text, text=<value>, markdown pairs, or - for stdin)]:text' \\
-            '--text[Alias for --add]:text' \\
-            '--stdin[Read comment text from stdin (supports multiline markdown)]' \\
-            '--file[Read comment text from file (supports multiline markdown)]:path' \\
-            '--edit[Replace the comment at 1-based index (text from positional/--add/--stdin/--file)]:index' \\
-            '--delete[Delete the comment at 1-based index]:index' \\
-            '--limit[Return only latest n entries]:number' \\
-            '--full-history[Return complete post-mutation history]' \\
-            '--if-absent[Append only when the resolved author and text are absent]' \\
-            '--author[Entry author (falls back to PM_AUTHOR/settings)]:author' \\
-            '--message[History message]:message' \\
-            '--force[Force override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        notes)
-          _arguments \\
-            '--add[Add one entry (plain text, text=<value>, markdown pairs, or - for stdin)]:text' \\
-            '--text[Alias for --add]:text' \\
-            '--add-json[Append one validated JSON context event]:json' \\
-            '--stdin[Read entry text from stdin]' \\
-            '--file[Read entry text from file]:path' \\
-            '--edit[Replace the entry at a 1-based index]:index' \\
-            '--delete[Delete the entry at a 1-based index]:index' \\
-            '--limit[Return only latest n entries]:number' \\
-            '--since[Return structured events at or after an ISO timestamp]:timestamp' \\
-            '--event-type[Return structured events with this top-level type]:event_type' \\
-            '--include-meta[Include result counts and truncation metadata]' \\
-            '--full-history[Return complete post-mutation history]' \\
-            '--if-absent[Append only when the resolved author and text are absent]' \\
-            '--author[Entry author (falls back to PM_AUTHOR/settings)]:author' \\
-            '--message[History message]:message' \\
-            '--force[Force override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        learnings)
-          _arguments \\
-            '--add[Add one entry (plain text, text=<value>, markdown pairs, or - for stdin)]:text' \\
-            '--text[Alias for --add]:text' \\
-            '--stdin[Read entry text from stdin]' \\
-            '--file[Read entry text from file]:path' \\
-            '--edit[Replace the entry at a 1-based index]:index' \\
-            '--delete[Delete the entry at a 1-based index]:index' \\
-            '--limit[Return only latest n entries]:number' \\
-            '--full-history[Return complete post-mutation history]' \\
-            '--if-absent[Append only when the resolved author and text are absent]' \\
-            '--author[Entry author (falls back to PM_AUTHOR/settings)]:author' \\
-            '--message[History message]:message' \\
-            '--force[Force override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        files)
-          _arguments \\
-            '1:subcommand:(discover lookup)' \\
-            '--add[Add a linked file]:file' \\
-            '--add-glob[Add linked files matching a glob]:glob' \\
-            '--remove[Remove a linked file]:file' \\
-            '--migrate[Migrate linked-file metadata]' \\
-            '--list[List linked files]' \\
-            '--apply[Apply discovered linked files]' \\
-            '--note[Linked-file note]:note' \\
-            '--append-stable[Preserve stable append ordering]' \\
-            '--validate-paths[Validate linked-file paths]' \\
-            '--scope[Filter lookup by evidence scope]:(project global)' \\
-            '--limit[Maximum lookup matches]:number' \\
-            '--offset[Skip the first lookup matches]:number' \\
-            '--no-truncate[Return every lookup match]' \\
-            '--strict-read[Require authoritative source reads]' \\
-            '--explain[Include ranked source-to-work rationale]' \\
-            '--lines[Attribute an inclusive source line range]:start_end' \\
-            '--decision-depth[Maximum governing-decision relationship depth]:number' \\
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--force[Force override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        deps)
-          _arguments \\
-            '--format[Output format]:(tree graph context)' \\
-            '--max-depth[Maximum traversal depth (0 keeps root only)]:depth' \\
-            '--collapse[Collapse mode]:(none repeated)' \\
-            '--summary[Return counts only without tree/graph payload]' \\
-            '--node-limit[Maximum nodes in context output]:number' \\
-            '--edge-limit[Maximum edges in context output]:number' \\
-            '--token-budget[Maximum estimated tokens in context output]:number' \\
-            '--cursor[Continue an equivalent context query]:cursor' \\
-            '--direction[Context traversal direction]:(outgoing incoming both)' \\
-            '--kind[Restrict context traversal to relationship kinds]:kind' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        graph)
-          _arguments \\
-            '1:subcommand:(ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators slack centrality articulation plan index)' \\
-            '--kind[Restrict traversal to registered relationship kinds]:kind' \\
-            '--max-depth[Maximum traversal depth]:depth' \\
-            '--limit[Maximum returned rows per bounded collection]:number' \\
-            '--after[Resume a traversal after this node id]:id' \\
-            '--direction[Edge orientation for paths/impact]:(outgoing incoming both)' \\
-            '--max-paths[Maximum enumerated paths]:number' \\
-            '--sample[Maximum evidence sample entries per audit finding]:number' \\
-            '--exempt-isolate[Item ids treated as explicitly valid isolates]:id' \\
-            '--exempt-isolate-type[Item types whose active isolates are policy-valid]:type' \\
-            '--save-baseline[Persist the audit census as the comparison baseline]' \\
-            '--rebuild[Rebuild and warm the durable graph index]' \\
-            '--clear[Delete the durable graph index]' \\
-            '--summary[Return counts-first envelopes without row collections]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        test)
-          _arguments \\
-            '--add[Add linked test entry]:entry' \\
-            '--add-json[Add linked test entry from JSON object/array]:json' \\
-            '--remove[Remove linked test entry by command/path]:entry' \\
-            '--remove-index[Remove linked test entry by 1-based index]:index' \\
-            '--list[List linked tests without mutating]' \\
-            '--run[Run linked tests]' \\
-            '--match[Run linked tests whose command/path contains substring]:substring' \\
-            '--only-index[Run one linked test by 1-based index]:number' \\
-            '--only-last[Run the most recently added linked test]' \\
-            '--background[Run linked tests in managed background mode]' \\
-            '--timeout[Default timeout seconds]:seconds' \\
-            '--progress[Emit linked-test progress to stderr]' \\
-            '--env-set[Set linked-test runtime environment values]:entry' \\
-            '--env-clear[Clear linked-test runtime environment values]:name' \\
-            '--shared-host-safe[Apply shared-host-safe runtime defaults]' \\
-            '--pm-context[PM linked-test context mode]:(schema tracker auto)' \\
-            '--override-linked-pm-context[Force run-level --pm-context over per-linked-test pm_context_mode metadata]' \\
-            '--fail-on-context-mismatch[Fail when context item counts mismatch]' \\
-            '--fail-on-skipped[Treat skipped linked tests as dependency failures]' \\
-            '--fail-on-empty-test-run[Treat empty linked-test selections as failures]' \\
-            '--require-assertions-for-pm[Require assertions for linked PM command tests]' \\
-            '--check-context[Preflight linked PM command context diagnostics before execution]' \\
-            '--auto-pm-context[Auto-remediate tracker-read context mismatches using tracker context]' \\
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--force[Force override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        test-all)
-          _arguments \\
-            '--status[Filter by status]:(open in_progress)' \\
-            '--limit[Limit matching items before running linked tests]:number' \\
-            '--offset[Skip matching items before running linked tests]:number' \\
-            '--background[Run linked tests in managed background mode]' \\
-            '--timeout[Default timeout seconds]:seconds' \\
-            '--progress[Emit linked-test progress to stderr]' \\
-            '--env-set[Set linked-test runtime environment values]:entry' \\
-            '--env-clear[Clear linked-test runtime environment values]:name' \\
-            '--shared-host-safe[Apply shared-host-safe runtime defaults]' \\
-            '--pm-context[PM linked-test context mode]:(schema tracker auto)' \\
-            '--override-linked-pm-context[Force run-level --pm-context over per-linked-test pm_context_mode metadata]' \\
-            '--fail-on-context-mismatch[Fail when context item counts mismatch]' \\
-            '--fail-on-skipped[Treat skipped linked tests as dependency failures]' \\
-            '--fail-on-empty-test-run[Treat empty linked-test selections as failures]' \\
-            '--require-assertions-for-pm[Require assertions for linked PM command tests]' \\
-            '--check-context[Preflight linked PM command context diagnostics before execution]' \\
-            '--auto-pm-context[Auto-remediate tracker-read context mismatches using tracker context]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        test-runs)
-          _arguments \\
-            '1:subcommand:(list status logs stop resume)' \\
-            '--status[Filter by background run status]:status:(queued running passed failed stopped canceled)' \\
-            '--limit[Limit returned runs]:number' \\
-            '--stream[Background log stream]:stream:(stdout stderr both)' \\
-            '--tail[Tail number of lines]:number' \\
-            '--force[Force stop with SIGKILL]' \\
-            '--author[Resume author]:author' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        init)
-          _arguments \\
-            '(1)--id-prefix[Set the item ID prefix]:prefix' \\
-            '(1)--prefix[Alias for --id-prefix]:prefix' \\
-            '1:optional id prefix or tracker path' \\
-            '--preset[Governance preset for new setups]:preset:(minimal default strict)' \\
-            '--defaults[Use non-interactive setup defaults]' \\
-            '-y[Alias for --defaults]' \\
-            '--yes[Alias for --defaults]' \\
-            '--author[Set the default mutation author for this project]:author' \\
-            '--agent-guidance[Agent guidance mode]:mode:(ask add skip status)' \\
-            '--type-preset[Register domain item types]:type-preset:(agile ops research)' \\
-            '--with-packages[Install bundled first-party packages during initialization]' \\
-            '--verbose[Include the full resolved settings tree in init output]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        config)
-          _arguments \\
-            '--criterion[Criteria value for definition-of-done metadata-required-fields or lifecycle pattern keys (repeatable for set)]:criterion' \\
-            '--clear-criteria[Clear config criteria-list key values]' \\
-            '--format[Item format for item-format key]:format:(toon)' \\
-            '--policy[Policy value for supported policy keys]:policy' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        close)
-          _arguments \\
-            '--release-assignment[Close and release assignment]' \\
-            '--reason[Closure reason]:reason' \\
-            '--close-reason[Alias for --reason]:close_reason' \\
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--validate-close[Validate closure metadata mode]:(off warn strict)' \\
-            '--resolution[Closure resolution summary]:resolution' \\
-            '--expected-result[Expected behavior note]:expected_result' \\
-            '--actual-result[Observed behavior note]:actual_result' \\
-            '--expected[Short alias for --expected-result]:expected_result' \\
-            '--actual[Short alias for --actual-result]:actual_result' \\
-            '--force[Force override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        claim)
-          _arguments \\
-            '--start[Claim and start work]' \\
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--force[Force override]' \\
-            '--if-available[Skip work held by another author]' \\
-            '--next[Atomically claim the next actionable item]' \\
-            '--type[Filter --next candidates by type]:(${typeChoices})' \\
-            '--tag[Filter --next candidates by tag]:(${zshTagChoices})' \\
-            '--priority[Filter --next candidates by priority]:(0 1 2 3 4)' \\
-            '--assignee-filter[Filter --next candidates by ownership]:assignee_filter:(assigned unassigned)' \\
-            '--parent[Scope --next candidates to a subtree]:parent' \\
-            '--sprint[Filter --next candidates by sprint]:sprint' \\
-            '--release[Filter --next candidates by release]:release' \\
-            '--max-attempts[Bound the --next candidate walk]:max_attempts' \\
-            '--include-decisions[Allow human-gated Decision candidates]' \\
-            '--token-budget[Bound ranked candidate tokens]:token_budget' \\
-            '--explain-ranking[Include ranking provenance]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        release)
-          _arguments \\
-            '--pause[Return to open and release ownership]' \\
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--force[Force override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        delete)
-          _arguments \\
-            '--dry-run[Preview the item file that would be deleted without mutating]' \\
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--force[Force override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        restore)
-          _arguments \\
-${renderZshArgumentSpecs(RESTORE_INVOCATIONS.map(flag=>`'${flag.flag}[${flag.description}]${flag.takes_value?":value":""}'`),{trailingContinuation:false})}
-          ;;
-        start-task|pause-task)
-          _arguments \\
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--force[Force override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        close-task)
-          _arguments \\
-            '--author[Mutation author]:author' \\
-            '--message[History message]:message' \\
-            '--validate-close[Validate closure metadata mode]:(off warn strict)' \\
-            '--force[Force override]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        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]' \\
-            '--check-lifecycle[Run active-item lifecycle governance drift checks]' \\
-            '--check-stale-blockers[Include stale blocker-pattern diagnostics in lifecycle checks]' \\
-            '--dependency-cycle-severity[Set dependency-cycle warning policy for lifecycle checks]:(off warn error)' \\
-            '--parent-cycle-severity[Set parent-hierarchy cycle warning policy for lifecycle checks]:(off warn error)' \\
-            '--check-files[Run linked-file and orphaned-file checks]' \\
-            '--scan-mode[Select file candidate scan mode for --check-files]:(default tracked-all tracked-all-strict)' \\
-            '--include-pm-internals[Include PM storage internals in tracked-all candidate scans]' \\
-            '--verbose-file-lists[Include full file-path lists for validate --check-files details]' \\
-            '--verbose-diagnostics[Include full validate diagnostic ID lists instead of compact summaries]' \\
-            '--all-affected-ids[Emit complete missing_* affected-ID lists with no truncation (implied by --json)]' \\
-            '--strict-exit[Return non-zero exit when validation warnings are present]' \\
-            '--fail-on-warn[Alias for --strict-exit]' \\
-            '--fix-hints[Add a machine-executable fix_hints[] of pm commands to each failing check]' \\
-            '--auto-fix[Apply the safe, deterministic subset of fix-hint remediations automatically]' \\
-            '--dry-run[Preview planned --auto-fix/--prune-missing fixes without applying them]' \\
-            '--fix-scope[Grant --auto-fix scopes (estimates/lifecycle must be named explicitly)]:(metadata resolution estimates lifecycle)' \\
-            '--prune-missing[Remove stale linked-file/doc links classified as deleted]' \\
-            '--check-history-drift[Run item/history hash drift checks]' \\
-            '--check-command-references[Run linked-command PM-ID reference checks]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        health)
-          _arguments \\
-            '--strict-directories[Treat optional item-type directories as required failures]' \\
-            '--check-only[Run read-only health diagnostics without refreshing vectors]' \\
-            '--no-refresh[Disable automatic vector refresh attempts during health checks]' \\
-            '--refresh-vectors[Explicitly enable vector refresh attempts during health checks]' \\
-            '--verbose-stale-items[Include full stale vectorization ID lists in health output]' \\
-            '--verbose-author-events[Include complete actionable unknown-author coordinates]' \\
-            '--brief[Emit compact health details for low-token agent checks]' \\
-            '--summary[Emit one-line-style health status with check names and warning count]' \\
-            '--strict-exit[Return non-zero exit when health warnings are present]' \\
-            '--fail-on-warn[Alias for --strict-exit]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]'
-          ;;
-        extension)
-          _arguments \\
-            '1:extension_action:(${EXTENSION_LIFECYCLE_ACTIONS})' \\
-            '--init[Generate a starter extension scaffold at target path]' \\
-            '--scaffold[Alias for --init]' \\
-            '--capability[Capability the init scaffold targets]:capability:(${SCAFFOLD_CAPABILITIES.join(" ")})' \\
-            '--install[Install extension from local path or GitHub source]' \\
-            '--uninstall[Uninstall extension by name]' \\
-            '--explore[List discovered extensions for selected scope]' \\
-            '--manage[List managed extensions with update metadata]' \\
-            '--describe[Map every surface a loaded extension registers]' \\
-            '--markdown[Render describe output as a Markdown reference document]' \\
-            '--output[Write describe Markdown to a file]:path:_files' \\
-            '--reload[Reload extensions with cache-busted module imports]' \\
-            '--watch[Enable watch mode with --reload]' \\
-            '--doctor[Run consolidated extension diagnostics (summary/deep)]' \\
-            '--catalog[List bundled first-party package catalog entries]' \\
-            '--adopt[Adopt an unmanaged extension into managed metadata]' \\
-            '--adopt-all[Adopt all unmanaged extensions into managed metadata]' \\
-            '--activate[Activate extension in selected scope settings]' \\
-            '--deactivate[Deactivate extension in selected scope settings]' \\
-            '--project[Use project extension scope (default)]' \\
-            '--local[Alias for --project]' \\
-            '--global[Use global extension scope]' \\
-            '--gh[Install from GitHub shorthand owner/repo/path]:github_spec' \\
-            '--github[Alias for --gh]:github_spec' \\
-            '--ref[Git ref/branch/tag for GitHub source]:git_ref' \\
-            '--detail[Detail mode for extension diagnostics]:detail_mode:(summary deep)' \\
-            '--trace[Include registration traces in doctor deep diagnostics]' \\
-            '--runtime-probe[Opt-in runtime activation probe for manage output]' \\
-            '--fix-managed-state[Adopt unmanaged extensions before diagnostics/update checks]' \\
-            '--isolated[Run doctor against project-scope extensions only]' \\
-            '--ignore-global[Alias for --isolated]' \\
-            '--strict-exit[Return non-zero exit when doctor warnings are present]' \\
-            '--fail-on-warn[Alias for --strict-exit (doctor)]' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]' \\
-            '*:target_or_name:_files -/'
-          ;;
-        package|packages)
-          _arguments \\
-            '1:package_action:(${PACKAGE_LIFECYCLE_ACTIONS})' \\
-            '--init[Generate a starter package scaffold at target path]' \\
-            '--scaffold[Alias for --init]' \\
-            '--capability[Capability the init scaffold targets]:capability:(${SCAFFOLD_CAPABILITIES.join(" ")})' \\
-            '--declarative[Generate a composeExtension blueprint starter]' \\
-            '--install[Install package from local path, GitHub source, npm source, or bundled alias]' \\
-            '--uninstall[Uninstall package by name]' \\
-            '--explore[List discovered packages for selected scope]' \\
-            '--manage[List managed packages with update metadata]' \\
-            '--describe[Map every surface a loaded package registers]' \\
-            '--markdown[Render describe output as a Markdown reference document]' \\
-            '--output[Write describe Markdown to a file]:path:_files' \\
-            '--reload[Reload packages with cache-busted module imports]' \\
-            '--watch[Enable watch mode with --reload]' \\
-            '--doctor[Run consolidated package diagnostics (summary/deep)]' \\
-            '--catalog[List bundled first-party package catalog entries]' \\
-            '--adopt[Adopt an unmanaged package into managed metadata]' \\
-            '--adopt-all[Adopt all unmanaged packages into managed metadata]' \\
-            '--activate[Activate package in selected scope settings]' \\
-            '--deactivate[Deactivate package in selected scope settings]' \\
-            '--project[Use project package scope (default)]' \\
-            '--local[Alias for --project]' \\
-            '--global[Use global package scope]' \\
-            '--gh[Install from GitHub shorthand owner/repo/path]:github_spec' \\
-            '--github[Alias for --gh]:github_spec' \\
-            '--ref[Git ref/branch/tag for GitHub source]:git_ref' \\
-            '--detail[Detail mode for package diagnostics]:detail_mode:(summary deep)' \\
-            '--trace[Include registration traces in doctor deep diagnostics]' \\
-            '--runtime-probe[Opt-in runtime activation probe for manage output]' \\
-            '--fix-managed-state[Adopt unmanaged packages before diagnostics/update checks]' \\
-            '--isolated[Run doctor against project-scope packages only]' \\
-            '--ignore-global[Alias for --isolated]' \\
-            '--strict-exit[Return non-zero exit when doctor warnings are present]' \\
-            '--fail-on-warn[Alias for --strict-exit (doctor)]' \\
-            '--dry-run[Plan upgrades without mutating]' \\
-            '--cli-only[Upgrade only the pm CLI/SDK npm package]' \\
-            '--packages-only[Upgrade only managed pm packages]' \\
-            '--repair[Force npm global reinstall for the CLI/SDK]' \\
-            '--tag[npm version or dist-tag for upgrades]:tag' \\
-            '--package-name[Override the CLI package name]:package_name' \\
-            '--json[Output JSON]' \\
-            '--quiet[Suppress stdout]' \\
-            '*:target_or_name:_files -/'
-          ;;
-        completion)
-          _arguments \\
-            '--eager-tags[Embed current tracker tags directly in script output]' \\
-            '1:shell:(bash zsh fish)'
-          ;;
-        templates)
-          local -a templates_cmds
-          templates_cmds=('save:Save or update a create template' 'list:List saved create templates' 'show:Show saved template details')
-          _describe 'templates command' templates_cmds
-          ;;
-      esac
-      ;;
-  esac
-}
-
-compdef _pm pm`}function generateFishScript(itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const namespaceLeaves=completionNamespaceLeaves(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"
-    set now 0
-  end
-  set -l ttl 120
-  if set -q PM_COMPLETION_TAG_TTL
-    set ttl $PM_COMPLETION_TAG_TTL
-  end
-  if set -q PM_COMPLETION_TAG_CACHE; and set -q PM_COMPLETION_TAG_CACHE_TS
-    set -l age (math "$now - $PM_COMPLETION_TAG_CACHE_TS")
-    if test $age -lt $ttl
-      printf '%s
-' $PM_COMPLETION_TAG_CACHE
-      return
-    end
-  end
-  set -l resolved (pm completion-tags ^/dev/null)
-  set -gx PM_COMPLETION_TAG_CACHE $resolved
-  set -gx PM_COMPLETION_TAG_CACHE_TS $now
-  printf '%s
-' $resolved
-end
-`;return`# Fish shell completion for pm
-# Save to ~/.config/fish/completions/pm.fish
-# or run: pm completion fish > ~/.config/fish/completions/pm.fish
-
-# Disable file completion by default
-complete -c pm -f
-
-# Global flags (available for all subcommands)
-complete -c pm -l json -d 'Output JSON instead of TOON'
-complete -c pm -l all -d 'Reveal every public command and compatibility alias'
-complete -c pm -l quiet -d 'Suppress stdout output'
-complete -c pm -l output-include -d 'Retain comma-separated read fields or sections' -r
-complete -c pm -l output-limit -d 'Set the universal read row ceiling' -r
-complete -c pm -l output-budget -d 'Set the universal estimated-token ceiling' -r
-complete -c pm -l output-format -d 'Select the universal read encoding' -r -a 'toon json'
-complete -c pm -l output-session -d 'Carry cross-call read budget and served-item state' -r
-complete -c pm -l output-row-contract -d 'Include row schema metadata in read output'
-complete -c pm -l no-changed-fields -d 'Omit changed_fields array from mutation output'
-complete -c pm -l id-only -d 'Print only id and status for single-item mutation output'
-complete -c pm -l pm-path -d 'Explicit tracker storage path for this command' -r
-complete -c pm -l path -d 'Override PM path for this command' -r
-complete -c pm -l no-extensions -d 'Disable extension loading'
-complete -c pm -l profile -d 'Print deterministic timing diagnostics'
-complete -c pm -s V -l version -d 'Output the version number'
-complete -c pm -s h -l help -d 'Display help'
-
-# Helper: true when no subcommand has been given yet
-function __pm_no_subcommand
-  not __fish_seen_subcommand_from ${noSubcommandList}
-end
-${dynamicTagResolver}
-${useDynamicTypeExpansion?renderFishDynamicChoiceResolver("type","completion-types",typeFallbackChoices):""}
-${renderFishDynamicChoiceResolver("status","completion-statuses",statusFallbackChoices)}
-
-# Subcommands
-${renderFishCommandDescriptions()}
-
-# list* flags
-for list_cmd in ${listCmds}
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l status   -d 'Filter by status' -r -a '${statusChoices}'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l all      -d 'Include every lifecycle status'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l type     -d 'Filter by item type' -r -a '${typeChoices}'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l tag      -d 'Filter by tag' -r -a ${fishTagChoices}
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l tags     -d 'Alias for --tag' -r -a ${fishTagChoices}
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l priority -d 'Filter by priority' -r -a '0 1 2 3 4'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l assignee -d 'Filter by assignee' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l sprint   -d 'Filter by sprint' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l release  -d 'Filter by release' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l limit    -d 'Limit returned item count' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l offset   -d 'Skip the first n matching rows before limit' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-truncate -d 'Return every matched row, overriding --limit'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l include-body -d 'Include item body in each returned list row'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l compact -d 'Render compact list projection fields'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l fields -d 'Render custom comma-separated list fields' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l tree -d 'Render hierarchical subtree output rooted at --parent or top-level parents'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l tree-depth -d 'Cap recursion depth for --tree (0 = root only)' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l sort -d 'Sort field' -r -a 'priority deadline updated_at created_at title parent'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l order -d 'Sort order (requires --sort)' -r -a 'asc desc'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l stream -d 'Emit line-delimited JSON rows (requires --json)'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l deadline-before -d 'Filter by deadline upper bound (ISO/date string or relative)' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l deadline-after  -d 'Filter by deadline lower bound (ISO/date string or relative)' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l today -d 'Filter to items updated since local midnight today'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l recent -d 'Filter to items updated in the last 7 days'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l updated-after  -d 'Filter by updated_at lower bound (ISO/relative)' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l updated-before -d 'Filter by updated_at upper bound (ISO/relative)' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l created-after  -d 'Filter by created_at lower bound (ISO/relative)' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l created-before -d 'Filter by created_at upper bound (ISO/relative)' -r
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-reviewer-missing   -d 'Select only items missing reviewer'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-risk-missing       -d 'Select only items missing risk'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-confidence-missing -d 'Select only items missing confidence'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-sprint-missing     -d 'Select only items missing sprint'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-release-missing    -d 'Select only items missing release'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-notes            -d 'Select only items that have notes'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-notes             -d 'Select only items with no notes'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-learnings        -d 'Select only items that have learnings'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-learnings         -d 'Select only items with no learnings'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-files            -d 'Select only items that have linked files'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-files             -d 'Select only items with no linked files'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-files-missing -d 'Alias for --no-files'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-docs             -d 'Select only items that have linked docs'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-docs              -d 'Select only items with no linked docs'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-docs-missing  -d 'Alias for --no-docs'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-tests            -d 'Select only items that have linked tests'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-tests             -d 'Select only items with no linked tests'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-comments         -d 'Select only items that have comments'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-comments          -d 'Select only items with no comments'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-deps             -d 'Select only items that have dependencies'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-deps              -d 'Select only items with no dependencies'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-body             -d 'Select only items with non-empty body'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l empty-body           -d 'Select only items with empty body'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-linked-command   -d 'Select only items that have a linked command'
-  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-linked-command    -d 'Select only items with no linked command'
-end
-${fishListRuntimeFieldFlags}
-
-# aggregate flags
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l group-by -d 'Comma-separated group-by fields (supported: parent,type,priority,status,assignee,tags,sprint,release)' -r
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l count -d 'Return grouped counts'
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l completion -d 'Add completion counts and percentage per group'
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l sum -d 'Numeric field to sum per group' -r
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l avg -d 'Numeric field to average per group' -r
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l include-unparented -d 'Include unparented rows when grouping by parent'
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l status -d 'Filter by status' -r -a '${statusChoices}'
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l type -d 'Filter by item type' -r -a '${typeChoices}'
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l tag -d 'Filter by tag' -r -a ${fishTagChoices}
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l priority -d 'Filter by priority' -r -a '0 1 2 3 4'
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l deadline-before -d 'Filter by deadline upper bound (ISO/date string or relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l deadline-after -d 'Filter by deadline lower bound (ISO/date string or relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l assignee -d 'Filter by assignee' -r
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l parent -d 'Filter by parent item ID' -r
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l sprint -d 'Filter by sprint' -r
-complete -c pm -n '__fish_seen_subcommand_from aggregate' -l release -d 'Filter by release' -r
-
-
-# create flags
-complete -c pm -n '__fish_seen_subcommand_from create' -s t -l title              -d 'Item title' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -s d -l description        -d 'Item description' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l type                    -d 'Item type' -r -a '${typeChoices}'
-complete -c pm -n '__fish_seen_subcommand_from create' -l create-mode             -d 'Create required-option policy mode' -r -a 'strict progressive'
-complete -c pm -n '__fish_seen_subcommand_from create' -l schedule-preset         -d 'Scheduling preset for Reminder/Meeting/Event' -r -a 'lightweight'
-complete -c pm -n '__fish_seen_subcommand_from create' -s s -l status             -d 'Item status' -r -a '${statusChoices}'
-complete -c pm -n '__fish_seen_subcommand_from create' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
-complete -c pm -n '__fish_seen_subcommand_from create' -l tags                    -d 'Comma-separated tags' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l add-tags                -d 'Add tags additively without replacing existing' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -s b -l body               -d 'Item body' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l body-file               -d 'Load the item body from a file' -r -F
-complete -c pm -n '__fish_seen_subcommand_from create' -l deadline                -d 'Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l estimate                -d 'Estimated minutes' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l acceptance-criteria     -d 'Acceptance criteria' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l reminder                -d 'Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l event                   -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l type-option             -d 'Type option key=value or key=<name>,value=<value>' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l author                  -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l message                 -d 'History message' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l assignee                -d 'Assignee' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l unset                   -d 'Clear scalar metadata field by name' -r
-complete -c pm -n '__fish_seen_subcommand_from create' -l clear-deps              -d 'Clear dependency entries'
-complete -c pm -n '__fish_seen_subcommand_from create' -l clear-comments          -d 'Clear comments'
-complete -c pm -n '__fish_seen_subcommand_from create' -l clear-notes             -d 'Clear notes'
-complete -c pm -n '__fish_seen_subcommand_from create' -l clear-learnings         -d 'Clear learnings'
-complete -c pm -n '__fish_seen_subcommand_from create' -l clear-files             -d 'Clear linked files'
-complete -c pm -n '__fish_seen_subcommand_from create' -l clear-tests             -d 'Clear linked tests'
-complete -c pm -n '__fish_seen_subcommand_from create' -l clear-docs              -d 'Clear linked docs'
-complete -c pm -n '__fish_seen_subcommand_from create' -l clear-reminders         -d 'Clear reminders'
-complete -c pm -n '__fish_seen_subcommand_from create' -l clear-events            -d 'Clear events'
-complete -c pm -n '__fish_seen_subcommand_from create' -l clear-type-options      -d 'Clear type options'
-${fishCreateRuntimeFieldFlags}
-
-# copy flags
-complete -c pm -n '__fish_seen_subcommand_from copy' -l title   -d 'Override copied title' -r
-complete -c pm -n '__fish_seen_subcommand_from copy' -l author  -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from copy' -l message -d 'History message' -r
-complete -c pm -n '__fish_seen_subcommand_from copy' -l force   -d 'Force ownership override'
-
-# focus flags
-complete -c pm -n '__pm_history_operation focus' -l clear -d 'Clear the focused item'
-
-# update flags
-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 '__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
-complete -c pm -n '__fish_seen_subcommand_from files' -a 'discover lookup' -d 'Linked-file subcommand'
-complete -c pm -n '__fish_seen_subcommand_from files' -l add -d 'Add a linked file' -r
-complete -c pm -n '__fish_seen_subcommand_from files' -l add-glob -d 'Add linked files matching a glob' -r
-complete -c pm -n '__fish_seen_subcommand_from files' -l remove -d 'Remove a linked file' -r
-complete -c pm -n '__fish_seen_subcommand_from files' -l migrate -d 'Migrate linked-file metadata'
-complete -c pm -n '__fish_seen_subcommand_from files' -l list -d 'List linked files'
-complete -c pm -n '__fish_seen_subcommand_from files' -l apply -d 'Apply discovered linked files'
-complete -c pm -n '__fish_seen_subcommand_from files' -l note -d 'Linked-file note' -r
-complete -c pm -n '__fish_seen_subcommand_from files' -l append-stable -d 'Preserve stable append ordering'
-complete -c pm -n '__fish_seen_subcommand_from files' -l validate-paths -d 'Validate linked-file paths'
-complete -c pm -n '__fish_seen_subcommand_from files' -l scope -d 'Filter lookup by evidence scope' -r -a 'project global'
-complete -c pm -n '__fish_seen_subcommand_from files' -l limit -d 'Maximum lookup matches' -r
-complete -c pm -n '__fish_seen_subcommand_from files' -l offset -d 'Skip the first lookup matches' -r
-complete -c pm -n '__fish_seen_subcommand_from files' -l no-truncate -d 'Return every lookup match'
-complete -c pm -n '__fish_seen_subcommand_from files' -l strict-read -d 'Require authoritative source reads'
-complete -c pm -n '__fish_seen_subcommand_from files' -l explain -d 'Include ranked source-to-work rationale'
-complete -c pm -n '__fish_seen_subcommand_from files' -l lines -d 'Attribute an inclusive source line range' -r
-complete -c pm -n '__fish_seen_subcommand_from files' -l decision-depth -d 'Maximum governing-decision relationship depth' -r
-
-
-# search flags
-complete -c pm -n '__fish_seen_subcommand_from search' -l mode          -d 'Search mode' -r -a 'keyword semantic hybrid'
-complete -c pm -n '__fish_seen_subcommand_from search' -l match-mode    -d 'Token match mode' -r -a 'and or exact'
-complete -c pm -n '__fish_seen_subcommand_from search' -l min-score     -d 'Per-query minimum score threshold' -r
-complete -c pm -n '__fish_seen_subcommand_from search' -l count          -d 'Return only the match count'
-complete -c pm -n '__fish_seen_subcommand_from search' -l include-linked -d 'Include linked content in scoring'
-complete -c pm -n '__fish_seen_subcommand_from search' -l highlight      -d 'Emit per-field matched-text snippets on each hit'
-complete -c pm -n '__fish_seen_subcommand_from search' -l limit          -d 'Max results' -r
-complete -c pm -n '__fish_seen_subcommand_from search' -l status         -d 'Filter by status (open/closed/canceled, csv)' -r -a '${statusChoices}'
-complete -c pm -n '__fish_seen_subcommand_from search' -l type           -d 'Filter by type' -r -a '${typeChoices}'
-complete -c pm -n '__fish_seen_subcommand_from search' -l tag            -d 'Filter by tag' -r -a ${fishTagChoices}
-complete -c pm -n '__fish_seen_subcommand_from search' -l tags           -d 'Alias for --tag' -r -a ${fishTagChoices}
-complete -c pm -n '__fish_seen_subcommand_from search' -l priority       -d 'Filter by priority' -r -a '0 1 2 3 4'
-complete -c pm -n '__fish_seen_subcommand_from search' -l updated-after  -d 'Filter by updated_at lower bound' -r
-complete -c pm -n '__fish_seen_subcommand_from search' -l updated-before -d 'Filter by updated_at upper bound' -r
-complete -c pm -n '__fish_seen_subcommand_from search' -l created-after  -d 'Filter by created_at lower bound' -r
-complete -c pm -n '__fish_seen_subcommand_from search' -l created-before -d 'Filter by created_at upper bound' -r
-complete -c pm -n '__fish_seen_subcommand_from search' -l assignee       -d 'Filter by assignee' -r
-complete -c pm -n '__fish_seen_subcommand_from search' -l sprint         -d 'Filter by sprint' -r
-complete -c pm -n '__fish_seen_subcommand_from search' -l release        -d 'Filter by release' -r
-complete -c pm -n '__fish_seen_subcommand_from search' -l parent         -d 'Filter by parent item ID' -r
-complete -c pm -n '__fish_seen_subcommand_from search' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
-complete -c pm -n '__fish_seen_subcommand_from search' -l filter-risk-missing       -d 'Select only items missing risk'
-complete -c pm -n '__fish_seen_subcommand_from search' -l filter-confidence-missing -d 'Select only items missing confidence'
-complete -c pm -n '__fish_seen_subcommand_from search' -l filter-sprint-missing     -d 'Select only items missing sprint'
-complete -c pm -n '__fish_seen_subcommand_from search' -l filter-release-missing    -d 'Select only items missing release'
-complete -c pm -n '__fish_seen_subcommand_from search' -l has-notes          -d 'Select only items that have notes'
-complete -c pm -n '__fish_seen_subcommand_from search' -l no-notes           -d 'Select only items with no notes'
-complete -c pm -n '__fish_seen_subcommand_from search' -l has-learnings      -d 'Select only items that have learnings'
-complete -c pm -n '__fish_seen_subcommand_from search' -l no-learnings       -d 'Select only items with no learnings'
-complete -c pm -n '__fish_seen_subcommand_from search' -l has-files          -d 'Select only items that have linked files'
-complete -c pm -n '__fish_seen_subcommand_from search' -l no-files           -d 'Select only items with no linked files'
-complete -c pm -n '__fish_seen_subcommand_from search' -l filter-files-missing -d 'Alias for --no-files'
-complete -c pm -n '__fish_seen_subcommand_from search' -l has-docs           -d 'Select only items that have linked docs'
-complete -c pm -n '__fish_seen_subcommand_from search' -l no-docs            -d 'Select only items with no linked docs'
-complete -c pm -n '__fish_seen_subcommand_from search' -l filter-docs-missing  -d 'Alias for --no-docs'
-complete -c pm -n '__fish_seen_subcommand_from search' -l has-tests          -d 'Select only items that have linked tests'
-complete -c pm -n '__fish_seen_subcommand_from search' -l no-tests           -d 'Select only items with no linked tests'
-complete -c pm -n '__fish_seen_subcommand_from search' -l has-comments       -d 'Select only items that have comments'
-complete -c pm -n '__fish_seen_subcommand_from search' -l no-comments        -d 'Select only items with no comments'
-complete -c pm -n '__fish_seen_subcommand_from search' -l has-deps           -d 'Select only items that have dependencies'
-complete -c pm -n '__fish_seen_subcommand_from search' -l no-deps            -d 'Select only items with no dependencies'
-complete -c pm -n '__fish_seen_subcommand_from search' -l has-body           -d 'Select only items with non-empty body'
-complete -c pm -n '__fish_seen_subcommand_from search' -l empty-body         -d 'Select only items with empty body'
-complete -c pm -n '__fish_seen_subcommand_from search' -l has-linked-command -d 'Select only items that have a linked command'
-complete -c pm -n '__fish_seen_subcommand_from search' -l no-linked-command  -d 'Select only items with no linked command'
-${fishSearchRuntimeFieldFlags}
-
-# calendar flags
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l view      -d 'Calendar view' -r -a 'agenda day week month'
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l date      -d 'Anchor date/time (ISO/date string or relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l from      -d 'Agenda lower bound (ISO/date string or relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l to        -d 'Agenda upper bound (ISO/date string or relative)' -r
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l past      -d 'Include past entries'
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l full-period -d 'Include full anchored day/week/month period'
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l type      -d 'Filter by type' -r -a '${typeChoices}'
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l tag       -d 'Filter by tag' -r -a ${fishTagChoices}
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l priority  -d 'Filter by priority' -r -a '0 1 2 3 4'
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l status    -d 'Filter by status' -r -a '${statusChoices}'
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l assignee  -d 'Filter by assignee' -r
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l sprint    -d 'Filter by sprint' -r
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l release   -d 'Filter by release' -r
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l include   -d 'Include event sources' -r -a 'all deadlines reminders events scheduled'
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l recurrence-lookahead-days -d 'Bound open-ended recurrence lookahead' -r
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l recurrence-lookback-days -d 'Bound open-ended recurrence lookback' -r
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l occurrence-limit -d 'Cap occurrences per recurring event' -r
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l limit     -d 'Limit returned events' -r
-complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l format    -d 'Output override' -r -a 'markdown toon json'
-${fishCalendarRuntimeFieldFlags}
-
-# context flags
-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 '__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'
-complete -c pm -n '__fish_seen_subcommand_from guide' -l format    -d 'Output override' -r -a 'markdown toon json'
-complete -c pm -n '__fish_seen_subcommand_from guide' -l depth     -d 'Guide detail depth' -r -a 'brief standard deep'
-complete -c pm -n '__fish_seen_subcommand_from guide' -a '${guideTopicChoices}' -d 'Guide topic'
-
-# reindex flags
-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'
-complete -c pm -n '__fish_seen_subcommand_from get' -l full -d 'Explicit full item read'
-complete -c pm -n '__fish_seen_subcommand_from get' -l fields -d 'Render custom comma-separated item fields' -r
-complete -c pm -n '__fish_seen_subcommand_from get' -l tree -d 'Include descendant subtree in result payload'
-complete -c pm -n '__fish_seen_subcommand_from get' -l tree-depth -d 'Cap subtree depth for --tree (0 = root only)' -r
-
-# Read the first command positions after consuming recognized global options.
-function __pm_history_tokens
-  set -l tokens (commandline -opc)
-  set -l skip_value 0
-  set -l positions 0
-  set -l command_path
-  for token in $tokens[2..-1]
-    if test $skip_value -eq 1
-      set skip_value 0
-      continue
-    end
-    switch (string replace -a _ - -- "$token")
-      case ${GLOBAL_COMPLETION_VALUE_PATTERNS.replaceAll("|"," ")}
-        set skip_value 1
-        continue
-      case ${GLOBAL_COMPLETION_INLINE_PATTERNS.split("|").map(pattern=>`'${pattern}'`).join(" ")} ${GLOBAL_COMPLETION_SWITCH_PATTERNS.replaceAll("|"," ")}
-        continue
-      case --
-        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)
-    set -a command_path "$token"
-    if not contains -- (string join ' ' -- $command_path) ${NAMESPACE_PREFIXES.map(prefix=>`'${prefix}'`).join(" ")}
-      return
-    end
-  end
-  if test $skip_value -eq 1
-    printf '%s\\n' --value
-  end
-end
-
-# Match only the command positions, keeping item history separate from maintenance.
-function __pm_history_operation
-  set -l tokens (__pm_history_tokens)
-  switch (string join ' ' -- $tokens)
-${[...PM_NAMESPACED_COMMAND_ALIASES].sort((left,right)=>right.canonical_argv.length-left.canonical_argv.length).map(entry=>`    case '${entry.canonical}' '${entry.canonical} *'
-      contains -- '${entry.alias}' $argv
-      return`).join("\n")}
-  end
-  contains -- "$tokens[1]" $argv
-end
-${Object.entries(namespaceLeaves).map(([noun,leaves])=>`complete -c pm -n 'test (string join " " -- (__pm_history_tokens)) = "${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")}
-
-${ATTEST_INVOCATIONS.map(flag=>`complete -c pm -n '__pm_history_operation history-attest' -l ${flag.flag.slice(2)}${flag.takes_value?" -r":""}`).join("\n")}
-
-# history / activity flags
-complete -c pm -n '__pm_history_operation history'  -l limit -d 'Max history entries' -r
-complete -c pm -n '__pm_history_operation history'  -l compact -d 'Condensed history projection'
-complete -c pm -n '__pm_history_operation history'  -l full -d 'Show full history entries'
-complete -c pm -n '__pm_history_operation history'  -l provenance -d 'Patch-free identity and agent provenance projection'
-complete -c pm -n '__pm_history_operation history'  -l provenance-summary -d 'Include bounded provenance completeness counts'
-complete -c pm -n '__pm_history_operation history'  -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
-complete -c pm -n '__pm_history_operation history'  -l agent-instance -d 'Filter by privacy-safe agent instance' -r
-complete -c pm -n '__pm_history_operation history'  -l provenance-filter -d 'Filter by exact declared provenance value' -r
-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 '__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
-complete -c pm -n '__pm_history_operation history-compact compact' -l all-over -d 'Bulk: compact every stream with more than N entries' -r
-complete -c pm -n '__pm_history_operation history-compact compact' -l closed -d 'Bulk: compact only closed (terminal) items streams'
-complete -c pm -n '__pm_history_operation history-compact compact' -l all-streams -d 'Bulk: compact every history stream regardless of lifecycle state'
-complete -c pm -n '__pm_history_operation history-compact compact' -l min-entries -d 'Bulk: skip streams with at most N entries' -r
-complete -c pm -n '__pm_history_operation history-compact compact' -l dry-run -d 'Preview compaction impact without writing the history file'
-complete -c pm -n '__pm_history_operation history-compact compact' -l author -d 'Mutation author' -r
-complete -c pm -n '__pm_history_operation history-compact compact' -l message -d 'Audit history message' -r
-complete -c pm -n '__pm_history_operation history-compact compact' -l force -d 'Force ownership/lock override'
-complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l event -d 'Actionable unknown-author event' -r
-complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l all-actionable -d 'Select every currently actionable event'
-complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l dry-run -d 'Preview a deterministic source-bound plan'
-complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l plan-fingerprint -d 'Apply the exact dry-run plan' -r
-complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l limit -d 'Maximum coordinate rows returned in the plan' -r
-complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l attributed-author -d 'Principal attributed by maintainer review' -r
-complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l reviewer -d 'Reviewer recording the disposition' -r
-complete -c pm -n '__fish_seen_subcommand_from history-author-acknowledge' -l reason -d 'Evidence-backed review rationale' -r
-complete -c pm -n '__pm_history_operation history-redact redact' -l literal -d 'Literal string matcher to redact from history/item payloads' -r
-complete -c pm -n '__pm_history_operation history-redact redact' -l id -d 'Item ID (alternative to positional ID)' -r
-complete -c pm -n '__pm_history_operation history-redact redact' -l regex -d 'Regex matcher to redact (/pattern/flags or raw pattern)' -r
-complete -c pm -n '__pm_history_operation history-redact redact' -l replacement -d 'Replacement text (defaults to [redacted])' -r
-complete -c pm -n '__pm_history_operation history-redact redact' -l dry-run -d 'Preview redaction impact without writing files'
-complete -c pm -n '__pm_history_operation history-redact redact' -l author -d 'Mutation author' -r
-complete -c pm -n '__pm_history_operation history-redact redact' -l message -d 'Audit history message' -r
-complete -c pm -n '__pm_history_operation history-redact redact' -l force -d 'Force ownership/lock override'
-complete -c pm -n '__pm_history_operation history-repair repair' -l salvage-tail -d 'Recover an invalid suffix after a verified prefix'
-complete -c pm -n '__pm_history_operation history-repair repair' -l id -d 'Item ID (alternative to positional ID)' -r
-complete -c pm -n '__pm_history_operation history-repair repair' -l normalize-provenance -d 'Remove invalid provenance with aggregate evidence'
-complete -c pm -n '__pm_history_operation history-repair repair' -l all -d 'Repair every drifted stream in one audited pass'
-complete -c pm -n '__pm_history_operation history-repair repair' -l dry-run -d 'Preview the re-anchor impact without writing the history file'
-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 '${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
-complete -c pm -n '__fish_seen_subcommand_from schema' -l alias -d 'Alias for the custom type, status, or field flag (repeatable)' -r
-complete -c pm -n '__fish_seen_subcommand_from schema' -l role -d 'Lifecycle role for a custom status (repeatable)' -r
-complete -c pm -n '__fish_seen_subcommand_from schema' -l order -d 'Display/sort order for a custom status' -r
-complete -c pm -n '__fish_seen_subcommand_from schema' -l type -d 'Value type for a custom field' -r -a 'string number boolean string_array array object'
-complete -c pm -n '__fish_seen_subcommand_from schema' -l commands -d 'Commands a custom field is wired onto (repeatable)' -r
-complete -c pm -n '__fish_seen_subcommand_from schema' -l cli-flag -d 'Override the auto-derived CLI flag for a custom field' -r
-complete -c pm -n '__fish_seen_subcommand_from schema' -l required -d 'Mark a custom field as always required'
-complete -c pm -n '__fish_seen_subcommand_from schema' -l required-on-create -d 'Mark a custom field as required at create time'
-complete -c pm -n '__fish_seen_subcommand_from schema' -l no-allow-unset -d 'Disallow clearing a custom field via --unset'
-complete -c pm -n '__fish_seen_subcommand_from schema' -l required-types -d 'Restrict a custom field requirement to specific item types (repeatable)' -r
-complete -c pm -n '__fish_seen_subcommand_from schema' -l infer -d 'Infer item types from title-prefix conventions (add-type)'
-complete -c pm -n '__fish_seen_subcommand_from schema' -l min-count -d 'Minimum items sharing a prefix for --infer' -r
-complete -c pm -n '__fish_seen_subcommand_from schema' -l apply -d 'Register inferred types (with --infer)'
-complete -c pm -n '__fish_seen_subcommand_from schema' -l author -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from schema' -l force -d 'Force ownership/lock override'
-complete -c pm -n '__fish_seen_subcommand_from profile' -a 'list show apply lint' -d 'Profile subcommand'
-complete -c pm -n '__fish_seen_subcommand_from profile' -a 'agile ops research' -d 'Profile name'
-complete -c pm -n '__fish_seen_subcommand_from profile' -l dry-run -d 'Preview the apply diff without writing any files'
-complete -c pm -n '__fish_seen_subcommand_from profile' -l author -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from profile' -l force -d 'Force ownership/lock override'
-complete -c pm -n '__fish_seen_subcommand_from plan' -a 'create show add-step update-step complete-step block-step reorder-step remove-step link unlink decision discovery validation resume approve materialize' -d 'Plan subcommand'
-complete -c pm -n '__fish_seen_subcommand_from plan' -l title -d 'Plan title' -r
-complete -c pm -n '__fish_seen_subcommand_from plan' -l scope -d 'Plan scope statement' -r
-complete -c pm -n '__fish_seen_subcommand_from plan' -l harness -d 'Plan harness provenance' -r -a 'codex claude-code cursor generic'
-complete -c pm -n '__fish_seen_subcommand_from plan' -l mode -d 'Plan mode' -r -a 'draft research review approved executing paused completed superseded'
-complete -c pm -n '__fish_seen_subcommand_from plan' -l resume-context -d 'Resume context summary' -r
-complete -c pm -n '__fish_seen_subcommand_from plan' -l step-title -d 'Step title' -r
-complete -c pm -n '__fish_seen_subcommand_from plan' -l step -d 'Step title (repeatable on create)' -r
-complete -c pm -n '__fish_seen_subcommand_from plan' -l step-status -d 'Step status' -r -a 'pending in_progress completed blocked skipped superseded'
-complete -c pm -n '__fish_seen_subcommand_from plan' -l step-evidence -d 'Step evidence' -r
-complete -c pm -n '__fish_seen_subcommand_from plan' -l depends-on -d 'Pm item id step depends on' -r
-complete -c pm -n '__fish_seen_subcommand_from plan' -l link -d 'Pm item id to link' -r
-complete -c pm -n '__fish_seen_subcommand_from plan' -l link-kind -d 'Link kind' -r -a 'related blocks blocked_by depends_on discovered_from implements verifies supersedes'
-complete -c pm -n '__fish_seen_subcommand_from plan' -l depth -d 'Show depth' -r -a 'brief standard deep'
-complete -c pm -n '__fish_seen_subcommand_from plan' -l steps -d 'Step ids/orders for materialize' -r
-complete -c pm -n '__fish_seen_subcommand_from plan' -l materialize-type -d 'Item type for materialized steps' -r
-complete -c pm -n '__fish_seen_subcommand_from plan' -l allow-multiple-active -d 'Allow multiple in_progress steps'
-complete -c pm -n '__fish_seen_subcommand_from plan' -l promote-to-item-dep -d 'Also add link as item dependency'
-complete -c pm -n '__fish_seen_subcommand_from plan' -l author -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from plan' -l message -d 'Mutation message' -r
-complete -c pm -n '__fish_seen_subcommand_from plan' -l force -d 'Force ownership override'
-complete -c pm -n '__pm_history_operation activity activity' -l id -d 'Filter by item ID' -r
-complete -c pm -n '__pm_history_operation activity activity' -l op -d 'Filter by history operation' -r
-complete -c pm -n '__pm_history_operation activity activity' -l author -d 'Filter by history author' -r
-complete -c pm -n '__pm_history_operation activity activity' -l from -d 'Lower timestamp bound (ISO/date string or relative)' -r
-complete -c pm -n '__pm_history_operation activity activity' -l to -d 'Upper timestamp bound (ISO/date string or relative)' -r
-complete -c pm -n '__pm_history_operation activity activity' -l limit -d 'Max activity entries' -r
-complete -c pm -n '__pm_history_operation activity activity' -l unbounded -d 'Return every matching activity entry'
-complete -c pm -n '__pm_history_operation activity activity' -l compact -d 'Condensed activity projection'
-complete -c pm -n '__pm_history_operation activity activity' -l raw -d 'Emit raw compact per-event activity output'
-complete -c pm -n '__pm_history_operation activity activity' -l full -d 'Show full activity entries'
-complete -c pm -n '__pm_history_operation activity activity' -l provenance -d 'Patch-free identity and agent provenance projection'
-complete -c pm -n '__pm_history_operation activity activity' -l provenance-summary -d 'Include bounded provenance completeness counts'
-complete -c pm -n '__pm_history_operation activity activity' -l harness -d 'Filter by recorded or vocabulary-resolved harness' -r
-complete -c pm -n '__pm_history_operation activity activity' -l agent-instance -d 'Filter by privacy-safe agent instance' -r
-complete -c pm -n '__pm_history_operation activity activity' -l provenance-filter -d 'Filter by exact declared provenance value' -r
-complete -c pm -n '__pm_history_operation activity activity' -l stream -d 'Emit line-delimited JSON rows (requires --json)'
-complete -c pm -n '__fish_seen_subcommand_from contracts' -l action -d 'Filter schema by tool action' -r
-complete -c pm -n '__fish_seen_subcommand_from contracts' -l command -d 'Scope output to one command (narrow-by-default)' -r
-complete -c pm -n '__fish_seen_subcommand_from contracts' -l summary -d 'Return compact command intent summary'
-complete -c pm -n '__fish_seen_subcommand_from contracts' -l schema-only -d 'Return schema-only payload'
-complete -c pm -n '__fish_seen_subcommand_from contracts' -l flags-only -d 'Return command flag contracts only'
-complete -c pm -n '__fish_seen_subcommand_from contracts' -l availability-only -d 'Return action availability only'
-complete -c pm -n '__fish_seen_subcommand_from contracts' -l runtime-only -d 'Include only actions invocable in the current runtime'
-complete -c pm -n '__fish_seen_subcommand_from contracts' -l active-only -d 'Alias for --runtime-only'
-complete -c pm -n '__fish_seen_subcommand_from contracts' -l full -d 'Include complete command and schema contract details'
-complete -c pm -n '__fish_seen_subcommand_from deps' -l format -d 'Output format' -r -a 'tree graph context'
-complete -c pm -n '__fish_seen_subcommand_from deps' -l max-depth -d 'Maximum traversal depth (0 keeps root only)' -r
-complete -c pm -n '__fish_seen_subcommand_from deps' -l collapse -d 'Collapse mode' -r -a 'none repeated'
-complete -c pm -n '__fish_seen_subcommand_from deps' -l summary -d 'Return counts only without tree/graph payload'
-complete -c pm -n '__fish_seen_subcommand_from deps' -l node-limit -d 'Maximum nodes in context output' -r
-complete -c pm -n '__fish_seen_subcommand_from deps' -l edge-limit -d 'Maximum edges in context output' -r
-complete -c pm -n '__fish_seen_subcommand_from deps' -l token-budget -d 'Maximum estimated tokens in context output' -r
-complete -c pm -n '__fish_seen_subcommand_from deps' -l cursor -d 'Continue an equivalent context query' -r
-complete -c pm -n '__fish_seen_subcommand_from deps' -l direction -d 'Context traversal direction' -r -a 'outgoing incoming both'
-complete -c pm -n '__fish_seen_subcommand_from deps' -l kind -d 'Restrict context traversal to relationship kinds' -r
-complete -c pm -n '__fish_seen_subcommand_from graph' -a 'ancestors descendants predecessors successors paths impact analyze audit communities redundancy dominators slack centrality articulation plan index' -d 'Graph query'
-complete -c pm -n '__fish_seen_subcommand_from graph' -l kind -d 'Restrict traversal to registered relationship kinds' -r
-complete -c pm -n '__fish_seen_subcommand_from graph' -l max-depth -d 'Maximum traversal depth' -r
-complete -c pm -n '__fish_seen_subcommand_from graph' -l limit -d 'Maximum returned rows per bounded collection' -r
-complete -c pm -n '__fish_seen_subcommand_from graph' -l after -d 'Resume a traversal after this node id' -r
-complete -c pm -n '__fish_seen_subcommand_from graph' -l direction -d 'Edge orientation for paths/impact' -r -a 'outgoing incoming both'
-complete -c pm -n '__fish_seen_subcommand_from graph' -l max-paths -d 'Maximum enumerated paths' -r
-complete -c pm -n '__fish_seen_subcommand_from graph' -l sample -d 'Maximum evidence sample entries per audit finding' -r
-complete -c pm -n '__fish_seen_subcommand_from graph' -l exempt-isolate -d 'Item ids treated as explicitly valid isolates' -r
-complete -c pm -n '__fish_seen_subcommand_from graph' -l exempt-isolate-type -d 'Item types whose active isolates are policy-valid' -r
-complete -c pm -n '__fish_seen_subcommand_from graph' -l save-baseline -d 'Persist the audit census as the comparison baseline'
-complete -c pm -n '__fish_seen_subcommand_from graph' -l rebuild -d 'Rebuild and warm the durable graph index'
-complete -c pm -n '__fish_seen_subcommand_from graph' -l clear -d 'Delete the durable graph index'
-complete -c pm -n '__fish_seen_subcommand_from graph' -l summary -d 'Return counts-first envelopes without row collections'
-
-# comments / notes / learnings flags
-complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l add -d 'Add one entry (text=<value> or plain text)' -r
-complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l text -d 'Alias for --add' -r
-complete -c pm -n '__fish_seen_subcommand_from notes' -l add-json -d 'Append one validated JSON context event' -r
-complete -c pm -n '__fish_seen_subcommand_from notes' -l since -d 'Return structured events at or after an ISO timestamp' -r
-complete -c pm -n '__fish_seen_subcommand_from notes' -l event-type -d 'Return structured events with this top-level type' -r
-complete -c pm -n '__fish_seen_subcommand_from notes' -l include-meta -d 'Include result counts and truncation metadata'
-complete -c pm -n '__fish_seen_subcommand_from comments' -l stdin -d 'Read comment text from stdin (supports multiline markdown)'
-complete -c pm -n '__fish_seen_subcommand_from comments' -l file -d 'Read comment text from file (supports multiline markdown)' -r
-complete -c pm -n '__fish_seen_subcommand_from comments' -l edit -d 'Replace the comment at 1-based index (text from positional/--add/--stdin/--file)' -r
-complete -c pm -n '__fish_seen_subcommand_from comments' -l delete -d 'Delete the comment at 1-based index' -r
-complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l if-absent -d 'Append only when the resolved author and text are absent'
-complete -c pm -n '__fish_seen_subcommand_from notes' -l stdin -d 'Read entry text from stdin'
-complete -c pm -n '__fish_seen_subcommand_from notes' -l file -d 'Read entry text from file' -r
-complete -c pm -n '__fish_seen_subcommand_from notes' -l edit -d 'Replace the entry at a 1-based index' -r
-complete -c pm -n '__fish_seen_subcommand_from notes' -l delete -d 'Delete the entry at a 1-based index' -r
-complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l limit -d 'Return only latest n entries' -r
-complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l full-history -d 'Return complete post-mutation history'
-complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l author -d 'Entry author' -r
-complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l message -d 'History message' -r
-complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l force -d 'Force override'
-
-# test flags
-complete -c pm -n '__fish_seen_subcommand_from test' -l add -d 'Add linked test entry' -r
-complete -c pm -n '__fish_seen_subcommand_from test' -l add-json -d 'Add linked test entry from JSON object/array' -r
-complete -c pm -n '__fish_seen_subcommand_from test' -l remove -d 'Remove linked test entry' -r
-complete -c pm -n '__fish_seen_subcommand_from test' -l remove-index -d 'Remove linked test entry by 1-based index' -r
-complete -c pm -n '__fish_seen_subcommand_from test' -l list -d 'List linked tests without mutating'
-complete -c pm -n '__fish_seen_subcommand_from test' -l run -d 'Run linked tests'
-complete -c pm -n '__fish_seen_subcommand_from test' -l match -d 'Run linked tests whose command/path contains substring' -r
-complete -c pm -n '__fish_seen_subcommand_from test' -l only-index -d 'Run one linked test by 1-based index' -r
-complete -c pm -n '__fish_seen_subcommand_from test' -l only-last -d 'Run the most recently added linked test'
-complete -c pm -n '__fish_seen_subcommand_from test' -l background -d 'Run linked tests in managed background mode'
-complete -c pm -n '__fish_seen_subcommand_from test' -l timeout -d 'Default timeout seconds' -r
-complete -c pm -n '__fish_seen_subcommand_from test' -l progress -d 'Emit linked-test progress to stderr'
-complete -c pm -n '__fish_seen_subcommand_from test' -l env-set -d 'Set linked-test runtime environment values' -r
-complete -c pm -n '__fish_seen_subcommand_from test' -l env-clear -d 'Clear linked-test runtime environment values' -r
-complete -c pm -n '__fish_seen_subcommand_from test' -l shared-host-safe -d 'Apply shared-host-safe runtime defaults'
-complete -c pm -n '__fish_seen_subcommand_from test' -l pm-context -d 'PM linked-test context mode' -r -a 'schema tracker auto'
-complete -c pm -n '__fish_seen_subcommand_from test' -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' -l fail-on-context-mismatch -d 'Fail when context item counts mismatch'
-complete -c pm -n '__fish_seen_subcommand_from test' -l fail-on-skipped -d 'Treat skipped linked tests as dependency failures'
-complete -c pm -n '__fish_seen_subcommand_from test' -l fail-on-empty-test-run -d 'Treat empty linked-test selections as failures'
-complete -c pm -n '__fish_seen_subcommand_from test' -l require-assertions-for-pm -d 'Require assertions for linked PM command tests'
-complete -c pm -n '__fish_seen_subcommand_from test' -l check-context -d 'Preflight linked PM command context diagnostics before execution'
-complete -c pm -n '__fish_seen_subcommand_from test' -l auto-pm-context -d 'Auto-remediate tracker-read context mismatches using tracker context'
-complete -c pm -n '__fish_seen_subcommand_from test' -l author -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from test' -l message -d 'History message' -r
-complete -c pm -n '__fish_seen_subcommand_from test' -l force -d 'Force override'
-
-# test-all flags
-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'
-complete -c pm -n '__fish_seen_subcommand_from test-runs' -l status -d 'Filter background runs by status' -r -a 'queued running passed failed stopped canceled'
-complete -c pm -n '__fish_seen_subcommand_from test-runs' -l limit -d 'Limit returned runs' -r
-complete -c pm -n '__fish_seen_subcommand_from test-runs' -l stream -d 'Background log stream selector' -r -a 'stdout stderr both'
-complete -c pm -n '__fish_seen_subcommand_from test-runs' -l tail -d 'Tail number of lines from logs' -r
-complete -c pm -n '__fish_seen_subcommand_from test-runs' -l force -d 'Force-stop run with SIGKILL'
-complete -c pm -n '__fish_seen_subcommand_from test-runs' -l author -d 'Resume author' -r
-
-# gc flags
-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 '__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
-complete -c pm -n '__fish_seen_subcommand_from append' -l author -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from append' -l message -d 'History message' -r
-complete -c pm -n '__fish_seen_subcommand_from append' -l force -d 'Force override'
-
-# close flags
-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 '__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
-complete -c pm -n '__fish_seen_subcommand_from meet event' -l duration -d 'Duration from start (default 1h)' -r
-complete -c pm -n '__fish_seen_subcommand_from meet event' -l end -d 'End time (overrides --duration)' -r
-complete -c pm -n '__fish_seen_subcommand_from meet event' -l location -d 'Location' -r
-complete -c pm -n '__fish_seen_subcommand_from meet event' -l timezone -d 'IANA timezone' -r
-complete -c pm -n '__fish_seen_subcommand_from meet event' -l all-day -d 'Mark as an all-day event'
-complete -c pm -n '__fish_seen_subcommand_from remind' -l at -d 'Reminder time (default +1d)' -r
-complete -c pm -n '__fish_seen_subcommand_from remind' -l text -d 'Reminder text (defaults to title)' -r
-complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l parent -d 'Parent item id' -r
-complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l allow-missing-parent -d 'Permit a parent id that does not exist yet'
-complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l tags -d 'Comma-separated tags' -r
-complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l priority -d 'Priority (0-4)' -r -a '0 1 2 3 4'
-complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l body -d 'Item body' -r
-complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l description -d 'Short description' -r
-complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l author -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l message -d 'History message' -r
-
-# close-many flags
-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 '__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
-complete -c pm -n '__fish_seen_subcommand_from init' -l defaults -d 'Use non-interactive setup defaults'
-complete -c pm -n '__fish_seen_subcommand_from init' -s y -l yes -d 'Alias for --defaults'
-complete -c pm -n '__fish_seen_subcommand_from init' -l author -d 'Set the default mutation author for this project' -r
-complete -c pm -n '__fish_seen_subcommand_from init' -l agent-guidance -d 'Agent guidance mode' -r -a 'ask add skip status'
-complete -c pm -n '__fish_seen_subcommand_from init' -l type-preset -d 'Register domain item types' -r -a 'agile ops research'
-complete -c pm -n '__fish_seen_subcommand_from init' -l with-packages -d 'Install bundled first-party packages during initialization'
-complete -c pm -n '__fish_seen_subcommand_from init' -l verbose -d 'Include the full resolved settings tree in init output'
-complete -c pm -n '__fish_seen_subcommand_from config' -l criterion -d 'Criteria value for definition-of-done metadata-required-fields or lifecycle pattern keys (repeatable for set)' -r
-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 '__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'
-complete -c pm -n '__fish_seen_subcommand_from completion' -a 'bash zsh fish' -d 'Shell type'
-
-# templates subcommands
-complete -c pm -n '__fish_seen_subcommand_from templates' -a 'save list show' -d 'Templates command'
-
-# extension lifecycle flags
-complete -c pm -n '__fish_seen_subcommand_from extension' -a '${EXTENSION_LIFECYCLE_ACTIONS}' -d 'Extension action subcommand'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l init -d 'Generate starter extension scaffold'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l scaffold -d 'Alias for --init'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l capability -d 'Capability the init scaffold targets' -r -a '${SCAFFOLD_CAPABILITIES.join(" ")}'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l install -d 'Install extension from local path or GitHub source'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l uninstall -d 'Uninstall extension by name'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l explore -d 'List discovered extensions for selected scope'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l manage -d 'List managed extensions with update metadata'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l describe -d 'Map every surface a loaded extension registers'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l markdown -d 'Render describe output as a Markdown reference document'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l output -d 'Write describe Markdown to a file' -r
-complete -c pm -n '__fish_seen_subcommand_from extension' -l reload -d 'Reload extensions with cache-busted module imports'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l watch -d 'Enable watch mode with --reload'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l doctor -d 'Run consolidated extension diagnostics'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l catalog -d 'List bundled first-party package catalog entries'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l adopt -d 'Adopt an unmanaged extension into managed metadata'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l adopt-all -d 'Adopt all unmanaged extensions into managed metadata'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l activate -d 'Activate extension in selected scope settings'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l deactivate -d 'Deactivate extension in selected scope settings'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l project -d 'Use project extension scope'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l local -d 'Alias for --project'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l global -d 'Use global extension scope'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l gh -d 'GitHub shorthand owner/repo/path' -r
-complete -c pm -n '__fish_seen_subcommand_from extension' -l github -d 'Alias for --gh' -r
-complete -c pm -n '__fish_seen_subcommand_from extension' -l ref -d 'Git ref/branch/tag for GitHub source' -r
-complete -c pm -n '__fish_seen_subcommand_from extension' -l detail -d 'Detail mode for extension diagnostics' -r -a 'summary deep'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l trace -d 'Include registration traces in doctor deep diagnostics'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l runtime-probe -d 'Opt-in runtime activation probe for manage output'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l fix-managed-state -d 'Adopt unmanaged extensions before diagnostics/update checks'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l isolated -d 'Run doctor against project-scope extensions only'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l ignore-global -d 'Alias for --isolated'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l strict-exit -d 'Return non-zero exit when doctor warnings are present'
-complete -c pm -n '__fish_seen_subcommand_from extension' -l fail-on-warn -d 'Alias for --strict-exit (doctor)'
-
-# package lifecycle flags
-for package_cmd in package packages
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -a '${PACKAGE_LIFECYCLE_ACTIONS}' -d 'Package action subcommand'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l init -d 'Generate starter package scaffold'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l scaffold -d 'Alias for --init'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l capability -d 'Capability the init scaffold targets' -r -a '${SCAFFOLD_CAPABILITIES.join(" ")}'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l declarative -d 'Generate a composeExtension blueprint starter'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l install -d 'Install package from local path, GitHub source, npm source, or bundled alias'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l uninstall -d 'Uninstall package by name'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l explore -d 'List discovered packages for selected scope'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l manage -d 'List managed packages with update metadata'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l describe -d 'Map every surface a loaded package registers'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l markdown -d 'Render describe output as a Markdown reference document'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l output -d 'Write describe Markdown to a file' -r
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l reload -d 'Reload packages with cache-busted module imports'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l watch -d 'Enable watch mode with --reload'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l doctor -d 'Run consolidated package diagnostics'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l catalog -d 'List bundled first-party package catalog entries'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l adopt -d 'Adopt an unmanaged package into managed metadata'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l adopt-all -d 'Adopt all unmanaged packages into managed metadata'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l activate -d 'Activate package in selected scope settings'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l deactivate -d 'Deactivate package in selected scope settings'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l project -d 'Use project package scope'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l local -d 'Alias for --project'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l global -d 'Use global package scope'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l gh -d 'GitHub shorthand owner/repo/path' -r
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l github -d 'Alias for --gh' -r
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l ref -d 'Git ref/branch/tag for GitHub source' -r
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l detail -d 'Detail mode for package diagnostics' -r -a 'summary deep'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l trace -d 'Include registration traces in doctor deep diagnostics'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l runtime-probe -d 'Opt-in runtime activation probe for manage output'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l fix-managed-state -d 'Adopt unmanaged packages before diagnostics/update checks'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l isolated -d 'Run doctor against project-scope packages only'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l ignore-global -d 'Alias for --isolated'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l strict-exit -d 'Return non-zero exit when doctor warnings are present'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l fail-on-warn -d 'Alias for --strict-exit (doctor)'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l dry-run -d 'Plan upgrades without mutating'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l cli-only -d 'Upgrade only the pm CLI/SDK npm package'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l packages-only -d 'Upgrade only managed pm packages'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l repair -d 'Force npm global reinstall for the CLI/SDK'
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l tag -d 'npm version or dist-tag for upgrades' -r
-  complete -c pm -n "__fish_seen_subcommand_from $package_cmd" -l package-name -d 'Override the CLI package name' -r
-end`}const SETUP_HINTS={bash:'Add to ~/.bashrc or ~/.bash_profile: eval "$(pm completion bash)"',zsh:'Add to ~/.zshrc: eval "$(pm completion zsh)"',fish:"Run: pm completion fish > ~/.config/fish/completions/pm.fish"};function runCompletion(shell,itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const normalized=shell.trim().toLowerCase();if(!VALID_SHELLS.includes(normalized)){throw new PmCliError(`Unknown shell: "${shell}". Supported shells: ${VALID_SHELLS.join(", ")}.`,EXIT_CODE.USAGE)}const validShell=normalized;let script;if(validShell==="bash"){script=generateBashScript(itemTypes,tags,eagerTagExpansion,runtime)}else if(validShell==="zsh"){script=generateZshScript(itemTypes,tags,eagerTagExpansion,runtime)}else{script=generateFishScript(itemTypes,tags,eagerTagExpansion,runtime)}return{shell:validShell,script,setup_hint:SETUP_HINTS[validShell]}}export{generateBashScript,generateFishScript,generateZshScript,runCompletion};
+!(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]="c1fb3981-3bae-5f63-861a-ee689a9ffd36")}catch(e2){}})();import{generateBashScript}from"./completion/bash.js";import{generateFishScript}from"./completion/fish.js";import{generateZshScript}from"./completion/zsh.js";import{EXIT_CODE,PmCliError}from"./runtime-primitives.js";const VALID_SHELLS=["bash","zsh","fish"];const SETUP_HINTS={bash:'Add to ~/.bashrc or ~/.bash_profile: eval "$(pm completion bash)"',zsh:'Add to ~/.zshrc: eval "$(pm completion zsh)"',fish:"Run: pm completion fish > ~/.config/fish/completions/pm.fish"};function runCompletion(shell,itemTypes=[],tags=[],eagerTagExpansion=false,runtime={}){const normalized=shell.trim().toLowerCase();if(!VALID_SHELLS.includes(normalized)){throw new PmCliError(`Unknown shell: "${shell}". Supported shells: ${VALID_SHELLS.join(", ")}.`,EXIT_CODE.USAGE)}const validShell=normalized;let script;if(validShell==="bash"){script=generateBashScript(itemTypes,tags,eagerTagExpansion,runtime)}else if(validShell==="zsh"){script=generateZshScript(itemTypes,tags,eagerTagExpansion,runtime)}else{script=generateFishScript(itemTypes,tags,eagerTagExpansion,runtime)}return{shell:validShell,script,setup_hint:SETUP_HINTS[validShell]}}import{generateBashScript as generateBashScript2}from"./completion/bash.js";import{generateFishScript as generateFishScript2}from"./completion/fish.js";import{generateZshScript as generateZshScript2}from"./completion/zsh.js";export{generateBashScript2 as generateBashScript,generateFishScript2 as generateFishScript,generateZshScript2 as generateZshScript,runCompletion};
 //# sourceMappingURL=completion.js.map