@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
@@ -5,7 +5,7 @@
5
5
  * discovery, result-envelope, and bounded legacy-compatibility contracts.
6
6
  */
7
7
  /** Canonical stateless MCP revision implemented by pm. */
8
- export declare const PM_MCP_PROTOCOL_VERSION: "2026-07-28";
8
+ export declare const PM_MCP_PROTOCOL_VERSION:"2026-07-28";
9
9
  /**
10
10
  * Legacy initialize-era revisions accepted only by the bounded stdio adapter.
11
11
  *
@@ -15,143 +15,143 @@ export declare const PM_MCP_PROTOCOL_VERSION: "2026-07-28";
15
15
  * Ordered newest first: element zero is the revision offered to a client that
16
16
  * omits `protocolVersion`.
17
17
  */
18
- export declare const PM_MCP_LEGACY_PROTOCOL_VERSIONS: readonly ["2025-11-25", "2025-06-18"];
18
+ export declare const PM_MCP_LEGACY_PROTOCOL_VERSIONS:readonly ["2025-11-25","2025-06-18"];
19
19
  /** Modern per-request protocol versions accepted by the stateless core. */
20
- export declare const PM_MCP_SUPPORTED_PROTOCOL_VERSIONS: readonly ["2026-07-28"];
20
+ export declare const PM_MCP_SUPPORTED_PROTOCOL_VERSIONS:readonly ["2026-07-28"];
21
21
  /** Allocated MCP 2026-07-28 protocol error codes. */
22
- export declare const PM_MCP_ERROR_CODES: {
23
- readonly headerMismatch: -32020;
24
- readonly missingRequiredClientCapability: -32021;
25
- readonly unsupportedProtocolVersion: -32022;
26
- readonly invalidParams: -32602;
22
+ export declare const PM_MCP_ERROR_CODES:{
23
+ readonly headerMismatch:-32020;
24
+ readonly missingRequiredClientCapability:-32021;
25
+ readonly unsupportedProtocolVersion:-32022;
26
+ readonly invalidParams:-32602;
27
27
  };
28
28
  /** Namespaced metadata keys owned by the MCP specification. */
29
- export declare const PM_MCP_META_KEYS: {
30
- readonly clientCapabilities: "io.modelcontextprotocol/clientCapabilities";
31
- readonly clientInfo: "io.modelcontextprotocol/clientInfo";
32
- readonly logLevel: "io.modelcontextprotocol/logLevel";
33
- readonly protocolVersion: "io.modelcontextprotocol/protocolVersion";
34
- readonly serverInfo: "io.modelcontextprotocol/serverInfo";
29
+ export declare const PM_MCP_META_KEYS:{
30
+ readonly clientCapabilities:"io.modelcontextprotocol/clientCapabilities";
31
+ readonly clientInfo:"io.modelcontextprotocol/clientInfo";
32
+ readonly logLevel:"io.modelcontextprotocol/logLevel";
33
+ readonly protocolVersion:"io.modelcontextprotocol/protocolVersion";
34
+ readonly serverInfo:"io.modelcontextprotocol/serverInfo";
35
35
  };
36
36
  /** Request-local severity vocabulary retained by the deprecated logging contract. */
37
- export declare const PM_MCP_LOG_LEVELS: readonly ["debug", "info", "notice", "warning", "error", "critical", "alert", "emergency"];
37
+ export declare const PM_MCP_LOG_LEVELS:readonly ["debug","info","notice","warning","error","critical","alert","emergency"];
38
38
  /** An explicit logging opt-in applies only to the request carrying it. */
39
39
  export type PmMcpLogLevel = (typeof PM_MCP_LOG_LEVELS)[number];
40
40
  /** MCP implementation identity carried in request and result metadata. */
41
41
  export interface PmMcpImplementation {
42
42
  /** Stable implementation name. */
43
- name: string;
43
+ name:string;
44
44
  /** Implementation version. */
45
- version: string;
45
+ version:string;
46
46
  /** Optional human-readable implementation description. */
47
- description?: string;
47
+ description?:string;
48
48
  /** Optional implementation website. */
49
- websiteUrl?: string;
49
+ websiteUrl?:string;
50
50
  }
51
51
  /** Open MCP client capability map declared independently on every request. */
52
- export type PmMcpClientCapabilities = Record<string, unknown>;
52
+ export type PmMcpClientCapabilities = Record<string,unknown>;
53
53
  /** Server capabilities advertised by pm discovery. */
54
54
  export interface PmMcpServerCapabilities {
55
55
  /** Prompt surface and change-notification support. */
56
- prompts?: {
57
- listChanged?: boolean;
56
+ prompts?:{
57
+ listChanged?:boolean;
58
58
  };
59
59
  /** Resource surface and change-notification support. */
60
- resources?: {
61
- listChanged?: boolean;
62
- subscribe?: boolean;
60
+ resources?:{
61
+ listChanged?:boolean;
62
+ subscribe?:boolean;
63
63
  };
64
64
  /** Tool surface and change-notification support. */
65
- tools?: {
66
- listChanged?: boolean;
65
+ tools?:{
66
+ listChanged?:boolean;
67
67
  };
68
68
  /** Negotiated optional extension settings keyed by extension identifier. */
69
- extensions?: Record<string, Record<string, unknown>>;
69
+ extensions?:Record<string,Record<string,unknown>>;
70
70
  /** Additional capability declarations retained for forward compatibility. */
71
- [key: string]: unknown;
71
+ [key:string]:unknown;
72
72
  }
73
73
  /** Validated request-local metadata for one modern MCP operation. */
74
74
  export interface PmMcpRequestContext {
75
75
  /** Exact modern protocol revision used by this request. */
76
- protocolVersion: (typeof PM_MCP_SUPPORTED_PROTOCOL_VERSIONS)[number];
76
+ protocolVersion:(typeof PM_MCP_SUPPORTED_PROTOCOL_VERSIONS)[number];
77
77
  /** Capabilities declared for this request only. */
78
- clientCapabilities: PmMcpClientCapabilities;
78
+ clientCapabilities:PmMcpClientCapabilities;
79
79
  /** Optional bounded client identity used only for diagnostics/provenance. */
80
- clientInfo?: PmMcpImplementation;
80
+ clientInfo?:PmMcpImplementation;
81
81
  /** Optional request-local logging threshold; absence forbids protocol log notifications. */
82
- logLevel?: PmMcpLogLevel;
82
+ logLevel?:PmMcpLogLevel;
83
83
  }
84
84
  /** Required fields attached to every modern successful result. */
85
85
  export interface PmMcpResultEnvelope {
86
86
  /** Ordinary successful results are complete. */
87
- resultType: "complete";
87
+ resultType:"complete";
88
88
  /** Result-local MCP metadata. */
89
- _meta: {
89
+ _meta:{
90
90
  /** Server identity is repeated on every modern result. */
91
- "io.modelcontextprotocol/serverInfo": PmMcpImplementation;
91
+ "io.modelcontextprotocol/serverInfo":PmMcpImplementation;
92
92
  };
93
93
  /** Additional method-specific result fields. */
94
- [key: string]: unknown;
94
+ [key:string]:unknown;
95
95
  }
96
96
  /** Required server identity metadata attached to every modern result shape. */
97
97
  export interface PmMcpServerResultMetadata {
98
98
  /** Result-local MCP metadata. */
99
- _meta: {
99
+ _meta:{
100
100
  /** Server identity is repeated on every modern result. */
101
- "io.modelcontextprotocol/serverInfo": PmMcpImplementation;
101
+ "io.modelcontextprotocol/serverInfo":PmMcpImplementation;
102
102
  /** Additional namespaced or application metadata. */
103
- [key: string]: unknown;
103
+ [key:string]:unknown;
104
104
  };
105
105
  }
106
106
  /** Modern discovery response contract. */
107
107
  export interface PmMcpDiscoverResult extends PmMcpResultEnvelope {
108
108
  /** Modern stateless revisions accepted through per-request metadata. */
109
- supportedVersions: string[];
109
+ supportedVersions:string[];
110
110
  /** Deterministic server capability declaration. */
111
- capabilities: PmMcpServerCapabilities;
111
+ capabilities:PmMcpServerCapabilities;
112
112
  /** Cache freshness hint required by the current schema. */
113
- ttlMs: number;
113
+ ttlMs:number;
114
114
  /** Discovery is public because it contains no caller-specific data. */
115
- cacheScope: "public";
115
+ cacheScope:"public";
116
116
  /** Optional model-facing usage guidance. */
117
- instructions?: string;
117
+ instructions?:string;
118
118
  }
119
119
  /** Protocol-era interpretation used at explicit compatibility boundaries. */
120
120
  export type PmMcpProtocolEra = "modern" | "legacy";
121
121
  /** Structured MCP protocol error safe for JSON-RPC adapters. */
122
122
  export declare class PmMcpProtocolError extends Error {
123
123
  /** JSON-RPC/MCP error code. */
124
- readonly code: number;
124
+ readonly code:number;
125
125
  /** Structured recovery or mismatch detail. */
126
- readonly data: Record<string, unknown>;
126
+ readonly data:Record<string,unknown>;
127
127
  /** Create one typed protocol error. */
128
- constructor(message: string, code: number, data?: Record<string, unknown>);
128
+ constructor(message:string,code:number,data?:Record<string,unknown>);
129
129
  }
130
130
  /** Return whether an unknown value is a non-array object. */
131
- export declare function isMcpRecord(value: unknown): value is Record<string, unknown>;
131
+ export declare function isMcpRecord(value:unknown):value is Record<string,unknown>;
132
132
  /** Parse an optional MCP implementation identity without guessing missing fields. */
133
- export declare function parseMcpImplementation(value: unknown): PmMcpImplementation | undefined;
133
+ export declare function parseMcpImplementation(value:unknown):PmMcpImplementation | undefined;
134
134
  /** Validate the stateless metadata required on every modern MCP request. */
135
- export declare function resolveMcpRequestContext(params: unknown): PmMcpRequestContext;
135
+ export declare function resolveMcpRequestContext(params:unknown):PmMcpRequestContext;
136
136
  /** Validate the HTTP protocol-version header against request-local metadata. */
137
- export declare function assertMcpProtocolHeader(requestContext: PmMcpRequestContext, headerValue: string | undefined): void;
137
+ export declare function assertMcpProtocolHeader(requestContext:PmMcpRequestContext,headerValue:string | undefined):void;
138
138
  /** Require named client capabilities without consulting prior requests. */
139
- export declare function assertMcpClientCapabilities(requestContext: PmMcpRequestContext, requiredCapabilities: readonly string[]): void;
139
+ export declare function assertMcpClientCapabilities(requestContext:PmMcpRequestContext,requiredCapabilities:readonly string[]):void;
140
140
  /** Return whether this request independently negotiated one named extension. */
141
- export declare function hasMcpClientExtension(requestContext: PmMcpRequestContext, extension: string): boolean;
141
+ export declare function hasMcpClientExtension(requestContext:PmMcpRequestContext,extension:string):boolean;
142
142
  /** Attach required server identity while preserving a non-complete result discriminator. */
143
- export declare function attachMcpServerInfo<Payload extends Record<string, unknown>>(payload: Payload, serverInfo: PmMcpImplementation): Payload & PmMcpServerResultMetadata;
143
+ export declare function attachMcpServerInfo<Payload extends Record<string,unknown>>(payload:Payload,serverInfo:PmMcpImplementation):Payload & PmMcpServerResultMetadata;
144
144
  /** Attach required modern result fields without mutating the caller payload. */
145
- export declare function buildMcpCompleteResult<Payload extends Record<string, unknown>>(payload: Payload, serverInfo: PmMcpImplementation): Payload & PmMcpResultEnvelope;
145
+ export declare function buildMcpCompleteResult<Payload extends Record<string,unknown>>(payload:Payload,serverInfo:PmMcpImplementation):Payload & PmMcpResultEnvelope;
146
146
  /** Build deterministic current-revision server discovery. */
147
- export declare function buildMcpDiscoverResult(input: {
148
- serverInfo: PmMcpImplementation;
149
- capabilities: PmMcpServerCapabilities;
150
- instructions?: string;
151
- ttlMs?: number;
152
- }): PmMcpDiscoverResult;
147
+ export declare function buildMcpDiscoverResult(input:{
148
+ serverInfo:PmMcpImplementation;
149
+ capabilities:PmMcpServerCapabilities;
150
+ instructions?:string;
151
+ ttlMs?:number;
152
+ }):PmMcpDiscoverResult;
153
153
  /**
154
154
  * Interpret resultType only at an explicit protocol-era boundary. Legacy
155
155
  * results may omit it; modern results fail closed when it is absent.
156
156
  */
157
- export declare function interpretMcpResultType(result: unknown, era: PmMcpProtocolEra): string;
157
+ export declare function interpretMcpResultType(result:unknown,era:PmMcpProtocolEra):string;
@@ -1,127 +1,127 @@
1
- import { PM_MCP_PROTOCOL_VERSION, type PmMcpRequestContext } from "./protocol.js";
1
+ import { PM_MCP_PROTOCOL_VERSION,type PmMcpRequestContext } from "./protocol.js";
2
2
  /** Draft extension identifier proposed by SEP-2640. */
3
- export declare const PM_MCP_SKILLS_EXTENSION: "io.modelcontextprotocol/skills";
3
+ export declare const PM_MCP_SKILLS_EXTENSION:"io.modelcontextprotocol/skills";
4
4
  /** Exact draft proposal revision implemented by pm. */
5
- export declare const PM_MCP_SKILLS_DRAFT_REVISION: "SEP-2640@a3e147ca2710f68214247aecc729731ee1ae8d03";
5
+ export declare const PM_MCP_SKILLS_DRAFT_REVISION:"SEP-2640@a3e147ca2710f68214247aecc729731ee1ae8d03";
6
6
  /** Server-side draft capability advertised through discovery. */
7
- export declare const PM_MCP_SKILLS_SERVER_CAPABILITY: Readonly<{
8
- revision: "SEP-2640@a3e147ca2710f68214247aecc729731ee1ae8d03";
9
- status: "draft";
10
- directoryRead: true;
7
+ export declare const PM_MCP_SKILLS_SERVER_CAPABILITY:Readonly<{
8
+ revision:"SEP-2640@a3e147ca2710f68214247aecc729731ee1ae8d03";
9
+ status:"draft";
10
+ directoryRead:true;
11
11
  }>;
12
12
  /** Require exact draft negotiation for a skills method. */
13
- export declare function assertPmMcpSkillsCapability(context: PmMcpRequestContext, directoryRead?: boolean): void;
13
+ export declare function assertPmMcpSkillsCapability(context:PmMcpRequestContext,directoryRead?:boolean):void;
14
14
  /** Security and context limits applied independently to every skill origin. */
15
- export declare const PM_MCP_SKILL_LIMITS: Readonly<{
16
- maxFilesPerSkill: 512;
17
- maxFileBytes: number;
18
- maxSkillBytes: number;
19
- defaultPageSize: 20;
20
- maxPageSize: 100;
15
+ export declare const PM_MCP_SKILL_LIMITS:Readonly<{
16
+ maxFilesPerSkill:512;
17
+ maxFileBytes:number;
18
+ maxSkillBytes:number;
19
+ defaultPageSize:20;
20
+ maxPageSize:100;
21
21
  }>;
22
22
  /** Origin from which a skill was loaded. */
23
23
  export type PmMcpSkillOrigin = "package" | "workspace";
24
24
  /** One immutable file advertised by a skill. */
25
25
  export interface PmMcpSkillResource {
26
26
  /** Addressable skill resource URI. */
27
- uri: string;
27
+ uri:string;
28
28
  /** SEP-2640 SHA-256 digest of the exact bytes returned by reads. */
29
- digest: string;
29
+ digest:string;
30
30
  /** Exact byte length. */
31
- size: number;
31
+ size:number;
32
32
  }
33
33
  /** Discoverable skill descriptor from the current SEP draft. */
34
34
  export interface PmMcpSkillDescriptor {
35
35
  /** URI of the skill's mandatory SKILL.md. */
36
- uri: string;
36
+ uri:string;
37
37
  /** Parsed, verbatim frontmatter object. */
38
- frontmatter: Record<string, unknown>;
38
+ frontmatter:Record<string,unknown>;
39
39
  /** Every bounded file in the skill directory. */
40
- resources: PmMcpSkillResource[];
40
+ resources:PmMcpSkillResource[];
41
41
  /** pm-specific compatibility and trust provenance. */
42
- _meta: {
43
- contractVersion: 1;
44
- extensionRevision: typeof PM_MCP_SKILLS_DRAFT_REVISION;
45
- origin: PmMcpSkillOrigin;
46
- packageVersion: string;
47
- protocolVersion: typeof PM_MCP_PROTOCOL_VERSION;
48
- trust: "untrusted";
49
- estimatedTokens: number;
42
+ _meta:{
43
+ contractVersion:1;
44
+ extensionRevision:typeof PM_MCP_SKILLS_DRAFT_REVISION;
45
+ origin:PmMcpSkillOrigin;
46
+ packageVersion:string;
47
+ protocolVersion:typeof PM_MCP_PROTOCOL_VERSION;
48
+ trust:"untrusted";
49
+ estimatedTokens:number;
50
50
  };
51
51
  }
52
52
  /** Inputs for loading the canonical package skills plus repository overrides. */
53
53
  export interface LoadPmMcpSkillsOptions {
54
54
  /** pm package root containing `.agents/skills`. */
55
- packageRoot: string;
55
+ packageRoot:string;
56
56
  /** Workspace root whose `.agents/skills` override package skills by name. */
57
- workspaceRoot?: string;
57
+ workspaceRoot?:string;
58
58
  /** Exact package version included in compatibility metadata. */
59
- packageVersion: string;
59
+ packageVersion:string;
60
60
  }
61
61
  /** List request inputs with opaque cursor pagination. */
62
62
  export interface ListPmMcpSkillsOptions {
63
63
  /** Opaque cursor returned by a previous page. */
64
- cursor?: string;
64
+ cursor?:string;
65
65
  /** Requested page size, bounded to 100. */
66
- limit?: number;
66
+ limit?:number;
67
67
  }
68
68
  /** One deterministic list page. */
69
69
  export interface ListPmMcpSkillsResult {
70
70
  /** Skills in lexical URI order. */
71
- skills: PmMcpSkillDescriptor[];
71
+ skills:PmMcpSkillDescriptor[];
72
72
  /** Opaque continuation cursor when more skills exist. */
73
- nextCursor?: string;
73
+ nextCursor?:string;
74
74
  /** Explicit completeness signal. */
75
- hasMore: boolean;
75
+ hasMore:boolean;
76
76
  }
77
77
  /** Exact read result for one skill resource. */
78
78
  export interface ReadPmMcpSkillResourceResult {
79
79
  /** Resource content returned as UTF-8 text or lossless Base64 bytes. */
80
- contents: Array<{
81
- uri: string;
82
- mimeType: "text/markdown" | "text/plain";
83
- text: string;
84
- _meta: {
85
- digest: string;
86
- origin: PmMcpSkillOrigin;
87
- trust: "untrusted";
80
+ contents:Array<{
81
+ uri:string;
82
+ mimeType:"text/markdown" | "text/plain";
83
+ text:string;
84
+ _meta:{
85
+ digest:string;
86
+ origin:PmMcpSkillOrigin;
87
+ trust:"untrusted";
88
88
  };
89
89
  } | {
90
- uri: string;
91
- mimeType: "application/octet-stream";
92
- blob: string;
93
- _meta: {
94
- digest: string;
95
- origin: PmMcpSkillOrigin;
96
- trust: "untrusted";
90
+ uri:string;
91
+ mimeType:"application/octet-stream";
92
+ blob:string;
93
+ _meta:{
94
+ digest:string;
95
+ origin:PmMcpSkillOrigin;
96
+ trust:"untrusted";
97
97
  };
98
98
  }>;
99
99
  }
100
100
  /** Direct-child directory listing defined by the current SEP draft. */
101
101
  export interface ReadPmMcpSkillDirectoryResult {
102
102
  /** Direct child file and directory resources in lexical URI order. */
103
- resources: Array<{
104
- uri: string;
105
- name: string;
106
- mimeType: "application/octet-stream" | "inode/directory" | "text/markdown" | "text/plain";
103
+ resources:Array<{
104
+ uri:string;
105
+ name:string;
106
+ mimeType:"application/octet-stream" | "inode/directory" | "text/markdown" | "text/plain";
107
107
  }>;
108
108
  /** Opaque continuation cursor when more direct children exist. */
109
- nextCursor?: string;
109
+ nextCursor?:string;
110
110
  /** Explicit completeness signal for this directory page. */
111
- hasMore: boolean;
111
+ hasMore:boolean;
112
112
  }
113
113
  /** Immutable in-memory registry for one request's package/workspace origins. */
114
114
  export declare class PmMcpSkillRegistry {
115
115
  #private;
116
116
  private constructor();
117
117
  /** Load package skills and apply validated workspace overrides by name. */
118
- static load(options: LoadPmMcpSkillsOptions): Promise<PmMcpSkillRegistry>;
118
+ static load(options:LoadPmMcpSkillsOptions):Promise<PmMcpSkillRegistry>;
119
119
  /** List skills in deterministic pages without loading file bodies. */
120
- list(options?: ListPmMcpSkillsOptions): ListPmMcpSkillsResult;
120
+ list(options?:ListPmMcpSkillsOptions):ListPmMcpSkillsResult;
121
121
  /** Get one skill descriptor by its SKILL.md URI. */
122
- get(uri: string): PmMcpSkillDescriptor;
122
+ get(uri:string):PmMcpSkillDescriptor;
123
123
  /** Read one digest-bound skill resource without following filesystem links. */
124
- read(uri: string): ReadPmMcpSkillResourceResult;
124
+ read(uri:string):ReadPmMcpSkillResourceResult;
125
125
  /** List one directory's direct children with opaque cursor pagination. */
126
- readDirectory(uri: string, options?: ListPmMcpSkillsOptions): ReadPmMcpSkillDirectoryResult;
126
+ readDirectory(uri:string,options?:ListPmMcpSkillsOptions):ReadPmMcpSkillDirectoryResult;
127
127
  }
@@ -4,7 +4,7 @@
4
4
  * Implements transport-neutral MCP 2026-07-28 subscription filtering,
5
5
  * acknowledgment, notification correlation, and graceful closure.
6
6
  */
7
- import { type PmMcpImplementation, type PmMcpServerCapabilities } from "./protocol.js";
7
+ import { type PmMcpImplementation,type PmMcpServerCapabilities } from "./protocol.js";
8
8
  /** Notification/result metadata key that correlates a subscription stream. */
9
9
  export declare const PM_MCP_SUBSCRIPTION_ID_META_KEY = "io.modelcontextprotocol/subscriptionId";
10
10
  /** JSON-RPC identifiers permitted for long-lived subscription requests. */
@@ -12,54 +12,54 @@ export type PmMcpSubscriptionId = string | number;
12
12
  /** Notification families a client may opt into on one listen stream. */
13
13
  export interface PmMcpSubscriptionFilter {
14
14
  /** Receive notifications when the tool list changes. */
15
- toolsListChanged?: boolean;
15
+ toolsListChanged?:boolean;
16
16
  /** Receive notifications when the prompt list changes. */
17
- promptsListChanged?: boolean;
17
+ promptsListChanged?:boolean;
18
18
  /** Receive notifications when the resource list changes. */
19
- resourcesListChanged?: boolean;
19
+ resourcesListChanged?:boolean;
20
20
  /** Receive updates for these exact resource URIs. */
21
- resourceSubscriptions?: string[];
21
+ resourceSubscriptions?:string[];
22
22
  }
23
23
  /** One JSON-RPC notification emitted by a subscription. */
24
24
  export interface PmMcpSubscriptionNotification {
25
25
  /** JSON-RPC revision. */
26
- jsonrpc: "2.0";
26
+ jsonrpc:"2.0";
27
27
  /** Notification method. */
28
- method: string;
28
+ method:string;
29
29
  /** Correlated notification parameters. */
30
- params: Record<string, unknown>;
30
+ params:Record<string,unknown>;
31
31
  }
32
32
  /** Sink used by stdio and HTTP adapters to write subscription messages. */
33
- export type PmMcpSubscriptionSink = (notification: PmMcpSubscriptionNotification) => void | Promise<void>;
33
+ export type PmMcpSubscriptionSink = (notification:PmMcpSubscriptionNotification) => void | Promise<void>;
34
34
  /** Validate and clone one subscription notification filter. */
35
- export declare function parseMcpSubscriptionFilter(value: unknown): PmMcpSubscriptionFilter;
35
+ export declare function parseMcpSubscriptionFilter(value:unknown):PmMcpSubscriptionFilter;
36
36
  /** Intersect a requested filter with notification capabilities the server advertises. */
37
- export declare function resolveMcpAcknowledgedSubscriptionFilter(requested: PmMcpSubscriptionFilter, capabilities: PmMcpServerCapabilities): PmMcpSubscriptionFilter;
37
+ export declare function resolveMcpAcknowledgedSubscriptionFilter(requested:PmMcpSubscriptionFilter,capabilities:PmMcpServerCapabilities):PmMcpSubscriptionFilter;
38
38
  /** Manage concurrent stateless subscriptions without retaining client sessions. */
39
39
  export declare class PmMcpSubscriptionRegistry {
40
40
  #private;
41
41
  /** Create a registry shared by one concrete transport process. */
42
- constructor(input: {
43
- capabilities: PmMcpServerCapabilities;
44
- serverInfo: PmMcpImplementation;
42
+ constructor(input:{
43
+ capabilities:PmMcpServerCapabilities;
44
+ serverInfo:PmMcpImplementation;
45
45
  });
46
46
  /** Number of currently open request-scoped subscription streams. */
47
- get size(): number;
47
+ get size():number;
48
48
  /** Open a subscription and emit its required first acknowledgment. */
49
- open(input: {
50
- id: PmMcpSubscriptionId;
51
- notifications: unknown;
52
- sink: PmMcpSubscriptionSink;
53
- }): Promise<PmMcpSubscriptionFilter>;
49
+ open(input:{
50
+ id:PmMcpSubscriptionId;
51
+ notifications:unknown;
52
+ sink:PmMcpSubscriptionSink;
53
+ }):Promise<PmMcpSubscriptionFilter>;
54
54
  /** Emit one list-change notification only to streams that opted into it. */
55
- emitListChanged(family: "tools" | "prompts" | "resources"): Promise<number>;
55
+ emitListChanged(family:"tools" | "prompts" | "resources"):Promise<number>;
56
56
  /** Emit a resource update only to streams that opted into the exact URI. */
57
- emitResourceUpdated(uri: string): Promise<number>;
57
+ emitResourceUpdated(uri:string):Promise<number>;
58
58
  /** Gracefully close one subscription and return its final modern result. */
59
- close(id: PmMcpSubscriptionId): Record<string, unknown> | undefined;
59
+ close(id:PmMcpSubscriptionId):Record<string,unknown> | undefined;
60
60
  /** Gracefully close every stream and preserve stable creation order. */
61
- closeAll(): Array<{
62
- id: PmMcpSubscriptionId;
63
- result: Record<string, unknown>;
61
+ closeAll():Array<{
62
+ id:PmMcpSubscriptionId;
63
+ result:Record<string,unknown>;
64
64
  }>;
65
65
  }
@@ -1,107 +1,107 @@
1
1
  import { type PmMcpRequestContext } from "./protocol.js";
2
- import { type PmMcpInputRequests, type PmMcpInputResponses } from "./interactions.js";
2
+ import { type PmMcpInputRequests,type PmMcpInputResponses } from "./interactions.js";
3
3
  /** Standard identifier used to negotiate the official MCP tasks extension. */
4
- export declare const PM_MCP_TASKS_EXTENSION: "io.modelcontextprotocol/tasks";
4
+ export declare const PM_MCP_TASKS_EXTENSION:"io.modelcontextprotocol/tasks";
5
5
  /** Lifecycle states defined by the official MCP tasks extension. */
6
- export declare const PM_MCP_TASK_STATUSES: readonly ["working", "input_required", "completed", "failed", "cancelled"];
6
+ export declare const PM_MCP_TASK_STATUSES:readonly ["working","input_required","completed","failed","cancelled"];
7
7
  /** Current state of a durable MCP task. */
8
8
  export type PmMcpTaskStatus = (typeof PM_MCP_TASK_STATUSES)[number];
9
9
  /** JSON-RPC error retained by a failed task. */
10
10
  export interface PmMcpTaskError {
11
11
  /** JSON-RPC or MCP error code. */
12
- code: number;
12
+ code:number;
13
13
  /** Bounded human-readable failure summary. */
14
- message: string;
14
+ message:string;
15
15
  /** Optional structured diagnostics. */
16
- data?: Record<string, unknown>;
16
+ data?:Record<string,unknown>;
17
17
  }
18
18
  /** Common public fields returned for every task state. */
19
19
  export interface PmMcpTask {
20
20
  /** Stable server-minted task identifier. */
21
- taskId: string;
21
+ taskId:string;
22
22
  /** Current extension lifecycle state. */
23
- status: PmMcpTaskStatus;
23
+ status:PmMcpTaskStatus;
24
24
  /** Optional bounded human-readable state summary. */
25
- statusMessage?: string;
25
+ statusMessage?:string;
26
26
  /** ISO 8601 creation timestamp. */
27
- createdAt: string;
27
+ createdAt:string;
28
28
  /** ISO 8601 last mutation timestamp. */
29
- lastUpdatedAt: string;
29
+ lastUpdatedAt:string;
30
30
  /** Milliseconds from creation before server retention may end. */
31
- ttlMs: number | null;
31
+ ttlMs:number | null;
32
32
  /** Suggested client polling interval. */
33
- pollIntervalMs?: number;
33
+ pollIntervalMs?:number;
34
34
  /** Additional forward-compatible extension fields. */
35
- [key: string]: unknown;
35
+ [key:string]:unknown;
36
36
  }
37
37
  /** Detailed public task state returned by `tasks/get`. */
38
38
  export type PmMcpDetailedTask = (PmMcpTask & {
39
- status: "working";
39
+ status:"working";
40
40
  }) | (PmMcpTask & {
41
- status: "input_required";
42
- inputRequests: PmMcpInputRequests;
41
+ status:"input_required";
42
+ inputRequests:PmMcpInputRequests;
43
43
  }) | (PmMcpTask & {
44
- status: "completed";
45
- result: Record<string, unknown>;
44
+ status:"completed";
45
+ result:Record<string,unknown>;
46
46
  }) | (PmMcpTask & {
47
- status: "failed";
48
- error: PmMcpTaskError;
47
+ status:"failed";
48
+ error:PmMcpTaskError;
49
49
  }) | (PmMcpTask & {
50
- status: "cancelled";
50
+ status:"cancelled";
51
51
  });
52
52
  /** Task handle returned instead of a synchronous tool result. */
53
53
  export type PmMcpCreateTaskResult = PmMcpTask & {
54
54
  /** Official extension result discriminator. */
55
- resultType: "task";
55
+ resultType:"task";
56
56
  };
57
57
  /** Construction options for one filesystem-backed task provider. */
58
58
  export interface PmMcpTaskStoreOptions {
59
59
  /** Tracker root whose ignored runtime area owns task records. */
60
- pmRoot: string;
60
+ pmRoot:string;
61
61
  /** Lock owner retained in diagnostics. */
62
- owner?: string;
62
+ owner?:string;
63
63
  /** Deterministic clock seam used by conformance tests. */
64
- now?: () => Date;
64
+ now?:() => Date;
65
65
  /** Deterministic task-id seam used by conformance tests. */
66
- taskIdFactory?: () => string;
66
+ taskIdFactory?:() => string;
67
67
  /** Process identifier used for restart recovery. */
68
- workerPid?: number;
68
+ workerPid?:number;
69
69
  }
70
70
  /** Filesystem-backed provider for official MCP task methods and state changes. */
71
71
  export declare class PmMcpTaskStore {
72
72
  #private;
73
73
  /** Create one task store scoped to a tracker runtime directory. */
74
- constructor(options: PmMcpTaskStoreOptions);
74
+ constructor(options:PmMcpTaskStoreOptions);
75
75
  /** Durably create a working task before returning its public handle. */
76
- create(input: {
77
- principal: string;
78
- ttlMs?: number | null;
79
- pollIntervalMs?: number;
80
- statusMessage?: string;
81
- }): Promise<PmMcpCreateTaskResult>;
76
+ create(input:{
77
+ principal:string;
78
+ ttlMs?:number | null;
79
+ pollIntervalMs?:number;
80
+ statusMessage?:string;
81
+ }):Promise<PmMcpCreateTaskResult>;
82
82
  /** Return authoritative task state, applying expiry and restart recovery. */
83
- get(taskId: string, principal: string): Promise<PmMcpDetailedTask>;
83
+ get(taskId:string,principal:string):Promise<PmMcpDetailedTask>;
84
84
  /** Transition a nonterminal task to an MRTR input-required state. */
85
- requireInput(input: {
86
- taskId: string;
87
- principal: string;
88
- requestContext: PmMcpRequestContext;
89
- inputRequests: unknown;
90
- statusMessage?: string;
91
- }): Promise<PmMcpDetailedTask>;
85
+ requireInput(input:{
86
+ taskId:string;
87
+ principal:string;
88
+ requestContext:PmMcpRequestContext;
89
+ inputRequests:unknown;
90
+ statusMessage?:string;
91
+ }):Promise<PmMcpDetailedTask>;
92
92
  /** Accept outstanding task inputs, ignoring unknown and duplicate response keys. */
93
- update(taskId: string, principal: string, inputResponses: unknown): Promise<{
94
- acceptedKeys: string[];
95
- remainingKeys: string[];
93
+ update(taskId:string,principal:string,inputResponses:unknown):Promise<{
94
+ acceptedKeys:string[];
95
+ remainingKeys:string[];
96
96
  }>;
97
97
  /** Retrieve and clear accepted task inputs for a resumed worker. */
98
- takeInputResponses(taskId: string, principal: string): Promise<PmMcpInputResponses>;
98
+ takeInputResponses(taskId:string,principal:string):Promise<PmMcpInputResponses>;
99
99
  /** Record one immutable successful terminal result. */
100
- complete(taskId: string, principal: string, result: Record<string, unknown>): Promise<PmMcpDetailedTask>;
100
+ complete(taskId:string,principal:string,result:Record<string,unknown>):Promise<PmMcpDetailedTask>;
101
101
  /** Record one immutable JSON-RPC terminal failure. */
102
- fail(taskId: string, principal: string, error: PmMcpTaskError): Promise<PmMcpDetailedTask>;
102
+ fail(taskId:string,principal:string,error:PmMcpTaskError):Promise<PmMcpDetailedTask>;
103
103
  /** Cooperatively cancel a nonterminal task and acknowledge terminal tasks idempotently. */
104
- cancel(taskId: string, principal: string): Promise<PmMcpDetailedTask>;
104
+ cancel(taskId:string,principal:string):Promise<PmMcpDetailedTask>;
105
105
  }
106
106
  /** Build a filesystem-backed task provider for a tracker runtime root. */
107
- export declare function createMcpTaskStore(options: PmMcpTaskStoreOptions): PmMcpTaskStore;
107
+ export declare function createMcpTaskStore(options:PmMcpTaskStoreOptions):PmMcpTaskStore;