@unbrained/pm-cli 2026.10.14 → 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 (692) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +54 -2
  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-recovery.d.ts +13 -13
  27. package/dist/cli/help-content.d.ts +22 -22
  28. package/dist/cli/help-content.js +2 -2
  29. package/dist/cli/help-json-payload.d.ts +45 -45
  30. package/dist/cli/invocation-profile.d.ts +5 -5
  31. package/dist/cli/main.d.ts +217 -217
  32. package/dist/cli/migration-gates.d.ts +24 -24
  33. package/dist/cli/option-values.d.ts +1 -1
  34. package/dist/cli/public.d.ts +1 -1
  35. package/dist/cli/register-annotations.d.ts +2 -2
  36. package/dist/cli/register-assurance.d.ts +1 -1
  37. package/dist/cli/register-files-lookup.d.ts +1 -1
  38. package/dist/cli/register-history-activity.d.ts +1 -1
  39. package/dist/cli/register-history-author.d.ts +1 -1
  40. package/dist/cli/register-history-maintenance.d.ts +1 -1
  41. package/dist/cli/register-list-query.d.ts +7 -7
  42. package/dist/cli/register-list-query.js +3 -3
  43. package/dist/cli/register-mutation-options.d.ts +1 -1
  44. package/dist/cli/register-mutation.d.ts +4 -4
  45. package/dist/cli/register-operations.d.ts +75 -75
  46. package/dist/cli/register-setup.d.ts +4 -4
  47. package/dist/cli/register-structured-mutation.d.ts +8 -8
  48. package/dist/cli/runtime/activation.d.ts +23 -23
  49. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  50. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  51. package/dist/cli/runtime/selection.d.ts +16 -16
  52. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  53. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  54. package/dist/cli/schema/registration.d.ts +1 -1
  55. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  56. package/dist/cli/stats-analytics-json.d.ts +1 -1
  57. package/dist/cli-bundle/bundle-manifest.json +1 -1
  58. package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-52EZH2QQ.js} +2 -2
  59. package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
  60. package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-7VHINXZP.js} +2 -2
  61. package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
  62. package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
  63. package/dist/cli-bundle/chunks/{chunk-PP3BVMFL.js → chunk-JSUJWIHQ.js} +30 -30
  64. package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-LNKLQYBG.js} +2 -2
  65. package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-N56CAQBU.js} +63 -64
  66. package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-NC3QVGDD.js} +2 -2
  67. package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-RJ5N44WY.js} +2 -2
  68. package/dist/cli-bundle/chunks/{chunk-LOSRTNNP.js → chunk-VIMQCFCK.js} +2 -2
  69. package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-WBBW3WQX.js} +4 -4
  70. package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
  71. package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-FKKFQ66D.js} +7 -7
  72. package/dist/cli-bundle/chunks/{register-mutation-TNRHNK4N.js → register-mutation-EWMMVZJB.js} +2 -2
  73. package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-GEQ2H7PS.js} +2 -2
  74. package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-PSJTQBBO.js} +2 -2
  75. package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-3RNUMVK4.js} +2 -2
  76. package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-4KQFMOM7.js} +6 -6
  77. package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-52I2SNKJ.js} +2 -2
  78. package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-5KRACGBK.js} +2 -2
  79. package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-5OO54BIV.js} +2 -2
  80. package/dist/cli-bundle/focused-chunks/{chunk-LKWDWER4.js → chunk-5TBAVZDR.js} +14 -14
  81. package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-FQKPOZKS.js} +2 -2
  82. package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-H3P77KVU.js} +2 -2
  83. package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
  84. package/dist/cli-bundle/focused-chunks/{chunk-23ACMPGB.js → chunk-JKBH7YGX.js} +2 -2
  85. package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-KIIFVULU.js} +2 -2
  86. package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-N6FUKTZS.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
  88. package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-Q4VNCTR2.js} +2 -2
  89. package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-THYQR3ON.js} +61 -62
  90. package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-TYLG5VEB.js} +2 -2
  91. package/dist/cli-bundle/main.js +26 -26
  92. package/dist/cli-bundle/sdk-authoring.js +1 -1
  93. package/dist/cli-bundle/sdk-contracts.js +2 -2
  94. package/dist/cli-bundle/sdk-core.js +22 -22
  95. package/dist/cli-bundle/sdk-governance.js +1 -1
  96. package/dist/cli-bundle/sdk-graph.js +1 -1
  97. package/dist/cli-bundle/sdk-merge.js +51 -51
  98. package/dist/cli-bundle/sdk-query.js +1 -1
  99. package/dist/cli-bundle/sdk-runtime.js +1 -1
  100. package/dist/cli-bundle/sdk-testing.js +1 -1
  101. package/dist/cli-bundle/sdk.js +7 -7
  102. package/dist/cli.d.ts +9 -9
  103. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  104. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  105. package/dist/core/config/nested-settings.d.ts +20 -20
  106. package/dist/core/config/positional-value.d.ts +9 -9
  107. package/dist/core/diagnostics/remediation.d.ts +7 -7
  108. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  109. package/dist/core/extensions/activation-summary.d.ts +30 -30
  110. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  111. package/dist/core/extensions/capability-usage.d.ts +25 -25
  112. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  113. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  114. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  115. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  116. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  117. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  118. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  119. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  120. package/dist/core/extensions/extension-policy.d.ts +62 -62
  121. package/dist/core/extensions/extension-registries.d.ts +8 -8
  122. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  123. package/dist/core/extensions/extension-types.d.ts +702 -702
  124. package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
  125. package/dist/core/extensions/flag-value-types.d.ts +16 -4
  126. package/dist/core/extensions/flag-value-types.js +1 -1
  127. package/dist/core/extensions/index.d.ts +34 -34
  128. package/dist/core/extensions/item-field-types.d.ts +3 -3
  129. package/dist/core/extensions/item-fields.d.ts +6 -6
  130. package/dist/core/extensions/loader.d.ts +66 -66
  131. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  132. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  133. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  134. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  135. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  136. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  137. package/dist/core/extensions/registration-validation.d.ts +6 -6
  138. package/dist/core/extensions/registration-values.d.ts +19 -19
  139. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  140. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  141. package/dist/core/extensions/service-ownership.d.ts +1 -1
  142. package/dist/core/extensions/version-compat.d.ts +9 -9
  143. package/dist/core/fs/atomic-create.d.ts +1 -1
  144. package/dist/core/fs/fs-utils.d.ts +12 -12
  145. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  146. package/dist/core/fs/path-utils.d.ts +1 -1
  147. package/dist/core/governance/content-fields.d.ts +25 -25
  148. package/dist/core/governance/issue-codes.d.ts +16 -16
  149. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  150. package/dist/core/history/digest.d.ts +5 -5
  151. package/dist/core/history/drift-cache.d.ts +2 -2
  152. package/dist/core/history/drift-scan.d.ts +18 -18
  153. package/dist/core/history/event-classification.d.ts +4 -4
  154. package/dist/core/history/event-index.d.ts +33 -33
  155. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  156. package/dist/core/history/history-diff.d.ts +15 -15
  157. package/dist/core/history/history-rewrite.d.ts +43 -43
  158. package/dist/core/history/history-storage-stats.d.ts +20 -20
  159. package/dist/core/history/history-stream-policy.d.ts +12 -12
  160. package/dist/core/history/history.d.ts +45 -45
  161. package/dist/core/history/identity.d.ts +4 -4
  162. package/dist/core/history/operation-contract.d.ts +17 -17
  163. package/dist/core/history/projection.d.ts +16 -16
  164. package/dist/core/history/read.d.ts +4 -4
  165. package/dist/core/history/replay.d.ts +47 -47
  166. package/dist/core/history/tombstone.d.ts +1 -1
  167. package/dist/core/history/version-address.d.ts +2 -2
  168. package/dist/core/history/workspace-history.d.ts +72 -72
  169. package/dist/core/io/body-file.d.ts +2 -2
  170. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  171. package/dist/core/item/actionability.d.ts +30 -30
  172. package/dist/core/item/dependency-reference.d.ts +2 -2
  173. package/dist/core/item/id.d.ts +9 -9
  174. package/dist/core/item/item-format-version.d.ts +17 -15
  175. package/dist/core/item/item-format-version.js +1 -1
  176. package/dist/core/item/item-format.d.ts +54 -54
  177. package/dist/core/item/item-record.d.ts +1 -1
  178. package/dist/core/item/item-type-definition.d.ts +11 -11
  179. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  180. package/dist/core/item/parse.d.ts +37 -37
  181. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  182. package/dist/core/item/priority.d.ts +3 -3
  183. package/dist/core/item/sprint-release-format.d.ts +4 -4
  184. package/dist/core/item/status-filter.d.ts +5 -5
  185. package/dist/core/item/status.d.ts +3 -3
  186. package/dist/core/item/toon-decode.d.ts +10 -10
  187. package/dist/core/item/type-registry.d.ts +35 -35
  188. package/dist/core/item/type-synonyms.d.ts +2 -2
  189. package/dist/core/lock/lock-gc.d.ts +28 -28
  190. package/dist/core/lock/lock.d.ts +53 -53
  191. package/dist/core/output/mutation-projection.d.ts +4 -4
  192. package/dist/core/output/output-control.d.ts +4 -4
  193. package/dist/core/output/output.d.ts +30 -30
  194. package/dist/core/output/query-summary.d.ts +5 -5
  195. package/dist/core/output/tabular.d.ts +3 -3
  196. package/dist/core/packages/manifest.d.ts +30 -30
  197. package/dist/core/packages/root.d.ts +4 -4
  198. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  199. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  200. package/dist/core/policy/workflow-policy.d.ts +56 -56
  201. package/dist/core/profile/profile-describe.d.ts +22 -22
  202. package/dist/core/profile/profile-lint.d.ts +13 -13
  203. package/dist/core/profile/profile-plan.d.ts +45 -45
  204. package/dist/core/profile/profile-presets.d.ts +36 -36
  205. package/dist/core/reproducibility/context.d.ts +9 -9
  206. package/dist/core/schema/fields-file.d.ts +35 -35
  207. package/dist/core/schema/item-types-file.d.ts +29 -29
  208. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  209. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  210. package/dist/core/schema/runtime-schema.d.ts +59 -59
  211. package/dist/core/schema/status-defs-file.d.ts +29 -29
  212. package/dist/core/schema/status-token.d.ts +1 -1
  213. package/dist/core/schema/type-inference.d.ts +10 -10
  214. package/dist/core/schema/type-presets.d.ts +5 -5
  215. package/dist/core/schema/type-workflows.d.ts +14 -14
  216. package/dist/core/search/background-refresh.d.ts +12 -12
  217. package/dist/core/search/bm25.d.ts +16 -16
  218. package/dist/core/search/cache.d.ts +34 -34
  219. package/dist/core/search/corpus.d.ts +17 -17
  220. package/dist/core/search/embedding-batches.d.ts +25 -25
  221. package/dist/core/search/eval-thresholds.d.ts +4 -4
  222. package/dist/core/search/eval.d.ts +40 -40
  223. package/dist/core/search/http-client.d.ts +24 -24
  224. package/dist/core/search/providers.d.ts +30 -30
  225. package/dist/core/search/relevance.d.ts +17 -17
  226. package/dist/core/search/semantic-defaults.d.ts +5 -5
  227. package/dist/core/search/staleness.d.ts +3 -3
  228. package/dist/core/search/vector-stores.d.ts +51 -51
  229. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  230. package/dist/core/sentry/helpers.d.ts +27 -27
  231. package/dist/core/sentry/instrument.d.ts +51 -51
  232. package/dist/core/sentry/instrument.js +1 -1
  233. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  234. package/dist/core/sentry/sensitive-assignments.js +2 -0
  235. package/dist/core/session/session-state.d.ts +37 -37
  236. package/dist/core/shared/agent-session-context.d.ts +14 -14
  237. package/dist/core/shared/author.d.ts +89 -89
  238. package/dist/core/shared/command-line.d.ts +3 -3
  239. package/dist/core/shared/command-types.d.ts +20 -20
  240. package/dist/core/shared/conflict-markers.d.ts +5 -5
  241. package/dist/core/shared/constants.d.ts +30 -30
  242. package/dist/core/shared/errors.d.ts +100 -100
  243. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  244. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  245. package/dist/core/shared/lazy-module.d.ts +1 -1
  246. package/dist/core/shared/levenshtein.d.ts +1 -1
  247. package/dist/core/shared/memo.d.ts +1 -1
  248. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  249. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  250. package/dist/core/shared/primitives.d.ts +13 -13
  251. package/dist/core/shared/secret-rules.d.ts +92 -92
  252. package/dist/core/shared/serial-queue.d.ts +6 -6
  253. package/dist/core/shared/serialization.d.ts +4 -4
  254. package/dist/core/shared/split-comma-list.d.ts +4 -4
  255. package/dist/core/shared/text-normalization.d.ts +3 -3
  256. package/dist/core/shared/time.d.ts +27 -27
  257. package/dist/core/store/item-format-migration.d.ts +7 -7
  258. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  259. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  260. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  261. package/dist/core/store/item-store.d.ts +123 -123
  262. package/dist/core/store/item-store.js +1 -1
  263. package/dist/core/store/paths.d.ts +27 -27
  264. package/dist/core/store/settings-concurrency.d.ts +1 -1
  265. package/dist/core/store/settings-read-cache.d.ts +11 -11
  266. package/dist/core/store/settings-validator.d.ts +117 -117
  267. package/dist/core/store/settings.d.ts +84 -84
  268. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  269. package/dist/core/store/tracker-preflight.d.ts +3 -3
  270. package/dist/core/telemetry/consent.d.ts +1 -1
  271. package/dist/core/telemetry/observability.d.ts +16 -16
  272. package/dist/core/telemetry/policy.d.ts +7 -7
  273. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  274. package/dist/core/telemetry/runtime.d.ts +275 -275
  275. package/dist/core/test/background-runs.d.ts +123 -123
  276. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  277. package/dist/core/test/run-selectors.d.ts +12 -12
  278. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  279. package/dist/core/validate/fix-planning.d.ts +36 -36
  280. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  281. package/dist/core/validate/missing-by-type.d.ts +3 -3
  282. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  283. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  284. package/dist/mcp/http-server.d.ts +26 -26
  285. package/dist/mcp/legacy-adapter.d.ts +18 -18
  286. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  287. package/dist/mcp/server.d.ts +73 -73
  288. package/dist/mcp/tool-definitions.d.ts +27 -27
  289. package/dist/sdk/actionability.d.ts +1 -1
  290. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  291. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  292. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  293. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  294. package/dist/sdk/agent/identity-config.d.ts +18 -18
  295. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  296. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  297. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  298. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  299. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  300. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  301. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  302. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  303. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  304. package/dist/sdk/agent-session-context.d.ts +1 -1
  305. package/dist/sdk/annotations.d.ts +74 -74
  306. package/dist/sdk/author-attribution.d.ts +47 -47
  307. package/dist/sdk/authoring.d.ts +9 -9
  308. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  309. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  310. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  311. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  312. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  313. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  314. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  315. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  316. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  317. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  318. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  319. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  320. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  321. package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
  322. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  323. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  324. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  325. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  326. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  327. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  328. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  329. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  330. package/dist/sdk/cli-contracts.d.ts +15 -15
  331. package/dist/sdk/cli-program.d.ts +1 -1
  332. package/dist/sdk/cli-program.js +1 -1
  333. package/dist/sdk/command-line.d.ts +3 -3
  334. package/dist/sdk/comments.d.ts +24 -24
  335. package/dist/sdk/compile-cache.d.ts +4 -4
  336. package/dist/sdk/completion/bash.d.ts +1 -1
  337. package/dist/sdk/completion/fish.d.ts +1 -1
  338. package/dist/sdk/completion/shared.d.ts +74 -74
  339. package/dist/sdk/completion/zsh.d.ts +1 -1
  340. package/dist/sdk/completion.d.ts +3 -3
  341. package/dist/sdk/compose.d.ts +94 -94
  342. package/dist/sdk/config.d.ts +105 -105
  343. package/dist/sdk/context/recency.d.ts +1 -1
  344. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  345. package/dist/sdk/context/usage-egress.d.ts +1 -1
  346. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  347. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  348. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  349. package/dist/sdk/context-packing.d.ts +44 -44
  350. package/dist/sdk/context-relevance.d.ts +110 -110
  351. package/dist/sdk/context-signal-store.d.ts +52 -52
  352. package/dist/sdk/context-usage.d.ts +78 -78
  353. package/dist/sdk/contracts.d.ts +2 -1
  354. package/dist/sdk/contracts.js +1 -1
  355. package/dist/sdk/core-governance.d.ts +5 -5
  356. package/dist/sdk/core.d.ts +8 -8
  357. package/dist/sdk/corpus-shape.d.ts +60 -60
  358. package/dist/sdk/define.d.ts +36 -36
  359. package/dist/sdk/dependencies.d.ts +70 -70
  360. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  361. package/dist/sdk/dependency-provenance.d.ts +22 -22
  362. package/dist/sdk/docs.d.ts +17 -17
  363. package/dist/sdk/duplicates.d.ts +14 -14
  364. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  365. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  366. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  367. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  368. package/dist/sdk/environment/source-context.d.ts +4 -4
  369. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  370. package/dist/sdk/error-code-catalog.d.ts +33 -33
  371. package/dist/sdk/error-runtime.d.ts +5 -5
  372. package/dist/sdk/errors.d.ts +17 -17
  373. package/dist/sdk/eval.d.ts +27 -27
  374. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  375. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  376. package/dist/sdk/extension/concurrency.d.ts +1 -1
  377. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  378. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  379. package/dist/sdk/extension/describe.d.ts +21 -21
  380. package/dist/sdk/extension/doctor.d.ts +46 -46
  381. package/dist/sdk/extension/install-plan.d.ts +32 -32
  382. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  383. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  384. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  385. package/dist/sdk/extension/install-sources.d.ts +106 -106
  386. package/dist/sdk/extension/managed-state.d.ts +42 -42
  387. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  388. package/dist/sdk/extension/migrations.d.ts +48 -48
  389. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  390. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  391. package/dist/sdk/extension/scaffold.d.ts +15 -15
  392. package/dist/sdk/extension/shared.d.ts +16 -16
  393. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  394. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  395. package/dist/sdk/extension/update-check.d.ts +9 -9
  396. package/dist/sdk/extension-command-context.d.ts +1 -1
  397. package/dist/sdk/extension-contracts.d.ts +10 -10
  398. package/dist/sdk/extension.d.ts +221 -221
  399. package/dist/sdk/files.d.ts +101 -101
  400. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  401. package/dist/sdk/flag-invocation-contracts.js +1 -1
  402. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  403. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  404. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  405. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  406. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  407. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  408. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  409. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  410. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  411. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  412. package/dist/sdk/governance/assurance.d.ts +204 -204
  413. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  414. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  415. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  416. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  417. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  418. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  419. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  420. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  421. package/dist/sdk/governance/gc.d.ts +26 -26
  422. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  423. package/dist/sdk/governance/health.d.ts +172 -172
  424. package/dist/sdk/governance/health.js +1 -1
  425. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  426. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  427. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  428. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  429. package/dist/sdk/governance/reindex.d.ts +102 -102
  430. package/dist/sdk/governance/reliability.d.ts +29 -29
  431. package/dist/sdk/governance/stale-work.d.ts +13 -13
  432. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  433. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  434. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  435. package/dist/sdk/governance/upgrade.d.ts +77 -77
  436. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  437. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  438. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  439. package/dist/sdk/governance/validate.d.ts +176 -176
  440. package/dist/sdk/governance/validate.js +1 -1
  441. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  442. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  443. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  444. package/dist/sdk/governance.d.ts +2 -2
  445. package/dist/sdk/graph/adapter.d.ts +45 -45
  446. package/dist/sdk/graph/analytics.d.ts +36 -36
  447. package/dist/sdk/graph/assembly.d.ts +51 -51
  448. package/dist/sdk/graph/cache.d.ts +19 -19
  449. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  450. package/dist/sdk/graph/centrality.d.ts +20 -20
  451. package/dist/sdk/graph/conformance.d.ts +21 -21
  452. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  453. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  454. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  455. package/dist/sdk/graph/governance.d.ts +92 -92
  456. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  457. package/dist/sdk/graph/index.d.ts +15 -15
  458. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  459. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  460. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  461. package/dist/sdk/graph/remediation.d.ts +15 -15
  462. package/dist/sdk/graph/run.d.ts +203 -203
  463. package/dist/sdk/graph/scheduling.d.ts +21 -21
  464. package/dist/sdk/graph/traversal.d.ts +18 -18
  465. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  466. package/dist/sdk/guide-topics.d.ts +19 -19
  467. package/dist/sdk/guide.d.ts +43 -43
  468. package/dist/sdk/history/attestation-command.d.ts +8 -8
  469. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  470. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  471. package/dist/sdk/history/attestation.d.ts +4 -4
  472. package/dist/sdk/history/maintenance.d.ts +25 -25
  473. package/dist/sdk/history/salvage.d.ts +19 -19
  474. package/dist/sdk/history/subject.d.ts +8 -8
  475. package/dist/sdk/history-analytics.d.ts +64 -64
  476. package/dist/sdk/history-compact.d.ts +67 -67
  477. package/dist/sdk/history-mcp.d.ts +7 -7
  478. package/dist/sdk/history-provenance.d.ts +40 -40
  479. package/dist/sdk/history-read.d.ts +24 -24
  480. package/dist/sdk/history-redact.d.ts +68 -68
  481. package/dist/sdk/history-repair.d.ts +92 -92
  482. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  483. package/dist/sdk/improvement-ledger.d.ts +62 -62
  484. package/dist/sdk/index.d.ts +69 -69
  485. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  486. package/dist/sdk/init.d.ts +117 -117
  487. package/dist/sdk/invocation-author.d.ts +1 -1
  488. package/dist/sdk/item-children.d.ts +15 -15
  489. package/dist/sdk/item-metadata-index.d.ts +2 -2
  490. package/dist/sdk/item-schedule.d.ts +9 -9
  491. package/dist/sdk/item-transaction.d.ts +73 -73
  492. package/dist/sdk/learnings.d.ts +23 -23
  493. package/dist/sdk/lifecycle/append.d.ts +8 -8
  494. package/dist/sdk/lifecycle/claim.d.ts +38 -38
  495. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  496. package/dist/sdk/lifecycle/close.d.ts +18 -18
  497. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  498. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  499. package/dist/sdk/lifecycle/create.d.ts +88 -88
  500. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  501. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  502. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  503. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  504. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  505. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  506. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  507. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  508. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  509. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  510. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  511. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  512. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  513. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  514. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  515. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  516. package/dist/sdk/lifecycle/restore.js +1 -1
  517. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  518. package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
  519. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  520. package/dist/sdk/lifecycle/update.d.ts +120 -120
  521. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  522. package/dist/sdk/lifecycle-policy.d.ts +31 -31
  523. package/dist/sdk/linked-artifacts.d.ts +58 -58
  524. package/dist/sdk/mcp/apps.d.ts +28 -28
  525. package/dist/sdk/mcp/authorization.d.ts +66 -66
  526. package/dist/sdk/mcp/discovery.d.ts +67 -67
  527. package/dist/sdk/mcp/interactions.d.ts +49 -49
  528. package/dist/sdk/mcp/protocol.d.ts +63 -63
  529. package/dist/sdk/mcp/skills.d.ts +62 -62
  530. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  531. package/dist/sdk/mcp/tasks.d.ts +51 -51
  532. package/dist/sdk/mcp/transport.d.ts +17 -17
  533. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  534. package/dist/sdk/merge/driver.d.ts +38 -38
  535. package/dist/sdk/merge/index.d.ts +5 -5
  536. package/dist/sdk/merge/install.d.ts +48 -48
  537. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  538. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  539. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  540. package/dist/sdk/merge/receipts.d.ts +111 -111
  541. package/dist/sdk/merge/reconcile.d.ts +20 -20
  542. package/dist/sdk/merge/three-way.d.ts +50 -50
  543. package/dist/sdk/merge/three-way.js +2 -2
  544. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  545. package/dist/sdk/mutation-events.d.ts +62 -62
  546. package/dist/sdk/mutation-guard.d.ts +134 -134
  547. package/dist/sdk/notes.d.ts +28 -28
  548. package/dist/sdk/output/table-rows.d.ts +6 -6
  549. package/dist/sdk/output-contracts.d.ts +26 -26
  550. package/dist/sdk/output-projection.d.ts +108 -108
  551. package/dist/sdk/output-token-accounting.d.ts +18 -18
  552. package/dist/sdk/output.d.ts +18 -18
  553. package/dist/sdk/ownership-source.d.ts +1 -1
  554. package/dist/sdk/package-import-adapters.d.ts +51 -51
  555. package/dist/sdk/package-migrations.d.ts +3 -3
  556. package/dist/sdk/package-runtime-options.d.ts +3 -3
  557. package/dist/sdk/pagination.d.ts +28 -28
  558. package/dist/sdk/pagination.js +1 -1
  559. package/dist/sdk/profile.d.ts +72 -72
  560. package/dist/sdk/provenance.d.ts +37 -37
  561. package/dist/sdk/public-surface.json +1 -1
  562. package/dist/sdk/query/activity.d.ts +84 -84
  563. package/dist/sdk/query/aggregate.d.ts +109 -109
  564. package/dist/sdk/query/calendar.d.ts +95 -95
  565. package/dist/sdk/query/complete-list.d.ts +35 -35
  566. package/dist/sdk/query/context.d.ts +300 -300
  567. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  568. package/dist/sdk/query/get.d.ts +54 -54
  569. package/dist/sdk/query/history.d.ts +38 -38
  570. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  571. package/dist/sdk/query/light-metadata.d.ts +1 -1
  572. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  573. package/dist/sdk/query/list.d.ts +167 -167
  574. package/dist/sdk/query/list.js +1 -1
  575. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  576. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  577. package/dist/sdk/query/next.d.ts +94 -94
  578. package/dist/sdk/query/parsers.d.ts +3 -3
  579. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  580. package/dist/sdk/query/search/corpus.d.ts +15 -15
  581. package/dist/sdk/query/search/filters.d.ts +15 -15
  582. package/dist/sdk/query/search/input.d.ts +8 -8
  583. package/dist/sdk/query/search/lexical.d.ts +10 -10
  584. package/dist/sdk/query/search/response.d.ts +22 -22
  585. package/dist/sdk/query/search/semantic.d.ts +133 -133
  586. package/dist/sdk/query/search/types.d.ts +65 -65
  587. package/dist/sdk/query/search-contracts.d.ts +53 -53
  588. package/dist/sdk/query/search-pagination.d.ts +21 -21
  589. package/dist/sdk/query/search-rendering.d.ts +30 -30
  590. package/dist/sdk/query/search.d.ts +60 -60
  591. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  592. package/dist/sdk/query.d.ts +6 -6
  593. package/dist/sdk/read-output/continuation.d.ts +11 -11
  594. package/dist/sdk/read-output/extension.d.ts +3 -3
  595. package/dist/sdk/read-output/options.d.ts +7 -7
  596. package/dist/sdk/read-output/provenance.d.ts +6 -6
  597. package/dist/sdk/read-output-budget.d.ts +11 -11
  598. package/dist/sdk/read-output-contracts.d.ts +112 -112
  599. package/dist/sdk/read-output-contracts.js +1 -1
  600. package/dist/sdk/read-output-rows.d.ts +15 -15
  601. package/dist/sdk/read-output-session.d.ts +29 -29
  602. package/dist/sdk/relationship-analytics.d.ts +46 -46
  603. package/dist/sdk/relationship-context.d.ts +48 -48
  604. package/dist/sdk/relationship-history.d.ts +59 -59
  605. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  606. package/dist/sdk/relationship-migration.d.ts +14 -14
  607. package/dist/sdk/relationships.d.ts +46 -46
  608. package/dist/sdk/reproducibility/process.d.ts +9 -9
  609. package/dist/sdk/runtime/actions.d.ts +1 -1
  610. package/dist/sdk/runtime/context.d.ts +15 -15
  611. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  612. package/dist/sdk/runtime/schema.d.ts +1 -1
  613. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  614. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  615. package/dist/sdk/runtime-input.d.ts +29 -29
  616. package/dist/sdk/runtime-primitives.d.ts +53 -53
  617. package/dist/sdk/runtime-primitives.js +1 -1
  618. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  619. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  620. package/dist/sdk/runtime.d.ts +374 -374
  621. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  622. package/dist/sdk/schema-migration.d.ts +79 -79
  623. package/dist/sdk/schema.d.ts +224 -224
  624. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  625. package/dist/sdk/similarity-scoring.d.ts +10 -10
  626. package/dist/sdk/similarity.d.ts +73 -73
  627. package/dist/sdk/start-task-status.d.ts +1 -1
  628. package/dist/sdk/stats.d.ts +72 -72
  629. package/dist/sdk/structured-mutations.d.ts +13 -13
  630. package/dist/sdk/telemetry-flush.d.ts +1 -1
  631. package/dist/sdk/telemetry.d.ts +32 -32
  632. package/dist/sdk/templates.d.ts +35 -35
  633. package/dist/sdk/test/batch.d.ts +50 -50
  634. package/dist/sdk/test/command-args.d.ts +2 -2
  635. package/dist/sdk/test/entry.d.ts +4 -4
  636. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  637. package/dist/sdk/test/execution.d.ts +247 -247
  638. package/dist/sdk/test/json-path.d.ts +4 -4
  639. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  640. package/dist/sdk/test/measurements.d.ts +10 -10
  641. package/dist/sdk/test/parsers.d.ts +18 -18
  642. package/dist/sdk/test/prerequisites.d.ts +3 -3
  643. package/dist/sdk/test/runs.d.ts +43 -43
  644. package/dist/sdk/test/trust.d.ts +15 -15
  645. package/dist/sdk/test/update.d.ts +23 -23
  646. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  647. package/dist/sdk/testing.d.ts +248 -248
  648. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  649. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  650. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  651. package/dist/sdk/workspace-contracts.d.ts +20 -20
  652. package/dist/sdk/workspace-memory.d.ts +42 -42
  653. package/dist/sdk/workspace-recipe.d.ts +9 -9
  654. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  655. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  656. package/dist/sdk/workspace-transaction.d.ts +26 -26
  657. package/dist/sdk/workspace.d.ts +9 -9
  658. package/dist/types.d.ts +540 -540
  659. package/docs/COMMANDS.md +11 -2
  660. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
  661. package/docs/LINKED_TEST_EDITS.md +15 -0
  662. package/docs/RELEASING.md +2 -0
  663. package/docs/TESTING.md +21 -1
  664. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
  665. package/marketplace.json +1 -1
  666. package/package.json +3 -1
  667. package/packages/pm-beads/package.json +1 -1
  668. package/packages/pm-calendar/package.json +1 -1
  669. package/packages/pm-command-kit/package.json +1 -1
  670. package/packages/pm-digital-twin/package.json +1 -1
  671. package/packages/pm-governance-audit/package.json +1 -1
  672. package/packages/pm-guide-shell/package.json +1 -1
  673. package/packages/pm-kanban/package.json +1 -1
  674. package/packages/pm-lifecycle-hooks/package.json +1 -1
  675. package/packages/pm-linked-test-adapters/package.json +1 -1
  676. package/packages/pm-search-advanced/package.json +1 -1
  677. package/packages/pm-templates/package.json +1 -1
  678. package/packages/pm-todos/package.json +1 -1
  679. package/packages/pm-vcs/package.json +1 -1
  680. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  681. package/plugins/pm-claude/package.json +1 -1
  682. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  683. package/plugins/pm-codex/package.json +1 -1
  684. package/plugins/pm-codex/plugin.json +1 -1
  685. package/runtime-dependencies.json +1 -1
  686. package/scripts/finalize-build.mjs +9 -3
  687. package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
  688. package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
  689. package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
  690. package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
  691. package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
  692. package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
@@ -17,44 +17,44 @@ export type StaleLinkClassification = "moved" | "deleted" | "malformed";
17
17
  /** Documents the stale link owner input payload exchanged by command, SDK, and package integrations. */
18
18
  export interface StaleLinkOwnerInput {
19
19
  /** Value that configures or reports item id for this contract. */
20
- item_id: string;
20
+ item_id:string;
21
21
  /** Normalized workspace-relative path that no longer resolves. */
22
- path: string;
22
+ path:string;
23
23
  /** Which link list of the owning item the path lives in. */
24
- link_kind: "files" | "docs";
24
+ link_kind:"files" | "docs";
25
25
  /** Value that configures or reports classification for this contract. */
26
- classification: StaleLinkClassification;
26
+ classification:StaleLinkClassification;
27
27
  }
28
28
  /** Documents the missing linked path owner payload exchanged by command, SDK, and package integrations. */
29
29
  export interface MissingLinkedPathOwner {
30
30
  /** Stable identifier used to reference this record across commands and storage. */
31
- id: string;
31
+ id:string;
32
32
  /** Owning item type, `"Unknown"` if metadata is absent. */
33
- type: string;
33
+ type:string;
34
34
  /** Owning item title, `""` if absent. */
35
- title: string;
35
+ title:string;
36
36
  /** Owning item status, `""` if absent. */
37
- status: string;
37
+ status:string;
38
38
  /** The link list the path lives in (= the input `link_kind`). */
39
- field: "files" | "docs";
39
+ field:"files" | "docs";
40
40
  }
41
41
  /** Documents the missing linked path row payload exchanged by command, SDK, and package integrations. */
42
42
  export interface MissingLinkedPathRow {
43
43
  /** Filesystem path used for path resolution. */
44
- path: string;
44
+ path:string;
45
45
  /** Value that configures or reports classification for this contract. */
46
- classification: StaleLinkClassification;
46
+ classification:StaleLinkClassification;
47
47
  /** Value that configures or reports items for this contract. */
48
- items: MissingLinkedPathOwner[];
48
+ items:MissingLinkedPathOwner[];
49
49
  }
50
50
  /** Documents the owner item metadata payload exchanged by command, SDK, and package integrations. */
51
51
  export interface OwnerItemMetadata {
52
52
  /** Schema type that determines the shape and validation rules for this value. */
53
- type?: string;
53
+ type?:string;
54
54
  /** Value that configures or reports title for this contract. */
55
- title?: string;
55
+ title?:string;
56
56
  /** Lifecycle state reported for status. */
57
- status?: string;
57
+ status?:string;
58
58
  }
59
59
  /**
60
60
  * Group stale-link owner inputs by linked path and attach owning-item metadata.
@@ -65,7 +65,7 @@ status?: string;
65
65
  * - `classification` per path follows {@link preferClassification} (moved wins).
66
66
  * - Missing metadata falls back: type `"Unknown"`, title `""`, status `""`.
67
67
  */
68
- export declare function buildMissingLinkedPathRows(rows: readonly StaleLinkOwnerInput[], lookup: (itemId: string) => OwnerItemMetadata | undefined): MissingLinkedPathRow[];
68
+ export declare function buildMissingLinkedPathRows(rows:readonly StaleLinkOwnerInput[],lookup:(itemId:string) => OwnerItemMetadata | undefined):MissingLinkedPathRow[];
69
69
  /**
70
70
  * Token-efficient one-line-per-owner serialization for the files-check details
71
71
  * (compact text counterpart to the full {@link MissingLinkedPathRow} objects).
@@ -75,4 +75,4 @@ export declare function buildMissingLinkedPathRows(rows: readonly StaleLinkOwner
75
75
  * render (`status=` and `title=""`). Order follows
76
76
  * {@link buildMissingLinkedPathRows} output order.
77
77
  */
78
- export declare function summarizeMissingLinkedPathRows(rows: readonly MissingLinkedPathRow[]): string[];
78
+ export declare function summarizeMissingLinkedPathRows(rows:readonly MissingLinkedPathRow[]):string[];
@@ -18,17 +18,17 @@ export type StaleLinkedPathClassification = "moved" | "deleted" | "malformed";
18
18
  /** Documents the classified stale linked path payload exchanged by command, SDK, and package integrations. */
19
19
  export interface ClassifiedStaleLinkedPath {
20
20
  /** Normalized workspace-relative stale linked path. */
21
- path: string;
21
+ path:string;
22
22
  /** Value that configures or reports classification for this contract. */
23
- classification: StaleLinkedPathClassification;
23
+ classification:StaleLinkedPathClassification;
24
24
  /** Candidate new locations (same basename, different path), sorted and capped at `candidateLimit`. Empty for `deleted` and `malformed`. */
25
- candidates: string[];
25
+ candidates:string[];
26
26
  /** True when more candidates existed than `candidateLimit` allowed. */
27
- candidates_truncated: boolean;
27
+ candidates_truncated:boolean;
28
28
  }
29
29
  /** Fallback stale path candidate limit used when callers do not provide an override. */
30
30
  export declare const DEFAULT_STALE_PATH_CANDIDATE_LIMIT = 3;
31
31
  /** Classify each stale (missing) linked path as `moved`, `deleted`, or `malformed` by matching its basename against the candidate file list. Output preserves the input order of `stalePaths` (callers pass an already-sorted unique list). A candidate equal to the stale path itself never matches (the path is known missing; an identical candidate would be self-referential noise). */
32
- export declare function classifyStaleLinkedPaths(stalePaths: readonly string[], candidateFiles: readonly string[], candidateLimit?: number): ClassifiedStaleLinkedPath[];
32
+ export declare function classifyStaleLinkedPaths(stalePaths:readonly string[],candidateFiles:readonly string[],candidateLimit?:number):ClassifiedStaleLinkedPath[];
33
33
  /** Render compact `<path>:moved:<top-candidate>` / `<path>:deleted` rows for the files check details (token-efficient counterpart to the full classification objects). */
34
- export declare function summarizeStaleLinkedPathClassifications(classified: readonly ClassifiedStaleLinkedPath[]): string[];
34
+ export declare function summarizeStaleLinkedPathClassifications(classified:readonly ClassifiedStaleLinkedPath[]):string[];
@@ -5,56 +5,56 @@
5
5
  * Serves the pm MCP dispatcher through the sessionless 2026-07-28 Streamable
6
6
  * HTTP POST binding with request-scoped JSON/SSE responses.
7
7
  */
8
- import { type IncomingMessage, type Server, type ServerResponse } from "node:http";
9
- import { type PmMcpHttpAuthorizationPolicy, type PmMcpProtectedResourceMetadata } from "../sdk/mcp/authorization.js";
8
+ import { type IncomingMessage,type Server,type ServerResponse } from "node:http";
9
+ import { type PmMcpHttpAuthorizationPolicy,type PmMcpProtectedResourceMetadata } from "../sdk/mcp/authorization.js";
10
10
  import { type JsonRpcRequest } from "./server.js";
11
11
  /** Runtime options for one real Streamable HTTP server. */
12
12
  export interface PmMcpHttpServerOptions {
13
13
  /** Local bind host. Defaults to the DNS-rebinding-safe loopback address. */
14
- host?: string;
14
+ host?:string;
15
15
  /** TCP port. Zero requests an ephemeral port. */
16
- port?: number;
16
+ port?:number;
17
17
  /** Single modern MCP POST endpoint. */
18
- endpointPath?: string;
18
+ endpointPath?:string;
19
19
  /** Exact browser origins permitted when an Origin header is present. */
20
- allowedOrigins?: readonly string[];
20
+ allowedOrigins?:readonly string[];
21
21
  /** Optional RFC 9728/OAuth resource-server policy. */
22
- authorization?: PmMcpHttpAuthorizationPolicy;
22
+ authorization?:PmMcpHttpAuthorizationPolicy;
23
23
  /** Metadata served at RFC 9728 well-known paths. */
24
- protectedResourceMetadata?: PmMcpProtectedResourceMetadata;
24
+ protectedResourceMetadata?:PmMcpProtectedResourceMetadata;
25
25
  /** Maximum accepted JSON request bytes. */
26
- maximumBodyBytes?: number;
26
+ maximumBodyBytes?:number;
27
27
  /** SSE comment interval; zero disables keep-alives. */
28
- keepAliveMs?: number;
28
+ keepAliveMs?:number;
29
29
  /** Optional embedding dispatcher; defaults to the canonical pm MCP handler. */
30
- requestHandler?: (request: JsonRpcRequest) => unknown | Promise<unknown>;
30
+ requestHandler?:(request:JsonRpcRequest) => unknown | Promise<unknown>;
31
31
  }
32
32
  /** Write one SSE event and wait for transport backpressure to clear. */
33
- export declare function writePmMcpSseEvent(response: ServerResponse, payload: unknown): Promise<void>;
34
- declare function writeMcpHttpDispatchError(response: ServerResponse, rpcRequest: JsonRpcRequest | undefined, error: unknown): void;
35
- declare function destroyFailedMcpHttpResponse(response: ServerResponse, error: unknown): void;
33
+ export declare function writePmMcpSseEvent(response:ServerResponse,payload:unknown):Promise<void>;
34
+ declare function writeMcpHttpDispatchError(response:ServerResponse,rpcRequest:JsonRpcRequest | undefined,error:unknown):void;
35
+ declare function destroyFailedMcpHttpResponse(response:ServerResponse,error:unknown):void;
36
36
  /** Create a configured HTTP server without binding it. */
37
- export declare function createPmMcpHttpServer(options?: PmMcpHttpServerOptions): Server<typeof IncomingMessage, typeof ServerResponse>;
37
+ export declare function createPmMcpHttpServer(options?:PmMcpHttpServerOptions):Server<typeof IncomingMessage,typeof ServerResponse>;
38
38
  /** Gracefully close subscriptions before stopping a Streamable HTTP server. */
39
- export declare function closePmMcpHttpServer(server: Server): Promise<void>;
39
+ export declare function closePmMcpHttpServer(server:Server):Promise<void>;
40
40
  /** Bind the configured Streamable HTTP server and return its actual address. */
41
- export declare function startPmMcpHttpServer(options?: PmMcpHttpServerOptions): Promise<ReturnType<typeof createPmMcpHttpServer>>;
41
+ export declare function startPmMcpHttpServer(options?:PmMcpHttpServerOptions):Promise<ReturnType<typeof createPmMcpHttpServer>>;
42
42
  /** Resolve loopback-safe bind defaults without opening a socket. */
43
- export declare function resolvePmMcpHttpListenAddress(options?: Pick<PmMcpHttpServerOptions, "host" | "port">): {
44
- host: string;
45
- port: number;
43
+ export declare function resolvePmMcpHttpListenAddress(options?:Pick<PmMcpHttpServerOptions,"host" | "port">):{
44
+ host:string;
45
+ port:number;
46
46
  };
47
47
  /** Resolve and harden executable HTTP options from an environment map. */
48
- export declare function resolvePmMcpHttpServerOptionsFromEnvironment(processEnvironment?: NodeJS.ProcessEnv): PmMcpHttpServerOptions;
48
+ export declare function resolvePmMcpHttpServerOptionsFromEnvironment(processEnvironment?:NodeJS.ProcessEnv):PmMcpHttpServerOptions;
49
49
  /** Internal HTTP transport seams used only by direct integration tests. */
50
- export declare const _testOnly: {
50
+ export declare const _testOnly:{
51
51
  /** Return the first active request-scoped transport key for one server. */
52
- activeSubscriptionKey: (server: Server) => symbol | undefined;
52
+ activeSubscriptionKey:(server:Server) => symbol | undefined;
53
53
  /** Open a stream against one server runtime without a network socket. */
54
- openHttpSubscription: (server: Server, request: JsonRpcRequest, response: ServerResponse) => Promise<void>;
54
+ openHttpSubscription:(server:Server,request:JsonRpcRequest,response:ServerResponse) => Promise<void>;
55
55
  /** Exercise committed-response handling without a network race. */
56
- writeMcpHttpDispatchError: typeof writeMcpHttpDispatchError;
56
+ writeMcpHttpDispatchError:typeof writeMcpHttpDispatchError;
57
57
  /** Exercise the terminal request rejection handler without a live socket. */
58
- destroyFailedMcpHttpResponse: typeof destroyFailedMcpHttpResponse;
58
+ destroyFailedMcpHttpResponse:typeof destroyFailedMcpHttpResponse;
59
59
  };
60
60
  export {};
@@ -5,36 +5,36 @@
5
5
  * canonical stateless dispatcher. No modern transport imports policy from it.
6
6
  */
7
7
  import { type AgentClientInfo } from "../sdk/runtime-primitives.js";
8
- import { PM_MCP_LEGACY_PROTOCOL_VERSIONS, type PmMcpImplementation, type PmMcpServerCapabilities } from "../sdk/mcp/protocol.js";
8
+ import { PM_MCP_LEGACY_PROTOCOL_VERSIONS,type PmMcpImplementation,type PmMcpServerCapabilities } from "../sdk/mcp/protocol.js";
9
9
  /** Minimal request shape consumed by the compatibility adapter. */
10
10
  export interface LegacyMcpRequest {
11
11
  /** Legacy method name. */
12
- method?: string;
12
+ method?:string;
13
13
  /** Legacy method parameters. */
14
- params?: Record<string, unknown>;
14
+ params?:Record<string,unknown>;
15
15
  }
16
16
  /** Host callbacks keep this adapter separate from canonical SDK policy. */
17
17
  export interface LegacyMcpAdapterOptions {
18
18
  /** Immutable server identity. */
19
- serverInfo: PmMcpImplementation;
19
+ serverInfo:PmMcpImplementation;
20
20
  /** Compatibility-era capabilities. */
21
- capabilities: PmMcpServerCapabilities;
21
+ capabilities:PmMcpServerCapabilities;
22
22
  /** Model-facing usage instructions. */
23
- instructions: string;
23
+ instructions:string;
24
24
  /** Parse bounded historical client identity. */
25
- parseClientInfo: (value: unknown) => AgentClientInfo | undefined;
25
+ parseClientInfo:(value:unknown) => AgentClientInfo | undefined;
26
26
  /** Resolve legacy tool definitions. */
27
- listTools: (params: Record<string, unknown> | undefined) => Promise<Record<string, unknown>>;
27
+ listTools:(params:Record<string,unknown> | undefined) => Promise<Record<string,unknown>>;
28
28
  /** Execute one legacy tool call. */
29
- callTool: (params: Record<string, unknown> | undefined, clientInfo: AgentClientInfo | undefined) => Promise<Record<string, unknown>>;
29
+ callTool:(params:Record<string,unknown> | undefined,clientInfo:AgentClientInfo | undefined) => Promise<Record<string,unknown>>;
30
30
  /** List legacy resources. */
31
- listResources: () => Record<string, unknown>;
31
+ listResources:() => Record<string,unknown>;
32
32
  /** Read one legacy resource. */
33
- readResource: (params: Record<string, unknown> | undefined) => Promise<Record<string, unknown>>;
33
+ readResource:(params:Record<string,unknown> | undefined) => Promise<Record<string,unknown>>;
34
34
  /** List legacy prompts. */
35
- listPrompts: () => Record<string, unknown>;
35
+ listPrompts:() => Record<string,unknown>;
36
36
  /** Render one legacy prompt. */
37
- getPrompt: (params: Record<string, unknown> | undefined) => Record<string, unknown>;
37
+ getPrompt:(params:Record<string,unknown> | undefined) => Record<string,unknown>;
38
38
  }
39
39
  /**
40
40
  * Resolve the legacy revision a handshake negotiates, or refuse with the full
@@ -44,16 +44,16 @@ getPrompt: (params: Record<string, unknown> | undefined) => Record<string, unkno
44
44
  * accepted legacy revision alongside the canonical modern one: the error text
45
45
  * is the only diagnostic such a client can surface.
46
46
  */
47
- export declare function resolveLegacyProtocolVersion(requestedVersion: unknown): (typeof PM_MCP_LEGACY_PROTOCOL_VERSIONS)[number];
47
+ export declare function resolveLegacyProtocolVersion(requestedVersion:unknown):(typeof PM_MCP_LEGACY_PROTOCOL_VERSIONS)[number];
48
48
  /** Explicit compatibility adapter with no cross-process or modern-session role. */
49
49
  export declare class LegacyMcpAdapter {
50
50
  #private;
51
51
  /** Create one process-local legacy stdio adapter. */
52
- constructor(options: LegacyMcpAdapterOptions);
52
+ constructor(options:LegacyMcpAdapterOptions);
53
53
  /** Read the bounded identity most recently supplied to legacy initialize. */
54
- getClientInfo(): AgentClientInfo | undefined;
54
+ getClientInfo():AgentClientInfo | undefined;
55
55
  /** Validate and answer the historical initialize handshake. */
56
- initialize(params: Record<string, unknown> | undefined): Record<string, unknown>;
56
+ initialize(params:Record<string,unknown> | undefined):Record<string,unknown>;
57
57
  /** Dispatch one unversioned request through the finite legacy method set. */
58
- dispatch(request: LegacyMcpRequest): Promise<Record<string, unknown>>;
58
+ dispatch(request:LegacyMcpRequest):Promise<Record<string,unknown>>;
59
59
  }
@@ -5,53 +5,53 @@
5
5
  * public SDK contracts.
6
6
  */
7
7
  import { type PmMcpToolProfile } from "../sdk/agent-capability-contracts.js";
8
- import { type WorkspaceContracts, type WorkspaceExtensionCommandContract } from "../sdk/runtime.js";
8
+ import { type WorkspaceContracts,type WorkspaceExtensionCommandContract } from "../sdk/runtime.js";
9
9
  import { type ToolDefinition } from "./tool-definitions.js";
10
10
  /** Environment configuration accepted by the MCP profile resolver. */
11
11
  export interface McpProfileEnvironment {
12
12
  /** Named built-in or custom MCP surface profile. */
13
- PM_MCP_PROFILE?: string;
13
+ PM_MCP_PROFILE?:string;
14
14
  /** Comma-separated exact tool allowlist used by the custom profile. */
15
- PM_MCP_TOOLS?: string;
15
+ PM_MCP_TOOLS?:string;
16
16
  }
17
17
  /** Fully resolved MCP tool surface for one request workspace. */
18
18
  export interface ResolvedMcpToolSurface {
19
19
  /** Resolved profile after environment validation. */
20
- profile: PmMcpToolProfile;
20
+ profile:PmMcpToolProfile;
21
21
  /** Runtime-filtered and workspace-enriched MCP definitions. */
22
- tools: ToolDefinition[];
22
+ tools:ToolDefinition[];
23
23
  /** Extension action names reachable through the selected surface. */
24
- extensionActions: string[];
24
+ extensionActions:string[];
25
25
  }
26
26
  /** Profile decision for one tool call without projecting every tool schema. */
27
27
  export interface ResolvedMcpToolAccess {
28
28
  /** Resolved profile after environment validation. */
29
- profile: PmMcpToolProfile;
29
+ profile:PmMcpToolProfile;
30
30
  /** Whether the requested tool is callable in that profile and workspace. */
31
- available: boolean;
31
+ available:boolean;
32
32
  }
33
- declare function workspaceFields(workspace: Pick<WorkspaceContracts, "fields">): NonNullable<WorkspaceContracts["fields"]>;
34
- declare function workspaceExtensionCommands(workspace: Pick<WorkspaceContracts, "extensionCommands">): NonNullable<WorkspaceContracts["extensionCommands"]>;
33
+ declare function workspaceFields(workspace:Pick<WorkspaceContracts,"fields">):NonNullable<WorkspaceContracts["fields"]>;
34
+ declare function workspaceExtensionCommands(workspace:Pick<WorkspaceContracts,"extensionCommands">):NonNullable<WorkspaceContracts["extensionCommands"]>;
35
35
  /** Resolve and validate the configured MCP profile. */
36
- export declare function resolveMcpToolProfile(environment?: McpProfileEnvironment): PmMcpToolProfile;
36
+ export declare function resolveMcpToolProfile(environment?:McpProfileEnvironment):PmMcpToolProfile;
37
37
  /** Select extension actions visible to one validated MCP profile. */
38
- export declare function selectMcpExtensionActions(commands: readonly WorkspaceExtensionCommandContract[], profile: PmMcpToolProfile, selectedNames: ReadonlySet<string>): string[];
38
+ export declare function selectMcpExtensionActions(commands:readonly WorkspaceExtensionCommandContract[],profile:PmMcpToolProfile,selectedNames:ReadonlySet<string>):string[];
39
39
  /**
40
40
  * Resolve a profile-filtered tool list and enrich schemas with live workspace
41
41
  * types, statuses, custom fields, and extension actions.
42
42
  */
43
- export declare function resolveMcpToolSurface(availableTools: readonly ToolDefinition[], args?: Record<string, unknown>, environment?: McpProfileEnvironment): Promise<ResolvedMcpToolSurface>;
43
+ export declare function resolveMcpToolSurface(availableTools:readonly ToolDefinition[],args?:Record<string,unknown>,environment?:McpProfileEnvironment):Promise<ResolvedMcpToolSurface>;
44
44
  /**
45
45
  * Resolve one tool's callability without cloning and enriching the complete
46
46
  * schema surface. Only compact/standard `pm_run` calls need workspace
47
47
  * contracts because an activated extension action can promote that dispatcher.
48
48
  */
49
- export declare function resolveMcpToolAccess(availableTools: readonly ToolDefinition[], toolName: string, args?: Record<string, unknown>, environment?: McpProfileEnvironment): Promise<ResolvedMcpToolAccess>;
49
+ export declare function resolveMcpToolAccess(availableTools:readonly ToolDefinition[],toolName:string,args?:Record<string,unknown>,environment?:McpProfileEnvironment):Promise<ResolvedMcpToolAccess>;
50
50
  /** Move declared custom-field inputs into the runtime action option bag. */
51
- export declare function normalizeWorkspaceToolArguments(toolName: string, args: Record<string, unknown>): Promise<Record<string, unknown>>;
51
+ export declare function normalizeWorkspaceToolArguments(toolName:string,args:Record<string,unknown>):Promise<Record<string,unknown>>;
52
52
  /** Internal compatibility helpers exposed only for exhaustive fallback tests. */
53
- export declare const _testOnlyMcpRuntimeCapabilities: {
54
- workspaceExtensionCommands: typeof workspaceExtensionCommands;
55
- workspaceFields: typeof workspaceFields;
53
+ export declare const _testOnlyMcpRuntimeCapabilities:{
54
+ workspaceExtensionCommands:typeof workspaceExtensionCommands;
55
+ workspaceFields:typeof workspaceFields;
56
56
  };
57
57
  export {};
@@ -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";