@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
@@ -1,101 +1,101 @@
1
1
  #!/usr/bin/env node
2
2
  import { type AgentClientInfo } from "../sdk/runtime-primitives.js";
3
- import { readRequiredString, type PmActionInput } from "../sdk/runtime.js";
4
- import { PmMcpProtocolError, resolveMcpRequestContext, type PmMcpRequestContext } from "../sdk/mcp/protocol.js";
3
+ import { readRequiredString,type PmActionInput } from "../sdk/runtime.js";
4
+ import { PmMcpProtocolError,resolveMcpRequestContext,type PmMcpRequestContext } from "../sdk/mcp/protocol.js";
5
5
  import { PmMcpInputRequiredError } from "../sdk/mcp/interactions.js";
6
- import { type PmMcpSubscriptionId, type PmMcpSubscriptionSink } from "../sdk/mcp/subscriptions.js";
6
+ import { type PmMcpSubscriptionId,type PmMcpSubscriptionSink } from "../sdk/mcp/subscriptions.js";
7
7
  /** JSON-RPC request shape accepted by pm MCP transport adapters. */
8
8
  export interface JsonRpcRequest {
9
9
  /** JSON-RPC revision marker when supplied by the transport. */
10
- jsonrpc?: string;
10
+ jsonrpc?:string;
11
11
  /** Correlation identifier omitted only for notifications. */
12
- id?: string | number | null;
12
+ id?:string | number | null;
13
13
  /** Protocol operation selected by the caller. */
14
- method?: string;
14
+ method?:string;
15
15
  /** Operation inputs including request-local MCP metadata. */
16
- params?: Record<string, unknown>;
16
+ params?:Record<string,unknown>;
17
17
  }
18
- declare function runMcpAction(args: PmActionInput): Promise<unknown>;
18
+ declare function runMcpAction(args:PmActionInput):Promise<unknown>;
19
19
  type PmMcpTransportSubscriptionKey = PmMcpSubscriptionId | symbol;
20
- declare function nearestDeclaredKey(unexpected: string, declared: string[]): string | undefined;
21
- declare function detectUnexpectedTopLevelKeys(toolName: string, args: Record<string, unknown>, toolDeclaredKeys?: Map<string, string[]>): string[];
20
+ declare function nearestDeclaredKey(unexpected:string,declared:string[]):string | undefined;
21
+ declare function detectUnexpectedTopLevelKeys(toolName:string,args:Record<string,unknown>,toolDeclaredKeys?:Map<string,string[]>):string[];
22
22
  /**
23
23
  * Enforce workspace mutation policy before MCP dispatch, excluding top-level
24
24
  * routing paths. Return redacted advisories; propagate blocking guard failures.
25
25
  */
26
- declare function collectMutationGuardWarnings(toolName: string, action: string | undefined, args: Record<string, unknown>): Promise<string[]>;
27
- declare function detectUnexpectedOptionKeys(toolName: string, action: string | undefined, args: Record<string, unknown>): string[];
28
- declare function resultContent(result: unknown, warnings?: string[], tokenAccounting?: boolean, canonicalStructuredResult?: boolean): Record<string, unknown>;
29
- declare function errorContent(error: unknown, canonicalStructuredResult?: boolean): Record<string, unknown>;
26
+ declare function collectMutationGuardWarnings(toolName:string,action:string | undefined,args:Record<string,unknown>):Promise<string[]>;
27
+ declare function detectUnexpectedOptionKeys(toolName:string,action:string | undefined,args:Record<string,unknown>):string[];
28
+ declare function resultContent(result:unknown,warnings?:string[],tokenAccounting?:boolean,canonicalStructuredResult?:boolean):Record<string,unknown>;
29
+ declare function errorContent(error:unknown,canonicalStructuredResult?:boolean):Record<string,unknown>;
30
30
  /** Retain at most 32 own, valid provenance values without cloning unbounded input. */
31
- declare function boundMcpClientProvenance(value: unknown): Record<string, string>;
32
- declare function emitMcpChangeNotifications(action: string | undefined): Promise<void>;
31
+ declare function boundMcpClientProvenance(value:unknown):Record<string,string>;
32
+ declare function emitMcpChangeNotifications(action:string | undefined):Promise<void>;
33
33
  /** Open one modern subscription through a concrete transport-owned sink. */
34
- export declare function openMcpSubscription(input: {
35
- request: JsonRpcRequest;
36
- key?: PmMcpTransportSubscriptionKey;
37
- sink: PmMcpSubscriptionSink;
38
- }): Promise<void>;
34
+ export declare function openMcpSubscription(input:{
35
+ request:JsonRpcRequest;
36
+ key?:PmMcpTransportSubscriptionKey;
37
+ sink:PmMcpSubscriptionSink;
38
+ }):Promise<void>;
39
39
  /** Gracefully close one active subscription by its request identifier. */
40
- export declare function closeMcpSubscription(id: PmMcpSubscriptionId, key?: PmMcpTransportSubscriptionKey): Record<string, unknown> | undefined;
41
- declare function closeStdioMcpSubscriptions(): Array<{
42
- id: PmMcpSubscriptionId;
43
- result: Record<string, unknown>;
40
+ export declare function closeMcpSubscription(id:PmMcpSubscriptionId,key?:PmMcpTransportSubscriptionKey):Record<string,unknown> | undefined;
41
+ declare function closeStdioMcpSubscriptions():Array<{
42
+ id:PmMcpSubscriptionId;
43
+ result:Record<string,unknown>;
44
44
  }>;
45
45
  /** Resolve the current workspace-enriched tool schema for HTTP header checks. */
46
- export declare function resolveMcpToolSchemaForRequest(request: JsonRpcRequest): Promise<unknown>;
46
+ export declare function resolveMcpToolSchemaForRequest(request:JsonRpcRequest):Promise<unknown>;
47
47
  /** Preserve MCP tool-result error semantics for non-protocol adapter failures. */
48
- export declare function buildMcpToolCallErrorResult(request: JsonRpcRequest, error: unknown): Record<string, unknown> | undefined;
49
- declare function mcpTaskPrincipal(requestContext: PmMcpRequestContext): string;
50
- declare function shouldCreateMcpTask(params: Record<string, unknown> | undefined, requestContext: PmMcpRequestContext): boolean;
51
- declare function settleMcpTaskExecution(taskId: string, execution: Promise<void>): Promise<void>;
48
+ export declare function buildMcpToolCallErrorResult(request:JsonRpcRequest,error:unknown):Record<string,unknown> | undefined;
49
+ declare function mcpTaskPrincipal(requestContext:PmMcpRequestContext):string;
50
+ declare function shouldCreateMcpTask(params:Record<string,unknown> | undefined,requestContext:PmMcpRequestContext):boolean;
51
+ declare function settleMcpTaskExecution(taskId:string,execution:Promise<void>):Promise<void>;
52
52
  /** Dispatch one MCP request under supported process-level reproducibility settings. */
53
- export declare function handleRequest(request: JsonRpcRequest): Promise<Record<string, unknown> | undefined>;
54
- declare function writeError(id: JsonRpcRequest["id"], error: unknown): void;
53
+ export declare function handleRequest(request:JsonRpcRequest):Promise<Record<string,unknown> | undefined>;
54
+ declare function writeError(id:JsonRpcRequest["id"],error:unknown):void;
55
55
  /** Implements process rpc line for the public runtime surface of this module. */
56
- export declare function processRpcLine(line: string): Promise<void>;
56
+ export declare function processRpcLine(line:string):Promise<void>;
57
57
  /** Implements start mcp server for the public runtime surface of this module. */
58
- export declare function startMcpServer(): void;
58
+ export declare function startMcpServer():void;
59
59
  /** Implements check whether invoked as mcp main module for the public runtime surface of this module. */
60
- export declare function isInvokedAsMcpMainModule(argvPath: string | undefined, moduleUrl: string): boolean;
60
+ export declare function isInvokedAsMcpMainModule(argvPath:string | undefined,moduleUrl:string):boolean;
61
61
  /** Public contract for test only, shared by SDK and presentation-layer consumers. */
62
- export declare const _testOnly: {
63
- boundMcpClientProvenance: typeof boundMcpClientProvenance;
64
- createMcpInputRequiredError: (input: ConstructorParameters<typeof PmMcpInputRequiredError>[0]) => PmMcpInputRequiredError;
65
- createMcpProtocolError: (message: string, code: number, data?: Record<string, unknown> | undefined) => PmMcpProtocolError;
66
- readonly closeManyOptionsFromFlat: typeof import("../sdk/runtime-input.js").closeManyOptionsFromFlat;
67
- detectUnexpectedOptionKeys: typeof detectUnexpectedOptionKeys;
68
- detectUnexpectedTopLevelKeys: typeof detectUnexpectedTopLevelKeys;
69
- collectMutationGuardWarnings: typeof collectMutationGuardWarnings;
70
- closeStdioMcpSubscriptions: typeof closeStdioMcpSubscriptions;
71
- errorContent: typeof errorContent;
72
- emitMcpChangeNotifications: typeof emitMcpChangeNotifications;
73
- expireMcpSubscriptionRecord: (id: PmMcpSubscriptionId, key?: PmMcpTransportSubscriptionKey) => Record<string, unknown> | undefined;
74
- getMcpClientInfo: () => AgentClientInfo | undefined;
75
- readonly extensionOptionsFromArgs: typeof import("../sdk/runtime-input.js").extensionOptionsFromArgs;
76
- readonly globalOptions: typeof import("../sdk/runtime-input.js").actionGlobalOptions;
77
- readonly mutationListOptions: typeof import("../sdk/runtime-input.js").mutationListOptions;
78
- nearestDeclaredKey: typeof nearestDeclaredKey;
79
- mcpTaskPrincipal: typeof mcpTaskPrincipal;
80
- resultContent: typeof resultContent;
81
- resolveMcpRequestContext: typeof resolveMcpRequestContext;
82
- shouldCreateMcpTask: typeof shouldCreateMcpTask;
83
- settleMcpTaskExecution: typeof settleMcpTaskExecution;
84
- subscriptionCount: () => number;
85
- readonly normalizeActionName: typeof import("../sdk/runtime-input.js").normalizeActionName;
86
- readonly normalizeCommandPath: typeof import("../sdk/runtime-input.js").normalizeCommandPath;
87
- readonly normalizeMcpOptionsArrays: typeof import("../sdk/runtime-input.js").normalizeMcpOptionsArrays;
88
- readonly normalizeMcpUpdateOptions: typeof import("../sdk/runtime-input.js").normalizeMcpUpdateOptions;
89
- readonly optionsWithAuthor: typeof import("../sdk/runtime-input.js").optionsWithAuthor;
90
- readonly readRequiredString: typeof readRequiredString;
91
- readonly readScalarString: typeof import("../sdk/runtime-input.js").readRuntimeScalarString;
92
- readonly readScalarStringAllowBlank: typeof import("../sdk/runtime-input.js").readRuntimeScalarStringAllowBlank;
93
- readonly readStringArray: typeof import("../sdk/runtime-input.js").readRuntimeStringArray;
94
- runAction: typeof runMcpAction;
95
- readonly updateManyOptionsFromFlat: typeof import("../sdk/runtime-input.js").updateManyOptionsFromFlat;
96
- readonly withAddNoteOption: typeof import("../sdk/runtime-input.js").withAddNoteOption;
97
- readonly withFilesDiscoveryOptions: typeof import("../sdk/runtime-input.js").withFilesDiscoveryOptions;
98
- readonly withMutationCompaction: typeof import("../sdk/runtime-input.js").withMutationCompaction;
99
- writeError: typeof writeError;
62
+ export declare const _testOnly:{
63
+ boundMcpClientProvenance:typeof boundMcpClientProvenance;
64
+ createMcpInputRequiredError:(input:ConstructorParameters<typeof PmMcpInputRequiredError>[0]) => PmMcpInputRequiredError;
65
+ createMcpProtocolError:(message:string,code:number,data?:Record<string,unknown> | undefined) => PmMcpProtocolError;
66
+ readonly closeManyOptionsFromFlat:typeof import("../sdk/runtime-input.js").closeManyOptionsFromFlat;
67
+ detectUnexpectedOptionKeys:typeof detectUnexpectedOptionKeys;
68
+ detectUnexpectedTopLevelKeys:typeof detectUnexpectedTopLevelKeys;
69
+ collectMutationGuardWarnings:typeof collectMutationGuardWarnings;
70
+ closeStdioMcpSubscriptions:typeof closeStdioMcpSubscriptions;
71
+ errorContent:typeof errorContent;
72
+ emitMcpChangeNotifications:typeof emitMcpChangeNotifications;
73
+ expireMcpSubscriptionRecord:(id:PmMcpSubscriptionId,key?:PmMcpTransportSubscriptionKey) => Record<string,unknown> | undefined;
74
+ getMcpClientInfo:() => AgentClientInfo | undefined;
75
+ readonly extensionOptionsFromArgs:typeof import("../sdk/runtime-input.js").extensionOptionsFromArgs;
76
+ readonly globalOptions:typeof import("../sdk/runtime-input.js").actionGlobalOptions;
77
+ readonly mutationListOptions:typeof import("../sdk/runtime-input.js").mutationListOptions;
78
+ nearestDeclaredKey:typeof nearestDeclaredKey;
79
+ mcpTaskPrincipal:typeof mcpTaskPrincipal;
80
+ resultContent:typeof resultContent;
81
+ resolveMcpRequestContext:typeof resolveMcpRequestContext;
82
+ shouldCreateMcpTask:typeof shouldCreateMcpTask;
83
+ settleMcpTaskExecution:typeof settleMcpTaskExecution;
84
+ subscriptionCount:() => number;
85
+ readonly normalizeActionName:typeof import("../sdk/runtime-input.js").normalizeActionName;
86
+ readonly normalizeCommandPath:typeof import("../sdk/runtime-input.js").normalizeCommandPath;
87
+ readonly normalizeMcpOptionsArrays:typeof import("../sdk/runtime-input.js").normalizeMcpOptionsArrays;
88
+ readonly normalizeMcpUpdateOptions:typeof import("../sdk/runtime-input.js").normalizeMcpUpdateOptions;
89
+ readonly optionsWithAuthor:typeof import("../sdk/runtime-input.js").optionsWithAuthor;
90
+ readonly readRequiredString:typeof readRequiredString;
91
+ readonly readScalarString:typeof import("../sdk/runtime-input.js").readRuntimeScalarString;
92
+ readonly readScalarStringAllowBlank:typeof import("../sdk/runtime-input.js").readRuntimeScalarStringAllowBlank;
93
+ readonly readStringArray:typeof import("../sdk/runtime-input.js").readRuntimeStringArray;
94
+ runAction:typeof runMcpAction;
95
+ readonly updateManyOptionsFromFlat:typeof import("../sdk/runtime-input.js").updateManyOptionsFromFlat;
96
+ readonly withAddNoteOption:typeof import("../sdk/runtime-input.js").withAddNoteOption;
97
+ readonly withFilesDiscoveryOptions:typeof import("../sdk/runtime-input.js").withFilesDiscoveryOptions;
98
+ readonly withMutationCompaction:typeof import("../sdk/runtime-input.js").withMutationCompaction;
99
+ writeError:typeof writeError;
100
100
  };
101
101
  export {};
@@ -9,55 +9,55 @@ import type { PmToolAction } from "../sdk/cli-contracts/enum-contracts.js";
9
9
  */
10
10
  export interface ToolDefinition {
11
11
  /** Value that configures or reports name for this contract. */
12
- name: string;
12
+ name:string;
13
13
  /** Value that configures or reports description for this contract. */
14
- description: string;
14
+ description:string;
15
15
  /** Value that configures or reports input schema for this contract. */
16
- inputSchema: Record<string, unknown>;
16
+ inputSchema:Record<string,unknown>;
17
17
  /** Optional negotiated extension metadata projected during tools/list. */
18
- _meta?: Record<string, unknown>;
18
+ _meta?:Record<string,unknown>;
19
19
  }
20
20
  /** MCP transport parameters layered over every canonical action schema. */
21
- export declare const TOOL_SCHEMA_BASE: {
22
- readonly type: "object";
23
- readonly properties: {
24
- readonly cwd: {
25
- readonly type: "string";
26
- readonly description: "Workspace directory to run the native pm operation in. Defaults to the MCP server process cwd.";
21
+ export declare const TOOL_SCHEMA_BASE:{
22
+ readonly type:"object";
23
+ readonly properties:{
24
+ readonly cwd:{
25
+ readonly type:"string";
26
+ readonly description:"Workspace directory to run the native pm operation in. Defaults to the MCP server process cwd.";
27
27
  };
28
- readonly path: {
29
- readonly type: "string";
30
- readonly description: "Optional pm data root, equivalent to PM_PATH/global --path. Leave unset for real repository tracking.";
28
+ readonly path:{
29
+ readonly type:"string";
30
+ readonly description:"Optional pm data root, equivalent to PM_PATH/global --path. Leave unset for real repository tracking.";
31
31
  };
32
- readonly author: {
33
- readonly type: "string";
34
- readonly description: "Optional mutation author override. Otherwise pm uses PM_AUTHOR, project settings, or detected harness identity.";
32
+ readonly author:{
33
+ readonly type:"string";
34
+ readonly description:"Optional mutation author override. Otherwise pm uses PM_AUTHOR, project settings, or detected harness identity.";
35
35
  };
36
- readonly tokenAccounting: {
37
- readonly type: "boolean";
38
- readonly description: "Attach the same bounded per-section token-cost receipt emitted by CLI --token-accounting.";
36
+ readonly tokenAccounting:{
37
+ readonly type:"boolean";
38
+ readonly description:"Attach the same bounded per-section token-cost receipt emitted by CLI --token-accounting.";
39
39
  };
40
40
  };
41
- readonly additionalProperties: true;
41
+ readonly additionalProperties:true;
42
42
  };
43
43
  /** Canonical SDK action backing each dedicated MCP tool schema. */
44
- export declare const NARROW_TOOL_ACTIONS: Readonly<Record<string, PmToolAction>>;
44
+ export declare const NARROW_TOOL_ACTIONS:Readonly<Record<string,PmToolAction>>;
45
45
  /**
46
46
  * Public tool definitions. Narrow schemas are projected from canonical action
47
47
  * contracts, with tool-specific descriptions and convenience aliases layered
48
48
  * on top.
49
49
  */
50
- export declare const TOOLS: ToolDefinition[];
50
+ export declare const TOOLS:ToolDefinition[];
51
51
  /** Stable projection of one MCP tool definition for the contract golden file (pm-4os2): tool name, description, required top-level fields, and the full inputSchema shape. Any drift (typo'd property, dropped required field, changed TOOL_SCHEMA_BASE) shows up in `pnpm contracts:check`. */
52
52
  export interface McpToolContract {
53
53
  /** Value that configures or reports name for this contract. */
54
- name: string;
54
+ name:string;
55
55
  /** Value that configures or reports description for this contract. */
56
- description: string;
56
+ description:string;
57
57
  /** Value that configures or reports required for this contract. */
58
- required: string[];
58
+ required:string[];
59
59
  /** Value that configures or reports input schema for this contract. */
60
- input_schema: Record<string, unknown>;
60
+ input_schema:Record<string,unknown>;
61
61
  }
62
62
  /** Implements build mcp tool contracts for the public runtime surface of this module. */
63
- export declare function buildMcpToolContracts(): McpToolContract[];
63
+ export declare function buildMcpToolContracts():McpToolContract[];
@@ -7,4 +7,4 @@
7
7
  * blocker or ready-work classifications without storage or rendering side
8
8
  * effects.
9
9
  */
10
- export { ACTIONABILITY_ORDERING_KINDS, collectBlockedByIds, collectBlockedByIdsFromCorpus, collectDependencyBlockedIds, computeActionabilityReport, indexBlockedByIds, resolveItemBlockers, resolveItemExecutionRole, selectActionableEntries, type ActionabilitySelectionOptions, type ActionabilityReport, type ActionableEntry, type ResolvedBlocker, } from "../core/item/actionability.js";
10
+ export { ACTIONABILITY_ORDERING_KINDS,collectBlockedByIds,collectBlockedByIdsFromCorpus,collectDependencyBlockedIds,computeActionabilityReport,indexBlockedByIds,resolveItemBlockers,resolveItemExecutionRole,selectActionableEntries,type ActionabilitySelectionOptions,type ActionabilityReport,type ActionableEntry,type ResolvedBlocker,} from "../core/item/actionability.js";
@@ -1,25 +1,25 @@
1
1
  /** A closed-domain refusal that can be executed and recovered automatically. */
2
2
  export interface PmClosedDomainContract {
3
3
  /** Stable assurance identity. */
4
- probe_id: string;
4
+ probe_id:string;
5
5
  /** Public command accepting the constrained flag. */
6
- command: string;
6
+ command:string;
7
7
  /** Constrained option spelling. */
8
- flag: string;
8
+ flag:string;
9
9
  /** Invalid token used to prove the refusal path. */
10
- rejected_value: string;
10
+ rejected_value:string;
11
11
  /** Exact argv that must refuse the invalid token. */
12
- refusal_args: readonly string[];
12
+ refusal_args:readonly string[];
13
13
  /** Complete stable core domain accepted by the command. */
14
- allowed_values: readonly string[];
14
+ allowed_values:readonly string[];
15
15
  /** Exact argv expected in the refusal's executable recovery. */
16
- suggested_retry_args: readonly string[];
16
+ suggested_retry_args:readonly string[];
17
17
  /** Stable machine-readable error code that owns the refusal. */
18
- error_code: "package_upgrade_modes_mutually_exclusive" | "projection_options_mutually_exclusive" | "unknown_context_intent" | "unknown_field_projection";
18
+ error_code:"package_upgrade_modes_mutually_exclusive" | "projection_options_mutually_exclusive" | "unknown_context_intent" | "unknown_field_projection";
19
19
  /** Whether a complete accepted-value domain is required in the refusal. */
20
- allowed_values_required?: boolean;
20
+ allowed_values_required?:boolean;
21
21
  }
22
22
  /** Return the complete stable core refusal corpus shared by every public surface. */
23
- export declare function listCoreClosedDomainContracts(): PmClosedDomainContract[];
23
+ export declare function listCoreClosedDomainContracts():PmClosedDomainContract[];
24
24
  /** Render a compact but complete core-domain description for command help. */
25
- export declare function renderPmClosedDomainHelp(command: string, flag: "--fields" | "--for"): string;
25
+ export declare function renderPmClosedDomainHelp(command:string,flag:"--fields" | "--for"):string;
@@ -1,10 +1,10 @@
1
1
  /** Identify presentation intent that must not be silently dropped from an unknown-option retry. */
2
- export declare function isReadProjectionRecoveryFlag(flag: string): boolean;
2
+ export declare function isReadProjectionRecoveryFlag(flag:string):boolean;
3
3
  /** Keep lexical corrections within read projection or mutation receipt semantics. */
4
- export declare function isCompatibleRecoveryFlag(requested: string, candidate: string): boolean;
4
+ export declare function isCompatibleRecoveryFlag(requested:string,candidate:string):boolean;
5
5
  /** Resolve a recovery command without interpreting global option values as command tokens. */
6
- export declare function resolveRecoveryCommandName(invocationArgv: string[] | undefined): string | undefined;
6
+ export declare function resolveRecoveryCommandName(invocationArgv:string[] | undefined):string | undefined;
7
7
  /** Resolve the truthful placeholder for a missing flag from its contract. */
8
- export declare function resolveMissingOptionPlaceholder(commandName: string, missingLabel: string): string | null | undefined;
8
+ export declare function resolveMissingOptionPlaceholder(commandName:string,missingLabel:string):string | null | undefined;
9
9
  /** Preserve an attempted argv vector and insert each missing option before `--`. */
10
- export declare function renderMissingOptionRetry(invocationArgv: string[], commandName: string, missingLabels: string[]): string | undefined;
10
+ export declare function renderMissingOptionRetry(invocationArgv:string[],commandName:string,missingLabels:string[]):string | undefined;
@@ -1,12 +1,12 @@
1
1
  /** Resolve the longest exact misplaced suffix under registered namespaces only when one canonical command owns it. */
2
- export declare function resolveMisnestedCommandPath(unknownPath: string, availablePaths: readonly string[]): string | undefined;
2
+ export declare function resolveMisnestedCommandPath(unknownPath:string,availablePaths:readonly string[]):string | undefined;
3
3
  /** Score one command path for a guessed command token; lower is better. */
4
- export declare function scoreCommandPathMatch(commandPath: string, queryToken: string): number;
4
+ export declare function scoreCommandPathMatch(commandPath:string,queryToken:string):number;
5
5
  /** Rank available command paths for one guessed token. */
6
- export declare function rankCommandPaths(commandPaths: string[], queryToken: string): string[];
6
+ export declare function rankCommandPaths(commandPaths:string[],queryToken:string):string[];
7
7
  /**
8
8
  * Replace migration-only prefixes with installed canonical paths and required flags.
9
9
  * A query token prefers known semantic matches over weaker spelling guesses after
10
10
  * unavailable replacements have been removed.
11
11
  */
12
- export declare function canonicalizeCommandSuggestions(candidates: readonly string[], availablePaths: readonly string[], queryToken?: string): string[];
12
+ export declare function canonicalizeCommandSuggestions(candidates:readonly string[],availablePaths:readonly string[],queryToken?:string):string[];
@@ -7,6 +7,6 @@
7
7
  * truthful answer that the collection is intentionally empty.
8
8
  */
9
9
  /** Return the explicit-empty flag for a repeatable create option. */
10
- export declare function resolveCreateExplicitEmptyFlag(optionKey: string): string | undefined;
10
+ export declare function resolveCreateExplicitEmptyFlag(optionKey:string):string | undefined;
11
11
  /** Return whether a create option can be satisfied by an explicit empty set. */
12
- export declare function supportsCreateExplicitEmpty(optionKey: string): boolean;
12
+ export declare function supportsCreateExplicitEmpty(optionKey:string):boolean;
@@ -8,56 +8,56 @@
8
8
  /** Persisted legacy-author interpretation vocabulary. */
9
9
  export interface AgentIdentityVocabulary {
10
10
  /** Monotonic interpretation revision. */
11
- version: number;
11
+ version:number;
12
12
  /** Exact legacy author spelling to canonical harness namespace. */
13
- aliases: Record<string, string>;
13
+ aliases:Record<string,string>;
14
14
  }
15
15
  /** Privacy-safe vocabulary projection used by config get/list/export. */
16
16
  export interface AgentIdentityVocabularySummary {
17
17
  /** Current interpretation revision. */
18
- version: number;
18
+ version:number;
19
19
  /** Number of exact legacy spellings configured. */
20
- alias_count: number;
20
+ alias_count:number;
21
21
  }
22
22
  /** Supported vocabulary mutations. */
23
23
  export type AgentIdentityVocabularyOperation = "add" | "remove" | "clear";
24
24
  /** One typed vocabulary mutation and optional residual-coverage census. */
25
25
  export interface AgentIdentityVocabularyMutationInput {
26
26
  /** Exact operation applied to the vocabulary. */
27
- operation: AgentIdentityVocabularyOperation;
27
+ operation:AgentIdentityVocabularyOperation;
28
28
  /** Exact legacy spelling required by add/remove. */
29
- legacy_author?: string;
29
+ legacy_author?:string;
30
30
  /** Canonical lowercase harness namespace required by add. */
31
- canonical_harness?: string;
31
+ canonical_harness?:string;
32
32
  /** Optional bounded author census used only to count still-unmapped values. */
33
- observed_authors?: readonly string[];
33
+ observed_authors?:readonly string[];
34
34
  }
35
35
  /** Privacy-safe dry-run or committed mutation preview. */
36
36
  export interface AgentIdentityVocabularyMutationPreview {
37
37
  /** Operation that was evaluated. */
38
- operation: AgentIdentityVocabularyOperation;
38
+ operation:AgentIdentityVocabularyOperation;
39
39
  /** Whether persistence would change. */
40
- changed: boolean;
40
+ changed:boolean;
41
41
  /** Revision before the operation. */
42
- version_before: number;
42
+ version_before:number;
43
43
  /** Revision after the operation, equal when idempotent. */
44
- version_after: number;
44
+ version_after:number;
45
45
  /** Alias count after the operation. */
46
- alias_count: number;
46
+ alias_count:number;
47
47
  /** Unique non-canonical authors not covered after the operation. */
48
- residual_author_count: number;
48
+ residual_author_count:number;
49
49
  }
50
50
  /** Planned vocabulary plus a privacy-safe result preview. */
51
51
  export interface AgentIdentityVocabularyMutationPlan {
52
52
  /** Complete value suitable for settings persistence. */
53
- vocabulary: AgentIdentityVocabulary;
53
+ vocabulary:AgentIdentityVocabulary;
54
54
  /** Public mutation result with no alias spellings. */
55
- preview: AgentIdentityVocabularyMutationPreview;
55
+ preview:AgentIdentityVocabularyMutationPreview;
56
56
  }
57
57
  /** Return only the revision and count suitable for config discovery surfaces. */
58
- export declare function summarizeAgentIdentityVocabulary(vocabulary: AgentIdentityVocabulary | undefined): AgentIdentityVocabularySummary;
58
+ export declare function summarizeAgentIdentityVocabulary(vocabulary:AgentIdentityVocabulary | undefined):AgentIdentityVocabularySummary;
59
59
  /**
60
60
  * Validate and plan one exact mutation. A real change increments the revision
61
61
  * exactly once; identical adds and absent removes are idempotent.
62
62
  */
63
- export declare function planAgentIdentityVocabularyMutation(current: AgentIdentityVocabulary | undefined, input: AgentIdentityVocabularyMutationInput): AgentIdentityVocabularyMutationPlan;
63
+ export declare function planAgentIdentityVocabularyMutation(current:AgentIdentityVocabulary | undefined,input:AgentIdentityVocabularyMutationInput):AgentIdentityVocabularyMutationPlan;
@@ -1,19 +1,19 @@
1
1
  /** Result of normalizing one item-addressed invocation. */
2
2
  export interface ItemAddressInvocationResult {
3
3
  /** Canonical argv with an `--id` value moved into positional-id location. */
4
- argv: string[];
4
+ argv:string[];
5
5
  /** Whether argv changed. */
6
- changed: boolean;
6
+ changed:boolean;
7
7
  /** Whether both positional and named item ids were supplied. */
8
- conflict: boolean;
8
+ conflict:boolean;
9
9
  /** Resolved named item id when one was present. */
10
- itemId?: string;
10
+ itemId?:string;
11
11
  }
12
12
  /** Return whether a command participates in the shared item-id alias contract. */
13
- export declare function supportsItemIdAlias(commandName: string | undefined): boolean;
13
+ export declare function supportsItemIdAlias(commandName:string | undefined):boolean;
14
14
  /**
15
15
  * Normalize `pm <command> --id <value>` to the command's positional id form.
16
16
  * The transformation is lossless for every other argument and reports a
17
17
  * conflict instead of guessing when both forms are present.
18
18
  */
19
- export declare function normalizeItemAddressInvocation(argv: string[]): ItemAddressInvocationResult;
19
+ export declare function normalizeItemAddressInvocation(argv:string[]):ItemAddressInvocationResult;
@@ -13,58 +13,58 @@ export type PmRefusalEvidenceKind = "owned_state" | "closed_domain" | "grammar";
13
13
  /** One complete-catalog closure row. */
14
14
  export interface PmRefusalClosureCensusRow {
15
15
  /** Declared machine-readable error code. */
16
- code: string;
16
+ code:string;
17
17
  /** Canonical compatibility-group code. */
18
- canonical_code: string;
18
+ canonical_code:string;
19
19
  /** Whether at least one executable probe reaches the compatibility group. */
20
- disposition: "executable" | "uncovered";
20
+ disposition:"executable" | "uncovered";
21
21
  /** Evidence families contributing executable probes. */
22
- evidence_kinds: PmRefusalEvidenceKind[];
22
+ evidence_kinds:PmRefusalEvidenceKind[];
23
23
  /** Stable executable probe identities. */
24
- probe_ids: string[];
24
+ probe_ids:string[];
25
25
  }
26
26
  /** Full emitted-vocabulary refusal closure receipt. */
27
27
  export interface PmRefusalClosureCensusReport {
28
28
  /** True only when every catalog code belongs to a probed compatibility group. */
29
- ok: boolean;
29
+ ok:boolean;
30
30
  /** Number of emitted codes in the catalog. */
31
- catalog_error_code_count: number;
31
+ catalog_error_code_count:number;
32
32
  /** Number of codes backed by executable evidence. */
33
- executable_error_code_count: number;
33
+ executable_error_code_count:number;
34
34
  /** Number of codes still lacking executable evidence. */
35
- uncovered_error_code_count: number;
35
+ uncovered_error_code_count:number;
36
36
  /** Executable codes divided by all catalog codes. */
37
- coverage_fraction: number;
37
+ coverage_fraction:number;
38
38
  /** Number of closed-domain probes joined into the census. */
39
- closed_domain_probe_count: number;
39
+ closed_domain_probe_count:number;
40
40
  /** Number of grammar-derived probes joined into the census. */
41
- grammar_probe_count: number;
41
+ grammar_probe_count:number;
42
42
  /** Stable complete list of codes without executable evidence. */
43
- uncovered_error_codes: string[];
43
+ uncovered_error_codes:string[];
44
44
  /** Exactly one row for every catalog code. */
45
- rows: PmRefusalClosureCensusRow[];
45
+ rows:PmRefusalClosureCensusRow[];
46
46
  }
47
47
  /** @deprecated Historical v1 floor retained for SDK compatibility. */
48
48
  export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE = 16;
49
49
  /** @deprecated Historical v1 identities retained for SDK compatibility. */
50
- export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE: readonly ["bulk_ids_input_empty", "bulk_ids_input_missing_path", "bulk_ids_input_unreadable", "invalid_argument_value", "missing_lifecycle_target", "missing_required_argument", "projection_options_mutually_exclusive", "tracker_not_initialized", "tracker_root_missing", "tracker_root_not_directory", "tracker_root_unreadable", "unknown_context_intent", "unknown_field_projection", "unknown_option", "unknown_subcommand"];
50
+ export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE:readonly ["bulk_ids_input_empty","bulk_ids_input_missing_path","bulk_ids_input_unreadable","invalid_argument_value","missing_lifecycle_target","missing_required_argument","projection_options_mutually_exclusive","tracker_not_initialized","tracker_root_missing","tracker_root_not_directory","tracker_root_unreadable","unknown_context_intent","unknown_field_projection","unknown_option","unknown_subcommand"];
51
51
  /** Reviewed v2 floor of 18 catalog rows across 17 canonical groups. */
52
52
  export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CODE_BASELINE_V2 = 18;
53
53
  /** V2 canonical identities that must retain executable evidence. */
54
- export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE_V2: readonly string[];
54
+ export declare const PM_REFUSAL_CLOSURE_EXECUTABLE_CANONICAL_CODE_BASELINE_V2:readonly string[];
55
55
  /** Ratchet receipt that prevents catalog growth from erasing proven closure. */
56
- export declare function verifyPmRefusalClosureRatchet(report: PmRefusalClosureCensusReport, baseline?: number): {
57
- ok: boolean;
58
- baseline: number;
59
- actual: number;
56
+ export declare function verifyPmRefusalClosureRatchet(report:PmRefusalClosureCensusReport,baseline?:number):{
57
+ ok:boolean;
58
+ baseline:number;
59
+ actual:number;
60
60
  };
61
61
  /** Ratchet canonical compatibility-group identities independently from counts. */
62
- export declare function verifyPmRefusalClosureIdentityRatchet(report: PmRefusalClosureCensusReport, requiredCanonicalCodes?: readonly string[]): {
63
- ok: boolean;
64
- required_canonical_codes: string[];
65
- missing_required_canonical_codes: string[];
62
+ export declare function verifyPmRefusalClosureIdentityRatchet(report:PmRefusalClosureCensusReport,requiredCanonicalCodes?:readonly string[]):{
63
+ ok:boolean;
64
+ required_canonical_codes:string[];
65
+ missing_required_canonical_codes:string[];
66
66
  };
67
67
  /** Build the complete closure join without silently omitting uncovered codes. */
68
- export declare function buildPmRefusalClosureCensus(catalog: readonly PmErrorCodeContract[], closedDomains: readonly PmClosedDomainContract[], grammar: readonly PmGrammarRefusalContract[]): PmRefusalClosureCensusReport;
68
+ export declare function buildPmRefusalClosureCensus(catalog:readonly PmErrorCodeContract[],closedDomains:readonly PmClosedDomainContract[],grammar:readonly PmGrammarRefusalContract[]):PmRefusalClosureCensusReport;
69
69
  /** Render the complete census for generated documentation and review evidence. */
70
- export declare function renderPmRefusalClosureCensusMarkdown(report: PmRefusalClosureCensusReport): string;
70
+ export declare function renderPmRefusalClosureCensusMarkdown(report:PmRefusalClosureCensusReport):string;
@@ -1,53 +1,53 @@
1
1
  /** One real refusal and the outcome of executing its advertised retry. */
2
2
  export interface PmRefusalClosureObservation {
3
3
  /** Stable corpus identifier. */
4
- probe_id: string;
4
+ probe_id:string;
5
5
  /** Public entrypoint that refused the invocation. */
6
- entrypoint: string;
6
+ entrypoint:string;
7
7
  /** Process exit code returned by the refusal. */
8
- exit_code: number;
8
+ exit_code:number;
9
9
  /** Rejected closed-domain token. */
10
- rejected_value: string;
10
+ rejected_value:string;
11
11
  /** Complete accepted domain emitted by the refusal. */
12
- allowed_values: readonly string[];
12
+ allowed_values:readonly string[];
13
13
  /** Stable error code emitted by the refusal. */
14
- error_code?: string;
14
+ error_code?:string;
15
15
  /** Contract-owned error code required for this refusal. */
16
- expected_error_code?: string;
16
+ expected_error_code?:string;
17
17
  /** Contract-owned complete accepted domain. */
18
- expected_allowed_values?: readonly string[];
18
+ expected_allowed_values?:readonly string[];
19
19
  /** Whether an accepted-value domain is required for this refusal class. */
20
- allowed_values_required?: boolean;
20
+ allowed_values_required?:boolean;
21
21
  /** Exact command emitted for recovery. */
22
- suggested_retry: string;
22
+ suggested_retry:string;
23
23
  /** Shell-free argv emitted for safe programmatic recovery. */
24
- suggested_retry_args?: readonly string[];
24
+ suggested_retry_args?:readonly string[];
25
25
  /** Contract-owned argv required for deterministic recovery. */
26
- expected_suggested_retry_args?: readonly string[];
26
+ expected_suggested_retry_args?:readonly string[];
27
27
  /** Whether executing the advertised retry succeeded. */
28
- retry_succeeded: boolean;
28
+ retry_succeeded:boolean;
29
29
  }
30
30
  /** One missing or contradictory recovery primitive. */
31
31
  export interface PmRefusalClosureFinding {
32
32
  /** Stable finding code. */
33
- code: "accepted_rejected_value" | "duplicate_probe" | "error_code_mismatch" | "empty_corpus" | "incomplete_allowed_values" | "missing_allowed_values" | "missing_suggested_retry_args" | "missing_suggested_retry" | "non_refusal_exit" | "suggested_retry_args_mismatch" | "retry_failed";
33
+ code:"accepted_rejected_value" | "duplicate_probe" | "error_code_mismatch" | "empty_corpus" | "incomplete_allowed_values" | "missing_allowed_values" | "missing_suggested_retry_args" | "missing_suggested_retry" | "non_refusal_exit" | "suggested_retry_args_mismatch" | "retry_failed";
34
34
  /** Stable corpus identifier. */
35
- probe_id: string;
35
+ probe_id:string;
36
36
  /** Actionable mismatch detail. */
37
- detail: string;
37
+ detail:string;
38
38
  }
39
39
  /** Complete recovery-closure score and its fail-closed findings. */
40
40
  export interface PmRefusalClosureReport {
41
41
  /** Whether every refusal was self-contained and executable. */
42
- ok: boolean;
42
+ ok:boolean;
43
43
  /** Number of unique probes scored. */
44
- probe_count: number;
44
+ probe_count:number;
45
45
  /** Number of probes with complete successful closure. */
46
- closed_probe_count: number;
46
+ closed_probe_count:number;
47
47
  /** Closed probes divided by unique probes. */
48
- closure_fraction: number;
48
+ closure_fraction:number;
49
49
  /** Stable ordered findings. */
50
- findings: readonly PmRefusalClosureFinding[];
50
+ findings:readonly PmRefusalClosureFinding[];
51
51
  }
52
52
  /** Score structured closed-domain refusals and executable retries. */
53
- export declare function scorePmRefusalClosure(observations: readonly PmRefusalClosureObservation[]): PmRefusalClosureReport;
53
+ export declare function scorePmRefusalClosure(observations:readonly PmRefusalClosureObservation[]):PmRefusalClosureReport;