@unbrained/pm-cli 2026.5.27 → 2026.5.29

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 (97) hide show
  1. package/CHANGELOG.md +107 -80
  2. package/dist/cli/commander-usage.js +8 -8
  3. package/dist/cli/commander-usage.js.map +1 -1
  4. package/dist/cli/commands/aggregate.js +4 -3
  5. package/dist/cli/commands/aggregate.js.map +1 -1
  6. package/dist/cli/commands/calendar.d.ts +8 -0
  7. package/dist/cli/commands/calendar.js +13 -2
  8. package/dist/cli/commands/calendar.js.map +1 -1
  9. package/dist/cli/commands/close.d.ts +3 -0
  10. package/dist/cli/commands/close.js +24 -2
  11. package/dist/cli/commands/close.js.map +1 -1
  12. package/dist/cli/commands/completion.js +34 -2
  13. package/dist/cli/commands/completion.js.map +1 -1
  14. package/dist/cli/commands/config.d.ts +11 -1
  15. package/dist/cli/commands/config.js +68 -6
  16. package/dist/cli/commands/config.js.map +1 -1
  17. package/dist/cli/commands/create.d.ts +1 -0
  18. package/dist/cli/commands/create.js +40 -4
  19. package/dist/cli/commands/create.js.map +1 -1
  20. package/dist/cli/commands/extension/bundled-catalog.js +4 -3
  21. package/dist/cli/commands/extension/bundled-catalog.js.map +1 -1
  22. package/dist/cli/commands/extension/scaffold.js +54 -21
  23. package/dist/cli/commands/extension/scaffold.js.map +1 -1
  24. package/dist/cli/commands/health.js +3 -11
  25. package/dist/cli/commands/health.js.map +1 -1
  26. package/dist/cli/commands/linked-test-parsers.js +5 -4
  27. package/dist/cli/commands/linked-test-parsers.js.map +1 -1
  28. package/dist/cli/commands/list.js +2 -3
  29. package/dist/cli/commands/list.js.map +1 -1
  30. package/dist/cli/commands/plan.d.ts +5 -0
  31. package/dist/cli/commands/plan.js +59 -10
  32. package/dist/cli/commands/plan.js.map +1 -1
  33. package/dist/cli/commands/search.js +45 -6
  34. package/dist/cli/commands/search.js.map +1 -1
  35. package/dist/cli/commands/test.js +3 -3
  36. package/dist/cli/commands/test.js.map +1 -1
  37. package/dist/cli/commands/update-many.js +35 -6
  38. package/dist/cli/commands/update-many.js.map +1 -1
  39. package/dist/cli/commands/update.d.ts +2 -0
  40. package/dist/cli/commands/update.js +59 -8
  41. package/dist/cli/commands/update.js.map +1 -1
  42. package/dist/cli/commands/validate.js +32 -12
  43. package/dist/cli/commands/validate.js.map +1 -1
  44. package/dist/cli/help-json-payload.d.ts +1 -11
  45. package/dist/cli/help-json-payload.js +12 -12
  46. package/dist/cli/help-json-payload.js.map +1 -1
  47. package/dist/cli/register-mutation.js +64 -5
  48. package/dist/cli/register-mutation.js.map +1 -1
  49. package/dist/cli/register-setup.js +4 -2
  50. package/dist/cli/register-setup.js.map +1 -1
  51. package/dist/cli/registration-helpers.d.ts +2 -6
  52. package/dist/cli/registration-helpers.js +9 -6
  53. package/dist/cli/registration-helpers.js.map +1 -1
  54. package/dist/core/config/nested-settings.d.ts +86 -0
  55. package/dist/core/config/nested-settings.js +258 -0
  56. package/dist/core/config/nested-settings.js.map +1 -0
  57. package/dist/core/item/parse.d.ts +19 -0
  58. package/dist/core/item/parse.js +76 -2
  59. package/dist/core/item/parse.js.map +1 -1
  60. package/dist/core/item/priority.d.ts +2 -1
  61. package/dist/core/item/priority.js +12 -2
  62. package/dist/core/item/priority.js.map +1 -1
  63. package/dist/core/search/providers.js +25 -5
  64. package/dist/core/search/providers.js.map +1 -1
  65. package/dist/core/search/staleness.d.ts +23 -0
  66. package/dist/core/search/staleness.js +34 -0
  67. package/dist/core/search/staleness.js.map +1 -0
  68. package/dist/core/search/vector-stores.js +12 -3
  69. package/dist/core/search/vector-stores.js.map +1 -1
  70. package/dist/core/shared/html-entity-decode.d.ts +21 -0
  71. package/dist/core/shared/html-entity-decode.js +122 -0
  72. package/dist/core/shared/html-entity-decode.js.map +1 -0
  73. package/dist/core/shared/levenshtein.js +23 -7
  74. package/dist/core/shared/levenshtein.js.map +1 -1
  75. package/dist/core/shared/split-comma-list.d.ts +20 -0
  76. package/dist/core/shared/split-comma-list.js +29 -0
  77. package/dist/core/shared/split-comma-list.js.map +1 -0
  78. package/dist/mcp/server.js +10 -3
  79. package/dist/mcp/server.js.map +1 -1
  80. package/dist/sdk/cli-contracts/commander-mutation-options.js +47 -11
  81. package/dist/sdk/cli-contracts/commander-mutation-options.js.map +1 -1
  82. package/dist/sdk/cli-contracts/tool-option-contracts.js +5 -2
  83. package/dist/sdk/cli-contracts/tool-option-contracts.js.map +1 -1
  84. package/dist/sdk/cli-contracts/tool-parameter-tables.js +12 -2
  85. package/dist/sdk/cli-contracts/tool-parameter-tables.js.map +1 -1
  86. package/dist/sdk/cli-contracts.js +30 -2
  87. package/dist/sdk/cli-contracts.js.map +1 -1
  88. package/dist/sdk/runtime.d.ts +1 -1
  89. package/dist/sdk/runtime.js +3 -3
  90. package/dist/sdk/runtime.js.map +1 -1
  91. package/docs/AGENT_GUIDE.md +7 -0
  92. package/docs/COMMANDS.md +17 -0
  93. package/docs/CONFIGURATION.md +55 -0
  94. package/docs/QUICKSTART.md +3 -0
  95. package/package.json +1 -1
  96. package/packages/pm-calendar/extensions/calendar/runtime.js +5 -0
  97. package/packages/pm-calendar/extensions/calendar/runtime.ts +6 -0
@@ -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]="b3284398-1103-5eb4-9c3d-028c20dfa304")}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]="9f9c17c8-52f5-5483-a616-b0a0b1a8b584")}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";
@@ -473,6 +473,7 @@ ${zshListRuntimeFieldFlags} '--json[Output JSON]' \\
473
473
  '(-s --status)'{-s,--status}'[Item status]:(${statusChoices})' \\
474
474
  '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
475
475
  '--tags[Comma-separated tags]:tags' \\
476
+ '--add-tags[Add tags additively without replacing existing]:tags' \\
476
477
  '(-b --body)'{-b,--body}'[Item body]:body' \\
477
478
  '--deadline[Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)]:deadline' \\
478
479
  '--estimate[Estimated minutes]:minutes' \\
@@ -509,6 +510,10 @@ ${zshCreateRuntimeFieldFlags} '--json[Output JSON]' \\
509
510
  '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
510
511
  '--type[Item type]:(${typeChoices})' \\
511
512
  '--tags[Comma-separated tags]:tags' \\
513
+ '--add-tags[Add tags additively without replacing existing]:tags' \\
514
+ '--remove-tags[Remove tags from the existing list]:tags' \\
515
+ '--expected[Short alias for --expected-result]:expected_result' \\
516
+ '--actual[Short alias for --actual-result]:actual_result' \\
512
517
  '--comment[Comment seed author=<value>,created_at=<iso|now>,text=<value>]:comment' \\
513
518
  '--note[Note seed author=<value>,created_at=<iso|now>,text=<value>]:note' \\
514
519
  '--learning[Learning seed author=<value>,created_at=<iso|now>,text=<value>]:learning' \\
@@ -560,6 +565,8 @@ ${zshUpdateRuntimeFieldFlags} '--allow-audit-update[Allow non-owner m
560
565
  '(-p --priority)'{-p,--priority}'[Priority (0-4)]:(0 1 2 3 4)' \\
561
566
  '--type[Item type]:(${typeChoices})' \\
562
567
  '--tags[Comma-separated tags]:tags' \\
568
+ '--add-tags[Add tags additively without replacing existing]:tags' \\
569
+ '--remove-tags[Remove tags from the existing list]:tags' \\
563
570
  '--deadline[Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)]:deadline' \\
564
571
  '--estimate[Estimated minutes]:minutes' \\
565
572
  '--acceptance-criteria[Acceptance criteria]:criteria' \\
@@ -583,6 +590,8 @@ ${zshUpdateRuntimeFieldFlags} '--allow-audit-update[Allow non-owner m
583
590
  '--resolution[Issue resolution summary]:resolution' \\
584
591
  '--expected-result[Issue expected behavior]:expected_result' \\
585
592
  '--actual-result[Issue observed behavior]:actual_result' \\
593
+ '--expected[Short alias for --expected-result]:expected_result' \\
594
+ '--actual[Short alias for --actual-result]:actual_result' \\
586
595
  '--affected-version[Affected version identifier]:affected_version' \\
587
596
  '--fixed-version[Fixed version identifier]:fixed_version' \\
588
597
  '--component[Issue component ownership]:component' \\
@@ -964,9 +973,16 @@ ${zshSearchRuntimeFieldFlags} '--json[Output JSON]' \\
964
973
  ;;
965
974
  close)
966
975
  _arguments \\
976
+ '--reason[Closure reason]:reason' \\
977
+ '--close-reason[Alias for --reason]:close_reason' \\
967
978
  '--author[Mutation author]:author' \\
968
979
  '--message[History message]:message' \\
969
980
  '--validate-close[Validate closure metadata mode]:(off warn strict)' \\
981
+ '--resolution[Closure resolution summary]:resolution' \\
982
+ '--expected-result[Expected behavior note]:expected_result' \\
983
+ '--actual-result[Observed behavior note]:actual_result' \\
984
+ '--expected[Short alias for --expected-result]:expected_result' \\
985
+ '--actual[Short alias for --actual-result]:actual_result' \\
970
986
  '--force[Force override]' \\
971
987
  '--json[Output JSON]' \\
972
988
  '--quiet[Suppress stdout]'
@@ -1301,6 +1317,7 @@ complete -c pm -n '__fish_seen_subcommand_from create' -l schedule-preset
1301
1317
  complete -c pm -n '__fish_seen_subcommand_from create' -s s -l status -d 'Item status' -r -a '${statusChoices}'
1302
1318
  complete -c pm -n '__fish_seen_subcommand_from create' -s p -l priority -d 'Priority (0-4)' -r -a '0 1 2 3 4'
1303
1319
  complete -c pm -n '__fish_seen_subcommand_from create' -l tags -d 'Comma-separated tags' -r
1320
+ complete -c pm -n '__fish_seen_subcommand_from create' -l add-tags -d 'Add tags additively without replacing existing' -r
1304
1321
  complete -c pm -n '__fish_seen_subcommand_from create' -s b -l body -d 'Item body' -r
1305
1322
  complete -c pm -n '__fish_seen_subcommand_from create' -l deadline -d 'Deadline (ISO/date string or relative +6h/+1d/+2w/+6m)' -r
1306
1323
  complete -c pm -n '__fish_seen_subcommand_from create' -l estimate -d 'Estimated minutes' -r
@@ -1332,6 +1349,10 @@ complete -c pm -n '__fish_seen_subcommand_from update' -s s -l status
1332
1349
  complete -c pm -n '__fish_seen_subcommand_from update' -l close-reason -d 'Set close reason' -r
1333
1350
  complete -c pm -n '__fish_seen_subcommand_from update' -s p -l priority -d 'Priority (0-4)' -r -a '0 1 2 3 4'
1334
1351
  complete -c pm -n '__fish_seen_subcommand_from update' -l type -d 'Item type' -r -a '${typeChoices}'
1352
+ complete -c pm -n '__fish_seen_subcommand_from update' -l add-tags -d 'Add tags additively without replacing existing' -r
1353
+ complete -c pm -n '__fish_seen_subcommand_from update' -l remove-tags -d 'Remove tags from the existing list' -r
1354
+ complete -c pm -n '__fish_seen_subcommand_from update' -l expected -d 'Short alias for --expected-result' -r
1355
+ complete -c pm -n '__fish_seen_subcommand_from update' -l actual -d 'Short alias for --actual-result' -r
1335
1356
  complete -c pm -n '__fish_seen_subcommand_from update' -l comment -d 'Comment seed author=<value>,created_at=<iso|now>,text=<value>' -r
1336
1357
  complete -c pm -n '__fish_seen_subcommand_from update' -l note -d 'Note seed author=<value>,created_at=<iso|now>,text=<value>' -r
1337
1358
  complete -c pm -n '__fish_seen_subcommand_from update' -l learning -d 'Learning seed author=<value>,created_at=<iso|now>,text=<value>' -r
@@ -1383,6 +1404,8 @@ complete -c pm -n '__fish_seen_subcommand_from update-many' -s b -l body
1383
1404
  complete -c pm -n '__fish_seen_subcommand_from update-many' -s p -l priority -d 'Priority (0-4)' -r -a '0 1 2 3 4'
1384
1405
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l type -d 'Item type' -r -a '${typeChoices}'
1385
1406
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l tags -d 'Comma-separated tags' -r
1407
+ complete -c pm -n '__fish_seen_subcommand_from update-many' -l add-tags -d 'Add tags additively without replacing existing' -r
1408
+ complete -c pm -n '__fish_seen_subcommand_from update-many' -l remove-tags -d 'Remove tags from the existing list' -r
1386
1409
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l deadline -d 'Deadline (ISO/date string or relative)' -r
1387
1410
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l estimate -d 'Estimated minutes' -r
1388
1411
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l acceptance-criteria -d 'Acceptance criteria' -r
@@ -1406,6 +1429,8 @@ complete -c pm -n '__fish_seen_subcommand_from update-many' -l repro-steps
1406
1429
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l resolution -d 'Issue resolution summary' -r
1407
1430
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l expected-result -d 'Issue expected behavior' -r
1408
1431
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l actual-result -d 'Issue observed behavior' -r
1432
+ complete -c pm -n '__fish_seen_subcommand_from update-many' -l expected -d 'Short alias for --expected-result' -r
1433
+ complete -c pm -n '__fish_seen_subcommand_from update-many' -l actual -d 'Short alias for --actual-result' -r
1409
1434
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l affected-version -d 'Affected version identifier' -r
1410
1435
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l fixed-version -d 'Fixed version identifier' -r
1411
1436
  complete -c pm -n '__fish_seen_subcommand_from update-many' -l component -d 'Issue component ownership' -r
@@ -1667,6 +1692,13 @@ complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-ta
1667
1692
  complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l message -d 'History message' -r
1668
1693
  complete -c pm -n '__fish_seen_subcommand_from claim release start-task pause-task close close-task delete' -l force -d 'Force override'
1669
1694
  complete -c pm -n '__fish_seen_subcommand_from close close-task' -l validate-close -d 'Validate closure metadata mode' -r -a 'off warn strict'
1695
+ complete -c pm -n '__fish_seen_subcommand_from close' -l reason -d 'Closure reason' -r
1696
+ complete -c pm -n '__fish_seen_subcommand_from close' -l close-reason -d 'Alias for --reason' -r
1697
+ complete -c pm -n '__fish_seen_subcommand_from close' -l resolution -d 'Closure resolution summary' -r
1698
+ complete -c pm -n '__fish_seen_subcommand_from close' -l expected-result -d 'Expected behavior note' -r
1699
+ complete -c pm -n '__fish_seen_subcommand_from close' -l actual-result -d 'Observed behavior note' -r
1700
+ complete -c pm -n '__fish_seen_subcommand_from close' -l expected -d 'Short alias for --expected-result' -r
1701
+ complete -c pm -n '__fish_seen_subcommand_from close' -l actual -d 'Short alias for --actual-result' -r
1670
1702
  complete -c pm -n '__fish_seen_subcommand_from release' -l allow-audit-release -d 'Allow non-owner release handoffs without requiring --force'
1671
1703
  complete -c pm -n '__fish_seen_subcommand_from delete' -l dry-run -d 'Preview the item file that would be deleted without mutating'
1672
1704
 
@@ -1782,4 +1814,4 @@ export function runCompletion(shell, itemTypes = DEFAULT_ITEM_TYPES, tags = [],
1782
1814
  };
1783
1815
  }
1784
1816
  //# sourceMappingURL=completion.js.map
1785
- //# debugId=b3284398-1103-5eb4-9c3d-028c20dfa304
1817
+ //# debugId=9f9c17c8-52f5-5483-a616-b0a0b1a8b584