@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,147 +1,147 @@
1
- import { type PmCommandCapabilityFamily, type PmCommandVisibilityTier, type PmMcpToolProfile } from "../agent-capability-contracts.js";
1
+ import { type PmCommandCapabilityFamily,type PmCommandVisibilityTier,type PmMcpToolProfile } from "../agent-capability-contracts.js";
2
2
  /** Namespaced MCP extension that opts a client into progressive tool discovery. */
3
3
  export declare const PM_MCP_PROGRESSIVE_DISCOVERY_EXTENSION = "dev.unbrained.pm/progressive-tool-discovery";
4
4
  /** Versioned server capability advertised for progressive tool discovery. */
5
- export declare const PM_MCP_PROGRESSIVE_DISCOVERY_SERVER_CAPABILITY: Readonly<{
6
- version: 1;
7
- discoveryTool: "pm_discover";
8
- canonicalResult: "structuredContent.result";
9
- compatibilityText: "pointer";
5
+ export declare const PM_MCP_PROGRESSIVE_DISCOVERY_SERVER_CAPABILITY:Readonly<{
6
+ version:1;
7
+ discoveryTool:"pm_discover";
8
+ canonicalResult:"structuredContent.result";
9
+ compatibilityText:"pointer";
10
10
  }>;
11
11
  /** Small stable tool catalog returned to clients that negotiate the extension. */
12
- export declare const PM_MCP_ENTRY_TOOL_NAMES: readonly string[];
12
+ export declare const PM_MCP_ENTRY_TOOL_NAMES:readonly string[];
13
13
  /** Ranking signals composed by the public discovery contract. */
14
14
  export type PmToolDiscoverySignalName = "lexical" | "semantic" | "graph" | "permission" | "freshness" | "usage";
15
15
  /** Optional host-owned signals supplied for one tool. */
16
16
  export interface PmToolDiscoverySignalInput {
17
17
  /** Semantic relevance normalized to the inclusive range zero through one. */
18
- semantic?: number;
18
+ semantic?:number;
19
19
  /** Graph proximity normalized to the inclusive range zero through one. */
20
- graph?: number;
20
+ graph?:number;
21
21
  /** Definition freshness normalized to the inclusive range zero through one. */
22
- freshness?: number;
22
+ freshness?:number;
23
23
  /** Historical selection usefulness normalized to the inclusive range zero through one. */
24
- usage?: number;
24
+ usage?:number;
25
25
  }
26
26
  /** One tool definition accepted by the SDK discovery engine. */
27
27
  export interface PmToolDiscoveryCandidate {
28
28
  /** Stable callable tool name. */
29
- name: string;
29
+ name:string;
30
30
  /** Agent-facing tool description. */
31
- description: string;
31
+ description:string;
32
32
  /** JSON Schema supplied when callers request schema expansion. */
33
- inputSchema: Record<string, unknown>;
33
+ inputSchema:Record<string,unknown>;
34
34
  /** Whether the current caller is authorized to invoke the tool. */
35
- authorized?: boolean;
35
+ authorized?:boolean;
36
36
  /** Optional host-owned ranking signals. */
37
- signals?: PmToolDiscoverySignalInput;
37
+ signals?:PmToolDiscoverySignalInput;
38
38
  }
39
39
  /** Options controlling one progressive discovery page. */
40
40
  export interface PmToolDiscoveryOptions {
41
41
  /** Free-text capability intent. Empty text lists by deterministic policy order. */
42
- query?: string;
42
+ query?:string;
43
43
  /** Restrict results to one stable capability family. */
44
- family?: PmCommandCapabilityFamily;
44
+ family?:PmCommandCapabilityFamily;
45
45
  /** Restrict results to tools visible at or below this tier. */
46
- tier?: Exclude<PmCommandVisibilityTier, "internal">;
46
+ tier?:Exclude<PmCommandVisibilityTier,"internal">;
47
47
  /** Maximum result rows, from one through one hundred. */
48
- limit?: number;
48
+ limit?:number;
49
49
  /** Opaque continuation cursor from an equivalent discovery request. */
50
- cursor?: string;
50
+ cursor?:string;
51
51
  /** Include complete input schemas instead of the default compact projection. */
52
- includeSchema?: boolean;
52
+ includeSchema?:boolean;
53
53
  /** Estimated-token ceiling, or unbounded for the complete selected page. */
54
- outputBudget?: number | "unbounded";
54
+ outputBudget?:number | "unbounded";
55
55
  /** MCP profile that produced the authorized candidate catalog. */
56
- profile?: PmMcpToolProfile;
56
+ profile?:PmMcpToolProfile;
57
57
  /** Host-owned HMAC key of at least 32 bytes for restart-stable cursors. */
58
- cursorIntegrityKey?: Uint8Array;
58
+ cursorIntegrityKey?:Uint8Array;
59
59
  }
60
60
  /** Applied score for one signal with explicit provenance. */
61
61
  export interface PmToolDiscoveryAppliedSignal {
62
62
  /** Normalized signal value. */
63
- value: number;
63
+ value:number;
64
64
  /** Public policy weight. */
65
- weight: number;
65
+ weight:number;
66
66
  /** Whether the signal was computed or supplied rather than defaulted. */
67
- available: boolean;
67
+ available:boolean;
68
68
  /** Transparent source of the normalized value. */
69
- source: "computed" | "host" | "authorization" | "unavailable";
69
+ source:"computed" | "host" | "authorization" | "unavailable";
70
70
  }
71
71
  /** One ranked discovery result. */
72
72
  export interface PmToolDiscoveryResultRow {
73
73
  /** Stable callable tool name. */
74
- name: string;
74
+ name:string;
75
75
  /** Agent-facing description. */
76
- description: string;
76
+ description:string;
77
77
  /** Canonical CLI command backing the tool. */
78
- command: string;
78
+ command:string;
79
79
  /** Minimum visibility tier inherited from the command contract. */
80
- tier: PmCommandVisibilityTier;
80
+ tier:PmCommandVisibilityTier;
81
81
  /** Stable capability family inherited from the command contract. */
82
- family: PmCommandCapabilityFamily;
82
+ family:PmCommandCapabilityFamily;
83
83
  /** Weighted aggregate score used for ordering. */
84
- score: number;
84
+ score:number;
85
85
  /** Complete per-signal score explanation. */
86
- signals: Readonly<Record<PmToolDiscoverySignalName, PmToolDiscoveryAppliedSignal>>;
86
+ signals:Readonly<Record<PmToolDiscoverySignalName,PmToolDiscoveryAppliedSignal>>;
87
87
  /** Complete JSON Schema when explicitly requested. */
88
- input_schema?: Record<string, unknown>;
88
+ input_schema?:Record<string,unknown>;
89
89
  }
90
90
  /** Explicit receipt for information omitted from a discovery page. */
91
91
  export interface PmToolDiscoveryOmissionReceipt {
92
92
  /** Whether any result rows or schemas were omitted. */
93
- has_omissions: boolean;
93
+ has_omissions:boolean;
94
94
  /** Stable omitted field groups. */
95
- omitted: Array<{
96
- name: "input_schema" | "tools";
97
- reason: "compact_projection" | "limit" | "token_budget";
98
- restore_with: string;
95
+ omitted:Array<{
96
+ name:"input_schema" | "tools";
97
+ reason:"compact_projection" | "limit" | "token_budget";
98
+ restore_with:string;
99
99
  }>;
100
100
  }
101
101
  /** Deterministic progressive tool discovery response. */
102
102
  export interface PmToolDiscoveryResult {
103
103
  /** Stable result discriminator for model and host routing. */
104
- result_type: "pm_tool_discovery";
104
+ result_type:"pm_tool_discovery";
105
105
  /** Public contract revision. */
106
- contract_version: 1;
106
+ contract_version:1;
107
107
  /** Normalized query used by ranking and cursor binding. */
108
- query: string;
108
+ query:string;
109
109
  /** MCP profile that produced the candidate catalog. */
110
- profile: PmMcpToolProfile;
110
+ profile:PmMcpToolProfile;
111
111
  /** Ranked page of authorized tools. */
112
- tools: PmToolDiscoveryResultRow[];
112
+ tools:PmToolDiscoveryResultRow[];
113
113
  /** Total authorized rows after filters and before pagination. */
114
- total: number;
114
+ total:number;
115
115
  /** Rows returned on this page. */
116
- returned: number;
116
+ returned:number;
117
117
  /** Whether a later ranked row remains. */
118
- has_more: boolean;
118
+ has_more:boolean;
119
119
  /** Opaque continuation cursor bound to query, filters, and catalog. */
120
- next_cursor?: string;
120
+ next_cursor?:string;
121
121
  /** Exact estimated serialized result cost. */
122
- token_cost: {
123
- estimated_tokens: number;
124
- budget: number | "unbounded";
125
- within_budget: boolean;
122
+ token_cost:{
123
+ estimated_tokens:number;
124
+ budget:number | "unbounded";
125
+ within_budget:boolean;
126
126
  };
127
127
  /** Public ranking formula and weights. */
128
- ranking_policy: {
129
- version: 1;
130
- formula: "weighted_sum_then_name";
131
- weights: Readonly<Record<PmToolDiscoverySignalName, number>>;
128
+ ranking_policy:{
129
+ version:1;
130
+ formula:"weighted_sum_then_name";
131
+ weights:Readonly<Record<PmToolDiscoverySignalName,number>>;
132
132
  };
133
133
  /** Cache identity and invalidation contract for deterministic pages. */
134
- cache: {
135
- key: string;
136
- ttl_ms: number;
137
- scope: "private";
138
- invalidates_on: readonly string[];
134
+ cache:{
135
+ key:string;
136
+ ttl_ms:number;
137
+ scope:"private";
138
+ invalidates_on:readonly string[];
139
139
  };
140
140
  /** Explicit recovery for compacted fields and rows. */
141
- omission_receipt: PmToolDiscoveryOmissionReceipt;
141
+ omission_receipt:PmToolDiscoveryOmissionReceipt;
142
142
  }
143
143
  /** Parse untrusted adapter input without discarding malformed discovery values. */
144
- export declare function parsePmToolDiscoveryOptions(input: Record<string, unknown>): PmToolDiscoveryOptions;
144
+ export declare function parsePmToolDiscoveryOptions(input:Record<string,unknown>):PmToolDiscoveryOptions;
145
145
  /**
146
146
  * Rank and page an authorized MCP tool catalog under an explicit token budget.
147
147
  *
@@ -149,4 +149,4 @@ export declare function parsePmToolDiscoveryOptions(input: Record<string, unknow
149
149
  * catalog, or ranking inputs change. Host signals override documented local
150
150
  * fallbacks without changing the public formula or hiding signal provenance.
151
151
  */
152
- export declare function discoverPmTools(candidates: readonly PmToolDiscoveryCandidate[], options?: PmToolDiscoveryOptions): PmToolDiscoveryResult;
152
+ export declare function discoverPmTools(candidates:readonly PmToolDiscoveryCandidate[],options?:PmToolDiscoveryOptions):PmToolDiscoveryResult;
@@ -1,32 +1,32 @@
1
- import { type PmMcpImplementation, type PmMcpRequestContext } from "./protocol.js";
1
+ import { type PmMcpImplementation,type PmMcpRequestContext } from "./protocol.js";
2
2
  /** Methods permitted inside a 2026-07-28 MRTR input request map. */
3
- export declare const PM_MCP_INPUT_REQUEST_METHODS: readonly ["elicitation/create", "roots/list", "sampling/createMessage"];
3
+ export declare const PM_MCP_INPUT_REQUEST_METHODS:readonly ["elicitation/create","roots/list","sampling/createMessage"];
4
4
  /** One typed request that a host must fulfill before retrying an operation. */
5
5
  export interface PmMcpInputRequest {
6
6
  /** Current MCP server-to-client request method. */
7
- method: (typeof PM_MCP_INPUT_REQUEST_METHODS)[number];
7
+ method:(typeof PM_MCP_INPUT_REQUEST_METHODS)[number];
8
8
  /** Method-specific parameters retained as an open protocol object. */
9
- params: Record<string, unknown>;
9
+ params:Record<string,unknown>;
10
10
  }
11
11
  /** Server-assigned MRTR input identifiers mapped to bounded requests. */
12
- export type PmMcpInputRequests = Record<string, PmMcpInputRequest>;
12
+ export type PmMcpInputRequests = Record<string,PmMcpInputRequest>;
13
13
  /** Host responses keyed by the identifiers in an earlier input request map. */
14
- export type PmMcpInputResponses = Record<string, Record<string, unknown>>;
14
+ export type PmMcpInputResponses = Record<string,Record<string,unknown>>;
15
15
  /** Modern interim result returned when an operation needs more host input. */
16
16
  export interface PmMcpInputRequiredResult {
17
17
  /** MRTR discriminator required by the current protocol. */
18
- resultType: "input_required";
18
+ resultType:"input_required";
19
19
  /** Optional bounded requests the host must fulfill. */
20
- inputRequests?: PmMcpInputRequests;
20
+ inputRequests?:PmMcpInputRequests;
21
21
  /** Optional integrity-protected state echoed unchanged on retry. */
22
- requestState?: string;
22
+ requestState?:string;
23
23
  /** Result-local MCP metadata. */
24
- _meta: {
24
+ _meta:{
25
25
  /** Server identity repeated on every modern result. */
26
- "io.modelcontextprotocol/serverInfo": PmMcpImplementation;
26
+ "io.modelcontextprotocol/serverInfo":PmMcpImplementation;
27
27
  };
28
28
  /** Additional forward-compatible result fields. */
29
- [key: string]: unknown;
29
+ [key:string]:unknown;
30
30
  }
31
31
  /**
32
32
  * Transport-neutral control signal used by SDK handlers to request an MRTR
@@ -34,68 +34,68 @@ _meta: {
34
34
  */
35
35
  export declare class PmMcpInputRequiredError extends Error {
36
36
  /** Server-authored input requests validated by the adapter. */
37
- readonly inputRequests?: unknown;
37
+ readonly inputRequests?:unknown;
38
38
  /** Optional opaque continuation state echoed on retry. */
39
- readonly requestState?: string;
39
+ readonly requestState?:string;
40
40
  /** Create an input-required control signal. */
41
- constructor(input: {
42
- inputRequests?: unknown;
43
- requestState?: string;
41
+ constructor(input:{
42
+ inputRequests?:unknown;
43
+ requestState?:string;
44
44
  });
45
45
  }
46
46
  /** Cache fields required on current list and read results. */
47
47
  export interface PmMcpCachePolicy {
48
48
  /** Milliseconds for which a client may consider the response fresh. */
49
- ttlMs: number;
49
+ ttlMs:number;
50
50
  /** Whether shared intermediaries may reuse the response. */
51
- cacheScope: "private" | "public";
51
+ cacheScope:"private" | "public";
52
52
  /** Additional forward-compatible cache fields. */
53
- [key: string]: unknown;
53
+ [key:string]:unknown;
54
54
  }
55
55
  /** Work bounds applied while validating an advertised JSON Schema. */
56
56
  export interface PmMcpJsonSchemaBounds {
57
57
  /** Maximum serialized schema bytes. */
58
- maxBytes?: number;
58
+ maxBytes?:number;
59
59
  /** Maximum nested object or array depth. */
60
- maxDepth?: number;
60
+ maxDepth?:number;
61
61
  /** Maximum visited object, array, and scalar nodes. */
62
- maxNodes?: number;
62
+ maxNodes?:number;
63
63
  }
64
64
  /** State sealed into an opaque MRTR requestState value. */
65
65
  export interface PmMcpRequestStatePayload {
66
66
  /** Absolute expiration timestamp in milliseconds. */
67
- expiresAt: number;
67
+ expiresAt:number;
68
68
  /** Original JSON-RPC method this state may resume. */
69
- method: string;
69
+ method:string;
70
70
  /** Digest of the original request's salient parameters. */
71
- parameterDigest: string;
71
+ parameterDigest:string;
72
72
  /** Principal binding chosen by the host or authorization layer. */
73
- principal: string;
73
+ principal:string;
74
74
  /** Application-owned continuation data. */
75
- state: unknown;
75
+ state:unknown;
76
76
  }
77
77
  /** Validate and clone a server-authored MRTR request map. */
78
- export declare function parseMcpInputRequests(value: unknown, requestContext: PmMcpRequestContext): PmMcpInputRequests;
78
+ export declare function parseMcpInputRequests(value:unknown,requestContext:PmMcpRequestContext):PmMcpInputRequests;
79
79
  /** Validate and clone client-supplied input responses from an MRTR retry. */
80
- export declare function parseMcpInputResponses(value: unknown): PmMcpInputResponses;
80
+ export declare function parseMcpInputResponses(value:unknown):PmMcpInputResponses;
81
81
  /** Build a modern input-required result after validating capability and size bounds. */
82
- export declare function buildMcpInputRequiredResult(input: {
83
- requestContext: PmMcpRequestContext;
84
- serverInfo: PmMcpImplementation;
85
- inputRequests?: unknown;
86
- requestState?: string;
87
- }): PmMcpInputRequiredResult;
82
+ export declare function buildMcpInputRequiredResult(input:{
83
+ requestContext:PmMcpRequestContext;
84
+ serverInfo:PmMcpImplementation;
85
+ inputRequests?:unknown;
86
+ requestState?:string;
87
+ }):PmMcpInputRequiredResult;
88
88
  /** Seal integrity-protected continuation state for an MRTR retry. */
89
- export declare function sealMcpRequestState(payload: PmMcpRequestStatePayload, secret: string | Uint8Array): string;
89
+ export declare function sealMcpRequestState(payload:PmMcpRequestStatePayload,secret:string | Uint8Array):string;
90
90
  /** Verify an MRTR requestState value against method, principal, digest, and expiry. */
91
- export declare function openMcpRequestState(value: string, secret: string | Uint8Array, expected: {
92
- method: string;
93
- parameterDigest: string;
94
- principal: string;
95
- nowMs?: number;
96
- }): PmMcpRequestStatePayload;
91
+ export declare function openMcpRequestState(value:string,secret:string | Uint8Array,expected:{
92
+ method:string;
93
+ parameterDigest:string;
94
+ principal:string;
95
+ nowMs?:number;
96
+ }):PmMcpRequestStatePayload;
97
97
  /** Compute a stable-sized digest for application-selected salient request data. */
98
- export declare function digestMcpRequestParameters(value: unknown): string;
98
+ export declare function digestMcpRequestParameters(value:unknown):string;
99
99
  /**
100
100
  * Bound single-use MRTR state consumption within one server process. Callers
101
101
  * requiring cross-process one-time semantics should persist the resulting hash.
@@ -103,16 +103,16 @@ export declare function digestMcpRequestParameters(value: unknown): string;
103
103
  export declare class PmMcpRequestStateReplayGuard {
104
104
  #private;
105
105
  /** Create a bounded in-process replay guard. */
106
- constructor(maximumEntries?: number);
106
+ constructor(maximumEntries?:number);
107
107
  /** Consume one opaque requestState value exactly once in this process. */
108
- consume(value: string): void;
108
+ consume(value:string):void;
109
109
  }
110
110
  /** Validate and clone a required MCP cache policy. */
111
- export declare function parseMcpCachePolicy(value: PmMcpCachePolicy): PmMcpCachePolicy;
111
+ export declare function parseMcpCachePolicy(value:PmMcpCachePolicy):PmMcpCachePolicy;
112
112
  /** Attach required cache fields without mutating a method-specific payload. */
113
- export declare function withMcpCachePolicy<Payload extends Record<string, unknown>>(payload: Payload, policy: PmMcpCachePolicy): Payload & PmMcpCachePolicy;
113
+ export declare function withMcpCachePolicy<Payload extends Record<string,unknown>>(payload:Payload,policy:PmMcpCachePolicy):Payload & PmMcpCachePolicy;
114
114
  /**
115
115
  * Validate JSON Schema 2020-12 structure under explicit byte, depth, node, and
116
116
  * local-reference work bounds while allowing the complete keyword vocabulary.
117
117
  */
118
- export declare function validateMcpJsonSchema(schema: unknown, bounds?: PmMcpJsonSchemaBounds): unknown;
118
+ export declare function validateMcpJsonSchema(schema:unknown,bounds?:PmMcpJsonSchemaBounds):unknown;
@@ -5,7 +5,7 @@
5
5
  * discovery, result-envelope, and bounded legacy-compatibility contracts.
6
6
  */
7
7
  /** Canonical stateless MCP revision implemented by pm. */
8
- export declare const PM_MCP_PROTOCOL_VERSION: "2026-07-28";
8
+ export declare const PM_MCP_PROTOCOL_VERSION:"2026-07-28";
9
9
  /**
10
10
  * Legacy initialize-era revisions accepted only by the bounded stdio adapter.
11
11
  *
@@ -15,143 +15,143 @@ export declare const PM_MCP_PROTOCOL_VERSION: "2026-07-28";
15
15
  * Ordered newest first: element zero is the revision offered to a client that
16
16
  * omits `protocolVersion`.
17
17
  */
18
- export declare const PM_MCP_LEGACY_PROTOCOL_VERSIONS: readonly ["2025-11-25", "2025-06-18"];
18
+ export declare const PM_MCP_LEGACY_PROTOCOL_VERSIONS:readonly ["2025-11-25","2025-06-18"];
19
19
  /** Modern per-request protocol versions accepted by the stateless core. */
20
- export declare const PM_MCP_SUPPORTED_PROTOCOL_VERSIONS: readonly ["2026-07-28"];
20
+ export declare const PM_MCP_SUPPORTED_PROTOCOL_VERSIONS:readonly ["2026-07-28"];
21
21
  /** Allocated MCP 2026-07-28 protocol error codes. */
22
- export declare const PM_MCP_ERROR_CODES: {
23
- readonly headerMismatch: -32020;
24
- readonly missingRequiredClientCapability: -32021;
25
- readonly unsupportedProtocolVersion: -32022;
26
- readonly invalidParams: -32602;
22
+ export declare const PM_MCP_ERROR_CODES:{
23
+ readonly headerMismatch:-32020;
24
+ readonly missingRequiredClientCapability:-32021;
25
+ readonly unsupportedProtocolVersion:-32022;
26
+ readonly invalidParams:-32602;
27
27
  };
28
28
  /** Namespaced metadata keys owned by the MCP specification. */
29
- export declare const PM_MCP_META_KEYS: {
30
- readonly clientCapabilities: "io.modelcontextprotocol/clientCapabilities";
31
- readonly clientInfo: "io.modelcontextprotocol/clientInfo";
32
- readonly logLevel: "io.modelcontextprotocol/logLevel";
33
- readonly protocolVersion: "io.modelcontextprotocol/protocolVersion";
34
- readonly serverInfo: "io.modelcontextprotocol/serverInfo";
29
+ export declare const PM_MCP_META_KEYS:{
30
+ readonly clientCapabilities:"io.modelcontextprotocol/clientCapabilities";
31
+ readonly clientInfo:"io.modelcontextprotocol/clientInfo";
32
+ readonly logLevel:"io.modelcontextprotocol/logLevel";
33
+ readonly protocolVersion:"io.modelcontextprotocol/protocolVersion";
34
+ readonly serverInfo:"io.modelcontextprotocol/serverInfo";
35
35
  };
36
36
  /** Request-local severity vocabulary retained by the deprecated logging contract. */
37
- export declare const PM_MCP_LOG_LEVELS: readonly ["debug", "info", "notice", "warning", "error", "critical", "alert", "emergency"];
37
+ export declare const PM_MCP_LOG_LEVELS:readonly ["debug","info","notice","warning","error","critical","alert","emergency"];
38
38
  /** An explicit logging opt-in applies only to the request carrying it. */
39
39
  export type PmMcpLogLevel = (typeof PM_MCP_LOG_LEVELS)[number];
40
40
  /** MCP implementation identity carried in request and result metadata. */
41
41
  export interface PmMcpImplementation {
42
42
  /** Stable implementation name. */
43
- name: string;
43
+ name:string;
44
44
  /** Implementation version. */
45
- version: string;
45
+ version:string;
46
46
  /** Optional human-readable implementation description. */
47
- description?: string;
47
+ description?:string;
48
48
  /** Optional implementation website. */
49
- websiteUrl?: string;
49
+ websiteUrl?:string;
50
50
  }
51
51
  /** Open MCP client capability map declared independently on every request. */
52
- export type PmMcpClientCapabilities = Record<string, unknown>;
52
+ export type PmMcpClientCapabilities = Record<string,unknown>;
53
53
  /** Server capabilities advertised by pm discovery. */
54
54
  export interface PmMcpServerCapabilities {
55
55
  /** Prompt surface and change-notification support. */
56
- prompts?: {
57
- listChanged?: boolean;
56
+ prompts?:{
57
+ listChanged?:boolean;
58
58
  };
59
59
  /** Resource surface and change-notification support. */
60
- resources?: {
61
- listChanged?: boolean;
62
- subscribe?: boolean;
60
+ resources?:{
61
+ listChanged?:boolean;
62
+ subscribe?:boolean;
63
63
  };
64
64
  /** Tool surface and change-notification support. */
65
- tools?: {
66
- listChanged?: boolean;
65
+ tools?:{
66
+ listChanged?:boolean;
67
67
  };
68
68
  /** Negotiated optional extension settings keyed by extension identifier. */
69
- extensions?: Record<string, Record<string, unknown>>;
69
+ extensions?:Record<string,Record<string,unknown>>;
70
70
  /** Additional capability declarations retained for forward compatibility. */
71
- [key: string]: unknown;
71
+ [key:string]:unknown;
72
72
  }
73
73
  /** Validated request-local metadata for one modern MCP operation. */
74
74
  export interface PmMcpRequestContext {
75
75
  /** Exact modern protocol revision used by this request. */
76
- protocolVersion: (typeof PM_MCP_SUPPORTED_PROTOCOL_VERSIONS)[number];
76
+ protocolVersion:(typeof PM_MCP_SUPPORTED_PROTOCOL_VERSIONS)[number];
77
77
  /** Capabilities declared for this request only. */
78
- clientCapabilities: PmMcpClientCapabilities;
78
+ clientCapabilities:PmMcpClientCapabilities;
79
79
  /** Optional bounded client identity used only for diagnostics/provenance. */
80
- clientInfo?: PmMcpImplementation;
80
+ clientInfo?:PmMcpImplementation;
81
81
  /** Optional request-local logging threshold; absence forbids protocol log notifications. */
82
- logLevel?: PmMcpLogLevel;
82
+ logLevel?:PmMcpLogLevel;
83
83
  }
84
84
  /** Required fields attached to every modern successful result. */
85
85
  export interface PmMcpResultEnvelope {
86
86
  /** Ordinary successful results are complete. */
87
- resultType: "complete";
87
+ resultType:"complete";
88
88
  /** Result-local MCP metadata. */
89
- _meta: {
89
+ _meta:{
90
90
  /** Server identity is repeated on every modern result. */
91
- "io.modelcontextprotocol/serverInfo": PmMcpImplementation;
91
+ "io.modelcontextprotocol/serverInfo":PmMcpImplementation;
92
92
  };
93
93
  /** Additional method-specific result fields. */
94
- [key: string]: unknown;
94
+ [key:string]:unknown;
95
95
  }
96
96
  /** Required server identity metadata attached to every modern result shape. */
97
97
  export interface PmMcpServerResultMetadata {
98
98
  /** Result-local MCP metadata. */
99
- _meta: {
99
+ _meta:{
100
100
  /** Server identity is repeated on every modern result. */
101
- "io.modelcontextprotocol/serverInfo": PmMcpImplementation;
101
+ "io.modelcontextprotocol/serverInfo":PmMcpImplementation;
102
102
  /** Additional namespaced or application metadata. */
103
- [key: string]: unknown;
103
+ [key:string]:unknown;
104
104
  };
105
105
  }
106
106
  /** Modern discovery response contract. */
107
107
  export interface PmMcpDiscoverResult extends PmMcpResultEnvelope {
108
108
  /** Modern stateless revisions accepted through per-request metadata. */
109
- supportedVersions: string[];
109
+ supportedVersions:string[];
110
110
  /** Deterministic server capability declaration. */
111
- capabilities: PmMcpServerCapabilities;
111
+ capabilities:PmMcpServerCapabilities;
112
112
  /** Cache freshness hint required by the current schema. */
113
- ttlMs: number;
113
+ ttlMs:number;
114
114
  /** Discovery is public because it contains no caller-specific data. */
115
- cacheScope: "public";
115
+ cacheScope:"public";
116
116
  /** Optional model-facing usage guidance. */
117
- instructions?: string;
117
+ instructions?:string;
118
118
  }
119
119
  /** Protocol-era interpretation used at explicit compatibility boundaries. */
120
120
  export type PmMcpProtocolEra = "modern" | "legacy";
121
121
  /** Structured MCP protocol error safe for JSON-RPC adapters. */
122
122
  export declare class PmMcpProtocolError extends Error {
123
123
  /** JSON-RPC/MCP error code. */
124
- readonly code: number;
124
+ readonly code:number;
125
125
  /** Structured recovery or mismatch detail. */
126
- readonly data: Record<string, unknown>;
126
+ readonly data:Record<string,unknown>;
127
127
  /** Create one typed protocol error. */
128
- constructor(message: string, code: number, data?: Record<string, unknown>);
128
+ constructor(message:string,code:number,data?:Record<string,unknown>);
129
129
  }
130
130
  /** Return whether an unknown value is a non-array object. */
131
- export declare function isMcpRecord(value: unknown): value is Record<string, unknown>;
131
+ export declare function isMcpRecord(value:unknown):value is Record<string,unknown>;
132
132
  /** Parse an optional MCP implementation identity without guessing missing fields. */
133
- export declare function parseMcpImplementation(value: unknown): PmMcpImplementation | undefined;
133
+ export declare function parseMcpImplementation(value:unknown):PmMcpImplementation | undefined;
134
134
  /** Validate the stateless metadata required on every modern MCP request. */
135
- export declare function resolveMcpRequestContext(params: unknown): PmMcpRequestContext;
135
+ export declare function resolveMcpRequestContext(params:unknown):PmMcpRequestContext;
136
136
  /** Validate the HTTP protocol-version header against request-local metadata. */
137
- export declare function assertMcpProtocolHeader(requestContext: PmMcpRequestContext, headerValue: string | undefined): void;
137
+ export declare function assertMcpProtocolHeader(requestContext:PmMcpRequestContext,headerValue:string | undefined):void;
138
138
  /** Require named client capabilities without consulting prior requests. */
139
- export declare function assertMcpClientCapabilities(requestContext: PmMcpRequestContext, requiredCapabilities: readonly string[]): void;
139
+ export declare function assertMcpClientCapabilities(requestContext:PmMcpRequestContext,requiredCapabilities:readonly string[]):void;
140
140
  /** Return whether this request independently negotiated one named extension. */
141
- export declare function hasMcpClientExtension(requestContext: PmMcpRequestContext, extension: string): boolean;
141
+ export declare function hasMcpClientExtension(requestContext:PmMcpRequestContext,extension:string):boolean;
142
142
  /** Attach required server identity while preserving a non-complete result discriminator. */
143
- export declare function attachMcpServerInfo<Payload extends Record<string, unknown>>(payload: Payload, serverInfo: PmMcpImplementation): Payload & PmMcpServerResultMetadata;
143
+ export declare function attachMcpServerInfo<Payload extends Record<string,unknown>>(payload:Payload,serverInfo:PmMcpImplementation):Payload & PmMcpServerResultMetadata;
144
144
  /** Attach required modern result fields without mutating the caller payload. */
145
- export declare function buildMcpCompleteResult<Payload extends Record<string, unknown>>(payload: Payload, serverInfo: PmMcpImplementation): Payload & PmMcpResultEnvelope;
145
+ export declare function buildMcpCompleteResult<Payload extends Record<string,unknown>>(payload:Payload,serverInfo:PmMcpImplementation):Payload & PmMcpResultEnvelope;
146
146
  /** Build deterministic current-revision server discovery. */
147
- export declare function buildMcpDiscoverResult(input: {
148
- serverInfo: PmMcpImplementation;
149
- capabilities: PmMcpServerCapabilities;
150
- instructions?: string;
151
- ttlMs?: number;
152
- }): PmMcpDiscoverResult;
147
+ export declare function buildMcpDiscoverResult(input:{
148
+ serverInfo:PmMcpImplementation;
149
+ capabilities:PmMcpServerCapabilities;
150
+ instructions?:string;
151
+ ttlMs?:number;
152
+ }):PmMcpDiscoverResult;
153
153
  /**
154
154
  * Interpret resultType only at an explicit protocol-era boundary. Legacy
155
155
  * results may omit it; modern results fail closed when it is absent.
156
156
  */
157
- export declare function interpretMcpResultType(result: unknown, era: PmMcpProtocolEra): string;
157
+ export declare function interpretMcpResultType(result:unknown,era:PmMcpProtocolEra):string;