@unbrained/pm-cli 2026.10.13 → 2026.10.15

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 (708) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +72 -1
  3. package/dist/cli/after-command-context-usage.d.ts +7 -7
  4. package/dist/cli/argv-utils.d.ts +4 -4
  5. package/dist/cli/bundle-integrity.d.ts +16 -16
  6. package/dist/cli/command-namespaces.d.ts +1 -1
  7. package/dist/cli/commander-usage.d.ts +34 -34
  8. package/dist/cli/commands/governance/validate.d.ts +1 -1
  9. package/dist/cli/commands/history/history-compact.d.ts +1 -1
  10. package/dist/cli/commands/history/history-redact.d.ts +1 -1
  11. package/dist/cli/commands/history/history-repair.d.ts +1 -1
  12. package/dist/cli/commands/history/restore.d.ts +1 -1
  13. package/dist/cli/commands/lifecycle/close.d.ts +1 -1
  14. package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
  15. package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
  16. package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
  17. package/dist/cli/commands/query/get.d.ts +1 -1
  18. package/dist/cli/commands/workspace/merge.d.ts +1 -1
  19. package/dist/cli/commands/workspace/schema.d.ts +1 -1
  20. package/dist/cli/context-intent-invocation.d.ts +1 -1
  21. package/dist/cli/description-stdin.d.ts +1 -1
  22. package/dist/cli/error-guidance.d.ts +119 -119
  23. package/dist/cli/extension-command-help.d.ts +64 -64
  24. package/dist/cli/extension-command-help.js +2 -2
  25. package/dist/cli/extension-command-options.d.ts +16 -16
  26. package/dist/cli/extension-command-options.js +1 -1
  27. package/dist/cli/extension-recovery.d.ts +13 -13
  28. package/dist/cli/help-content.d.ts +22 -22
  29. package/dist/cli/help-content.js +2 -2
  30. package/dist/cli/help-json-payload.d.ts +45 -45
  31. package/dist/cli/invocation-profile.d.ts +5 -5
  32. package/dist/cli/main.d.ts +217 -217
  33. package/dist/cli/main.js +2 -2
  34. package/dist/cli/migration-gates.d.ts +24 -24
  35. package/dist/cli/option-values.d.ts +1 -1
  36. package/dist/cli/public.d.ts +1 -1
  37. package/dist/cli/register-annotations.d.ts +2 -2
  38. package/dist/cli/register-assurance.d.ts +1 -1
  39. package/dist/cli/register-files-lookup.d.ts +1 -1
  40. package/dist/cli/register-history-activity.d.ts +1 -1
  41. package/dist/cli/register-history-author.d.ts +1 -1
  42. package/dist/cli/register-history-maintenance.d.ts +1 -1
  43. package/dist/cli/register-list-query.d.ts +7 -7
  44. package/dist/cli/register-list-query.js +3 -3
  45. package/dist/cli/register-mutation-options.d.ts +1 -1
  46. package/dist/cli/register-mutation.d.ts +4 -4
  47. package/dist/cli/register-operations.d.ts +75 -75
  48. package/dist/cli/register-setup.d.ts +4 -4
  49. package/dist/cli/register-structured-mutation.d.ts +8 -8
  50. package/dist/cli/runtime/activation.d.ts +23 -23
  51. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  52. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  53. package/dist/cli/runtime/selection.d.ts +16 -16
  54. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  55. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  56. package/dist/cli/schema/registration.d.ts +1 -1
  57. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  58. package/dist/cli/stats-analytics-json.d.ts +1 -1
  59. package/dist/cli-bundle/bundle-manifest.json +1 -1
  60. package/dist/cli-bundle/chunks/{chunk-LBDWFWPK.js → chunk-52EZH2QQ.js} +2 -2
  61. package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
  62. package/dist/cli-bundle/chunks/{chunk-APWPC4ZZ.js → chunk-7VHINXZP.js} +2 -2
  63. package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
  64. package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
  65. package/dist/cli-bundle/chunks/{chunk-PSNS537F.js → chunk-JSUJWIHQ.js} +30 -30
  66. package/dist/cli-bundle/chunks/{chunk-N5EXRYCZ.js → chunk-LNKLQYBG.js} +2 -2
  67. package/dist/cli-bundle/chunks/{chunk-YH6H3UVE.js → chunk-N56CAQBU.js} +63 -64
  68. package/dist/cli-bundle/chunks/chunk-NC3QVGDD.js +8 -0
  69. package/dist/cli-bundle/chunks/{chunk-AM2XOZKE.js → chunk-RJ5N44WY.js} +2 -2
  70. package/dist/cli-bundle/chunks/{chunk-HXHFKXLV.js → chunk-VIMQCFCK.js} +2 -2
  71. package/dist/cli-bundle/chunks/{chunk-UBTYYZIE.js → chunk-WBBW3WQX.js} +4 -4
  72. package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
  73. package/dist/cli-bundle/chunks/{register-list-query-BJ742QOR.js → register-list-query-FKKFQ66D.js} +7 -7
  74. package/dist/cli-bundle/chunks/{register-mutation-GGGBRIH2.js → register-mutation-EWMMVZJB.js} +2 -2
  75. package/dist/cli-bundle/chunks/{register-operations-E6HXYHNM.js → register-operations-GEQ2H7PS.js} +2 -2
  76. package/dist/cli-bundle/chunks/{register-setup-4ZVTVEPY.js → register-setup-PSJTQBBO.js} +2 -2
  77. package/dist/cli-bundle/focused-chunks/{chunk-NNW5BS5L.js → chunk-3RNUMVK4.js} +2 -2
  78. package/dist/cli-bundle/focused-chunks/{chunk-3LQEBXU5.js → chunk-4KQFMOM7.js} +6 -6
  79. package/dist/cli-bundle/focused-chunks/{chunk-RAA7SVRA.js → chunk-52I2SNKJ.js} +2 -2
  80. package/dist/cli-bundle/focused-chunks/{chunk-6BTUISKV.js → chunk-5KRACGBK.js} +2 -2
  81. package/dist/cli-bundle/focused-chunks/chunk-5OO54BIV.js +3 -0
  82. package/dist/cli-bundle/focused-chunks/chunk-5TBAVZDR.js +20 -0
  83. package/dist/cli-bundle/focused-chunks/{chunk-R23T7GFZ.js → chunk-FQKPOZKS.js} +2 -2
  84. package/dist/cli-bundle/focused-chunks/{chunk-IIKFTJVC.js → chunk-H3P77KVU.js} +2 -2
  85. package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
  86. package/dist/cli-bundle/focused-chunks/{chunk-73UNAJHD.js → chunk-JKBH7YGX.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/{chunk-KGFRQ34R.js → chunk-KIIFVULU.js} +2 -2
  88. package/dist/cli-bundle/focused-chunks/{chunk-SOB7X4FJ.js → chunk-N6FUKTZS.js} +2 -2
  89. package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
  90. package/dist/cli-bundle/focused-chunks/{chunk-RU6GCFN3.js → chunk-Q4VNCTR2.js} +2 -2
  91. package/dist/cli-bundle/focused-chunks/{chunk-QMNAY25P.js → chunk-THYQR3ON.js} +61 -62
  92. package/dist/cli-bundle/focused-chunks/{chunk-DVK7VKZL.js → chunk-TYLG5VEB.js} +2 -2
  93. package/dist/cli-bundle/main.js +27 -27
  94. package/dist/cli-bundle/sdk-authoring.js +1 -1
  95. package/dist/cli-bundle/sdk-contracts.js +2 -2
  96. package/dist/cli-bundle/sdk-core.js +23 -23
  97. package/dist/cli-bundle/sdk-governance.js +1 -1
  98. package/dist/cli-bundle/sdk-graph.js +1 -1
  99. package/dist/cli-bundle/sdk-merge.js +51 -51
  100. package/dist/cli-bundle/sdk-query.js +1 -1
  101. package/dist/cli-bundle/sdk-runtime.js +1 -1
  102. package/dist/cli-bundle/sdk-testing.js +1 -1
  103. package/dist/cli-bundle/sdk.js +7 -7
  104. package/dist/cli.d.ts +9 -9
  105. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  106. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  107. package/dist/core/config/nested-settings.d.ts +20 -20
  108. package/dist/core/config/positional-value.d.ts +9 -9
  109. package/dist/core/diagnostics/remediation.d.ts +7 -7
  110. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  111. package/dist/core/extensions/activation-summary.d.ts +30 -30
  112. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  113. package/dist/core/extensions/capability-usage.d.ts +25 -25
  114. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  115. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  116. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  117. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  118. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  119. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  120. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  121. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  122. package/dist/core/extensions/extension-policy.d.ts +62 -62
  123. package/dist/core/extensions/extension-registries.d.ts +8 -8
  124. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  125. package/dist/core/extensions/extension-types.d.ts +702 -702
  126. package/dist/core/extensions/flag-definition-validation.d.ts +19 -6
  127. package/dist/core/extensions/flag-definition-validation.js +1 -1
  128. package/dist/core/extensions/flag-value-types.d.ts +16 -4
  129. package/dist/core/extensions/flag-value-types.js +1 -1
  130. package/dist/core/extensions/index.d.ts +34 -34
  131. package/dist/core/extensions/item-field-types.d.ts +3 -3
  132. package/dist/core/extensions/item-fields.d.ts +6 -6
  133. package/dist/core/extensions/loader.d.ts +66 -66
  134. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  135. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  136. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  137. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  138. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  139. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  140. package/dist/core/extensions/registration-validation.d.ts +6 -6
  141. package/dist/core/extensions/registration-values.d.ts +19 -19
  142. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  143. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  144. package/dist/core/extensions/service-ownership.d.ts +1 -1
  145. package/dist/core/extensions/version-compat.d.ts +9 -9
  146. package/dist/core/fs/atomic-create.d.ts +1 -1
  147. package/dist/core/fs/fs-utils.d.ts +12 -12
  148. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  149. package/dist/core/fs/path-utils.d.ts +1 -1
  150. package/dist/core/governance/content-fields.d.ts +25 -25
  151. package/dist/core/governance/issue-codes.d.ts +16 -16
  152. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  153. package/dist/core/history/digest.d.ts +5 -5
  154. package/dist/core/history/drift-cache.d.ts +2 -2
  155. package/dist/core/history/drift-scan.d.ts +18 -18
  156. package/dist/core/history/event-classification.d.ts +4 -4
  157. package/dist/core/history/event-index.d.ts +33 -33
  158. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  159. package/dist/core/history/history-diff.d.ts +15 -15
  160. package/dist/core/history/history-rewrite.d.ts +43 -43
  161. package/dist/core/history/history-storage-stats.d.ts +20 -20
  162. package/dist/core/history/history-stream-policy.d.ts +12 -12
  163. package/dist/core/history/history.d.ts +45 -45
  164. package/dist/core/history/identity.d.ts +4 -4
  165. package/dist/core/history/operation-contract.d.ts +17 -17
  166. package/dist/core/history/projection.d.ts +16 -16
  167. package/dist/core/history/read.d.ts +4 -4
  168. package/dist/core/history/replay.d.ts +47 -47
  169. package/dist/core/history/tombstone.d.ts +1 -1
  170. package/dist/core/history/version-address.d.ts +2 -2
  171. package/dist/core/history/workspace-history.d.ts +72 -72
  172. package/dist/core/io/body-file.d.ts +2 -2
  173. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  174. package/dist/core/item/actionability.d.ts +30 -30
  175. package/dist/core/item/dependency-reference.d.ts +2 -2
  176. package/dist/core/item/id.d.ts +9 -9
  177. package/dist/core/item/item-format-version.d.ts +17 -15
  178. package/dist/core/item/item-format-version.js +1 -1
  179. package/dist/core/item/item-format.d.ts +54 -54
  180. package/dist/core/item/item-record.d.ts +1 -1
  181. package/dist/core/item/item-type-definition.d.ts +11 -11
  182. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  183. package/dist/core/item/parse.d.ts +37 -37
  184. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  185. package/dist/core/item/priority.d.ts +3 -3
  186. package/dist/core/item/sprint-release-format.d.ts +4 -4
  187. package/dist/core/item/status-filter.d.ts +5 -5
  188. package/dist/core/item/status.d.ts +3 -3
  189. package/dist/core/item/toon-decode.d.ts +10 -10
  190. package/dist/core/item/type-registry.d.ts +35 -35
  191. package/dist/core/item/type-synonyms.d.ts +2 -2
  192. package/dist/core/lock/lock-gc.d.ts +28 -28
  193. package/dist/core/lock/lock.d.ts +53 -53
  194. package/dist/core/output/mutation-projection.d.ts +4 -4
  195. package/dist/core/output/output-control.d.ts +4 -4
  196. package/dist/core/output/output.d.ts +30 -30
  197. package/dist/core/output/query-summary.d.ts +5 -5
  198. package/dist/core/output/tabular.d.ts +3 -3
  199. package/dist/core/packages/manifest.d.ts +30 -30
  200. package/dist/core/packages/root.d.ts +4 -4
  201. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  202. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  203. package/dist/core/policy/workflow-policy.d.ts +56 -56
  204. package/dist/core/profile/profile-describe.d.ts +22 -22
  205. package/dist/core/profile/profile-lint.d.ts +13 -13
  206. package/dist/core/profile/profile-plan.d.ts +45 -45
  207. package/dist/core/profile/profile-presets.d.ts +36 -36
  208. package/dist/core/reproducibility/context.d.ts +9 -9
  209. package/dist/core/schema/fields-file.d.ts +35 -35
  210. package/dist/core/schema/item-types-file.d.ts +29 -29
  211. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  212. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  213. package/dist/core/schema/runtime-schema.d.ts +59 -59
  214. package/dist/core/schema/status-defs-file.d.ts +29 -29
  215. package/dist/core/schema/status-token.d.ts +1 -1
  216. package/dist/core/schema/type-inference.d.ts +10 -10
  217. package/dist/core/schema/type-presets.d.ts +5 -5
  218. package/dist/core/schema/type-workflows.d.ts +14 -14
  219. package/dist/core/search/background-refresh.d.ts +12 -12
  220. package/dist/core/search/bm25.d.ts +16 -16
  221. package/dist/core/search/cache.d.ts +34 -34
  222. package/dist/core/search/corpus.d.ts +17 -17
  223. package/dist/core/search/embedding-batches.d.ts +25 -25
  224. package/dist/core/search/eval-thresholds.d.ts +4 -4
  225. package/dist/core/search/eval.d.ts +40 -40
  226. package/dist/core/search/http-client.d.ts +24 -24
  227. package/dist/core/search/providers.d.ts +30 -30
  228. package/dist/core/search/relevance.d.ts +17 -17
  229. package/dist/core/search/semantic-defaults.d.ts +5 -5
  230. package/dist/core/search/staleness.d.ts +3 -3
  231. package/dist/core/search/vector-stores.d.ts +51 -51
  232. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  233. package/dist/core/sentry/helpers.d.ts +28 -26
  234. package/dist/core/sentry/helpers.js +1 -1
  235. package/dist/core/sentry/instrument.d.ts +52 -50
  236. package/dist/core/sentry/instrument.js +1 -1
  237. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  238. package/dist/core/sentry/sensitive-assignments.js +2 -0
  239. package/dist/core/session/session-state.d.ts +37 -37
  240. package/dist/core/shared/agent-session-context.d.ts +14 -14
  241. package/dist/core/shared/author.d.ts +89 -89
  242. package/dist/core/shared/command-line.d.ts +3 -3
  243. package/dist/core/shared/command-types.d.ts +20 -20
  244. package/dist/core/shared/conflict-markers.d.ts +5 -5
  245. package/dist/core/shared/constants.d.ts +30 -30
  246. package/dist/core/shared/errors.d.ts +100 -100
  247. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  248. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  249. package/dist/core/shared/lazy-module.d.ts +1 -1
  250. package/dist/core/shared/levenshtein.d.ts +1 -1
  251. package/dist/core/shared/memo.d.ts +1 -1
  252. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  253. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  254. package/dist/core/shared/primitives.d.ts +13 -13
  255. package/dist/core/shared/secret-rules.d.ts +92 -92
  256. package/dist/core/shared/serial-queue.d.ts +6 -6
  257. package/dist/core/shared/serialization.d.ts +4 -4
  258. package/dist/core/shared/split-comma-list.d.ts +4 -4
  259. package/dist/core/shared/text-normalization.d.ts +3 -3
  260. package/dist/core/shared/time.d.ts +27 -27
  261. package/dist/core/store/item-format-migration.d.ts +7 -7
  262. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  263. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  264. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  265. package/dist/core/store/item-store.d.ts +123 -123
  266. package/dist/core/store/item-store.js +1 -1
  267. package/dist/core/store/paths.d.ts +27 -27
  268. package/dist/core/store/settings-concurrency.d.ts +1 -1
  269. package/dist/core/store/settings-read-cache.d.ts +11 -11
  270. package/dist/core/store/settings-validator.d.ts +117 -117
  271. package/dist/core/store/settings.d.ts +84 -84
  272. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  273. package/dist/core/store/tracker-preflight.d.ts +3 -3
  274. package/dist/core/telemetry/consent.d.ts +1 -1
  275. package/dist/core/telemetry/observability.d.ts +16 -16
  276. package/dist/core/telemetry/policy.d.ts +7 -7
  277. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  278. package/dist/core/telemetry/runtime.d.ts +275 -275
  279. package/dist/core/telemetry/runtime.js +2 -2
  280. package/dist/core/test/background-runs.d.ts +123 -123
  281. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  282. package/dist/core/test/run-selectors.d.ts +12 -12
  283. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  284. package/dist/core/validate/fix-planning.d.ts +36 -36
  285. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  286. package/dist/core/validate/missing-by-type.d.ts +3 -3
  287. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  288. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  289. package/dist/mcp/http-server.d.ts +26 -26
  290. package/dist/mcp/legacy-adapter.d.ts +18 -18
  291. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  292. package/dist/mcp/server.d.ts +73 -73
  293. package/dist/mcp/tool-definitions.d.ts +27 -27
  294. package/dist/sdk/actionability.d.ts +1 -1
  295. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  296. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  297. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  298. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  299. package/dist/sdk/agent/identity-config.d.ts +18 -18
  300. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  301. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  302. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  303. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  304. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  305. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  306. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  307. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  308. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  309. package/dist/sdk/agent-session-context.d.ts +1 -1
  310. package/dist/sdk/annotations.d.ts +74 -74
  311. package/dist/sdk/author-attribution.d.ts +47 -47
  312. package/dist/sdk/authoring.d.ts +9 -9
  313. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  314. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  315. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  316. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  317. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  318. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  319. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  320. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  321. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  322. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  323. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  324. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  325. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  326. package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
  327. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  328. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  329. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  330. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  331. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  332. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  333. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  334. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  335. package/dist/sdk/cli-contracts.d.ts +15 -15
  336. package/dist/sdk/cli-program.d.ts +1 -1
  337. package/dist/sdk/cli-program.js +1 -1
  338. package/dist/sdk/command-line.d.ts +3 -3
  339. package/dist/sdk/comments.d.ts +24 -24
  340. package/dist/sdk/compile-cache.d.ts +4 -4
  341. package/dist/sdk/completion/bash.d.ts +1 -1
  342. package/dist/sdk/completion/fish.d.ts +1 -1
  343. package/dist/sdk/completion/shared.d.ts +74 -74
  344. package/dist/sdk/completion/zsh.d.ts +1 -1
  345. package/dist/sdk/completion.d.ts +3 -3
  346. package/dist/sdk/compose.d.ts +94 -94
  347. package/dist/sdk/config.d.ts +105 -105
  348. package/dist/sdk/context/recency.d.ts +1 -1
  349. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  350. package/dist/sdk/context/usage-egress.d.ts +1 -1
  351. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  352. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  353. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  354. package/dist/sdk/context-packing.d.ts +44 -44
  355. package/dist/sdk/context-relevance.d.ts +110 -110
  356. package/dist/sdk/context-signal-store.d.ts +52 -52
  357. package/dist/sdk/context-usage.d.ts +78 -78
  358. package/dist/sdk/contracts.d.ts +2 -1
  359. package/dist/sdk/contracts.js +1 -1
  360. package/dist/sdk/core-governance.d.ts +5 -5
  361. package/dist/sdk/core.d.ts +8 -8
  362. package/dist/sdk/corpus-shape.d.ts +60 -60
  363. package/dist/sdk/define.d.ts +36 -36
  364. package/dist/sdk/dependencies.d.ts +70 -70
  365. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  366. package/dist/sdk/dependency-provenance.d.ts +22 -22
  367. package/dist/sdk/docs.d.ts +17 -17
  368. package/dist/sdk/duplicates.d.ts +14 -14
  369. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  370. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  371. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  372. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  373. package/dist/sdk/environment/source-context.d.ts +4 -4
  374. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  375. package/dist/sdk/error-code-catalog.d.ts +33 -33
  376. package/dist/sdk/error-runtime.d.ts +5 -5
  377. package/dist/sdk/errors.d.ts +17 -17
  378. package/dist/sdk/eval.d.ts +27 -27
  379. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  380. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  381. package/dist/sdk/extension/concurrency.d.ts +1 -1
  382. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  383. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  384. package/dist/sdk/extension/describe.d.ts +21 -21
  385. package/dist/sdk/extension/doctor.d.ts +46 -46
  386. package/dist/sdk/extension/install-plan.d.ts +32 -32
  387. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  388. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  389. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  390. package/dist/sdk/extension/install-sources.d.ts +106 -106
  391. package/dist/sdk/extension/managed-state.d.ts +42 -42
  392. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  393. package/dist/sdk/extension/migrations.d.ts +48 -48
  394. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  395. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  396. package/dist/sdk/extension/scaffold.d.ts +15 -15
  397. package/dist/sdk/extension/shared.d.ts +16 -16
  398. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  399. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  400. package/dist/sdk/extension/update-check.d.ts +9 -9
  401. package/dist/sdk/extension-command-context.d.ts +1 -1
  402. package/dist/sdk/extension-contracts.d.ts +10 -10
  403. package/dist/sdk/extension.d.ts +221 -221
  404. package/dist/sdk/files.d.ts +101 -101
  405. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  406. package/dist/sdk/flag-invocation-contracts.js +1 -1
  407. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  408. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  409. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  410. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  411. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  412. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  413. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  414. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  415. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  416. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  417. package/dist/sdk/governance/assurance.d.ts +204 -204
  418. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  419. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  420. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  421. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  422. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  423. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  424. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  425. package/dist/sdk/governance/defect-recurrence.js +2 -1
  426. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  427. package/dist/sdk/governance/gc.d.ts +26 -26
  428. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  429. package/dist/sdk/governance/health.d.ts +172 -172
  430. package/dist/sdk/governance/health.js +1 -1
  431. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  432. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  433. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  434. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  435. package/dist/sdk/governance/reindex.d.ts +102 -102
  436. package/dist/sdk/governance/reliability.d.ts +29 -29
  437. package/dist/sdk/governance/stale-work.d.ts +13 -13
  438. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  439. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  440. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  441. package/dist/sdk/governance/upgrade.d.ts +77 -77
  442. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  443. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  444. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  445. package/dist/sdk/governance/validate.d.ts +176 -176
  446. package/dist/sdk/governance/validate.js +1 -1
  447. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  448. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  449. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  450. package/dist/sdk/governance.d.ts +2 -2
  451. package/dist/sdk/graph/adapter.d.ts +45 -45
  452. package/dist/sdk/graph/analytics.d.ts +36 -36
  453. package/dist/sdk/graph/assembly.d.ts +51 -51
  454. package/dist/sdk/graph/cache.d.ts +19 -19
  455. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  456. package/dist/sdk/graph/centrality.d.ts +20 -20
  457. package/dist/sdk/graph/conformance.d.ts +21 -21
  458. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  459. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  460. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  461. package/dist/sdk/graph/governance.d.ts +92 -92
  462. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  463. package/dist/sdk/graph/index.d.ts +15 -15
  464. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  465. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  466. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  467. package/dist/sdk/graph/remediation.d.ts +15 -15
  468. package/dist/sdk/graph/run.d.ts +203 -203
  469. package/dist/sdk/graph/scheduling.d.ts +21 -21
  470. package/dist/sdk/graph/traversal.d.ts +18 -18
  471. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  472. package/dist/sdk/guide-topics.d.ts +19 -19
  473. package/dist/sdk/guide.d.ts +43 -43
  474. package/dist/sdk/history/attestation-command.d.ts +8 -8
  475. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  476. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  477. package/dist/sdk/history/attestation.d.ts +4 -4
  478. package/dist/sdk/history/maintenance.d.ts +25 -25
  479. package/dist/sdk/history/salvage.d.ts +19 -19
  480. package/dist/sdk/history/subject.d.ts +8 -8
  481. package/dist/sdk/history-analytics.d.ts +64 -64
  482. package/dist/sdk/history-compact.d.ts +67 -67
  483. package/dist/sdk/history-mcp.d.ts +7 -7
  484. package/dist/sdk/history-provenance.d.ts +40 -40
  485. package/dist/sdk/history-read.d.ts +24 -24
  486. package/dist/sdk/history-redact.d.ts +68 -68
  487. package/dist/sdk/history-repair.d.ts +92 -92
  488. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  489. package/dist/sdk/improvement-ledger.d.ts +62 -62
  490. package/dist/sdk/index.d.ts +69 -69
  491. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  492. package/dist/sdk/init.d.ts +117 -117
  493. package/dist/sdk/invocation-author.d.ts +1 -1
  494. package/dist/sdk/item-children.d.ts +15 -15
  495. package/dist/sdk/item-metadata-index.d.ts +2 -2
  496. package/dist/sdk/item-schedule.d.ts +9 -9
  497. package/dist/sdk/item-transaction.d.ts +73 -73
  498. package/dist/sdk/learnings.d.ts +23 -23
  499. package/dist/sdk/lifecycle/append.d.ts +8 -8
  500. package/dist/sdk/lifecycle/claim.d.ts +38 -38
  501. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  502. package/dist/sdk/lifecycle/close.d.ts +18 -18
  503. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  504. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  505. package/dist/sdk/lifecycle/create.d.ts +88 -88
  506. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  507. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  508. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  509. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  510. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  511. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  512. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  513. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  514. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  515. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  516. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  517. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  518. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  519. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  520. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  521. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  522. package/dist/sdk/lifecycle/restore.js +1 -1
  523. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  524. package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
  525. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  526. package/dist/sdk/lifecycle/update.d.ts +120 -120
  527. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  528. package/dist/sdk/lifecycle-policy.d.ts +31 -31
  529. package/dist/sdk/linked-artifacts.d.ts +58 -58
  530. package/dist/sdk/mcp/apps.d.ts +28 -28
  531. package/dist/sdk/mcp/authorization.d.ts +66 -66
  532. package/dist/sdk/mcp/discovery.d.ts +67 -67
  533. package/dist/sdk/mcp/interactions.d.ts +49 -49
  534. package/dist/sdk/mcp/protocol.d.ts +63 -63
  535. package/dist/sdk/mcp/skills.d.ts +62 -62
  536. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  537. package/dist/sdk/mcp/tasks.d.ts +51 -51
  538. package/dist/sdk/mcp/transport.d.ts +17 -17
  539. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  540. package/dist/sdk/merge/driver.d.ts +38 -38
  541. package/dist/sdk/merge/index.d.ts +5 -5
  542. package/dist/sdk/merge/install.d.ts +48 -48
  543. package/dist/sdk/merge/install.js +1 -1
  544. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  545. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  546. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  547. package/dist/sdk/merge/receipts.d.ts +111 -111
  548. package/dist/sdk/merge/reconcile.d.ts +20 -20
  549. package/dist/sdk/merge/three-way.d.ts +50 -50
  550. package/dist/sdk/merge/three-way.js +2 -2
  551. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  552. package/dist/sdk/mutation-events.d.ts +62 -62
  553. package/dist/sdk/mutation-guard.d.ts +134 -134
  554. package/dist/sdk/notes.d.ts +28 -28
  555. package/dist/sdk/output/table-rows.d.ts +6 -6
  556. package/dist/sdk/output-contracts.d.ts +26 -26
  557. package/dist/sdk/output-projection.d.ts +108 -108
  558. package/dist/sdk/output-token-accounting.d.ts +18 -18
  559. package/dist/sdk/output.d.ts +18 -18
  560. package/dist/sdk/ownership-source.d.ts +1 -1
  561. package/dist/sdk/package-import-adapters.d.ts +51 -51
  562. package/dist/sdk/package-migrations.d.ts +3 -3
  563. package/dist/sdk/package-runtime-options.d.ts +3 -3
  564. package/dist/sdk/pagination.d.ts +28 -28
  565. package/dist/sdk/pagination.js +1 -1
  566. package/dist/sdk/profile.d.ts +72 -72
  567. package/dist/sdk/provenance.d.ts +37 -37
  568. package/dist/sdk/public-surface.json +1 -1
  569. package/dist/sdk/query/activity.d.ts +84 -84
  570. package/dist/sdk/query/aggregate.d.ts +109 -109
  571. package/dist/sdk/query/calendar.d.ts +95 -95
  572. package/dist/sdk/query/complete-list.d.ts +35 -35
  573. package/dist/sdk/query/context.d.ts +300 -300
  574. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  575. package/dist/sdk/query/get.d.ts +54 -54
  576. package/dist/sdk/query/history.d.ts +38 -38
  577. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  578. package/dist/sdk/query/light-metadata.d.ts +1 -1
  579. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  580. package/dist/sdk/query/list.d.ts +167 -167
  581. package/dist/sdk/query/list.js +1 -1
  582. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  583. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  584. package/dist/sdk/query/next.d.ts +94 -94
  585. package/dist/sdk/query/parsers.d.ts +3 -3
  586. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  587. package/dist/sdk/query/search/corpus.d.ts +15 -15
  588. package/dist/sdk/query/search/filters.d.ts +15 -15
  589. package/dist/sdk/query/search/input.d.ts +8 -8
  590. package/dist/sdk/query/search/lexical.d.ts +10 -10
  591. package/dist/sdk/query/search/response.d.ts +22 -22
  592. package/dist/sdk/query/search/semantic.d.ts +133 -133
  593. package/dist/sdk/query/search/types.d.ts +65 -65
  594. package/dist/sdk/query/search-contracts.d.ts +53 -53
  595. package/dist/sdk/query/search-pagination.d.ts +21 -21
  596. package/dist/sdk/query/search-rendering.d.ts +30 -30
  597. package/dist/sdk/query/search.d.ts +60 -60
  598. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  599. package/dist/sdk/query.d.ts +6 -6
  600. package/dist/sdk/read-output/continuation.d.ts +11 -11
  601. package/dist/sdk/read-output/extension.d.ts +3 -3
  602. package/dist/sdk/read-output/options.d.ts +7 -7
  603. package/dist/sdk/read-output/provenance.d.ts +6 -6
  604. package/dist/sdk/read-output-budget.d.ts +11 -11
  605. package/dist/sdk/read-output-contracts.d.ts +112 -112
  606. package/dist/sdk/read-output-contracts.js +1 -1
  607. package/dist/sdk/read-output-rows.d.ts +15 -15
  608. package/dist/sdk/read-output-session.d.ts +29 -29
  609. package/dist/sdk/relationship-analytics.d.ts +46 -46
  610. package/dist/sdk/relationship-context.d.ts +48 -48
  611. package/dist/sdk/relationship-history.d.ts +59 -59
  612. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  613. package/dist/sdk/relationship-migration.d.ts +14 -14
  614. package/dist/sdk/relationships.d.ts +46 -46
  615. package/dist/sdk/reproducibility/process.d.ts +9 -9
  616. package/dist/sdk/runtime/actions.d.ts +1 -1
  617. package/dist/sdk/runtime/context.d.ts +15 -15
  618. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  619. package/dist/sdk/runtime/schema.d.ts +1 -1
  620. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  621. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  622. package/dist/sdk/runtime-input.d.ts +29 -29
  623. package/dist/sdk/runtime-primitives.d.ts +54 -52
  624. package/dist/sdk/runtime-primitives.js +1 -1
  625. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  626. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  627. package/dist/sdk/runtime.d.ts +374 -374
  628. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  629. package/dist/sdk/schema-migration.d.ts +79 -79
  630. package/dist/sdk/schema.d.ts +224 -224
  631. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  632. package/dist/sdk/similarity-scoring.d.ts +10 -10
  633. package/dist/sdk/similarity.d.ts +73 -73
  634. package/dist/sdk/start-task-status.d.ts +1 -1
  635. package/dist/sdk/stats.d.ts +72 -72
  636. package/dist/sdk/structured-mutations.d.ts +13 -13
  637. package/dist/sdk/telemetry-flush.d.ts +1 -1
  638. package/dist/sdk/telemetry.d.ts +32 -32
  639. package/dist/sdk/templates.d.ts +35 -35
  640. package/dist/sdk/test/batch.d.ts +50 -50
  641. package/dist/sdk/test/command-args.d.ts +2 -2
  642. package/dist/sdk/test/entry.d.ts +4 -4
  643. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  644. package/dist/sdk/test/execution.d.ts +247 -247
  645. package/dist/sdk/test/json-path.d.ts +4 -4
  646. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  647. package/dist/sdk/test/measurements.d.ts +10 -10
  648. package/dist/sdk/test/parsers.d.ts +18 -18
  649. package/dist/sdk/test/prerequisites.d.ts +3 -3
  650. package/dist/sdk/test/runs.d.ts +43 -43
  651. package/dist/sdk/test/trust.d.ts +15 -15
  652. package/dist/sdk/test/update.d.ts +23 -23
  653. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  654. package/dist/sdk/testing.d.ts +250 -246
  655. package/dist/sdk/testing.js +2 -2
  656. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  657. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  658. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  659. package/dist/sdk/workspace-contracts.d.ts +20 -20
  660. package/dist/sdk/workspace-memory.d.ts +42 -42
  661. package/dist/sdk/workspace-recipe.d.ts +9 -9
  662. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  663. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  664. package/dist/sdk/workspace-transaction.d.ts +26 -26
  665. package/dist/sdk/workspace.d.ts +9 -9
  666. package/dist/types.d.ts +540 -540
  667. package/docs/COMMANDS.md +11 -2
  668. package/docs/CONFIGURATION.md +43 -0
  669. package/docs/DEFECT_RECURRENCE.md +8 -0
  670. package/docs/EXTENSIONS.md +1 -1
  671. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +33 -0
  672. package/docs/LINKED_TEST_EDITS.md +15 -0
  673. package/docs/MERGE_SAFETY.md +8 -0
  674. package/docs/RELEASING.md +2 -0
  675. package/docs/SDK.md +19 -0
  676. package/docs/TESTING.md +21 -1
  677. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
  678. package/marketplace.json +1 -1
  679. package/package.json +3 -1
  680. package/packages/pm-beads/package.json +1 -1
  681. package/packages/pm-calendar/package.json +1 -1
  682. package/packages/pm-command-kit/package.json +1 -1
  683. package/packages/pm-digital-twin/package.json +1 -1
  684. package/packages/pm-governance-audit/package.json +1 -1
  685. package/packages/pm-guide-shell/package.json +1 -1
  686. package/packages/pm-kanban/package.json +1 -1
  687. package/packages/pm-lifecycle-hooks/package.json +1 -1
  688. package/packages/pm-linked-test-adapters/package.json +1 -1
  689. package/packages/pm-search-advanced/package.json +1 -1
  690. package/packages/pm-templates/package.json +1 -1
  691. package/packages/pm-todos/package.json +1 -1
  692. package/packages/pm-vcs/package.json +1 -1
  693. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  694. package/plugins/pm-claude/package.json +1 -1
  695. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  696. package/plugins/pm-codex/package.json +1 -1
  697. package/plugins/pm-codex/plugin.json +1 -1
  698. package/runtime-dependencies.json +1 -1
  699. package/scripts/finalize-build.mjs +9 -3
  700. package/dist/cli-bundle/chunks/chunk-DJDRHJBP.js +0 -234
  701. package/dist/cli-bundle/chunks/chunk-DUK5DHI6.js +0 -8
  702. package/dist/cli-bundle/chunks/chunk-IFPJDJUM.js +0 -20
  703. package/dist/cli-bundle/chunks/chunk-RL45OYTL.js +0 -6
  704. package/dist/cli-bundle/chunks/chunk-WYZGZV2M.js +0 -2
  705. package/dist/cli-bundle/focused-chunks/chunk-F5J3ATMV.js +0 -165
  706. package/dist/cli-bundle/focused-chunks/chunk-IOTNG6CN.js +0 -2
  707. package/dist/cli-bundle/focused-chunks/chunk-S6ITXQ5T.js +0 -20
  708. package/dist/cli-bundle/focused-chunks/chunk-UPJA45K7.js +0 -26
@@ -2,75 +2,75 @@ import { type PmCommandPositionalContract } from "../cli-contracts/grammar-contr
2
2
  /** Shared executable shape for a refusal that must not mutate tracker state. */
3
3
  export interface PmGrammarRefusalContract {
4
4
  /** Stable probe identity used by ratchets and evidence. */
5
- probe_id: string;
5
+ probe_id:string;
6
6
  /** Canonical command path under test. */
7
- command: string;
7
+ command:string;
8
8
  /** Exact argv expected to refuse. */
9
- refusal_args: readonly string[];
9
+ refusal_args:readonly string[];
10
10
  /** Exact help argv that must execute successfully after the refusal. */
11
- recovery_args: readonly string[];
11
+ recovery_args:readonly string[];
12
12
  /** Stable problem-envelope code expected from the refusal. */
13
- error_code: "invalid_argument_value" | "missing_lifecycle_target" | "missing_required_argument" | "unknown_subcommand";
13
+ error_code:"invalid_argument_value" | "missing_lifecycle_target" | "missing_required_argument" | "unknown_subcommand";
14
14
  }
15
15
  /** One required positional omission derived from the grammar declaration. */
16
16
  export interface PmRequiredArgumentRefusalContract extends PmGrammarRefusalContract {
17
17
  /** Stable positional name deliberately omitted by the probe. */
18
- missing_argument: string;
18
+ missing_argument:string;
19
19
  /** Zero-based slot index in the command's declared positional signature. */
20
- missing_argument_index: number;
20
+ missing_argument_index:number;
21
21
  }
22
22
  /** One invalid action probe for a closed positional subcommand family. */
23
23
  export interface PmSubcommandRefusalContract extends PmGrammarRefusalContract {
24
24
  /** Invalid action token used to reach the refusal. */
25
- rejected_value: string;
25
+ rejected_value:string;
26
26
  /** Complete authoritative action domain expected in recovery. */
27
- allowed_values: readonly string[];
27
+ allowed_values:readonly string[];
28
28
  }
29
29
  /** Runtime evidence for one grammar-derived refusal probe. */
30
30
  export interface PmGrammarRefusalObservation {
31
31
  /** Probe identity matching a declared contract. */
32
- probe_id: string;
32
+ probe_id:string;
33
33
  /** Machine-readable code emitted by the refusal. */
34
- error_code: string;
34
+ error_code:string;
35
35
  /** Process exit code emitted by the refusal. */
36
- exit_code: number;
36
+ exit_code:number;
37
37
  /** Allowed values emitted for a closed action family. */
38
- allowed_values: readonly string[];
38
+ allowed_values:readonly string[];
39
39
  /** Whether the advertised help recovery exited successfully. */
40
- recovery_succeeded: boolean;
40
+ recovery_succeeded:boolean;
41
41
  /** Whether any tracker state changed while executing the refusal. */
42
- refusal_mutated_state: boolean;
42
+ refusal_mutated_state:boolean;
43
43
  /** Repository-relative tracker paths changed by the refusal, when measured. */
44
- mutated_paths?: readonly string[];
44
+ mutated_paths?:readonly string[];
45
45
  }
46
46
  /** Stable reason a grammar-derived refusal failed closure. */
47
47
  export type PmGrammarRefusalFindingCode = "refusal_allowed_values_mismatch" | "refusal_error_code_mismatch" | "refusal_exit_code_mismatch" | "refusal_mutated_state" | "refusal_probe_missing" | "refusal_recovery_failed" | "unexpected_refusal_probe";
48
48
  /** One actionable grammar-derived refusal closure failure. */
49
49
  export interface PmGrammarRefusalFinding {
50
50
  /** Stable machine-readable failure category. */
51
- code: PmGrammarRefusalFindingCode;
51
+ code:PmGrammarRefusalFindingCode;
52
52
  /** Probe associated with the finding. */
53
- probe_id: string;
53
+ probe_id:string;
54
54
  /** Human-readable failure detail. */
55
- detail: string;
55
+ detail:string;
56
56
  }
57
57
  /** Aggregate closure receipt for the grammar-derived refusal corpus. */
58
58
  export interface PmGrammarRefusalClosureReport {
59
59
  /** Whether every declared probe refused safely and recovered. */
60
- ok: boolean;
60
+ ok:boolean;
61
61
  /** Number of declared probes. */
62
- probe_count: number;
62
+ probe_count:number;
63
63
  /** Number of probes without findings. */
64
- closed_probe_count: number;
64
+ closed_probe_count:number;
65
65
  /** Stable actionable failures. */
66
- findings: PmGrammarRefusalFinding[];
66
+ findings:PmGrammarRefusalFinding[];
67
67
  }
68
68
  /**
69
69
  * Return one omission probe for every required slot in the declared grammar.
70
70
  * Earlier positionals receive deterministic, non-mutating placeholder values.
71
71
  */
72
- export declare function listPmRequiredArgumentRefusalContracts(contracts?: readonly PmCommandPositionalContract[]): PmRequiredArgumentRefusalContract[];
72
+ export declare function listPmRequiredArgumentRefusalContracts(contracts?:readonly PmCommandPositionalContract[]):PmRequiredArgumentRefusalContract[];
73
73
  /** Return one invalid-action probe for every required positional action family. */
74
- export declare function listPmSubcommandRefusalContracts(contracts?: readonly PmCommandPositionalContract[]): PmSubcommandRefusalContract[];
74
+ export declare function listPmSubcommandRefusalContracts(contracts?:readonly PmCommandPositionalContract[]):PmSubcommandRefusalContract[];
75
75
  /** Score exact code, exit, domain, state-safety, and recovery closure. */
76
- export declare function scorePmGrammarRefusalClosure(contracts: readonly (PmRequiredArgumentRefusalContract | PmSubcommandRefusalContract)[], observations: readonly PmGrammarRefusalObservation[]): PmGrammarRefusalClosureReport;
76
+ export declare function scorePmGrammarRefusalClosure(contracts:readonly (PmRequiredArgumentRefusalContract | PmSubcommandRefusalContract)[],observations:readonly PmGrammarRefusalObservation[]):PmGrammarRefusalClosureReport;
@@ -1,175 +1,175 @@
1
- import type { PmErrorCodeContract, PmErrorCodeClass } from "../error-code-catalog.js";
1
+ import type { PmErrorCodeContract,PmErrorCodeClass } from "../error-code-catalog.js";
2
2
  /** One recorded result from driving a real public entrypoint into a refusal. */
3
3
  export interface PmRefusalProbeObservation {
4
4
  /** Stable probe identifier from the owning error-code contract. */
5
- probe_id: string;
5
+ probe_id:string;
6
6
  /** Public command entrypoint exercised by the probe. */
7
- entrypoint: string;
7
+ entrypoint:string;
8
8
  /** Machine-readable code observed at the transport boundary. */
9
- code: string;
9
+ code:string;
10
10
  /** Semantic exit class observed at the transport boundary. */
11
- exit_class: PmErrorCodeClass;
11
+ exit_class:PmErrorCodeClass;
12
12
  }
13
13
  /** One actionable conformance failure. */
14
14
  export interface PmRefusalReachabilityFinding {
15
15
  /** Stable finding kind for automation. */
16
- kind: "duplicate_probe" | "missing_probe" | "wrong_entrypoint" | "wrong_error_code" | "wrong_exit_class" | "undeclared_probe";
16
+ kind:"duplicate_probe" | "missing_probe" | "wrong_entrypoint" | "wrong_error_code" | "wrong_exit_class" | "undeclared_probe";
17
17
  /** Probe whose declaration or observation failed. */
18
- probe_id: string;
18
+ probe_id:string;
19
19
  /** Human-readable mismatch summary. */
20
- detail: string;
20
+ detail:string;
21
21
  }
22
22
  /** Complete refusal-reachability conformance receipt. */
23
23
  export interface PmRefusalReachabilityReport {
24
24
  /** Whether every declaration and observation agreed. */
25
- ok: boolean;
25
+ ok:boolean;
26
26
  /** Number of declared probes evaluated. */
27
- declared_probe_count: number;
27
+ declared_probe_count:number;
28
28
  /** Number of real-entrypoint observations supplied. */
29
- observed_probe_count: number;
29
+ observed_probe_count:number;
30
30
  /** Stable, sorted conformance findings. */
31
- findings: PmRefusalReachabilityFinding[];
31
+ findings:PmRefusalReachabilityFinding[];
32
32
  }
33
33
  /** Recovery-reference kinds emitted by structured refusal envelopes. */
34
- export declare const PM_RECOVERY_REFERENCE_KINDS: readonly ["suggested_retry", "candidate_command", "example", "next_step", "migration_hint", "restore_with"];
34
+ export declare const PM_RECOVERY_REFERENCE_KINDS:readonly ["suggested_retry","candidate_command","example","next_step","migration_hint","restore_with"];
35
35
  /** Recovery-reference kind emitted by a refusal. */
36
36
  export type PmRecoveryReferenceKind = (typeof PM_RECOVERY_REFERENCE_KINDS)[number];
37
37
  /** Behavioral promise attached to a recovery reference. */
38
38
  export type PmRecoveryReferenceSemantics = "recovery" | "replacement" | "behavior_preserving";
39
39
  /** Literal envelope fields recognized as recovery-reference producers. */
40
- export declare const PM_RECOVERY_REFERENCE_FIELDS: readonly ("suggested_retry" | "restore_with" | "next_best_command" | "candidate_commands" | "next_steps" | "examples" | "migration_hint" | "migration_hints" | "fallback_candidates" | "suggested_next_steps" | "example" | "candidate_command" | "next_step" | "retry_command")[];
40
+ export declare const PM_RECOVERY_REFERENCE_FIELDS:readonly ("suggested_retry" | "restore_with" | "next_best_command" | "candidate_commands" | "next_steps" | "examples" | "migration_hint" | "migration_hints" | "fallback_candidates" | "suggested_next_steps" | "example" | "candidate_command" | "next_step" | "retry_command")[];
41
41
  /** One source file supplied to the producer-census analyzer. */
42
42
  export interface PmRecoveryProducerSource {
43
43
  /** Repository-relative source path. */
44
- path: string;
44
+ path:string;
45
45
  /** Complete source text. */
46
- content: string;
46
+ content:string;
47
47
  }
48
48
  /** One literal recovery field emitted from a source location. */
49
49
  export interface PmRecoveryProducerLocation {
50
50
  /** Repository-relative producer source path. */
51
- path: string;
51
+ path:string;
52
52
  /** One-based source line. */
53
- line: number;
53
+ line:number;
54
54
  /** Literal structured-envelope field. */
55
- field: (typeof PM_RECOVERY_REFERENCE_FIELDS)[number];
55
+ field:(typeof PM_RECOVERY_REFERENCE_FIELDS)[number];
56
56
  /** Normalized recovery kind. */
57
- kind: PmRecoveryReferenceKind;
57
+ kind:PmRecoveryReferenceKind;
58
58
  }
59
59
  /** Producer-census failure that requires a new field contract or producer. */
60
60
  export interface PmRecoveryProducerCensusFinding {
61
61
  /** Stable finding kind. */
62
- kind: "invalid_source" | "missing_kind_producer" | "unknown_recovery_field";
62
+ kind:"invalid_source" | "missing_kind_producer" | "unknown_recovery_field";
63
63
  /** Source path or normalized kind. */
64
- subject: string;
64
+ subject:string;
65
65
  /** Actionable explanation. */
66
- detail: string;
66
+ detail:string;
67
67
  }
68
68
  /** Complete literal producer-table census for recovery references. */
69
69
  export interface PmRecoveryProducerCensusReport {
70
70
  /** Whether every recovery kind has a producer and no unknown fields exist. */
71
- ok: boolean;
71
+ ok:boolean;
72
72
  /** Source files inspected. */
73
- scanned_file_count: number;
73
+ scanned_file_count:number;
74
74
  /** Literal producer locations. */
75
- producer_count: number;
75
+ producer_count:number;
76
76
  /** Stable counts by normalized recovery kind. */
77
- producer_count_by_kind: Record<PmRecoveryReferenceKind, number>;
77
+ producer_count_by_kind:Record<PmRecoveryReferenceKind,number>;
78
78
  /** Stable producer locations. */
79
- producers: PmRecoveryProducerLocation[];
79
+ producers:PmRecoveryProducerLocation[];
80
80
  /** Missing-kind or unknown-field findings. */
81
- findings: PmRecoveryProducerCensusFinding[];
81
+ findings:PmRecoveryProducerCensusFinding[];
82
82
  }
83
83
  /** One derived promise that another invocation or command path is reachable. */
84
84
  export interface PmRecoveryReferenceObligation {
85
85
  /** Stable reference identifier derived from its emitting envelope. */
86
- id: string;
86
+ id:string;
87
87
  /** Refusal probe that emitted the reference. */
88
- probe_id: string;
88
+ probe_id:string;
89
89
  /** Typed recovery vocabulary rather than prose inference. */
90
- kind: PmRecoveryReferenceKind;
90
+ kind:PmRecoveryReferenceKind;
91
91
  /** Whether the reference recovers, replaces, or preserves the original behavior. */
92
- semantics: PmRecoveryReferenceSemantics;
92
+ semantics:PmRecoveryReferenceSemantics;
93
93
  /** Exact emitted command or recovery text. */
94
- value: string;
94
+ value:string;
95
95
  }
96
96
  /** Result of executing or resolving one derived recovery obligation. */
97
97
  export interface PmRecoveryReferenceObservation {
98
98
  /** Stable obligation identifier. */
99
- id: string;
99
+ id:string;
100
100
  /** Whether the promised recovery or command path was reachable. */
101
- reachable: boolean;
101
+ reachable:boolean;
102
102
  /** How the promise was discharged. */
103
- proof: "executed" | "declared_command_path" | "linked_execution";
103
+ proof:"executed" | "declared_command_path" | "linked_execution";
104
104
  /** Semantics actually demonstrated by the proof. */
105
- semantics: PmRecoveryReferenceSemantics;
105
+ semantics:PmRecoveryReferenceSemantics;
106
106
  }
107
107
  /** Coverage totals for one emitted recovery-reference kind. */
108
108
  export interface PmRecoveryReferenceKindCoverage {
109
109
  /** Typed reference kind. */
110
- kind: PmRecoveryReferenceKind;
110
+ kind:PmRecoveryReferenceKind;
111
111
  /** Derived obligations of this kind. */
112
- declared: number;
112
+ declared:number;
113
113
  /** Obligations with one observation. */
114
- observed: number;
114
+ observed:number;
115
115
  /** Obligations proven reachable. */
116
- passed: number;
116
+ passed:number;
117
117
  }
118
118
  /** One recovery-reference coverage failure. */
119
119
  export interface PmRecoveryReferenceFinding {
120
120
  /** Stable finding kind for assurance and CI. */
121
- kind: "duplicate_obligation" | "duplicate_observation" | "missing_observation" | "unreachable_reference" | "wrong_semantics" | "undeclared_observation";
121
+ kind:"duplicate_obligation" | "duplicate_observation" | "missing_observation" | "unreachable_reference" | "wrong_semantics" | "undeclared_observation";
122
122
  /** Obligation or observation identifier. */
123
- reference_id: string;
123
+ reference_id:string;
124
124
  /** Human-readable mismatch summary. */
125
- detail: string;
125
+ detail:string;
126
126
  }
127
127
  /** Complete cross-kind recovery-reference coverage receipt. */
128
128
  export interface PmRecoveryReferenceReport {
129
129
  /** Whether every derived reference was uniquely proven reachable. */
130
- ok: boolean;
130
+ ok:boolean;
131
131
  /** Total references derived from real refusal envelopes. */
132
- declared_reference_count: number;
132
+ declared_reference_count:number;
133
133
  /** Total reference observations supplied. */
134
- observed_reference_count: number;
134
+ observed_reference_count:number;
135
135
  /** Reachable fraction across the declared obligation set. */
136
- pass_fraction: number;
136
+ pass_fraction:number;
137
137
  /** Stable coverage buckets, including zero-population kinds. */
138
- coverage_by_kind: PmRecoveryReferenceKindCoverage[];
138
+ coverage_by_kind:PmRecoveryReferenceKindCoverage[];
139
139
  /** Stable, sorted conformance findings. */
140
- findings: PmRecoveryReferenceFinding[];
140
+ findings:PmRecoveryReferenceFinding[];
141
141
  }
142
142
  /** Per-kind runtime evidence; counts do not claim one observation per source location. */
143
143
  export interface PmRecoveryProducerRuntimeCoverage {
144
144
  /** Typed recovery-reference kind. */
145
- kind: PmRecoveryReferenceKind;
145
+ kind:PmRecoveryReferenceKind;
146
146
  /** Literal source producers discovered for the kind. */
147
- source_producers: number;
147
+ source_producers:number;
148
148
  /** Distinct runtime values observed for the kind. */
149
- runtime_values: number;
149
+ runtime_values:number;
150
150
  }
151
151
  /** Unified per-kind source-census and runtime-value coverage receipt. */
152
152
  export interface PmRecoveryProducerRuntimeReport {
153
153
  /** Whether every source-declared kind emitted at least one runtime value. */
154
- ok: boolean;
154
+ ok:boolean;
155
155
  /** Source producer denominator. */
156
- source_producer_count: number;
156
+ source_producer_count:number;
157
157
  /** Distinct runtime-value denominator. */
158
- runtime_value_count: number;
158
+ runtime_value_count:number;
159
159
  /** Stable per-kind source and runtime coverage. */
160
- coverage_by_kind: PmRecoveryProducerRuntimeCoverage[];
160
+ coverage_by_kind:PmRecoveryProducerRuntimeCoverage[];
161
161
  /** Kinds with source producers but no runtime evidence. */
162
- missing_runtime_kinds: PmRecoveryReferenceKind[];
162
+ missing_runtime_kinds:PmRecoveryReferenceKind[];
163
163
  }
164
164
  /** Census syntax-parsed structured-envelope producers without executing source code. */
165
- export declare function censusPmRecoveryReferenceProducers(sources: readonly PmRecoveryProducerSource[]): PmRecoveryProducerCensusReport;
165
+ export declare function censusPmRecoveryReferenceProducers(sources:readonly PmRecoveryProducerSource[]):PmRecoveryProducerCensusReport;
166
166
  /** Derive typed obligations from every recognized recovery field in an emitted envelope. */
167
- export declare function derivePmRecoveryReferenceObligations(probeId: string, envelope: unknown): PmRecoveryReferenceObligation[];
167
+ export declare function derivePmRecoveryReferenceObligations(probeId:string,envelope:unknown):PmRecoveryReferenceObligation[];
168
168
  /** Compare declared refusal states with real-entrypoint observations. */
169
- export declare function verifyPmRefusalReachability(catalog: readonly PmErrorCodeContract[], observations: readonly PmRefusalProbeObservation[]): PmRefusalReachabilityReport;
169
+ export declare function verifyPmRefusalReachability(catalog:readonly PmErrorCodeContract[],observations:readonly PmRefusalProbeObservation[]):PmRefusalReachabilityReport;
170
170
  /** Verify executable and declared-path proof for emitted recovery references. */
171
- export declare function verifyPmRecoveryReferences(obligations: readonly PmRecoveryReferenceObligation[], observations: readonly PmRecoveryReferenceObservation[]): PmRecoveryReferenceReport;
171
+ export declare function verifyPmRecoveryReferences(obligations:readonly PmRecoveryReferenceObligation[],observations:readonly PmRecoveryReferenceObservation[]):PmRecoveryReferenceReport;
172
172
  /** Join source-census counts to distinct emitted runtime values by typed kind. */
173
- export declare function verifyPmRecoveryProducerRuntimeCoverage(census: PmRecoveryProducerCensusReport, obligations: readonly PmRecoveryReferenceObligation[]): PmRecoveryProducerRuntimeReport;
173
+ export declare function verifyPmRecoveryProducerRuntimeCoverage(census:PmRecoveryProducerCensusReport,obligations:readonly PmRecoveryReferenceObligation[]):PmRecoveryProducerRuntimeReport;
174
174
  /** Honest kind-level name for the compatibility implementation above. */
175
- export declare const verifyPmRecoveryKindRuntimeCoverage: typeof verifyPmRecoveryProducerRuntimeCoverage;
175
+ export declare const verifyPmRecoveryKindRuntimeCoverage:typeof verifyPmRecoveryProducerRuntimeCoverage;
@@ -1,40 +1,40 @@
1
- import { PmCliError, type PmCliErrorRecoveryPayload } from "../../core/shared/errors.js";
1
+ import { PmCliError,type PmCliErrorRecoveryPayload } from "../../core/shared/errors.js";
2
2
  /** Catalog-only alias retained for consumers of the former package lifecycle code. */
3
- export declare const UNKNOWN_SUBCOMMAND_COMPATIBILITY_CODES: readonly [{
4
- readonly code: "unknown_lifecycle_action";
3
+ export declare const UNKNOWN_SUBCOMMAND_COMPATIBILITY_CODES:readonly [{
4
+ readonly code:"unknown_lifecycle_action";
5
5
  }];
6
6
  /** Inputs for constructing a portable unknown-subcommand refusal. */
7
7
  export interface UnknownSubcommandErrorOptions {
8
8
  /** Command family path without the rejected token. */
9
- command_path: string;
9
+ command_path:string;
10
10
  /** Rejected positional token. */
11
- token: string;
11
+ token:string;
12
12
  /** Complete declared subcommand vocabulary for the family. */
13
- allowed: readonly string[];
13
+ allowed:readonly string[];
14
14
  /** Human-readable command family, defaulting to `pm <command_path>`. */
15
- display_name?: string;
15
+ display_name?:string;
16
16
  /** Positional token role used in the compatibility message. */
17
- token_kind?: "subcommand" | "action" | "path";
17
+ token_kind?:"subcommand" | "action" | "path";
18
18
  /** Arguments that follow the rejected token and should survive a retry. */
19
- trailing_args?: readonly string[];
19
+ trailing_args?:readonly string[];
20
20
  /** Family-aware retry that takes precedence over edit-distance recovery. */
21
- retry_command?: string;
21
+ retry_command?:string;
22
22
  /** Compatibility suffix appended after the allowed-value sentence. */
23
- message_suffix?: string;
23
+ message_suffix?:string;
24
24
  /** Additional ranked recovery candidates supplied by the command family. */
25
- fallback_candidates?: PmCliErrorRecoveryPayload["fallback_candidates"];
25
+ fallback_candidates?:PmCliErrorRecoveryPayload["fallback_candidates"];
26
26
  /** Transport exit used by non-CLI protocol adapters. */
27
- exit_code?: number;
27
+ exit_code?:number;
28
28
  /** Additional family-specific examples. */
29
- examples?: readonly string[];
29
+ examples?:readonly string[];
30
30
  }
31
- declare function nearestSubcommand(token: string, allowed: readonly string[]): string | undefined;
32
- declare function renderCommand(tokens: readonly string[]): string;
31
+ declare function nearestSubcommand(token:string,allowed:readonly string[]):string | undefined;
32
+ declare function renderCommand(tokens:readonly string[]):string;
33
33
  /** Build the shared typed refusal used by CLI, SDK, MCP, and packages. */
34
- export declare function createUnknownSubcommandError(options: UnknownSubcommandErrorOptions): PmCliError;
34
+ export declare function createUnknownSubcommandError(options:UnknownSubcommandErrorOptions):PmCliError;
35
35
  /** Test-only access to deterministic nearest-match behavior. */
36
- export declare const _testOnly: {
37
- nearestSubcommand: typeof nearestSubcommand;
38
- renderCommand: typeof renderCommand;
36
+ export declare const _testOnly:{
37
+ nearestSubcommand:typeof nearestSubcommand;
38
+ renderCommand:typeof renderCommand;
39
39
  };
40
40
  export {};
@@ -1,8 +1,8 @@
1
1
  import { type PmOutputEnvelopeKind } from "../output-contracts.js";
2
2
  /** Stable schema version for replayable agent-task transcript corpora. */
3
- export declare const PM_AGENT_TASK_TRANSCRIPT_VERSION: 2;
3
+ export declare const PM_AGENT_TASK_TRANSCRIPT_VERSION:2;
4
4
  /** Supported strategies for measuring one transcript step's output cost. */
5
- export declare const PM_AGENT_TASK_ACCOUNTING_MODES: readonly ["self_reported", "independent_transport"];
5
+ export declare const PM_AGENT_TASK_ACCOUNTING_MODES:readonly ["self_reported","independent_transport"];
6
6
  /** Token-accounting strategy a replayed transcript step must preserve. */
7
7
  export type PmAgentTaskAccountingMode = (typeof PM_AGENT_TASK_ACCOUNTING_MODES)[number];
8
8
  /** Scalar value that a replayed transcript must observe at one output path. */
@@ -12,41 +12,41 @@ export type PmAgentTaskStepOutputKind = PmOutputEnvelopeKind | "refusal";
12
12
  /** Declares one real CLI invocation within a replayable agent task. */
13
13
  export interface PmAgentTaskTranscriptStep {
14
14
  /** Stable step identifier unique within its task. */
15
- id: string;
15
+ id:string;
16
16
  /** Shell-free CLI arguments, excluding the pm executable, preserved exactly. */
17
- args: readonly string[];
17
+ args:readonly string[];
18
18
  /** Process status required for the step to satisfy the transcript. */
19
- expected_exit_code: number;
19
+ expected_exit_code:number;
20
20
  /** Semantic output family required from the transport. */
21
- expected_output_kind: PmAgentTaskStepOutputKind;
21
+ expected_output_kind:PmAgentTaskStepOutputKind;
22
22
  /** Accounting strategy required from the measured transport. */
23
- expected_accounting_mode: PmAgentTaskAccountingMode;
23
+ expected_accounting_mode:PmAgentTaskAccountingMode;
24
24
  /** Dot-separated own-property paths proving required context was consumed. */
25
- required_fields: readonly string[];
25
+ required_fields:readonly string[];
26
26
  /** Exact terminal scalar values required at selected output paths. */
27
- expected_field_values?: Readonly<Record<string, PmAgentTaskExpectedFieldValue>>;
27
+ expected_field_values?:Readonly<Record<string,PmAgentTaskExpectedFieldValue>>;
28
28
  /** Stable diagnostic code required from a refusal step. */
29
- expected_error_code?: string;
29
+ expected_error_code?:string;
30
30
  /** Exact command or flag required in a refusal identity. */
31
- expected_refusal_surface?: string;
31
+ expected_refusal_surface?:string;
32
32
  /** Earlier refusal step whose recovery this successful step executes. */
33
- recovery_for?: string;
33
+ recovery_for?:string;
34
34
  }
35
35
  /** Versioned multi-step agent workflow suitable for deterministic replay. */
36
36
  export interface PmAgentTaskTranscript {
37
37
  /** Stable task identifier used by baselines and reports. */
38
- id: string;
38
+ id:string;
39
39
  /** Human-readable task outcome represented by the transcript. */
40
- description: string;
40
+ description:string;
41
41
  /** Ordered invocations whose shared workspace state completes the task. */
42
- steps: readonly PmAgentTaskTranscriptStep[];
42
+ steps:readonly PmAgentTaskTranscriptStep[];
43
43
  }
44
44
  /** Published collection of replayable agent workflows. */
45
45
  export interface PmAgentTaskTranscriptCorpus {
46
46
  /** Schema version governing every transcript in the corpus. */
47
- version: typeof PM_AGENT_TASK_TRANSCRIPT_VERSION;
47
+ version:typeof PM_AGENT_TASK_TRANSCRIPT_VERSION;
48
48
  /** Complete ordered task set evaluated by the release gate. */
49
- tasks: readonly PmAgentTaskTranscript[];
49
+ tasks:readonly PmAgentTaskTranscript[];
50
50
  }
51
51
  /** Parse and fail closed on malformed or internally inconsistent transcripts. */
52
- export declare function parsePmAgentTaskTranscriptCorpus(value: unknown): PmAgentTaskTranscriptCorpus;
52
+ export declare function parsePmAgentTaskTranscriptCorpus(value:unknown):PmAgentTaskTranscriptCorpus;
@@ -10,54 +10,54 @@ export type PmTrackerPreflightRecoveryKind = "initialize" | "select_directory" |
10
10
  /** Static refusal and recovery obligation for one tracker filesystem state. */
11
11
  export interface PmTrackerPreflightRecoveryContract {
12
12
  /** Stable probe identifier used by repository gates and evidence. */
13
- probe_id: string;
13
+ probe_id:string;
14
14
  /** Filesystem state created by the executable probe. */
15
- failure_kind: PmTrackerPreflightFailureKind;
15
+ failure_kind:PmTrackerPreflightFailureKind;
16
16
  /** Stable structured error code required from CLI and SDK transports. */
17
- expected_error_code: string;
17
+ expected_error_code:string;
18
18
  /** Process exit code required from the CLI transport. */
19
- expected_exit_code: 1 | 2 | 3;
19
+ expected_exit_code:1 | 2 | 3;
20
20
  /** Safe recovery behavior for this filesystem state. */
21
- recovery_kind: PmTrackerPreflightRecoveryKind;
21
+ recovery_kind:PmTrackerPreflightRecoveryKind;
22
22
  }
23
23
  /** Runtime evidence captured from one executable tracker preflight probe. */
24
24
  export interface PmTrackerPreflightRecoveryObservation {
25
25
  /** Stable probe identifier from the corresponding contract. */
26
- probe_id: string;
26
+ probe_id:string;
27
27
  /** Structured error code emitted by the refusal. */
28
- error_code: string;
28
+ error_code:string;
29
29
  /** Process exit code emitted by the refusal. */
30
- exit_code: number;
30
+ exit_code:number;
31
31
  /** Recovery behavior exercised by the probe driver. */
32
- recovery_kind: PmTrackerPreflightRecoveryKind;
32
+ recovery_kind:PmTrackerPreflightRecoveryKind;
33
33
  /** Tokenized retry emitted by the refusal, or an empty list when no deterministic retry is safe. */
34
- suggested_retry_args: string[];
34
+ suggested_retry_args:string[];
35
35
  /** Whether the emitted retry or safe alternate-root retry executed successfully. */
36
- retry_succeeded: boolean;
36
+ retry_succeeded:boolean;
37
37
  /** Whether a file-path refusal incorrectly recommended tracker initialization. */
38
- unsafe_init_recommended: boolean;
38
+ unsafe_init_recommended:boolean;
39
39
  }
40
40
  /** Actionable failure emitted by the tracker preflight closure scorer. */
41
41
  export interface PmTrackerPreflightRecoveryFinding {
42
42
  /** Stable finding code for automation and ratchets. */
43
- code: "missing_probe" | "error_code_mismatch" | "exit_code_mismatch" | "recovery_kind_mismatch" | "missing_init_recovery" | "unsafe_init_recovery" | "retry_failed";
43
+ code:"missing_probe" | "error_code_mismatch" | "exit_code_mismatch" | "recovery_kind_mismatch" | "missing_init_recovery" | "unsafe_init_recovery" | "retry_failed";
44
44
  /** Probe that failed its recovery obligation. */
45
- probe_id: string;
45
+ probe_id:string;
46
46
  /** Human-readable explanation of the failed obligation. */
47
- detail: string;
47
+ detail:string;
48
48
  }
49
49
  /** Aggregate executable-closure report for the tracker preflight corpus. */
50
50
  export interface PmTrackerPreflightRecoveryReport {
51
51
  /** Whether every declared probe met its refusal and recovery contract. */
52
- ok: boolean;
52
+ ok:boolean;
53
53
  /** Number of declared tracker preflight probes. */
54
- probe_count: number;
54
+ probe_count:number;
55
55
  /** Number of probes with no findings. */
56
- closed_probe_count: number;
56
+ closed_probe_count:number;
57
57
  /** Deterministically ordered failed obligations. */
58
- findings: PmTrackerPreflightRecoveryFinding[];
58
+ findings:PmTrackerPreflightRecoveryFinding[];
59
59
  }
60
60
  /** Return defensive copies of every core tracker preflight recovery contract. */
61
- export declare function listTrackerPreflightRecoveryContracts(): PmTrackerPreflightRecoveryContract[];
61
+ export declare function listTrackerPreflightRecoveryContracts():PmTrackerPreflightRecoveryContract[];
62
62
  /** Score runtime observations against the complete tracker preflight recovery corpus. */
63
- export declare function scoreTrackerPreflightRecoveryClosure(observations: readonly PmTrackerPreflightRecoveryObservation[]): PmTrackerPreflightRecoveryReport;
63
+ export declare function scoreTrackerPreflightRecoveryClosure(observations:readonly PmTrackerPreflightRecoveryObservation[]):PmTrackerPreflightRecoveryReport;