@unbrained/pm-cli 2026.5.18 → 2026.5.27

package/dist/cli/commands/completion.js

@@ -1,5 +1,5 @@
 
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="f31aa5f9-6785-5b5e-9c34-167ef6e9f543")}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]="b3284398-1103-5eb4-9c3d-028c20dfa304")}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";
@@ -29,9 +29,10 @@ const PLAN_SUBCOMMANDS_LIST = "create show add-step update-step complete-step bl
 const COMPLETION_FLAGS = toCompletionFlagString(COMPLETION_FLAG_CONTRACTS);
 const COMPLETION_SHELL_CHOICES = `${COMPLETION_FLAGS} bash zsh fish`;
 const GUIDE_TOPIC_CHOICES = joinCompletionValues(listGuideTopicIds());
-const MUTATION_FLAGS = "--author --message --force --json --quiet --path --no-extensions --no-pager --profile --help";
-const CLOSE_MUTATION_FLAGS = "--author --message --validate-close --force --json --quiet --path --no-extensions --no-pager --profile --help";
-const RELEASE_MUTATION_FLAGS = "--allow-audit-release --author --message --force --json --quiet --path --no-extensions --no-pager --profile --help";
+const MUTATION_FLAGS = "--author --message --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help";
+const DELETE_MUTATION_FLAGS = "--dry-run --author --message --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help";
+const CLOSE_MUTATION_FLAGS = "--author --message --validate-close --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help";
+const RELEASE_MUTATION_FLAGS = "--allow-audit-release --author --message --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help";
 const GLOBAL_FLAGS = GLOBAL_FLAG_CONTRACTS.flatMap((entry) => [entry.short, entry.flag])
     .filter((value) => Boolean(value))
     .join(" ");
@@ -44,6 +45,33 @@ 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")}\n`;
+}
+function renderFishRuntimeFieldFlagSpecs(commands, runtimeFlags) {
+    const normalizedFlags = normalizeRuntimeCompletionFlags(runtimeFlags).map((flag) => flag.slice(2));
+    if (commands.length === 0 || normalizedFlags.length === 0) {
+        return "";
+    }
+    const lines = [];
+    for (const command of commands) {
+        for (const flag of normalizedFlags) {
+            lines.push(`complete -c pm -n '__fish_seen_subcommand_from ${command}' -l ${flag} -d 'Runtime schema field flag' -r`);
+        }
+    }
+    return `${lines.join("\n")}\n`;
+}
 export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], eagerTagExpansion = false, runtime = {}) {
     const cmds = ALL_COMMANDS.join(" ");
     const typeValues = itemTypes.join(" ");
@@ -119,10 +147,10 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         `      COMPREPLY=(${compgen(listFlags)})`,
         "      ;;",
         "    aggregate)",
-        `      COMPREPLY=(${compgen("--group-by --count --include-unparented --status --type --tag --priority --deadline-before --deadline-after --assignee --assignee-filter --parent --sprint --release --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--group-by --count --include-unparented --status --type --tag --priority --deadline-before --deadline-after --assignee --assignee-filter --parent --sprint --release --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    dedupe-audit)",
-        `      COMPREPLY=(${compgen("--mode --limit --threshold --status --type --tag --priority --deadline-before --deadline-after --assignee --assignee-filter --parent --sprint --release --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--mode --limit --threshold --status --type --tag --priority --deadline-before --deadline-after --assignee --assignee-filter --parent --sprint --release --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    create)",
         `      COMPREPLY=(${compgen(createFlags)})`,
@@ -149,34 +177,34 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         `      COMPREPLY=(${compgen(searchFlags)})`,
         "      ;;",
         "    reindex)",
-        `      COMPREPLY=(${compgen("--mode --progress --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--mode --progress --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    init)",
-        `      COMPREPLY=(${compgen(`${INIT_FLAGS} --json --quiet --path --no-extensions --no-pager --profile --help`)})`,
+        `      COMPREPLY=(${compgen(`${INIT_FLAGS} --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help`)})`,
         "      ;;",
         "    config)",
-        `      COMPREPLY=(${compgen("--criterion --clear-criteria --format --policy --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--criterion --clear-criteria --format --policy --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    extension)",
-        `      COMPREPLY=(${compgen("init scaffold install uninstall explore manage reload doctor adopt adopt-all activate deactivate --init --scaffold --install --uninstall --explore --manage --reload --watch --doctor --adopt --adopt-all --activate --deactivate --project --local --global --gh --github --ref --detail --trace --runtime-probe --fix-managed-state --strict-exit --fail-on-warn --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("init scaffold install uninstall explore manage reload doctor adopt adopt-all activate deactivate --init --scaffold --install --uninstall --explore --manage --reload --watch --doctor --adopt --adopt-all --activate --deactivate --project --local --global --gh --github --ref --detail --trace --runtime-probe --fix-managed-state --strict-exit --fail-on-warn --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    comments)",
-        `      COMPREPLY=(${compgen("--add --stdin --file --limit --author --message --allow-audit-comment --force --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--add --stdin --file --limit --author --message --allow-audit-comment --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    comments-audit)",
-        `      COMPREPLY=(${compgen("--status --type --tag --priority --parent --sprint --release --assignee --assignee-filter --limit-items --limit --full-history --latest --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--status --type --tag --priority --parent --sprint --release --assignee --assignee-filter --limit-items --limit --full-history --latest --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    notes)",
-        `      COMPREPLY=(${compgen("--add --limit --author --message --allow-audit-note --allow-audit-comment --force --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--add --limit --author --message --allow-audit-note --allow-audit-comment --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    learnings)",
-        `      COMPREPLY=(${compgen("--add --limit --author --message --allow-audit-learning --allow-audit-comment --force --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--add --limit --author --message --allow-audit-learning --allow-audit-comment --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    files)",
-        `      COMPREPLY=(${compgen("discover --add --add-glob --remove --migrate --list --apply --note --append-stable --validate-paths --audit --author --message --force --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("discover --add --add-glob --remove --migrate --list --apply --note --append-stable --validate-paths --audit --author --message --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    docs)",
-        `      COMPREPLY=(${compgen("--add --add-glob --remove --migrate --validate-paths --audit --author --message --force --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--add --add-glob --remove --migrate --validate-paths --audit --author --message --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    append)",
         `      COMPREPLY=(${compgen(APPEND_FLAGS)})`,
@@ -185,25 +213,34 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         `      COMPREPLY=(${compgen(DEPS_FLAGS)})`,
         "      ;;",
         "    test)",
-        `      COMPREPLY=(${compgen("--add --remove --run --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 --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--add --remove --run --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 --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 --path --no-extensions --no-pager --profile --help")})`,
+        `      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 --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    test-runs)",
-        `      COMPREPLY=(${compgen("list status logs stop resume --status --limit --stream --tail --force --author --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      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 --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 --strict-exit --fail-on-warn --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 --diff --verify --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--limit --compact --full --diff --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")})`,
         "      ;;",
         "    history-redact)",
-        `      COMPREPLY=(${compgen("--literal --regex --replacement --dry-run --author --message --force --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--literal --regex --replacement --dry-run --author --message --force --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
+        "      ;;",
+        "    history-repair)",
+        `      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")})`,
         "      ;;",
         "    plan)",
         `      COMPREPLY=(${compgen(`${PLAN_SUBCOMMANDS_LIST} ${PLAN_FLAGS}`)})`,
@@ -215,7 +252,7 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         `      COMPREPLY=(${compgen(CONTRACTS_FLAGS)})`,
         "      ;;",
         "    gc)",
-        `      COMPREPLY=(${compgen("--dry-run --scope --json --quiet --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--dry-run --scope --json --quiet --no-changed-fields --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    close|close-task)",
         `      COMPREPLY=(${compgen(CLOSE_MUTATION_FLAGS)})`,
@@ -223,7 +260,10 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
         "    release)",
         `      COMPREPLY=(${compgen(RELEASE_MUTATION_FLAGS)})`,
         "      ;;",
-        "    claim|delete|restore|start-task|pause-task)",
+        "    delete)",
+        `      COMPREPLY=(${compgen(DELETE_MUTATION_FLAGS)})`,
+        "      ;;",
+        "    claim|restore|start-task|pause-task)",
         `      COMPREPLY=(${compgen(MUTATION_FLAGS)})`,
         "      ;;",
         "    completion)",
@@ -242,13 +282,21 @@ 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) {
+export function generateZshScript(itemTypes = DEFAULT_ITEM_TYPES, 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 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 zshUpdateRuntimeFieldFlags = renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.update);
+    const zshUpdateManyRuntimeFieldFlags = renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.["update-many"]);
+    const zshSearchRuntimeFieldFlags = renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.search);
+    const zshCalendarRuntimeFieldFlags = renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.calendar);
+    const zshContextRuntimeFieldFlags = renderZshRuntimeFieldFlagSpecs(runtime.command_flags?.context);
     const dynamicTagResolver = useEagerTagExpansion
         ? ""
         : `
@@ -297,6 +345,8 @@ _pm_commands() {
     'reindex:Rebuild search artifacts'
     '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'
     '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'
@@ -339,6 +389,7 @@ _pm() {
   _arguments -C \\
     '--json[Output JSON instead of TOON]' \\
     '--quiet[Suppress stdout output]' \\
+    '--no-changed-fields[Omit changed_fields array from mutation output]' \\
     '--path[Override PM path for this command]:path:_files -/' \\
     '--no-extensions[Disable extension loading]' \\
     '--no-pager[Disable pager integration for help and long output]' \\
@@ -370,7 +421,7 @@ _pm() {
             '--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)]' \\
-            '--json[Output JSON]' \\
+${zshListRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--quiet[Suppress stdout]' \\
             '--path[Override PM path]:path:_files -/'
           ;;
@@ -379,7 +430,7 @@ _pm() {
             '--group-by[Comma-separated group-by fields (supported: parent,type,priority,status,assignee,tags,sprint,release)]:fields' \\
             '--count[Return grouped counts]' \\
             '--include-unparented[Include unparented rows when grouping by parent]' \\
-            '--status[Filter by status]:(draft open in_progress blocked closed canceled)' \\
+            '--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)' \\
@@ -398,7 +449,7 @@ _pm() {
             '--mode[Dedupe mode]:(title_exact title_fuzzy parent_scope)' \\
             '--limit[Limit returned duplicate clusters]:number' \\
             '--threshold[Fuzzy mode token similarity threshold between 0 and 1]:number' \\
-            '--status[Filter by status]:(draft open in_progress blocked closed canceled)' \\
+            '--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)' \\
@@ -419,14 +470,14 @@ _pm() {
             '--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]:(draft open in_progress blocked)' \\
+            '(-s --status)'{-s,--status}'[Item status]:(${statusChoices})' \\
             '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
             '--tags[Comma-separated tags]:tags' \\
             '(-b --body)'{-b,--body}'[Item body]:body' \\
             '--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>,text=<text>]:reminder' \\
+            '--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' \\
@@ -445,7 +496,7 @@ _pm() {
             '--author[Mutation author]:author' \\
             '--message[History message]:message' \\
             '--assignee[Assignee]:assignee' \\
-            '--json[Output JSON]' \\
+${zshCreateRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
         update)
@@ -453,7 +504,7 @@ _pm() {
             '(-t --title)'{-t,--title}'[Item title]:title' \\
             '(-d --description)'{-d,--description}'[Item description]:description' \\
             '(-b --body)'{-b,--body}'[Item body]:body' \\
-            '(-s --status)'{-s,--status}'[Item status]:(draft open in_progress blocked canceled)' \\
+            '(-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})' \\
@@ -464,7 +515,7 @@ _pm() {
             '--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>,text=<text>]:reminder' \\
+            '--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' \\
@@ -478,7 +529,7 @@ _pm() {
             '--clear-reminders[Clear reminders]' \\
             '--clear-events[Clear events]' \\
             '--clear-type-options[Clear type options]' \\
-            '--allow-audit-update[Allow non-owner metadata-only audit updates without requiring --force]' \\
+${zshUpdateRuntimeFieldFlags}            '--allow-audit-update[Allow non-owner metadata-only audit updates without requiring --force]' \\
             '--author[Mutation author]:author' \\
             '--message[History message]:message' \\
             '--force[Force override]' \\
@@ -487,7 +538,7 @@ _pm() {
           ;;
         update-many)
           _arguments \\
-            '--filter-status[Filter by status before applying updates]:(draft open in_progress blocked closed canceled)' \\
+            '--filter-status[Filter by status before applying updates]:(${statusChoices})' \\
             '--filter-type[Filter by type before applying updates]:(${typeChoices})' \\
             '--filter-tag[Filter by tag before applying updates]:(${zshTagChoices})' \\
             '--filter-priority[Filter by priority before applying updates]:(0 1 2 3 4)' \\
@@ -547,7 +598,7 @@ _pm() {
             '--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>,text=<text>]:reminder' \\
+            '--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' \\
@@ -561,7 +612,7 @@ _pm() {
             '--clear-reminders[Clear reminders]' \\
             '--clear-events[Clear events]' \\
             '--clear-type-options[Clear type options]' \\
-            '--allow-audit-update[Allow non-owner metadata-only audit updates without requiring --force]' \\
+${zshUpdateManyRuntimeFieldFlags}            '--allow-audit-update[Allow non-owner metadata-only audit updates without requiring --force]' \\
             '--author[Mutation author]:author' \\
             '--message[History message]:message' \\
             '--force[Force override]' \\
@@ -570,7 +621,7 @@ _pm() {
           ;;
         normalize)
           _arguments \\
-            '--filter-status[Filter by status before planning or apply]:(draft open in_progress blocked closed canceled)' \\
+            '--filter-status[Filter by status before planning or apply]:(${statusChoices})' \\
             '--filter-type[Filter by type before planning or apply]:(${typeChoices})' \\
             '--filter-tag[Filter by tag before planning or apply]:(${zshTagChoices})' \\
             '--filter-priority[Filter by priority before planning or apply]:(0 1 2 3 4)' \\
@@ -603,12 +654,12 @@ _pm() {
             '--type[Filter by type]:(${typeChoices})' \\
             '--tag[Filter by tag]:(${zshTagChoices})' \\
             '--priority[Filter by priority]:(0 1 2 3 4)' \\
-            '--status[Filter by status]:(draft open in_progress blocked closed canceled)' \\
+            '--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' \\
-            '--include[Include event sources]:(all deadlines reminders events)' \\
+${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' \\
@@ -632,7 +683,7 @@ _pm() {
             '--release[Filter by release]:release' \\
             '--limit[Limit focus and agenda rows per section]:number' \\
             '--format[Output override]:(markdown toon json)' \\
-            '--json[Output JSON]' \\
+${zshContextRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
         guide)
@@ -652,7 +703,7 @@ _pm() {
             '--type[Filter by type]:(${typeChoices})' \\
             '--tag[Filter by tag]:(${zshTagChoices})' \\
             '--priority[Filter by priority]:(0 1 2 3 4)' \\
-            '--json[Output JSON]' \\
+${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
         reindex)
@@ -665,11 +716,21 @@ _pm() {
         history)
           _arguments \\
             '--limit[Max entries]:number' \\
+            '--compact[Condensed history projection]' \\
+            '--full[Show full history entries]' \\
             '--diff[Include changed-field patch summary]' \\
             '--verify[Verify history hash chain and replay integrity]' \\
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
+        get)
+          _arguments \\
+            '--depth[Detail depth]:(brief standard deep)' \\
+            '--full[Explicit full item read]' \\
+            '--fields[Render custom comma-separated item fields]:fields' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
         history-redact)
           _arguments \\
             '--literal[Literal string matcher to redact from history/item payloads]:literal' \\
@@ -682,6 +743,27 @@ _pm() {
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
+        history-repair)
+          _arguments \\
+            '--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)
+          _arguments \\
+            '1:subcommand:(add-type)' \\
+            '--description[Human description for the custom item type]: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' \\
+            '--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)' \\
@@ -715,6 +797,8 @@ _pm() {
             '--from[Lower timestamp bound (ISO/date string or relative)]:date' \\
             '--to[Upper timestamp bound (ISO/date string or relative)]:date' \\
             '--limit[Max entries]:number' \\
+            '--compact[Condensed activity projection]' \\
+            '--full[Show full activity entries]' \\
             '--stream[Emit line-delimited JSON rows]:mode' \\
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
@@ -852,6 +936,7 @@ _pm() {
             '--author[Set the default mutation author for this project]:author' \\
             '--agent-guidance[Agent guidance mode]:mode:(ask add skip status)' \\
             '--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]'
           ;;
@@ -864,6 +949,7 @@ _pm() {
             '--author[Set the default mutation author for this project]:author' \\
             '--agent-guidance[Agent guidance mode]:mode:(ask add skip status)' \\
             '--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]'
           ;;
@@ -902,6 +988,15 @@ _pm() {
             '--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]'
+          ;;
         start-task|pause-task)
           _arguments \\
             '--author[Mutation author]:author' \\
@@ -945,6 +1040,8 @@ _pm() {
             '--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]' \\
+            '--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]' \\
@@ -952,7 +1049,7 @@ _pm() {
           ;;
         comments-audit)
           _arguments \\
-            '--status[Filter by item status]:status:(draft open in_progress blocked closed canceled)' \\
+            '--status[Filter by item status]:status:(${statusChoices})' \\
             '--type[Filter by item type]:(${typeChoices})' \\
             '--tag[Filter by tag]:(${zshTagChoices})' \\
             '--priority[Filter by priority]:(0 1 2 3 4)' \\
@@ -1017,14 +1114,23 @@ _pm() {
 
 compdef _pm pm`;
 }
-export function generateFishScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], eagerTagExpansion = false) {
-    const listCmds = ALL_COMMANDS.filter((command) => command === "list" || command.startsWith("list-")).join(" ");
+export function generateFishScript(itemTypes = DEFAULT_ITEM_TYPES, 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 guideTopicChoices = GUIDE_TOPIC_CHOICES;
     const tagChoices = joinCompletionValues(tags);
     const useEagerTagExpansion = eagerTagExpansion || tags.length > 0;
     const fishTagChoices = useEagerTagExpansion ? `'${tagChoices}'` : "'(__pm_tag_choices)'";
+    const fishListRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(listCommandNames, runtime.command_flags?.list);
+    const fishCreateRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(["create"], runtime.command_flags?.create);
+    const fishUpdateRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(["update"], runtime.command_flags?.update);
+    const fishUpdateManyRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(["update-many"], runtime.command_flags?.["update-many"]);
+    const fishSearchRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(["search"], runtime.command_flags?.search);
+    const fishCalendarRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(["calendar", "cal"], runtime.command_flags?.calendar);
+    const fishContextRuntimeFieldFlags = renderFishRuntimeFieldFlagSpecs(["context", "ctx"], runtime.command_flags?.context);
     const dynamicTagResolver = useEagerTagExpansion
         ? ""
         : `
@@ -1060,6 +1166,7 @@ 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 quiet -d 'Suppress stdout output'
+complete -c pm -l no-changed-fields -d 'Omit changed_fields array from mutation output'
 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'
@@ -1097,6 +1204,8 @@ complete -c pm -n __pm_no_subcommand -a search        -d 'Search items with keyw
 complete -c pm -n __pm_no_subcommand -a reindex       -d 'Rebuild search artifacts'
 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 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'
@@ -1149,12 +1258,13 @@ for list_cmd in ${listCmds}
   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
 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 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 'draft open in_progress blocked closed canceled'
+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'
@@ -1170,7 +1280,7 @@ complete -c pm -n '__fish_seen_subcommand_from aggregate' -l release -d 'Filter
 complete -c pm -n '__fish_seen_subcommand_from dedupe-audit' -l mode -d 'Dedupe mode' -r -a 'title_exact title_fuzzy parent_scope'
 complete -c pm -n '__fish_seen_subcommand_from dedupe-audit' -l limit -d 'Limit returned duplicate clusters' -r
 complete -c pm -n '__fish_seen_subcommand_from dedupe-audit' -l threshold -d 'Fuzzy mode token similarity threshold between 0 and 1' -r
-complete -c pm -n '__fish_seen_subcommand_from dedupe-audit' -l status -d 'Filter by status' -r -a 'draft open in_progress blocked closed canceled'
+complete -c pm -n '__fish_seen_subcommand_from dedupe-audit' -l status -d 'Filter by status' -r -a '${statusChoices}'
 complete -c pm -n '__fish_seen_subcommand_from dedupe-audit' -l type -d 'Filter by item type' -r -a '${typeChoices}'
 complete -c pm -n '__fish_seen_subcommand_from dedupe-audit' -l tag -d 'Filter by tag' -r -a ${fishTagChoices}
 complete -c pm -n '__fish_seen_subcommand_from dedupe-audit' -l priority -d 'Filter by priority' -r -a '0 1 2 3 4'
@@ -1188,14 +1298,14 @@ complete -c pm -n '__fish_seen_subcommand_from create' -s d -l description
 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 'draft open in_progress blocked'
+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' -s b -l body               -d 'Item body' -r
 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>,text=<text>' -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
@@ -1212,12 +1322,13 @@ complete -c pm -n '__fish_seen_subcommand_from create' -l clear-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}
 
 # update flags
 complete -c pm -n '__fish_seen_subcommand_from update' -s t -l title              -d 'Item title' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -s d -l description        -d 'Item description' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -s b -l body               -d 'Item body' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -s s -l status             -d 'Item status' -r -a 'draft open in_progress blocked canceled'
+complete -c pm -n '__fish_seen_subcommand_from update' -s s -l status             -d 'Item status' -r -a '${statusChoices}'
 complete -c pm -n '__fish_seen_subcommand_from update' -l close-reason            -d 'Set close reason' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
 complete -c pm -n '__fish_seen_subcommand_from update' -l type                    -d 'Item type' -r -a '${typeChoices}'
@@ -1227,7 +1338,7 @@ complete -c pm -n '__fish_seen_subcommand_from update' -l learning
 complete -c pm -n '__fish_seen_subcommand_from update' -l file                    -d 'Linked file path=<value>,scope=<project|global>,note=<text>' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -l test                    -d 'Linked test command=<value>,path=<value>,scope=<project|global>' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -l doc                     -d 'Linked doc path=<value>,scope=<project|global>,note=<text>' -r
-complete -c pm -n '__fish_seen_subcommand_from update' -l reminder                -d 'Reminder entry at=<iso|relative>,text=<text>' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l reminder                -d 'Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -l event                   -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -l type-option             -d 'Type option key=value or key=<name>,value=<value>' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -l unset                   -d 'Clear scalar metadata field by name' -r
@@ -1247,9 +1358,10 @@ complete -c pm -n '__fish_seen_subcommand_from update' -l allow-audit-update
 complete -c pm -n '__fish_seen_subcommand_from update' -l author                  -d 'Mutation author' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -l message                 -d 'History message' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -l force                   -d 'Force override'
+${fishUpdateRuntimeFieldFlags}
 
 # update-many flags
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-status           -d 'Filter by status before applying updates' -r -a 'draft open in_progress blocked closed canceled'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-status           -d 'Filter by status before applying updates' -r -a '${statusChoices}'
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-type             -d 'Filter by type before applying updates' -r -a '${typeChoices}'
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-tag              -d 'Filter by tag before applying updates' -r -a ${fishTagChoices}
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-priority         -d 'Filter by priority before applying updates' -r -a '0 1 2 3 4'
@@ -1309,7 +1421,7 @@ complete -c pm -n '__fish_seen_subcommand_from update-many' -l learning
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l file                    -d 'Linked file path=<value>,scope=<project|global>,note=<text>' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l test                    -d 'Linked test command=<value>,path=<value>,scope=<project|global>' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l doc                     -d 'Linked doc path=<value>,scope=<project|global>,note=<text>' -r
-complete -c pm -n '__fish_seen_subcommand_from update-many' -l reminder                -d 'Reminder entry at=<iso|relative>,text=<text>' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l reminder                -d 'Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l event                   -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l type-option             -d 'Type option key=value or key=<name>,value=<value>' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l unset                   -d 'Clear scalar metadata field by name' -r
@@ -1327,9 +1439,10 @@ complete -c pm -n '__fish_seen_subcommand_from update-many' -l allow-audit-updat
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l author                  -d 'Mutation author' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l message                 -d 'History message' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l force                   -d 'Force override'
+${fishUpdateManyRuntimeFieldFlags}
 
 # normalize flags
-complete -c pm -n '__fish_seen_subcommand_from normalize' -l filter-status           -d 'Filter by status before planning or apply' -r -a 'draft open in_progress blocked closed canceled'
+complete -c pm -n '__fish_seen_subcommand_from normalize' -l filter-status           -d 'Filter by status before planning or apply' -r -a '${statusChoices}'
 complete -c pm -n '__fish_seen_subcommand_from normalize' -l filter-type             -d 'Filter by type before planning or apply' -r -a '${typeChoices}'
 complete -c pm -n '__fish_seen_subcommand_from normalize' -l filter-tag              -d 'Filter by tag before planning or apply' -r -a ${fishTagChoices}
 complete -c pm -n '__fish_seen_subcommand_from normalize' -l filter-priority         -d 'Filter by priority before planning or apply' -r -a '0 1 2 3 4'
@@ -1356,6 +1469,7 @@ complete -c pm -n '__fish_seen_subcommand_from search' -l limit          -d 'Max
 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'
+${fishSearchRuntimeFieldFlags}
 
 # calendar flags
 complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l view      -d 'Calendar view' -r -a 'agenda day week month'
@@ -1367,17 +1481,18 @@ complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l full-period -d '
 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 'draft open in_progress blocked closed canceled'
+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'
+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 '__fish_seen_subcommand_from context ctx' -l date      -d 'Anchor date/time (ISO/date string or relative)' -r
@@ -1393,6 +1508,7 @@ complete -c pm -n '__fish_seen_subcommand_from context ctx' -l sprint    -d 'Fil
 complete -c pm -n '__fish_seen_subcommand_from context ctx' -l release   -d 'Filter by release' -r
 complete -c pm -n '__fish_seen_subcommand_from context ctx' -l limit     -d 'Limit focus and agenda rows per section' -r
 complete -c pm -n '__fish_seen_subcommand_from context ctx' -l format    -d 'Output override' -r -a 'markdown toon json'
+${fishContextRuntimeFieldFlags}
 
 # guide flags
 complete -c pm -n '__fish_seen_subcommand_from guide' -l list      -d 'Show guide topic index'
@@ -1404,8 +1520,15 @@ complete -c pm -n '__fish_seen_subcommand_from guide' -a '${guideTopicChoices}'
 complete -c pm -n '__fish_seen_subcommand_from reindex' -l mode -d 'Reindex mode' -r -a 'keyword semantic hybrid'
 complete -c pm -n '__fish_seen_subcommand_from reindex' -l progress -d 'Emit progress updates to stderr'
 
+# get flags
+complete -c pm -n '__fish_seen_subcommand_from get' -l depth -d 'Detail depth' -r -a 'brief standard deep'
+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
+
 # history / activity flags
 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 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
@@ -1415,6 +1538,17 @@ complete -c pm -n '__fish_seen_subcommand_from history-redact' -l dry-run -d 'Pr
 complete -c pm -n '__fish_seen_subcommand_from history-redact' -l author -d 'Mutation author' -r
 complete -c pm -n '__fish_seen_subcommand_from history-redact' -l message -d 'Audit history message' -r
 complete -c pm -n '__fish_seen_subcommand_from history-redact' -l force -d 'Force ownership/lock override'
+complete -c pm -n '__fish_seen_subcommand_from history-repair' -l dry-run -d 'Preview the re-anchor impact without writing the history file'
+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' -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 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'
 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
@@ -1441,6 +1575,8 @@ complete -c pm -n '__fish_seen_subcommand_from activity' -l author -d 'Filter by
 complete -c pm -n '__fish_seen_subcommand_from activity' -l from -d 'Lower timestamp bound (ISO/date string or relative)' -r
 complete -c pm -n '__fish_seen_subcommand_from activity' -l to -d 'Upper timestamp bound (ISO/date string or relative)' -r
 complete -c pm -n '__fish_seen_subcommand_from activity' -l limit -d 'Max activity entries' -r
+complete -c pm -n '__fish_seen_subcommand_from activity' -l compact -d 'Condensed activity projection'
+complete -c pm -n '__fish_seen_subcommand_from activity' -l full -d 'Show full activity entries'
 complete -c pm -n '__fish_seen_subcommand_from activity' -l stream -d 'Emit line-delimited JSON rows'
 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
@@ -1527,11 +1663,12 @@ complete -c pm -n '__fish_seen_subcommand_from append' -l message -d 'History me
 complete -c pm -n '__fish_seen_subcommand_from append' -l force -d 'Force override'
 
 # close flags
-complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task' -l author -d 'Mutation author' -r
-complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task' -l message -d 'History message' -r
-complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task' -l force -d 'Force override'
+complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l message -d 'History message' -r
+complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l force -d 'Force override'
 complete -c pm -n '__fish_seen_subcommand_from close close-task' -l validate-close -d 'Validate closure metadata mode' -r -a 'off warn strict'
 complete -c pm -n '__fish_seen_subcommand_from 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'
 
 # validate flags
 complete -c pm -n '__fish_seen_subcommand_from validate' -l check-metadata -d 'Run metadata completeness checks'
@@ -1554,6 +1691,7 @@ complete -c pm -n '__fish_seen_subcommand_from init' -s y -l yes -d 'Alias for -
 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 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'
@@ -1563,9 +1701,11 @@ complete -c pm -n '__fish_seen_subcommand_from health' -l check-only -d 'Run rea
 complete -c pm -n '__fish_seen_subcommand_from health' -l no-refresh -d 'Disable automatic vector refresh attempts during health checks'
 complete -c pm -n '__fish_seen_subcommand_from health' -l refresh-vectors -d 'Explicitly enable vector refresh attempts during health checks'
 complete -c pm -n '__fish_seen_subcommand_from health' -l verbose-stale-items -d 'Include full stale vectorization ID lists in health output'
+complete -c pm -n '__fish_seen_subcommand_from health' -l brief -d 'Emit compact health details for low-token agent checks'
+complete -c pm -n '__fish_seen_subcommand_from health' -l summary -d 'Emit one-line-style health status with check names and warning count'
 complete -c pm -n '__fish_seen_subcommand_from health' -l strict-exit -d 'Return non-zero exit when health warnings are present'
 complete -c pm -n '__fish_seen_subcommand_from health' -l fail-on-warn -d 'Alias for --strict-exit'
-complete -c pm -n '__fish_seen_subcommand_from comments-audit' -l status -d 'Filter by item status' -r -a 'draft open in_progress blocked closed canceled'
+complete -c pm -n '__fish_seen_subcommand_from comments-audit' -l status -d 'Filter by item status' -r -a '${statusChoices}'
 complete -c pm -n '__fish_seen_subcommand_from comments-audit' -l type -d 'Filter by item type' -r -a '${typeChoices}'
 complete -c pm -n '__fish_seen_subcommand_from comments-audit' -l tag -d 'Filter by tag' -r -a ${fishTagChoices}
 complete -c pm -n '__fish_seen_subcommand_from comments-audit' -l priority -d 'Filter by priority' -r -a '0 1 2 3 4'
@@ -1630,10 +1770,10 @@ export function runCompletion(shell, itemTypes = DEFAULT_ITEM_TYPES, tags = [],
         script = generateBashScript(itemTypes, tags, eagerTagExpansion, runtime);
     }
     else if (validShell === "zsh") {
-        script = generateZshScript(itemTypes, tags, eagerTagExpansion);
+        script = generateZshScript(itemTypes, tags, eagerTagExpansion, runtime);
     }
     else {
-        script = generateFishScript(itemTypes, tags, eagerTagExpansion);
+        script = generateFishScript(itemTypes, tags, eagerTagExpansion, runtime);
     }
     return {
         shell: validShell,
@@ -1642,4 +1782,4 @@ export function runCompletion(shell, itemTypes = DEFAULT_ITEM_TYPES, tags = [],
     };
 }
 //# sourceMappingURL=completion.js.map
-//# debugId=f31aa5f9-6785-5b5e-9c34-167ef6e9f543
+//# debugId=b3284398-1103-5eb4-9c3d-028c20dfa304