@unbrained/pm-cli 2026.5.31 → 2026.6.6

package/dist/cli/commands/completion.js

@@ -1,19 +1,20 @@
 
-!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]="56ca52a0-bad8-57a6-af37-8b54538f07fa")}catch(e){}}();
+!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]="62701936-e5db-51ae-87a7-d448b11c7e5f")}catch(e){}}();
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
-import { ACTIVITY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, NORMALIZE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, SEARCH_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, toCompletionFlagString, } from "../../sdk/cli-contracts.js";
-import { BUILTIN_ITEM_TYPE_VALUES } from "../../types/index.js";
+import { ACTIVITY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, NORMALIZE_FLAG_CONTRACTS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, SEARCH_FLAG_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, toCompletionFlagString, } from "../../sdk/cli-contracts.js";
+import { BUILTIN_ITEM_TYPE_VALUES, STATUS_VALUES } from "../../types/index.js";
 import { listGuideTopicIds } from "../guide-topics.js";
 const VALID_SHELLS = ["bash", "zsh", "fish"];
 const DEFAULT_ITEM_TYPES = [...BUILTIN_ITEM_TYPE_VALUES];
-const DEFAULT_STATUS_VALUES = ["draft", "open", "in_progress", "blocked", "closed", "canceled"];
+const DEFAULT_STATUS_VALUES = [...STATUS_VALUES];
 const ALL_COMMANDS = [...PM_CORE_COMMAND_NAMES];
 const LIST_FLAGS = toCompletionFlagString(LIST_FILTER_FLAG_CONTRACTS);
 const APPEND_FLAGS = toCompletionFlagString(APPEND_FLAG_CONTRACTS);
 const CREATE_FLAGS = toCompletionFlagString(CREATE_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 NORMALIZE_FLAGS = toCompletionFlagString(NORMALIZE_FLAG_CONTRACTS);
 const ACTIVITY_FLAGS = toCompletionFlagString(ACTIVITY_FLAG_CONTRACTS);
 const CALENDAR_FLAGS = toCompletionFlagString(CALENDAR_FLAG_CONTRACTS);
@@ -41,6 +42,18 @@ function joinCompletionValues(values) {
         .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);
@@ -72,10 +85,93 @@ function renderFishRuntimeFieldFlagSpecs(commands, runtimeFlags) {
     }
     return `${lines.join("\n")}\n`;
 }
-export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], eagerTagExpansion = false, runtime = {}) {
+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
+`;
+}
+export function generateBashScript(itemTypes = [], tags = [], eagerTagExpansion = false, runtime = {}) {
     const cmds = ALL_COMMANDS.join(" ");
-    const typeValues = itemTypes.join(" ");
-    const statusValues = joinCompletionValues(runtime.statuses ?? DEFAULT_STATUS_VALUES);
+    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);
@@ -93,6 +189,9 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         "# 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 || {",
@@ -107,12 +206,14 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         "  fi",
         "",
         '  if [[ "$prev" == "--type" ]]; then',
-        `    COMPREPLY=(${compgen(typeValues)})`,
+        useDynamicTypeExpansion
+            ? '    COMPREPLY=($(compgen -W "$(_pm_completion_type_choices)" -- "$cur"))'
+            : `    COMPREPLY=(${compgen(typeValues)})`,
         "    return 0",
         "  fi",
         "",
         '  if [[ "$prev" == "--status" ]]; then',
-        `    COMPREPLY=(${compgen(statusValues)})`,
+        '    COMPREPLY=($(compgen -W "$(_pm_completion_status_choices)" -- "$cur"))',
         "    return 0",
         "  fi",
         "",
@@ -222,13 +323,13 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         `      COMPREPLY=(${compgen("list status logs stop resume --status --limit --stream --tail --force --author --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    validate)",
-        `      COMPREPLY=(${compgen("--check-metadata --metadata-profile --check-resolution --check-lifecycle --check-stale-blockers --dependency-cycle-severity --check-files --scan-mode --include-pm-internals --verbose-file-lists --strict-exit --fail-on-warn --check-history-drift --check-command-references --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--check-metadata --metadata-profile --check-resolution --check-lifecycle --check-stale-blockers --dependency-cycle-severity --check-files --scan-mode --include-pm-internals --verbose-file-lists --verbose-diagnostics --strict-exit --fail-on-warn --fix-hints --check-history-drift --check-command-references --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    health)",
         `      COMPREPLY=(${compgen(HEALTH_FLAGS)})`,
         "      ;;",
         "    history)",
-        `      COMPREPLY=(${compgen("--limit --compact --full --diff --verify --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--limit --compact --full --diff --field --verify --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    get)",
         `      COMPREPLY=(${compgen("--depth --full --fields --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
@@ -240,7 +341,7 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         `      COMPREPLY=(${compgen("--dry-run --author --message --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    schema)",
-        `      COMPREPLY=(${compgen("add-type --description --default-status --folder --alias --author --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("list show add-type remove-type add-status remove-status --description --default-status --folder --alias --role --order --author --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    plan)",
         `      COMPREPLY=(${compgen(`${PLAN_SUBCOMMANDS_LIST} ${PLAN_FLAGS}`)})`,
@@ -254,9 +355,15 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         "    gc)",
         `      COMPREPLY=(${compgen("--dry-run --scope --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
+        "    stats)",
+        `      COMPREPLY=(${compgen("--storage --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
+        "      ;;",
         "    close|close-task)",
         `      COMPREPLY=(${compgen(CLOSE_MUTATION_FLAGS)})`,
         "      ;;",
+        "    close-many)",
+        `      COMPREPLY=(${compgen(CLOSE_MANY_FLAGS)})`,
+        "      ;;",
         "    release)",
         `      COMPREPLY=(${compgen(RELEASE_MUTATION_FLAGS)})`,
         "      ;;",
@@ -282,10 +389,13 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         "complete -F _pm_completion pm",
     ].join("\n");
 }
-export function generateZshScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], eagerTagExpansion = false, runtime = {}) {
+export function generateZshScript(itemTypes = [], tags = [], eagerTagExpansion = false, runtime = {}) {
     const cmds = ALL_COMMANDS.map((c) => `'${c}'`).join(" ");
-    const typeChoices = itemTypes.join(" ");
-    const statusChoices = joinCompletionValues(runtime.statuses ?? DEFAULT_STATUS_VALUES);
+    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;
@@ -346,7 +456,7 @@ _pm_commands() {
     'history:Show item history entries'
     '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:Register custom item types into .agents/pm/schema/types.json'
+    'schema:Manage custom item types and statuses in .agents/pm/schema/*.json'
     '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'
@@ -354,6 +464,7 @@ _pm_commands() {
     'update-many:Bulk-update matched items with dry-run and rollback checkpoints'
     'normalize:Normalize lifecycle metadata with dry-run planning or apply mode'
     'close:Close an item with a required reason'
+    'close-many:Bulk-close matched items with a 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'
@@ -383,6 +494,8 @@ _pm_commands() {
   _describe 'command' commands
 }
 ${dynamicTagResolver}
+${useDynamicTypeExpansion ? renderZshDynamicChoiceResolver("type", "completion-types", typeFallbackChoices) : ""}
+${renderZshDynamicChoiceResolver("status", "completion-statuses", statusFallbackChoices)}
 
 _pm() {
   local context state line
@@ -409,6 +522,10 @@ _pm() {
             '--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' \\
+            '--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' \\
@@ -549,11 +666,16 @@ ${zshUpdateRuntimeFieldFlags}            '--allow-audit-update[Allow non-owner m
             '--filter-priority[Filter by priority before applying updates]:(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 applying updates]: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' \\
+            '--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]' \\
@@ -628,6 +750,42 @@ ${zshUpdateManyRuntimeFieldFlags}            '--allow-audit-update[Allow non-own
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
+        close-many)
+          _arguments \\
+            '--filter-status[Filter by status before closing]:(${statusChoices})' \\
+            '--filter-type[Filter by type before closing]:(${typeChoices})' \\
+            '--filter-tag[Filter by tag before closing]:(${zshTagChoices})' \\
+            '--filter-priority[Filter by priority before closing]:(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 closing]: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' \\
+            '--ids[Explicit comma-separated ID allowlist]:ids' \\
+            '--limit[Limit matched item count]:number' \\
+            '--offset[Skip first n matched rows]:number' \\
+            '--reason[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]'
+          ;;
         normalize)
           _arguments \\
             '--filter-status[Filter by status before planning or apply]:(${statusChoices})' \\
@@ -709,6 +867,7 @@ ${zshContextRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--mode[Search mode]:(keyword semantic hybrid)' \\
             '--include-linked[Include linked content in scoring]' \\
             '--limit[Max results]:number' \\
+            '--status[Filter by status (open/closed/canceled, csv)]:(${statusChoices})' \\
             '--type[Filter by type]:(${typeChoices})' \\
             '--tag[Filter by tag]:(${zshTagChoices})' \\
             '--priority[Filter by priority]:(0 1 2 3 4)' \\
@@ -727,7 +886,8 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--limit[Max entries]:number' \\
             '--compact[Condensed history projection]' \\
             '--full[Show full history entries]' \\
-            '--diff[Include changed-field patch summary]' \\
+            '--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]'
@@ -763,11 +923,13 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           ;;
         schema)
           _arguments \\
-            '1:subcommand:(add-type)' \\
-            '--description[Human description for the custom item type]:text' \\
+            '1:subcommand:(list show add-type remove-type add-status remove-status)' \\
+            '--description[Human description for the custom item type or status]: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 (repeatable)]:name' \\
+            '--alias[Alias for the custom type or status (repeatable)]:name' \\
+            '--role[Lifecycle role for a custom status (repeatable)]:role' \\
+            '--order[Display/sort order for a custom status]:n' \\
             '--author[Mutation author]:author' \\
             '--force[Force ownership/lock override]' \\
             '--json[Output JSON]' \\
@@ -827,7 +989,13 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
         gc)
           _arguments \\
             '--dry-run[Preview cleanup targets without deleting files]' \\
-            '--scope[Limit cleanup to one or more scopes]:scope' \\
+            '--scope[Limit cleanup to one or more scopes: index, embeddings, runtime, locks]:scope' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        stats)
+          _arguments \\
+            '--storage[Include aggregate history-stream storage metrics]' \\
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
@@ -944,6 +1112,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--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]' \\
@@ -957,6 +1126,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--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]' \\
@@ -1044,6 +1214,7 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--verbose-file-lists[Include full file-path lists for validate --check-files details]' \\
             '--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]' \\
             '--check-history-drift[Run item/history hash drift checks]' \\
             '--check-command-references[Run linked-command PM-ID reference checks]' \\
             '--json[Output JSON]' \\
@@ -1130,12 +1301,15 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
 
 compdef _pm pm`;
 }
-export function generateFishScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], eagerTagExpansion = false, runtime = {}) {
+export function generateFishScript(itemTypes = [], tags = [], eagerTagExpansion = false, runtime = {}) {
     const listCommandNames = ALL_COMMANDS.filter((command) => command === "list" || command.startsWith("list-"));
     const listCmds = listCommandNames.join(" ");
     const noSubcommandList = ALL_COMMANDS.join(" ");
-    const typeChoices = itemTypes.join(" ");
-    const statusChoices = joinCompletionValues(runtime.statuses ?? DEFAULT_STATUS_VALUES);
+    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;
@@ -1194,6 +1368,8 @@ function __pm_no_subcommand
   not __fish_seen_subcommand_from ${noSubcommandList}
 end
 ${dynamicTagResolver}
+${useDynamicTypeExpansion ? renderFishDynamicChoiceResolver("type", "completion-types", typeFallbackChoices) : ""}
+${renderFishDynamicChoiceResolver("status", "completion-statuses", statusFallbackChoices)}
 
 # Subcommands
 complete -c pm -n __pm_no_subcommand -a init          -d 'Initialize pm storage for the current workspace'
@@ -1221,7 +1397,7 @@ complete -c pm -n __pm_no_subcommand -a reindex       -d 'Rebuild search artifac
 complete -c pm -n __pm_no_subcommand -a history       -d 'Show item history entries'
 complete -c pm -n __pm_no_subcommand -a history-redact -d 'Redact sensitive literals/patterns and recompute history hashes'
 complete -c pm -n __pm_no_subcommand -a history-repair -d 'Re-anchor a drifted history chain so pm health/validate report ok'
-complete -c pm -n __pm_no_subcommand -a schema        -d 'Register custom item types into .agents/pm/schema/types.json'
+complete -c pm -n __pm_no_subcommand -a schema        -d 'Inspect and manage runtime schema'
 complete -c pm -n __pm_no_subcommand -a plan          -d 'Agent-optimized Plan workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)'
 complete -c pm -n __pm_no_subcommand -a activity      -d 'Show recent activity across items'
 complete -c pm -n __pm_no_subcommand -a restore       -d 'Restore an item to an earlier state'
@@ -1229,6 +1405,7 @@ complete -c pm -n __pm_no_subcommand -a update        -d 'Update item fields and
 complete -c pm -n __pm_no_subcommand -a update-many   -d 'Bulk-update matched items with dry-run and rollback checkpoints'
 complete -c pm -n __pm_no_subcommand -a normalize     -d 'Normalize lifecycle metadata with dry-run planning or apply mode'
 complete -c pm -n __pm_no_subcommand -a close         -d 'Close an item with a required reason'
+complete -c pm -n __pm_no_subcommand -a close-many    -d 'Bulk-close matched items with a shared reason and rollback checkpoint'
 complete -c pm -n __pm_no_subcommand -a delete        -d 'Delete an item and record the change'
 complete -c pm -n __pm_no_subcommand -a append        -d 'Append text to an item body'
 complete -c pm -n __pm_no_subcommand -a comments      -d 'List or add comments for an item'
@@ -1273,6 +1450,10 @@ for list_cmd in ${listCmds}
   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 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
 end
 ${fishListRuntimeFieldFlags}
 
@@ -1388,11 +1569,16 @@ complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-tag
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-priority         -d 'Filter by priority before applying updates' -r -a '0 1 2 3 4'
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-deadline-before  -d 'Filter by deadline upper bound' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-deadline-after   -d 'Filter by deadline lower bound' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-updated-after    -d 'Filter by updated_at lower bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-updated-before   -d 'Filter by updated_at upper bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-created-after    -d 'Filter by created_at lower bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-created-before   -d 'Filter by created_at upper bound (ISO/relative)' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-assignee         -d 'Filter by assignee before applying updates' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-assignee-filter  -d 'Filter assignee presence' -r -a 'assigned unassigned'
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-parent           -d 'Filter by parent item ID' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-sprint           -d 'Filter by sprint before applying updates' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-release          -d 'Filter by release before applying updates' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l ids                     -d 'Explicit comma-separated ID allowlist' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l limit                   -d 'Limit matched item count' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l offset                  -d 'Skip first n matched rows' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l dry-run                 -d 'Preview updates without mutating'
@@ -1491,6 +1677,7 @@ complete -c pm -n '__fish_seen_subcommand_from normalize' -l force
 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 include-linked -d 'Include linked content in scoring'
 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 priority       -d 'Filter by priority' -r -a '0 1 2 3 4'
@@ -1554,7 +1741,8 @@ complete -c pm -n '__fish_seen_subcommand_from get' -l fields -d 'Render custom
 complete -c pm -n '__fish_seen_subcommand_from history'  -l limit -d 'Max history entries' -r
 complete -c pm -n '__fish_seen_subcommand_from history'  -l compact -d 'Condensed history projection'
 complete -c pm -n '__fish_seen_subcommand_from history'  -l full -d 'Show full history entries'
-complete -c pm -n '__fish_seen_subcommand_from history'  -l diff -d 'Include changed-field patch summary'
+complete -c pm -n '__fish_seen_subcommand_from history'  -l diff -d 'Include per-entry field-level before/after value diffs'
+complete -c pm -n '__fish_seen_subcommand_from history'  -l field -d 'With --diff, show only entries that changed this field' -r
 complete -c pm -n '__fish_seen_subcommand_from history'  -l verify -d 'Verify history hash chain and replay integrity'
 complete -c pm -n '__fish_seen_subcommand_from history-redact' -l literal -d 'Literal string matcher to redact from history/item payloads' -r
 complete -c pm -n '__fish_seen_subcommand_from history-redact' -l regex -d 'Regex matcher to redact (/pattern/flags or raw pattern)' -r
@@ -1567,11 +1755,13 @@ complete -c pm -n '__fish_seen_subcommand_from history-repair' -l dry-run -d 'Pr
 complete -c pm -n '__fish_seen_subcommand_from history-repair' -l author -d 'Mutation author' -r
 complete -c pm -n '__fish_seen_subcommand_from history-repair' -l message -d 'Audit history message' -r
 complete -c pm -n '__fish_seen_subcommand_from history-repair' -l force -d 'Force ownership/lock override'
-complete -c pm -n '__fish_seen_subcommand_from schema' -a 'add-type' -d 'Schema subcommand'
-complete -c pm -n '__fish_seen_subcommand_from schema' -l description -d 'Human description for the custom item type' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -a 'list show add-type remove-type add-status remove-status' -d 'Schema subcommand'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l description -d 'Human description for the custom item type or status' -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 (repeatable)' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l alias -d 'Alias for the custom type or status (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 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 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'
@@ -1679,7 +1869,10 @@ complete -c pm -n '__fish_seen_subcommand_from test-runs' -l author -d 'Resume a
 
 # gc flags
 complete -c pm -n '__fish_seen_subcommand_from gc' -l dry-run -d 'Preview cleanup targets without deleting files'
-complete -c pm -n '__fish_seen_subcommand_from gc' -l scope -d 'Limit cleanup to index/embeddings/runtime scopes' -r
+complete -c pm -n '__fish_seen_subcommand_from gc' -l scope -d 'Limit cleanup to index/embeddings/runtime/locks scopes' -r
+
+# stats flags
+complete -c pm -n '__fish_seen_subcommand_from stats' -l storage -d 'Include aggregate history-stream storage metrics'
 
 # append flags
 complete -c pm -n '__fish_seen_subcommand_from append' -s b -l body -d 'Item body' -r
@@ -1702,6 +1895,39 @@ complete -c pm -n '__fish_seen_subcommand_from close' -l actual -d 'Short alias
 complete -c pm -n '__fish_seen_subcommand_from release' -l allow-audit-release -d 'Allow non-owner release handoffs without requiring --force'
 complete -c pm -n '__fish_seen_subcommand_from delete' -l dry-run -d 'Preview the item file that would be deleted without mutating'
 
+# close-many flags
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-status          -d 'Filter by status before closing' -r -a '${statusChoices}'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-type            -d 'Filter by type before closing' -r -a '${typeChoices}'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-tag             -d 'Filter by tag before closing' -r -a ${fishTagChoices}
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-priority        -d 'Filter by priority before closing' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-deadline-before -d 'Filter by deadline upper bound' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-deadline-after  -d 'Filter by deadline lower bound' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-updated-after   -d 'Filter by updated_at lower bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-updated-before  -d 'Filter by updated_at upper bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-created-after   -d 'Filter by created_at lower bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-created-before  -d 'Filter by created_at upper bound (ISO/relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-assignee        -d 'Filter by assignee before closing' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-parent          -d 'Filter by parent item ID' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-sprint          -d 'Filter by sprint before closing' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-release         -d 'Filter by release before closing' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l ids                    -d 'Explicit comma-separated ID allowlist' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l limit                  -d 'Limit matched item count' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l offset                 -d 'Skip first n matched rows' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l reason                 -d 'Shared close reason applied to every matched item' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l resolution             -d 'Shared closure resolution' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l expected-result        -d 'Shared expected-result note' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l actual-result          -d 'Shared actual-result note' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l expected               -d 'Short alias for --expected-result' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l actual                 -d 'Short alias for --actual-result' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l validate-close         -d 'Validate closure metadata per item' -r -a 'off warn strict'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l author                 -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l message                -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l force                  -d 'Re-close terminal matches and override ownership'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l dry-run                -d 'Preview matched items without mutating'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l rollback               -d 'Rollback checkpoint ID' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l no-checkpoint          -d 'Disable checkpoint creation during apply mode'
+
 # validate flags
 complete -c pm -n '__fish_seen_subcommand_from validate' -l check-metadata -d 'Run metadata completeness checks'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l metadata-profile -d 'Select metadata validation profile for --check-metadata' -r -a 'core strict custom'
@@ -1715,6 +1941,7 @@ complete -c pm -n '__fish_seen_subcommand_from validate' -l include-pm-internals
 complete -c pm -n '__fish_seen_subcommand_from validate' -l verbose-file-lists -d 'Include full file-path lists for validate --check-files details'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l strict-exit -d 'Return non-zero exit when validation warnings are present'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l fail-on-warn -d 'Alias for --strict-exit'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l fix-hints -d 'Add a machine-executable fix_hints[] of pm commands to each failing check'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l check-history-drift -d 'Run item/history hash drift checks'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l check-command-references -d 'Run linked-command PM-ID reference checks'
 complete -c pm -n '__fish_seen_subcommand_from init' -l preset -d 'Governance preset for new setups' -r -a 'minimal default strict'
@@ -1722,6 +1949,7 @@ complete -c pm -n '__fish_seen_subcommand_from init' -l defaults -d 'Use non-int
 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
@@ -1791,7 +2019,7 @@ const SETUP_HINTS = {
     zsh: 'Add to ~/.zshrc: eval "$(pm completion zsh)"',
     fish: "Run: pm completion fish > ~/.config/fish/completions/pm.fish",
 };
-export function runCompletion(shell, itemTypes = DEFAULT_ITEM_TYPES, tags = [], eagerTagExpansion = false, runtime = {}) {
+export 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);
@@ -1814,4 +2042,4 @@ export function runCompletion(shell, itemTypes = DEFAULT_ITEM_TYPES, tags = [],
     };
 }
 //# sourceMappingURL=completion.js.map
-//# debugId=56ca52a0-bad8-57a6-af37-8b54538f07fa
+//# debugId=62701936-e5db-51ae-87a7-d448b11c7e5f