@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,228 +1,3 @@
1
- /**
2
- * @module core/schema/status-defs-file
3
- *
4
- * Resolves configurable schema, fields, statuses, and workflows for Status Defs File.
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]="ec456832-5120-5171-93fd-861ea4125acb")}catch(e){}}();
8
- import { RUNTIME_STATUS_ROLE_VALUES } from "../../types/index.js";
9
- import { DEFAULT_RUNTIME_STATUS_DEFINITIONS } from "./runtime-schema.js";
10
- import { normalizeStatusToken } from "./status-token.js";
11
- export { normalizeStatusToken } from "./status-token.js";
12
- /**
13
- * Pure logic for the `pm schema add-status` / `pm schema remove-status`
14
- * commands. The CLI command file (schema.ts) owns IO/governance; everything
15
- * testable and side-effect-free lives here so it can be coverage-gated to 100%.
16
- *
17
- * Statuses persist at `.agents/pm/schema/statuses.json` under the shape
18
- * `{ statuses: RuntimeStatusDefinition[] }`. When the file is absent the runtime
19
- * merge layer (src/core/store/settings.ts) still supplies the built-in defaults
20
- * from DEFAULT_RUNTIME_STATUS_DEFINITIONS, so this module never duplicates them
21
- * into the persisted file.
22
- */
23
- const RUNTIME_STATUS_ROLE_SET = new Set(RUNTIME_STATUS_ROLE_VALUES);
24
- /** The 5 lifecycle status ids that ship as built-in defaults and may never be removed (their normalized ids match DEFAULT_RUNTIME_STATUS_DEFINITIONS: open/in_progress/blocked/closed/canceled). `draft` is also a default but the acceptance criteria enumerate the 5 terminal/active ids explicitly, so the guard derives the full set from the canonical defaults to stay in sync. */
25
- export const BUILTIN_STATUS_IDS = new Set(DEFAULT_RUNTIME_STATUS_DEFINITIONS.map((definition) => normalizeStatusToken(definition.id)).filter((id) => id.length > 0));
26
- function dedupeTokens(values) {
27
- const seen = new Set();
28
- for (const value of values) {
29
- const token = normalizeStatusToken(value);
30
- if (token.length > 0) {
31
- seen.add(token);
32
- }
33
- }
34
- return [...seen].sort((left, right) => left.localeCompare(right));
35
- }
36
- /**
37
- * Validates and normalizes raw add-status CLI input. Throws a plain Error with a
38
- * stable message when the id is missing/empty or a role is not one of
39
- * RUNTIME_STATUS_ROLE_VALUES; the CLI layer maps these to PmCliError exit codes.
40
- *
41
- * Omitted vs explicit-empty is preserved end-to-end: when `raw.roles`/`raw.aliases`
42
- * is `undefined` (flag not supplied) the normalized field is `undefined` so the
43
- * upsert leaves the existing value untouched; when supplied (even an empty array)
44
- * the field is normalized to an array so the upsert can apply an explicit clear.
45
- */
46
- export function normalizeAddStatusInput(raw) {
47
- const id = normalizeStatusToken(raw.id);
48
- if (id.length === 0) {
49
- throw new Error("Status id must not be empty.");
50
- }
51
- // Built-in lifecycle statuses are reserved and cannot be overridden: an
52
- // add-status override would change reserved metadata yet remove-status refuses
53
- // to delete a built-in id, leaving no CLI path to undo it. Reject up front,
54
- // symmetric with removeStatusDef.
55
- if (BUILTIN_STATUS_IDS.has(id)) {
56
- throw new Error(`Cannot add-status the built-in status "${id}". Built-in statuses are reserved: ${[...BUILTIN_STATUS_IDS].join(", ")}.`);
57
- }
58
- let roles;
59
- if (raw.roles !== undefined) {
60
- roles = [];
61
- const seenRoles = new Set();
62
- for (const rawRole of raw.roles) {
63
- const role = typeof rawRole === "string" ? rawRole.trim().toLowerCase() : "";
64
- if (role.length === 0) {
65
- continue;
66
- }
67
- if (!RUNTIME_STATUS_ROLE_SET.has(role)) {
68
- throw new Error(`Invalid status role "${rawRole}". Allowed roles: ${RUNTIME_STATUS_ROLE_VALUES.join(", ")}.`);
69
- }
70
- if (!seenRoles.has(role)) {
71
- seenRoles.add(role);
72
- roles.push(role);
73
- }
74
- }
75
- if (roles.length === 0) {
76
- throw new Error(`Status role must include at least one lifecycle role. Allowed roles: ${RUNTIME_STATUS_ROLE_VALUES.join(", ")}.`);
77
- }
78
- }
79
- const aliases = raw.aliases === undefined
80
- ? undefined
81
- : dedupeTokens(raw.aliases).filter((alias) => alias !== id);
82
- const description = raw.description?.trim();
83
- const order = typeof raw.order === "number" && Number.isFinite(raw.order)
84
- ? Math.trunc(raw.order)
85
- : undefined;
86
- return {
87
- id,
88
- roles,
89
- aliases,
90
- description: description && description.length > 0 ? description : undefined,
91
- order,
92
- };
93
- }
94
- function selectStatusesArray(parsed) {
95
- if (Array.isArray(parsed)) {
96
- return parsed;
97
- }
98
- if (typeof parsed !== "object" || parsed === null) {
99
- return undefined;
100
- }
101
- const record = parsed;
102
- if (Array.isArray(record.statuses)) {
103
- return record.statuses;
104
- }
105
- if (Array.isArray(record.definitions)) {
106
- return record.definitions;
107
- }
108
- return undefined;
109
- }
110
- function extractStatusDefinitions(parsed) {
111
- const candidate = selectStatusesArray(parsed);
112
- if (!candidate) {
113
- return [];
114
- }
115
- const definitions = [];
116
- for (const entry of candidate) {
117
- if (typeof entry !== "object" || entry === null || Array.isArray(entry)) {
118
- continue;
119
- }
120
- const record = entry;
121
- if (typeof record.id !== "string" || record.id.trim().length === 0) {
122
- continue;
123
- }
124
- definitions.push(record);
125
- }
126
- return definitions;
127
- }
128
- /** Coerces an arbitrary parsed value from statuses.json into a StatusDefsFile. Accepts the canonical `{ statuses: [...] }` shape, a bare array of definitions, or a `{ definitions: [...] }` form, and tolerates a missing/invalid file by returning an empty statuses list. */
129
- export function parseStatusDefsFile(raw) {
130
- if (raw === null || raw === undefined || raw.trim().length === 0) {
131
- return { statuses: [] };
132
- }
133
- let parsed;
134
- try {
135
- parsed = JSON.parse(raw);
136
- }
137
- catch {
138
- throw new Error("schema/statuses.json contains invalid JSON.");
139
- }
140
- return { statuses: extractStatusDefinitions(parsed) };
141
- }
142
- /** Serializes the status definitions file with a trailing newline (matches the rest of the schema scaffold files written by pm). */
143
- export function serializeStatusDefsFile(file) {
144
- return `${JSON.stringify({ statuses: file.statuses }, null, 2)}\n`;
145
- }
146
- /** Idempotent UPSERT of a status definition into the parsed file. Matching is by normalized id. When a definition already exists, fields supplied in `input` override the previous values (roles/aliases replace when a non-empty array is given, clear when an explicit empty array is given, and are left UNTOUCHED when the field is `undefined` — i.e. the add-status flag was omitted); description/order override when provided. Fields not addressed by add-status flags are preserved untouched, so `add-status <id> --description x` keeps any previously-set roles/aliases. */
147
- export function upsertStatusDef(file, input, baseDefinition) {
148
- const statuses = file.statuses.slice();
149
- const existingIndex = statuses.findIndex((definition) => normalizeStatusToken(definition.id) === input.id);
150
- // A file-backed definition is the primary seed; when the status is not yet in
151
- // statuses.json fall back to `baseDefinition` (the resolved settings-backed
152
- // definition) so omitting --role/--alias preserves metadata that lives in
153
- // settings.schema.statuses rather than the file.
154
- const existing = existingIndex >= 0 ? statuses[existingIndex] : baseDefinition;
155
- const next = {
156
- ...existing,
157
- id: input.id,
158
- };
159
- if (input.roles !== undefined) {
160
- if (input.roles.length > 0) {
161
- next.roles = [...input.roles];
162
- }
163
- else if (next.roles !== undefined) {
164
- delete next.roles;
165
- }
166
- }
167
- if (input.aliases !== undefined) {
168
- if (input.aliases.length > 0) {
169
- next.aliases = [...input.aliases];
170
- }
171
- else if (next.aliases !== undefined) {
172
- delete next.aliases;
173
- }
174
- }
175
- if (input.description !== undefined) {
176
- next.description = input.description;
177
- }
178
- if (input.order !== undefined) {
179
- next.order = input.order;
180
- }
181
- if (existingIndex >= 0) {
182
- statuses[existingIndex] = next;
183
- }
184
- else {
185
- statuses.push(next);
186
- }
187
- return {
188
- file: { statuses },
189
- definition: next,
190
- // "replaced" reflects whether the status already existed effectively (in the
191
- // file OR in resolved settings), so the CLI reports "Updated" vs "Registered"
192
- // correctly even when the prior definition lived only in settings.
193
- replaced: existing !== undefined,
194
- };
195
- }
196
- /** Removes a status definition from the parsed file by id (normalized). Throws a plain Error when `id` is empty or matches a reserved built-in default status (those are never stored in the file and must never be deletable). Returns `removed: false` when no matching definition exists so the CLI layer can treat the call as an idempotent no-op. */
197
- export function removeStatusDef(file, id) {
198
- const normalizedId = normalizeStatusToken(id);
199
- if (normalizedId.length === 0) {
200
- throw new Error("Status id must not be empty.");
201
- }
202
- if (BUILTIN_STATUS_IDS.has(normalizedId)) {
203
- throw new Error(`Cannot remove built-in status "${normalizedId}". Built-in statuses are reserved: ${[...BUILTIN_STATUS_IDS].join(", ")}.`);
204
- }
205
- const statuses = file.statuses.slice();
206
- const existingIndex = statuses.findIndex((definition) => normalizeStatusToken(definition.id) === normalizedId);
207
- if (existingIndex < 0) {
208
- return { file: { statuses }, removed: false };
209
- }
210
- const [definition] = statuses.splice(existingIndex, 1);
211
- return { file: { statuses }, removed: true, definition };
212
- }
213
- /** Throws when the new status id or any explicitly-supplied alias collides with a DIFFERENT existing status's id/alias. `resolvedAliasToId` maps a normalized token to its owning status id (the runtime status registry's alias_to_id map, which stores ids and aliases in one namespace). Re-adding the same status (matching id) is allowed — only cross-status collisions throw. This prevents a custom status from shadowing a built-in lifecycle token (for example `add-status review --alias open`, or a custom id `cancelled` that aliases the built-in `canceled`), which would make `pm update --status open` resolve to the wrong status. The CLI layer maps the thrown Error to a USAGE exit code. */
214
- export function assertStatusTokensAvailable(input, resolvedAliasToId) {
215
- const candidates = [input.id, ...(input.aliases ?? [])];
216
- for (const candidate of candidates) {
217
- const token = normalizeStatusToken(candidate);
218
- if (token.length === 0) {
219
- continue;
220
- }
221
- const owner = resolvedAliasToId.get(token);
222
- if (owner !== undefined && owner !== input.id) {
223
- throw new Error(`Status token "${token}" already belongs to status "${owner}". Choose a different id/alias to avoid shadowing it.`);
224
- }
225
- }
226
- }
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]="e3a1e65b-55d7-5206-b3e7-cac3ac29745c")}catch(e2){}})();import{RUNTIME_STATUS_ROLE_VALUES}from"../../types/index.js";import{DEFAULT_RUNTIME_STATUS_DEFINITIONS}from"./runtime-schema.js";import{normalizeStatusToken}from"./status-token.js";import{normalizeStatusToken as normalizeStatusToken2}from"./status-token.js";const RUNTIME_STATUS_ROLE_SET=new Set(RUNTIME_STATUS_ROLE_VALUES);const BUILTIN_STATUS_IDS=new Set(DEFAULT_RUNTIME_STATUS_DEFINITIONS.map(definition=>normalizeStatusToken(definition.id)).filter(id=>id.length>0));function dedupeTokens(values){const seen=new Set;for(const value of values){const token=normalizeStatusToken(value);if(token.length>0){seen.add(token)}}return[...seen].sort((left,right)=>left.localeCompare(right))}function normalizeAddStatusInput(raw){const id=normalizeStatusToken(raw.id);if(id.length===0){throw new Error("Status id must not be empty.")}if(BUILTIN_STATUS_IDS.has(id)){throw new Error(`Cannot add-status the built-in status "${id}". Built-in statuses are reserved: ${[...BUILTIN_STATUS_IDS].join(", ")}.`)}let roles;if(raw.roles!==void 0){roles=[];const seenRoles=new Set;for(const rawRole of raw.roles){const role=typeof rawRole==="string"?rawRole.trim().toLowerCase():"";if(role.length===0){continue}if(!RUNTIME_STATUS_ROLE_SET.has(role)){throw new Error(`Invalid status role "${rawRole}". Allowed roles: ${RUNTIME_STATUS_ROLE_VALUES.join(", ")}.`)}if(!seenRoles.has(role)){seenRoles.add(role);roles.push(role)}}if(roles.length===0){throw new Error(`Status role must include at least one lifecycle role. Allowed roles: ${RUNTIME_STATUS_ROLE_VALUES.join(", ")}.`)}}const aliases=raw.aliases===void 0?void 0:dedupeTokens(raw.aliases).filter(alias=>alias!==id);const description=raw.description?.trim();const order=typeof raw.order==="number"&&Number.isFinite(raw.order)?Math.trunc(raw.order):void 0;return{id,roles,aliases,description:description&&description.length>0?description:void 0,order}}function selectStatusesArray(parsed){if(Array.isArray(parsed)){return parsed}if(typeof parsed!=="object"||parsed===null){return void 0}const record=parsed;if(Array.isArray(record.statuses)){return record.statuses}if(Array.isArray(record.definitions)){return record.definitions}return void 0}function extractStatusDefinitions(parsed){const candidate=selectStatusesArray(parsed);if(!candidate){return[]}const definitions=[];for(const entry of candidate){if(typeof entry!=="object"||entry===null||Array.isArray(entry)){continue}const record=entry;if(typeof record.id!=="string"||record.id.trim().length===0){continue}definitions.push(record)}return definitions}function parseStatusDefsFile(raw){if(raw===null||raw===void 0||raw.trim().length===0){return{statuses:[]}}let parsed;try{parsed=JSON.parse(raw)}catch{throw new Error("schema/statuses.json contains invalid JSON.")}return{statuses:extractStatusDefinitions(parsed)}}function serializeStatusDefsFile(file){return`${JSON.stringify({statuses:file.statuses},null,2)}
2
+ `}function upsertStatusDef(file,input,baseDefinition){const statuses=file.statuses.slice();const existingIndex=statuses.findIndex(definition=>normalizeStatusToken(definition.id)===input.id);const existing=existingIndex>=0?statuses[existingIndex]:baseDefinition;const next={...existing,id:input.id};if(input.roles!==void 0){if(input.roles.length>0){next.roles=[...input.roles]}else if(next.roles!==void 0){delete next.roles}}if(input.aliases!==void 0){if(input.aliases.length>0){next.aliases=[...input.aliases]}else if(next.aliases!==void 0){delete next.aliases}}if(input.description!==void 0){next.description=input.description}if(input.order!==void 0){next.order=input.order}if(existingIndex>=0){statuses[existingIndex]=next}else{statuses.push(next)}return{file:{statuses},definition:next,replaced:existing!==void 0}}function removeStatusDef(file,id){const normalizedId=normalizeStatusToken(id);if(normalizedId.length===0){throw new Error("Status id must not be empty.")}if(BUILTIN_STATUS_IDS.has(normalizedId)){throw new Error(`Cannot remove built-in status "${normalizedId}". Built-in statuses are reserved: ${[...BUILTIN_STATUS_IDS].join(", ")}.`)}const statuses=file.statuses.slice();const existingIndex=statuses.findIndex(definition2=>normalizeStatusToken(definition2.id)===normalizedId);if(existingIndex<0){return{file:{statuses},removed:false}}const[definition]=statuses.splice(existingIndex,1);return{file:{statuses},removed:true,definition}}function assertStatusTokensAvailable(input,resolvedAliasToId){const candidates=[input.id,...input.aliases??[]];for(const candidate of candidates){const token=normalizeStatusToken(candidate);if(token.length===0){continue}const owner=resolvedAliasToId.get(token);if(owner!==void 0&&owner!==input.id){throw new Error(`Status token "${token}" already belongs to status "${owner}". Choose a different id/alias to avoid shadowing it.`)}}}export{BUILTIN_STATUS_IDS,assertStatusTokensAvailable,normalizeAddStatusInput,normalizeStatusToken2 as normalizeStatusToken,parseStatusDefsFile,removeStatusDef,serializeStatusDefsFile,upsertStatusDef};
227
3
  //# sourceMappingURL=status-defs-file.js.map
228
- //# debugId=ec456832-5120-5171-93fd-861ea4125acb
@@ -1,32 +1,2 @@
1
- /**
2
- * @module core/schema/status-token
3
- *
4
- * Owns the canonical bounded status-token normalization primitive used by
5
- * schema files, runtime registries, workflows, and package-facing SDK helpers.
6
- */
7
-
8
- !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="d6056922-237d-525a-b354-687493a4e123")}catch(e){}}();
9
- import { evictOldestMemoEntries } from "../shared/memo.js";
10
- const STATUS_TOKEN_MEMO_MAX_ENTRIES = 2_000;
11
- const statusTokenMemo = new Map();
12
- /** Lowercase a status token and collapse whitespace or hyphen runs to one underscore. */
13
- export function normalizeStatusToken(value) {
14
- if (typeof value !== "string") {
15
- return "";
16
- }
17
- const memoized = statusTokenMemo.get(value);
18
- if (memoized !== undefined) {
19
- return memoized;
20
- }
21
- const normalized = value
22
- .trim()
23
- .toLowerCase()
24
- .replaceAll(/[\s-]+/g, "_");
25
- if (statusTokenMemo.size >= STATUS_TOKEN_MEMO_MAX_ENTRIES) {
26
- evictOldestMemoEntries(statusTokenMemo);
27
- }
28
- statusTokenMemo.set(value, normalized);
29
- return normalized;
30
- }
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]="d66d32f8-a5f2-5068-bcd0-b93094d7c6a4")}catch(e2){}})();import{evictOldestMemoEntries}from"../shared/memo.js";const STATUS_TOKEN_MEMO_MAX_ENTRIES=2e3;const statusTokenMemo=new Map;function normalizeStatusToken(value){if(typeof value!=="string"){return""}const memoized=statusTokenMemo.get(value);if(memoized!==void 0){return memoized}const normalized=value.trim().toLowerCase().replaceAll(/[\s-]+/g,"_");if(statusTokenMemo.size>=STATUS_TOKEN_MEMO_MAX_ENTRIES){evictOldestMemoEntries(statusTokenMemo)}statusTokenMemo.set(value,normalized);return normalized}export{normalizeStatusToken};
31
2
  //# sourceMappingURL=status-token.js.map
32
- //# debugId=d6056922-237d-525a-b354-687493a4e123
@@ -1,96 +1,2 @@
1
- /**
2
- * @module core/schema/type-inference
3
- *
4
- * Resolves configurable schema, fields, statuses, and workflows for Type Inference.
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]="3d53ef97-6dd5-5dea-a5c2-9bc9e62d881c")}catch(e){}}();
8
- import { matchBuiltinTypeName } from "./item-types-file.js";
9
- /**
10
- * Pure logic for `pm schema add-type --infer`: scan existing item titles for
11
- * stable `PREFIX-`/`PREFIX:` conventions and propose them as custom item types.
12
- * The CLI command file (schema.ts) owns IO and the optional registration; this
13
- * module only derives candidates from a list of titles so it is fully testable
14
- * and coverage-gated to 100%.
15
- *
16
- * Conventions recognized (case-insensitive, first run wins per title):
17
- * - `INFRA- ...` / `SECURITY-...` (hyphen-delimited prefix)
18
- * - `BUG: ...` / `SPIKE: ...` (colon-delimited prefix)
19
- * The prefix token must be a letter-led identifier of letters, digits, and
20
- * internal hyphens/underscores so it maps cleanly to a single PascalCase type
21
- * name. Purely numeric or sequence-style prefixes (e.g. `S001-`, `E12-`) are
22
- * intentionally skipped: they index items, they are not type boundaries.
23
- */
24
- const PREFIX_PATTERN = /^([A-Za-z][A-Za-z0-9_-]*?)\s*[-:]\s+\S/;
25
- /** Extracts the leading prefix token from a title, or undefined when the title has no stable letter-led `PREFIX-`/`PREFIX:` convention. */
26
- export function extractTitlePrefix(title) {
27
- const match = PREFIX_PATTERN.exec(title.trim());
28
- if (!match) {
29
- return undefined;
30
- }
31
- const token = match[1];
32
- // Reject single-character prefixes (e.g. "S-", "E-"): they are sequence/index
33
- // markers far more often than genuine type boundaries.
34
- if (token.length < 2) {
35
- return undefined;
36
- }
37
- // Reject sequence/index-style prefixes — a single leading letter followed by
38
- // only digits (e.g. "S001-", "E12-", "V1-"). These index items rather than
39
- // mark a type boundary, matching the convention documented above.
40
- if (/^[A-Za-z]\d+$/.test(token)) {
41
- return undefined;
42
- }
43
- return token.toLowerCase();
44
- }
45
- /** Converts a normalized prefix token into a PascalCase type name. Internal hyphen/underscore runs become word boundaries; each word is capitalized. */
46
- export function prefixToTypeName(prefix) {
47
- return prefix
48
- .split(/[-_]+/)
49
- .filter((segment) => segment.length > 0)
50
- .map((segment) => `${segment.slice(0, 1).toUpperCase()}${segment.slice(1).toLowerCase()}`)
51
- .join("");
52
- }
53
- /** Scans titles for shared prefix conventions and returns candidate custom types, sorted by descending frequency then name. Only prefixes carried by at least `minCount` titles are returned. */
54
- export function inferTypesFromTitles(titles, options = {}) {
55
- const minCount = typeof options.minCount === "number" && options.minCount > 0
56
- ? Math.trunc(options.minCount)
57
- : 10;
58
- const maxExamples = typeof options.maxExamples === "number" && options.maxExamples > 0
59
- ? Math.trunc(options.maxExamples)
60
- : 3;
61
- const byPrefix = new Map();
62
- for (const rawTitle of titles) {
63
- const title = typeof rawTitle === "string" ? rawTitle.trim() : "";
64
- if (title.length === 0) {
65
- continue;
66
- }
67
- const prefix = extractTitlePrefix(title);
68
- if (prefix === undefined) {
69
- continue;
70
- }
71
- const bucket = byPrefix.get(prefix) ?? { count: 0, examples: [] };
72
- bucket.count += 1;
73
- if (bucket.examples.length < maxExamples) {
74
- bucket.examples.push(title);
75
- }
76
- byPrefix.set(prefix, bucket);
77
- }
78
- const candidates = [];
79
- for (const [prefix, bucket] of byPrefix.entries()) {
80
- if (bucket.count < minCount) {
81
- continue;
82
- }
83
- const name = prefixToTypeName(prefix);
84
- candidates.push({
85
- name,
86
- prefix,
87
- count: bucket.count,
88
- examples: bucket.examples,
89
- shadows_builtin: matchBuiltinTypeName(name) !== undefined,
90
- });
91
- }
92
- candidates.sort((left, right) => right.count - left.count || left.name.localeCompare(right.name));
93
- return candidates;
94
- }
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]="96cec314-edb6-5c51-abc4-d028bdc4f10c")}catch(e2){}})();import{matchBuiltinTypeName}from"./item-types-file.js";const PREFIX_PATTERN=/^([A-Za-z][A-Za-z0-9_-]*?)\s*[-:]\s+\S/;function extractTitlePrefix(title){const match=PREFIX_PATTERN.exec(title.trim());if(!match){return void 0}const token=match[1];if(token.length<2){return void 0}if(/^[A-Za-z]\d+$/.test(token)){return void 0}return token.toLowerCase()}function prefixToTypeName(prefix){return prefix.split(/[-_]+/).filter(segment=>segment.length>0).map(segment=>`${segment.slice(0,1).toUpperCase()}${segment.slice(1).toLowerCase()}`).join("")}function inferTypesFromTitles(titles,options={}){const minCount=typeof options.minCount==="number"&&options.minCount>0?Math.trunc(options.minCount):10;const maxExamples=typeof options.maxExamples==="number"&&options.maxExamples>0?Math.trunc(options.maxExamples):3;const byPrefix=new Map;for(const rawTitle of titles){const title=typeof rawTitle==="string"?rawTitle.trim():"";if(title.length===0){continue}const prefix=extractTitlePrefix(title);if(prefix===void 0){continue}const bucket=byPrefix.get(prefix)??{count:0,examples:[]};bucket.count+=1;if(bucket.examples.length<maxExamples){bucket.examples.push(title)}byPrefix.set(prefix,bucket)}const candidates=[];for(const[prefix,bucket]of byPrefix.entries()){if(bucket.count<minCount){continue}const name=prefixToTypeName(prefix);candidates.push({name,prefix,count:bucket.count,examples:bucket.examples,shadows_builtin:matchBuiltinTypeName(name)!==void 0})}candidates.sort((left,right)=>right.count-left.count||left.name.localeCompare(right.name));return candidates}export{extractTitlePrefix,inferTypesFromTitles,prefixToTypeName};
95
2
  //# sourceMappingURL=type-inference.js.map
96
- //# debugId=3d53ef97-6dd5-5dea-a5c2-9bc9e62d881c
@@ -1,88 +1,2 @@
1
- /**
2
- * @module core/schema/type-presets
3
- *
4
- * Resolves configurable schema, fields, statuses, and workflows for Type Presets.
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]="e3f016bb-8add-5765-bb1a-a7b22423f8d1")}catch(e){}}();
8
- import { normalizeAddTypeInput, } from "./item-types-file.js";
9
- /** Shared domain item-type presets. These power both `pm init --type-preset` (registered during initialization) and the standalone `pm schema apply-preset` subcommand (adopting a preset into an already-initialized project). Keeping the raw definitions and the preset-name normalizer in one place guarantees init and schema register byte-identical types. */
10
- export const TYPE_PRESET_NAMES = ["agile", "ops", "research"];
11
- /**
12
- * Raw (pre-normalization) preset definitions keyed by preset name. Each entry is
13
- * fed through {@link normalizeAddTypeInput} before being upserted so the same
14
- * validation/normalization the `pm schema add-type` CLI applies governs preset
15
- * registration too.
16
- */
17
- export const TYPE_PRESET_DEFINITIONS = {
18
- agile: [
19
- {
20
- name: "Story",
21
- description: "User-facing outcome or capability slice expressed from a stakeholder perspective.",
22
- defaultStatus: "open",
23
- folder: "stories",
24
- aliases: ["user-story"],
25
- },
26
- {
27
- name: "Spike",
28
- description: "Time-boxed investigation used to reduce uncertainty before implementation.",
29
- defaultStatus: "open",
30
- folder: "spikes",
31
- aliases: ["research-spike"],
32
- },
33
- ],
34
- ops: [
35
- {
36
- name: "Incident",
37
- description: "Operational disruption, degradation, or support escalation with recovery tracking.",
38
- defaultStatus: "open",
39
- folder: "incidents",
40
- aliases: ["outage"],
41
- },
42
- {
43
- name: "Runbook",
44
- description: "Repeatable operational procedure, diagnostic path, or response playbook.",
45
- defaultStatus: "open",
46
- folder: "runbooks",
47
- aliases: ["playbook"],
48
- },
49
- ],
50
- research: [
51
- {
52
- name: "Experiment",
53
- description: "Validated-learning activity with hypothesis, method, and outcome tracking.",
54
- defaultStatus: "open",
55
- folder: "experiments",
56
- aliases: ["study"],
57
- },
58
- {
59
- name: "Hypothesis",
60
- description: "Testable claim or assumption that should be supported, rejected, or refined.",
61
- defaultStatus: "open",
62
- folder: "hypotheses",
63
- aliases: ["assumption"],
64
- },
65
- ],
66
- };
67
- /** Validates and normalizes a raw preset-name CLI value. Returns `undefined` when the value is omitted (no preset requested). Throws a plain Error with a stable message for an empty or unknown preset; CLI layers map it to a USAGE exit code. Accepts hyphen/underscore-insensitive casing for ergonomics. */
68
- export function normalizeTypePresetName(rawValue) {
69
- if (rawValue === undefined) {
70
- return undefined;
71
- }
72
- const normalized = rawValue.trim().toLowerCase().replaceAll("-", "_");
73
- if (normalized.length === 0) {
74
- throw new Error("Type preset name must not be empty.");
75
- }
76
- if (normalized === "agile" ||
77
- normalized === "ops" ||
78
- normalized === "research") {
79
- return normalized;
80
- }
81
- throw new Error(`Invalid type preset "${rawValue}". Allowed: ${TYPE_PRESET_NAMES.join(", ")}.`);
82
- }
83
- /** Returns the normalized add-type inputs for a preset, in the order they should be upserted. Each raw definition is run through normalizeAddTypeInput so callers get the same validated shape as an individual `add-type` invocation. */
84
- export function resolveTypePresetDefinitions(preset) {
85
- return TYPE_PRESET_DEFINITIONS[preset].map((rawDefinition) => normalizeAddTypeInput(rawDefinition));
86
- }
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]="ebcb45a2-996a-5194-8086-efe882dbcacc")}catch(e2){}})();import{normalizeAddTypeInput}from"./item-types-file.js";const TYPE_PRESET_NAMES=["agile","ops","research"];const TYPE_PRESET_DEFINITIONS={agile:[{name:"Story",description:"User-facing outcome or capability slice expressed from a stakeholder perspective.",defaultStatus:"open",folder:"stories",aliases:["user-story"]},{name:"Spike",description:"Time-boxed investigation used to reduce uncertainty before implementation.",defaultStatus:"open",folder:"spikes",aliases:["research-spike"]}],ops:[{name:"Incident",description:"Operational disruption, degradation, or support escalation with recovery tracking.",defaultStatus:"open",folder:"incidents",aliases:["outage"]},{name:"Runbook",description:"Repeatable operational procedure, diagnostic path, or response playbook.",defaultStatus:"open",folder:"runbooks",aliases:["playbook"]}],research:[{name:"Experiment",description:"Validated-learning activity with hypothesis, method, and outcome tracking.",defaultStatus:"open",folder:"experiments",aliases:["study"]},{name:"Hypothesis",description:"Testable claim or assumption that should be supported, rejected, or refined.",defaultStatus:"open",folder:"hypotheses",aliases:["assumption"]}]};function normalizeTypePresetName(rawValue){if(rawValue===void 0){return void 0}const normalized=rawValue.trim().toLowerCase().replaceAll("-","_");if(normalized.length===0){throw new Error("Type preset name must not be empty.")}if(normalized==="agile"||normalized==="ops"||normalized==="research"){return normalized}throw new Error(`Invalid type preset "${rawValue}". Allowed: ${TYPE_PRESET_NAMES.join(", ")}.`)}function resolveTypePresetDefinitions(preset){return TYPE_PRESET_DEFINITIONS[preset].map(rawDefinition=>normalizeAddTypeInput(rawDefinition))}export{TYPE_PRESET_DEFINITIONS,TYPE_PRESET_NAMES,normalizeTypePresetName,resolveTypePresetDefinitions};
87
2
  //# sourceMappingURL=type-presets.js.map
88
- //# debugId=e3f016bb-8add-5765-bb1a-a7b22423f8d1
@@ -1,105 +1,2 @@
1
-
2
- !function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="c4e316a0-823d-5722-9e15-6d741ae44f1b")}catch(e){}}();
3
- import { normalizeStatusToken } from "./status-token.js";
4
- export { normalizeStatusToken } from "./status-token.js";
5
- function normalizeTypeName(value) {
6
- return typeof value === "string" ? value.trim().toLowerCase() : "";
7
- }
8
- function resolveStatusId(value, statusRegistry) {
9
- const token = normalizeStatusToken(value);
10
- if (token.length === 0) {
11
- return "";
12
- }
13
- return statusRegistry?.alias_to_id?.get(token) ?? token;
14
- }
15
- /**
16
- * Normalize the raw type_workflows from a runtime schema into a deduped,
17
- * lower-cased-type list with normalized status tokens.
18
- *
19
- * An entry is kept when it has a valid (non-empty) `type` AND its
20
- * `allowed_transitions` is an ARRAY — even when that array is empty. An explicit
21
- * empty array is a deliberate DENY-ALL rule (only same-status no-ops are
22
- * permitted, see evaluateTransition), so it must NOT collapse into "no rule"
23
- * (which would leave the type unrestricted). Entries with a missing/empty type
24
- * or a non-array `allowed_transitions` are dropped, as are malformed/short pairs.
25
- */
26
- export function resolveTypeWorkflows(schema) {
27
- const rawWorkflows = Array.isArray(schema?.type_workflows)
28
- ? schema.type_workflows
29
- : [];
30
- const byType = new Map();
31
- for (const entry of rawWorkflows) {
32
- const type = normalizeTypeName(entry?.type);
33
- if (type.length === 0) {
34
- continue;
35
- }
36
- if (!Array.isArray(entry?.allowed_transitions)) {
37
- continue;
38
- }
39
- const pairs = entry.allowed_transitions;
40
- const record = byType.get(type) ?? { pairs: [], denyAll: false };
41
- // Only an explicitly empty array is an intentional deny-all; a nonempty array
42
- // whose pairs are all malformed is a typo and must be dropped (not deny-all).
43
- if (pairs.length === 0) {
44
- record.denyAll = true;
45
- }
46
- for (const pair of pairs) {
47
- if (!Array.isArray(pair) || pair.length !== 2) {
48
- continue;
49
- }
50
- const from = normalizeStatusToken(pair[0]);
51
- const to = normalizeStatusToken(pair[1]);
52
- if (from.length === 0 || to.length === 0) {
53
- continue;
54
- }
55
- if (record.pairs.some((candidate) => candidate[0] === from && candidate[1] === to)) {
56
- continue;
57
- }
58
- record.pairs.push([from, to]);
59
- }
60
- byType.set(type, record);
61
- }
62
- return [...byType.entries()]
63
- .filter(([, record]) => record.pairs.length > 0 || record.denyAll)
64
- .map(([type, record]) => ({ type, allowed_transitions: record.pairs }))
65
- .sort((left, right) => left.type.localeCompare(right.type));
66
- }
67
- /** Evaluate whether a status transition is allowed for the given item type. Returns hasRule=false (allowed) when the type is unrestricted. */
68
- export function evaluateTransition(input) {
69
- const typeName = normalizeTypeName(input.typeName);
70
- const matched = input.typeWorkflows.find((workflow) => workflow.type === typeName);
71
- if (!matched) {
72
- return { allowed: true, hasRule: false, allowedTransitions: [] };
73
- }
74
- const from = resolveStatusId(input.fromStatus, input.statusRegistry);
75
- const to = resolveStatusId(input.toStatus, input.statusRegistry);
76
- // A no-op self-transition is always permitted, even under a restricting rule.
77
- if (from.length > 0 && from === to) {
78
- return {
79
- allowed: true,
80
- hasRule: true,
81
- allowedTransitions: matched.allowed_transitions,
82
- };
83
- }
84
- const allowed = matched.allowed_transitions.some((pair) => {
85
- const ruleFrom = resolveStatusId(pair[0], input.statusRegistry);
86
- const ruleTo = resolveStatusId(pair[1], input.statusRegistry);
87
- return ruleFrom === from && ruleTo === to;
88
- });
89
- return {
90
- allowed,
91
- hasRule: true,
92
- allowedTransitions: matched.allowed_transitions,
93
- };
94
- }
95
- /** Render the allowed transitions for an error/warning hint. */
96
- export function describeAllowedTransitions(allowedTransitions) {
97
- if (allowedTransitions.length === 0) {
98
- return "(no transitions allowed)";
99
- }
100
- return allowedTransitions
101
- .map((pair) => `${pair[0]} -> ${pair[1]}`)
102
- .join(", ");
103
- }
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]="8c5aba7a-21a0-5d99-943a-877085caca57")}catch(e2){}})();import{normalizeStatusToken}from"./status-token.js";import{normalizeStatusToken as normalizeStatusToken2}from"./status-token.js";function normalizeTypeName(value){return typeof value==="string"?value.trim().toLowerCase():""}function resolveStatusId(value,statusRegistry){const token=normalizeStatusToken(value);if(token.length===0){return""}return statusRegistry?.alias_to_id?.get(token)??token}function resolveTypeWorkflows(schema){const rawWorkflows=Array.isArray(schema?.type_workflows)?schema.type_workflows:[];const byType=new Map;for(const entry of rawWorkflows){const type=normalizeTypeName(entry?.type);if(type.length===0){continue}if(!Array.isArray(entry?.allowed_transitions)){continue}const pairs=entry.allowed_transitions;const record=byType.get(type)??{pairs:[],denyAll:false};if(pairs.length===0){record.denyAll=true}for(const pair of pairs){if(!Array.isArray(pair)||pair.length!==2){continue}const from=normalizeStatusToken(pair[0]);const to=normalizeStatusToken(pair[1]);if(from.length===0||to.length===0){continue}if(record.pairs.some(candidate=>candidate[0]===from&&candidate[1]===to)){continue}record.pairs.push([from,to])}byType.set(type,record)}return[...byType.entries()].filter(([,record])=>record.pairs.length>0||record.denyAll).map(([type,record])=>({type,allowed_transitions:record.pairs})).sort((left,right)=>left.type.localeCompare(right.type))}function evaluateTransition(input){const typeName=normalizeTypeName(input.typeName);const matched=input.typeWorkflows.find(workflow=>workflow.type===typeName);if(!matched){return{allowed:true,hasRule:false,allowedTransitions:[]}}const from=resolveStatusId(input.fromStatus,input.statusRegistry);const to=resolveStatusId(input.toStatus,input.statusRegistry);if(from.length>0&&from===to){return{allowed:true,hasRule:true,allowedTransitions:matched.allowed_transitions}}const allowed=matched.allowed_transitions.some(pair=>{const ruleFrom=resolveStatusId(pair[0],input.statusRegistry);const ruleTo=resolveStatusId(pair[1],input.statusRegistry);return ruleFrom===from&&ruleTo===to});return{allowed,hasRule:true,allowedTransitions:matched.allowed_transitions}}function describeAllowedTransitions(allowedTransitions){if(allowedTransitions.length===0){return"(no transitions allowed)"}return allowedTransitions.map(pair=>`${pair[0]} -> ${pair[1]}`).join(", ")}export{describeAllowedTransitions,evaluateTransition,normalizeStatusToken2 as normalizeStatusToken,resolveTypeWorkflows};
104
2
  //# sourceMappingURL=type-workflows.js.map
105
- //# debugId=c4e316a0-823d-5722-9e15-6d741ae44f1b