@unbrained/pm-cli 2026.6.13 → 2026.6.17

package/dist/cli/commands/completion.js

@@ -1,8 +1,8 @@
 
-!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]="78557caa-254b-5c20-a792-78be2b6c9de3")}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]="2f331396-9d67-51d7-a763-3ade7ab92864")}catch(e){}}();
 import { EXIT_CODE } from "../../core/shared/constants.js";
 import { PmCliError } from "../../core/shared/errors.js";
-import { AGGREGATE_FLAG_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GET_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 { AGGREGATE_FLAG_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, CONTEXT_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, MEET_FLAG_CONTRACTS, REMIND_FLAG_CONTRACTS, CREATE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GET_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"];
@@ -13,6 +13,9 @@ const LIST_FLAGS = toCompletionFlagString(LIST_FILTER_FLAG_CONTRACTS);
 const AGGREGATE_FLAGS = toCompletionFlagString(AGGREGATE_FLAG_CONTRACTS);
 const APPEND_FLAGS = toCompletionFlagString(APPEND_FLAG_CONTRACTS);
 const COPY_FLAGS = toCompletionFlagString(COPY_FLAG_CONTRACTS);
+const FOCUS_FLAGS = toCompletionFlagString(FOCUS_FLAG_CONTRACTS);
+const MEET_FLAGS = toCompletionFlagString(MEET_FLAG_CONTRACTS);
+const REMIND_FLAGS = toCompletionFlagString(REMIND_FLAG_CONTRACTS);
 const CREATE_FLAGS = toCompletionFlagString(CREATE_FLAG_CONTRACTS);
 const GET_FLAGS = toCompletionFlagString(GET_FLAG_CONTRACTS);
 const UPDATE_FLAGS = toCompletionFlagString(UPDATE_FLAG_CONTRACTS);
@@ -262,6 +265,9 @@ export function generateBashScript(itemTypes = [], tags = [], eagerTagExpansion
         "    copy)",
         `      COMPREPLY=(${compgen(COPY_FLAGS)})`,
         "      ;;",
+        "    focus)",
+        `      COMPREPLY=(${compgen(FOCUS_FLAGS)})`,
+        "      ;;",
         "    update)",
         `      COMPREPLY=(${compgen(updateFlags)})`,
         "      ;;",
@@ -296,7 +302,7 @@ export function generateBashScript(itemTypes = [], tags = [], eagerTagExpansion
         `      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 --pm-path --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    comments)",
-        `      COMPREPLY=(${compgen("--add --stdin --file --limit --author --message --allow-audit-comment --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--add --stdin --file --edit --delete --limit --author --message --allow-audit-comment --force --json --quiet --no-changed-fields --pm-path --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 --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
@@ -329,7 +335,7 @@ export function generateBashScript(itemTypes = [], tags = [], eagerTagExpansion
         `      COMPREPLY=(${compgen("list status logs stop resume --status --limit --stream --tail --force --author --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    validate)",
-        `      COMPREPLY=(${compgen("--check-metadata --metadata-profile --check-resolution --check-lifecycle --check-stale-blockers --dependency-cycle-severity --check-files --scan-mode --include-pm-internals --verbose-file-lists --verbose-diagnostics --strict-exit --fail-on-warn --fix-hints --auto-fix --dry-run --fix-scope --prune-missing --check-history-drift --check-command-references --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
+        `      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 --all-affected-ids --strict-exit --fail-on-warn --fix-hints --auto-fix --dry-run --fix-scope --prune-missing --check-history-drift --check-command-references --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    health)",
         `      COMPREPLY=(${compgen(HEALTH_FLAGS)})`,
@@ -350,7 +356,7 @@ export function generateBashScript(itemTypes = [], tags = [], eagerTagExpansion
         `      COMPREPLY=(${compgen("--all --dry-run --author --message --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    schema)",
-        `      COMPREPLY=(${compgen("list show show-status add-type remove-type add-status remove-status --description --default-status --folder --alias --role --order --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset --description --default-status --folder --alias --role --order --type --commands --cli-flag --required --required-on-create --no-allow-unset --required-types --infer --min-count --apply --author --force --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    plan)",
         `      COMPREPLY=(${compgen(`${PLAN_SUBCOMMANDS_LIST} ${PLAN_FLAGS}`)})`,
@@ -365,7 +371,7 @@ export function generateBashScript(itemTypes = [], tags = [], eagerTagExpansion
         `      COMPREPLY=(${compgen("--dry-run --scope --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    stats)",
-        `      COMPREPLY=(${compgen("--storage --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
+        `      COMPREPLY=(${compgen("--storage --metadata-coverage --field-utilization --by-assignee --by-tag --by-priority --tag-prefix --json --quiet --no-changed-fields --pm-path --path --no-extensions --no-pager --profile --help")})`,
         "      ;;",
         "    close|close-task)",
         `      COMPREPLY=(${compgen(CLOSE_MUTATION_FLAGS)})`,
@@ -382,6 +388,12 @@ export function generateBashScript(itemTypes = [], tags = [], eagerTagExpansion
         "    claim|restore|start-task|pause-task)",
         `      COMPREPLY=(${compgen(MUTATION_FLAGS)})`,
         "      ;;",
+        "    meet|event)",
+        `      COMPREPLY=(${compgen(MEET_FLAGS)})`,
+        "      ;;",
+        "    remind)",
+        `      COMPREPLY=(${compgen(REMIND_FLAGS)})`,
+        "      ;;",
         "    completion)",
         `      COMPREPLY=(${compgen(COMPLETION_SHELL_CHOICES)})`,
         "      ;;",
@@ -445,6 +457,7 @@ _pm_commands() {
     'extension:Manage extension lifecycle operations'
     'create:Create a new project management item'
     'copy:Copy an existing item to a new ID'
+    'focus:Set/clear/show the session focused parent for new items'
     'list:List active items with optional filters'
     'list-all:List all items with optional filters'
     'list-draft:List draft items with optional filters'
@@ -498,6 +511,9 @@ _pm_commands() {
     'start-task:Lifecycle alias to claim and set in_progress'
     'pause-task:Lifecycle alias to reopen and release claim'
     'close-task:Lifecycle alias to close and release claim'
+    'meet:Shortcut to create a Meeting with scheduling defaults'
+    'event:Shortcut to create an Event with scheduling defaults'
+    'remind:Shortcut to create a Reminder from a point in time'
     'templates:Manage reusable create templates'
     'completion:Generate shell completion'
     'help:Display help for a command'
@@ -543,8 +559,33 @@ _pm() {
             '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
             '--sprint[Filter by sprint]:sprint' \\
             '--release[Filter by release]:release' \\
+            '--filter-reviewer-missing[Select only items missing reviewer]' \\
+            '--filter-risk-missing[Select only items missing risk]' \\
+            '--filter-confidence-missing[Select only items missing confidence]' \\
+            '--filter-sprint-missing[Select only items missing sprint]' \\
+            '--filter-release-missing[Select only items missing release]' \\
+            '--has-notes[Select only items that have notes]' \\
+            '--no-notes[Select only items with no notes]' \\
+            '--has-learnings[Select only items that have learnings]' \\
+            '--no-learnings[Select only items with no learnings]' \\
+            '--has-files[Select only items that have linked files]' \\
+            '--no-files[Select only items with no linked files]' \\
+            '--has-docs[Select only items that have linked docs]' \\
+            '--no-docs[Select only items with no linked docs]' \\
+            '--has-tests[Select only items that have linked tests]' \\
+            '--no-tests[Select only items with no linked tests]' \\
+            '--has-comments[Select only items that have comments]' \\
+            '--no-comments[Select only items with no comments]' \\
+            '--has-deps[Select only items that have dependencies]' \\
+            '--no-deps[Select only items with no dependencies]' \\
+            '--has-body[Select only items with non-empty body]' \\
+            '--empty-body[Select only items with empty body]' \\
+            '--has-linked-command[Select only items that have a linked command]' \\
+            '--no-linked-command[Select only items with no linked command]' \\
             '--limit[Limit returned item count]:number' \\
             '--offset[Skip the first n matching rows before limit]:number' \\
+            '--no-truncate[Return every matched row, overriding --limit]' \\
+            '--all[Alias for --no-truncate]' \\
             '--include-body[Include item body in each returned list row]' \\
             '--compact[Render compact list projection fields]' \\
             '--fields[Render custom comma-separated list fields]:fields' \\
@@ -611,6 +652,7 @@ ${zshListRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--tags[Comma-separated tags]:tags' \\
             '--add-tags[Add tags additively without replacing existing]:tags' \\
             '(-b --body)'{-b,--body}'[Item body]:body' \\
+            '--body-file[Load the item body from a file]:body_file:_files' \\
             '--deadline[Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)]:deadline' \\
             '--estimate[Estimated minutes]:minutes' \\
             '--acceptance-criteria[Acceptance criteria]:criteria' \\
@@ -645,11 +687,52 @@ ${zshCreateRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
+        focus)
+          _arguments \\
+            '--clear[Clear the focused item]' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        meet|event)
+          _arguments \\
+            '--start[Start time (ISO, now, or relative)]:start' \\
+            '--duration[Duration from start (default 1h)]:duration' \\
+            '--end[End time (overrides --duration)]:end' \\
+            '--location[Location]:location' \\
+            '--timezone[IANA timezone]:timezone' \\
+            '--all-day[Mark as an all-day event]' \\
+            '--parent[Parent item id]:parent' \\
+            '--allow-missing-parent[Permit a parent id that does not exist yet]' \\
+            '--tags[Comma-separated tags]:tags' \\
+            '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
+            '(-b --body)'{-b,--body}'[Item body]:body' \\
+            '(-d --description)'{-d,--description}'[Short description]:description' \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
+        remind)
+          _arguments \\
+            '--at[Reminder time (default +1d)]:at' \\
+            '--text[Reminder text (defaults to title)]:text' \\
+            '--parent[Parent item id]:parent' \\
+            '--allow-missing-parent[Permit a parent id that does not exist yet]' \\
+            '--tags[Comma-separated tags]:tags' \\
+            '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
+            '(-b --body)'{-b,--body}'[Item body]:body' \\
+            '(-d --description)'{-d,--description}'[Short description]:description' \\
+            '--author[Mutation author]:author' \\
+            '--message[History message]:message' \\
+            '--json[Output JSON]' \\
+            '--quiet[Suppress stdout]'
+          ;;
         update)
           _arguments \\
             '(-t --title)'{-t,--title}'[Item title]:title' \\
             '(-d --description)'{-d,--description}'[Item description]:description' \\
             '(-b --body)'{-b,--body}'[Item body]:body' \\
+            '--body-file[Load the item body from a file]:body_file:_files' \\
             '(-s --status)'{-s,--status}'[Item status]:(${statusChoices})' \\
             '--close-reason[Set close reason]:close_reason' \\
             '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
@@ -703,6 +786,33 @@ ${zshUpdateRuntimeFieldFlags}            '--allow-audit-update[Allow non-owner m
             '--filter-parent[Filter by parent item ID]:parent' \\
             '--filter-sprint[Filter by sprint]:sprint' \\
             '--filter-release[Filter by release]:release' \\
+            '--filter-ac-missing[Select only items missing acceptance_criteria]' \\
+            '--filter-estimates-missing[Select only items missing estimated_minutes]' \\
+            '--filter-resolution-missing[Select only terminal items missing resolution]' \\
+            '--filter-metadata-missing[Select only items missing any tracked metadata]' \\
+            '--filter-reviewer-missing[Select only items missing reviewer]' \\
+            '--filter-risk-missing[Select only items missing risk]' \\
+            '--filter-confidence-missing[Select only items missing confidence]' \\
+            '--filter-sprint-missing[Select only items missing sprint]' \\
+            '--filter-release-missing[Select only items missing release]' \\
+            '--filter-has-notes[Select only items that have notes]' \\
+            '--filter-no-notes[Select only items with no notes]' \\
+            '--filter-has-learnings[Select only items that have learnings]' \\
+            '--filter-no-learnings[Select only items with no learnings]' \\
+            '--filter-has-files[Select only items that have linked files]' \\
+            '--filter-no-files[Select only items with no linked files]' \\
+            '--filter-has-docs[Select only items that have linked docs]' \\
+            '--filter-no-docs[Select only items with no linked docs]' \\
+            '--filter-has-tests[Select only items that have linked tests]' \\
+            '--filter-no-tests[Select only items with no linked tests]' \\
+            '--filter-has-comments[Select only items that have comments]' \\
+            '--filter-no-comments[Select only items with no comments]' \\
+            '--filter-has-deps[Select only items that have dependencies]' \\
+            '--filter-no-deps[Select only items with no dependencies]' \\
+            '--filter-has-body[Select only items with non-empty body]' \\
+            '--filter-empty-body[Select only items with empty body]' \\
+            '--filter-has-linked-command[Select only items that have a linked command]' \\
+            '--filter-no-linked-command[Select only items with no linked command]' \\
             '--ids[Explicit comma-separated ID allowlist]:ids' \\
             '--limit[Limit matched item count]:number' \\
             '--offset[Skip first n matched rows]:number' \\
@@ -795,6 +905,29 @@ ${zshUpdateManyRuntimeFieldFlags}            '--allow-audit-update[Allow non-own
             '--filter-parent[Filter by parent item ID]:parent' \\
             '--filter-sprint[Filter by sprint]:sprint' \\
             '--filter-release[Filter by release]:release' \\
+            '--filter-reviewer-missing[Select only items missing reviewer]' \\
+            '--filter-risk-missing[Select only items missing risk]' \\
+            '--filter-confidence-missing[Select only items missing confidence]' \\
+            '--filter-sprint-missing[Select only items missing sprint]' \\
+            '--filter-release-missing[Select only items missing release]' \\
+            '--filter-has-notes[Select only items that have notes]' \\
+            '--filter-no-notes[Select only items with no notes]' \\
+            '--filter-has-learnings[Select only items that have learnings]' \\
+            '--filter-no-learnings[Select only items with no learnings]' \\
+            '--filter-has-files[Select only items that have linked files]' \\
+            '--filter-no-files[Select only items with no linked files]' \\
+            '--filter-has-docs[Select only items that have linked docs]' \\
+            '--filter-no-docs[Select only items with no linked docs]' \\
+            '--filter-has-tests[Select only items that have linked tests]' \\
+            '--filter-no-tests[Select only items with no linked tests]' \\
+            '--filter-has-comments[Select only items that have comments]' \\
+            '--filter-no-comments[Select only items with no comments]' \\
+            '--filter-has-deps[Select only items that have dependencies]' \\
+            '--filter-no-deps[Select only items with no dependencies]' \\
+            '--filter-has-body[Select only items with non-empty body]' \\
+            '--filter-empty-body[Select only items with empty body]' \\
+            '--filter-has-linked-command[Select only items that have a linked command]' \\
+            '--filter-no-linked-command[Select only items with no linked command]' \\
             '--ids[Explicit comma-separated ID allowlist]:ids' \\
             '--limit[Limit matched item count]:number' \\
             '--offset[Skip first n matched rows]:number' \\
@@ -876,7 +1009,9 @@ ${zshCalendarRuntimeFieldFlags}            '--include[Include event sources]:(al
             '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
             '--sprint[Filter by sprint]:sprint' \\
             '--release[Filter by release]:release' \\
+            '--parent[Scope snapshot to one item subtree]:id' \\
             '--limit[Limit focus and agenda rows per section]:number' \\
+            '--depth[Context depth]:(brief standard deep full)' \\
             '--format[Output override]:(markdown toon json)' \\
 ${zshContextRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
@@ -893,6 +1028,9 @@ ${zshContextRuntimeFieldFlags}            '--json[Output JSON]' \\
         search)
           _arguments \\
             '--mode[Search mode]:(keyword semantic hybrid)' \\
+            '--match-mode[Token match mode]:(and or exact)' \\
+            '--min-score[Per-query minimum score threshold]:number' \\
+            '--count[Return only the match count]' \\
             '--include-linked[Include linked content in scoring]' \\
             '--limit[Max results]:number' \\
             '--status[Filter by status (open/closed/canceled, csv)]:(${statusChoices})' \\
@@ -900,6 +1038,37 @@ ${zshContextRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--tag[Filter by tag]:(${zshTagChoices})' \\
             '--tags[Alias for --tag]:(${zshTagChoices})' \\
             '--priority[Filter by priority]:(0 1 2 3 4)' \\
+            '--updated-after[Filter by updated_at lower bound]:value' \\
+            '--updated-before[Filter by updated_at upper bound]:value' \\
+            '--created-after[Filter by created_at lower bound]:value' \\
+            '--created-before[Filter by created_at upper bound]:value' \\
+            '--assignee[Filter by assignee]:value' \\
+            '--sprint[Filter by sprint]:value' \\
+            '--release[Filter by release]:value' \\
+            '--parent[Filter by parent item ID]:value' \\
+            '--filter-reviewer-missing[Select only items missing reviewer]' \\
+            '--filter-risk-missing[Select only items missing risk]' \\
+            '--filter-confidence-missing[Select only items missing confidence]' \\
+            '--filter-sprint-missing[Select only items missing sprint]' \\
+            '--filter-release-missing[Select only items missing release]' \\
+            '--has-notes[Select only items that have notes]' \\
+            '--no-notes[Select only items with no notes]' \\
+            '--has-learnings[Select only items that have learnings]' \\
+            '--no-learnings[Select only items with no learnings]' \\
+            '--has-files[Select only items that have linked files]' \\
+            '--no-files[Select only items with no linked files]' \\
+            '--has-docs[Select only items that have linked docs]' \\
+            '--no-docs[Select only items with no linked docs]' \\
+            '--has-tests[Select only items that have linked tests]' \\
+            '--no-tests[Select only items with no linked tests]' \\
+            '--has-comments[Select only items that have comments]' \\
+            '--no-comments[Select only items with no comments]' \\
+            '--has-deps[Select only items that have dependencies]' \\
+            '--no-deps[Select only items with no dependencies]' \\
+            '--has-body[Select only items with non-empty body]' \\
+            '--empty-body[Select only items with empty body]' \\
+            '--has-linked-command[Select only items that have a linked command]' \\
+            '--no-linked-command[Select only items with no linked command]' \\
 ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
@@ -965,13 +1134,23 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
           ;;
         schema)
           _arguments \\
-            '1:subcommand:(list show show-status add-type remove-type add-status remove-status)' \\
-            '--description[Human description for the custom item type or status]:text' \\
+            '1:subcommand:(list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset)' \\
+            '--description[Human description for the custom item type, status, or field]:text' \\
             '--default-status[Default status hint for the custom item type]:status' \\
             '--folder[Storage folder for items of this custom type]:dir' \\
-            '--alias[Alias for the custom type or status (repeatable)]:name' \\
+            '--alias[Alias for the custom type, status, or field flag (repeatable)]:name' \\
             '--role[Lifecycle role for a custom status (repeatable)]:role' \\
             '--order[Display/sort order for a custom status]:n' \\
+            '--type[Value type for a custom field]:type:(string number boolean string_array)' \\
+            '--commands[Commands a custom field is wired onto (repeatable)]:commands' \\
+            '--cli-flag[Override the auto-derived CLI flag for a custom field]:flag' \\
+            '--required[Mark a custom field as always required]' \\
+            '--required-on-create[Mark a custom field as required at create time]' \\
+            '--no-allow-unset[Disallow clearing a custom field via --unset]' \\
+            '--required-types[Restrict a custom field requirement to specific item types (repeatable)]:types' \\
+            '--infer[Infer item types from title-prefix conventions (add-type)]' \\
+            '--min-count[Minimum items sharing a prefix for --infer]:n' \\
+            '--apply[Register inferred types (with --infer)]' \\
             '--author[Mutation author]:author' \\
             '--force[Force ownership/lock override]' \\
             '--json[Output JSON]' \\
@@ -1039,6 +1218,12 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
         stats)
           _arguments \\
             '--storage[Include aggregate history-stream storage metrics]' \\
+            '--metadata-coverage[Include metadata coverage percentages overall and by type]' \\
+            '--field-utilization[Include content-field utilization rates across all items]' \\
+            '--by-assignee[Lifecycle-bucketed breakdown grouped by assignee]' \\
+            '--by-tag[Lifecycle-bucketed breakdown grouped by tag]' \\
+            '--by-priority[Lifecycle-bucketed breakdown grouped by priority]' \\
+            '--tag-prefix[With --by-tag: only count tags with this prefix]:prefix' \\
             '--json[Output JSON]' \\
             '--quiet[Suppress stdout]'
           ;;
@@ -1047,6 +1232,8 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--add[Add one entry (plain text, text=<value>, markdown pairs, or - for stdin)]:text' \\
             '--stdin[Read comment text from stdin (supports multiline markdown)]' \\
             '--file[Read comment text from file (supports multiline markdown)]:path' \\
+            '--edit[Replace the comment at 1-based index (text from positional/--add/--stdin/--file)]:index' \\
+            '--delete[Delete the comment at 1-based index]:index' \\
             '--limit[Return only latest n entries]:number' \\
             '--author[Entry author (falls back to PM_AUTHOR/settings)]:author' \\
             '--message[History message]:message' \\
@@ -1260,12 +1447,14 @@ ${zshSearchRuntimeFieldFlags}            '--json[Output JSON]' \\
             '--scan-mode[Select file candidate scan mode for --check-files]:(default tracked-all tracked-all-strict)' \\
             '--include-pm-internals[Include PM storage internals in tracked-all candidate scans]' \\
             '--verbose-file-lists[Include full file-path lists for validate --check-files details]' \\
+            '--verbose-diagnostics[Include full validate diagnostic ID lists instead of compact summaries]' \\
+            '--all-affected-ids[Emit complete missing_* affected-ID lists with no truncation (implied by --json)]' \\
             '--strict-exit[Return non-zero exit when validation warnings are present]' \\
             '--fail-on-warn[Alias for --strict-exit]' \\
             '--fix-hints[Add a machine-executable fix_hints[] of pm commands to each failing check]' \\
             '--auto-fix[Apply the safe, deterministic subset of fix-hint remediations automatically]' \\
             '--dry-run[Preview planned --auto-fix/--prune-missing fixes without applying them]' \\
-            '--fix-scope[Grant --auto-fix scopes (lifecycle must be named explicitly)]:(metadata resolution lifecycle)' \\
+            '--fix-scope[Grant --auto-fix scopes (estimates/lifecycle must be named explicitly)]:(metadata resolution estimates lifecycle)' \\
             '--prune-missing[Remove stale linked-file/doc links classified as deleted]' \\
             '--check-history-drift[Run item/history hash drift checks]' \\
             '--check-command-references[Run linked-command PM-ID reference checks]' \\
@@ -1431,6 +1620,7 @@ complete -c pm -n __pm_no_subcommand -a config        -d 'Read or update pm sett
 complete -c pm -n __pm_no_subcommand -a extension     -d 'Manage extension lifecycle operations'
 complete -c pm -n __pm_no_subcommand -a create        -d 'Create a new project management item'
 complete -c pm -n __pm_no_subcommand -a copy          -d 'Copy an existing item to a new ID'
+complete -c pm -n __pm_no_subcommand -a focus         -d 'Set/clear/show the session focused parent for new items'
 complete -c pm -n __pm_no_subcommand -a list          -d 'List active items with optional filters'
 complete -c pm -n __pm_no_subcommand -a list-all      -d 'List all items with optional filters'
 complete -c pm -n __pm_no_subcommand -a list-draft    -d 'List draft items with optional filters'
@@ -1484,6 +1674,9 @@ complete -c pm -n __pm_no_subcommand -a release       -d 'Release the active cla
 complete -c pm -n __pm_no_subcommand -a start-task    -d 'Lifecycle alias to claim and set in-progress'
 complete -c pm -n __pm_no_subcommand -a pause-task    -d 'Lifecycle alias to reopen and release claim'
 complete -c pm -n __pm_no_subcommand -a close-task    -d 'Lifecycle alias to close and release claim'
+complete -c pm -n __pm_no_subcommand -a meet          -d 'Shortcut to create a Meeting with scheduling defaults'
+complete -c pm -n __pm_no_subcommand -a event         -d 'Shortcut to create an Event with scheduling defaults'
+complete -c pm -n __pm_no_subcommand -a remind        -d 'Shortcut to create a Reminder from a point in time'
 complete -c pm -n __pm_no_subcommand -a templates     -d 'Manage reusable create templates'
 complete -c pm -n __pm_no_subcommand -a completion    -d 'Generate shell completion'
 
@@ -1499,6 +1692,8 @@ for list_cmd in ${listCmds}
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l release  -d 'Filter by release' -r
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l limit    -d 'Limit returned item count' -r
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l offset   -d 'Skip the first n matching rows before limit' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-truncate -d 'Return every matched row, overriding --limit'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l all -d 'Alias for --no-truncate'
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l include-body -d 'Include item body in each returned list row'
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l compact -d 'Render compact list projection fields'
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l fields -d 'Render custom comma-separated list fields' -r
@@ -1513,6 +1708,29 @@ for list_cmd in ${listCmds}
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l updated-before -d 'Filter by updated_at upper bound (ISO/relative)' -r
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l created-after  -d 'Filter by created_at lower bound (ISO/relative)' -r
   complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l created-before -d 'Filter by created_at upper bound (ISO/relative)' -r
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-reviewer-missing   -d 'Select only items missing reviewer'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-risk-missing       -d 'Select only items missing risk'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-confidence-missing -d 'Select only items missing confidence'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-sprint-missing     -d 'Select only items missing sprint'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l filter-release-missing    -d 'Select only items missing release'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-notes            -d 'Select only items that have notes'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-notes             -d 'Select only items with no notes'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-learnings        -d 'Select only items that have learnings'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-learnings         -d 'Select only items with no learnings'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-files            -d 'Select only items that have linked files'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-files             -d 'Select only items with no linked files'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-docs             -d 'Select only items that have linked docs'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-docs              -d 'Select only items with no linked docs'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-tests            -d 'Select only items that have linked tests'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-tests             -d 'Select only items with no linked tests'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-comments         -d 'Select only items that have comments'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-comments          -d 'Select only items with no comments'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-deps             -d 'Select only items that have dependencies'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-deps              -d 'Select only items with no dependencies'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-body             -d 'Select only items with non-empty body'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l empty-body           -d 'Select only items with empty body'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l has-linked-command   -d 'Select only items that have a linked command'
+  complete -c pm -n "__fish_seen_subcommand_from $list_cmd" -l no-linked-command    -d 'Select only items with no linked command'
 end
 ${fishListRuntimeFieldFlags}
 
@@ -1562,6 +1780,7 @@ complete -c pm -n '__fish_seen_subcommand_from create' -s p -l priority
 complete -c pm -n '__fish_seen_subcommand_from create' -l tags                    -d 'Comma-separated tags' -r
 complete -c pm -n '__fish_seen_subcommand_from create' -l add-tags                -d 'Add tags additively without replacing existing' -r
 complete -c pm -n '__fish_seen_subcommand_from create' -s b -l body               -d 'Item body' -r
+complete -c pm -n '__fish_seen_subcommand_from create' -l body-file               -d 'Load the item body from a file' -r -F
 complete -c pm -n '__fish_seen_subcommand_from create' -l deadline                -d 'Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)' -r
 complete -c pm -n '__fish_seen_subcommand_from create' -l estimate                -d 'Estimated minutes' -r
 complete -c pm -n '__fish_seen_subcommand_from create' -l acceptance-criteria     -d 'Acceptance criteria' -r
@@ -1590,10 +1809,14 @@ complete -c pm -n '__fish_seen_subcommand_from copy' -l author  -d 'Mutation aut
 complete -c pm -n '__fish_seen_subcommand_from copy' -l message -d 'History message' -r
 complete -c pm -n '__fish_seen_subcommand_from copy' -l force   -d 'Force ownership override'
 
+# focus flags
+complete -c pm -n '__fish_seen_subcommand_from focus' -l clear -d 'Clear the focused item'
+
 # update flags
 complete -c pm -n '__fish_seen_subcommand_from update' -s t -l title              -d 'Item title' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -s d -l description        -d 'Item description' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -s b -l body               -d 'Item body' -r
+complete -c pm -n '__fish_seen_subcommand_from update' -l body-file               -d 'Load the item body from a file' -r -F
 complete -c pm -n '__fish_seen_subcommand_from update' -s s -l status             -d 'Item status' -r -a '${statusChoices}'
 complete -c pm -n '__fish_seen_subcommand_from update' -l close-reason            -d 'Set close reason' -r
 complete -c pm -n '__fish_seen_subcommand_from update' -s p -l priority           -d 'Priority (0-4)' -r -a '0 1 2 3 4'
@@ -1646,6 +1869,33 @@ complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-assignee-f
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-parent           -d 'Filter by parent item ID' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-sprint           -d 'Filter by sprint before applying updates' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-release          -d 'Filter by release before applying updates' -r
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-ac-missing       -d 'Select only items missing acceptance_criteria'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-estimates-missing -d 'Select only items missing estimated_minutes'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-resolution-missing -d 'Select only terminal items missing resolution'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-metadata-missing  -d 'Select only items missing any tracked metadata'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-risk-missing       -d 'Select only items missing risk'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-confidence-missing -d 'Select only items missing confidence'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-sprint-missing     -d 'Select only items missing sprint'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-release-missing    -d 'Select only items missing release'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-notes          -d 'Select only items that have notes'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-notes           -d 'Select only items with no notes'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-learnings      -d 'Select only items that have learnings'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-learnings       -d 'Select only items with no learnings'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-files          -d 'Select only items that have linked files'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-files           -d 'Select only items with no linked files'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-docs           -d 'Select only items that have linked docs'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-docs            -d 'Select only items with no linked docs'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-tests          -d 'Select only items that have linked tests'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-tests           -d 'Select only items with no linked tests'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-comments       -d 'Select only items that have comments'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-comments        -d 'Select only items with no comments'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-deps           -d 'Select only items that have dependencies'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-deps            -d 'Select only items with no dependencies'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-body           -d 'Select only items with non-empty body'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-empty-body         -d 'Select only items with empty body'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-has-linked-command -d 'Select only items that have a linked command'
+complete -c pm -n '__fish_seen_subcommand_from update-many' -l filter-no-linked-command  -d 'Select only items with no linked command'
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l ids                     -d 'Explicit comma-separated ID allowlist' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l limit                   -d 'Limit matched item count' -r
 complete -c pm -n '__fish_seen_subcommand_from update-many' -l offset                  -d 'Skip first n matched rows' -r
@@ -1743,6 +1993,9 @@ complete -c pm -n '__fish_seen_subcommand_from normalize' -l force
 
 # search flags
 complete -c pm -n '__fish_seen_subcommand_from search' -l mode          -d 'Search mode' -r -a 'keyword semantic hybrid'
+complete -c pm -n '__fish_seen_subcommand_from search' -l match-mode    -d 'Token match mode' -r -a 'and or exact'
+complete -c pm -n '__fish_seen_subcommand_from search' -l min-score     -d 'Per-query minimum score threshold' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l count          -d 'Return only the match count'
 complete -c pm -n '__fish_seen_subcommand_from search' -l include-linked -d 'Include linked content in scoring'
 complete -c pm -n '__fish_seen_subcommand_from search' -l 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}'
@@ -1750,6 +2003,37 @@ complete -c pm -n '__fish_seen_subcommand_from search' -l type           -d 'Fil
 complete -c pm -n '__fish_seen_subcommand_from search' -l tag            -d 'Filter by tag' -r -a ${fishTagChoices}
 complete -c pm -n '__fish_seen_subcommand_from search' -l tags           -d 'Alias for --tag' -r -a ${fishTagChoices}
 complete -c pm -n '__fish_seen_subcommand_from search' -l priority       -d 'Filter by priority' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from search' -l updated-after  -d 'Filter by updated_at lower bound' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l updated-before -d 'Filter by updated_at upper bound' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l created-after  -d 'Filter by created_at lower bound' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l created-before -d 'Filter by created_at upper bound' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l assignee       -d 'Filter by assignee' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l sprint         -d 'Filter by sprint' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l release        -d 'Filter by release' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l parent         -d 'Filter by parent item ID' -r
+complete -c pm -n '__fish_seen_subcommand_from search' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
+complete -c pm -n '__fish_seen_subcommand_from search' -l filter-risk-missing       -d 'Select only items missing risk'
+complete -c pm -n '__fish_seen_subcommand_from search' -l filter-confidence-missing -d 'Select only items missing confidence'
+complete -c pm -n '__fish_seen_subcommand_from search' -l filter-sprint-missing     -d 'Select only items missing sprint'
+complete -c pm -n '__fish_seen_subcommand_from search' -l filter-release-missing    -d 'Select only items missing release'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-notes          -d 'Select only items that have notes'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-notes           -d 'Select only items with no notes'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-learnings      -d 'Select only items that have learnings'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-learnings       -d 'Select only items with no learnings'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-files          -d 'Select only items that have linked files'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-files           -d 'Select only items with no linked files'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-docs           -d 'Select only items that have linked docs'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-docs            -d 'Select only items with no linked docs'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-tests          -d 'Select only items that have linked tests'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-tests           -d 'Select only items with no linked tests'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-comments       -d 'Select only items that have comments'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-comments        -d 'Select only items with no comments'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-deps           -d 'Select only items that have dependencies'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-deps            -d 'Select only items with no dependencies'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-body           -d 'Select only items with non-empty body'
+complete -c pm -n '__fish_seen_subcommand_from search' -l empty-body         -d 'Select only items with empty body'
+complete -c pm -n '__fish_seen_subcommand_from search' -l has-linked-command -d 'Select only items that have a linked command'
+complete -c pm -n '__fish_seen_subcommand_from search' -l no-linked-command  -d 'Select only items with no linked command'
 ${fishSearchRuntimeFieldFlags}
 
 # calendar flags
@@ -1787,7 +2071,9 @@ complete -c pm -n '__fish_seen_subcommand_from context ctx' -l assignee  -d 'Fil
 complete -c pm -n '__fish_seen_subcommand_from context ctx' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
 complete -c pm -n '__fish_seen_subcommand_from context ctx' -l sprint    -d 'Filter by sprint' -r
 complete -c pm -n '__fish_seen_subcommand_from context ctx' -l release   -d 'Filter by release' -r
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l parent    -d 'Scope snapshot to one item subtree' -r
 complete -c pm -n '__fish_seen_subcommand_from context ctx' -l limit     -d 'Limit focus and agenda rows per section' -r
+complete -c pm -n '__fish_seen_subcommand_from context ctx' -l depth     -d 'Context depth' -r -a 'brief standard deep full'
 complete -c pm -n '__fish_seen_subcommand_from context ctx' -l format    -d 'Output override' -r -a 'markdown toon json'
 ${fishContextRuntimeFieldFlags}
 
@@ -1832,13 +2118,23 @@ 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 'list show show-status 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' -a 'list show show-status add-type remove-type add-status remove-status add-field remove-field list-fields show-field apply-preset' -d 'Schema subcommand'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l description -d 'Human description for the custom item type, status, or field' -r
 complete -c pm -n '__fish_seen_subcommand_from schema' -l default-status -d 'Default status hint for the custom item type' -r
 complete -c pm -n '__fish_seen_subcommand_from schema' -l folder -d 'Storage folder for items of this custom type' -r
-complete -c pm -n '__fish_seen_subcommand_from schema' -l alias -d 'Alias for the custom type or status (repeatable)' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l alias -d 'Alias for the custom type, status, or field flag (repeatable)' -r
 complete -c pm -n '__fish_seen_subcommand_from schema' -l role -d 'Lifecycle role for a custom status (repeatable)' -r
 complete -c pm -n '__fish_seen_subcommand_from schema' -l order -d 'Display/sort order for a custom status' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l type -d 'Value type for a custom field' -r -a 'string number boolean string_array'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l commands -d 'Commands a custom field is wired onto (repeatable)' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l cli-flag -d 'Override the auto-derived CLI flag for a custom field' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l required -d 'Mark a custom field as always required'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l required-on-create -d 'Mark a custom field as required at create time'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l no-allow-unset -d 'Disallow clearing a custom field via --unset'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l required-types -d 'Restrict a custom field requirement to specific item types (repeatable)' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l infer -d 'Infer item types from title-prefix conventions (add-type)'
+complete -c pm -n '__fish_seen_subcommand_from schema' -l min-count -d 'Minimum items sharing a prefix for --infer' -r
+complete -c pm -n '__fish_seen_subcommand_from schema' -l apply -d 'Register inferred types (with --infer)'
 complete -c pm -n '__fish_seen_subcommand_from schema' -l author -d 'Mutation author' -r
 complete -c pm -n '__fish_seen_subcommand_from schema' -l force -d 'Force ownership/lock override'
 complete -c pm -n '__fish_seen_subcommand_from 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'
@@ -1887,6 +2183,8 @@ complete -c pm -n '__fish_seen_subcommand_from deps' -l summary -d 'Return count
 complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l add -d 'Add one entry (text=<value> or plain text)' -r
 complete -c pm -n '__fish_seen_subcommand_from comments' -l stdin -d 'Read comment text from stdin (supports multiline markdown)'
 complete -c pm -n '__fish_seen_subcommand_from comments' -l file -d 'Read comment text from file (supports multiline markdown)' -r
+complete -c pm -n '__fish_seen_subcommand_from comments' -l edit -d 'Replace the comment at 1-based index (text from positional/--add/--stdin/--file)' -r
+complete -c pm -n '__fish_seen_subcommand_from comments' -l delete -d 'Delete the comment at 1-based index' -r
 complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l limit -d 'Return only latest n entries' -r
 complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l author -d 'Entry author' -r
 complete -c pm -n '__fish_seen_subcommand_from comments notes learnings' -l message -d 'History message' -r
@@ -1956,6 +2254,12 @@ complete -c pm -n '__fish_seen_subcommand_from gc' -l scope -d 'Limit cleanup to
 
 # stats flags
 complete -c pm -n '__fish_seen_subcommand_from stats' -l storage -d 'Include aggregate history-stream storage metrics'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l metadata-coverage -d 'Include metadata coverage percentages overall and by type'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l field-utilization -d 'Include content-field utilization rates across all items'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l by-assignee -d 'Lifecycle-bucketed breakdown grouped by assignee'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l by-tag -d 'Lifecycle-bucketed breakdown grouped by tag'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l by-priority -d 'Lifecycle-bucketed breakdown grouped by priority'
+complete -c pm -n '__fish_seen_subcommand_from stats' -l tag-prefix -d 'With --by-tag: only count tags with this prefix' -r
 
 # append flags
 complete -c pm -n '__fish_seen_subcommand_from append' -s b -l body -d 'Item body' -r
@@ -1978,6 +2282,24 @@ 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'
 
+# scheduling shortcut flags (meet/event/remind)
+complete -c pm -n '__fish_seen_subcommand_from meet event' -l start -d 'Start time (ISO, now, or relative)' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event' -l duration -d 'Duration from start (default 1h)' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event' -l end -d 'End time (overrides --duration)' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event' -l location -d 'Location' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event' -l timezone -d 'IANA timezone' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event' -l all-day -d 'Mark as an all-day event'
+complete -c pm -n '__fish_seen_subcommand_from remind' -l at -d 'Reminder time (default +1d)' -r
+complete -c pm -n '__fish_seen_subcommand_from remind' -l text -d 'Reminder text (defaults to title)' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l parent -d 'Parent item id' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l allow-missing-parent -d 'Permit a parent id that does not exist yet'
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l tags -d 'Comma-separated tags' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l priority -d 'Priority (0-4)' -r -a '0 1 2 3 4'
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l body -d 'Item body' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l description -d 'Short description' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l author -d 'Mutation author' -r
+complete -c pm -n '__fish_seen_subcommand_from meet event remind' -l message -d 'History message' -r
+
 # close-many flags
 complete -c pm -n '__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}'
@@ -1994,6 +2316,29 @@ complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-assignee-fi
 complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-parent          -d 'Filter by parent item ID' -r
 complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-sprint          -d 'Filter by sprint before closing' -r
 complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-release         -d 'Filter by release before closing' -r
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-reviewer-missing   -d 'Select only items missing reviewer'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-risk-missing       -d 'Select only items missing risk'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-confidence-missing -d 'Select only items missing confidence'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-sprint-missing     -d 'Select only items missing sprint'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-release-missing    -d 'Select only items missing release'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-notes          -d 'Select only items that have notes'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-notes           -d 'Select only items with no notes'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-learnings      -d 'Select only items that have learnings'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-learnings       -d 'Select only items with no learnings'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-files          -d 'Select only items that have linked files'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-files           -d 'Select only items with no linked files'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-docs           -d 'Select only items that have linked docs'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-docs            -d 'Select only items with no linked docs'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-tests          -d 'Select only items that have linked tests'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-tests           -d 'Select only items with no linked tests'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-comments       -d 'Select only items that have comments'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-comments        -d 'Select only items with no comments'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-deps           -d 'Select only items that have dependencies'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-deps            -d 'Select only items with no dependencies'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-body           -d 'Select only items with non-empty body'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-empty-body         -d 'Select only items with empty body'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-has-linked-command -d 'Select only items that have a linked command'
+complete -c pm -n '__fish_seen_subcommand_from close-many' -l filter-no-linked-command  -d 'Select only items with no linked command'
 complete -c pm -n '__fish_seen_subcommand_from close-many' -l ids                    -d 'Explicit comma-separated ID allowlist' -r
 complete -c pm -n '__fish_seen_subcommand_from close-many' -l limit                  -d 'Limit matched item count' -r
 complete -c pm -n '__fish_seen_subcommand_from close-many' -l offset                 -d 'Skip first n matched rows' -r
@@ -2022,12 +2367,14 @@ complete -c pm -n '__fish_seen_subcommand_from validate' -l check-files -d 'Run
 complete -c pm -n '__fish_seen_subcommand_from validate' -l scan-mode -d 'Select file candidate scan mode for --check-files' -r -a 'default tracked-all tracked-all-strict'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l include-pm-internals -d 'Include PM storage internals in tracked-all candidate scans'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l verbose-file-lists -d 'Include full file-path lists for validate --check-files details'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l verbose-diagnostics -d 'Include full validate diagnostic ID lists instead of compact summaries'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l all-affected-ids -d 'Emit complete missing_* affected-ID lists with no truncation (implied by --json)'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l strict-exit -d 'Return non-zero exit when validation warnings are present'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l fail-on-warn -d 'Alias for --strict-exit'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l fix-hints -d 'Add a machine-executable fix_hints[] of pm commands to each failing check'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l auto-fix -d 'Apply the safe, deterministic subset of fix-hint remediations automatically'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l dry-run -d 'Preview planned --auto-fix/--prune-missing fixes without applying them'
-complete -c pm -n '__fish_seen_subcommand_from validate' -l fix-scope -d 'Grant --auto-fix scopes (lifecycle must be named explicitly)' -r -a 'metadata resolution lifecycle'
+complete -c pm -n '__fish_seen_subcommand_from validate' -l fix-scope -d 'Grant --auto-fix scopes (estimates/lifecycle must be named explicitly)' -r -a 'metadata resolution estimates lifecycle'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l prune-missing -d 'Remove stale linked-file/doc links classified as deleted'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l check-history-drift -d 'Run item/history hash drift checks'
 complete -c pm -n '__fish_seen_subcommand_from validate' -l check-command-references -d 'Run linked-command PM-ID reference checks'
@@ -2129,4 +2476,4 @@ export function runCompletion(shell, itemTypes = [], tags = [], eagerTagExpansio
     };
 }
 //# sourceMappingURL=completion.js.map
-//# debugId=78557caa-254b-5c20-a792-78be2b6c9de3
+//# debugId=2f331396-9d67-51d7-a763-3ade7ab92864