@unbrained/pm-cli 2026.5.18 → 2026.5.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (225) hide show
  1. package/CHANGELOG.md +60 -0
  2. package/README.md +2 -1
  3. package/dist/cli/commander-usage.js +16 -2
  4. package/dist/cli/commander-usage.js.map +1 -1
  5. package/dist/cli/commands/annotation-command.d.ts +49 -0
  6. package/dist/cli/commands/annotation-command.js +135 -0
  7. package/dist/cli/commands/annotation-command.js.map +1 -0
  8. package/dist/cli/commands/append.js +3 -7
  9. package/dist/cli/commands/append.js.map +1 -1
  10. package/dist/cli/commands/calendar.js +3 -6
  11. package/dist/cli/commands/calendar.js.map +1 -1
  12. package/dist/cli/commands/claim.js +12 -22
  13. package/dist/cli/commands/claim.js.map +1 -1
  14. package/dist/cli/commands/close.js +61 -9
  15. package/dist/cli/commands/close.js.map +1 -1
  16. package/dist/cli/commands/comments.d.ts +5 -0
  17. package/dist/cli/commands/comments.js +27 -117
  18. package/dist/cli/commands/comments.js.map +1 -1
  19. package/dist/cli/commands/completion.js +102 -15
  20. package/dist/cli/commands/completion.js.map +1 -1
  21. package/dist/cli/commands/context.js +4 -10
  22. package/dist/cli/commands/context.js.map +1 -1
  23. package/dist/cli/commands/contracts.js +168 -36
  24. package/dist/cli/commands/contracts.js.map +1 -1
  25. package/dist/cli/commands/create.js +49 -44
  26. package/dist/cli/commands/create.js.map +1 -1
  27. package/dist/cli/commands/dedupe-audit.js +7 -4
  28. package/dist/cli/commands/dedupe-audit.js.map +1 -1
  29. package/dist/cli/commands/delete.d.ts +3 -0
  30. package/dist/cli/commands/delete.js +9 -8
  31. package/dist/cli/commands/delete.js.map +1 -1
  32. package/dist/cli/commands/docs.d.ts +1 -0
  33. package/dist/cli/commands/docs.js +4 -8
  34. package/dist/cli/commands/docs.js.map +1 -1
  35. package/dist/cli/commands/event-validation-messages.d.ts +3 -0
  36. package/dist/cli/commands/event-validation-messages.js +44 -0
  37. package/dist/cli/commands/event-validation-messages.js.map +1 -0
  38. package/dist/cli/commands/extension.d.ts +1 -0
  39. package/dist/cli/commands/extension.js +138 -21
  40. package/dist/cli/commands/extension.js.map +1 -1
  41. package/dist/cli/commands/files.js +6 -13
  42. package/dist/cli/commands/files.js.map +1 -1
  43. package/dist/cli/commands/gc.js +17 -4
  44. package/dist/cli/commands/gc.js.map +1 -1
  45. package/dist/cli/commands/get.d.ts +3 -2
  46. package/dist/cli/commands/get.js +50 -8
  47. package/dist/cli/commands/get.js.map +1 -1
  48. package/dist/cli/commands/health.d.ts +10 -0
  49. package/dist/cli/commands/health.js +254 -75
  50. package/dist/cli/commands/health.js.map +1 -1
  51. package/dist/cli/commands/history-redact.d.ts +8 -0
  52. package/dist/cli/commands/history-redact.js +14 -97
  53. package/dist/cli/commands/history-redact.js.map +1 -1
  54. package/dist/cli/commands/history-repair.d.ts +33 -0
  55. package/dist/cli/commands/history-repair.js +166 -0
  56. package/dist/cli/commands/history-repair.js.map +1 -0
  57. package/dist/cli/commands/history.d.ts +4 -4
  58. package/dist/cli/commands/history.js +10 -88
  59. package/dist/cli/commands/history.js.map +1 -1
  60. package/dist/cli/commands/index.d.ts +3 -1
  61. package/dist/cli/commands/index.js +5 -3
  62. package/dist/cli/commands/index.js.map +1 -1
  63. package/dist/cli/commands/init.d.ts +28 -0
  64. package/dist/cli/commands/init.js +23 -2
  65. package/dist/cli/commands/init.js.map +1 -1
  66. package/dist/cli/commands/learnings.js +20 -119
  67. package/dist/cli/commands/learnings.js.map +1 -1
  68. package/dist/cli/commands/linked-test-entry.d.ts +3 -0
  69. package/dist/cli/commands/linked-test-entry.js +62 -0
  70. package/dist/cli/commands/linked-test-entry.js.map +1 -0
  71. package/dist/cli/commands/list.js +32 -22
  72. package/dist/cli/commands/list.js.map +1 -1
  73. package/dist/cli/commands/notes.js +20 -119
  74. package/dist/cli/commands/notes.js.map +1 -1
  75. package/dist/cli/commands/plan.d.ts +3 -0
  76. package/dist/cli/commands/plan.js +184 -22
  77. package/dist/cli/commands/plan.js.map +1 -1
  78. package/dist/cli/commands/restore.js +7 -50
  79. package/dist/cli/commands/restore.js.map +1 -1
  80. package/dist/cli/commands/schema.d.ts +31 -0
  81. package/dist/cli/commands/schema.js +98 -0
  82. package/dist/cli/commands/schema.js.map +1 -0
  83. package/dist/cli/commands/search.js +151 -40
  84. package/dist/cli/commands/search.js.map +1 -1
  85. package/dist/cli/commands/templates.d.ts +4 -0
  86. package/dist/cli/commands/templates.js +89 -17
  87. package/dist/cli/commands/templates.js.map +1 -1
  88. package/dist/cli/commands/test-all.js +4 -8
  89. package/dist/cli/commands/test-all.js.map +1 -1
  90. package/dist/cli/commands/test.d.ts +1 -0
  91. package/dist/cli/commands/test.js +7 -10
  92. package/dist/cli/commands/test.js.map +1 -1
  93. package/dist/cli/commands/update-many.js +4 -8
  94. package/dist/cli/commands/update-many.js.map +1 -1
  95. package/dist/cli/commands/update.js +109 -51
  96. package/dist/cli/commands/update.js.map +1 -1
  97. package/dist/cli/commands/validate.d.ts +3 -1
  98. package/dist/cli/commands/validate.js +23 -71
  99. package/dist/cli/commands/validate.js.map +1 -1
  100. package/dist/cli/error-guidance.js +96 -6
  101. package/dist/cli/error-guidance.js.map +1 -1
  102. package/dist/cli/extension-command-help.d.ts +0 -1
  103. package/dist/cli/extension-command-help.js +2 -13
  104. package/dist/cli/extension-command-help.js.map +1 -1
  105. package/dist/cli/extension-command-options.d.ts +1 -0
  106. package/dist/cli/extension-command-options.js +106 -7
  107. package/dist/cli/extension-command-options.js.map +1 -1
  108. package/dist/cli/help-content.d.ts +0 -1
  109. package/dist/cli/help-content.js +13 -9
  110. package/dist/cli/help-content.js.map +1 -1
  111. package/dist/cli/help-json-payload.d.ts +1 -0
  112. package/dist/cli/help-json-payload.js +33 -3
  113. package/dist/cli/help-json-payload.js.map +1 -1
  114. package/dist/cli/main.js +35 -29
  115. package/dist/cli/main.js.map +1 -1
  116. package/dist/cli/register-list-query.d.ts +1 -1
  117. package/dist/cli/register-list-query.js +40 -17
  118. package/dist/cli/register-list-query.js.map +1 -1
  119. package/dist/cli/register-mutation.d.ts +1 -1
  120. package/dist/cli/register-mutation.js +232 -64
  121. package/dist/cli/register-mutation.js.map +1 -1
  122. package/dist/cli/register-operations.js +16 -11
  123. package/dist/cli/register-operations.js.map +1 -1
  124. package/dist/cli/register-setup.js +26 -14
  125. package/dist/cli/register-setup.js.map +1 -1
  126. package/dist/cli/registration-helpers.d.ts +0 -2
  127. package/dist/cli/registration-helpers.js +13 -40
  128. package/dist/cli/registration-helpers.js.map +1 -1
  129. package/dist/cli.js +23 -3
  130. package/dist/cli.js.map +1 -1
  131. package/dist/core/extensions/index.d.ts +0 -1
  132. package/dist/core/extensions/index.js +2 -14
  133. package/dist/core/extensions/index.js.map +1 -1
  134. package/dist/core/extensions/loader.js +3 -9
  135. package/dist/core/extensions/loader.js.map +1 -1
  136. package/dist/core/fs/path-utils.d.ts +1 -0
  137. package/dist/core/fs/path-utils.js +12 -0
  138. package/dist/core/fs/path-utils.js.map +1 -0
  139. package/dist/core/history/drift-scan.d.ts +11 -0
  140. package/dist/core/history/drift-scan.js +67 -0
  141. package/dist/core/history/drift-scan.js.map +1 -0
  142. package/dist/core/history/replay.d.ts +82 -0
  143. package/dist/core/history/replay.js +249 -0
  144. package/dist/core/history/replay.js.map +1 -0
  145. package/dist/core/item/item-format.js +11 -8
  146. package/dist/core/item/item-format.js.map +1 -1
  147. package/dist/core/item/item-type-definition.d.ts +52 -0
  148. package/dist/core/item/item-type-definition.js +123 -0
  149. package/dist/core/item/item-type-definition.js.map +1 -0
  150. package/dist/core/item/parse.js +3 -2
  151. package/dist/core/item/parse.js.map +1 -1
  152. package/dist/core/item/priority.d.ts +23 -0
  153. package/dist/core/item/priority.js +55 -0
  154. package/dist/core/item/priority.js.map +1 -0
  155. package/dist/core/item/status.d.ts +14 -1
  156. package/dist/core/item/status.js +22 -2
  157. package/dist/core/item/status.js.map +1 -1
  158. package/dist/core/item/toon-decode.d.ts +19 -0
  159. package/dist/core/item/toon-decode.js +69 -0
  160. package/dist/core/item/toon-decode.js.map +1 -0
  161. package/dist/core/item/type-registry.js +13 -84
  162. package/dist/core/item/type-registry.js.map +1 -1
  163. package/dist/core/packages/manifest.js +3 -9
  164. package/dist/core/packages/manifest.js.map +1 -1
  165. package/dist/core/schema/item-types-file.d.ts +85 -0
  166. package/dist/core/schema/item-types-file.js +243 -0
  167. package/dist/core/schema/item-types-file.js.map +1 -0
  168. package/dist/core/schema/runtime-schema.d.ts +2 -1
  169. package/dist/core/schema/runtime-schema.js +11 -9
  170. package/dist/core/schema/runtime-schema.js.map +1 -1
  171. package/dist/core/search/semantic-defaults.js +3 -3
  172. package/dist/core/search/semantic-defaults.js.map +1 -1
  173. package/dist/core/shared/author.d.ts +1 -0
  174. package/dist/core/shared/author.js +9 -0
  175. package/dist/core/shared/author.js.map +1 -0
  176. package/dist/core/shared/lazy-module.d.ts +1 -0
  177. package/dist/core/shared/lazy-module.js +11 -0
  178. package/dist/core/shared/lazy-module.js.map +1 -0
  179. package/dist/core/shared/option-alias-visibility.d.ts +44 -0
  180. package/dist/core/shared/option-alias-visibility.js +76 -0
  181. package/dist/core/shared/option-alias-visibility.js.map +1 -0
  182. package/dist/core/shared/text-normalization.d.ts +0 -1
  183. package/dist/core/shared/text-normalization.js +2 -5
  184. package/dist/core/shared/text-normalization.js.map +1 -1
  185. package/dist/core/store/item-store.d.ts +2 -0
  186. package/dist/core/store/item-store.js +70 -39
  187. package/dist/core/store/item-store.js.map +1 -1
  188. package/dist/core/store/settings-validator.d.ts +106 -0
  189. package/dist/core/store/settings-validator.js +279 -0
  190. package/dist/core/store/settings-validator.js.map +1 -0
  191. package/dist/core/store/settings.js +6 -343
  192. package/dist/core/store/settings.js.map +1 -1
  193. package/dist/core/telemetry/runtime.js +5 -3
  194. package/dist/core/telemetry/runtime.js.map +1 -1
  195. package/dist/mcp/server.js +64 -13
  196. package/dist/mcp/server.js.map +1 -1
  197. package/dist/sdk/cli-contracts.d.ts +9 -2
  198. package/dist/sdk/cli-contracts.js +204 -13
  199. package/dist/sdk/cli-contracts.js.map +1 -1
  200. package/dist/sdk/runtime.d.ts +25 -1
  201. package/dist/sdk/runtime.js +46 -3
  202. package/dist/sdk/runtime.js.map +1 -1
  203. package/dist/types.d.ts +6 -0
  204. package/dist/types.js +10 -2
  205. package/dist/types.js.map +1 -1
  206. package/docs/AGENT_GUIDE.md +7 -1
  207. package/docs/ARCHITECTURE.md +1 -1
  208. package/docs/COMMANDS.md +39 -6
  209. package/docs/CONFIGURATION.md +1 -1
  210. package/docs/RELEASING.md +11 -7
  211. package/docs/SDK.md +11 -2
  212. package/package.json +12 -11
  213. package/packages/pm-calendar/README.md +3 -1
  214. package/packages/pm-calendar/extensions/calendar/index.js +21 -2
  215. package/packages/pm-calendar/extensions/calendar/index.ts +21 -2
  216. package/packages/pm-search-advanced/README.md +8 -0
  217. package/packages/pm-search-advanced/extensions/search-advanced/index.js +74 -0
  218. package/packages/pm-search-advanced/extensions/search-advanced/index.ts +74 -0
  219. package/packages/pm-search-advanced/extensions/search-advanced/runtime.js +67 -9
  220. package/packages/pm-search-advanced/extensions/search-advanced/runtime.ts +67 -9
  221. package/packages/pm-templates/extensions/templates/runtime.js +11 -202
  222. package/packages/pm-templates/extensions/templates/runtime.ts +38 -230
  223. package/dist/core/output/command-aware.d.ts +0 -1
  224. package/dist/core/output/command-aware.js +0 -397
  225. package/dist/core/output/command-aware.js.map +0 -1
@@ -1,5 +1,5 @@
1
1
 
2
- !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="f31aa5f9-6785-5b5e-9c34-167ef6e9f543")}catch(e){}}();
2
+ !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="ab5654d4-0aa0-5942-9f7e-b0cf2c952ea8")}catch(e){}}();
3
3
  import { EXIT_CODE } from "../../core/shared/constants.js";
4
4
  import { PmCliError } from "../../core/shared/errors.js";
5
5
  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";
@@ -30,6 +30,7 @@ const COMPLETION_FLAGS = toCompletionFlagString(COMPLETION_FLAG_CONTRACTS);
30
30
  const COMPLETION_SHELL_CHOICES = `${COMPLETION_FLAGS} bash zsh fish`;
31
31
  const GUIDE_TOPIC_CHOICES = joinCompletionValues(listGuideTopicIds());
32
32
  const MUTATION_FLAGS = "--author --message --force --json --quiet --path --no-extensions --no-pager --profile --help";
33
+ const DELETE_MUTATION_FLAGS = "--dry-run --author --message --force --json --quiet --path --no-extensions --no-pager --profile --help";
33
34
  const CLOSE_MUTATION_FLAGS = "--author --message --validate-close --force --json --quiet --path --no-extensions --no-pager --profile --help";
34
35
  const RELEASE_MUTATION_FLAGS = "--allow-audit-release --author --message --force --json --quiet --path --no-extensions --no-pager --profile --help";
35
36
  const GLOBAL_FLAGS = GLOBAL_FLAG_CONTRACTS.flatMap((entry) => [entry.short, entry.flag])
@@ -200,11 +201,20 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
200
201
  ` COMPREPLY=(${compgen(HEALTH_FLAGS)})`,
201
202
  " ;;",
202
203
  " history)",
203
- ` COMPREPLY=(${compgen("--limit --diff --verify --json --quiet --path --no-extensions --no-pager --profile --help")})`,
204
+ ` COMPREPLY=(${compgen("--limit --compact --full --diff --verify --json --quiet --path --no-extensions --no-pager --profile --help")})`,
205
+ " ;;",
206
+ " get)",
207
+ ` COMPREPLY=(${compgen("--depth --full --fields --json --quiet --path --no-extensions --no-pager --profile --help")})`,
204
208
  " ;;",
205
209
  " history-redact)",
206
210
  ` COMPREPLY=(${compgen("--literal --regex --replacement --dry-run --author --message --force --json --quiet --path --no-extensions --no-pager --profile --help")})`,
207
211
  " ;;",
212
+ " history-repair)",
213
+ ` COMPREPLY=(${compgen("--dry-run --author --message --force --json --quiet --path --no-extensions --no-pager --profile --help")})`,
214
+ " ;;",
215
+ " schema)",
216
+ ` COMPREPLY=(${compgen("add-type --description --default-status --folder --alias --author --force --json --quiet --path --no-extensions --no-pager --profile --help")})`,
217
+ " ;;",
208
218
  " plan)",
209
219
  ` COMPREPLY=(${compgen(`${PLAN_SUBCOMMANDS_LIST} ${PLAN_FLAGS}`)})`,
210
220
  " ;;",
@@ -223,7 +233,10 @@ export function generateBashScript(itemTypes = DEFAULT_ITEM_TYPES, tags = [], ea
223
233
  " release)",
224
234
  ` COMPREPLY=(${compgen(RELEASE_MUTATION_FLAGS)})`,
225
235
  " ;;",
226
- " claim|delete|restore|start-task|pause-task)",
236
+ " delete)",
237
+ ` COMPREPLY=(${compgen(DELETE_MUTATION_FLAGS)})`,
238
+ " ;;",
239
+ " claim|restore|start-task|pause-task)",
227
240
  ` COMPREPLY=(${compgen(MUTATION_FLAGS)})`,
228
241
  " ;;",
229
242
  " completion)",
@@ -297,6 +310,8 @@ _pm_commands() {
297
310
  'reindex:Rebuild search artifacts'
298
311
  'history:Show item history entries'
299
312
  'history-redact:Redact sensitive literals/patterns and recompute history hashes'
313
+ 'history-repair:Re-anchor a drifted history chain so pm health/validate report ok'
314
+ 'schema:Register custom item types into .agents/pm/schema/types.json'
300
315
  'plan:Agent-optimized Plan item workflow (create/show/add-step/update-step/complete-step/link/approve/materialize)'
301
316
  'activity:Show recent activity across items'
302
317
  'restore:Restore an item to an earlier state'
@@ -426,7 +441,7 @@ _pm() {
426
441
  '--deadline[Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)]:deadline' \\
427
442
  '--estimate[Estimated minutes]:minutes' \\
428
443
  '--acceptance-criteria[Acceptance criteria]:criteria' \\
429
- '--reminder[Reminder entry at=<iso|relative>,text=<text>]:reminder' \\
444
+ '--reminder[Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>]:reminder' \\
430
445
  '--event[Event entry start=<iso|relative>,end=<iso|relative>,recur_*]:event' \\
431
446
  '--type-option[Type option key=value or key=<name>,value=<value>]:type_option' \\
432
447
  '--unset[Clear scalar metadata field by name]:field' \\
@@ -464,7 +479,7 @@ _pm() {
464
479
  '--file[Linked file path=<value>,scope=<project|global>,note=<text>]:file' \\
465
480
  '--test[Linked test command=<value>,path=<value>,scope=<project|global>]:test' \\
466
481
  '--doc[Linked doc path=<value>,scope=<project|global>,note=<text>]:doc' \\
467
- '--reminder[Reminder entry at=<iso|relative>,text=<text>]:reminder' \\
482
+ '--reminder[Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>]:reminder' \\
468
483
  '--event[Event entry start=<iso|relative>,end=<iso|relative>,recur_*]:event' \\
469
484
  '--type-option[Type option key=value or key=<name>,value=<value>]:type_option' \\
470
485
  '--unset[Clear scalar metadata field by name]:field' \\
@@ -547,7 +562,7 @@ _pm() {
547
562
  '--file[Linked file path=<value>,scope=<project|global>,note=<text>]:file' \\
548
563
  '--test[Linked test command=<value>,path=<value>,scope=<project|global>]:test' \\
549
564
  '--doc[Linked doc path=<value>,scope=<project|global>,note=<text>]:doc' \\
550
- '--reminder[Reminder entry at=<iso|relative>,text=<text>]:reminder' \\
565
+ '--reminder[Reminder entry at=<iso|relative>|date=<iso|relative>,text=<text>|title=<text>]:reminder' \\
551
566
  '--event[Event entry start=<iso|relative>,end=<iso|relative>,recur_*]:event' \\
552
567
  '--type-option[Type option key=value or key=<name>,value=<value>]:type_option' \\
553
568
  '--unset[Clear scalar metadata field by name]:field' \\
@@ -608,7 +623,7 @@ _pm() {
608
623
  '--assignee-filter[Filter assignee presence]:(assigned unassigned)' \\
609
624
  '--sprint[Filter by sprint]:sprint' \\
610
625
  '--release[Filter by release]:release' \\
611
- '--include[Include event sources]:(all deadlines reminders events)' \\
626
+ '--include[Include event sources]:(all deadlines reminders events scheduled)' \\
612
627
  '--recurrence-lookahead-days[Bound open-ended recurrence lookahead]:days' \\
613
628
  '--recurrence-lookback-days[Bound open-ended recurrence lookback]:days' \\
614
629
  '--occurrence-limit[Cap occurrences per recurring event]:number' \\
@@ -665,11 +680,21 @@ _pm() {
665
680
  history)
666
681
  _arguments \\
667
682
  '--limit[Max entries]:number' \\
683
+ '--compact[Condensed history projection]' \\
684
+ '--full[Show full history entries]' \\
668
685
  '--diff[Include changed-field patch summary]' \\
669
686
  '--verify[Verify history hash chain and replay integrity]' \\
670
687
  '--json[Output JSON]' \\
671
688
  '--quiet[Suppress stdout]'
672
689
  ;;
690
+ get)
691
+ _arguments \\
692
+ '--depth[Detail depth]:(brief standard deep)' \\
693
+ '--full[Explicit full item read]' \\
694
+ '--fields[Render custom comma-separated item fields]:fields' \\
695
+ '--json[Output JSON]' \\
696
+ '--quiet[Suppress stdout]'
697
+ ;;
673
698
  history-redact)
674
699
  _arguments \\
675
700
  '--literal[Literal string matcher to redact from history/item payloads]:literal' \\
@@ -682,6 +707,27 @@ _pm() {
682
707
  '--json[Output JSON]' \\
683
708
  '--quiet[Suppress stdout]'
684
709
  ;;
710
+ history-repair)
711
+ _arguments \\
712
+ '--dry-run[Preview the re-anchor impact without writing the history file]' \\
713
+ '--author[Mutation author]:author' \\
714
+ '--message[Audit history message]:message' \\
715
+ '--force[Force ownership/lock override]' \\
716
+ '--json[Output JSON]' \\
717
+ '--quiet[Suppress stdout]'
718
+ ;;
719
+ schema)
720
+ _arguments \\
721
+ '1:subcommand:(add-type)' \\
722
+ '--description[Human description for the custom item type]:text' \\
723
+ '--default-status[Default status hint for the custom item type]:status' \\
724
+ '--folder[Storage folder for items of this custom type]:dir' \\
725
+ '--alias[Alias for the custom type (repeatable)]:name' \\
726
+ '--author[Mutation author]:author' \\
727
+ '--force[Force ownership/lock override]' \\
728
+ '--json[Output JSON]' \\
729
+ '--quiet[Suppress stdout]'
730
+ ;;
685
731
  plan)
686
732
  _arguments \\
687
733
  '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 +761,8 @@ _pm() {
715
761
  '--from[Lower timestamp bound (ISO/date string or relative)]:date' \\
716
762
  '--to[Upper timestamp bound (ISO/date string or relative)]:date' \\
717
763
  '--limit[Max entries]:number' \\
764
+ '--compact[Condensed activity projection]' \\
765
+ '--full[Show full activity entries]' \\
718
766
  '--stream[Emit line-delimited JSON rows]:mode' \\
719
767
  '--json[Output JSON]' \\
720
768
  '--quiet[Suppress stdout]'
@@ -852,6 +900,7 @@ _pm() {
852
900
  '--author[Set the default mutation author for this project]:author' \\
853
901
  '--agent-guidance[Agent guidance mode]:mode:(ask add skip status)' \\
854
902
  '--with-packages[Install bundled first-party packages during initialization]' \\
903
+ '--verbose[Include the full resolved settings tree in init output]' \\
855
904
  '--json[Output JSON]' \\
856
905
  '--quiet[Suppress stdout]'
857
906
  ;;
@@ -864,6 +913,7 @@ _pm() {
864
913
  '--author[Set the default mutation author for this project]:author' \\
865
914
  '--agent-guidance[Agent guidance mode]:mode:(ask add skip status)' \\
866
915
  '--with-packages[Install bundled first-party packages during initialization]' \\
916
+ '--verbose[Include the full resolved settings tree in init output]' \\
867
917
  '--json[Output JSON]' \\
868
918
  '--quiet[Suppress stdout]'
869
919
  ;;
@@ -902,6 +952,15 @@ _pm() {
902
952
  '--json[Output JSON]' \\
903
953
  '--quiet[Suppress stdout]'
904
954
  ;;
955
+ delete)
956
+ _arguments \\
957
+ '--dry-run[Preview the item file that would be deleted without mutating]' \\
958
+ '--author[Mutation author]:author' \\
959
+ '--message[History message]:message' \\
960
+ '--force[Force override]' \\
961
+ '--json[Output JSON]' \\
962
+ '--quiet[Suppress stdout]'
963
+ ;;
905
964
  start-task|pause-task)
906
965
  _arguments \\
907
966
  '--author[Mutation author]:author' \\
@@ -945,6 +1004,8 @@ _pm() {
945
1004
  '--no-refresh[Disable automatic vector refresh attempts during health checks]' \\
946
1005
  '--refresh-vectors[Explicitly enable vector refresh attempts during health checks]' \\
947
1006
  '--verbose-stale-items[Include full stale vectorization ID lists in health output]' \\
1007
+ '--brief[Emit compact health details for low-token agent checks]' \\
1008
+ '--summary[Emit one-line-style health status with check names and warning count]' \\
948
1009
  '--strict-exit[Return non-zero exit when health warnings are present]' \\
949
1010
  '--fail-on-warn[Alias for --strict-exit]' \\
950
1011
  '--json[Output JSON]' \\
@@ -1097,6 +1158,8 @@ complete -c pm -n __pm_no_subcommand -a search -d 'Search items with keyw
1097
1158
  complete -c pm -n __pm_no_subcommand -a reindex -d 'Rebuild search artifacts'
1098
1159
  complete -c pm -n __pm_no_subcommand -a history -d 'Show item history entries'
1099
1160
  complete -c pm -n __pm_no_subcommand -a history-redact -d 'Redact sensitive literals/patterns and recompute history hashes'
1161
+ complete -c pm -n __pm_no_subcommand -a history-repair -d 'Re-anchor a drifted history chain so pm health/validate report ok'
1162
+ complete -c pm -n __pm_no_subcommand -a schema -d 'Register custom item types into .agents/pm/schema/types.json'
1100
1163
  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)'
1101
1164
  complete -c pm -n __pm_no_subcommand -a activity -d 'Show recent activity across items'
1102
1165
  complete -c pm -n __pm_no_subcommand -a restore -d 'Restore an item to an earlier state'
@@ -1195,7 +1258,7 @@ complete -c pm -n '__fish_seen_subcommand_from create' -s b -l body
1195
1258
  complete -c pm -n '__fish_seen_subcommand_from create' -l deadline -d 'Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)' -r
1196
1259
  complete -c pm -n '__fish_seen_subcommand_from create' -l estimate -d 'Estimated minutes' -r
1197
1260
  complete -c pm -n '__fish_seen_subcommand_from create' -l acceptance-criteria -d 'Acceptance criteria' -r
1198
- complete -c pm -n '__fish_seen_subcommand_from create' -l reminder -d 'Reminder entry at=<iso|relative>,text=<text>' -r
1261
+ 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
1199
1262
  complete -c pm -n '__fish_seen_subcommand_from create' -l event -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
1200
1263
  complete -c pm -n '__fish_seen_subcommand_from create' -l type-option -d 'Type option key=value or key=<name>,value=<value>' -r
1201
1264
  complete -c pm -n '__fish_seen_subcommand_from create' -l author -d 'Mutation author' -r
@@ -1227,7 +1290,7 @@ complete -c pm -n '__fish_seen_subcommand_from update' -l learning
1227
1290
  complete -c pm -n '__fish_seen_subcommand_from update' -l file -d 'Linked file path=<value>,scope=<project|global>,note=<text>' -r
1228
1291
  complete -c pm -n '__fish_seen_subcommand_from update' -l test -d 'Linked test command=<value>,path=<value>,scope=<project|global>' -r
1229
1292
  complete -c pm -n '__fish_seen_subcommand_from update' -l doc -d 'Linked doc path=<value>,scope=<project|global>,note=<text>' -r
1230
- complete -c pm -n '__fish_seen_subcommand_from update' -l reminder -d 'Reminder entry at=<iso|relative>,text=<text>' -r
1293
+ 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
1231
1294
  complete -c pm -n '__fish_seen_subcommand_from update' -l event -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
1232
1295
  complete -c pm -n '__fish_seen_subcommand_from update' -l type-option -d 'Type option key=value or key=<name>,value=<value>' -r
1233
1296
  complete -c pm -n '__fish_seen_subcommand_from update' -l unset -d 'Clear scalar metadata field by name' -r
@@ -1309,7 +1372,7 @@ complete -c pm -n '__fish_seen_subcommand_from update-many' -l learning
1309
1372
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l file -d 'Linked file path=<value>,scope=<project|global>,note=<text>' -r
1310
1373
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l test -d 'Linked test command=<value>,path=<value>,scope=<project|global>' -r
1311
1374
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l doc -d 'Linked doc path=<value>,scope=<project|global>,note=<text>' -r
1312
- complete -c pm -n '__fish_seen_subcommand_from update-many' -l reminder -d 'Reminder entry at=<iso|relative>,text=<text>' -r
1375
+ 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
1313
1376
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l event -d 'Event entry start=<iso|relative>,end=<iso|relative>,recur_*' -r
1314
1377
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l type-option -d 'Type option key=value or key=<name>,value=<value>' -r
1315
1378
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l unset -d 'Clear scalar metadata field by name' -r
@@ -1372,7 +1435,7 @@ complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l assignee -d 'Fi
1372
1435
  complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l assignee-filter -d 'Filter assignee presence' -r -a 'assigned unassigned'
1373
1436
  complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l sprint -d 'Filter by sprint' -r
1374
1437
  complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l release -d 'Filter by release' -r
1375
- complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l include -d 'Include event sources' -r -a 'all deadlines reminders events'
1438
+ complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l include -d 'Include event sources' -r -a 'all deadlines reminders events scheduled'
1376
1439
  complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l recurrence-lookahead-days -d 'Bound open-ended recurrence lookahead' -r
1377
1440
  complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l recurrence-lookback-days -d 'Bound open-ended recurrence lookback' -r
1378
1441
  complete -c pm -n '__fish_seen_subcommand_from calendar cal' -l occurrence-limit -d 'Cap occurrences per recurring event' -r
@@ -1404,8 +1467,15 @@ complete -c pm -n '__fish_seen_subcommand_from guide' -a '${guideTopicChoices}'
1404
1467
  complete -c pm -n '__fish_seen_subcommand_from reindex' -l mode -d 'Reindex mode' -r -a 'keyword semantic hybrid'
1405
1468
  complete -c pm -n '__fish_seen_subcommand_from reindex' -l progress -d 'Emit progress updates to stderr'
1406
1469
 
1470
+ # get flags
1471
+ complete -c pm -n '__fish_seen_subcommand_from get' -l depth -d 'Detail depth' -r -a 'brief standard deep'
1472
+ complete -c pm -n '__fish_seen_subcommand_from get' -l full -d 'Explicit full item read'
1473
+ complete -c pm -n '__fish_seen_subcommand_from get' -l fields -d 'Render custom comma-separated item fields' -r
1474
+
1407
1475
  # history / activity flags
1408
1476
  complete -c pm -n '__fish_seen_subcommand_from history' -l limit -d 'Max history entries' -r
1477
+ complete -c pm -n '__fish_seen_subcommand_from history' -l compact -d 'Condensed history projection'
1478
+ complete -c pm -n '__fish_seen_subcommand_from history' -l full -d 'Show full history entries'
1409
1479
  complete -c pm -n '__fish_seen_subcommand_from history' -l diff -d 'Include changed-field patch summary'
1410
1480
  complete -c pm -n '__fish_seen_subcommand_from history' -l verify -d 'Verify history hash chain and replay integrity'
1411
1481
  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 +1485,17 @@ complete -c pm -n '__fish_seen_subcommand_from history-redact' -l dry-run -d 'Pr
1415
1485
  complete -c pm -n '__fish_seen_subcommand_from history-redact' -l author -d 'Mutation author' -r
1416
1486
  complete -c pm -n '__fish_seen_subcommand_from history-redact' -l message -d 'Audit history message' -r
1417
1487
  complete -c pm -n '__fish_seen_subcommand_from history-redact' -l force -d 'Force ownership/lock override'
1488
+ complete -c pm -n '__fish_seen_subcommand_from history-repair' -l dry-run -d 'Preview the re-anchor impact without writing the history file'
1489
+ complete -c pm -n '__fish_seen_subcommand_from history-repair' -l author -d 'Mutation author' -r
1490
+ complete -c pm -n '__fish_seen_subcommand_from history-repair' -l message -d 'Audit history message' -r
1491
+ complete -c pm -n '__fish_seen_subcommand_from history-repair' -l force -d 'Force ownership/lock override'
1492
+ complete -c pm -n '__fish_seen_subcommand_from schema' -a 'add-type' -d 'Schema subcommand'
1493
+ complete -c pm -n '__fish_seen_subcommand_from schema' -l description -d 'Human description for the custom item type' -r
1494
+ complete -c pm -n '__fish_seen_subcommand_from schema' -l default-status -d 'Default status hint for the custom item type' -r
1495
+ complete -c pm -n '__fish_seen_subcommand_from schema' -l folder -d 'Storage folder for items of this custom type' -r
1496
+ complete -c pm -n '__fish_seen_subcommand_from schema' -l alias -d 'Alias for the custom type (repeatable)' -r
1497
+ complete -c pm -n '__fish_seen_subcommand_from schema' -l author -d 'Mutation author' -r
1498
+ complete -c pm -n '__fish_seen_subcommand_from schema' -l force -d 'Force ownership/lock override'
1418
1499
  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'
1419
1500
  complete -c pm -n '__fish_seen_subcommand_from plan' -l title -d 'Plan title' -r
1420
1501
  complete -c pm -n '__fish_seen_subcommand_from plan' -l scope -d 'Plan scope statement' -r
@@ -1441,6 +1522,8 @@ complete -c pm -n '__fish_seen_subcommand_from activity' -l author -d 'Filter by
1441
1522
  complete -c pm -n '__fish_seen_subcommand_from activity' -l from -d 'Lower timestamp bound (ISO/date string or relative)' -r
1442
1523
  complete -c pm -n '__fish_seen_subcommand_from activity' -l to -d 'Upper timestamp bound (ISO/date string or relative)' -r
1443
1524
  complete -c pm -n '__fish_seen_subcommand_from activity' -l limit -d 'Max activity entries' -r
1525
+ complete -c pm -n '__fish_seen_subcommand_from activity' -l compact -d 'Condensed activity projection'
1526
+ complete -c pm -n '__fish_seen_subcommand_from activity' -l full -d 'Show full activity entries'
1444
1527
  complete -c pm -n '__fish_seen_subcommand_from activity' -l stream -d 'Emit line-delimited JSON rows'
1445
1528
  complete -c pm -n '__fish_seen_subcommand_from contracts' -l action -d 'Filter schema by tool action' -r
1446
1529
  complete -c pm -n '__fish_seen_subcommand_from contracts' -l command -d 'Scope output to one command (narrow-by-default)' -r
@@ -1527,11 +1610,12 @@ complete -c pm -n '__fish_seen_subcommand_from append' -l message -d 'History me
1527
1610
  complete -c pm -n '__fish_seen_subcommand_from append' -l force -d 'Force override'
1528
1611
 
1529
1612
  # close flags
1530
- complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task' -l author -d 'Mutation author' -r
1531
- complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task' -l message -d 'History message' -r
1532
- complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task' -l force -d 'Force override'
1613
+ complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l author -d 'Mutation author' -r
1614
+ complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l message -d 'History message' -r
1615
+ complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l force -d 'Force override'
1533
1616
  complete -c pm -n '__fish_seen_subcommand_from close close-task' -l validate-close -d 'Validate closure metadata mode' -r -a 'off warn strict'
1534
1617
  complete -c pm -n '__fish_seen_subcommand_from release' -l allow-audit-release -d 'Allow non-owner release handoffs without requiring --force'
1618
+ complete -c pm -n '__fish_seen_subcommand_from delete' -l dry-run -d 'Preview the item file that would be deleted without mutating'
1535
1619
 
1536
1620
  # validate flags
1537
1621
  complete -c pm -n '__fish_seen_subcommand_from validate' -l check-metadata -d 'Run metadata completeness checks'
@@ -1554,6 +1638,7 @@ complete -c pm -n '__fish_seen_subcommand_from init' -s y -l yes -d 'Alias for -
1554
1638
  complete -c pm -n '__fish_seen_subcommand_from init' -l author -d 'Set the default mutation author for this project' -r
1555
1639
  complete -c pm -n '__fish_seen_subcommand_from init' -l agent-guidance -d 'Agent guidance mode' -r -a 'ask add skip status'
1556
1640
  complete -c pm -n '__fish_seen_subcommand_from init' -l with-packages -d 'Install bundled first-party packages during initialization'
1641
+ complete -c pm -n '__fish_seen_subcommand_from init' -l verbose -d 'Include the full resolved settings tree in init output'
1557
1642
  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
1558
1643
  complete -c pm -n '__fish_seen_subcommand_from config' -l clear-criteria -d 'Clear config criteria-list key values'
1559
1644
  complete -c pm -n '__fish_seen_subcommand_from config' -l format -d 'Item format for item-format key' -r -a 'toon'
@@ -1563,6 +1648,8 @@ complete -c pm -n '__fish_seen_subcommand_from health' -l check-only -d 'Run rea
1563
1648
  complete -c pm -n '__fish_seen_subcommand_from health' -l no-refresh -d 'Disable automatic vector refresh attempts during health checks'
1564
1649
  complete -c pm -n '__fish_seen_subcommand_from health' -l refresh-vectors -d 'Explicitly enable vector refresh attempts during health checks'
1565
1650
  complete -c pm -n '__fish_seen_subcommand_from health' -l verbose-stale-items -d 'Include full stale vectorization ID lists in health output'
1651
+ complete -c pm -n '__fish_seen_subcommand_from health' -l brief -d 'Emit compact health details for low-token agent checks'
1652
+ complete -c pm -n '__fish_seen_subcommand_from health' -l summary -d 'Emit one-line-style health status with check names and warning count'
1566
1653
  complete -c pm -n '__fish_seen_subcommand_from health' -l strict-exit -d 'Return non-zero exit when health warnings are present'
1567
1654
  complete -c pm -n '__fish_seen_subcommand_from health' -l fail-on-warn -d 'Alias for --strict-exit'
1568
1655
  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'
@@ -1642,4 +1729,4 @@ export function runCompletion(shell, itemTypes = DEFAULT_ITEM_TYPES, tags = [],
1642
1729
  };
1643
1730
  }
1644
1731
  //# sourceMappingURL=completion.js.map
1645
- //# debugId=f31aa5f9-6785-5b5e-9c34-167ef6e9f543
1732
+ //# debugId=ab5654d4-0aa0-5942-9f7e-b0cf2c952ea8