@unbrained/pm-cli 2026.9.4 → 2026.9.6

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 (277) hide show
  1. package/.agents/skills/HARNESS_COMPATIBILITY.md +1 -1
  2. package/.agents/skills/README.md +2 -2
  3. package/.agents/skills/pm-developer/SKILL.md +4 -1
  4. package/.agents/skills/pm-developer/references/COMMAND_PLAYBOOK.md +10 -0
  5. package/.agents/skills/pm-developer/references/GRAPH_AND_RELATIONSHIPS.md +3 -1
  6. package/.agents/skills/pm-extensions/SKILL.md +2 -2
  7. package/.agents/skills/pm-extensions/references/LIFECYCLE.md +3 -3
  8. package/.agents/skills/pm-extensions/references/TROUBLESHOOTING.md +3 -3
  9. package/.agents/skills/pm-user/SKILL.md +2 -0
  10. package/.agents/skills/pm-user/references/BACKLOG_SHAPING.md +5 -0
  11. package/.agents/skills/pm-user/references/WORKFLOWS.md +20 -5
  12. package/.claude-plugin/marketplace.json +2 -2
  13. package/CHANGELOG.md +58 -3
  14. package/dist/cli/commander-usage.d.ts +2 -0
  15. package/dist/cli/commander-usage.js +15 -12
  16. package/dist/cli/help-json-payload.js +12 -7
  17. package/dist/cli/main.js +22 -11
  18. package/dist/cli/register-list-query.js +4 -2
  19. package/dist/cli/register-mutation.js +4 -2
  20. package/dist/cli/register-operations.js +17 -8
  21. package/dist/cli-bundle/bundle-manifest.json +153 -161
  22. package/dist/cli-bundle/chunks/chunk-AZDFJGH6.js +9 -0
  23. package/dist/cli-bundle/chunks/{chunk-V72UV7QS.js → chunk-BAX2BYUW.js} +73 -73
  24. package/dist/cli-bundle/chunks/{chunk-HI6BHPCU.js → chunk-CKOL5U7J.js} +51 -51
  25. package/dist/cli-bundle/chunks/{chunk-A24WAVE6.js → chunk-JT6XF6GE.js} +2 -2
  26. package/dist/cli-bundle/chunks/{chunk-I2AS367G.js → chunk-JX4DH4WC.js} +2 -2
  27. package/dist/cli-bundle/chunks/{chunk-YW4QK2G7.js → chunk-NPN5I67J.js} +2 -2
  28. package/dist/cli-bundle/chunks/chunk-OF76PSDQ.js +5 -0
  29. package/dist/cli-bundle/chunks/chunk-QUWFABDM.js +232 -0
  30. package/dist/cli-bundle/chunks/{chunk-RI4XNOYS.js → chunk-RWWBOWJ5.js} +2 -2
  31. package/dist/cli-bundle/chunks/chunk-WGAOYSYH.js +40 -0
  32. package/dist/cli-bundle/chunks/{chunk-X6CMGV6L.js → chunk-WI2AYPA7.js} +2 -2
  33. package/dist/cli-bundle/chunks/{register-list-query-Z5YYSJJG.js → register-list-query-5JL52D33.js} +3 -3
  34. package/dist/cli-bundle/chunks/{register-mutation-ELSP6I4I.js → register-mutation-ZPG7KMVP.js} +4 -4
  35. package/dist/cli-bundle/chunks/register-operations-I5W3KMGB.js +2 -0
  36. package/dist/cli-bundle/chunks/{register-setup-E2AE72QG.js → register-setup-H4SVAVX7.js} +2 -2
  37. package/dist/cli-bundle/focused-chunks/{chunk-3646BZ4W.js → chunk-3BZEOXLT.js} +2 -2
  38. package/dist/cli-bundle/focused-chunks/chunk-AL5ON6K6.js +2 -0
  39. package/dist/cli-bundle/focused-chunks/chunk-CHC2IDXA.js +6 -0
  40. package/dist/cli-bundle/focused-chunks/chunk-CK6QFAPZ.js +20 -0
  41. package/dist/cli-bundle/focused-chunks/{chunk-NBMJD6MK.js → chunk-EZR3GHFE.js} +2 -2
  42. package/dist/cli-bundle/focused-chunks/chunk-H2WJWK7L.js +56 -0
  43. package/dist/cli-bundle/focused-chunks/{chunk-53IHPICX.js → chunk-LIJIA4TY.js} +2 -2
  44. package/dist/cli-bundle/focused-chunks/{chunk-25UJBH4M.js → chunk-M6PBRFSH.js} +2 -2
  45. package/dist/cli-bundle/focused-chunks/{chunk-AJR3OP2E.js → chunk-NTPY5GSO.js} +2 -2
  46. package/dist/cli-bundle/focused-chunks/chunk-P5O7MP5Y.js +2 -0
  47. package/dist/cli-bundle/focused-chunks/chunk-PDMW2E36.js +177 -0
  48. package/dist/cli-bundle/focused-chunks/{chunk-MHKUIPJW.js → chunk-PEFABF7E.js} +2 -2
  49. package/dist/cli-bundle/focused-chunks/{chunk-6PWPQKDN.js → chunk-QTVCLMSZ.js} +2 -2
  50. package/dist/cli-bundle/focused-chunks/{chunk-7N2TV7WZ.js → chunk-QTZRBUYA.js} +2 -2
  51. package/dist/cli-bundle/focused-chunks/chunk-SGQST3PQ.js +12 -0
  52. package/dist/cli-bundle/focused-chunks/chunk-UKHASMMP.js +10 -0
  53. package/dist/cli-bundle/focused-chunks/chunk-ZPEKQHOC.js +2 -0
  54. package/dist/cli-bundle/main.js +22 -15
  55. package/dist/cli-bundle/sdk-authoring.js +1 -1
  56. package/dist/cli-bundle/sdk-contracts.js +2 -2
  57. package/dist/cli-bundle/sdk-core.js +37 -37
  58. package/dist/cli-bundle/sdk-governance.js +1 -1
  59. package/dist/cli-bundle/sdk-graph.js +1 -1
  60. package/dist/cli-bundle/sdk-merge.js +42 -39
  61. package/dist/cli-bundle/sdk-query.js +1 -1
  62. package/dist/cli-bundle/sdk-runtime.js +1 -1
  63. package/dist/cli-bundle/sdk-testing.js +1 -1
  64. package/dist/cli-bundle/sdk.js +9 -9
  65. package/dist/core/extensions/extension-types.d.ts +2 -0
  66. package/dist/core/extensions/extension-types.js +2 -2
  67. package/dist/core/extensions/module-graph-snapshot.js +5 -4
  68. package/dist/core/fs/host-environment-errors.d.ts +27 -0
  69. package/dist/core/fs/host-environment-errors.js +142 -0
  70. package/dist/core/history/drift-scan.d.ts +5 -0
  71. package/dist/core/history/drift-scan.js +16 -6
  72. package/dist/core/history/event-classification.d.ts +1 -1
  73. package/dist/core/history/event-classification.js +3 -2
  74. package/dist/core/history/history.js +37 -5
  75. package/dist/core/history/identity.d.ts +15 -0
  76. package/dist/core/history/identity.js +31 -0
  77. package/dist/core/history/projection.js +50 -17
  78. package/dist/core/history/read.js +6 -3
  79. package/dist/core/history/replay.d.ts +1 -2
  80. package/dist/core/history/replay.js +4 -4
  81. package/dist/core/history/version-address.d.ts +13 -0
  82. package/dist/core/history/version-address.js +33 -0
  83. package/dist/core/item/actionability.d.ts +21 -1
  84. package/dist/core/item/actionability.js +45 -10
  85. package/dist/core/item/id.js +8 -4
  86. package/dist/core/item/item-type-definition.d.ts +2 -0
  87. package/dist/core/item/item-type-definition.js +9 -2
  88. package/dist/core/item/type-registry.d.ts +5 -1
  89. package/dist/core/item/type-registry.js +9 -4
  90. package/dist/core/output/mutation-projection.js +12 -5
  91. package/dist/core/shared/errors.d.ts +8 -0
  92. package/dist/core/shared/errors.js +2 -2
  93. package/dist/core/store/item-metadata-query-index.js +13 -10
  94. package/dist/core/store/item-metadata-read-work.d.ts +19 -0
  95. package/dist/core/store/item-metadata-read-work.js +44 -0
  96. package/dist/core/store/item-store.d.ts +14 -0
  97. package/dist/core/store/item-store.js +52 -10
  98. package/dist/core/store/settings-validator.js +3 -2
  99. package/dist/core/validate/fix-planning.d.ts +1 -1
  100. package/dist/core/validate/fix-planning.js +2 -2
  101. package/dist/core/validate/missing-link-owners.d.ts +1 -1
  102. package/dist/core/validate/missing-link-owners.js +5 -3
  103. package/dist/core/validate/stale-file-classification.d.ts +6 -4
  104. package/dist/core/validate/stale-file-classification.js +20 -5
  105. package/dist/mcp/server.js +12 -5
  106. package/dist/sdk/actionability.d.ts +1 -1
  107. package/dist/sdk/actionability.js +3 -3
  108. package/dist/sdk/cli-contracts/command-aliases.js +11 -2
  109. package/dist/sdk/cli-contracts/completeness.js +4 -3
  110. package/dist/sdk/cli-contracts/flag-contracts.d.ts +2 -0
  111. package/dist/sdk/cli-contracts/flag-contracts.js +31 -5
  112. package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +21 -13
  113. package/dist/sdk/cli-contracts/grammar-contracts.js +11 -2
  114. package/dist/sdk/cli-contracts/runtime-contracts.js +5 -2
  115. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +254 -5
  116. package/dist/sdk/cli-contracts/schemas/assurance-definition.js +52 -2
  117. package/dist/sdk/cli-contracts/tool-parameter-tables.js +30 -6
  118. package/dist/sdk/cli-contracts/tool-schema.d.ts +2 -2
  119. package/dist/sdk/cli-contracts/tool-schema.js +32 -7
  120. package/dist/sdk/context/usage-ledger.d.ts +41 -0
  121. package/dist/sdk/context/usage-ledger.js +186 -0
  122. package/dist/sdk/context-intent-contracts.js +3 -3
  123. package/dist/sdk/context-usage.d.ts +18 -9
  124. package/dist/sdk/context-usage.js +44 -121
  125. package/dist/sdk/define.d.ts +1 -1
  126. package/dist/sdk/define.js +2 -2
  127. package/dist/sdk/dependency-provenance.d.ts +7 -0
  128. package/dist/sdk/dependency-provenance.js +14 -4
  129. package/dist/sdk/duplicates.d.ts +2 -0
  130. package/dist/sdk/duplicates.js +3 -2
  131. package/dist/sdk/environment/host-environment-errors.d.ts +5 -27
  132. package/dist/sdk/environment/host-environment-errors.js +4 -137
  133. package/dist/sdk/extension/install-runtime.js +9 -6
  134. package/dist/sdk/extension/install-snapshot.js +7 -6
  135. package/dist/sdk/generated/generated-error-code-catalog-part-1.js +104 -56
  136. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +50 -2
  137. package/dist/sdk/governance/assurance-action.d.ts +3 -2
  138. package/dist/sdk/governance/assurance-action.js +23 -11
  139. package/dist/sdk/governance/assurance-runtime.d.ts +2 -0
  140. package/dist/sdk/governance/assurance-runtime.js +6 -3
  141. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +93 -0
  142. package/dist/sdk/governance/defect-recurrence-coverage.js +189 -0
  143. package/dist/sdk/governance/defect-recurrence-graph.d.ts +33 -0
  144. package/dist/sdk/governance/defect-recurrence-graph.js +121 -0
  145. package/dist/sdk/governance/defect-recurrence.d.ts +8 -0
  146. package/dist/sdk/governance/defect-recurrence.js +118 -17
  147. package/dist/sdk/governance/health.d.ts +17 -2
  148. package/dist/sdk/governance/health.js +31 -10
  149. package/dist/sdk/governance/linked-file-report.d.ts +41 -0
  150. package/dist/sdk/governance/linked-file-report.js +72 -0
  151. package/dist/sdk/governance/validate-history-drift.js +16 -5
  152. package/dist/sdk/governance/validate.d.ts +5 -2
  153. package/dist/sdk/governance/validate.js +21 -37
  154. package/dist/sdk/governance.d.ts +2 -0
  155. package/dist/sdk/governance.js +4 -2
  156. package/dist/sdk/guide-topics.js +116 -2
  157. package/dist/sdk/history/salvage.d.ts +35 -0
  158. package/dist/sdk/history/salvage.js +248 -0
  159. package/dist/sdk/history-compact.js +32 -37
  160. package/dist/sdk/history-read.d.ts +3 -2
  161. package/dist/sdk/history-read.js +6 -3
  162. package/dist/sdk/history-repair.d.ts +12 -0
  163. package/dist/sdk/history-repair.js +60 -13
  164. package/dist/sdk/lifecycle/claim.d.ts +4 -0
  165. package/dist/sdk/lifecycle/claim.js +9 -3
  166. package/dist/sdk/lifecycle/close.d.ts +8 -0
  167. package/dist/sdk/lifecycle/close.js +16 -8
  168. package/dist/sdk/lifecycle/create.js +9 -12
  169. package/dist/sdk/lifecycle/restore.d.ts +1 -0
  170. package/dist/sdk/lifecycle/restore.js +19 -7
  171. package/dist/sdk/lifecycle/update.js +12 -12
  172. package/dist/sdk/lifecycle-policy.d.ts +3 -0
  173. package/dist/sdk/lifecycle-policy.js +2 -2
  174. package/dist/sdk/merge/abandoned-receipts.d.ts +15 -0
  175. package/dist/sdk/merge/abandoned-receipts.js +47 -0
  176. package/dist/sdk/merge/driver.js +4 -2
  177. package/dist/sdk/merge/index.d.ts +1 -0
  178. package/dist/sdk/merge/index.js +2 -2
  179. package/dist/sdk/merge/receipt-operation.d.ts +15 -0
  180. package/dist/sdk/merge/receipt-operation.js +97 -0
  181. package/dist/sdk/merge/receipt-schema.d.ts +20 -0
  182. package/dist/sdk/merge/receipt-schema.js +398 -0
  183. package/dist/sdk/merge/receipts.d.ts +16 -7
  184. package/dist/sdk/merge/receipts.js +54 -340
  185. package/dist/sdk/merge/reconcile.d.ts +2 -0
  186. package/dist/sdk/merge/reconcile.js +11 -4
  187. package/dist/sdk/output-projection.d.ts +3 -1
  188. package/dist/sdk/output-projection.js +11 -3
  189. package/dist/sdk/public-surface.json +1 -0
  190. package/dist/sdk/query/context.d.ts +9 -0
  191. package/dist/sdk/query/context.js +33 -21
  192. package/dist/sdk/query/duplicate-candidates.d.ts +7 -0
  193. package/dist/sdk/query/duplicate-candidates.js +71 -0
  194. package/dist/sdk/query/get.d.ts +2 -2
  195. package/dist/sdk/query/get.js +9 -8
  196. package/dist/sdk/query/history.d.ts +11 -0
  197. package/dist/sdk/query/history.js +34 -10
  198. package/dist/sdk/query/next.d.ts +15 -1
  199. package/dist/sdk/query/next.js +43 -20
  200. package/dist/sdk/query.d.ts +3 -0
  201. package/dist/sdk/query.js +5 -2
  202. package/dist/sdk/read-output-session.js +5 -3
  203. package/dist/sdk/runtime-primitives.d.ts +1 -1
  204. package/dist/sdk/runtime-primitives.js +3 -3
  205. package/dist/sdk/runtime.js +4 -2
  206. package/dist/sdk/similarity.d.ts +24 -3
  207. package/dist/sdk/similarity.js +50 -55
  208. package/dist/types.d.ts +2 -0
  209. package/dist/types.js +2 -2
  210. package/docs/AGENT_GUIDE.md +58 -1
  211. package/docs/BOUNDED_CONTEXT_READS.md +185 -0
  212. package/docs/CLOSE_EVIDENCE_RECOVERY.md +35 -0
  213. package/docs/COMMANDS.md +30 -8
  214. package/docs/CONTEXT_RELEVANCE.md +16 -4
  215. package/docs/DEFECT_RECURRENCE.md +80 -6
  216. package/docs/EXTENSIONS.md +18 -19
  217. package/docs/HISTORY_RECOVERY.md +146 -0
  218. package/docs/MERGE_SAFETY.md +50 -0
  219. package/docs/OUTPUT_PROJECTION_CONTRACTS.md +66 -0
  220. package/docs/PR_REVIEW_LOOP.md +18 -3
  221. package/docs/README.md +19 -1
  222. package/docs/RELEASING.md +31 -13
  223. package/docs/SDK_CONTEXT_TRUTH_CONTRACTS.md +24 -1
  224. package/docs/SDK_EXECUTION_CONTRACTS.md +105 -0
  225. package/docs/SDK_LIFECYCLE.md +27 -0
  226. package/docs/SDK_RUNTIME_BOUNDARIES.md +11 -0
  227. package/docs/TESTING.md +5 -0
  228. package/docs/agent-task-token-baseline.json +17 -17
  229. package/docs/agent-task-transcripts.json +2 -1
  230. package/docs/generated/FLAG_LEXICON_BUDGETS.md +11 -11
  231. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +11 -3
  232. package/marketplace.json +2 -2
  233. package/package.json +8 -6
  234. package/packages/pm-beads/package.json +1 -1
  235. package/packages/pm-calendar/package.json +1 -1
  236. package/packages/pm-command-kit/package.json +1 -1
  237. package/packages/pm-digital-twin/package.json +1 -1
  238. package/packages/pm-governance-audit/README.md +10 -1
  239. package/packages/pm-governance-audit/extensions/governance-audit/dedupe-audit.ts +50 -65
  240. package/packages/pm-governance-audit/extensions/governance-audit/index.ts +2 -2
  241. package/packages/pm-governance-audit/extensions/governance-audit/sdk.ts +1 -0
  242. package/packages/pm-governance-audit/package.json +1 -1
  243. package/packages/pm-guide-shell/package.json +1 -1
  244. package/packages/pm-kanban/package.json +1 -1
  245. package/packages/pm-lifecycle-hooks/package.json +1 -1
  246. package/packages/pm-linked-test-adapters/package.json +1 -1
  247. package/packages/pm-search-advanced/package.json +1 -1
  248. package/packages/pm-templates/package.json +1 -1
  249. package/packages/pm-todos/package.json +1 -1
  250. package/packages/pm-vcs/package.json +1 -1
  251. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  252. package/plugins/pm-claude/skills/pm-audit/SKILL.md +2 -2
  253. package/plugins/pm-claude/skills/pm-developer/SKILL.md +2 -2
  254. package/plugins/pm-claude/skills/pm-planner/SKILL.md +2 -2
  255. package/plugins/pm-claude/skills/pm-release/SKILL.md +2 -2
  256. package/plugins/pm-claude/skills/pm-workflow/SKILL.md +3 -3
  257. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  258. package/plugins/pm-codex/skills/pm-auditor/SKILL.md +2 -2
  259. package/plugins/pm-codex/skills/pm-native/SKILL.md +3 -4
  260. package/plugins/pm-codex/skills/pm-release/SKILL.md +2 -2
  261. package/scripts/finalize-build.mjs +13 -1
  262. package/dist/cli-bundle/chunks/chunk-6XSKPNCF.js +0 -230
  263. package/dist/cli-bundle/chunks/chunk-OGBVU67G.js +0 -5
  264. package/dist/cli-bundle/chunks/chunk-TXW6VL33.js +0 -38
  265. package/dist/cli-bundle/chunks/chunk-VGLHECAP.js +0 -9
  266. package/dist/cli-bundle/chunks/register-operations-OH7R3ZT4.js +0 -2
  267. package/dist/cli-bundle/focused-chunks/chunk-4YRAVI43.js +0 -12
  268. package/dist/cli-bundle/focused-chunks/chunk-5P4HVOWG.js +0 -176
  269. package/dist/cli-bundle/focused-chunks/chunk-636VVQ7F.js +0 -54
  270. package/dist/cli-bundle/focused-chunks/chunk-B3A6MJYE.js +0 -2
  271. package/dist/cli-bundle/focused-chunks/chunk-BFDDJ2T2.js +0 -2
  272. package/dist/cli-bundle/focused-chunks/chunk-BHUIRZWQ.js +0 -9
  273. package/dist/cli-bundle/focused-chunks/chunk-JADHHPY6.js +0 -6
  274. package/dist/cli-bundle/focused-chunks/chunk-NSKBLHVI.js +0 -20
  275. package/dist/cli-bundle/focused-chunks/chunk-P2GOAOQN.js +0 -2
  276. package/dist/cli-bundle/focused-chunks/chunk-YARWJM2B.js +0 -2
  277. package/sdk/public-surface.json +0 -33034
@@ -5,7 +5,7 @@
5
5
  * per-command growth budgets.
6
6
  */
7
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]="3466866d-8869-5ab6-b981-d084e7330aa5")}catch(e){}}();
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]="3fdfd4c8-a7ef-5469-acf5-bc2577fd141a")}catch(e){}}();
9
9
  import { hasSubcommandFlagContractsForCommand, resolveSubcommandFlagContractsForCommand, } from "./flag-contracts.js";
10
10
  import { PM_COMMAND_CAPABILITY_CONTRACTS, } from "../agent-capability-contracts.js";
11
11
  import { enrichCliFlagInvocationContracts } from "../flag-invocation-contracts.js";
@@ -101,9 +101,12 @@ export function listPmFlagSpellingInventory() {
101
101
  accepted_spellings: Object.freeze([...new Set([entry.flag, ...entry.aliases])].sort()),
102
102
  })));
103
103
  }
104
+ // pm-2bqgs7: reconcile already executable options omitted by the previous
105
+ // declared-only census. pm-08mt4k adds two explicit scheduling opt-ins to next
106
+ // and claim; aliases remain free and every future increase still fails closed.
104
107
  const PM_COMMAND_FLAG_BUDGET_MAXIMUMS = Object.freeze({
105
108
  init: 30,
106
- config: 35,
109
+ config: 36,
107
110
  extension: 53,
108
111
  package: 54,
109
112
  packages: 54,
@@ -113,7 +116,7 @@ const PM_COMMAND_FLAG_BUDGET_MAXIMUMS = Object.freeze({
113
116
  copy: 24,
114
117
  focus: 22,
115
118
  list: 86,
116
- "list-all": 85,
119
+ "list-all": 86,
117
120
  "list-draft": 84,
118
121
  "list-open": 84,
119
122
  "list-in-progress": 84,
@@ -126,34 +129,39 @@ const PM_COMMAND_FLAG_BUDGET_MAXIMUMS = Object.freeze({
126
129
  get: 30,
127
130
  graph: 34,
128
131
  search: 78,
129
- duplicates: 24,
132
+ // pm-pshhry: one explicit exhaustive-reference mode, with no spare flag allowance.
133
+ duplicates: 25,
130
134
  eval: 25,
131
- next: 35,
135
+ next: 38,
132
136
  history: 35,
133
137
  events: 33,
134
138
  "history-redact": 27,
135
- "history-repair": 26,
139
+ // One explicit destructive-recovery mode; never overload ordinary reanchoring.
140
+ "history-repair": 27,
136
141
  "history-compact": 30,
137
142
  "history-author-acknowledge": 28,
138
- merge: 24,
143
+ // 24 -> 27 on 2026-09-04: --message, --force, and --include-reconciled were
144
+ // already registered at runtime for reconcile and report; declaring them
145
+ // makes the contract truthful rather than growing the surface.
146
+ merge: 27,
139
147
  schema: 40,
140
148
  profile: 22,
141
149
  activity: 35,
142
150
  restore: 23,
143
151
  update: 105,
144
- "update-many": 140,
152
+ "update-many": 146,
145
153
  close: 31,
146
154
  "close-many": 72,
147
155
  delete: 24,
148
- append: 24,
156
+ append: 25,
149
157
  comments: 31,
150
158
  notes: 35,
151
- learnings: 27,
159
+ learnings: 31,
152
160
  files: 39,
153
161
  docs: 30,
154
162
  deps: 32,
155
163
  plan: 109,
156
- test: 52,
164
+ test: 53,
157
165
  "test-all": 40,
158
166
  telemetry: 21,
159
167
  stats: 29,
@@ -163,7 +171,7 @@ const PM_COMMAND_FLAG_BUDGET_MAXIMUMS = Object.freeze({
163
171
  gc: 22,
164
172
  workspace: 23,
165
173
  contracts: 29,
166
- claim: 36,
174
+ claim: 38,
167
175
  release: 23,
168
176
  "start-task": 23,
169
177
  "pause-task": 23,
@@ -337,4 +345,4 @@ export function renderPmFlagLexiconMarkdown() {
337
345
  ].join("\n");
338
346
  }
339
347
  //# sourceMappingURL=flag-lexicon-contracts.js.map
340
- //# debugId=3466866d-8869-5ab6-b981-d084e7330aa5
348
+ //# debugId=3fdfd4c8-a7ef-5469-acf5-bc2577fd141a
@@ -7,7 +7,7 @@
7
7
  * cannot silently bypass the architecture decision.
8
8
  */
9
9
 
10
- !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]="4efc5934-7d1b-517b-8b5e-eb2fe14379f2")}catch(e){}}();
10
+ !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]="986f1257-822a-5b27-b2e5-a1daae96be71")}catch(e){}}();
11
11
  import { resolvePmCommandAlias, } from "./command-aliases.js";
12
12
  /** Canonical top-level domains an agent must retain to route pm operations. */
13
13
  export const PM_CLI_GRAMMAR_NOUNS = [
@@ -314,6 +314,15 @@ export const PM_POSITIONAL_ACTION_CONTRACTS = [
314
314
  description: "Analyze bounded defect-recurrence risk for a proposed change.",
315
315
  example: 'pm assurance risk --definition \'{"change":{"files":[]}}\'',
316
316
  },
317
+ {
318
+ command: "assurance lineages",
319
+ parent: "assurance",
320
+ action: "lineages",
321
+ slots: [],
322
+ accepted_flags: ["--definition"],
323
+ description: "Measure all recorded recurrence lineages with bounded evidence rows.",
324
+ example: 'pm assurance lineages --definition \'{"policy":{"version":1,"evidence_epoch":"2026-01-01T00:00:00.000Z","families":[]}}\'',
325
+ },
317
326
  {
318
327
  command: "workspace position",
319
328
  parent: "workspace",
@@ -975,4 +984,4 @@ export function verifyPmCliGrammar(commands, aliases = [], destinations = PM_COM
975
984
  };
976
985
  }
977
986
  //# sourceMappingURL=grammar-contracts.js.map
978
- //# debugId=4efc5934-7d1b-517b-8b5e-eb2fe14379f2
987
+ //# debugId=986f1257-822a-5b27-b2e5-a1daae96be71
@@ -4,7 +4,7 @@
4
4
  * Implements the pm contracts command surface and its agent-facing runtime behavior.
5
5
  */
6
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]="1506e8bc-3350-5ef5-a40a-44509eb59317")}catch(e){}}();
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]="188569e7-c809-5f28-a714-d531f57be1d9")}catch(e){}}();
8
8
  import { EXIT_CODE, SETTINGS_DEFAULTS, PmCliError, activateExtensions, getActiveExtensionRegistrations, loadExtensions, pathExists, commandOptionFlagLabel, resolveCommandOptionPolicyState, resolveItemTypeRegistry, resolveRuntimeFieldRegistry, resolveRuntimeStatusRegistry, getSettingsPath, resolvePmRoot, readSettings, } from "../runtime-primitives.js";
9
9
  import { buildMcpToolContracts, } from "../../mcp/tool-definitions.js";
10
10
  import { ACTIVITY_COMMANDER_STRING_OPTION_CONTRACTS, ACTIVITY_FLAG_CONTRACTS, AGGREGATE_FLAG_CONTRACTS, ASSURANCE_FLAG_CONTRACTS, APPEND_FLAG_CONTRACTS, CALENDAR_COMMANDER_STRING_OPTION_CONTRACTS, CALENDAR_FLAG_CONTRACTS, CLAIM_FLAG_CONTRACTS, CLOSE_TASK_FLAG_CONTRACTS, COMMENTS_FLAG_CONTRACTS, CLOSE_FLAG_CONTRACTS, CLOSE_MANY_FLAG_CONTRACTS, COMPLETION_FLAG_CONTRACTS, CONFIG_FLAG_CONTRACTS, CONTRACTS_FLAG_CONTRACTS, COPY_FLAG_CONTRACTS, CONTEXT_COMMANDER_STRING_OPTION_CONTRACTS, CONTEXT_FLAG_CONTRACTS, CREATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, CREATE_COMMANDER_STRING_OPTION_CONTRACTS, CREATE_FLAG_CONTRACTS, DELETE_FLAG_CONTRACTS, DEPS_FLAG_CONTRACTS, GRAPH_FLAG_CONTRACTS, DOCS_FLAG_CONTRACTS, EXTENSION_ACTIVATE_FLAG_CONTRACTS, EXTENSION_ADOPT_ALL_FLAG_CONTRACTS, EXTENSION_ADOPT_FLAG_CONTRACTS, EXTENSION_CATALOG_FLAG_CONTRACTS, EXTENSION_DEACTIVATE_FLAG_CONTRACTS, EXTENSION_DESCRIBE_FLAG_CONTRACTS, EXTENSION_DOCTOR_FLAG_CONTRACTS, EXTENSION_EXPLORE_FLAG_CONTRACTS, EXTENSION_FLAG_CONTRACTS, EXTENSION_INIT_FLAG_CONTRACTS, EXTENSION_INSTALL_FLAG_CONTRACTS, EXTENSION_MANAGE_FLAG_CONTRACTS, EXTENSION_MIGRATE_FLAG_CONTRACTS, EXTENSION_RELOAD_FLAG_CONTRACTS, EXTENSION_UNINSTALL_FLAG_CONTRACTS, FILES_FLAG_CONTRACTS, FOCUS_FLAG_CONTRACTS, GC_FLAG_CONTRACTS, GET_FLAG_CONTRACTS, GUIDE_FLAG_CONTRACTS, GLOBAL_FLAG_CONTRACTS, HEALTH_FLAG_CONTRACTS, HISTORY_FLAG_CONTRACTS, HISTORY_COMPACT_FLAG_CONTRACTS, HISTORY_REDACT_FLAG_CONTRACTS, HISTORY_REPAIR_FLAG_CONTRACTS, HISTORY_AUTHOR_ACKNOWLEDGE_FLAG_CONTRACTS, INSTALL_FLAG_CONTRACTS, INIT_FLAG_CONTRACTS, ITEM_COMPLETE_FLAG_CONTRACTS, ITEM_MUTATE_FLAG_CONTRACTS, ITEM_REOPEN_FLAG_CONTRACTS, LEARNINGS_FLAG_CONTRACTS, LIST_COMMANDER_STRING_OPTION_CONTRACTS, LIST_FILTER_FLAG_CONTRACTS, MERGE_FLAG_CONTRACTS, NOTES_FLAG_CONTRACTS, PACKAGE_FLAG_CONTRACTS, PACKAGE_INIT_FLAG_CONTRACTS, PM_EXTENSION_CAPABILITY_CONTRACTS, PM_EXTENSION_POLICY_MODE_CONTRACTS, PM_EXTENSION_POLICY_SURFACE_CONTRACTS, PM_EXTENSION_SANDBOX_PROFILE_CONTRACTS, PM_EXTENSION_SERVICE_NAME_CONTRACTS, PM_EXTENSION_TRUST_MODE_CONTRACTS, PM_OUTPUT_DEGRADATION_STEPS, PLAN_FLAG_CONTRACTS, PM_CORE_COMMAND_NAMES, PM_DEPRECATED_TOOL_ACTIONS, PM_TOOL_ACTIONS, PM_TOOL_PARAMETERS_SCHEMA, REINDEX_FLAG_CONTRACTS, RELEASE_FLAG_CONTRACTS, RESTORE_FLAG_CONTRACTS, SCHEMA_FLAG_CONTRACTS, PROFILE_FLAG_CONTRACTS, SEARCH_COMMANDER_STRING_OPTION_CONTRACTS, EVAL_FLAG_CONTRACTS, WORKSPACE_FLAG_CONTRACTS, NEXT_FLAG_CONTRACTS, SEARCH_FLAG_CONTRACTS, STATS_FLAG_CONTRACTS, DUPLICATES_FLAG_CONTRACTS, START_TASK_FLAG_CONTRACTS, PAUSE_TASK_FLAG_CONTRACTS, TELEMETRY_FLAG_CONTRACTS, TEST_ALL_FLAG_CONTRACTS, TEST_FLAG_CONTRACTS, TEST_RUNS_FLAG_CONTRACTS, UPDATE_COMMANDER_REPEATABLE_OPTION_CONTRACTS, UPDATE_COMMANDER_STRING_OPTION_CONTRACTS, UPDATE_FLAG_CONTRACTS, UPDATE_MANY_FLAG_CONTRACTS, UPGRADE_FLAG_CONTRACTS, VALIDATE_FLAG_CONTRACTS, compactFlagAliasContracts, PM_COMMAND_ALIAS_CONTRACTS, PM_DIAGNOSTIC_OUTPUT_BUDGET_CONTRACTS, resolvePmCommandOutputBudget, } from "../cli-contracts.js";
@@ -228,6 +228,9 @@ const COMMAND_INTENTS = new Map([
228
228
  ["aggregate", "Group counts."],
229
229
  ["append", "Append body."],
230
230
  ["assurance", "Evaluate assurance."],
231
+ ["assurance derive", "Derive checks from evidence."],
232
+ ["assurance risk", "Select checks for changes."],
233
+ ["assurance lineages", "Measure recurrence coverage."],
231
234
  ["beads", "Manage Beads interoperability."],
232
235
  ["cal", "Manage calendar integration."],
233
236
  ["calendar", "Manage calendar integration."],
@@ -2085,4 +2088,4 @@ export const _testOnlyContractsCommand = {
2085
2088
  toRuntimeShortFlagToken,
2086
2089
  };
2087
2090
  //# sourceMappingURL=runtime-contracts.js.map
2088
- //# debugId=1506e8bc-3350-5ef5-a40a-44509eb59317
2091
+ //# debugId=188569e7-c809-5f28-a714-d531f57be1d9
@@ -1,11 +1,260 @@
1
- /**
2
- * @module sdk/cli-contracts/schemas/assurance-definition
3
- *
4
- * Defines the strict JSON Schema accepted by assurance definition mutations.
5
- */
6
1
  /** JSON Schema for measurement, assertion, and gate assurance definitions. */
7
2
  export declare const ASSURANCE_DEFINITION_SCHEMA: {
8
3
  oneOf: ({
4
+ type: string;
5
+ additionalProperties: boolean;
6
+ required: string[];
7
+ properties: {
8
+ limit: {
9
+ type: string;
10
+ minimum: number;
11
+ maximum: number;
12
+ };
13
+ cursor: {
14
+ type: string;
15
+ minLength: number;
16
+ };
17
+ change: {
18
+ additionalProperties: boolean;
19
+ type: string;
20
+ properties: {
21
+ [k: string]: {
22
+ type: string;
23
+ items: {
24
+ type: string;
25
+ };
26
+ };
27
+ };
28
+ };
29
+ policy: {
30
+ type: string;
31
+ required: string[];
32
+ properties: {
33
+ version: {
34
+ const: number;
35
+ };
36
+ evidence_epoch: {
37
+ type: string;
38
+ format: string;
39
+ };
40
+ families: {
41
+ type: string;
42
+ items: {
43
+ type: string;
44
+ required: string[];
45
+ properties: {
46
+ id: {
47
+ type: string;
48
+ pattern: string;
49
+ };
50
+ version: {
51
+ type: string;
52
+ minimum: number;
53
+ };
54
+ title: {
55
+ type: string;
56
+ pattern: string;
57
+ };
58
+ owner_item_id: {
59
+ type: string;
60
+ pattern: string;
61
+ };
62
+ escape_class: {
63
+ enum: readonly ["production_defect", "nightly_regression", "scanner_finding", "review_caught_late"];
64
+ };
65
+ triggers: {
66
+ type: string;
67
+ properties: {
68
+ file_patterns: {
69
+ type: string;
70
+ items: {
71
+ type: string;
72
+ maxLength: number;
73
+ };
74
+ };
75
+ };
76
+ };
77
+ checks: {
78
+ type: string;
79
+ required: string[];
80
+ properties: {
81
+ local: {
82
+ type: string;
83
+ minItems: number;
84
+ items: {
85
+ type: string;
86
+ pattern: string;
87
+ };
88
+ };
89
+ hosted: {
90
+ type: string;
91
+ minItems: number;
92
+ items: {
93
+ type: string;
94
+ pattern: string;
95
+ };
96
+ };
97
+ };
98
+ };
99
+ negative_control: {
100
+ minProperties: number;
101
+ type: string;
102
+ properties: {
103
+ [k: string]: {
104
+ type: string;
105
+ items: {
106
+ type: string;
107
+ };
108
+ };
109
+ };
110
+ };
111
+ historical_item_ids: {
112
+ type: string;
113
+ minItems: number;
114
+ items: {
115
+ type: string;
116
+ pattern: string;
117
+ };
118
+ };
119
+ budget: {
120
+ type: string;
121
+ required: string[];
122
+ properties: {
123
+ [k: string]: {
124
+ type: string;
125
+ minimum: number;
126
+ maximum: number;
127
+ };
128
+ };
129
+ };
130
+ };
131
+ };
132
+ };
133
+ };
134
+ additionalProperties: boolean;
135
+ };
136
+ } | {
137
+ limit: {
138
+ type: string;
139
+ minimum: number;
140
+ maximum: number;
141
+ };
142
+ cursor: {
143
+ type: string;
144
+ minLength: number;
145
+ };
146
+ uncoveredOnly: {
147
+ type: string;
148
+ };
149
+ policy: {
150
+ type: string;
151
+ required: string[];
152
+ properties: {
153
+ version: {
154
+ const: number;
155
+ };
156
+ evidence_epoch: {
157
+ type: string;
158
+ format: string;
159
+ };
160
+ families: {
161
+ type: string;
162
+ items: {
163
+ type: string;
164
+ required: string[];
165
+ properties: {
166
+ id: {
167
+ type: string;
168
+ pattern: string;
169
+ };
170
+ version: {
171
+ type: string;
172
+ minimum: number;
173
+ };
174
+ title: {
175
+ type: string;
176
+ pattern: string;
177
+ };
178
+ owner_item_id: {
179
+ type: string;
180
+ pattern: string;
181
+ };
182
+ escape_class: {
183
+ enum: readonly ["production_defect", "nightly_regression", "scanner_finding", "review_caught_late"];
184
+ };
185
+ triggers: {
186
+ type: string;
187
+ properties: {
188
+ file_patterns: {
189
+ type: string;
190
+ items: {
191
+ type: string;
192
+ maxLength: number;
193
+ };
194
+ };
195
+ };
196
+ };
197
+ checks: {
198
+ type: string;
199
+ required: string[];
200
+ properties: {
201
+ local: {
202
+ type: string;
203
+ minItems: number;
204
+ items: {
205
+ type: string;
206
+ pattern: string;
207
+ };
208
+ };
209
+ hosted: {
210
+ type: string;
211
+ minItems: number;
212
+ items: {
213
+ type: string;
214
+ pattern: string;
215
+ };
216
+ };
217
+ };
218
+ };
219
+ negative_control: {
220
+ minProperties: number;
221
+ type: string;
222
+ properties: {
223
+ [k: string]: {
224
+ type: string;
225
+ items: {
226
+ type: string;
227
+ };
228
+ };
229
+ };
230
+ };
231
+ historical_item_ids: {
232
+ type: string;
233
+ minItems: number;
234
+ items: {
235
+ type: string;
236
+ pattern: string;
237
+ };
238
+ };
239
+ budget: {
240
+ type: string;
241
+ required: string[];
242
+ properties: {
243
+ [k: string]: {
244
+ type: string;
245
+ minimum: number;
246
+ maximum: number;
247
+ };
248
+ };
249
+ };
250
+ };
251
+ };
252
+ };
253
+ };
254
+ additionalProperties: boolean;
255
+ };
256
+ };
257
+ } | {
9
258
  type: string;
10
259
  additionalProperties: boolean;
11
260
  required: string[];
@@ -4,7 +4,42 @@
4
4
  * Defines the strict JSON Schema accepted by assurance definition mutations.
5
5
  */
6
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]="19a97f60-3b6e-5653-a652-02aebaf5afdd")}catch(e){}}();
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]="550e4e06-9e07-59e1-bb47-8233f84885c4")}catch(e){}}();
8
+ import { DEFECT_ESCAPE_CLASSES } from "../../governance/defect-recurrence.js";
9
+ const DEFECT_NONEMPTY_STRING_SCHEMA = { type: "string", pattern: "\\S" };
10
+ const DEFECT_NONEMPTY_STRINGS_SCHEMA = { type: "array", minItems: 1, items: DEFECT_NONEMPTY_STRING_SCHEMA };
11
+ const DEFECT_CHANGE_INPUT_SCHEMA = {
12
+ type: "object",
13
+ properties: Object.fromEntries(["files", "package_names", "item_ids", "tags", "error_codes"].map((key) => [key, { type: "array", items: { type: "string" } }])),
14
+ };
15
+ const DEFECT_FAMILY_SCHEMA = {
16
+ type: "object",
17
+ required: ["id", "version", "title", "owner_item_id", "escape_class", "triggers", "checks", "negative_control", "historical_item_ids", "budget"],
18
+ properties: {
19
+ id: DEFECT_NONEMPTY_STRING_SCHEMA,
20
+ version: { type: "integer", minimum: 1 },
21
+ title: DEFECT_NONEMPTY_STRING_SCHEMA,
22
+ owner_item_id: DEFECT_NONEMPTY_STRING_SCHEMA,
23
+ escape_class: { enum: DEFECT_ESCAPE_CLASSES },
24
+ triggers: {
25
+ type: "object",
26
+ properties: {
27
+ ...Object.fromEntries(["package_names", "item_ids", "tags", "error_codes"].map((key) => [key, { type: "array", items: { type: "string" } }])),
28
+ file_patterns: { type: "array", items: { type: "string", maxLength: 256 } },
29
+ },
30
+ },
31
+ checks: {
32
+ type: "object", required: ["local", "hosted"],
33
+ properties: { local: DEFECT_NONEMPTY_STRINGS_SCHEMA, hosted: DEFECT_NONEMPTY_STRINGS_SCHEMA },
34
+ },
35
+ negative_control: { ...DEFECT_CHANGE_INPUT_SCHEMA, minProperties: 1 },
36
+ historical_item_ids: DEFECT_NONEMPTY_STRINGS_SCHEMA,
37
+ budget: {
38
+ type: "object", required: ["max_escape_rate", "max_false_positive_rate"],
39
+ properties: Object.fromEntries(["max_escape_rate", "max_false_positive_rate"].map((key) => [key, { type: "number", minimum: 0, maximum: 1 }])),
40
+ },
41
+ },
42
+ };
8
43
  const ASSURANCE_VALUE_SCHEMA = {
9
44
  oneOf: [{ type: "number" }, { type: "array", items: { type: "string" } }],
10
45
  };
@@ -19,6 +54,21 @@ Reflect.set(ITEMS_FIELD_CONDITIONAL_SCHEMA, "then", {
19
54
  /** JSON Schema for measurement, assertion, and gate assurance definitions. */
20
55
  export const ASSURANCE_DEFINITION_SCHEMA = {
21
56
  oneOf: [
57
+ ...[true, false].map((isRisk) => ({
58
+ type: "object",
59
+ additionalProperties: false,
60
+ required: isRisk ? ["policy", "change"] : ["policy"],
61
+ properties: {
62
+ policy: { type: "object", required: ["version", "evidence_epoch", "families"], properties: {
63
+ version: { const: 1 },
64
+ evidence_epoch: { type: "string", format: "date-time" },
65
+ families: { type: "array", items: DEFECT_FAMILY_SCHEMA },
66
+ }, additionalProperties: false },
67
+ ...(isRisk ? { change: { ...DEFECT_CHANGE_INPUT_SCHEMA, additionalProperties: false } } : { uncoveredOnly: { type: "boolean" } }),
68
+ limit: { type: "integer", minimum: 1, maximum: 100 },
69
+ cursor: { type: "string", minLength: 1 },
70
+ },
71
+ })),
22
72
  {
23
73
  type: "object",
24
74
  additionalProperties: false,
@@ -272,4 +322,4 @@ export const ASSURANCE_DEFINITION_SCHEMA = {
272
322
  ],
273
323
  };
274
324
  //# sourceMappingURL=assurance-definition.js.map
275
- //# debugId=19a97f60-3b6e-5653-a652-02aebaf5afdd
325
+ //# debugId=550e4e06-9e07-59e1-bb47-8233f84885c4
@@ -4,7 +4,7 @@
4
4
  * Defines SDK command-contract metadata for Tool Parameter Tables.
5
5
  */
6
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]="6968f481-8384-5e3b-8ac0-b0972d08eeb1")}catch(e){}}();
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]="7f278171-3479-5ce6-a925-da6393463200")}catch(e){}}();
8
8
  import { PLAN_HARNESS_VALUES, PLAN_MODE_VALUES, PLAN_STEP_LINK_KIND_VALUES, PLAN_STEP_STATUS_VALUES, } from "../../types/index.js";
9
9
  import { PM_READ_OUTPUT_SESSION_MAX_SEEN_ITEM_IDS } from "../read-output-session.js";
10
10
  import { ASSURANCE_DEFINITION_SCHEMA } from "./schemas/assurance-definition.js";
@@ -192,6 +192,7 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
192
192
  status: { type: "string" },
193
193
  since: { type: "string", format: "date-time" },
194
194
  cursorMode: { type: "string", enum: ["batch", "row"] },
195
+ exhaustive: { type: "boolean" },
195
196
  threshold: { type: "number", minimum: 0, maximum: 1 },
196
197
  filterStatus: { type: "string" },
197
198
  filterType: { type: "string" },
@@ -489,6 +490,7 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
489
490
  delete: { type: "integer", minimum: 1 },
490
491
  dryRun: { type: "boolean" },
491
492
  normalizeProvenance: { type: "boolean" },
493
+ salvageTail: { type: "boolean" },
492
494
  all: { type: "boolean" },
493
495
  clear: { type: "boolean" },
494
496
  cliOnly: { type: "boolean" },
@@ -508,6 +510,8 @@ export const PM_TOOL_PARAMETER_PROPERTIES = {
508
510
  ],
509
511
  },
510
512
  includeDecisions: { type: "boolean" },
513
+ includeGates: { type: "boolean" },
514
+ includeContainers: { type: "boolean" },
511
515
  explainRanking: { type: "boolean" },
512
516
  noTags: { type: "boolean" },
513
517
  noExtensionHealth: { type: "boolean" },
@@ -674,6 +678,7 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_PROPERTIES = {
674
678
  "derive",
675
679
  "promote",
676
680
  "risk",
681
+ "lineages",
677
682
  ],
678
683
  },
679
684
  preset: {
@@ -867,6 +872,12 @@ export const PLAN_ACTION_PARAMETER_METADATA = {
867
872
  };
868
873
  /** Public contract for pm tool parameter metadata, shared by SDK and presentation-layer consumers. */
869
874
  export const PM_TOOL_PARAMETER_METADATA = {
875
+ includeGates: {
876
+ description: "Opt next or claim-next into outcome gates. Blocker and ownership restrictions still apply.",
877
+ },
878
+ includeContainers: {
879
+ description: "Opt next or claim-next into containers with unfinished descendants. Blocker and ownership restrictions still apply.",
880
+ },
870
881
  action: {
871
882
  description: "Tool action to execute.",
872
883
  },
@@ -1181,6 +1192,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
1181
1192
  description: "Inclusive ISO 8601 creation timestamp lower bound for duplicate discovery.",
1182
1193
  examples: ["2026-01-01T00:00:00.000Z"],
1183
1194
  },
1195
+ exhaustive: {
1196
+ description: "Compare every duplicate pair within the disclosed safety bound; default prefix filtering preserves exact recall.",
1197
+ },
1184
1198
  threshold: {
1185
1199
  description: "Minimum duplicate similarity score from zero through one.",
1186
1200
  examples: [0.85],
@@ -1472,6 +1486,9 @@ export const PM_TOOL_PARAMETER_METADATA = {
1472
1486
  normalizeProvenance: {
1473
1487
  description: "For history-repair: remove invalid legacy provenance observations and emit only aggregate privacy-safe repair evidence.",
1474
1488
  },
1489
+ salvageTail: {
1490
+ description: "For history-repair with one explicit id: remove an invalid trailing suffix after a verified prefix; refuses interior corruption.",
1491
+ },
1475
1492
  all: {
1476
1493
  description: "For history-repair action: scan every stream for drift and repair each drifted stream in one audited pass (mutually exclusive with id).",
1477
1494
  },
@@ -1671,10 +1688,10 @@ export const PM_TOOL_PARAMETER_METADATA = {
1671
1688
  description: "For validate action, include full diagnostic ID lists instead of compact summaries.",
1672
1689
  },
1673
1690
  strictExit: {
1674
- description: "Return non-zero exit when health/validate/extension-doctor warnings are present.",
1691
+ description: "Apply the selected capability's strict exit policy; health also requires merge drivers.",
1675
1692
  },
1676
1693
  failOnWarn: {
1677
- description: "Alias for strictExit in health/validate/extension-doctor action payloads.",
1694
+ description: "Alias for strictExit in health, validation, history, and managed doctor actions.",
1678
1695
  },
1679
1696
  fixHints: {
1680
1697
  description: "For validate action, add a machine-executable fix_hints[] of pm commands to each failing check's details.",
@@ -1953,10 +1970,17 @@ export const PM_TOOL_PARAMETER_METADATA = {
1953
1970
  * because its single `name` property must cover every action at once.
1954
1971
  */
1955
1972
  export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
1973
+ "health": { strictExit: { description: "Return non-zero for a failing health verdict; also require merge drivers." } },
1974
+ "validate": { strictExit: { description: "Return non-zero when validation reports warnings." } },
1975
+ "extension-doctor": { strictExit: { description: "Return non-zero when extension diagnostics report warnings or a non-ok summary." } },
1976
+ "package-doctor": { strictExit: { description: "Return non-zero when package diagnostics report warnings or a non-ok summary." } },
1977
+ "history": { strictExit: { description: "Return non-zero for history verification failures when verify is enabled." } },
1978
+ extension: { strictExit: { description: "For doctor operations, return non-zero on warnings or a non-ok diagnostic summary." } },
1979
+ package: { strictExit: { description: "For doctor operations, return non-zero on warnings or a non-ok diagnostic summary." } },
1956
1980
  assurance: {
1957
1981
  subcommand: {
1958
- description: "Assurance operation: list, show, put, remove, run, verdicts, presets, apply, derive, promote, or risk.",
1959
- examples: ["list", "run", "derive", "promote", "risk"],
1982
+ description: "Assurance operation: list, show, put, remove, run, verdicts, presets, apply, derive, promote, risk, or lineages.",
1983
+ examples: ["list", "run", "risk", "lineages"],
1960
1984
  },
1961
1985
  kind: {
1962
1986
  description: "Assurance declaration kind for registry operations: measurement, assertion, or gate.",
@@ -2141,4 +2165,4 @@ export const PM_TOOL_ACTION_SCOPED_PARAMETER_METADATA = {
2141
2165
  },
2142
2166
  };
2143
2167
  //# sourceMappingURL=tool-parameter-tables.js.map
2144
- //# debugId=6968f481-8384-5e3b-8ac0-b0972d08eeb1
2168
+ //# debugId=7f278171-3479-5ce6-a925-da6393463200
@@ -91,14 +91,14 @@ export interface PmActionToolInputSchemaOptions {
91
91
  */
92
92
  export declare function buildPmActionToolInputSchema(action: PmToolAction, options?: PmActionToolInputSchemaOptions): Record<string, unknown>;
93
93
  /** Canonical version of the action-scoped strict MCP tool-parameters schema (`PM_TOOL_PARAMETERS_SCHEMA`). Exported as the single source of truth so the MCP server, the `pm contracts` command, SDK consumers, and contract tests bind to one version constant. Bump the patch/minor for additive, backward-compatible schema changes; bump the MAJOR for breaking changes — the major also drives the `$id` `tool-parameters-v{major}` slug, so the two never drift. */
94
- export declare const PM_TOOL_PARAMETERS_SCHEMA_VERSION: "4.10.1";
94
+ export declare const PM_TOOL_PARAMETERS_SCHEMA_VERSION: "4.14.0";
95
95
  /**
96
96
  * Major component of {@link PM_TOOL_PARAMETERS_SCHEMA_VERSION}, used to build the
97
97
  * schema `$id` slug so a breaking version bump renames the document in lockstep.
98
98
  */
99
99
  export declare const PM_TOOL_PARAMETERS_SCHEMA_MAJOR: string;
100
100
  /** Version of the provider-compatible flat tool-parameters schema (`PM_PROVIDER_TOOL_PARAMETERS_SCHEMA`). Tracked separately from the strict schema because the flat projection evolves independently. */
101
- export declare const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION: "1.4.0";
101
+ export declare const PM_PROVIDER_TOOL_PARAMETERS_SCHEMA_VERSION: "1.7.0";
102
102
  /** Public contract for pm tool parameters schema, shared by SDK and presentation-layer consumers. */
103
103
  export declare const PM_TOOL_PARAMETERS_SCHEMA: Record<string, unknown>;
104
104
  declare function toProviderCompatibleParameterDefinition(key: string, definition: unknown): Record<string, unknown>;