@unbrained/pm-cli 2026.10.14 → 2026.10.17

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 (753) hide show
  1. package/.agents/skills/pm-developer/references/COMMAND_PLAYBOOK.md +1 -1
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/AGENTS.md +1 -0
  4. package/CHANGELOG.md +74 -2
  5. package/dist/cli/after-command-context-usage.d.ts +7 -7
  6. package/dist/cli/argv-utils.d.ts +4 -4
  7. package/dist/cli/bundle-integrity.d.ts +16 -16
  8. package/dist/cli/command-namespaces.d.ts +1 -1
  9. package/dist/cli/commander-usage.d.ts +34 -34
  10. package/dist/cli/commands/governance/validate.d.ts +1 -1
  11. package/dist/cli/commands/history/history-compact.d.ts +1 -1
  12. package/dist/cli/commands/history/history-redact.d.ts +1 -1
  13. package/dist/cli/commands/history/history-repair.d.ts +1 -1
  14. package/dist/cli/commands/history/restore.d.ts +1 -1
  15. package/dist/cli/commands/lifecycle/close.d.ts +1 -1
  16. package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
  17. package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
  18. package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
  19. package/dist/cli/commands/query/get.d.ts +1 -1
  20. package/dist/cli/commands/workspace/merge.d.ts +1 -1
  21. package/dist/cli/commands/workspace/schema.d.ts +1 -1
  22. package/dist/cli/context-intent-invocation.d.ts +1 -1
  23. package/dist/cli/description-stdin.d.ts +1 -1
  24. package/dist/cli/error-guidance.d.ts +119 -119
  25. package/dist/cli/extension-command-help.d.ts +64 -64
  26. package/dist/cli/extension-command-help.js +2 -2
  27. package/dist/cli/extension-command-options.d.ts +18 -16
  28. package/dist/cli/extension-command-options.js +1 -1
  29. package/dist/cli/extension-recovery.d.ts +13 -13
  30. package/dist/cli/help-content.d.ts +22 -22
  31. package/dist/cli/help-content.js +3 -3
  32. package/dist/cli/help-json-payload.d.ts +45 -45
  33. package/dist/cli/invocation-profile.d.ts +5 -5
  34. package/dist/cli/main.d.ts +217 -217
  35. package/dist/cli/migration-gates.d.ts +24 -24
  36. package/dist/cli/option-values.d.ts +1 -1
  37. package/dist/cli/public.d.ts +1 -1
  38. package/dist/cli/register-annotations.d.ts +2 -2
  39. package/dist/cli/register-assurance.d.ts +1 -1
  40. package/dist/cli/register-files-lookup.d.ts +1 -1
  41. package/dist/cli/register-history-activity.d.ts +1 -1
  42. package/dist/cli/register-history-author.d.ts +1 -1
  43. package/dist/cli/register-history-maintenance.d.ts +1 -1
  44. package/dist/cli/register-list-query.d.ts +7 -7
  45. package/dist/cli/register-list-query.js +3 -3
  46. package/dist/cli/register-mutation-options.d.ts +1 -1
  47. package/dist/cli/register-mutation.d.ts +4 -4
  48. package/dist/cli/register-mutation.js +2 -2
  49. package/dist/cli/register-operations.d.ts +75 -75
  50. package/dist/cli/register-operations.js +1 -1
  51. package/dist/cli/register-setup.d.ts +4 -4
  52. package/dist/cli/register-structured-mutation.d.ts +8 -13
  53. package/dist/cli/register-structured-mutation.js +1 -1
  54. package/dist/cli/runtime/activation.d.ts +23 -23
  55. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  56. package/dist/cli/runtime/invocation-options.js +1 -1
  57. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  58. package/dist/cli/runtime/selection.d.ts +16 -16
  59. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  60. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  61. package/dist/cli/schema/registration.d.ts +1 -1
  62. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  63. package/dist/cli/stats-analytics-json.d.ts +1 -1
  64. package/dist/cli-bundle/bundle-manifest.json +1 -1
  65. package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-3QKI3XNX.js} +2 -2
  66. package/dist/cli-bundle/chunks/chunk-4PNPDT2N.js +236 -0
  67. package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-6ZDKKOKM.js} +28 -28
  68. package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-B5QVGCZX.js} +2 -2
  69. package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-EA2CG7UM.js} +2 -2
  70. package/dist/cli-bundle/chunks/chunk-HY7FQ7QX.js +2 -0
  71. package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-J4LPQCET.js} +2 -2
  72. package/dist/cli-bundle/chunks/chunk-JS3B2M4D.js +6 -0
  73. package/dist/cli-bundle/chunks/chunk-O4YBC3OM.js +30 -0
  74. package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-OZCSXX4D.js} +63 -64
  75. package/dist/cli-bundle/chunks/chunk-VMCSTFSO.js +2 -0
  76. package/dist/cli-bundle/chunks/chunk-W3KZ22DW.js +2 -0
  77. package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-X2ONXFBP.js} +2 -2
  78. package/dist/cli-bundle/chunks/chunk-X53HM753.js +20 -0
  79. package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-RU3QZSAQ.js} +7 -7
  80. package/dist/cli-bundle/chunks/register-mutation-EQYMT32A.js +20 -0
  81. package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-VXBGE4XI.js} +2 -2
  82. package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-UUDEGFRO.js} +2 -2
  83. package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-2IOHHNRT.js} +2 -2
  84. package/dist/cli-bundle/focused-chunks/chunk-5JEFDEL3.js +166 -0
  85. package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-AH6NX6GM.js} +2 -2
  86. package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-E33QA7PK.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-FTUZ3JF2.js} +6 -6
  88. package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-JXR6UKFM.js} +3 -3
  89. package/dist/cli-bundle/focused-chunks/chunk-LDKX4KYJ.js +2 -0
  90. package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-MBQF6HT6.js} +2 -2
  91. package/dist/cli-bundle/focused-chunks/chunk-NZO7GOXD.js +20 -0
  92. package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-PYC7BF6Z.js} +2 -2
  93. package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-QOSVJDOO.js} +61 -62
  94. package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-RBLSY6ML.js} +2 -2
  95. package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-RHTH5ILM.js} +2 -2
  96. package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-SIGIGZCG.js} +3 -3
  97. package/dist/cli-bundle/focused-chunks/chunk-TRFVAWF2.js +26 -0
  98. package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-UNTQE37U.js} +2 -2
  99. package/dist/cli-bundle/main.js +22 -22
  100. package/dist/cli-bundle/sdk-authoring.js +1 -1
  101. package/dist/cli-bundle/sdk-contracts.js +2 -2
  102. package/dist/cli-bundle/sdk-core.js +23 -23
  103. package/dist/cli-bundle/sdk-governance.js +1 -1
  104. package/dist/cli-bundle/sdk-graph.js +1 -1
  105. package/dist/cli-bundle/sdk-merge.js +54 -54
  106. package/dist/cli-bundle/sdk-query.js +1 -1
  107. package/dist/cli-bundle/sdk-runtime.js +1 -1
  108. package/dist/cli-bundle/sdk-testing.js +1 -1
  109. package/dist/cli-bundle/sdk.js +7 -7
  110. package/dist/cli.d.ts +9 -9
  111. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  112. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  113. package/dist/core/config/nested-settings.d.ts +20 -20
  114. package/dist/core/config/positional-value.d.ts +9 -9
  115. package/dist/core/diagnostics/remediation.d.ts +7 -7
  116. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  117. package/dist/core/extensions/activation-summary.d.ts +30 -30
  118. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  119. package/dist/core/extensions/capability-usage.d.ts +25 -25
  120. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  121. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  122. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  123. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  124. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  125. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  126. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  127. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  128. package/dist/core/extensions/extension-policy.d.ts +62 -62
  129. package/dist/core/extensions/extension-registries.d.ts +8 -8
  130. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  131. package/dist/core/extensions/extension-types.d.ts +717 -702
  132. package/dist/core/extensions/extension-types.js +1 -1
  133. package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
  134. package/dist/core/extensions/flag-value-types.d.ts +32 -4
  135. package/dist/core/extensions/flag-value-types.js +1 -1
  136. package/dist/core/extensions/index.d.ts +34 -34
  137. package/dist/core/extensions/item-field-types.d.ts +3 -3
  138. package/dist/core/extensions/item-fields.d.ts +6 -6
  139. package/dist/core/extensions/loader.d.ts +66 -66
  140. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  141. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  142. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  143. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  144. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  145. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  146. package/dist/core/extensions/registration-contracts.js +1 -1
  147. package/dist/core/extensions/registration-validation.d.ts +6 -6
  148. package/dist/core/extensions/registration-values.d.ts +19 -19
  149. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  150. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  151. package/dist/core/extensions/service-ownership.d.ts +1 -1
  152. package/dist/core/extensions/version-compat.d.ts +9 -9
  153. package/dist/core/fs/atomic-create.d.ts +1 -1
  154. package/dist/core/fs/fs-utils.d.ts +12 -12
  155. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  156. package/dist/core/fs/path-utils.d.ts +1 -1
  157. package/dist/core/governance/content-fields.d.ts +25 -25
  158. package/dist/core/governance/issue-codes.d.ts +16 -16
  159. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  160. package/dist/core/history/digest.d.ts +5 -5
  161. package/dist/core/history/drift-cache.d.ts +2 -2
  162. package/dist/core/history/drift-scan.d.ts +18 -18
  163. package/dist/core/history/event-classification.d.ts +4 -4
  164. package/dist/core/history/event-index.d.ts +33 -33
  165. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  166. package/dist/core/history/history-diff.d.ts +15 -15
  167. package/dist/core/history/history-rewrite.d.ts +43 -43
  168. package/dist/core/history/history-storage-stats.d.ts +20 -20
  169. package/dist/core/history/history-stream-policy.d.ts +12 -12
  170. package/dist/core/history/history.d.ts +45 -45
  171. package/dist/core/history/identity.d.ts +4 -4
  172. package/dist/core/history/operation-contract.d.ts +17 -17
  173. package/dist/core/history/projection.d.ts +16 -16
  174. package/dist/core/history/read.d.ts +4 -4
  175. package/dist/core/history/replay.d.ts +47 -47
  176. package/dist/core/history/tombstone.d.ts +1 -1
  177. package/dist/core/history/version-address.d.ts +2 -2
  178. package/dist/core/history/workspace-history.d.ts +72 -72
  179. package/dist/core/io/body-file.d.ts +2 -2
  180. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  181. package/dist/core/item/actionability.d.ts +30 -30
  182. package/dist/core/item/dependency-reference.d.ts +2 -2
  183. package/dist/core/item/id.d.ts +9 -9
  184. package/dist/core/item/item-format-version.d.ts +17 -15
  185. package/dist/core/item/item-format-version.js +1 -1
  186. package/dist/core/item/item-format.d.ts +54 -54
  187. package/dist/core/item/item-format.js +3 -3
  188. package/dist/core/item/item-record.d.ts +1 -1
  189. package/dist/core/item/item-type-definition.d.ts +11 -11
  190. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  191. package/dist/core/item/parse.d.ts +37 -37
  192. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  193. package/dist/core/item/priority.d.ts +3 -3
  194. package/dist/core/item/sprint-release-format.d.ts +4 -4
  195. package/dist/core/item/status-filter.d.ts +5 -5
  196. package/dist/core/item/status.d.ts +3 -3
  197. package/dist/core/item/toon-decode.d.ts +10 -10
  198. package/dist/core/item/type-registry.d.ts +35 -35
  199. package/dist/core/item/type-synonyms.d.ts +2 -2
  200. package/dist/core/lock/lock-gc.d.ts +28 -28
  201. package/dist/core/lock/lock.d.ts +53 -53
  202. package/dist/core/output/mutation-projection.d.ts +4 -25
  203. package/dist/core/output/mutation-projection.js +1 -1
  204. package/dist/core/output/output-control.d.ts +4 -4
  205. package/dist/core/output/output.d.ts +30 -30
  206. package/dist/core/output/query-summary.d.ts +5 -5
  207. package/dist/core/output/tabular.d.ts +3 -3
  208. package/dist/core/packages/manifest.d.ts +30 -30
  209. package/dist/core/packages/root.d.ts +4 -4
  210. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  211. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  212. package/dist/core/policy/workflow-policy.d.ts +56 -56
  213. package/dist/core/profile/profile-describe.d.ts +22 -22
  214. package/dist/core/profile/profile-lint.d.ts +13 -13
  215. package/dist/core/profile/profile-plan.d.ts +45 -45
  216. package/dist/core/profile/profile-presets.d.ts +36 -36
  217. package/dist/core/reproducibility/context.d.ts +9 -9
  218. package/dist/core/schema/fields-file.d.ts +35 -35
  219. package/dist/core/schema/item-types-file.d.ts +29 -29
  220. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  221. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  222. package/dist/core/schema/runtime-schema.d.ts +59 -59
  223. package/dist/core/schema/status-defs-file.d.ts +29 -29
  224. package/dist/core/schema/status-token.d.ts +1 -1
  225. package/dist/core/schema/type-inference.d.ts +10 -10
  226. package/dist/core/schema/type-presets.d.ts +5 -5
  227. package/dist/core/schema/type-workflows.d.ts +15 -15
  228. package/dist/core/schema/type-workflows.js +1 -1
  229. package/dist/core/search/background-refresh.d.ts +12 -12
  230. package/dist/core/search/bm25.d.ts +16 -16
  231. package/dist/core/search/cache.d.ts +34 -34
  232. package/dist/core/search/corpus.d.ts +17 -17
  233. package/dist/core/search/embedding-batches.d.ts +25 -25
  234. package/dist/core/search/eval-thresholds.d.ts +4 -4
  235. package/dist/core/search/eval.d.ts +40 -40
  236. package/dist/core/search/http-client.d.ts +24 -24
  237. package/dist/core/search/providers.d.ts +30 -30
  238. package/dist/core/search/relevance.d.ts +17 -17
  239. package/dist/core/search/semantic-defaults.d.ts +5 -5
  240. package/dist/core/search/staleness.d.ts +3 -3
  241. package/dist/core/search/vector-stores.d.ts +51 -51
  242. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  243. package/dist/core/sentry/helpers.d.ts +27 -27
  244. package/dist/core/sentry/instrument.d.ts +51 -51
  245. package/dist/core/sentry/instrument.js +1 -1
  246. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  247. package/dist/core/sentry/sensitive-assignments.js +2 -0
  248. package/dist/core/session/session-state.d.ts +37 -37
  249. package/dist/core/shared/agent-session-context.d.ts +14 -14
  250. package/dist/core/shared/author.d.ts +89 -89
  251. package/dist/core/shared/command-line.d.ts +3 -3
  252. package/dist/core/shared/command-types.d.ts +20 -20
  253. package/dist/core/shared/conflict-markers.d.ts +5 -5
  254. package/dist/core/shared/constants.d.ts +30 -30
  255. package/dist/core/shared/errors.d.ts +100 -100
  256. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  257. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  258. package/dist/core/shared/lazy-module.d.ts +1 -1
  259. package/dist/core/shared/levenshtein.d.ts +1 -1
  260. package/dist/core/shared/memo.d.ts +1 -1
  261. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  262. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  263. package/dist/core/shared/primitives.d.ts +13 -13
  264. package/dist/core/shared/secret-rules.d.ts +92 -92
  265. package/dist/core/shared/serial-queue.d.ts +6 -6
  266. package/dist/core/shared/serialization.d.ts +4 -4
  267. package/dist/core/shared/split-comma-list.d.ts +4 -4
  268. package/dist/core/shared/text-normalization.d.ts +5 -3
  269. package/dist/core/shared/text-normalization.js +1 -1
  270. package/dist/core/shared/time.d.ts +27 -27
  271. package/dist/core/store/item-format-migration.d.ts +7 -7
  272. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  273. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  274. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  275. package/dist/core/store/item-mutation-precondition.d.ts +11 -0
  276. package/dist/core/store/item-mutation-precondition.js +2 -0
  277. package/dist/core/store/item-store.d.ts +123 -123
  278. package/dist/core/store/item-store.js +1 -1
  279. package/dist/core/store/paths.d.ts +27 -27
  280. package/dist/core/store/settings-concurrency.d.ts +1 -1
  281. package/dist/core/store/settings-read-cache.d.ts +11 -11
  282. package/dist/core/store/settings-validator.d.ts +117 -117
  283. package/dist/core/store/settings.d.ts +84 -84
  284. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  285. package/dist/core/store/tracker-preflight.d.ts +3 -3
  286. package/dist/core/telemetry/consent.d.ts +1 -1
  287. package/dist/core/telemetry/observability.d.ts +16 -16
  288. package/dist/core/telemetry/policy.d.ts +7 -7
  289. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  290. package/dist/core/telemetry/runtime.d.ts +275 -275
  291. package/dist/core/test/background-runs.d.ts +123 -123
  292. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  293. package/dist/core/test/run-selectors.d.ts +12 -12
  294. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  295. package/dist/core/validate/fix-planning.d.ts +36 -36
  296. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  297. package/dist/core/validate/missing-by-type.d.ts +3 -3
  298. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  299. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  300. package/dist/mcp/http-server.d.ts +26 -26
  301. package/dist/mcp/legacy-adapter.d.ts +18 -18
  302. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  303. package/dist/mcp/server.d.ts +73 -73
  304. package/dist/mcp/server.js +1 -1
  305. package/dist/mcp/tool-definitions.d.ts +27 -27
  306. package/dist/mcp/tool-definitions.js +1 -1
  307. package/dist/sdk/actionability.d.ts +1 -1
  308. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  309. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  310. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  311. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  312. package/dist/sdk/agent/identity-config.d.ts +18 -18
  313. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  314. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  315. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  316. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  317. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  318. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  319. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  320. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  321. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  322. package/dist/sdk/agent-session-context.d.ts +1 -1
  323. package/dist/sdk/annotations.d.ts +74 -74
  324. package/dist/sdk/author-attribution.d.ts +47 -47
  325. package/dist/sdk/authoring.d.ts +9 -9
  326. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  327. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  328. package/dist/sdk/cli-contracts/agent-output-contracts.js +1 -1
  329. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  330. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  331. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  332. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  333. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  334. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  335. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  336. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  337. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  338. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  339. package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -1
  340. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  341. package/dist/sdk/cli-contracts/registration-helpers.d.ts +57 -57
  342. package/dist/sdk/cli-contracts/registration-helpers.js +1 -1
  343. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  344. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  345. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  346. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  347. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  348. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  349. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  350. package/dist/sdk/cli-contracts/tool-schema.js +1 -1
  351. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  352. package/dist/sdk/cli-contracts.d.ts +15 -15
  353. package/dist/sdk/cli-program.d.ts +1 -1
  354. package/dist/sdk/cli-program.js +1 -1
  355. package/dist/sdk/command-line.d.ts +3 -3
  356. package/dist/sdk/comments.d.ts +24 -24
  357. package/dist/sdk/compile-cache.d.ts +4 -4
  358. package/dist/sdk/completion/bash.d.ts +1 -1
  359. package/dist/sdk/completion/fish.d.ts +1 -1
  360. package/dist/sdk/completion/shared.d.ts +74 -74
  361. package/dist/sdk/completion/zsh.d.ts +1 -1
  362. package/dist/sdk/completion.d.ts +3 -3
  363. package/dist/sdk/compose.d.ts +94 -94
  364. package/dist/sdk/config.d.ts +105 -105
  365. package/dist/sdk/context/recency.d.ts +1 -1
  366. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  367. package/dist/sdk/context/usage-egress.d.ts +1 -1
  368. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  369. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  370. package/dist/sdk/context-intent-contracts.js +1 -1
  371. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  372. package/dist/sdk/context-packing.d.ts +44 -44
  373. package/dist/sdk/context-relevance.d.ts +110 -110
  374. package/dist/sdk/context-signal-store.d.ts +52 -52
  375. package/dist/sdk/context-usage.d.ts +78 -78
  376. package/dist/sdk/contracts.d.ts +2 -1
  377. package/dist/sdk/contracts.js +1 -1
  378. package/dist/sdk/core-governance.d.ts +5 -5
  379. package/dist/sdk/core.d.ts +9 -8
  380. package/dist/sdk/core.js +1 -1
  381. package/dist/sdk/corpus-shape.d.ts +60 -60
  382. package/dist/sdk/define.d.ts +36 -36
  383. package/dist/sdk/dependencies.d.ts +70 -70
  384. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  385. package/dist/sdk/dependency-provenance.d.ts +22 -22
  386. package/dist/sdk/docs.d.ts +17 -17
  387. package/dist/sdk/duplicates.d.ts +14 -14
  388. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  389. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  390. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  391. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  392. package/dist/sdk/environment/source-context.d.ts +4 -4
  393. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  394. package/dist/sdk/error-code-catalog.d.ts +33 -33
  395. package/dist/sdk/error-runtime.d.ts +5 -5
  396. package/dist/sdk/errors.d.ts +17 -17
  397. package/dist/sdk/eval.d.ts +27 -27
  398. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  399. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  400. package/dist/sdk/extension/concurrency.d.ts +1 -1
  401. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  402. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  403. package/dist/sdk/extension/describe.d.ts +21 -21
  404. package/dist/sdk/extension/doctor.d.ts +46 -46
  405. package/dist/sdk/extension/install-plan.d.ts +32 -32
  406. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  407. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  408. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  409. package/dist/sdk/extension/install-sources.d.ts +106 -106
  410. package/dist/sdk/extension/managed-state.d.ts +42 -42
  411. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  412. package/dist/sdk/extension/migrations.d.ts +48 -48
  413. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  414. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  415. package/dist/sdk/extension/scaffold.d.ts +15 -15
  416. package/dist/sdk/extension/shared.d.ts +16 -16
  417. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  418. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  419. package/dist/sdk/extension/update-check.d.ts +9 -9
  420. package/dist/sdk/extension-command-context.d.ts +1 -1
  421. package/dist/sdk/extension-contracts.d.ts +10 -10
  422. package/dist/sdk/extension.d.ts +221 -221
  423. package/dist/sdk/files.d.ts +101 -101
  424. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  425. package/dist/sdk/flag-invocation-contracts.js +1 -1
  426. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  427. package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -1
  428. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  429. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  430. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  431. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  432. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  433. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  434. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  435. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  436. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  437. package/dist/sdk/governance/assurance.d.ts +204 -204
  438. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  439. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  440. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  441. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  442. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  443. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  444. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  445. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  446. package/dist/sdk/governance/gc.d.ts +26 -26
  447. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  448. package/dist/sdk/governance/health.d.ts +172 -172
  449. package/dist/sdk/governance/health.js +1 -1
  450. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  451. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  452. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  453. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  454. package/dist/sdk/governance/reindex.d.ts +102 -102
  455. package/dist/sdk/governance/reliability.d.ts +29 -29
  456. package/dist/sdk/governance/stale-work.d.ts +13 -13
  457. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  458. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  459. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  460. package/dist/sdk/governance/upgrade.d.ts +77 -77
  461. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  462. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  463. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  464. package/dist/sdk/governance/validate.d.ts +176 -176
  465. package/dist/sdk/governance/validate.js +1 -1
  466. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  467. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  468. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  469. package/dist/sdk/governance.d.ts +2 -2
  470. package/dist/sdk/graph/adapter.d.ts +45 -45
  471. package/dist/sdk/graph/analytics.d.ts +36 -36
  472. package/dist/sdk/graph/assembly.d.ts +51 -51
  473. package/dist/sdk/graph/cache.d.ts +19 -19
  474. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  475. package/dist/sdk/graph/centrality.d.ts +20 -20
  476. package/dist/sdk/graph/conformance.d.ts +21 -21
  477. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  478. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  479. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  480. package/dist/sdk/graph/governance.d.ts +92 -92
  481. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  482. package/dist/sdk/graph/index.d.ts +15 -15
  483. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  484. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  485. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  486. package/dist/sdk/graph/remediation.d.ts +15 -15
  487. package/dist/sdk/graph/run.d.ts +203 -203
  488. package/dist/sdk/graph/scheduling.d.ts +21 -21
  489. package/dist/sdk/graph/traversal.d.ts +18 -18
  490. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  491. package/dist/sdk/guide-topics.d.ts +19 -19
  492. package/dist/sdk/guide-topics.js +1 -1
  493. package/dist/sdk/guide.d.ts +43 -43
  494. package/dist/sdk/history/attestation-command.d.ts +8 -8
  495. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  496. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  497. package/dist/sdk/history/attestation.d.ts +4 -4
  498. package/dist/sdk/history/maintenance.d.ts +25 -25
  499. package/dist/sdk/history/salvage.d.ts +19 -19
  500. package/dist/sdk/history/subject.d.ts +8 -8
  501. package/dist/sdk/history-analytics.d.ts +64 -64
  502. package/dist/sdk/history-compact.d.ts +67 -67
  503. package/dist/sdk/history-mcp.d.ts +7 -7
  504. package/dist/sdk/history-provenance.d.ts +40 -40
  505. package/dist/sdk/history-read.d.ts +24 -24
  506. package/dist/sdk/history-redact.d.ts +68 -68
  507. package/dist/sdk/history-repair.d.ts +92 -92
  508. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  509. package/dist/sdk/improvement-ledger.d.ts +62 -62
  510. package/dist/sdk/index.d.ts +70 -69
  511. package/dist/sdk/index.js +1 -1
  512. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  513. package/dist/sdk/init.d.ts +117 -117
  514. package/dist/sdk/invocation-author.d.ts +1 -1
  515. package/dist/sdk/item-children.d.ts +15 -15
  516. package/dist/sdk/item-metadata-index.d.ts +2 -2
  517. package/dist/sdk/item-schedule.d.ts +9 -9
  518. package/dist/sdk/item-transaction.d.ts +139 -76
  519. package/dist/sdk/item-transaction.js +1 -1
  520. package/dist/sdk/learnings.d.ts +23 -23
  521. package/dist/sdk/lifecycle/append.d.ts +8 -8
  522. package/dist/sdk/lifecycle/claim.d.ts +53 -39
  523. package/dist/sdk/lifecycle/claim.js +1 -1
  524. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  525. package/dist/sdk/lifecycle/close.d.ts +18 -24
  526. package/dist/sdk/lifecycle/close.js +1 -1
  527. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  528. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  529. package/dist/sdk/lifecycle/core-item-fields.d.ts +6 -0
  530. package/dist/sdk/lifecycle/core-item-fields.js +2 -0
  531. package/dist/sdk/lifecycle/create.d.ts +88 -88
  532. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  533. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  534. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  535. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  536. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  537. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  538. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  539. package/dist/sdk/lifecycle/mcp-actions.js +1 -1
  540. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  541. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  542. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  543. package/dist/sdk/lifecycle/mutation-option-validation.d.ts +2 -0
  544. package/dist/sdk/lifecycle/mutation-option-validation.js +2 -0
  545. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  546. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  547. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  548. package/dist/sdk/lifecycle/release-handoff.d.ts +12 -0
  549. package/dist/sdk/lifecycle/release-handoff.js +2 -0
  550. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  551. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  552. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  553. package/dist/sdk/lifecycle/restore.js +1 -1
  554. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  555. package/dist/sdk/lifecycle/structured-mutation-plan.d.ts +33 -0
  556. package/dist/sdk/lifecycle/structured-mutation-plan.js +2 -0
  557. package/dist/sdk/lifecycle/task-composition.d.ts +9 -9
  558. package/dist/sdk/lifecycle/task-composition.js +1 -1
  559. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  560. package/dist/sdk/lifecycle/update.d.ts +113 -121
  561. package/dist/sdk/lifecycle/update.js +1 -1
  562. package/dist/sdk/lifecycle/workflow-transition.d.ts +13 -0
  563. package/dist/sdk/lifecycle/workflow-transition.js +2 -0
  564. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  565. package/dist/sdk/lifecycle-policy.d.ts +42 -32
  566. package/dist/sdk/lifecycle-policy.js +1 -1
  567. package/dist/sdk/linked-artifacts.d.ts +58 -58
  568. package/dist/sdk/mcp/apps.d.ts +28 -28
  569. package/dist/sdk/mcp/authorization.d.ts +66 -66
  570. package/dist/sdk/mcp/discovery.d.ts +67 -67
  571. package/dist/sdk/mcp/interactions.d.ts +49 -49
  572. package/dist/sdk/mcp/protocol.d.ts +63 -63
  573. package/dist/sdk/mcp/skills.d.ts +62 -62
  574. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  575. package/dist/sdk/mcp/tasks.d.ts +51 -51
  576. package/dist/sdk/mcp/transport.d.ts +17 -17
  577. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  578. package/dist/sdk/merge/driver.d.ts +38 -38
  579. package/dist/sdk/merge/index.d.ts +5 -5
  580. package/dist/sdk/merge/install.d.ts +48 -48
  581. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  582. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  583. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  584. package/dist/sdk/merge/receipts.d.ts +111 -111
  585. package/dist/sdk/merge/reconcile.d.ts +20 -20
  586. package/dist/sdk/merge/three-way.d.ts +50 -50
  587. package/dist/sdk/merge/three-way.js +2 -2
  588. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  589. package/dist/sdk/mutation-events.d.ts +62 -62
  590. package/dist/sdk/mutation-guard.d.ts +134 -134
  591. package/dist/sdk/notes.d.ts +28 -28
  592. package/dist/sdk/output/table-rows.d.ts +6 -6
  593. package/dist/sdk/output-contracts.d.ts +26 -26
  594. package/dist/sdk/output-projection.d.ts +108 -108
  595. package/dist/sdk/output-token-accounting.d.ts +18 -18
  596. package/dist/sdk/output.d.ts +18 -18
  597. package/dist/sdk/ownership-source.d.ts +1 -1
  598. package/dist/sdk/package-import-adapters.d.ts +51 -51
  599. package/dist/sdk/package-migrations.d.ts +3 -3
  600. package/dist/sdk/package-runtime-options.d.ts +3 -3
  601. package/dist/sdk/pagination.d.ts +28 -28
  602. package/dist/sdk/pagination.js +1 -1
  603. package/dist/sdk/profile.d.ts +72 -72
  604. package/dist/sdk/provenance.d.ts +37 -37
  605. package/dist/sdk/public-surface.json +1 -1
  606. package/dist/sdk/query/activity.d.ts +84 -84
  607. package/dist/sdk/query/aggregate.d.ts +109 -109
  608. package/dist/sdk/query/calendar.d.ts +95 -95
  609. package/dist/sdk/query/complete-list.d.ts +35 -35
  610. package/dist/sdk/query/context.d.ts +300 -300
  611. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  612. package/dist/sdk/query/get.d.ts +54 -54
  613. package/dist/sdk/query/history.d.ts +38 -38
  614. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  615. package/dist/sdk/query/light-metadata.d.ts +1 -1
  616. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  617. package/dist/sdk/query/list.d.ts +167 -167
  618. package/dist/sdk/query/list.js +1 -1
  619. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  620. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  621. package/dist/sdk/query/next.d.ts +94 -94
  622. package/dist/sdk/query/parsers.d.ts +3 -3
  623. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  624. package/dist/sdk/query/search/corpus.d.ts +15 -15
  625. package/dist/sdk/query/search/filters.d.ts +15 -15
  626. package/dist/sdk/query/search/input.d.ts +8 -8
  627. package/dist/sdk/query/search/lexical.d.ts +10 -10
  628. package/dist/sdk/query/search/response.d.ts +22 -22
  629. package/dist/sdk/query/search/semantic.d.ts +133 -133
  630. package/dist/sdk/query/search/types.d.ts +65 -65
  631. package/dist/sdk/query/search-contracts.d.ts +53 -53
  632. package/dist/sdk/query/search-pagination.d.ts +21 -21
  633. package/dist/sdk/query/search-rendering.d.ts +30 -30
  634. package/dist/sdk/query/search.d.ts +60 -60
  635. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  636. package/dist/sdk/query.d.ts +6 -6
  637. package/dist/sdk/read-output/continuation.d.ts +11 -11
  638. package/dist/sdk/read-output/extension.d.ts +3 -3
  639. package/dist/sdk/read-output/options.d.ts +7 -7
  640. package/dist/sdk/read-output/provenance.d.ts +6 -6
  641. package/dist/sdk/read-output-budget.d.ts +11 -11
  642. package/dist/sdk/read-output-budget.js +1 -1
  643. package/dist/sdk/read-output-contracts.d.ts +112 -112
  644. package/dist/sdk/read-output-contracts.js +1 -1
  645. package/dist/sdk/read-output-rows.d.ts +15 -15
  646. package/dist/sdk/read-output-session.d.ts +29 -29
  647. package/dist/sdk/relationship-analytics.d.ts +46 -46
  648. package/dist/sdk/relationship-context.d.ts +48 -48
  649. package/dist/sdk/relationship-history.d.ts +59 -59
  650. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  651. package/dist/sdk/relationship-migration.d.ts +14 -14
  652. package/dist/sdk/relationships.d.ts +46 -46
  653. package/dist/sdk/reproducibility/process.d.ts +9 -9
  654. package/dist/sdk/runtime/actions.d.ts +1 -1
  655. package/dist/sdk/runtime/context.d.ts +15 -15
  656. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  657. package/dist/sdk/runtime/schema.d.ts +1 -1
  658. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  659. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  660. package/dist/sdk/runtime-input.d.ts +29 -29
  661. package/dist/sdk/runtime-input.js +1 -1
  662. package/dist/sdk/runtime-primitives.d.ts +53 -53
  663. package/dist/sdk/runtime-primitives.js +1 -1
  664. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  665. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  666. package/dist/sdk/runtime.d.ts +374 -374
  667. package/dist/sdk/runtime.js +1 -1
  668. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  669. package/dist/sdk/schema-migration.d.ts +79 -79
  670. package/dist/sdk/schema.d.ts +224 -224
  671. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  672. package/dist/sdk/similarity-scoring.d.ts +10 -10
  673. package/dist/sdk/similarity.d.ts +73 -73
  674. package/dist/sdk/start-task-status.d.ts +1 -1
  675. package/dist/sdk/stats.d.ts +72 -72
  676. package/dist/sdk/structured-mutations.d.ts +64 -13
  677. package/dist/sdk/structured-mutations.js +1 -1
  678. package/dist/sdk/telemetry-flush.d.ts +1 -1
  679. package/dist/sdk/telemetry.d.ts +32 -32
  680. package/dist/sdk/templates.d.ts +35 -35
  681. package/dist/sdk/test/batch.d.ts +50 -50
  682. package/dist/sdk/test/command-args.d.ts +2 -2
  683. package/dist/sdk/test/entry.d.ts +4 -4
  684. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  685. package/dist/sdk/test/execution.d.ts +247 -247
  686. package/dist/sdk/test/json-path.d.ts +4 -4
  687. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  688. package/dist/sdk/test/measurements.d.ts +10 -10
  689. package/dist/sdk/test/parsers.d.ts +18 -18
  690. package/dist/sdk/test/prerequisites.d.ts +3 -3
  691. package/dist/sdk/test/runs.d.ts +43 -43
  692. package/dist/sdk/test/trust.d.ts +15 -15
  693. package/dist/sdk/test/update.d.ts +23 -23
  694. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  695. package/dist/sdk/testing.d.ts +248 -248
  696. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  697. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  698. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  699. package/dist/sdk/workspace-contracts.d.ts +20 -20
  700. package/dist/sdk/workspace-memory.d.ts +42 -42
  701. package/dist/sdk/workspace-recipe.d.ts +9 -9
  702. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  703. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  704. package/dist/sdk/workspace-transaction.d.ts +26 -26
  705. package/dist/sdk/workspace-transaction.js +2 -2
  706. package/dist/sdk/workspace.d.ts +9 -9
  707. package/dist/types.d.ts +540 -540
  708. package/docs/AGENT_GUIDE.md +33 -4
  709. package/docs/CLOSE_EVIDENCE_RECOVERY.md +16 -7
  710. package/docs/COMMANDS.md +96 -12
  711. package/docs/ECOSYSTEM_PLANNING_REVIEW.md +5 -1
  712. package/docs/EXTENSIONS.md +1 -1
  713. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
  714. package/docs/LINKED_TEST_EDITS.md +15 -0
  715. package/docs/RELEASING.md +2 -0
  716. package/docs/SDK.md +114 -2
  717. package/docs/TESTING.md +36 -1
  718. package/docs/generated/FLAG_LEXICON_BUDGETS.md +1 -1
  719. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +17 -3
  720. package/marketplace.json +1 -1
  721. package/package.json +4 -1
  722. package/packages/pm-beads/package.json +1 -1
  723. package/packages/pm-calendar/package.json +1 -1
  724. package/packages/pm-command-kit/package.json +1 -1
  725. package/packages/pm-digital-twin/package.json +1 -1
  726. package/packages/pm-governance-audit/package.json +1 -1
  727. package/packages/pm-guide-shell/package.json +1 -1
  728. package/packages/pm-kanban/package.json +1 -1
  729. package/packages/pm-lifecycle-hooks/package.json +1 -1
  730. package/packages/pm-linked-test-adapters/package.json +1 -1
  731. package/packages/pm-search-advanced/package.json +1 -1
  732. package/packages/pm-templates/package.json +1 -1
  733. package/packages/pm-todos/package.json +1 -1
  734. package/packages/pm-vcs/package.json +1 -1
  735. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  736. package/plugins/pm-claude/package.json +1 -1
  737. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  738. package/plugins/pm-codex/package.json +1 -1
  739. package/plugins/pm-codex/plugin.json +1 -1
  740. package/runtime-dependencies.json +1 -1
  741. package/scripts/finalize-build.mjs +9 -3
  742. package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
  743. package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
  744. package/dist/cli-bundle/chunks/chunk-LOSRTNNP.js +0 -2
  745. package/dist/cli-bundle/chunks/chunk-PP3BVMFL.js +0 -30
  746. package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
  747. package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
  748. package/dist/cli-bundle/chunks/register-mutation-TNRHNK4N.js +0 -20
  749. package/dist/cli-bundle/focused-chunks/chunk-23ACMPGB.js +0 -2
  750. package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
  751. package/dist/cli-bundle/focused-chunks/chunk-LKWDWER4.js +0 -20
  752. package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
  753. package/docs/ecosystem-review-2026-09-28.json +0 -1
@@ -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 {};