@unbrained/pm-cli 2026.9.7 → 2026.9.9

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 (746) hide show
  1. package/.agents/skills/pm-developer/SKILL.md +12 -4
  2. package/.agents/skills/pm-developer/references/MULTI_AGENT_MERGE.md +19 -10
  3. package/.agents/skills/pm-extensions/SKILL.md +6 -0
  4. package/.agents/skills/pm-sdk/SKILL.md +11 -2
  5. package/.agents/skills/pm-user/SKILL.md +7 -2
  6. package/.agents/skills/pm-user/references/ECOSYSTEM_PLANNING.md +95 -0
  7. package/.claude-plugin/marketplace.json +2 -2
  8. package/CHANGELOG.md +231 -182
  9. package/dist/cli/after-command-context-usage.js +1 -48
  10. package/dist/cli/argv-utils.js +1 -40
  11. package/dist/cli/bootstrap-args.js +1 -9
  12. package/dist/cli/bundle-integrity.js +2 -110
  13. package/dist/cli/commander-usage.js +11 -771
  14. package/dist/cli/commands/activity.js +1 -9
  15. package/dist/cli/commands/aggregate.js +1 -5
  16. package/dist/cli/commands/append.js +1 -5
  17. package/dist/cli/commands/claim.js +1 -5
  18. package/dist/cli/commands/close-many.js +1 -5
  19. package/dist/cli/commands/close.js +1 -9
  20. package/dist/cli/commands/comments.js +1 -5
  21. package/dist/cli/commands/config.js +1 -9
  22. package/dist/cli/commands/context.js +1 -9
  23. package/dist/cli/commands/contracts.js +1 -5
  24. package/dist/cli/commands/copy.js +1 -9
  25. package/dist/cli/commands/create.js +1 -9
  26. package/dist/cli/commands/delete.js +1 -9
  27. package/dist/cli/commands/deps.js +1 -9
  28. package/dist/cli/commands/docs.js +1 -9
  29. package/dist/cli/commands/duplicates.js +1 -9
  30. package/dist/cli/commands/eval.js +1 -9
  31. package/dist/cli/commands/extension/describe.js +1 -5
  32. package/dist/cli/commands/extension/scaffold.js +1 -5
  33. package/dist/cli/commands/extension/shared.js +1 -5
  34. package/dist/cli/commands/extension.js +1 -9
  35. package/dist/cli/commands/files.js +1 -9
  36. package/dist/cli/commands/focus.js +1 -9
  37. package/dist/cli/commands/gc.js +1 -9
  38. package/dist/cli/commands/get.js +1 -9
  39. package/dist/cli/commands/graph.js +1 -10
  40. package/dist/cli/commands/health.js +1 -9
  41. package/dist/cli/commands/history-compact.js +1 -10
  42. package/dist/cli/commands/history-redact.js +1 -11
  43. package/dist/cli/commands/history-repair.js +1 -10
  44. package/dist/cli/commands/history.js +1 -5
  45. package/dist/cli/commands/index.js +1 -58
  46. package/dist/cli/commands/init-agent-guidance.js +1 -9
  47. package/dist/cli/commands/init.js +1 -9
  48. package/dist/cli/commands/learnings.js +1 -5
  49. package/dist/cli/commands/lifecycle-transitions.js +1 -5
  50. package/dist/cli/commands/list.js +1 -9
  51. package/dist/cli/commands/merge.js +1 -11
  52. package/dist/cli/commands/next.js +1 -9
  53. package/dist/cli/commands/notes.js +1 -5
  54. package/dist/cli/commands/plan.js +1 -9
  55. package/dist/cli/commands/profile.js +1 -9
  56. package/dist/cli/commands/restore.js +1 -9
  57. package/dist/cli/commands/scheduling-shortcuts.js +1 -9
  58. package/dist/cli/commands/schema.js +1 -10
  59. package/dist/cli/commands/search.js +1 -9
  60. package/dist/cli/commands/stats.js +1 -9
  61. package/dist/cli/commands/telemetry.js +1 -9
  62. package/dist/cli/commands/test-all.js +1 -9
  63. package/dist/cli/commands/test-runs.js +1 -9
  64. package/dist/cli/commands/test.js +1 -9
  65. package/dist/cli/commands/update-many.js +1 -5
  66. package/dist/cli/commands/update.js +1 -9
  67. package/dist/cli/commands/upgrade.js +1 -5
  68. package/dist/cli/commands/validate.js +1 -15
  69. package/dist/cli/context-intent-invocation.js +1 -20
  70. package/dist/cli/description-stdin.js +1 -17
  71. package/dist/cli/error-guidance.js +1 -1353
  72. package/dist/cli/extension-command-help.js +5 -636
  73. package/dist/cli/extension-command-options.js +1 -427
  74. package/dist/cli/extension-recovery.js +1 -126
  75. package/dist/cli/help-content.js +2 -1001
  76. package/dist/cli/help-json-payload.js +4 -570
  77. package/dist/cli/main.d.ts +4 -0
  78. package/dist/cli/main.js +5 -2573
  79. package/dist/cli/migration-gates.js +1 -289
  80. package/dist/cli/public.js +1 -20
  81. package/dist/cli/register-annotations.js +1 -270
  82. package/dist/cli/register-assurance.js +1 -62
  83. package/dist/cli/register-files-lookup.js +1 -56
  84. package/dist/cli/register-history-activity.d.ts +8 -0
  85. package/dist/cli/register-history-activity.js +2 -0
  86. package/dist/cli/register-history-author.js +1 -38
  87. package/dist/cli/register-history-maintenance.d.ts +9 -0
  88. package/dist/cli/register-history-maintenance.js +2 -0
  89. package/dist/cli/register-list-query.js +10 -943
  90. package/dist/cli/register-mutation-options.js +1 -9
  91. package/dist/cli/register-mutation.d.ts +0 -5
  92. package/dist/cli/register-mutation.js +19 -1893
  93. package/dist/cli/register-operations.js +1 -920
  94. package/dist/cli/register-setup.js +1 -716
  95. package/dist/cli/register-structured-mutation.js +1 -196
  96. package/dist/cli/registration-helpers.js +1 -5
  97. package/dist/cli/runtime-compatibility-boundary.js +4 -42
  98. package/dist/cli/schema-registration-helpers.js +1 -73
  99. package/dist/cli/search-refresh.js +1 -13
  100. package/dist/cli/stats-analytics-json.js +1 -68
  101. package/dist/cli/telemetry-flush.js +1 -10
  102. package/dist/cli-bundle/bundle-manifest.json +164 -156
  103. package/dist/cli-bundle/chunks/{chunk-NPN5I67J.js → chunk-3IPRM75M.js} +3 -3
  104. package/dist/cli-bundle/chunks/chunk-4VL5P22L.js +2 -0
  105. package/dist/cli-bundle/chunks/chunk-AAFBV3U3.js +29 -0
  106. package/dist/cli-bundle/chunks/chunk-D3YVILJJ.js +20 -0
  107. package/dist/cli-bundle/chunks/{chunk-WYRZZ5ZE.js → chunk-DEZPZOQ7.js} +2 -2
  108. package/dist/cli-bundle/chunks/chunk-ECBLPN7B.js +3 -0
  109. package/dist/cli-bundle/chunks/chunk-J6ERHBV2.js +235 -0
  110. package/dist/cli-bundle/chunks/chunk-JUNJ5EKI.js +2 -0
  111. package/dist/cli-bundle/chunks/chunk-L5RCDKQ2.js +2 -0
  112. package/dist/cli-bundle/chunks/chunk-NSAPNEYH.js +2 -0
  113. package/dist/cli-bundle/chunks/chunk-OHNLSGGV.js +79 -0
  114. package/dist/cli-bundle/chunks/chunk-WQKMSFBV.js +5 -0
  115. package/dist/cli-bundle/chunks/{chunk-BAX2BYUW.js → chunk-XZ6T7YPP.js} +256 -150
  116. package/dist/cli-bundle/chunks/{chunk-JT6XF6GE.js → chunk-Z3XVXUVF.js} +4 -4
  117. package/dist/cli-bundle/chunks/register-list-query-UIHRCS6D.js +11 -0
  118. package/dist/cli-bundle/chunks/register-mutation-WHWMGRVX.js +20 -0
  119. package/dist/cli-bundle/chunks/register-operations-64YZYTC5.js +2 -0
  120. package/dist/cli-bundle/chunks/register-setup-PERI45EM.js +2 -0
  121. package/dist/cli-bundle/focused-chunks/chunk-2W4XIYOB.js +2 -0
  122. package/dist/cli-bundle/focused-chunks/chunk-2WSBXIGF.js +12 -0
  123. package/dist/cli-bundle/focused-chunks/chunk-5FHTCOHS.js +3 -0
  124. package/dist/cli-bundle/focused-chunks/chunk-7N6DOREF.js +26 -0
  125. package/dist/cli-bundle/focused-chunks/{chunk-3BZEOXLT.js → chunk-7PC4R5QB.js} +2 -2
  126. package/dist/cli-bundle/focused-chunks/chunk-BUCJUZVG.js +6 -0
  127. package/dist/cli-bundle/focused-chunks/chunk-FE3BABLJ.js +2 -0
  128. package/dist/cli-bundle/focused-chunks/chunk-IWITF53W.js +2 -0
  129. package/dist/cli-bundle/focused-chunks/chunk-OQUGRHKV.js +10 -0
  130. package/dist/cli-bundle/focused-chunks/{chunk-M6PBRFSH.js → chunk-PNKIANFZ.js} +2 -2
  131. package/dist/cli-bundle/focused-chunks/{chunk-LIJIA4TY.js → chunk-QQQ4SAUO.js} +3 -3
  132. package/dist/cli-bundle/focused-chunks/chunk-TTYXF5YD.js +177 -0
  133. package/dist/cli-bundle/focused-chunks/chunk-XNR3DM6J.js +2 -0
  134. package/dist/cli-bundle/focused-chunks/chunk-XSS3APUF.js +9 -0
  135. package/dist/cli-bundle/focused-chunks/chunk-YCDQ2N23.js +8 -0
  136. package/dist/cli-bundle/focused-chunks/chunk-YJUXGS57.js +20 -0
  137. package/dist/cli-bundle/focused-chunks/chunk-ZTCE4UO6.js +58 -0
  138. package/dist/cli-bundle/main.js +20 -20
  139. package/dist/cli-bundle/sdk-authoring.js +1 -1
  140. package/dist/cli-bundle/sdk-contracts.js +2 -2
  141. package/dist/cli-bundle/sdk-core.js +37 -37
  142. package/dist/cli-bundle/sdk-governance.js +1 -1
  143. package/dist/cli-bundle/sdk-graph.js +1 -1
  144. package/dist/cli-bundle/sdk-merge.js +42 -42
  145. package/dist/cli-bundle/sdk-query.js +1 -1
  146. package/dist/cli-bundle/sdk-runtime.js +1 -1
  147. package/dist/cli-bundle/sdk-testing.js +1 -1
  148. package/dist/cli-bundle/sdk.js +11 -11
  149. package/dist/cli.js +1 -104
  150. package/dist/core/checkpoint/checkpoint-gc.js +1 -169
  151. package/dist/core/checkpoint/mutation-checkpoint.js +2 -133
  152. package/dist/core/config/nested-settings.js +1 -534
  153. package/dist/core/config/positional-value.js +1 -109
  154. package/dist/core/diagnostics/remediation.js +1 -506
  155. package/dist/core/extensions/activation-summary-markdown.js +2 -145
  156. package/dist/core/extensions/activation-summary.js +1 -92
  157. package/dist/core/extensions/activation-transaction.js +1 -46
  158. package/dist/core/extensions/capability-usage.js +1 -173
  159. package/dist/core/extensions/command-hook-context.js +1 -13
  160. package/dist/core/extensions/command-metadata-contract.js +1 -22
  161. package/dist/core/extensions/command-visibility-tier.js +1 -29
  162. package/dist/core/extensions/contribution-inventory.js +1 -173
  163. package/dist/core/extensions/exporter-output-contract.js +1 -66
  164. package/dist/core/extensions/extension-candidate.js +1 -18
  165. package/dist/core/extensions/extension-capability-aliases.js +1 -158
  166. package/dist/core/extensions/extension-hook-runtime.js +1 -699
  167. package/dist/core/extensions/extension-policy.js +1 -599
  168. package/dist/core/extensions/extension-registries.js +1 -62
  169. package/dist/core/extensions/extension-runtime-helpers.js +1 -33
  170. package/dist/core/extensions/extension-types.js +1 -102
  171. package/dist/core/extensions/flag-definition-validation.js +1 -52
  172. package/dist/core/extensions/flag-value-types.js +1 -64
  173. package/dist/core/extensions/index.js +1 -526
  174. package/dist/core/extensions/item-field-types.js +1 -39
  175. package/dist/core/extensions/item-fields.js +1 -261
  176. package/dist/core/extensions/loader.js +1 -2223
  177. package/dist/core/extensions/manifest-schema.js +1 -69
  178. package/dist/core/extensions/module-graph-snapshot.js +1 -33
  179. package/dist/core/extensions/preflight-ownership.js +1 -41
  180. package/dist/core/extensions/registration-validation.js +1 -82
  181. package/dist/core/extensions/registration-values.js +1 -209
  182. package/dist/core/extensions/reserved-host-flags.js +1 -36
  183. package/dist/core/extensions/runtime-registrations.js +1 -67
  184. package/dist/core/extensions/service-ownership.js +1 -19
  185. package/dist/core/extensions/version-compat.js +1 -216
  186. package/dist/core/fs/fs-utils.js +2 -158
  187. package/dist/core/fs/host-environment-errors.js +1 -141
  188. package/dist/core/fs/index.js +1 -9
  189. package/dist/core/fs/path-utils.js +1 -17
  190. package/dist/core/governance/content-fields.js +1 -160
  191. package/dist/core/governance/issue-codes.js +1 -151
  192. package/dist/core/governance/metadata-coverage.js +1 -358
  193. package/dist/core/history/drift-cache.js +3 -72
  194. package/dist/core/history/drift-scan.js +1 -342
  195. package/dist/core/history/event-classification.js +1 -109
  196. package/dist/core/history/event-index.js +8 -784
  197. package/dist/core/history/history-compact-bulk.js +1 -104
  198. package/dist/core/history/history-diff.js +1 -158
  199. package/dist/core/history/history-rewrite.d.ts +6 -1
  200. package/dist/core/history/history-rewrite.js +1 -107
  201. package/dist/core/history/history-storage-stats.js +1 -102
  202. package/dist/core/history/history-stream-policy.js +1 -62
  203. package/dist/core/history/history.js +2 -617
  204. package/dist/core/history/identity.js +1 -30
  205. package/dist/core/history/index.js +1 -9
  206. package/dist/core/history/projection.js +1 -196
  207. package/dist/core/history/read.d.ts +9 -0
  208. package/dist/core/history/read.js +1 -57
  209. package/dist/core/history/replay.js +2 -439
  210. package/dist/core/history/version-address.js +1 -32
  211. package/dist/core/history/workspace-history.js +2 -433
  212. package/dist/core/io/body-file.js +1 -62
  213. package/dist/core/io/bulk-ids-input.js +1 -112
  214. package/dist/core/item/actionability.js +1 -327
  215. package/dist/core/item/dependency-reference.js +1 -20
  216. package/dist/core/item/id.js +1 -112
  217. package/dist/core/item/index.js +1 -12
  218. package/dist/core/item/item-format-version.js +1 -78
  219. package/dist/core/item/item-format.js +5 -1473
  220. package/dist/core/item/item-record.js +1 -23
  221. package/dist/core/item/item-type-definition.js +1 -133
  222. package/dist/core/item/parent-reference-policy.js +1 -57
  223. package/dist/core/item/parse.js +2 -603
  224. package/dist/core/item/plan-lifecycle.js +1 -19
  225. package/dist/core/item/priority.js +1 -61
  226. package/dist/core/item/sprint-release-format.js +1 -38
  227. package/dist/core/item/status-filter.js +1 -115
  228. package/dist/core/item/status.js +1 -43
  229. package/dist/core/item/toon-decode.js +1 -29
  230. package/dist/core/item/type-registry.js +1 -715
  231. package/dist/core/item/type-synonyms.js +1 -38
  232. package/dist/core/lock/index.js +1 -9
  233. package/dist/core/lock/lock-gc.js +1 -240
  234. package/dist/core/lock/lock.js +3 -590
  235. package/dist/core/output/mutation-projection.js +1 -217
  236. package/dist/core/output/output-control.js +1 -25
  237. package/dist/core/output/output.js +11 -494
  238. package/dist/core/output/query-summary.js +1 -58
  239. package/dist/core/output/tabular.js +1 -77
  240. package/dist/core/packages/manifest.js +1 -244
  241. package/dist/core/packages/root.js +1 -84
  242. package/dist/core/policy/workflow-policy-schema.d.ts +312 -0
  243. package/dist/core/policy/workflow-policy-schema.js +2 -0
  244. package/dist/core/policy/workflow-policy-store.d.ts +24 -0
  245. package/dist/core/policy/workflow-policy-store.js +2 -0
  246. package/dist/core/policy/workflow-policy.d.ts +139 -0
  247. package/dist/core/policy/workflow-policy.js +2 -0
  248. package/dist/core/profile/profile-describe.js +1 -83
  249. package/dist/core/profile/profile-lint.js +1 -415
  250. package/dist/core/profile/profile-plan.js +0 -0
  251. package/dist/core/profile/profile-presets.js +1 -370
  252. package/dist/core/reproducibility/context.js +1 -82
  253. package/dist/core/schema/fields-file.js +2 -288
  254. package/dist/core/schema/item-types-file.js +2 -296
  255. package/dist/core/schema/runtime-field-filters.js +1 -49
  256. package/dist/core/schema/runtime-field-values.js +1 -313
  257. package/dist/core/schema/runtime-schema.js +2 -826
  258. package/dist/core/schema/status-defs-file.js +2 -227
  259. package/dist/core/schema/status-token.js +1 -31
  260. package/dist/core/schema/type-inference.js +1 -95
  261. package/dist/core/schema/type-presets.js +1 -87
  262. package/dist/core/schema/type-workflows.js +1 -104
  263. package/dist/core/search/background-refresh.js +2 -286
  264. package/dist/core/search/bm25.js +1 -146
  265. package/dist/core/search/cache.js +2 -534
  266. package/dist/core/search/corpus.js +1 -311
  267. package/dist/core/search/embedding-batches.js +1 -163
  268. package/dist/core/search/eval.js +1 -225
  269. package/dist/core/search/http-client.js +1 -75
  270. package/dist/core/search/providers.js +1 -242
  271. package/dist/core/search/relevance.js +1 -244
  272. package/dist/core/search/semantic-defaults.js +1 -199
  273. package/dist/core/search/staleness.js +1 -30
  274. package/dist/core/search/vector-stores.js +2 -664
  275. package/dist/core/search/vectorization-metadata.js +1 -81
  276. package/dist/core/sentry/helpers.js +1 -272
  277. package/dist/core/sentry/instrument.js +1 -387
  278. package/dist/core/session/session-state.js +1 -260
  279. package/dist/core/shared/agent-session-context.js +1 -133
  280. package/dist/core/shared/author.js +1 -1172
  281. package/dist/core/shared/command-types.js +1 -4
  282. package/dist/core/shared/conflict-markers.js +1 -31
  283. package/dist/core/shared/constants.js +1 -405
  284. package/dist/core/shared/errors.js +1 -20
  285. package/dist/core/shared/html-entity-decode.js +1 -131
  286. package/dist/core/shared/index.js +1 -12
  287. package/dist/core/shared/item-metadata-contract.js +1 -89
  288. package/dist/core/shared/lazy-module.js +1 -16
  289. package/dist/core/shared/levenshtein.js +1 -61
  290. package/dist/core/shared/memo.js +1 -19
  291. package/dist/core/shared/numeric-parsers.js +1 -20
  292. package/dist/core/shared/option-alias-visibility.js +1 -67
  293. package/dist/core/shared/primitives.js +1 -127
  294. package/dist/core/shared/serial-queue.js +1 -79
  295. package/dist/core/shared/serialization.js +1 -210
  296. package/dist/core/shared/split-comma-list.js +1 -30
  297. package/dist/core/shared/text-normalization.js +1 -38
  298. package/dist/core/shared/time.js +1 -306
  299. package/dist/core/store/index.js +1 -12
  300. package/dist/core/store/item-format-migration.js +1 -125
  301. package/dist/core/store/item-metadata-cache.js +1 -1116
  302. package/dist/core/store/item-metadata-query-index.js +9 -394
  303. package/dist/core/store/item-metadata-read-work.js +1 -43
  304. package/dist/core/store/item-store.js +1 -693
  305. package/dist/core/store/paths.d.ts +1 -1
  306. package/dist/core/store/paths.js +1 -214
  307. package/dist/core/store/settings-read-cache.js +1 -85
  308. package/dist/core/store/settings-validator.d.ts +1 -0
  309. package/dist/core/store/settings-validator.js +1 -421
  310. package/dist/core/store/settings.js +3 -1309
  311. package/dist/core/store/tracker-preflight.js +1 -141
  312. package/dist/core/telemetry/consent.js +5 -108
  313. package/dist/core/telemetry/observability.js +1 -246
  314. package/dist/core/telemetry/runtime.js +4 -1988
  315. package/dist/core/test/background-runs.js +4 -945
  316. package/dist/core/test/item-test-run-tracking.js +1 -63
  317. package/dist/core/test/run-selectors.js +1 -120
  318. package/dist/core/validate/estimate-defaults.js +1 -89
  319. package/dist/core/validate/fix-planning.js +1 -189
  320. package/dist/core/validate/linked-artifact-reference.js +1 -36
  321. package/dist/core/validate/missing-by-type.js +1 -34
  322. package/dist/core/validate/missing-link-owners.js +1 -95
  323. package/dist/core/validate/stale-file-classification.js +1 -82
  324. package/dist/mcp/http-server.js +5 -448
  325. package/dist/mcp/legacy-adapter.js +1 -77
  326. package/dist/mcp/runtime-capabilities.js +1 -200
  327. package/dist/mcp/server.js +4 -1233
  328. package/dist/mcp/tool-definitions.js +1 -804
  329. package/dist/sdk/actionability.js +1 -13
  330. package/dist/sdk/agent/closed-domain-contracts.js +1 -161
  331. package/dist/sdk/agent/command-recovery.js +1 -59
  332. package/dist/sdk/agent/command-suggestions.js +1 -66
  333. package/dist/sdk/agent/create-option-policy.js +1 -31
  334. package/dist/sdk/agent/identity-config.js +1 -106
  335. package/dist/sdk/agent/item-addressing.js +1 -207
  336. package/dist/sdk/agent/refusal-closure-census.js +1 -151
  337. package/dist/sdk/agent/refusal-closure.js +1 -133
  338. package/dist/sdk/agent/refusal-corpus-contracts.js +1 -193
  339. package/dist/sdk/agent/refusal-reachability.js +1 -593
  340. package/dist/sdk/agent/subcommand-recovery.js +1 -83
  341. package/dist/sdk/agent/task-transcript-contracts.js +1 -197
  342. package/dist/sdk/agent/tracker-preflight-contracts.js +1 -126
  343. package/dist/sdk/agent-capability-contracts.js +1 -428
  344. package/dist/sdk/agent-session-context.js +1 -9
  345. package/dist/sdk/annotations.js +1 -448
  346. package/dist/sdk/author-attribution.js +1 -468
  347. package/dist/sdk/authoring.js +1 -20
  348. package/dist/sdk/cli-bootstrap.js +1 -838
  349. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +1 -1
  350. package/dist/sdk/cli-contracts/agent-output-contracts.js +4 -476
  351. package/dist/sdk/cli-contracts/bootstrap-command-scanner.js +1 -79
  352. package/dist/sdk/cli-contracts/command-aliases.d.ts +4 -0
  353. package/dist/sdk/cli-contracts/command-aliases.js +1 -107
  354. package/dist/sdk/cli-contracts/command-exit-contracts.js +1 -151
  355. package/dist/sdk/cli-contracts/commander-mutation-options.js +1 -1081
  356. package/dist/sdk/cli-contracts/commander-types.js +1 -159
  357. package/dist/sdk/cli-contracts/completeness.js +1 -393
  358. package/dist/sdk/cli-contracts/enum-contracts.d.ts +1 -1
  359. package/dist/sdk/cli-contracts/enum-contracts.js +1 -222
  360. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1947
  361. package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -347
  362. package/dist/sdk/cli-contracts/grammar-contracts.js +1 -986
  363. package/dist/sdk/cli-contracts/registration-helpers.js +7 -990
  364. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +5 -0
  365. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -2090
  366. package/dist/sdk/cli-contracts/schemas/assurance-definition.js +1 -324
  367. package/dist/sdk/cli-contracts/string-lists.js +1 -16
  368. package/dist/sdk/cli-contracts/tool-option-contracts.js +1 -461
  369. package/dist/sdk/cli-contracts/tool-parameter-tables.js +1 -2167
  370. package/dist/sdk/cli-contracts/tool-schema.d.ts +3 -1
  371. package/dist/sdk/cli-contracts/tool-schema.js +1 -1664
  372. package/dist/sdk/cli-contracts/typed-action-inputs.js +1 -4
  373. package/dist/sdk/cli-contracts.d.ts +1 -1
  374. package/dist/sdk/cli-contracts.js +1 -17
  375. package/dist/sdk/cli-program.js +1 -49
  376. package/dist/sdk/command-line.d.ts +2 -5
  377. package/dist/sdk/command-line.js +1 -78
  378. package/dist/sdk/comments.js +1 -133
  379. package/dist/sdk/compile-cache.js +1 -73
  380. package/dist/sdk/completion.js +174 -839
  381. package/dist/sdk/compose.js +1 -1090
  382. package/dist/sdk/config.js +1 -1204
  383. package/dist/sdk/context/recency.js +1 -33
  384. package/dist/sdk/context/semantic-session-attribution.js +1 -82
  385. package/dist/sdk/context/usage-egress.js +1 -29
  386. package/dist/sdk/context/usage-ledger.js +3 -185
  387. package/dist/sdk/context-intent-contracts.js +1 -709
  388. package/dist/sdk/context-intent-runtime.js +1 -115
  389. package/dist/sdk/context-packing.js +1 -218
  390. package/dist/sdk/context-relevance.js +1 -503
  391. package/dist/sdk/context-signal-store.js +2 -426
  392. package/dist/sdk/context-usage.js +1 -367
  393. package/dist/sdk/contracts.js +1 -23
  394. package/dist/sdk/core-governance.js +1 -14
  395. package/dist/sdk/core.js +1 -14
  396. package/dist/sdk/corpus-shape.js +1 -401
  397. package/dist/sdk/define.js +1 -220
  398. package/dist/sdk/dependencies.js +1 -718
  399. package/dist/sdk/dependency-flag-validation.js +1 -156
  400. package/dist/sdk/dependency-provenance.js +1 -135
  401. package/dist/sdk/docs.js +1 -14
  402. package/dist/sdk/duplicates.js +1 -40
  403. package/dist/sdk/environment/agent-environment.js +1 -466
  404. package/dist/sdk/environment/host-environment-errors.js +1 -8
  405. package/dist/sdk/environment/project-runtime-compatibility.js +1 -481
  406. package/dist/sdk/environment/source-context.js +1 -28
  407. package/dist/sdk/environment/tracker-preflight.js +1 -9
  408. package/dist/sdk/error-code-catalog.js +1 -153
  409. package/dist/sdk/error-runtime.js +1 -58
  410. package/dist/sdk/errors.js +1 -58
  411. package/dist/sdk/eval.js +1 -190
  412. package/dist/sdk/extension/author-manifest.js +1 -92
  413. package/dist/sdk/extension/bundled-catalog.js +1 -332
  414. package/dist/sdk/extension/concurrency.js +1 -25
  415. package/dist/sdk/extension/copy-scope.d.ts +2 -0
  416. package/dist/sdk/extension/copy-scope.js +2 -0
  417. package/dist/sdk/extension/custom-field-collisions.js +1 -30
  418. package/dist/sdk/extension/describe.js +3 -189
  419. package/dist/sdk/extension/doctor.js +1 -606
  420. package/dist/sdk/extension/install-plan.d.ts +69 -0
  421. package/dist/sdk/extension/install-plan.js +2 -0
  422. package/dist/sdk/extension/install-receipts.d.ts +7 -0
  423. package/dist/sdk/extension/install-receipts.js +2 -0
  424. package/dist/sdk/extension/install-runtime.js +3 -313
  425. package/dist/sdk/extension/install-snapshot.js +1 -66
  426. package/dist/sdk/extension/install-sources.js +5 -1057
  427. package/dist/sdk/extension/managed-state.js +2 -252
  428. package/dist/sdk/extension/migrations.js +2 -174
  429. package/dist/sdk/extension/output-ownership.js +1 -25
  430. package/dist/sdk/extension/runtime-summary.js +1 -18
  431. package/dist/sdk/extension/scaffold.js +4 -2308
  432. package/dist/sdk/extension/shared.js +1 -147
  433. package/dist/sdk/extension/source-resolution.js +1 -65
  434. package/dist/sdk/extension/update-check.js +1 -67
  435. package/dist/sdk/extension-command-context.js +1 -44
  436. package/dist/sdk/extension-contracts.js +1 -73
  437. package/dist/sdk/extension.d.ts +7 -2
  438. package/dist/sdk/extension.js +1 -2196
  439. package/dist/sdk/files.js +1 -535
  440. package/dist/sdk/flag-invocation-contracts.d.ts +0 -5
  441. package/dist/sdk/flag-invocation-contracts.js +1 -344
  442. package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -2224
  443. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -2236
  444. package/dist/sdk/generated-error-code-catalog.js +1 -16
  445. package/dist/sdk/governance/assurance-action-contracts.js +1 -4
  446. package/dist/sdk/governance/assurance-action.js +1 -411
  447. package/dist/sdk/governance/assurance-limits.js +1 -10
  448. package/dist/sdk/governance/assurance-mutation-error.js +1 -81
  449. package/dist/sdk/governance/assurance-presets.js +1 -135
  450. package/dist/sdk/governance/assurance-runtime.js +1 -238
  451. package/dist/sdk/governance/assurance.js +4 -1182
  452. package/dist/sdk/governance/boundary-fixtures.js +1 -200
  453. package/dist/sdk/governance/coverage-assurance.js +1 -60
  454. package/dist/sdk/governance/defect-recurrence-coverage.js +1 -188
  455. package/dist/sdk/governance/defect-recurrence-graph.js +1 -120
  456. package/dist/sdk/governance/defect-recurrence-signals.js +1 -24
  457. package/dist/sdk/governance/defect-recurrence.js +1 -623
  458. package/dist/sdk/governance/extension-host-version.js +1 -115
  459. package/dist/sdk/governance/gc.js +1 -368
  460. package/dist/sdk/governance/health.js +1 -2367
  461. package/dist/sdk/governance/hierarchy-validation.js +1 -108
  462. package/dist/sdk/governance/linked-file-report.js +1 -71
  463. package/dist/sdk/governance/merge-receipt-history.js +1 -206
  464. package/dist/sdk/governance/provenance-health.js +1 -282
  465. package/dist/sdk/governance/reindex.js +4 -761
  466. package/dist/sdk/governance/stale-work.js +1 -82
  467. package/dist/sdk/governance/status-role-diagnostics.js +1 -35
  468. package/dist/sdk/governance/storage-integrity.js +1 -280
  469. package/dist/sdk/governance/tracked-runtime-cache.js +1 -106
  470. package/dist/sdk/governance/upgrade.js +2 -327
  471. package/dist/sdk/governance/validate-history-drift.js +1 -81
  472. package/dist/sdk/governance/validate-item-reader.js +1 -17
  473. package/dist/sdk/governance/validate-normalization.js +1 -36
  474. package/dist/sdk/governance/validate.d.ts +3 -1
  475. package/dist/sdk/governance/validate.js +1 -2261
  476. package/dist/sdk/governance/workflow-completeness.d.ts +32 -0
  477. package/dist/sdk/governance/workflow-completeness.js +2 -0
  478. package/dist/sdk/governance/workflow-policy.d.ts +47 -0
  479. package/dist/sdk/governance/workflow-policy.js +4 -0
  480. package/dist/sdk/governance/workspace-position.js +1 -163
  481. package/dist/sdk/governance.d.ts +2 -0
  482. package/dist/sdk/governance.js +1 -31
  483. package/dist/sdk/graph/adapter.js +1 -181
  484. package/dist/sdk/graph/analytics.js +1 -474
  485. package/dist/sdk/graph/assembly.js +1 -377
  486. package/dist/sdk/graph/cache.js +1 -160
  487. package/dist/sdk/graph/centrality.js +1 -258
  488. package/dist/sdk/graph/conformance.js +1 -130
  489. package/dist/sdk/graph/deadline-scheduling.d.ts +90 -0
  490. package/dist/sdk/graph/deadline-scheduling.js +2 -0
  491. package/dist/sdk/graph/durable-cache.d.ts +1 -1
  492. package/dist/sdk/graph/durable-cache.js +1 -361
  493. package/dist/sdk/graph/governance-contracts.js +1 -34
  494. package/dist/sdk/graph/governance.d.ts +13 -1
  495. package/dist/sdk/graph/governance.js +1 -735
  496. package/dist/sdk/graph/hierarchy-integrity.js +1 -310
  497. package/dist/sdk/graph/index.d.ts +3 -2
  498. package/dist/sdk/graph/index.js +1 -26
  499. package/dist/sdk/graph/lifecycle-coverage.d.ts +32 -0
  500. package/dist/sdk/graph/lifecycle-coverage.js +2 -0
  501. package/dist/sdk/graph/mutation-advisory.js +1 -176
  502. package/dist/sdk/graph/remediation.js +1 -197
  503. package/dist/sdk/graph/run.d.ts +15 -1
  504. package/dist/sdk/graph/run.js +1 -768
  505. package/dist/sdk/graph/scheduling.js +1 -124
  506. package/dist/sdk/graph/traversal.js +1 -284
  507. package/dist/sdk/graph/workspace-relationship-kind-registry.js +1 -27
  508. package/dist/sdk/graph.js +1 -15
  509. package/dist/sdk/guide-topics.js +1 -707
  510. package/dist/sdk/guide.js +1 -279
  511. package/dist/sdk/history/maintenance.d.ts +71 -0
  512. package/dist/sdk/history/maintenance.js +2 -0
  513. package/dist/sdk/history/salvage.js +2 -247
  514. package/dist/sdk/history/subject.d.ts +19 -0
  515. package/dist/sdk/history/subject.js +2 -0
  516. package/dist/sdk/history-analytics.js +1 -282
  517. package/dist/sdk/history-compact.js +1 -527
  518. package/dist/sdk/history-mcp.js +1 -68
  519. package/dist/sdk/history-provenance.js +1 -182
  520. package/dist/sdk/history-read.js +1 -96
  521. package/dist/sdk/history-redact.d.ts +1 -14
  522. package/dist/sdk/history-redact.js +1 -643
  523. package/dist/sdk/history-repair.d.ts +5 -0
  524. package/dist/sdk/history-repair.js +1 -657
  525. package/dist/sdk/improvement-ledger-validation.js +1 -62
  526. package/dist/sdk/improvement-ledger.js +2 -257
  527. package/dist/sdk/index.d.ts +4 -1
  528. package/dist/sdk/index.js +1 -183
  529. package/dist/sdk/init-agent-guidance.js +2 -496
  530. package/dist/sdk/init.js +2 -820
  531. package/dist/sdk/invocation-author.js +1 -39
  532. package/dist/sdk/item-children.js +1 -90
  533. package/dist/sdk/item-metadata-index.js +1 -15
  534. package/dist/sdk/item-schedule.js +1 -27
  535. package/dist/sdk/item-transaction.js +1 -396
  536. package/dist/sdk/learnings.js +1 -29
  537. package/dist/sdk/lifecycle/append.js +2 -53
  538. package/dist/sdk/lifecycle/claim.d.ts +2 -0
  539. package/dist/sdk/lifecycle/claim.js +1 -242
  540. package/dist/sdk/lifecycle/close-many.js +1 -438
  541. package/dist/sdk/lifecycle/close.js +1 -468
  542. package/dist/sdk/lifecycle/copy.js +1 -212
  543. package/dist/sdk/lifecycle/create.js +1 -1949
  544. package/dist/sdk/lifecycle/delete.js +1 -45
  545. package/dist/sdk/lifecycle/event-validation-messages.js +1 -91
  546. package/dist/sdk/lifecycle/focus.js +1 -91
  547. package/dist/sdk/lifecycle/hierarchy-mutation-lock.js +1 -24
  548. package/dist/sdk/lifecycle/legacy-none-tokens.js +1 -149
  549. package/dist/sdk/lifecycle/lifecycle-transitions.js +1 -40
  550. package/dist/sdk/lifecycle/mcp-actions.d.ts +2 -0
  551. package/dist/sdk/lifecycle/mcp-actions.js +1 -51
  552. package/dist/sdk/lifecycle/metadata-normalizers.js +1 -46
  553. package/dist/sdk/lifecycle/mutation-command-options.js +1 -9
  554. package/dist/sdk/lifecycle/plan.js +1 -1606
  555. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +1 -1
  556. package/dist/sdk/lifecycle/recurrence-parsers.js +1 -147
  557. package/dist/sdk/lifecycle/reopen.js +1 -68
  558. package/dist/sdk/lifecycle/repeatable-metadata-parsers.js +1 -143
  559. package/dist/sdk/lifecycle/restore.d.ts +1 -0
  560. package/dist/sdk/lifecycle/restore.js +1 -330
  561. package/dist/sdk/lifecycle/shared-unset-fields.js +1 -295
  562. package/dist/sdk/lifecycle/update-many.js +1 -861
  563. package/dist/sdk/lifecycle/update.js +1 -2136
  564. package/dist/sdk/lifecycle-completion.js +1 -92
  565. package/dist/sdk/lifecycle-policy.js +1 -120
  566. package/dist/sdk/linked-artifacts.js +1 -530
  567. package/dist/sdk/mcp/apps.js +4 -133
  568. package/dist/sdk/mcp/authorization.js +1 -404
  569. package/dist/sdk/mcp/discovery.js +1 -494
  570. package/dist/sdk/mcp/interactions.js +1 -336
  571. package/dist/sdk/mcp/protocol.d.ts +7 -0
  572. package/dist/sdk/mcp/protocol.js +1 -184
  573. package/dist/sdk/mcp/skills.js +1 -389
  574. package/dist/sdk/mcp/subscriptions.js +1 -211
  575. package/dist/sdk/mcp/tasks.js +2 -430
  576. package/dist/sdk/mcp/transport.js +1 -260
  577. package/dist/sdk/merge/abandoned-receipts.js +1 -46
  578. package/dist/sdk/merge/driver.js +1 -212
  579. package/dist/sdk/merge/index.js +1 -16
  580. package/dist/sdk/merge/install.js +3 -561
  581. package/dist/sdk/merge/receipt-file-boundary.js +1 -46
  582. package/dist/sdk/merge/receipt-operation.js +1 -96
  583. package/dist/sdk/merge/receipt-schema.js +1 -397
  584. package/dist/sdk/merge/receipts.js +4 -525
  585. package/dist/sdk/merge/reconcile.js +1 -352
  586. package/dist/sdk/merge/three-way.js +3 -775
  587. package/dist/sdk/merge.js +1 -10
  588. package/dist/sdk/mutation-events.js +1 -292
  589. package/dist/sdk/mutation-guard.js +1 -216
  590. package/dist/sdk/notes.js +1 -139
  591. package/dist/sdk/output-contracts.js +1 -172
  592. package/dist/sdk/output-projection.js +1 -430
  593. package/dist/sdk/output-token-accounting.js +1 -140
  594. package/dist/sdk/output.js +1 -64
  595. package/dist/sdk/ownership-source.js +1 -21
  596. package/dist/sdk/package-import-adapters.js +1 -442
  597. package/dist/sdk/package-migrations.js +1 -20
  598. package/dist/sdk/package-runtime-options.js +1 -80
  599. package/dist/sdk/pagination.js +1 -162
  600. package/dist/sdk/profile.js +1 -454
  601. package/dist/sdk/provenance.js +1 -258
  602. package/dist/sdk/public-surface.json +1 -1
  603. package/dist/sdk/query/activity.js +1 -401
  604. package/dist/sdk/query/aggregate.d.ts +16 -0
  605. package/dist/sdk/query/aggregate.js +1 -390
  606. package/dist/sdk/query/calendar.js +1 -964
  607. package/dist/sdk/query/complete-list.js +1 -215
  608. package/dist/sdk/query/context.js +1 -1702
  609. package/dist/sdk/query/duplicate-candidates.js +1 -70
  610. package/dist/sdk/query/get.js +1 -450
  611. package/dist/sdk/query/history.js +1 -186
  612. package/dist/sdk/query/item-filter-options.js +1 -9
  613. package/dist/sdk/query/light-metadata.js +1 -18
  614. package/dist/sdk/query/list-filter-shared.js +1 -81
  615. package/dist/sdk/query/list.js +1 -1304
  616. package/dist/sdk/query/multi-value-filters.js +1 -78
  617. package/dist/sdk/query/next.js +1 -513
  618. package/dist/sdk/query/parsers.js +1 -44
  619. package/dist/sdk/query/projection-contracts.js +1 -184
  620. package/dist/sdk/query/search-contracts.d.ts +27 -0
  621. package/dist/sdk/query/search-contracts.js +1 -230
  622. package/dist/sdk/query/search-pagination.js +1 -35
  623. package/dist/sdk/query/search-rendering.js +1 -105
  624. package/dist/sdk/query/search.d.ts +6 -4
  625. package/dist/sdk/query/search.js +2 -1987
  626. package/dist/sdk/query.js +1 -35
  627. package/dist/sdk/read-output/continuation.js +1 -194
  628. package/dist/sdk/read-output-budget.js +1 -135
  629. package/dist/sdk/read-output-contracts.d.ts +1 -1
  630. package/dist/sdk/read-output-contracts.js +1 -1225
  631. package/dist/sdk/read-output-rows.js +1 -186
  632. package/dist/sdk/read-output-session.js +1 -208
  633. package/dist/sdk/relationship-analytics.js +1 -410
  634. package/dist/sdk/relationship-context.js +1 -284
  635. package/dist/sdk/relationship-history.js +4 -519
  636. package/dist/sdk/relationship-kinds/contract.js +1 -22
  637. package/dist/sdk/relationship-migration.js +1 -77
  638. package/dist/sdk/relationships.js +1 -579
  639. package/dist/sdk/reproducibility/process.js +1 -87
  640. package/dist/sdk/runtime-action-aliases.js +1 -59
  641. package/dist/sdk/runtime-extended-actions.js +1 -177
  642. package/dist/sdk/runtime-input.js +1 -614
  643. package/dist/sdk/runtime-primitives.js +1 -84
  644. package/dist/sdk/runtime-public-contracts.d.ts +2 -1
  645. package/dist/sdk/runtime-public-contracts.js +1 -4
  646. package/dist/sdk/runtime-stats-options.js +1 -38
  647. package/dist/sdk/runtime.d.ts +4 -0
  648. package/dist/sdk/runtime.js +1 -1928
  649. package/dist/sdk/scheduling-shortcuts.js +1 -63
  650. package/dist/sdk/schema-migration.js +3 -856
  651. package/dist/sdk/schema.d.ts +2 -1
  652. package/dist/sdk/schema.js +1 -1376
  653. package/dist/sdk/search-refresh-worker.js +1 -18
  654. package/dist/sdk/similarity-scoring.js +1 -53
  655. package/dist/sdk/similarity.js +1 -326
  656. package/dist/sdk/start-task-status.js +1 -14
  657. package/dist/sdk/stats.js +1 -270
  658. package/dist/sdk/structured-mutations.js +1 -580
  659. package/dist/sdk/telemetry-flush.js +1 -13
  660. package/dist/sdk/telemetry.js +1 -405
  661. package/dist/sdk/templates.js +2 -292
  662. package/dist/sdk/test/batch.js +2 -509
  663. package/dist/sdk/test/entry.js +1 -70
  664. package/dist/sdk/test/execution.js +6 -2211
  665. package/dist/sdk/test/linked-command-detection.js +1 -546
  666. package/dist/sdk/test/measurements.js +1 -91
  667. package/dist/sdk/test/parsers.js +1 -545
  668. package/dist/sdk/test/runs.js +1 -193
  669. package/dist/sdk/test/trust.js +2 -206
  670. package/dist/sdk/testing.js +4 -1391
  671. package/dist/sdk/traceability/runtime-files-lookup.js +1 -32
  672. package/dist/sdk/traceability/source-traceability.js +1 -292
  673. package/dist/sdk/tracker-root-discovery.js +1 -9
  674. package/dist/sdk/workspace-contracts-cache.js +1 -28
  675. package/dist/sdk/workspace-contracts.js +1 -33
  676. package/dist/sdk/workspace-memory.js +2 -318
  677. package/dist/sdk/workspace-recipe.js +1 -71
  678. package/dist/sdk/workspace-snapshot.js +4 -613
  679. package/dist/sdk/workspace-transaction-gc.js +1 -149
  680. package/dist/sdk/workspace-transaction.js +2 -363
  681. package/dist/sdk/workspace.js +3 -127
  682. package/dist/types/index.js +1 -9
  683. package/dist/types.d.ts +4 -0
  684. package/dist/types.js +1 -245
  685. package/docs/AGENT_GUIDE.md +1 -1
  686. package/docs/COMMANDS.md +10 -0
  687. package/docs/CONFIGURATION.md +12 -1
  688. package/docs/CONTEXT_ALGORITHM_PORTFOLIO.md +167 -0
  689. package/docs/DIAGNOSTIC_OUTPUT_CONTRACTS.md +9 -3
  690. package/docs/EXTENSIONS.md +1 -0
  691. package/docs/HISTORY_MAINTENANCE.md +125 -0
  692. package/docs/MCP_2026_07_28_CONFORMANCE.md +20 -10
  693. package/docs/PACKAGE_EVIDENCE.md +92 -0
  694. package/docs/PLANNING_MEASUREMENTS.md +183 -0
  695. package/docs/README.md +4 -0
  696. package/docs/READ_OUTPUT_CONTRACTS.md +5 -0
  697. package/docs/SCRIPTING.md +21 -0
  698. package/docs/TESTING.md +33 -0
  699. package/docs/WORKFLOW_POLICIES.md +129 -0
  700. package/docs/generated/FLAG_LEXICON_BUDGETS.md +7 -7
  701. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +11 -5
  702. package/marketplace.json +2 -2
  703. package/package.json +5 -5
  704. package/packages/pm-beads/package.json +1 -1
  705. package/packages/pm-calendar/package.json +1 -1
  706. package/packages/pm-command-kit/package.json +1 -1
  707. package/packages/pm-digital-twin/package.json +1 -1
  708. package/packages/pm-governance-audit/package.json +1 -1
  709. package/packages/pm-guide-shell/package.json +1 -1
  710. package/packages/pm-kanban/package.json +1 -1
  711. package/packages/pm-lifecycle-hooks/package.json +1 -1
  712. package/packages/pm-linked-test-adapters/package.json +1 -1
  713. package/packages/pm-search-advanced/package.json +1 -1
  714. package/packages/pm-templates/package.json +1 -1
  715. package/packages/pm-todos/package.json +1 -1
  716. package/packages/pm-vcs/package.json +1 -1
  717. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  718. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  719. package/scripts/finalize-build.mjs +45 -3
  720. package/dist/cli-bundle/chunks/chunk-AZDFJGH6.js +0 -9
  721. package/dist/cli-bundle/chunks/chunk-CKOL5U7J.js +0 -77
  722. package/dist/cli-bundle/chunks/chunk-JX4DH4WC.js +0 -3
  723. package/dist/cli-bundle/chunks/chunk-OF76PSDQ.js +0 -5
  724. package/dist/cli-bundle/chunks/chunk-QUWFABDM.js +0 -232
  725. package/dist/cli-bundle/chunks/chunk-QWRRFYK3.js +0 -2
  726. package/dist/cli-bundle/chunks/chunk-RWWBOWJ5.js +0 -2
  727. package/dist/cli-bundle/chunks/chunk-WGAOYSYH.js +0 -40
  728. package/dist/cli-bundle/chunks/chunk-WI2AYPA7.js +0 -2
  729. package/dist/cli-bundle/chunks/register-list-query-5JL52D33.js +0 -11
  730. package/dist/cli-bundle/chunks/register-mutation-ZPG7KMVP.js +0 -20
  731. package/dist/cli-bundle/chunks/register-operations-I5W3KMGB.js +0 -2
  732. package/dist/cli-bundle/chunks/register-setup-H4SVAVX7.js +0 -2
  733. package/dist/cli-bundle/focused-chunks/chunk-AL5ON6K6.js +0 -2
  734. package/dist/cli-bundle/focused-chunks/chunk-CHC2IDXA.js +0 -6
  735. package/dist/cli-bundle/focused-chunks/chunk-CK6QFAPZ.js +0 -20
  736. package/dist/cli-bundle/focused-chunks/chunk-EZR3GHFE.js +0 -2
  737. package/dist/cli-bundle/focused-chunks/chunk-H2WJWK7L.js +0 -56
  738. package/dist/cli-bundle/focused-chunks/chunk-NTPY5GSO.js +0 -3
  739. package/dist/cli-bundle/focused-chunks/chunk-P5O7MP5Y.js +0 -2
  740. package/dist/cli-bundle/focused-chunks/chunk-PDMW2E36.js +0 -177
  741. package/dist/cli-bundle/focused-chunks/chunk-PEFABF7E.js +0 -26
  742. package/dist/cli-bundle/focused-chunks/chunk-QTVCLMSZ.js +0 -6
  743. package/dist/cli-bundle/focused-chunks/chunk-QTZRBUYA.js +0 -8
  744. package/dist/cli-bundle/focused-chunks/chunk-SGQST3PQ.js +0 -12
  745. package/dist/cli-bundle/focused-chunks/chunk-UKHASMMP.js +0 -10
  746. package/dist/cli-bundle/focused-chunks/chunk-ZPEKQHOC.js +0 -2
@@ -1,991 +1,8 @@
1
- /**
2
- * @module cli/registration-helpers
3
- *
4
- * Provides CLI runtime support for Registration Helpers.
5
- */
6
-
7
- !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]="01742f33-d1e8-5684-a585-2add88ddb73c")}catch(e){}}();
8
- import { Option } from "commander";
9
- import { pathExists, refreshSearchArtifactsForMutation, shouldRunSearchRefreshInForeground, EXIT_CODE, PmCliError, printError, printResult, writeStdout, getSettingsPath, resolvePmRoot, readSettings, runActiveServiceOverride, setActiveCommandResult, } from "../runtime-primitives.js";
10
- import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, NEXT_COMMANDER_STRING_OPTION_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, readFirstValueFromCommanderOptions, readFirstStringFromCommanderOptions, readStringArrayFromCommanderOptions, } from "../cli-contracts.js";
11
- export { setActiveCommandResult };
12
- export { printError, printResult, writeStdout };
13
- /** Let an active package asynchronously augment a completed command result. */
14
- export async function applyActiveCommandResultService(command, args, options, global, result) {
15
- const pmRoot = resolvePmRoot(process.cwd(), global.path);
16
- const override = await runActiveServiceOverride("command_result", {
17
- command,
18
- args,
19
- options,
20
- global,
21
- pm_root: pmRoot,
22
- result,
23
- });
24
- return override.handled ? override.result : result;
25
- }
26
- /** Synchronize parser-derived options with Commander and its action arguments. */
27
- export function syncCommanderActionOptions(actionCommand, commandOptions) {
28
- for (const [key, value] of Object.entries(commandOptions)) {
29
- actionCommand.setOptionValueWithSource(key, value, "cli");
30
- }
31
- }
32
- function readJoinedRepeatedOption(options, contract) {
33
- const values = [];
34
- const observedArrays = new Set();
35
- for (const key of contract.keys) {
36
- if (!Object.hasOwn(options, key)) {
37
- continue;
38
- }
39
- const value = options[key];
40
- if (value == null) {
41
- continue;
42
- }
43
- if (typeof value === "string") {
44
- values.push(value);
45
- continue;
46
- }
47
- if (!Array.isArray(value) ||
48
- !value.every((entry) => typeof entry === "string")) {
49
- return undefined;
50
- }
51
- if (observedArrays.has(value)) {
52
- continue;
53
- }
54
- observedArrays.add(value);
55
- values.push(...value);
56
- }
57
- return values.length > 0 ? values.join("; ") : undefined;
58
- }
59
- const RESOLVED_GLOBAL_OPTIONS = Symbol("pm.resolvedGlobalOptions");
60
- function commandOptionsReader(command) {
61
- return typeof command === "object" && command !== null
62
- ? command
63
- : {};
64
- }
65
- // Resolves the alias contract for a normalize target, falling back to a
66
- // single-key contract if the target is somehow absent from the contract table.
67
- function resolveCommanderContract(contracts, target) {
68
- const contract = contracts.find((entry) => entry.target === target);
69
- /* c8 ignore start -- every normalize target is present in its contract table (verified by contract drift tests); the fallback is a defensive guard against future drift */
70
- return contract ?? { target, keys: [target] };
71
- /* c8 ignore stop */
72
- }
73
- /** Implements set resolved global options for the public runtime surface of this module. */
74
- export function setResolvedGlobalOptions(command, globalOptions) {
75
- command[RESOLVED_GLOBAL_OPTIONS] = {
76
- ...globalOptions,
77
- };
78
- }
79
- /** Implements clear resolved global options for the public runtime surface of this module. */
80
- export function clearResolvedGlobalOptions(command) {
81
- delete command[RESOLVED_GLOBAL_OPTIONS];
82
- }
83
- /** Read one string-valued Commander option without coercion. */
84
- function readStringCommandOption(options, key) {
85
- return typeof options[key] === "string" ? options[key] : undefined;
86
- }
87
- /** Implements get global options for the public runtime surface of this module. */
88
- export function getGlobalOptions(command) {
89
- const commandPath = getCommandPath(command);
90
- const resolved = command[RESOLVED_GLOBAL_OPTIONS];
91
- if (resolved) {
92
- return {
93
- ...resolved,
94
- ...(commandPath.length > 0 ? { command: commandPath } : {}),
95
- };
96
- }
97
- const reader = commandOptionsReader(command);
98
- const opts = typeof reader.optsWithGlobals === "function"
99
- ? reader.optsWithGlobals()
100
- : typeof reader.opts === "function"
101
- ? reader.opts()
102
- : {};
103
- const normalized = {
104
- json: opts.json === true ? true : undefined,
105
- quiet: Boolean(opts.quiet),
106
- noChangedFields: opts.changedFields === false,
107
- ...(opts.fullChangedFields === true ? { fullChangedFields: true } : {}),
108
- idOnly: opts.idOnly === true,
109
- ...(opts.lean === true ? { lean: true } : {}),
110
- ...(opts.tokenAccounting === true ? { tokenAccounting: true } : {}),
111
- outputInclude: readStringCommandOption(opts, "outputInclude"),
112
- outputLimit: readStringCommandOption(opts, "outputLimit"),
113
- outputBudget: readStringCommandOption(opts, "outputBudget"),
114
- outputSession: readStringCommandOption(opts, "outputSession"),
115
- outputCursor: readStringCommandOption(opts, "outputCursor"),
116
- ...(opts.outputRowContract === true ? { outputRowContract: true } : {}),
117
- ...(opts.outputFormat === "toon" || opts.outputFormat === "json"
118
- ? { outputFormat: opts.outputFormat }
119
- : {}),
120
- path: readStringCommandOption(opts, "pmPath") ??
121
- readStringCommandOption(opts, "path"),
122
- noExtensions: opts.extensions === false,
123
- noPager: Boolean(opts.noPager),
124
- profile: Boolean(opts.profile),
125
- ...(commandPath.length > 0 ? { command: commandPath } : {}),
126
- ...(typeof opts.author === "string" ? { author: opts.author } : {}),
127
- };
128
- return normalized;
129
- }
130
- /** Implements get command path for the public runtime surface of this module. */
131
- export function getCommandPath(command) {
132
- const parts = [];
133
- let current = command;
134
- while (current?.parent) {
135
- parts.unshift(current.name());
136
- current = current.parent;
137
- }
138
- return parts.join(" ");
139
- }
140
- /** Implements apply default output format for the public runtime surface of this module. */
141
- export async function applyDefaultOutputFormat(globalOptions) {
142
- if (globalOptions.json === true) {
143
- return globalOptions;
144
- }
145
- const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);
146
- if (!(await pathExists(getSettingsPath(pmRoot)))) {
147
- return globalOptions;
148
- }
149
- const settings = await readSettings(pmRoot);
150
- return {
151
- ...globalOptions,
152
- defaultOutputFormat: settings.output.default_format,
153
- };
154
- }
155
- /** Implements collect for the public runtime surface of this module. */
156
- export function collect(value, previous) {
157
- const next = previous ?? [];
158
- next.push(value);
159
- return next;
160
- }
161
- function pushOptionalValueFlag(args, flag, value) {
162
- if (typeof value !== "string") {
163
- return;
164
- }
165
- const trimmed = value.trim();
166
- if (trimmed.length === 0) {
167
- return;
168
- }
169
- args.push(flag, trimmed);
170
- }
171
- function pushOptionalBooleanFlag(args, flag, value) {
172
- if (value === true) {
173
- args.push(flag);
174
- }
175
- }
176
- function pushRepeatableValueFlag(args, flag, values) {
177
- if (!Array.isArray(values)) {
178
- return;
179
- }
180
- for (const value of values) {
181
- if (typeof value !== "string") {
182
- continue;
183
- }
184
- const trimmed = value.trim();
185
- if (trimmed.length === 0) {
186
- continue;
187
- }
188
- args.push(flag, trimmed);
189
- }
190
- }
191
- function optionTrue(options, key) {
192
- return options[key] === true ? true : undefined;
193
- }
194
- function optionFalse(options, key) {
195
- return options[key] === false ? true : undefined;
196
- }
197
- /** Reads an option value when Commander supplied it as a string. */
198
- export function readOptionString(options, key) {
199
- return typeof options[key] === "string" ? options[key] : undefined;
200
- }
201
- /** Adds a Commander option that remains parseable but hidden from human help. */
202
- export function addHiddenOption(command, flags, description, repeatable = false, repeatableParser = undefined) {
203
- const option = new Option(flags, description).hideHelp();
204
- if (repeatable) {
205
- option.argParser(repeatableParser ?? collect);
206
- }
207
- command.addOption(option);
208
- }
209
- /** Adds a group of parseable Commander aliases hidden from human help. */
210
- export function addHiddenOptions(command, aliases, repeatable) {
211
- for (const [flags, description] of aliases) {
212
- addHiddenOption(command, flags, description, repeatable);
213
- }
214
- }
215
- function anyOptionTrue(options, keys) {
216
- return keys.some((key) => options[key] === true) ? true : undefined;
217
- }
218
- function readStringOrFiniteNumberFromCommanderOptions(options, contract) {
219
- const value = readFirstValueFromCommanderOptions(options, contract);
220
- return typeof value === "string" ||
221
- (typeof value === "number" && Number.isFinite(value))
222
- ? value
223
- : undefined;
224
- }
225
- function copyUnknownOptions(target, source) {
226
- for (const [key, value] of Object.entries(source)) {
227
- if (key === "__proto__" || key === "constructor" || key === "prototype") {
228
- continue;
229
- }
230
- if (Object.hasOwn(target, key)) {
231
- continue;
232
- }
233
- target[key] = value;
234
- }
235
- }
236
- /** Implements build background test command args for the public runtime surface of this module. */
237
- export function buildBackgroundTestCommandArgs(id, options) {
238
- const args = ["test", id, "--run", "--json", "--progress"];
239
- pushRepeatableValueFlag(args, "--add", options.add);
240
- pushRepeatableValueFlag(args, "--add-json", options.addJson);
241
- pushRepeatableValueFlag(args, "--remove", options.remove);
242
- pushRepeatableValueFlag(args, "--remove-index", options.removeIndex);
243
- pushOptionalValueFlag(args, "--match", options.match);
244
- pushOptionalValueFlag(args, "--only-index", options.onlyIndex);
245
- pushOptionalBooleanFlag(args, "--only-last", options.onlyLast);
246
- pushRepeatableValueFlag(args, "--measure", options.measure);
247
- pushOptionalValueFlag(args, "--metric-below", options.metricBelow);
248
- pushOptionalValueFlag(args, "--metric-diff", options.metricDiff);
249
- pushSharedBackgroundTestCommandArgs(args, options);
250
- pushOptionalValueFlag(args, "--author", options.author);
251
- pushOptionalValueFlag(args, "--message", options.message);
252
- pushOptionalBooleanFlag(args, "--force", options.force);
253
- return args;
254
- }
255
- function pushSharedBackgroundTestCommandArgs(args, options) {
256
- pushOptionalValueFlag(args, "--timeout", options.timeout);
257
- pushRepeatableValueFlag(args, "--env-set", options.envSet);
258
- pushRepeatableValueFlag(args, "--env-clear", options.envClear);
259
- pushOptionalBooleanFlag(args, "--shared-host-safe", options.sharedHostSafe);
260
- pushOptionalValueFlag(args, "--pm-context", options.pmContext);
261
- pushOptionalBooleanFlag(args, "--override-linked-pm-context", options.overrideLinkedPmContext);
262
- pushOptionalValueFlag(args, "--workspace-context", options.workspaceContext);
263
- pushOptionalBooleanFlag(args, "--override-linked-workspace-context", options.overrideLinkedWorkspaceContext);
264
- pushOptionalBooleanFlag(args, "--allow-untrusted-linked-tests", options.allowUntrustedLinkedTests);
265
- pushOptionalBooleanFlag(args, "--fail-on-context-mismatch", options.failOnContextMismatch);
266
- pushOptionalBooleanFlag(args, "--fail-on-skipped", options.failOnSkipped);
267
- pushOptionalBooleanFlag(args, "--fail-on-empty-test-run", options.failOnEmptyTestRun);
268
- pushOptionalBooleanFlag(args, "--require-assertions-for-pm", options.requireAssertionsForPm);
269
- pushOptionalBooleanFlag(args, "--check-context", options.checkContext);
270
- pushOptionalBooleanFlag(args, "--auto-pm-context", options.autoPmContext);
271
- }
272
- /** Implements build background test all command args for the public runtime surface of this module. */
273
- export function buildBackgroundTestAllCommandArgs(options) {
274
- const args = ["test-all", "--json", "--progress"];
275
- pushOptionalValueFlag(args, "--status", options.status);
276
- pushOptionalValueFlag(args, "--limit", options.limit);
277
- pushOptionalValueFlag(args, "--offset", options.offset);
278
- pushSharedBackgroundTestCommandArgs(args, options);
279
- return args;
280
- }
281
- /** Implements format hook warnings for the public runtime surface of this module. */
282
- export function formatHookWarnings(warnings) {
283
- return warnings.join(",");
284
- }
285
- /** Implements normalize create options for the public runtime surface of this module. */
286
- export function normalizeCreateOptions(commandOptions, options = {}) {
287
- const readCreateString = (target) => readFirstStringFromCommanderOptions(commandOptions, resolveCommanderContract(CREATE_COMMANDER_STRING_OPTION_CONTRACTS, target));
288
- const readCreateList = (target) => readStringArrayFromCommanderOptions(commandOptions, resolveCommanderContract(CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, target));
289
- const type = readCreateString("type");
290
- if (options.requireType !== false && type === undefined) {
291
- throw new PmCliError("Missing required option --type <value>. Why required: create resolves runtime schema fields/workflow from item type. Retry: add --type <built-in or configured custom type> (example: --type Task).", EXIT_CODE.USAGE);
292
- }
293
- const normalized = {
294
- title: readCreateString("title"),
295
- description: readCreateString("description"),
296
- type,
297
- template: readCreateString("template"),
298
- createMode: readCreateString("createMode"),
299
- schedulePreset: readCreateString("schedulePreset"),
300
- status: readCreateString("status"),
301
- closeReason: readCreateString("closeReason"),
302
- completedAt: readCreateString("completedAt"),
303
- priority: readCreateString("priority"),
304
- tags: readCreateString("tags"),
305
- addTags: readCreateList("addTags"),
306
- body: readCreateString("body"),
307
- deadline: readCreateString("deadline"),
308
- estimatedMinutes: readCreateString("estimatedMinutes"),
309
- acceptanceCriteria: readJoinedRepeatedOption(commandOptions, resolveCommanderContract(CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, "acceptanceCriteria")),
310
- definitionOfReady: readCreateString("definitionOfReady"),
311
- order: readCreateString("order"),
312
- rank: readCreateString("rank"),
313
- goal: readCreateString("goal"),
314
- objective: readCreateString("objective"),
315
- value: readCreateString("value"),
316
- impact: readCreateString("impact"),
317
- outcome: readCreateString("outcome"),
318
- whyNow: readCreateString("whyNow"),
319
- author: readCreateString("author"),
320
- message: readCreateString("message"),
321
- assignee: readCreateString("assignee"),
322
- parent: readCreateString("parent"),
323
- allowMissingParent: anyOptionTrue(commandOptions, [
324
- "allowMissingParent",
325
- "allow_missing_parent",
326
- ]) === true,
327
- allowUnresolvedDeps: anyOptionTrue(commandOptions, [
328
- "allowUnresolvedDeps",
329
- "allow_unresolved_deps",
330
- ]) === true,
331
- allowDuplicate: optionTrue(commandOptions, "allowDuplicate") === true,
332
- reviewer: readCreateString("reviewer"),
333
- risk: readCreateString("risk"),
334
- confidence: readCreateString("confidence"),
335
- sprint: readCreateString("sprint"),
336
- release: readCreateString("release"),
337
- blockedBy: readCreateString("blockedBy"),
338
- blockedReason: readCreateString("blockedReason"),
339
- unblockNote: readCreateString("unblockNote"),
340
- reporter: readCreateString("reporter"),
341
- severity: readCreateString("severity"),
342
- environment: readCreateString("environment"),
343
- reproSteps: readCreateString("reproSteps"),
344
- resolution: readCreateString("resolution"),
345
- expectedResult: readCreateString("expectedResult"),
346
- actualResult: readCreateString("actualResult"),
347
- affectedVersion: readCreateString("affectedVersion"),
348
- fixedVersion: readCreateString("fixedVersion"),
349
- component: readCreateString("component"),
350
- regression: commandOptions.regression === true
351
- ? "true"
352
- : readCreateString("regression"),
353
- customerImpact: readCreateString("customerImpact"),
354
- dep: readCreateList("dep"),
355
- comment: readCreateList("comment"),
356
- note: readCreateList("note"),
357
- learning: readCreateList("learning"),
358
- file: readCreateList("file"),
359
- test: readCreateList("test"),
360
- doc: readCreateList("doc"),
361
- reminder: readCreateList("reminder"),
362
- event: readCreateList("event"),
363
- typeOption: readCreateList("typeOption"),
364
- field: readCreateList("field"),
365
- unset: readCreateList("unset"),
366
- clearDeps: optionTrue(commandOptions, "clearDeps"),
367
- clearComments: optionTrue(commandOptions, "clearComments"),
368
- clearNotes: optionTrue(commandOptions, "clearNotes"),
369
- clearLearnings: optionTrue(commandOptions, "clearLearnings"),
370
- clearFiles: optionTrue(commandOptions, "clearFiles"),
371
- clearTests: optionTrue(commandOptions, "clearTests"),
372
- clearDocs: optionTrue(commandOptions, "clearDocs"),
373
- clearReminders: optionTrue(commandOptions, "clearReminders"),
374
- clearEvents: optionTrue(commandOptions, "clearEvents"),
375
- clearTypeOptions: optionTrue(commandOptions, "clearTypeOptions"),
376
- };
377
- copyUnknownOptions(normalized, commandOptions);
378
- return normalized;
379
- }
380
- /** Implements normalize update options for the public runtime surface of this module. */
381
- export function normalizeUpdateOptions(commandOptions) {
382
- const readUpdateString = (target) => readFirstStringFromCommanderOptions(commandOptions, resolveCommanderContract(UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, target));
383
- const readUpdateList = (target) => readStringArrayFromCommanderOptions(commandOptions, resolveCommanderContract(UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, target));
384
- const normalized = {
385
- title: readUpdateString("title"),
386
- description: readUpdateString("description"),
387
- body: readUpdateString("body"),
388
- status: readUpdateString("status"),
389
- closeReason: readUpdateString("closeReason"),
390
- priority: readUpdateString("priority"),
391
- type: readUpdateString("type"),
392
- tags: readUpdateString("tags"),
393
- addTags: readUpdateList("addTags"),
394
- removeTags: readUpdateList("removeTags"),
395
- deadline: readUpdateString("deadline"),
396
- estimatedMinutes: readUpdateString("estimatedMinutes"),
397
- acceptanceCriteria: readJoinedRepeatedOption(commandOptions, resolveCommanderContract(UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, "acceptanceCriteria")),
398
- addAc: readUpdateList("addAc"),
399
- removeAc: readUpdateList("removeAc"),
400
- definitionOfReady: readUpdateString("definitionOfReady"),
401
- order: readUpdateString("order"),
402
- rank: readUpdateString("rank"),
403
- goal: readUpdateString("goal"),
404
- objective: readUpdateString("objective"),
405
- value: readUpdateString("value"),
406
- impact: readUpdateString("impact"),
407
- outcome: readUpdateString("outcome"),
408
- whyNow: readUpdateString("whyNow"),
409
- author: readUpdateString("author"),
410
- message: readUpdateString("message"),
411
- force: Boolean(commandOptions.force),
412
- ownershipMetadataBypass: commandOptions.ownershipMetadataBypass === true ? true : undefined,
413
- ownershipDependencyBypass: commandOptions.ownershipDependencyBypass === true ? true : undefined,
414
- assignee: readUpdateString("assignee"),
415
- parent: readUpdateString("parent"),
416
- allowUnresolvedDeps: anyOptionTrue(commandOptions, [
417
- "allowUnresolvedDeps",
418
- "allow_unresolved_deps",
419
- ]) === true,
420
- reviewer: readUpdateString("reviewer"),
421
- risk: readUpdateString("risk"),
422
- confidence: readUpdateString("confidence"),
423
- sprint: readUpdateString("sprint"),
424
- release: readUpdateString("release"),
425
- blockedBy: readUpdateString("blockedBy"),
426
- blockedReason: readUpdateString("blockedReason"),
427
- unblockNote: readUpdateString("unblockNote"),
428
- reporter: readUpdateString("reporter"),
429
- severity: readUpdateString("severity"),
430
- environment: readUpdateString("environment"),
431
- reproSteps: readUpdateString("reproSteps"),
432
- resolution: readUpdateString("resolution"),
433
- expectedResult: readUpdateString("expectedResult"),
434
- actualResult: readUpdateString("actualResult"),
435
- affectedVersion: readUpdateString("affectedVersion"),
436
- fixedVersion: readUpdateString("fixedVersion"),
437
- component: readUpdateString("component"),
438
- regression: commandOptions.regression === true
439
- ? "true"
440
- : readUpdateString("regression"),
441
- customerImpact: readUpdateString("customerImpact"),
442
- dep: readUpdateList("dep"),
443
- depRemove: readUpdateList("depRemove"),
444
- replaceDeps: optionTrue(commandOptions, "replaceDeps"),
445
- replaceTests: optionTrue(commandOptions, "replaceTests"),
446
- replaceFiles: optionTrue(commandOptions, "replaceFiles"),
447
- replaceDocs: optionTrue(commandOptions, "replaceDocs"),
448
- comment: readUpdateList("comment"),
449
- note: readUpdateList("note"),
450
- learning: readUpdateList("learning"),
451
- file: readUpdateList("file"),
452
- test: readUpdateList("test"),
453
- doc: readUpdateList("doc"),
454
- reminder: readUpdateList("reminder"),
455
- event: readUpdateList("event"),
456
- typeOption: readUpdateList("typeOption"),
457
- field: readUpdateList("field"),
458
- unset: readUpdateList("unset"),
459
- clearDeps: optionTrue(commandOptions, "clearDeps"),
460
- clearComments: optionTrue(commandOptions, "clearComments"),
461
- clearNotes: optionTrue(commandOptions, "clearNotes"),
462
- clearLearnings: optionTrue(commandOptions, "clearLearnings"),
463
- clearFiles: optionTrue(commandOptions, "clearFiles"),
464
- clearTests: optionTrue(commandOptions, "clearTests"),
465
- clearDocs: optionTrue(commandOptions, "clearDocs"),
466
- clearReminders: optionTrue(commandOptions, "clearReminders"),
467
- clearEvents: optionTrue(commandOptions, "clearEvents"),
468
- clearTypeOptions: optionTrue(commandOptions, "clearTypeOptions"),
469
- };
470
- copyUnknownOptions(normalized, commandOptions);
471
- return normalized;
472
- }
473
- const UPDATE_MANY_CONTROL_OPTION_KEYS = new Set([
474
- "filterStatus",
475
- "filterType",
476
- "filterTag",
477
- "filterPriority",
478
- "filterDeadlineBefore",
479
- "filterDeadlineAfter",
480
- "filterUpdatedAfter",
481
- "filterUpdatedBefore",
482
- "filterCreatedAfter",
483
- "filterCreatedBefore",
484
- "filterAssignee",
485
- "filterAssigneeFilter",
486
- "filterAssignee_filter",
487
- "filterParent",
488
- "filterSprint",
489
- "filterRelease",
490
- "filterAcMissing",
491
- "filterEstimatesMissing",
492
- "filterEstimateMissing",
493
- "filterResolutionMissing",
494
- "filterMetadataMissing",
495
- "filterReviewerMissing",
496
- "filterRiskMissing",
497
- "filterConfidenceMissing",
498
- "filterSprintMissing",
499
- "filterReleaseMissing",
500
- "filterHasNotes",
501
- "filterNoNotes",
502
- "filterHasLearnings",
503
- "filterNoLearnings",
504
- "filterHasFiles",
505
- "filterNoFiles",
506
- "filterHasDocs",
507
- "filterNoDocs",
508
- "filterHasTests",
509
- "filterNoTests",
510
- "filterHasComments",
511
- "filterNoComments",
512
- "filterHasDeps",
513
- "filterNoDeps",
514
- "filterHasBody",
515
- "filterEmptyBody",
516
- "filterHasLinkedCommand",
517
- "filterNoLinkedCommand",
518
- "ids",
519
- "limit",
520
- "offset",
521
- "dryRun",
522
- "rollback",
523
- "checkpoint",
524
- ]);
525
- /** Implements extract update many mutation option source for the public runtime surface of this module. */
526
- export function extractUpdateManyMutationOptionSource(commandOptions) {
527
- const mutationOptions = {};
528
- for (const [key, value] of Object.entries(commandOptions)) {
529
- if (UPDATE_MANY_CONTROL_OPTION_KEYS.has(key)) {
530
- continue;
531
- }
532
- mutationOptions[key] = value;
533
- }
534
- return mutationOptions;
535
- }
536
- function readListOptionString(options, target) {
537
- const contract = resolveCommanderContract(LIST_COMMANDER_STRING_OPTION_CONTRACTS, target);
538
- const stringValue = readFirstStringFromCommanderOptions(options, contract);
539
- if (stringValue !== undefined) {
540
- return stringValue;
541
- }
542
- for (const key of contract.keys) {
543
- const value = options[key];
544
- if (Array.isArray(value)) {
545
- const strings = value.filter((entry) => typeof entry === "string");
546
- if (strings.length > 0) {
547
- return strings.join(",");
548
- }
549
- }
550
- /* c8 ignore start -- unreachable: readFirstStringFromCommanderOptions already returns above for any string value under contract.keys, so a string here cannot occur */
551
- if (target === "ids" && typeof value === "string") {
552
- return value;
553
- }
554
- /* c8 ignore stop */
555
- if (typeof value === "number" && Number.isFinite(value)) {
556
- return String(value);
557
- }
558
- }
559
- return undefined;
560
- }
561
- // Shared governance-missing (GH-236) + content-field presence/absence (GH-242)
562
- // selection-filter fields. Presence flags are plain booleans; absence uses
563
- // commander negation (`--no-notes` stores notes=false) except --empty-body
564
- // which is its own dest. The docs/files `--filter-*-missing` aliases mirror
565
- // `--no-*` while keeping the raw alias keys accounted for before passthrough.
566
- // Spread into normalizeListOptions and normalizeSearchOptions at the same
567
- // position so key order is preserved.
568
- function readSelectionFilterOptionFields(options) {
569
- const filterFilesMissing = optionTrue(options, "filterFilesMissing");
570
- const filterDocsMissing = optionTrue(options, "filterDocsMissing");
571
- return {
572
- filterReviewerMissing: optionTrue(options, "filterReviewerMissing"),
573
- filterRiskMissing: optionTrue(options, "filterRiskMissing"),
574
- filterConfidenceMissing: optionTrue(options, "filterConfidenceMissing"),
575
- filterSprintMissing: optionTrue(options, "filterSprintMissing"),
576
- filterReleaseMissing: optionTrue(options, "filterReleaseMissing"),
577
- hasNotes: optionTrue(options, "hasNotes"),
578
- hasLearnings: optionTrue(options, "hasLearnings"),
579
- hasFiles: optionTrue(options, "hasFiles"),
580
- hasDocs: optionTrue(options, "hasDocs"),
581
- hasTests: optionTrue(options, "hasTests"),
582
- hasComments: optionTrue(options, "hasComments"),
583
- hasDeps: optionTrue(options, "hasDeps"),
584
- hasBody: optionTrue(options, "hasBody"),
585
- hasLinkedCommand: optionTrue(options, "hasLinkedCommand"),
586
- noNotes: optionFalse(options, "notes"),
587
- noLearnings: optionFalse(options, "learnings"),
588
- noFiles: optionFalse(options, "files") ?? filterFilesMissing,
589
- filterFilesMissing,
590
- noDocs: optionFalse(options, "docs") ?? filterDocsMissing,
591
- filterDocsMissing,
592
- noTests: optionFalse(options, "tests"),
593
- noComments: optionFalse(options, "comments"),
594
- noDeps: optionFalse(options, "deps"),
595
- emptyBody: optionTrue(options, "emptyBody"),
596
- noLinkedCommand: optionFalse(options, "linkedCommand"),
597
- };
598
- }
599
- /** Implements normalize list options for the public runtime surface of this module. */
600
- export function normalizeListOptions(options) {
601
- const normalized = {
602
- status: readListOptionString(options, "status"),
603
- type: readListOptionString(options, "type"),
604
- tag: readListOptionString(options, "tag"),
605
- priority: readListOptionString(options, "priority"),
606
- deadlineBefore: readListOptionString(options, "deadlineBefore"),
607
- deadlineAfter: readListOptionString(options, "deadlineAfter"),
608
- updatedAfter: readListOptionString(options, "updatedAfter"),
609
- updatedBefore: readListOptionString(options, "updatedBefore"),
610
- createdAfter: readListOptionString(options, "createdAfter"),
611
- createdBefore: readListOptionString(options, "createdBefore"),
612
- today: optionTrue(options, "today"),
613
- recent: optionTrue(options, "recent"),
614
- ids: readListOptionString(options, "ids"),
615
- assignee: readListOptionString(options, "assignee"),
616
- assigneeFilter: readListOptionString(options, "assigneeFilter"),
617
- parent: readListOptionString(options, "parent"),
618
- sprint: readListOptionString(options, "sprint"),
619
- release: readListOptionString(options, "release"),
620
- limit: readListOptionString(options, "limit"),
621
- offset: readListOptionString(options, "offset"),
622
- // Commander stores --no-truncate as truncate=false.
623
- noTruncate: optionFalse(options, "truncate"),
624
- includeBody: optionTrue(options, "includeBody"),
625
- strictRead: optionTrue(options, "strictRead"),
626
- compact: optionTrue(options, "compact"),
627
- brief: optionTrue(options, "brief"),
628
- full: optionTrue(options, "full"),
629
- fields: readListOptionString(options, "fields"),
630
- sort: readListOptionString(options, "sort"),
631
- order: readListOptionString(options, "order"),
632
- tree: optionTrue(options, "tree"),
633
- treeDepth: readListOptionString(options, "treeDepth"),
634
- filterAcMissing: optionTrue(options, "filterAcMissing"),
635
- filterEstimatesMissing: anyOptionTrue(options, [
636
- "filterEstimatesMissing",
637
- "filterEstimateMissing",
638
- ]),
639
- filterResolutionMissing: optionTrue(options, "filterResolutionMissing"),
640
- filterMetadataMissing: optionTrue(options, "filterMetadataMissing"),
641
- // Governance-missing (GH-236) + content presence/absence (GH-242) filters.
642
- ...readSelectionFilterOptionFields(options),
643
- };
644
- copyUnknownOptions(normalized, options);
645
- return normalized;
646
- }
647
- /** Implements normalize aggregate options for the public runtime surface of this module. */
648
- export function normalizeAggregateOptions(options) {
649
- return {
650
- groupBy: typeof options.groupBy === "string" ? options.groupBy : undefined,
651
- count: options.count === true ? true : undefined,
652
- completion: options.completion === true ? true : undefined,
653
- sum: typeof options.sum === "string" ? options.sum : undefined,
654
- avg: typeof options.avg === "string" ? options.avg : undefined,
655
- includeUnparented: options.includeUnparented === true || options.include_unparented === true,
656
- status: typeof options.status === "string" ? options.status : undefined,
657
- type: readListOptionString(options, "type"),
658
- tag: readListOptionString(options, "tag"),
659
- priority: readListOptionString(options, "priority"),
660
- deadlineBefore: readListOptionString(options, "deadlineBefore"),
661
- deadlineAfter: readListOptionString(options, "deadlineAfter"),
662
- assignee: readListOptionString(options, "assignee"),
663
- assigneeFilter: readListOptionString(options, "assigneeFilter"),
664
- parent: readListOptionString(options, "parent"),
665
- sprint: readListOptionString(options, "sprint"),
666
- release: readListOptionString(options, "release"),
667
- };
668
- }
669
- /** Implements print list json stream for the public runtime surface of this module. */
670
- export function printListJsonStream(commandName, result, globalOptions) {
671
- setActiveCommandResult(result);
672
- if (globalOptions.quiet) {
673
- return;
674
- }
675
- const warnings = Array.isArray(result.warnings) ? result.warnings : [];
676
- const metaPayload = {
677
- type: "meta",
678
- command: commandName,
679
- count: result.count,
680
- now: result.now,
681
- filters: result.filters,
682
- };
683
- if (warnings.length > 0) {
684
- metaPayload.warnings = warnings;
685
- }
686
- if (!writeStdout(`${JSON.stringify(metaPayload)}\n`)) {
687
- return;
688
- }
689
- for (const item of result.items) {
690
- if (!writeStdout(`${JSON.stringify({ type: "item", command: commandName, item })}\n`)) {
691
- return;
692
- }
693
- }
694
- writeStdout(`${JSON.stringify({ type: "end", command: commandName, count: result.count })}\n`);
695
- }
696
- /** Implements print activity json stream for the public runtime surface of this module. */
697
- export function printActivityJsonStream(result, options, globalOptions) {
698
- setActiveCommandResult(result);
699
- if (globalOptions.quiet) {
700
- return;
701
- }
702
- const metaPayload = {
703
- type: "meta",
704
- command: "activity",
705
- count: result.count,
706
- filters: {
707
- id: options.id ?? null,
708
- op: options.op ?? null,
709
- author: options.author ?? null,
710
- from: options.from ?? null,
711
- to: options.to ?? null,
712
- limit: options.limit ?? null,
713
- },
714
- };
715
- if (!writeStdout(`${JSON.stringify(metaPayload)}\n`)) {
716
- return;
717
- }
718
- const entries = result.compact && result.compact_activity
719
- ? result.compact_activity
720
- : (result.activity ?? []);
721
- for (const entry of entries) {
722
- if (!writeStdout(`${JSON.stringify({ type: "entry", command: "activity", entry })}\n`)) {
723
- return;
724
- }
725
- }
726
- writeStdout(`${JSON.stringify({ type: "end", command: "activity", count: result.count })}\n`);
727
- }
728
- /** Implements normalize search options for the public runtime surface of this module. */
729
- export function normalizeSearchOptions(options) {
730
- const readSearchString = (target) => readFirstStringFromCommanderOptions(options, resolveCommanderContract(SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, target));
731
- const readSearchStringOrNumber = (target) => {
732
- const candidate = readFirstValueFromCommanderOptions(options, resolveCommanderContract(SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, target));
733
- if (typeof candidate === "string") {
734
- return candidate;
735
- }
736
- if (typeof candidate === "number" && Number.isFinite(candidate)) {
737
- return candidate;
738
- }
739
- return undefined;
740
- };
741
- const fields = readSearchString("fields");
742
- const compactRequested = options.compact === true;
743
- const fullRequested = options.full === true;
744
- const defaultCompact = !compactRequested && !fullRequested && fields === undefined;
745
- const mode = options.semantic === true
746
- ? "semantic"
747
- : options.hybrid === true
748
- ? "hybrid"
749
- : readSearchString("mode");
750
- const normalized = {
751
- mode,
752
- matchMode: readSearchString("matchMode"),
753
- minScore: readSearchStringOrNumber("minScore"),
754
- count: optionTrue(options, "count"),
755
- semanticWeight: readSearchStringOrNumber("semanticWeight"),
756
- includeLinked: optionTrue(options, "includeLinked"),
757
- titleExact: optionTrue(options, "titleExact"),
758
- phraseExact: optionTrue(options, "phraseExact"),
759
- highlight: optionTrue(options, "highlight"),
760
- status: readSearchString("status"),
761
- type: readSearchString("type"),
762
- tag: readSearchString("tag"),
763
- priority: readSearchString("priority"),
764
- deadlineBefore: readSearchString("deadlineBefore"),
765
- deadlineAfter: readSearchString("deadlineAfter"),
766
- updatedAfter: readSearchString("updatedAfter"),
767
- updatedBefore: readSearchString("updatedBefore"),
768
- createdAfter: readSearchString("createdAfter"),
769
- createdBefore: readSearchString("createdBefore"),
770
- assignee: readSearchString("assignee"),
771
- sprint: readSearchString("sprint"),
772
- release: readSearchString("release"),
773
- parent: readSearchString("parent"),
774
- limit: readSearchString("limit"),
775
- fields,
776
- compact: compactRequested || defaultCompact ? true : undefined,
777
- full: optionTrue(options, "full"),
778
- // Governance-missing (GH-236) + content presence/absence (GH-242) filters,
779
- // mirroring normalizeListOptions via the shared field slice.
780
- ...readSelectionFilterOptionFields(options),
781
- };
782
- copyUnknownOptions(normalized, options);
783
- return normalized;
784
- }
785
- /** Implements normalize search keywords input for the public runtime surface of this module. */
786
- export function normalizeSearchKeywordsInput(keywords) {
787
- const query = keywords
788
- .map((entry) => entry.trim())
789
- .filter((entry) => entry.length > 0)
790
- .join(" ");
791
- if (query.length === 0) {
792
- throw new PmCliError("Search query must not be empty", EXIT_CODE.USAGE);
793
- }
794
- return query;
795
- }
796
- /** Implements normalize activity options for the public runtime surface of this module. */
797
- export function normalizeActivityOptions(options) {
798
- const readActivityString = (target) => readFirstStringFromCommanderOptions(options, resolveCommanderContract(ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, target));
799
- const normalized = {
800
- id: readActivityString("id"),
801
- op: readActivityString("op"),
802
- author: readActivityString("author"),
803
- from: readActivityString("from"),
804
- to: readActivityString("to"),
805
- limit: readActivityString("limit"),
806
- compact: options.full === true || options.provenance === true
807
- ? false
808
- : options.compact === true || options.raw === true
809
- ? true
810
- : undefined,
811
- ...(options.raw === true ||
812
- options.compact === true ||
813
- options.full === true
814
- ? { raw: true }
815
- : {}),
816
- unbounded: optionTrue(options, "unbounded"),
817
- provenance: optionTrue(options, "provenance"),
818
- provenanceSummary: optionTrue(options, "provenanceSummary"),
819
- harness: Array.isArray(options.harness)
820
- ? options.harness
821
- : undefined,
822
- agentInstance: Array.isArray(options.agentInstance)
823
- ? options.agentInstance
824
- : undefined,
825
- provenanceFilter: Array.isArray(options.provenanceFilter)
826
- ? options.provenanceFilter
827
- : undefined,
828
- };
829
- return Object.fromEntries(Object.entries(normalized).filter(([, value]) => value !== undefined));
830
- }
831
- const ACTIVITY_STREAM_ENABLED_VALUES = new Set([
832
- "",
833
- "rows",
834
- "ndjson",
835
- "jsonl",
836
- "true",
837
- "1",
838
- "yes",
839
- "on",
840
- ]);
841
- const ACTIVITY_STREAM_DISABLED_VALUES = new Set(["false", "off", "none", "0"]);
842
- /** Implements resolve activity stream mode for the public runtime surface of this module. */
843
- export function resolveActivityStreamMode(raw) {
844
- if (raw === true) {
845
- return true;
846
- }
847
- if (raw === false || raw === undefined || raw === null) {
848
- return false;
849
- }
850
- if (typeof raw === "string") {
851
- const normalized = raw.trim().toLowerCase();
852
- if (ACTIVITY_STREAM_ENABLED_VALUES.has(normalized)) {
853
- return true;
854
- }
855
- if (ACTIVITY_STREAM_DISABLED_VALUES.has(normalized)) {
856
- return false;
857
- }
858
- }
859
- throw new PmCliError("Activity --stream accepts rows|ndjson|jsonl (or no value)", EXIT_CODE.USAGE);
860
- }
861
- /** Implements normalize context options for the public runtime surface of this module. */
862
- export function normalizeContextOptions(options) {
863
- const readContextString = (target) => readFirstStringFromCommanderOptions(options, resolveCommanderContract(CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, target));
864
- const readContextStringOrNumber = (target) => readStringOrFiniteNumberFromCommanderOptions(options, resolveCommanderContract(CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, target));
865
- const sectionRaw = options.section;
866
- const section = Array.isArray(sectionRaw)
867
- ? sectionRaw.filter((v) => typeof v === "string" && v.trim().length > 0)
868
- : typeof sectionRaw === "string" && sectionRaw.trim().length > 0
869
- ? [sectionRaw]
870
- : undefined;
871
- const normalized = {
872
- date: readContextString("date"),
873
- from: readContextString("from"),
874
- to: readContextString("to"),
875
- past: options.past === true ? true : undefined,
876
- type: readContextString("type"),
877
- tag: readContextString("tag"),
878
- priority: readContextString("priority"),
879
- assignee: readContextString("assignee"),
880
- assigneeFilter: readContextString("assigneeFilter"),
881
- sprint: readContextString("sprint"),
882
- release: readContextString("release"),
883
- parent: readContextString("parent"),
884
- limit: readContextString("limit"),
885
- format: readContextString("format"),
886
- depth: readContextString("depth"),
887
- fields: readContextString("fields"),
888
- section: section && section.length > 0 ? section : undefined,
889
- activityLimit: readContextString("activityLimit"),
890
- staleThreshold: readContextString("staleThreshold"),
891
- tokenBudget: readContextStringOrNumber("tokenBudget"),
892
- noExtensionHealth: options.extensionHealth === false ? true : undefined,
893
- noTags: options.tags === false ? true : undefined,
894
- };
895
- for (const [key, value] of Object.entries(options)) {
896
- if (Object.hasOwn(normalized, key)) {
897
- continue;
898
- }
899
- normalized[key] = value;
900
- }
901
- return normalized;
902
- }
903
- /**
904
- * Normalizes raw commander options for `pm next` into a typed {@link NextOptions}
905
- * payload, resolving snake_case flag aliases (e.g. `--assignee_filter`,
906
- * `--blocked_limit`, `--ready_only`) to their canonical camelCase keys and folding
907
- * the boolean `--ready-only` switch. Unknown keys are passed through untouched so
908
- * downstream filtering still sees them.
909
- */
910
- export function normalizeNextOptions(options) {
911
- const readNextString = (target) => readFirstStringFromCommanderOptions(options, resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS, target));
912
- const readNextStringOrNumber = (target) => readStringOrFiniteNumberFromCommanderOptions(options, resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS, target));
913
- const normalized = {
914
- type: readNextString("type"),
915
- tag: readNextString("tag"),
916
- priority: readNextStringOrNumber("priority"),
917
- assignee: readNextString("assignee"),
918
- assigneeFilter: readNextString("assigneeFilter"),
919
- sprint: readNextString("sprint"),
920
- release: readNextString("release"),
921
- parent: readNextString("parent"),
922
- limit: readNextString("limit"),
923
- blockedLimit: readNextString("blockedLimit"),
924
- readyOnly: options.readyOnly === true || options.ready_only === true
925
- ? true
926
- : undefined,
927
- format: readNextString("format"),
928
- tokenBudget: readNextStringOrNumber("tokenBudget"),
929
- };
930
- for (const [key, value] of Object.entries(options)) {
931
- if (Object.hasOwn(normalized, key)) {
932
- continue;
933
- }
934
- normalized[key] = value;
935
- }
936
- return normalized;
937
- }
938
- function collectMutationItemIds(result) {
939
- if (!result || typeof result !== "object") {
940
- return [];
941
- }
942
- const record = result;
943
- const ids = new Set();
944
- const pushId = (value) => {
945
- if (typeof value !== "string") {
946
- return;
947
- }
948
- const normalized = value.trim();
949
- if (normalized.length === 0) {
950
- return;
951
- }
952
- ids.add(normalized);
953
- };
954
- pushId(record.id);
955
- const item = record.item;
956
- if (item && typeof item === "object") {
957
- pushId(item.id);
958
- }
959
- const explicitIds = record.ids;
960
- if (Array.isArray(explicitIds)) {
961
- for (const candidate of explicitIds) {
962
- pushId(candidate);
963
- }
964
- }
965
- const items = record.items;
966
- if (Array.isArray(items)) {
967
- for (const candidate of items) {
968
- if (!candidate || typeof candidate !== "object") {
969
- continue;
970
- }
971
- pushId(candidate.id);
972
- }
973
- }
974
- return [...ids].sort((left, right) => left.localeCompare(right));
975
- }
976
- /** Implements invalidate search caches for mutation for the public runtime surface of this module. */
977
- export async function invalidateSearchCachesForMutation(globalOptions, result) {
978
- const pmRoot = resolvePmRoot(process.cwd(), globalOptions.path);
979
- const refreshResult = await refreshSearchArtifactsForMutation(pmRoot, collectMutationItemIds(result), {
980
- background: !shouldRunSearchRefreshInForeground(),
981
- });
982
- if (globalOptions.profile && refreshResult.warnings.length > 0) {
983
- printError(`profile:search_refresh_warnings=${formatHookWarnings(refreshResult.warnings)}`);
984
- }
985
- }
986
- /** Public contract for test only, shared by SDK and presentation-layer consumers. */
987
- export const _testOnly = {
988
- collectMutationItemIds,
989
- };
1
+ !(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]="7ffd5046-9154-52e7-94ce-192b07b8ceae")}catch(e2){}})();import{Option}from"commander";import{resolvePmHistoryOperation}from"./command-aliases.js";import{pathExists,refreshSearchArtifactsForMutation,shouldRunSearchRefreshInForeground,EXIT_CODE,PmCliError,printError,printResult,writeStdout,getSettingsPath,resolvePmRoot,readSettings,runActiveServiceOverride,setActiveCommandResult}from"../runtime-primitives.js";import{ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,CREATE_COMMANDER_STRING_OPTION_CONTRACTS,LIST_COMMANDER_STRING_OPTION_CONTRACTS,NEXT_COMMANDER_STRING_OPTION_CONTRACTS,SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,readFirstValueFromCommanderOptions,readFirstStringFromCommanderOptions,readStringArrayFromCommanderOptions}from"../cli-contracts.js";async function applyActiveCommandResultService(command,args,options,global2,result){const pmRoot=resolvePmRoot(process.cwd(),global2.path);const override=await runActiveServiceOverride("command_result",{command,args,options,global:global2,pm_root:pmRoot,result});return override.handled?override.result:result}function syncCommanderActionOptions(actionCommand,commandOptions){for(const[key,value]of Object.entries(commandOptions)){actionCommand.setOptionValueWithSource(key,value,"cli")}}function readJoinedRepeatedOption(options,contract){const values=[];const observedArrays=new Set;for(const key of contract.keys){if(!Object.hasOwn(options,key)){continue}const value=options[key];if(value==null){continue}if(typeof value==="string"){values.push(value);continue}if(!Array.isArray(value)||!value.every(entry=>typeof entry==="string")){return void 0}if(observedArrays.has(value)){continue}observedArrays.add(value);values.push(...value)}return values.length>0?values.join("; "):void 0}const RESOLVED_GLOBAL_OPTIONS=Symbol("pm.resolvedGlobalOptions");function commandOptionsReader(command){return typeof command==="object"&&command!==null?command:{}}function resolveCommanderContract(contracts,target){const contract=contracts.find(entry=>entry.target===target);return contract??{target,keys:[target]}}function setResolvedGlobalOptions(command,globalOptions){command[RESOLVED_GLOBAL_OPTIONS]={...globalOptions}}function clearResolvedGlobalOptions(command){delete command[RESOLVED_GLOBAL_OPTIONS]}function readStringCommandOption(options,key){return typeof options[key]==="string"?options[key]:void 0}function getGlobalOptions(command){const commandPath=resolvePmHistoryOperation(getCommandPath(command));const resolved=command[RESOLVED_GLOBAL_OPTIONS];if(resolved){return{...resolved,...commandPath.length>0?{command:commandPath}:{}}}const reader=commandOptionsReader(command);const opts=typeof reader.optsWithGlobals==="function"?reader.optsWithGlobals():typeof reader.opts==="function"?reader.opts():{};const normalized={json:opts.json===true?true:void 0,quiet:Boolean(opts.quiet),noChangedFields:opts.changedFields===false,...opts.fullChangedFields===true?{fullChangedFields:true}:{},idOnly:opts.idOnly===true,...opts.lean===true?{lean:true}:{},...opts.tokenAccounting===true?{tokenAccounting:true}:{},outputInclude:readStringCommandOption(opts,"outputInclude"),outputLimit:readStringCommandOption(opts,"outputLimit"),outputBudget:readStringCommandOption(opts,"outputBudget"),outputSession:readStringCommandOption(opts,"outputSession"),outputCursor:readStringCommandOption(opts,"outputCursor"),...opts.outputRowContract===true?{outputRowContract:true}:{},...opts.outputFormat==="toon"||opts.outputFormat==="json"?{outputFormat:opts.outputFormat}:{},path:readStringCommandOption(opts,"pmPath")??readStringCommandOption(opts,"path"),noExtensions:opts.extensions===false,noPager:Boolean(opts.noPager),profile:Boolean(opts.profile),...commandPath.length>0?{command:commandPath}:{},...typeof opts.author==="string"?{author:opts.author}:{}};return normalized}function getCommandPath(command){const parts=[];let current=command;while(current?.parent){parts.unshift(current.name());current=current.parent}return parts.join(" ")}async function applyDefaultOutputFormat(globalOptions){if(globalOptions.json===true){return globalOptions}const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);if(!await pathExists(getSettingsPath(pmRoot))){return globalOptions}const settings=await readSettings(pmRoot);return{...globalOptions,defaultOutputFormat:settings.output.default_format}}function collect(value,previous){const next=previous??[];next.push(value);return next}function pushOptionalValueFlag(args,flag,value){if(typeof value!=="string"){return}const trimmed=value.trim();if(trimmed.length===0){return}args.push(flag,trimmed)}function pushOptionalBooleanFlag(args,flag,value){if(value===true){args.push(flag)}}function pushRepeatableValueFlag(args,flag,values){if(!Array.isArray(values)){return}for(const value of values){if(typeof value!=="string"){continue}const trimmed=value.trim();if(trimmed.length===0){continue}args.push(flag,trimmed)}}function optionTrue(options,key){return options[key]===true?true:void 0}function optionFalse(options,key){return options[key]===false?true:void 0}function readOptionString(options,key){return typeof options[key]==="string"?options[key]:void 0}function addHiddenOption(command,flags,description,repeatable=false,repeatableParser=void 0){const option=new Option(flags,description).hideHelp();if(repeatable){option.argParser(repeatableParser??collect)}command.addOption(option)}function addHiddenOptions(command,aliases,repeatable){for(const[flags,description]of aliases){addHiddenOption(command,flags,description,repeatable)}}function anyOptionTrue(options,keys){return keys.some(key=>options[key]===true)?true:void 0}function readStringOrFiniteNumberFromCommanderOptions(options,contract){const value=readFirstValueFromCommanderOptions(options,contract);return typeof value==="string"||typeof value==="number"&&Number.isFinite(value)?value:void 0}function copyUnknownOptions(target,source){for(const[key,value]of Object.entries(source)){if(key==="__proto__"||key==="constructor"||key==="prototype"){continue}if(Object.hasOwn(target,key)){continue}target[key]=value}}function buildBackgroundTestCommandArgs(id,options){const args=["test",id,"--run","--json","--progress"];pushRepeatableValueFlag(args,"--add",options.add);pushRepeatableValueFlag(args,"--add-json",options.addJson);pushRepeatableValueFlag(args,"--remove",options.remove);pushRepeatableValueFlag(args,"--remove-index",options.removeIndex);pushOptionalValueFlag(args,"--match",options.match);pushOptionalValueFlag(args,"--only-index",options.onlyIndex);pushOptionalBooleanFlag(args,"--only-last",options.onlyLast);pushRepeatableValueFlag(args,"--measure",options.measure);pushOptionalValueFlag(args,"--metric-below",options.metricBelow);pushOptionalValueFlag(args,"--metric-diff",options.metricDiff);pushSharedBackgroundTestCommandArgs(args,options);pushOptionalValueFlag(args,"--author",options.author);pushOptionalValueFlag(args,"--message",options.message);pushOptionalBooleanFlag(args,"--force",options.force);return args}function pushSharedBackgroundTestCommandArgs(args,options){pushOptionalValueFlag(args,"--timeout",options.timeout);pushRepeatableValueFlag(args,"--env-set",options.envSet);pushRepeatableValueFlag(args,"--env-clear",options.envClear);pushOptionalBooleanFlag(args,"--shared-host-safe",options.sharedHostSafe);pushOptionalValueFlag(args,"--pm-context",options.pmContext);pushOptionalBooleanFlag(args,"--override-linked-pm-context",options.overrideLinkedPmContext);pushOptionalValueFlag(args,"--workspace-context",options.workspaceContext);pushOptionalBooleanFlag(args,"--override-linked-workspace-context",options.overrideLinkedWorkspaceContext);pushOptionalBooleanFlag(args,"--allow-untrusted-linked-tests",options.allowUntrustedLinkedTests);pushOptionalBooleanFlag(args,"--fail-on-context-mismatch",options.failOnContextMismatch);pushOptionalBooleanFlag(args,"--fail-on-skipped",options.failOnSkipped);pushOptionalBooleanFlag(args,"--fail-on-empty-test-run",options.failOnEmptyTestRun);pushOptionalBooleanFlag(args,"--require-assertions-for-pm",options.requireAssertionsForPm);pushOptionalBooleanFlag(args,"--check-context",options.checkContext);pushOptionalBooleanFlag(args,"--auto-pm-context",options.autoPmContext)}function buildBackgroundTestAllCommandArgs(options){const args=["test-all","--json","--progress"];pushOptionalValueFlag(args,"--status",options.status);pushOptionalValueFlag(args,"--limit",options.limit);pushOptionalValueFlag(args,"--offset",options.offset);pushSharedBackgroundTestCommandArgs(args,options);return args}function formatHookWarnings(warnings){return warnings.join(",")}function normalizeCreateOptions(commandOptions,options={}){const readCreateString=target=>readFirstStringFromCommanderOptions(commandOptions,resolveCommanderContract(CREATE_COMMANDER_STRING_OPTION_CONTRACTS,target));const readCreateList=target=>readStringArrayFromCommanderOptions(commandOptions,resolveCommanderContract(CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,target));const type=readCreateString("type");if(options.requireType!==false&&type===void 0){throw new PmCliError("Missing required option --type <value>. Why required: create resolves runtime schema fields/workflow from item type. Retry: add --type <built-in or configured custom type> (example: --type Task).",EXIT_CODE.USAGE)}const normalized={title:readCreateString("title"),description:readCreateString("description"),type,template:readCreateString("template"),createMode:readCreateString("createMode"),schedulePreset:readCreateString("schedulePreset"),status:readCreateString("status"),closeReason:readCreateString("closeReason"),completedAt:readCreateString("completedAt"),priority:readCreateString("priority"),tags:readCreateString("tags"),addTags:readCreateList("addTags"),body:readCreateString("body"),deadline:readCreateString("deadline"),estimatedMinutes:readCreateString("estimatedMinutes"),acceptanceCriteria:readJoinedRepeatedOption(commandOptions,resolveCommanderContract(CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,"acceptanceCriteria")),definitionOfReady:readCreateString("definitionOfReady"),order:readCreateString("order"),rank:readCreateString("rank"),goal:readCreateString("goal"),objective:readCreateString("objective"),value:readCreateString("value"),impact:readCreateString("impact"),outcome:readCreateString("outcome"),whyNow:readCreateString("whyNow"),author:readCreateString("author"),message:readCreateString("message"),assignee:readCreateString("assignee"),parent:readCreateString("parent"),allowMissingParent:anyOptionTrue(commandOptions,["allowMissingParent","allow_missing_parent"])===true,allowUnresolvedDeps:anyOptionTrue(commandOptions,["allowUnresolvedDeps","allow_unresolved_deps"])===true,allowDuplicate:optionTrue(commandOptions,"allowDuplicate")===true,reviewer:readCreateString("reviewer"),risk:readCreateString("risk"),confidence:readCreateString("confidence"),sprint:readCreateString("sprint"),release:readCreateString("release"),blockedBy:readCreateString("blockedBy"),blockedReason:readCreateString("blockedReason"),unblockNote:readCreateString("unblockNote"),reporter:readCreateString("reporter"),severity:readCreateString("severity"),environment:readCreateString("environment"),reproSteps:readCreateString("reproSteps"),resolution:readCreateString("resolution"),expectedResult:readCreateString("expectedResult"),actualResult:readCreateString("actualResult"),affectedVersion:readCreateString("affectedVersion"),fixedVersion:readCreateString("fixedVersion"),component:readCreateString("component"),regression:commandOptions.regression===true?"true":readCreateString("regression"),customerImpact:readCreateString("customerImpact"),dep:readCreateList("dep"),comment:readCreateList("comment"),note:readCreateList("note"),learning:readCreateList("learning"),file:readCreateList("file"),test:readCreateList("test"),doc:readCreateList("doc"),reminder:readCreateList("reminder"),event:readCreateList("event"),typeOption:readCreateList("typeOption"),field:readCreateList("field"),unset:readCreateList("unset"),clearDeps:optionTrue(commandOptions,"clearDeps"),clearComments:optionTrue(commandOptions,"clearComments"),clearNotes:optionTrue(commandOptions,"clearNotes"),clearLearnings:optionTrue(commandOptions,"clearLearnings"),clearFiles:optionTrue(commandOptions,"clearFiles"),clearTests:optionTrue(commandOptions,"clearTests"),clearDocs:optionTrue(commandOptions,"clearDocs"),clearReminders:optionTrue(commandOptions,"clearReminders"),clearEvents:optionTrue(commandOptions,"clearEvents"),clearTypeOptions:optionTrue(commandOptions,"clearTypeOptions")};copyUnknownOptions(normalized,commandOptions);return normalized}function normalizeUpdateOptions(commandOptions){const readUpdateString=target=>readFirstStringFromCommanderOptions(commandOptions,resolveCommanderContract(UPDATE_COMMANDER_STRING_OPTION_CONTRACTS,target));const readUpdateList=target=>readStringArrayFromCommanderOptions(commandOptions,resolveCommanderContract(UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,target));const normalized={title:readUpdateString("title"),description:readUpdateString("description"),body:readUpdateString("body"),status:readUpdateString("status"),closeReason:readUpdateString("closeReason"),priority:readUpdateString("priority"),type:readUpdateString("type"),tags:readUpdateString("tags"),addTags:readUpdateList("addTags"),removeTags:readUpdateList("removeTags"),deadline:readUpdateString("deadline"),estimatedMinutes:readUpdateString("estimatedMinutes"),acceptanceCriteria:readJoinedRepeatedOption(commandOptions,resolveCommanderContract(UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS,"acceptanceCriteria")),addAc:readUpdateList("addAc"),removeAc:readUpdateList("removeAc"),definitionOfReady:readUpdateString("definitionOfReady"),order:readUpdateString("order"),rank:readUpdateString("rank"),goal:readUpdateString("goal"),objective:readUpdateString("objective"),value:readUpdateString("value"),impact:readUpdateString("impact"),outcome:readUpdateString("outcome"),whyNow:readUpdateString("whyNow"),author:readUpdateString("author"),message:readUpdateString("message"),force:Boolean(commandOptions.force),ownershipMetadataBypass:commandOptions.ownershipMetadataBypass===true?true:void 0,ownershipDependencyBypass:commandOptions.ownershipDependencyBypass===true?true:void 0,assignee:readUpdateString("assignee"),parent:readUpdateString("parent"),allowUnresolvedDeps:anyOptionTrue(commandOptions,["allowUnresolvedDeps","allow_unresolved_deps"])===true,reviewer:readUpdateString("reviewer"),risk:readUpdateString("risk"),confidence:readUpdateString("confidence"),sprint:readUpdateString("sprint"),release:readUpdateString("release"),blockedBy:readUpdateString("blockedBy"),blockedReason:readUpdateString("blockedReason"),unblockNote:readUpdateString("unblockNote"),reporter:readUpdateString("reporter"),severity:readUpdateString("severity"),environment:readUpdateString("environment"),reproSteps:readUpdateString("reproSteps"),resolution:readUpdateString("resolution"),expectedResult:readUpdateString("expectedResult"),actualResult:readUpdateString("actualResult"),affectedVersion:readUpdateString("affectedVersion"),fixedVersion:readUpdateString("fixedVersion"),component:readUpdateString("component"),regression:commandOptions.regression===true?"true":readUpdateString("regression"),customerImpact:readUpdateString("customerImpact"),dep:readUpdateList("dep"),depRemove:readUpdateList("depRemove"),replaceDeps:optionTrue(commandOptions,"replaceDeps"),replaceTests:optionTrue(commandOptions,"replaceTests"),replaceFiles:optionTrue(commandOptions,"replaceFiles"),replaceDocs:optionTrue(commandOptions,"replaceDocs"),comment:readUpdateList("comment"),note:readUpdateList("note"),learning:readUpdateList("learning"),file:readUpdateList("file"),test:readUpdateList("test"),doc:readUpdateList("doc"),reminder:readUpdateList("reminder"),event:readUpdateList("event"),typeOption:readUpdateList("typeOption"),field:readUpdateList("field"),unset:readUpdateList("unset"),clearDeps:optionTrue(commandOptions,"clearDeps"),clearComments:optionTrue(commandOptions,"clearComments"),clearNotes:optionTrue(commandOptions,"clearNotes"),clearLearnings:optionTrue(commandOptions,"clearLearnings"),clearFiles:optionTrue(commandOptions,"clearFiles"),clearTests:optionTrue(commandOptions,"clearTests"),clearDocs:optionTrue(commandOptions,"clearDocs"),clearReminders:optionTrue(commandOptions,"clearReminders"),clearEvents:optionTrue(commandOptions,"clearEvents"),clearTypeOptions:optionTrue(commandOptions,"clearTypeOptions")};copyUnknownOptions(normalized,commandOptions);return normalized}const UPDATE_MANY_CONTROL_OPTION_KEYS=new Set(["filterStatus","filterType","filterTag","filterPriority","filterDeadlineBefore","filterDeadlineAfter","filterUpdatedAfter","filterUpdatedBefore","filterCreatedAfter","filterCreatedBefore","filterAssignee","filterAssigneeFilter","filterAssignee_filter","filterParent","filterSprint","filterRelease","filterAcMissing","filterEstimatesMissing","filterEstimateMissing","filterResolutionMissing","filterMetadataMissing","filterReviewerMissing","filterRiskMissing","filterConfidenceMissing","filterSprintMissing","filterReleaseMissing","filterHasNotes","filterNoNotes","filterHasLearnings","filterNoLearnings","filterHasFiles","filterNoFiles","filterHasDocs","filterNoDocs","filterHasTests","filterNoTests","filterHasComments","filterNoComments","filterHasDeps","filterNoDeps","filterHasBody","filterEmptyBody","filterHasLinkedCommand","filterNoLinkedCommand","ids","limit","offset","dryRun","rollback","checkpoint"]);function extractUpdateManyMutationOptionSource(commandOptions){const mutationOptions={};for(const[key,value]of Object.entries(commandOptions)){if(UPDATE_MANY_CONTROL_OPTION_KEYS.has(key)){continue}mutationOptions[key]=value}return mutationOptions}function readListOptionString(options,target){const contract=resolveCommanderContract(LIST_COMMANDER_STRING_OPTION_CONTRACTS,target);const stringValue=readFirstStringFromCommanderOptions(options,contract);if(stringValue!==void 0){return stringValue}for(const key of contract.keys){const value=options[key];if(Array.isArray(value)){const strings=value.filter(entry=>typeof entry==="string");if(strings.length>0){return strings.join(",")}}if(target==="ids"&&typeof value==="string"){return value}if(typeof value==="number"&&Number.isFinite(value)){return String(value)}}return void 0}function readSelectionFilterOptionFields(options){const filterFilesMissing=optionTrue(options,"filterFilesMissing");const filterDocsMissing=optionTrue(options,"filterDocsMissing");return{filterReviewerMissing:optionTrue(options,"filterReviewerMissing"),filterRiskMissing:optionTrue(options,"filterRiskMissing"),filterConfidenceMissing:optionTrue(options,"filterConfidenceMissing"),filterSprintMissing:optionTrue(options,"filterSprintMissing"),filterReleaseMissing:optionTrue(options,"filterReleaseMissing"),hasNotes:optionTrue(options,"hasNotes"),hasLearnings:optionTrue(options,"hasLearnings"),hasFiles:optionTrue(options,"hasFiles"),hasDocs:optionTrue(options,"hasDocs"),hasTests:optionTrue(options,"hasTests"),hasComments:optionTrue(options,"hasComments"),hasDeps:optionTrue(options,"hasDeps"),hasBody:optionTrue(options,"hasBody"),hasLinkedCommand:optionTrue(options,"hasLinkedCommand"),noNotes:optionFalse(options,"notes"),noLearnings:optionFalse(options,"learnings"),noFiles:optionFalse(options,"files")??filterFilesMissing,filterFilesMissing,noDocs:optionFalse(options,"docs")??filterDocsMissing,filterDocsMissing,noTests:optionFalse(options,"tests"),noComments:optionFalse(options,"comments"),noDeps:optionFalse(options,"deps"),emptyBody:optionTrue(options,"emptyBody"),noLinkedCommand:optionFalse(options,"linkedCommand")}}function normalizeListOptions(options){const normalized={status:readListOptionString(options,"status"),type:readListOptionString(options,"type"),tag:readListOptionString(options,"tag"),priority:readListOptionString(options,"priority"),deadlineBefore:readListOptionString(options,"deadlineBefore"),deadlineAfter:readListOptionString(options,"deadlineAfter"),updatedAfter:readListOptionString(options,"updatedAfter"),updatedBefore:readListOptionString(options,"updatedBefore"),createdAfter:readListOptionString(options,"createdAfter"),createdBefore:readListOptionString(options,"createdBefore"),today:optionTrue(options,"today"),recent:optionTrue(options,"recent"),ids:readListOptionString(options,"ids"),assignee:readListOptionString(options,"assignee"),assigneeFilter:readListOptionString(options,"assigneeFilter"),parent:readListOptionString(options,"parent"),sprint:readListOptionString(options,"sprint"),release:readListOptionString(options,"release"),limit:readListOptionString(options,"limit"),offset:readListOptionString(options,"offset"),noTruncate:optionFalse(options,"truncate"),includeBody:optionTrue(options,"includeBody"),strictRead:optionTrue(options,"strictRead"),compact:optionTrue(options,"compact"),brief:optionTrue(options,"brief"),full:optionTrue(options,"full"),fields:readListOptionString(options,"fields"),sort:readListOptionString(options,"sort"),order:readListOptionString(options,"order"),tree:optionTrue(options,"tree"),treeDepth:readListOptionString(options,"treeDepth"),filterAcMissing:optionTrue(options,"filterAcMissing"),filterEstimatesMissing:anyOptionTrue(options,["filterEstimatesMissing","filterEstimateMissing"]),filterResolutionMissing:optionTrue(options,"filterResolutionMissing"),filterMetadataMissing:optionTrue(options,"filterMetadataMissing"),...readSelectionFilterOptionFields(options)};copyUnknownOptions(normalized,options);return normalized}function normalizeAggregateOptions(options){return{groupBy:typeof options.groupBy==="string"?options.groupBy:void 0,setMode:typeof options.setMode==="string"?options.setMode:void 0,limit:readListOptionString(options,"limit"),after:readListOptionString(options,"after"),count:options.count===true?true:void 0,completion:options.completion===true?true:void 0,sum:typeof options.sum==="string"?options.sum:void 0,avg:typeof options.avg==="string"?options.avg:void 0,includeUnparented:options.includeUnparented===true||options.include_unparented===true,status:typeof options.status==="string"?options.status:void 0,type:readListOptionString(options,"type"),tag:readListOptionString(options,"tag"),priority:readListOptionString(options,"priority"),deadlineBefore:readListOptionString(options,"deadlineBefore"),deadlineAfter:readListOptionString(options,"deadlineAfter"),assignee:readListOptionString(options,"assignee"),assigneeFilter:readListOptionString(options,"assigneeFilter"),parent:readListOptionString(options,"parent"),sprint:readListOptionString(options,"sprint"),release:readListOptionString(options,"release")}}function printListJsonStream(commandName,result,globalOptions){setActiveCommandResult(result);if(globalOptions.quiet){return}const warnings=Array.isArray(result.warnings)?result.warnings:[];const metaPayload={type:"meta",command:commandName,count:result.count,now:result.now,filters:result.filters};if(warnings.length>0){metaPayload.warnings=warnings}if(!writeStdout(`${JSON.stringify(metaPayload)}
2
+ `)){return}for(const item of result.items){if(!writeStdout(`${JSON.stringify({type:"item",command:commandName,item})}
3
+ `)){return}}writeStdout(`${JSON.stringify({type:"end",command:commandName,count:result.count})}
4
+ `)}function printActivityJsonStream(result,options,globalOptions){setActiveCommandResult(result);if(globalOptions.quiet){return}const metaPayload={type:"meta",command:"activity",count:result.count,filters:{id:options.id??null,op:options.op??null,author:options.author??null,from:options.from??null,to:options.to??null,limit:options.limit??null}};if(!writeStdout(`${JSON.stringify(metaPayload)}
5
+ `)){return}const entries=result.compact&&result.compact_activity?result.compact_activity:result.activity??[];for(const entry of entries){if(!writeStdout(`${JSON.stringify({type:"entry",command:"activity",entry})}
6
+ `)){return}}writeStdout(`${JSON.stringify({type:"end",command:"activity",count:result.count})}
7
+ `)}function normalizeSearchOptions(options){const readSearchString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,target));const readSearchStringOrNumber=target=>{const candidate=readFirstValueFromCommanderOptions(options,resolveCommanderContract(SEARCH_COMMANDER_STRING_OPTION_CONTRACTS,target));if(typeof candidate==="string"){return candidate}if(typeof candidate==="number"&&Number.isFinite(candidate)){return candidate}return void 0};const fields=readSearchString("fields");const compactRequested=options.compact===true;const fullRequested=options.full===true;const defaultCompact=!compactRequested&&!fullRequested&&fields===void 0;const mode=options.semantic===true?"semantic":options.hybrid===true?"hybrid":readSearchString("mode");const normalized={mode,matchMode:readSearchString("matchMode"),minScore:readSearchStringOrNumber("minScore"),count:optionTrue(options,"count"),semanticWeight:readSearchStringOrNumber("semanticWeight"),includeLinked:optionTrue(options,"includeLinked"),titleExact:optionTrue(options,"titleExact"),phraseExact:optionTrue(options,"phraseExact"),highlight:optionTrue(options,"highlight"),status:readSearchString("status"),type:readSearchString("type"),tag:readSearchString("tag"),priority:readSearchString("priority"),deadlineBefore:readSearchString("deadlineBefore"),deadlineAfter:readSearchString("deadlineAfter"),updatedAfter:readSearchString("updatedAfter"),updatedBefore:readSearchString("updatedBefore"),createdAfter:readSearchString("createdAfter"),createdBefore:readSearchString("createdBefore"),assignee:readSearchString("assignee"),sprint:readSearchString("sprint"),release:readSearchString("release"),parent:readSearchString("parent"),limit:readSearchString("limit"),fields,compact:compactRequested||defaultCompact?true:void 0,full:optionTrue(options,"full"),...readSelectionFilterOptionFields(options)};copyUnknownOptions(normalized,options);return normalized}function normalizeSearchKeywordsInput(keywords){const query=keywords.map(entry=>entry.trim()).filter(entry=>entry.length>0).join(" ");if(query.length===0){throw new PmCliError("Search query must not be empty",EXIT_CODE.USAGE)}return query}function normalizeActivityOptions(options){const readActivityString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS,target));const normalized={id:readActivityString("id"),op:readActivityString("op"),author:readActivityString("author"),from:readActivityString("from"),to:readActivityString("to"),limit:readActivityString("limit"),compact:options.full===true||options.provenance===true?false:options.compact===true||options.raw===true?true:void 0,...options.raw===true||options.compact===true||options.full===true?{raw:true}:{},unbounded:optionTrue(options,"unbounded"),provenance:optionTrue(options,"provenance"),provenanceSummary:optionTrue(options,"provenanceSummary"),harness:Array.isArray(options.harness)?options.harness:void 0,agentInstance:Array.isArray(options.agentInstance)?options.agentInstance:void 0,provenanceFilter:Array.isArray(options.provenanceFilter)?options.provenanceFilter:void 0};return Object.fromEntries(Object.entries(normalized).filter(([,value])=>value!==void 0))}const ACTIVITY_STREAM_ENABLED_VALUES=new Set(["","rows","ndjson","jsonl","true","1","yes","on"]);const ACTIVITY_STREAM_DISABLED_VALUES=new Set(["false","off","none","0"]);function resolveActivityStreamMode(raw){if(raw===true){return true}if(raw===false||raw===void 0||raw===null){return false}if(typeof raw==="string"){const normalized=raw.trim().toLowerCase();if(ACTIVITY_STREAM_ENABLED_VALUES.has(normalized)){return true}if(ACTIVITY_STREAM_DISABLED_VALUES.has(normalized)){return false}}throw new PmCliError("Activity --stream accepts rows|ndjson|jsonl (or no value)",EXIT_CODE.USAGE)}function normalizeContextOptions(options){const readContextString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,target));const readContextStringOrNumber=target=>readStringOrFiniteNumberFromCommanderOptions(options,resolveCommanderContract(CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS,target));const sectionRaw=options.section;const section=Array.isArray(sectionRaw)?sectionRaw.filter(v=>typeof v==="string"&&v.trim().length>0):typeof sectionRaw==="string"&&sectionRaw.trim().length>0?[sectionRaw]:void 0;const normalized={date:readContextString("date"),from:readContextString("from"),to:readContextString("to"),past:options.past===true?true:void 0,type:readContextString("type"),tag:readContextString("tag"),priority:readContextString("priority"),assignee:readContextString("assignee"),assigneeFilter:readContextString("assigneeFilter"),sprint:readContextString("sprint"),release:readContextString("release"),parent:readContextString("parent"),limit:readContextString("limit"),format:readContextString("format"),depth:readContextString("depth"),fields:readContextString("fields"),section:section&&section.length>0?section:void 0,activityLimit:readContextString("activityLimit"),staleThreshold:readContextString("staleThreshold"),tokenBudget:readContextStringOrNumber("tokenBudget"),noExtensionHealth:options.extensionHealth===false?true:void 0,noTags:options.tags===false?true:void 0};for(const[key,value]of Object.entries(options)){if(Object.hasOwn(normalized,key)){continue}normalized[key]=value}return normalized}function normalizeNextOptions(options){const readNextString=target=>readFirstStringFromCommanderOptions(options,resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS,target));const readNextStringOrNumber=target=>readStringOrFiniteNumberFromCommanderOptions(options,resolveCommanderContract(NEXT_COMMANDER_STRING_OPTION_CONTRACTS,target));const normalized={type:readNextString("type"),tag:readNextString("tag"),priority:readNextStringOrNumber("priority"),assignee:readNextString("assignee"),assigneeFilter:readNextString("assigneeFilter"),sprint:readNextString("sprint"),release:readNextString("release"),parent:readNextString("parent"),limit:readNextString("limit"),blockedLimit:readNextString("blockedLimit"),readyOnly:options.readyOnly===true||options.ready_only===true?true:void 0,format:readNextString("format"),tokenBudget:readNextStringOrNumber("tokenBudget")};for(const[key,value]of Object.entries(options)){if(Object.hasOwn(normalized,key)){continue}normalized[key]=value}return normalized}function collectMutationItemIds(result){if(!result||typeof result!=="object"){return[]}const record=result;const ids=new Set;const pushId=value=>{if(typeof value!=="string"){return}const normalized=value.trim();if(normalized.length===0){return}ids.add(normalized)};pushId(record.id);const item=record.item;if(item&&typeof item==="object"){pushId(item.id)}const explicitIds=record.ids;if(Array.isArray(explicitIds)){for(const candidate of explicitIds){pushId(candidate)}}const items=record.items;if(Array.isArray(items)){for(const candidate of items){if(!candidate||typeof candidate!=="object"){continue}pushId(candidate.id)}}return[...ids].sort((left,right)=>left.localeCompare(right))}async function invalidateSearchCachesForMutation(globalOptions,result){const pmRoot=resolvePmRoot(process.cwd(),globalOptions.path);const refreshResult=await refreshSearchArtifactsForMutation(pmRoot,collectMutationItemIds(result),{background:!shouldRunSearchRefreshInForeground()});if(globalOptions.profile&&refreshResult.warnings.length>0){printError(`profile:search_refresh_warnings=${formatHookWarnings(refreshResult.warnings)}`)}}const _testOnly={collectMutationItemIds};export{_testOnly,addHiddenOption,addHiddenOptions,applyActiveCommandResultService,applyDefaultOutputFormat,buildBackgroundTestAllCommandArgs,buildBackgroundTestCommandArgs,clearResolvedGlobalOptions,collect,extractUpdateManyMutationOptionSource,formatHookWarnings,getCommandPath,getGlobalOptions,invalidateSearchCachesForMutation,normalizeActivityOptions,normalizeAggregateOptions,normalizeContextOptions,normalizeCreateOptions,normalizeListOptions,normalizeNextOptions,normalizeSearchKeywordsInput,normalizeSearchOptions,normalizeUpdateOptions,printActivityJsonStream,printError,printListJsonStream,printResult,readOptionString,resolveActivityStreamMode,setActiveCommandResult,setResolvedGlobalOptions,syncCommanderActionOptions,writeStdout};
990
8
  //# sourceMappingURL=registration-helpers.js.map
991
- //# debugId=01742f33-d1e8-5684-a585-2add88ddb73c