@unbrained/pm-cli 2026.10.12 → 2026.10.13

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (708) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +27 -0
  3. package/dist/cli/after-command-context-usage.d.ts +8 -8
  4. package/dist/cli/bundle-integrity.d.ts +23 -23
  5. package/dist/cli/commander-usage.d.ts +26 -26
  6. package/dist/cli/commander-usage.js +2 -2
  7. package/dist/cli/error-guidance.d.ts +158 -163
  8. package/dist/cli/error-guidance.js +2 -2
  9. package/dist/cli/extension-command-help.d.ts +68 -68
  10. package/dist/cli/extension-command-options.d.ts +20 -20
  11. package/dist/cli/extension-recovery.d.ts +20 -20
  12. package/dist/cli/help-content.d.ts +16 -16
  13. package/dist/cli/help-content.js +2 -2
  14. package/dist/cli/help-json-payload.d.ts +40 -40
  15. package/dist/cli/invocation-profile.d.ts +8 -8
  16. package/dist/cli/main.d.ts +165 -165
  17. package/dist/cli/main.js +1 -1
  18. package/dist/cli/migration-gates.d.ts +20 -20
  19. package/dist/cli/register-list-query.d.ts +4 -4
  20. package/dist/cli/register-mutation-options.d.ts +2 -2
  21. package/dist/cli/register-operations.d.ts +66 -66
  22. package/dist/cli/register-setup.d.ts +1 -1
  23. package/dist/cli/register-structured-mutation.d.ts +3 -3
  24. package/dist/cli/register-structured-mutation.js +1 -1
  25. package/dist/cli/runtime/activation.d.ts +3 -3
  26. package/dist/cli/runtime/invocation-options.js +1 -1
  27. package/dist/cli/runtime/selection.d.ts +6 -6
  28. package/dist/cli/runtime-compatibility-boundary.d.ts +12 -12
  29. package/dist/cli-bundle/bundle-manifest.json +1 -1
  30. package/dist/cli-bundle/chunks/{chunk-MHPU2LDF.js → chunk-AM2XOZKE.js} +2 -2
  31. package/dist/cli-bundle/chunks/{chunk-UABZJXIS.js → chunk-APWPC4ZZ.js} +2 -2
  32. package/dist/cli-bundle/chunks/chunk-DJDRHJBP.js +234 -0
  33. package/dist/cli-bundle/chunks/{chunk-B465HPS5.js → chunk-DUK5DHI6.js} +2 -2
  34. package/dist/cli-bundle/chunks/chunk-HXHFKXLV.js +2 -0
  35. package/dist/cli-bundle/chunks/chunk-IFPJDJUM.js +20 -0
  36. package/dist/cli-bundle/chunks/{chunk-QM3M7GB5.js → chunk-LBDWFWPK.js} +2 -2
  37. package/dist/cli-bundle/chunks/{chunk-X2I2EEAS.js → chunk-N5EXRYCZ.js} +2 -2
  38. package/dist/cli-bundle/chunks/chunk-PSNS537F.js +30 -0
  39. package/dist/cli-bundle/chunks/{chunk-3LQTJN4J.js → chunk-RL45OYTL.js} +2 -2
  40. package/dist/cli-bundle/chunks/{chunk-DT3KUUKY.js → chunk-UBTYYZIE.js} +49 -49
  41. package/dist/cli-bundle/chunks/chunk-WYZGZV2M.js +2 -0
  42. package/dist/cli-bundle/chunks/{chunk-GUVKPOY6.js → chunk-YH6H3UVE.js} +10 -10
  43. package/dist/cli-bundle/chunks/{register-list-query-OR33UEML.js → register-list-query-BJ742QOR.js} +2 -2
  44. package/dist/cli-bundle/chunks/{register-mutation-R34EJ3NH.js → register-mutation-GGGBRIH2.js} +3 -3
  45. package/dist/cli-bundle/chunks/{register-operations-UHSMEHSF.js → register-operations-E6HXYHNM.js} +2 -2
  46. package/dist/cli-bundle/chunks/{register-setup-5E3PT22L.js → register-setup-4ZVTVEPY.js} +2 -2
  47. package/dist/cli-bundle/focused-chunks/{chunk-TS46OZD5.js → chunk-3LQEBXU5.js} +12 -12
  48. package/dist/cli-bundle/focused-chunks/{chunk-AJG3DBXR.js → chunk-6BTUISKV.js} +2 -2
  49. package/dist/cli-bundle/focused-chunks/chunk-73UNAJHD.js +2 -0
  50. package/dist/cli-bundle/focused-chunks/{chunk-RNAWRTQV.js → chunk-DVK7VKZL.js} +2 -2
  51. package/dist/cli-bundle/focused-chunks/{chunk-7QIZB2F2.js → chunk-F5J3ATMV.js} +14 -14
  52. package/dist/cli-bundle/focused-chunks/chunk-IIKFTJVC.js +2 -0
  53. package/dist/cli-bundle/focused-chunks/chunk-IOTNG6CN.js +2 -0
  54. package/dist/cli-bundle/focused-chunks/{chunk-Z4T3637Y.js → chunk-KGFRQ34R.js} +2 -2
  55. package/dist/cli-bundle/focused-chunks/chunk-NNW5BS5L.js +3 -0
  56. package/dist/cli-bundle/focused-chunks/{chunk-VBTLX5SN.js → chunk-QMNAY25P.js} +62 -62
  57. package/dist/cli-bundle/focused-chunks/{chunk-CYEZLKLL.js → chunk-R23T7GFZ.js} +2 -2
  58. package/dist/cli-bundle/focused-chunks/chunk-RAA7SVRA.js +8 -0
  59. package/dist/cli-bundle/focused-chunks/{chunk-SV6YYZLR.js → chunk-RU6GCFN3.js} +2 -2
  60. package/dist/cli-bundle/focused-chunks/{chunk-YCOJLIDI.js → chunk-S6ITXQ5T.js} +4 -4
  61. package/dist/cli-bundle/focused-chunks/{chunk-OGOLIS5R.js → chunk-SOB7X4FJ.js} +2 -2
  62. package/dist/cli-bundle/focused-chunks/chunk-UPJA45K7.js +26 -0
  63. package/dist/cli-bundle/main.js +20 -20
  64. package/dist/cli-bundle/sdk-authoring.js +1 -1
  65. package/dist/cli-bundle/sdk-contracts.js +2 -2
  66. package/dist/cli-bundle/sdk-core.js +23 -23
  67. package/dist/cli-bundle/sdk-governance.js +1 -1
  68. package/dist/cli-bundle/sdk-graph.js +1 -1
  69. package/dist/cli-bundle/sdk-merge.js +51 -51
  70. package/dist/cli-bundle/sdk-query.js +1 -1
  71. package/dist/cli-bundle/sdk-runtime.js +1 -1
  72. package/dist/cli-bundle/sdk-testing.js +1 -1
  73. package/dist/cli-bundle/sdk.js +8 -8
  74. package/dist/cli.d.ts +4 -4
  75. package/dist/core/checkpoint/checkpoint-gc.d.ts +32 -32
  76. package/dist/core/checkpoint/mutation-checkpoint.d.ts +34 -34
  77. package/dist/core/config/nested-settings.d.ts +26 -26
  78. package/dist/core/config/positional-value.d.ts +16 -16
  79. package/dist/core/diagnostics/remediation.d.ts +6 -6
  80. package/dist/core/diagnostics/remediation.js +1 -1
  81. package/dist/core/extensions/activation-summary-markdown.d.ts +6 -6
  82. package/dist/core/extensions/activation-summary.d.ts +54 -54
  83. package/dist/core/extensions/activation-transaction.d.ts +7 -7
  84. package/dist/core/extensions/capability-usage.d.ts +26 -26
  85. package/dist/core/extensions/command-hook-context.d.ts +26 -26
  86. package/dist/core/extensions/contribution-inventory.d.ts +21 -21
  87. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  88. package/dist/core/extensions/extension-capability-aliases.d.ts +2 -2
  89. package/dist/core/extensions/extension-policy.d.ts +80 -80
  90. package/dist/core/extensions/extension-types.d.ts +1294 -1285
  91. package/dist/core/extensions/extension-types.js +1 -1
  92. package/dist/core/extensions/flag-definition-validation.d.ts +4 -4
  93. package/dist/core/extensions/item-fields.d.ts +3 -2
  94. package/dist/core/extensions/item-fields.js +1 -1
  95. package/dist/core/extensions/loader.d.ts +36 -36
  96. package/dist/core/extensions/loader.js +1 -1
  97. package/dist/core/extensions/manifest-schema.d.ts +16 -16
  98. package/dist/core/extensions/module-graph-snapshot.d.ts +8 -8
  99. package/dist/core/extensions/read-output-contract.d.ts +5 -0
  100. package/dist/core/extensions/read-output-contract.js +2 -0
  101. package/dist/core/extensions/registration-values.d.ts +1 -1
  102. package/dist/core/extensions/reserved-host-flags.d.ts +6 -6
  103. package/dist/core/extensions/version-compat.d.ts +10 -10
  104. package/dist/core/fs/fs-utils.d.ts +1 -1
  105. package/dist/core/fs/host-environment-errors.d.ts +14 -14
  106. package/dist/core/governance/content-fields.d.ts +31 -31
  107. package/dist/core/governance/issue-codes.d.ts +27 -27
  108. package/dist/core/governance/metadata-coverage.d.ts +91 -91
  109. package/dist/core/history/drift-scan.d.ts +26 -26
  110. package/dist/core/history/event-index.d.ts +41 -41
  111. package/dist/core/history/history-compact-bulk.d.ts +22 -22
  112. package/dist/core/history/history-diff.d.ts +22 -22
  113. package/dist/core/history/history-rewrite.d.ts +66 -66
  114. package/dist/core/history/history-storage-stats.d.ts +31 -31
  115. package/dist/core/history/history-stream-policy.d.ts +12 -12
  116. package/dist/core/history/history.d.ts +22 -22
  117. package/dist/core/history/identity.d.ts +6 -6
  118. package/dist/core/history/operation-contract.d.ts +9 -9
  119. package/dist/core/history/projection.d.ts +15 -15
  120. package/dist/core/history/read.d.ts +4 -4
  121. package/dist/core/history/replay.d.ts +51 -49
  122. package/dist/core/history/replay.js +1 -1
  123. package/dist/core/history/workspace-history.d.ts +101 -101
  124. package/dist/core/io/bulk-ids-input.d.ts +4 -4
  125. package/dist/core/item/actionability.d.ts +40 -40
  126. package/dist/core/item/id.d.ts +3 -3
  127. package/dist/core/item/item-format-version.d.ts +8 -8
  128. package/dist/core/item/item-format.d.ts +35 -35
  129. package/dist/core/item/item-type-definition.d.ts +2 -2
  130. package/dist/core/item/parent-reference-policy.d.ts +1 -1
  131. package/dist/core/item/parse.d.ts +12 -12
  132. package/dist/core/item/sprint-release-format.d.ts +2 -2
  133. package/dist/core/item/status-filter.d.ts +4 -4
  134. package/dist/core/item/toon-decode.d.ts +9 -9
  135. package/dist/core/item/type-registry.d.ts +40 -40
  136. package/dist/core/lock/lock-gc.d.ts +50 -50
  137. package/dist/core/lock/lock.d.ts +37 -37
  138. package/dist/core/output/mutation-projection.d.ts +6 -6
  139. package/dist/core/output/output-control.d.ts +4 -4
  140. package/dist/core/output/output.d.ts +40 -40
  141. package/dist/core/output/query-summary.d.ts +5 -5
  142. package/dist/core/packages/manifest.d.ts +50 -50
  143. package/dist/core/policy/workflow-policy-schema.d.ts +306 -306
  144. package/dist/core/policy/workflow-policy-store.d.ts +7 -7
  145. package/dist/core/policy/workflow-policy.d.ts +81 -81
  146. package/dist/core/profile/profile-describe.d.ts +40 -40
  147. package/dist/core/profile/profile-lint.d.ts +20 -20
  148. package/dist/core/profile/profile-plan.d.ts +84 -84
  149. package/dist/core/profile/profile-presets.d.ts +52 -52
  150. package/dist/core/reproducibility/context.d.ts +6 -6
  151. package/dist/core/schema/fields-file.d.ts +54 -54
  152. package/dist/core/schema/item-types-file.d.ts +36 -36
  153. package/dist/core/schema/runtime-field-values.d.ts +2 -2
  154. package/dist/core/schema/runtime-schema.d.ts +86 -86
  155. package/dist/core/schema/status-defs-file.d.ts +36 -36
  156. package/dist/core/schema/type-inference.d.ts +14 -14
  157. package/dist/core/schema/type-workflows.d.ts +22 -22
  158. package/dist/core/search/background-refresh.d.ts +9 -9
  159. package/dist/core/search/bm25.d.ts +19 -19
  160. package/dist/core/search/cache.d.ts +35 -35
  161. package/dist/core/search/corpus.d.ts +12 -12
  162. package/dist/core/search/embedding-batches.d.ts +48 -48
  163. package/dist/core/search/eval.d.ts +49 -49
  164. package/dist/core/search/http-client.d.ts +38 -38
  165. package/dist/core/search/providers.d.ts +41 -41
  166. package/dist/core/search/relevance.d.ts +20 -20
  167. package/dist/core/search/semantic-defaults.d.ts +8 -8
  168. package/dist/core/search/staleness.d.ts +4 -4
  169. package/dist/core/search/vector-stores.d.ts +78 -78
  170. package/dist/core/search/vectorization-metadata.d.ts +6 -6
  171. package/dist/core/sentry/helpers.d.ts +15 -15
  172. package/dist/core/sentry/instrument.d.ts +40 -40
  173. package/dist/core/session/session-state.d.ts +32 -32
  174. package/dist/core/shared/agent-session-context.d.ts +14 -14
  175. package/dist/core/shared/author.d.ts +128 -128
  176. package/dist/core/shared/command-types.d.ts +40 -40
  177. package/dist/core/shared/conflict-markers.d.ts +6 -6
  178. package/dist/core/shared/constants.d.ts +13 -13
  179. package/dist/core/shared/errors.d.ts +194 -183
  180. package/dist/core/shared/errors.js +1 -1
  181. package/dist/core/shared/secret-rules.d.ts +97 -97
  182. package/dist/core/shared/serial-queue.d.ts +8 -8
  183. package/dist/core/shared/split-comma-list.d.ts +6 -6
  184. package/dist/core/shared/time.d.ts +23 -23
  185. package/dist/core/store/item-format-migration.d.ts +10 -10
  186. package/dist/core/store/item-metadata-cache.d.ts +38 -38
  187. package/dist/core/store/item-metadata-query-index.d.ts +79 -79
  188. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  189. package/dist/core/store/item-store.d.ts +110 -110
  190. package/dist/core/store/paths.d.ts +2 -2
  191. package/dist/core/store/settings-read-cache.d.ts +12 -12
  192. package/dist/core/store/settings-validator.d.ts +165 -165
  193. package/dist/core/store/settings.d.ts +59 -59
  194. package/dist/core/telemetry/observability.d.ts +17 -17
  195. package/dist/core/telemetry/policy.d.ts +3 -3
  196. package/dist/core/telemetry/runtime.d.ts +241 -241
  197. package/dist/core/test/background-runs.d.ts +185 -185
  198. package/dist/core/test/item-test-run-tracking.d.ts +6 -6
  199. package/dist/core/test/run-selectors.d.ts +18 -18
  200. package/dist/core/validate/fix-planning.d.ts +50 -50
  201. package/dist/core/validate/missing-by-type.d.ts +4 -4
  202. package/dist/core/validate/missing-link-owners.d.ts +30 -30
  203. package/dist/core/validate/stale-file-classification.d.ts +8 -8
  204. package/dist/mcp/http-server.d.ts +28 -28
  205. package/dist/mcp/legacy-adapter.d.ts +33 -33
  206. package/dist/mcp/runtime-capabilities.d.ts +16 -16
  207. package/dist/mcp/server.d.ts +50 -50
  208. package/dist/mcp/tool-definitions.d.ts +36 -36
  209. package/dist/sdk/agent/closed-domain-contracts.d.ts +18 -18
  210. package/dist/sdk/agent/command-recovery.d.ts +4 -0
  211. package/dist/sdk/agent/command-recovery.js +1 -1
  212. package/dist/sdk/agent/identity-config.d.ts +32 -32
  213. package/dist/sdk/agent/item-addressing.d.ts +8 -8
  214. package/dist/sdk/agent/refusal-closure-census.d.ts +34 -34
  215. package/dist/sdk/agent/refusal-closure.d.ts +42 -42
  216. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +46 -46
  217. package/dist/sdk/agent/refusal-reachability.d.ts +112 -112
  218. package/dist/sdk/agent/subcommand-recovery.d.ts +25 -25
  219. package/dist/sdk/agent/task-transcript-contracts.d.ts +30 -30
  220. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +38 -38
  221. package/dist/sdk/agent-capability-contracts.d.ts +37 -37
  222. package/dist/sdk/annotations.d.ts +106 -106
  223. package/dist/sdk/author-attribution.d.ts +76 -76
  224. package/dist/sdk/authoring.d.ts +1 -1
  225. package/dist/sdk/authoring.js +1 -1
  226. package/dist/sdk/cli-bootstrap.d.ts +70 -70
  227. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +63 -63
  228. package/dist/sdk/cli-contracts/command-aliases.d.ts +14 -14
  229. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +70 -70
  230. package/dist/sdk/cli-contracts/commander-types.d.ts +17 -17
  231. package/dist/sdk/cli-contracts/completeness.d.ts +26 -26
  232. package/dist/sdk/cli-contracts/enum-contracts.d.ts +5 -5
  233. package/dist/sdk/cli-contracts/flag-contracts.d.ts +32 -32
  234. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  235. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +42 -42
  236. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +84 -84
  237. package/dist/sdk/cli-contracts/grammar-contracts.js +1 -1
  238. package/dist/sdk/cli-contracts/registration-helpers.d.ts +36 -36
  239. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +290 -294
  240. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  241. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +793 -793
  242. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +391 -391
  243. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +6 -6
  244. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  245. package/dist/sdk/cli-contracts/tool-schema.js +1 -1
  246. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +24 -24
  247. package/dist/sdk/comments.d.ts +44 -44
  248. package/dist/sdk/compile-cache.d.ts +4 -4
  249. package/dist/sdk/completion/shared.d.ts +22 -22
  250. package/dist/sdk/compose.d.ts +156 -156
  251. package/dist/sdk/config.d.ts +123 -123
  252. package/dist/sdk/context/semantic-session-attribution.d.ts +14 -14
  253. package/dist/sdk/context/usage-ledger.d.ts +20 -20
  254. package/dist/sdk/context-intent-contracts.d.ts +50 -50
  255. package/dist/sdk/context-intent-contracts.js +1 -1
  256. package/dist/sdk/context-intent-runtime.d.ts +8 -8
  257. package/dist/sdk/context-packing.d.ts +78 -78
  258. package/dist/sdk/context-relevance.d.ts +189 -180
  259. package/dist/sdk/context-relevance.js +1 -1
  260. package/dist/sdk/context-signal-store.d.ts +84 -84
  261. package/dist/sdk/context-usage.d.ts +92 -92
  262. package/dist/sdk/corpus-shape.d.ts +101 -101
  263. package/dist/sdk/define.d.ts +2 -2
  264. package/dist/sdk/dependencies.d.ts +116 -116
  265. package/dist/sdk/dependency-flag-validation.d.ts +14 -12
  266. package/dist/sdk/dependency-flag-validation.js +1 -1
  267. package/dist/sdk/dependency-provenance.d.ts +30 -30
  268. package/dist/sdk/docs.d.ts +32 -32
  269. package/dist/sdk/duplicates.d.ts +21 -21
  270. package/dist/sdk/environment/agent-environment.d.ts +196 -196
  271. package/dist/sdk/environment/project-runtime-compatibility.d.ts +56 -56
  272. package/dist/sdk/environment/source-context.d.ts +6 -6
  273. package/dist/sdk/error-code-catalog.d.ts +40 -40
  274. package/dist/sdk/errors.d.ts +29 -29
  275. package/dist/sdk/eval.d.ts +45 -45
  276. package/dist/sdk/extension/author-manifest.d.ts +14 -14
  277. package/dist/sdk/extension/bundled-catalog.d.ts +7 -7
  278. package/dist/sdk/extension/describe.d.ts +36 -36
  279. package/dist/sdk/extension/doctor.d.ts +29 -29
  280. package/dist/sdk/extension/install-plan.d.ts +55 -55
  281. package/dist/sdk/extension/install-receipts.d.ts +2 -2
  282. package/dist/sdk/extension/install-runtime.d.ts +8 -8
  283. package/dist/sdk/extension/install-snapshot.d.ts +14 -14
  284. package/dist/sdk/extension/install-sources.d.ts +96 -96
  285. package/dist/sdk/extension/managed-state.d.ts +66 -66
  286. package/dist/sdk/extension/migrations.d.ts +82 -82
  287. package/dist/sdk/extension/output-ownership.d.ts +24 -24
  288. package/dist/sdk/extension/runtime-summary.d.ts +5 -5
  289. package/dist/sdk/extension/scaffold.d.ts +12 -12
  290. package/dist/sdk/extension/shared.d.ts +15 -15
  291. package/dist/sdk/extension/source-resolution.d.ts +30 -30
  292. package/dist/sdk/extension/static-inventory.d.ts +42 -42
  293. package/dist/sdk/extension/update-check.d.ts +10 -10
  294. package/dist/sdk/extension.d.ts +320 -320
  295. package/dist/sdk/files.d.ts +157 -157
  296. package/dist/sdk/flag-invocation-contracts.d.ts +44 -44
  297. package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -1
  298. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  299. package/dist/sdk/governance/artifact-ledgers.d.ts +35 -35
  300. package/dist/sdk/governance/assurance-action.d.ts +68 -68
  301. package/dist/sdk/governance/assurance-action.js +1 -1
  302. package/dist/sdk/governance/assurance-mutation-error.d.ts +36 -36
  303. package/dist/sdk/governance/assurance-presets.d.ts +24 -24
  304. package/dist/sdk/governance/assurance-runtime.d.ts +14 -14
  305. package/dist/sdk/governance/assurance.d.ts +353 -353
  306. package/dist/sdk/governance/boundary-fixtures.d.ts +60 -60
  307. package/dist/sdk/governance/closure-timestamps.d.ts +9 -9
  308. package/dist/sdk/governance/coverage-assurance.d.ts +10 -10
  309. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +75 -75
  310. package/dist/sdk/governance/defect-recurrence-graph.d.ts +18 -18
  311. package/dist/sdk/governance/defect-recurrence.d.ts +186 -181
  312. package/dist/sdk/governance/defect-recurrence.js +1 -1
  313. package/dist/sdk/governance/extension-host-version.d.ts +16 -16
  314. package/dist/sdk/governance/gc.d.ts +48 -48
  315. package/dist/sdk/governance/health-merge-evidence.d.ts +5 -5
  316. package/dist/sdk/governance/health.d.ts +188 -188
  317. package/dist/sdk/governance/hierarchy-validation.d.ts +13 -13
  318. package/dist/sdk/governance/linked-file-report.d.ts +26 -26
  319. package/dist/sdk/governance/merge-receipt-history.d.ts +36 -36
  320. package/dist/sdk/governance/provenance-health.d.ts +64 -64
  321. package/dist/sdk/governance/reindex.d.ts +89 -89
  322. package/dist/sdk/governance/reliability.d.ts +56 -56
  323. package/dist/sdk/governance/stale-work.d.ts +22 -22
  324. package/dist/sdk/governance/status-role-diagnostics.d.ts +12 -12
  325. package/dist/sdk/governance/storage-integrity.d.ts +54 -54
  326. package/dist/sdk/governance/tracked-runtime-cache.d.ts +10 -10
  327. package/dist/sdk/governance/upgrade.d.ts +104 -104
  328. package/dist/sdk/governance/validate-history-drift.d.ts +2 -2
  329. package/dist/sdk/governance/validate-item-reader.d.ts +6 -6
  330. package/dist/sdk/governance/validate.d.ts +191 -191
  331. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  332. package/dist/sdk/governance/workflow-policy.d.ts +28 -28
  333. package/dist/sdk/governance/workspace-position.d.ts +46 -46
  334. package/dist/sdk/graph/adapter.d.ts +66 -66
  335. package/dist/sdk/graph/analytics.d.ts +54 -54
  336. package/dist/sdk/graph/assembly.d.ts +80 -80
  337. package/dist/sdk/graph/cache.d.ts +29 -29
  338. package/dist/sdk/graph/cardinality-integrity.d.ts +13 -0
  339. package/dist/sdk/graph/cardinality-integrity.js +2 -0
  340. package/dist/sdk/graph/centrality.d.ts +34 -34
  341. package/dist/sdk/graph/conformance.d.ts +33 -33
  342. package/dist/sdk/graph/deadline-scheduling.d.ts +58 -58
  343. package/dist/sdk/graph/durable-cache.d.ts +26 -26
  344. package/dist/sdk/graph/governance.d.ts +165 -165
  345. package/dist/sdk/graph/hierarchy-integrity.d.ts +52 -52
  346. package/dist/sdk/graph/index.d.ts +1 -0
  347. package/dist/sdk/graph/index.js +1 -1
  348. package/dist/sdk/graph/lifecycle-coverage.d.ts +17 -17
  349. package/dist/sdk/graph/mutation-advisory.d.ts +11 -11
  350. package/dist/sdk/graph/query-contracts.d.ts +10 -10
  351. package/dist/sdk/graph/remediation.d.ts +25 -25
  352. package/dist/sdk/graph/run.d.ts +392 -392
  353. package/dist/sdk/graph/scheduling.d.ts +38 -38
  354. package/dist/sdk/graph/traversal.d.ts +14 -14
  355. package/dist/sdk/guide-topics.d.ts +32 -32
  356. package/dist/sdk/guide.d.ts +62 -62
  357. package/dist/sdk/history/attestation-command.d.ts +12 -12
  358. package/dist/sdk/history/attestation-contract.d.ts +78 -78
  359. package/dist/sdk/history/attestation-scan.d.ts +6 -6
  360. package/dist/sdk/history/maintenance.d.ts +46 -46
  361. package/dist/sdk/history/salvage.d.ts +18 -18
  362. package/dist/sdk/history/subject.d.ts +9 -9
  363. package/dist/sdk/history-analytics.d.ts +84 -84
  364. package/dist/sdk/history-compact.d.ts +103 -103
  365. package/dist/sdk/history-mcp.d.ts +8 -8
  366. package/dist/sdk/history-provenance.d.ts +59 -59
  367. package/dist/sdk/history-read.d.ts +36 -36
  368. package/dist/sdk/history-redact.d.ts +78 -78
  369. package/dist/sdk/history-repair.d.ts +158 -158
  370. package/dist/sdk/history-repair.js +1 -1
  371. package/dist/sdk/improvement-ledger.d.ts +102 -102
  372. package/dist/sdk/init-agent-guidance.d.ts +70 -70
  373. package/dist/sdk/init.d.ts +152 -152
  374. package/dist/sdk/item-children.d.ts +28 -28
  375. package/dist/sdk/item-schedule.d.ts +12 -12
  376. package/dist/sdk/item-transaction.d.ts +100 -100
  377. package/dist/sdk/learnings.d.ts +42 -42
  378. package/dist/sdk/lifecycle/append.d.ts +14 -14
  379. package/dist/sdk/lifecycle/claim.d.ts +60 -60
  380. package/dist/sdk/lifecycle/close-many.d.ts +94 -94
  381. package/dist/sdk/lifecycle/close.d.ts +27 -27
  382. package/dist/sdk/lifecycle/copy.d.ts +18 -18
  383. package/dist/sdk/lifecycle/core-field-recovery.d.ts +7 -0
  384. package/dist/sdk/lifecycle/core-field-recovery.js +2 -0
  385. package/dist/sdk/lifecycle/create.d.ts +82 -82
  386. package/dist/sdk/lifecycle/create.js +1 -1
  387. package/dist/sdk/lifecycle/delete.d.ts +28 -28
  388. package/dist/sdk/lifecycle/focus.d.ts +10 -10
  389. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +10 -10
  390. package/dist/sdk/lifecycle/hierarchy-mutation-lock.js +1 -1
  391. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +54 -54
  392. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +4 -4
  393. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  394. package/dist/sdk/lifecycle/mutation-command-options.d.ts +116 -116
  395. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +6 -0
  396. package/dist/sdk/lifecycle/mutation-facet-contracts.js +2 -0
  397. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +42 -42
  398. package/dist/sdk/lifecycle/plan.d.ts +217 -217
  399. package/dist/sdk/lifecycle/reopen.d.ts +29 -24
  400. package/dist/sdk/lifecycle/reopen.js +1 -1
  401. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +3 -3
  402. package/dist/sdk/lifecycle/restore.d.ts +33 -33
  403. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +19 -19
  404. package/dist/sdk/lifecycle/task-composition.d.ts +4 -4
  405. package/dist/sdk/lifecycle/update-many.d.ts +79 -79
  406. package/dist/sdk/lifecycle/update.d.ts +131 -132
  407. package/dist/sdk/lifecycle/update.js +2 -2
  408. package/dist/sdk/lifecycle-completion.d.ts +22 -22
  409. package/dist/sdk/lifecycle-policy.d.ts +52 -52
  410. package/dist/sdk/linked-artifacts.d.ts +69 -69
  411. package/dist/sdk/mcp/apps.d.ts +32 -32
  412. package/dist/sdk/mcp/authorization.d.ts +76 -76
  413. package/dist/sdk/mcp/discovery.d.ts +111 -111
  414. package/dist/sdk/mcp/interactions.d.ts +61 -61
  415. package/dist/sdk/mcp/protocol.d.ts +78 -78
  416. package/dist/sdk/mcp/skills.d.ts +88 -88
  417. package/dist/sdk/mcp/subscriptions.d.ts +39 -39
  418. package/dist/sdk/mcp/tasks.d.ts +75 -75
  419. package/dist/sdk/mcp/transport.d.ts +11 -11
  420. package/dist/sdk/merge/abandoned-receipts.d.ts +6 -6
  421. package/dist/sdk/merge/driver.d.ts +60 -60
  422. package/dist/sdk/merge/install.d.ts +64 -64
  423. package/dist/sdk/merge/receipt-file-boundary.d.ts +5 -5
  424. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  425. package/dist/sdk/merge/receipt-schema.d.ts +2 -2
  426. package/dist/sdk/merge/receipts.d.ts +156 -156
  427. package/dist/sdk/merge/reconcile.d.ts +36 -36
  428. package/dist/sdk/merge/reconcile.js +1 -1
  429. package/dist/sdk/merge/three-way.d.ts +77 -76
  430. package/dist/sdk/merge/three-way.js +1 -1
  431. package/dist/sdk/mutation-events.d.ts +84 -84
  432. package/dist/sdk/mutation-guard.d.ts +106 -106
  433. package/dist/sdk/notes.d.ts +52 -52
  434. package/dist/sdk/output/table-rows.d.ts +8 -8
  435. package/dist/sdk/output-contracts.d.ts +38 -38
  436. package/dist/sdk/output-projection.d.ts +142 -142
  437. package/dist/sdk/output-token-accounting.d.ts +27 -27
  438. package/dist/sdk/output.d.ts +28 -28
  439. package/dist/sdk/package-import-adapters.d.ts +54 -54
  440. package/dist/sdk/pagination.d.ts +29 -29
  441. package/dist/sdk/profile.d.ts +123 -123
  442. package/dist/sdk/provenance.d.ts +58 -58
  443. package/dist/sdk/public-surface.json +1 -1
  444. package/dist/sdk/query/activity.d.ts +118 -118
  445. package/dist/sdk/query/aggregate.d.ts +140 -140
  446. package/dist/sdk/query/calendar.d.ts +144 -144
  447. package/dist/sdk/query/complete-list.d.ts +53 -53
  448. package/dist/sdk/query/context.d.ts +395 -395
  449. package/dist/sdk/query/duplicate-candidates.d.ts +1 -1
  450. package/dist/sdk/query/get.d.ts +77 -77
  451. package/dist/sdk/query/history.d.ts +72 -72
  452. package/dist/sdk/query/item-filter-options.d.ts +79 -79
  453. package/dist/sdk/query/list-filter-shared.d.ts +1 -1
  454. package/dist/sdk/query/list.d.ts +188 -188
  455. package/dist/sdk/query/multi-value-filters.d.ts +4 -4
  456. package/dist/sdk/query/next-ready-budget.d.ts +14 -14
  457. package/dist/sdk/query/next.d.ts +137 -137
  458. package/dist/sdk/query/projection-contracts.d.ts +8 -8
  459. package/dist/sdk/query/search/corpus.d.ts +8 -8
  460. package/dist/sdk/query/search/filters.d.ts +5 -5
  461. package/dist/sdk/query/search/input.d.ts +4 -4
  462. package/dist/sdk/query/search/response.d.ts +8 -8
  463. package/dist/sdk/query/search/semantic.d.ts +106 -106
  464. package/dist/sdk/query/search/types.d.ts +85 -85
  465. package/dist/sdk/query/search-contracts.d.ts +65 -65
  466. package/dist/sdk/query/search-pagination.d.ts +19 -19
  467. package/dist/sdk/query/search-rendering.d.ts +25 -25
  468. package/dist/sdk/query/search.d.ts +46 -46
  469. package/dist/sdk/read-output/continuation.d.ts +8 -8
  470. package/dist/sdk/read-output/continuation.js +1 -1
  471. package/dist/sdk/read-output/extension.d.ts +7 -0
  472. package/dist/sdk/read-output/extension.js +2 -0
  473. package/dist/sdk/read-output/options.d.ts +6 -4
  474. package/dist/sdk/read-output/options.js +1 -1
  475. package/dist/sdk/read-output/provenance.d.ts +8 -8
  476. package/dist/sdk/read-output-budget.d.ts +10 -10
  477. package/dist/sdk/read-output-contracts.d.ts +192 -186
  478. package/dist/sdk/read-output-contracts.js +1 -1
  479. package/dist/sdk/read-output-rows.d.ts +6 -6
  480. package/dist/sdk/read-output-session.d.ts +50 -50
  481. package/dist/sdk/relationship-analytics.d.ts +78 -78
  482. package/dist/sdk/relationship-context.d.ts +81 -81
  483. package/dist/sdk/relationship-history.d.ts +109 -109
  484. package/dist/sdk/relationship-kinds/contract.d.ts +34 -34
  485. package/dist/sdk/relationship-migration.d.ts +26 -26
  486. package/dist/sdk/relationships.d.ts +78 -78
  487. package/dist/sdk/reproducibility/process.d.ts +3 -3
  488. package/dist/sdk/runtime/context.d.ts +11 -11
  489. package/dist/sdk/runtime-action-aliases.d.ts +2 -2
  490. package/dist/sdk/runtime-extended-actions.d.ts +8 -8
  491. package/dist/sdk/runtime-input.d.ts +3 -3
  492. package/dist/sdk/runtime-public-contracts.d.ts +78 -78
  493. package/dist/sdk/runtime.d.ts +305 -305
  494. package/dist/sdk/runtime.js +1 -1
  495. package/dist/sdk/scheduling-shortcuts.d.ts +32 -32
  496. package/dist/sdk/schema-migration.d.ts +86 -86
  497. package/dist/sdk/schema.d.ts +355 -355
  498. package/dist/sdk/similarity-scoring.d.ts +10 -10
  499. package/dist/sdk/similarity.d.ts +113 -113
  500. package/dist/sdk/stats.d.ts +108 -108
  501. package/dist/sdk/structured-mutations.d.ts +16 -16
  502. package/dist/sdk/structured-mutations.js +1 -1
  503. package/dist/sdk/telemetry.d.ts +53 -53
  504. package/dist/sdk/templates.d.ts +39 -39
  505. package/dist/sdk/test/batch.d.ts +85 -85
  506. package/dist/sdk/test/execution-receipts.d.ts +3 -3
  507. package/dist/sdk/test/execution.d.ts +277 -277
  508. package/dist/sdk/test/execution.js +2 -2
  509. package/dist/sdk/test/json-path.d.ts +2 -2
  510. package/dist/sdk/test/linked-command-detection.d.ts +10 -10
  511. package/dist/sdk/test/measurements.d.ts +11 -11
  512. package/dist/sdk/test/parsers.d.ts +1 -1
  513. package/dist/sdk/test/parsers.js +1 -1
  514. package/dist/sdk/test/runs.d.ts +52 -52
  515. package/dist/sdk/test/trust.d.ts +12 -12
  516. package/dist/sdk/test/update.d.ts +31 -31
  517. package/dist/sdk/testing.d.ts +319 -319
  518. package/dist/sdk/traceability/source-traceability.d.ts +65 -65
  519. package/dist/sdk/workspace-contracts.d.ts +37 -37
  520. package/dist/sdk/workspace-memory.d.ts +60 -60
  521. package/dist/sdk/workspace-recipe.d.ts +9 -9
  522. package/dist/sdk/workspace-snapshot.d.ts +97 -97
  523. package/dist/sdk/workspace-transaction-gc.d.ts +32 -32
  524. package/dist/sdk/workspace-transaction.d.ts +47 -47
  525. package/dist/sdk/workspace.d.ts +6 -6
  526. package/dist/types.d.ts +978 -978
  527. package/dist/types.js +1 -1
  528. package/docs/BUILD_AND_RELEASE_ACCEPTANCE.md +5 -2
  529. package/docs/DEFECT_RECURRENCE.md +12 -0
  530. package/docs/EXTENSIONS.md +2 -2
  531. package/docs/MERGE_SAFETY.md +27 -1
  532. package/docs/RECURRENCE_RECOVERY_CONTRACTS.md +17 -4
  533. package/docs/RELATIONSHIP_GRAPH.md +26 -0
  534. package/docs/RELEASING.md +6 -0
  535. package/docs/SDK.md +43 -18
  536. package/docs/SDK_CONSUMER_RECEIPTS.md +67 -0
  537. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +6 -3
  538. package/marketplace.json +1 -1
  539. package/node_modules/@opentelemetry/core/build/esm/version.d.ts +1 -1
  540. package/node_modules/@opentelemetry/core/build/esm/version.js +1 -1
  541. package/node_modules/@opentelemetry/core/build/esnext/version.d.ts +1 -1
  542. package/node_modules/@opentelemetry/core/build/esnext/version.js +1 -1
  543. package/node_modules/@opentelemetry/core/build/src/version.d.ts +1 -1
  544. package/node_modules/@opentelemetry/core/build/src/version.js +1 -1
  545. package/node_modules/@opentelemetry/core/package.json +2 -2
  546. package/node_modules/@opentelemetry/resources/build/esm/version.d.ts +1 -1
  547. package/node_modules/@opentelemetry/resources/build/esm/version.js +1 -1
  548. package/node_modules/@opentelemetry/resources/build/esnext/version.d.ts +1 -1
  549. package/node_modules/@opentelemetry/resources/build/esnext/version.js +1 -1
  550. package/node_modules/@opentelemetry/resources/build/src/version.d.ts +1 -1
  551. package/node_modules/@opentelemetry/resources/build/src/version.js +1 -1
  552. package/node_modules/@opentelemetry/resources/package.json +3 -3
  553. package/node_modules/@opentelemetry/sdk-trace/build/esm/StackContextManager.d.ts +57 -0
  554. package/node_modules/@opentelemetry/sdk-trace/build/esm/StackContextManager.js +105 -0
  555. package/node_modules/@opentelemetry/sdk-trace/build/esm/index.d.ts +1 -0
  556. package/node_modules/@opentelemetry/sdk-trace/build/esm/index.js +1 -0
  557. package/node_modules/@opentelemetry/sdk-trace/build/esm/version.d.ts +1 -1
  558. package/node_modules/@opentelemetry/sdk-trace/build/esm/version.js +1 -1
  559. package/node_modules/@opentelemetry/sdk-trace/build/esnext/StackContextManager.d.ts +57 -0
  560. package/node_modules/@opentelemetry/sdk-trace/build/esnext/StackContextManager.js +105 -0
  561. package/node_modules/@opentelemetry/sdk-trace/build/esnext/index.d.ts +1 -0
  562. package/node_modules/@opentelemetry/sdk-trace/build/esnext/index.js +1 -0
  563. package/node_modules/@opentelemetry/sdk-trace/build/esnext/version.d.ts +1 -1
  564. package/node_modules/@opentelemetry/sdk-trace/build/esnext/version.js +1 -1
  565. package/node_modules/@opentelemetry/sdk-trace/build/src/StackContextManager.d.ts +57 -0
  566. package/node_modules/@opentelemetry/sdk-trace/build/src/StackContextManager.js +109 -0
  567. package/node_modules/@opentelemetry/sdk-trace/build/src/index.d.ts +1 -0
  568. package/node_modules/@opentelemetry/sdk-trace/build/src/index.js +3 -1
  569. package/node_modules/@opentelemetry/sdk-trace/build/src/version.d.ts +1 -1
  570. package/node_modules/@opentelemetry/sdk-trace/build/src/version.js +1 -1
  571. package/node_modules/@opentelemetry/sdk-trace/package.json +5 -5
  572. package/node_modules/@opentelemetry/sdk-trace-base/build/esm/version.d.ts +1 -1
  573. package/node_modules/@opentelemetry/sdk-trace-base/build/esm/version.js +1 -1
  574. package/node_modules/@opentelemetry/sdk-trace-base/build/esnext/version.d.ts +1 -1
  575. package/node_modules/@opentelemetry/sdk-trace-base/build/esnext/version.js +1 -1
  576. package/node_modules/@opentelemetry/sdk-trace-base/build/src/version.d.ts +1 -1
  577. package/node_modules/@opentelemetry/sdk-trace-base/build/src/version.js +1 -1
  578. package/node_modules/@opentelemetry/sdk-trace-base/package.json +7 -7
  579. package/node_modules/@sentry/core/build/cjs/browser.js +3 -0
  580. package/node_modules/@sentry/core/build/cjs/fetch.js +10 -9
  581. package/node_modules/@sentry/core/build/cjs/index.js +3 -0
  582. package/node_modules/@sentry/core/build/cjs/integrations/http/add-outgoing-request-breadcrumb.js +2 -1
  583. package/node_modules/@sentry/core/build/cjs/integrations/http/get-outgoing-span-data.js +3 -2
  584. package/node_modules/@sentry/core/build/cjs/integrations/http/server-subscription.js +7 -3
  585. package/node_modules/@sentry/core/build/cjs/integrations/requestdata.js +23 -9
  586. package/node_modules/@sentry/core/build/cjs/server.js +3 -0
  587. package/node_modules/@sentry/core/build/cjs/utils/data-collection/filterCollectedUrl.js +24 -0
  588. package/node_modules/@sentry/core/build/cjs/utils/data-collection/filterKeyValueData.js +17 -23
  589. package/node_modules/@sentry/core/build/cjs/utils/data-collection/filterQueryParams.js +8 -15
  590. package/node_modules/@sentry/core/build/cjs/utils/data-collection/filterUrlQuery.js +20 -0
  591. package/node_modules/@sentry/core/build/cjs/utils/url.js +4 -3
  592. package/node_modules/@sentry/core/build/cjs/utils/version.js +1 -1
  593. package/node_modules/@sentry/core/build/esm/browser.js +1 -0
  594. package/node_modules/@sentry/core/build/esm/fetch.js +10 -9
  595. package/node_modules/@sentry/core/build/esm/index.js +1 -0
  596. package/node_modules/@sentry/core/build/esm/integrations/http/add-outgoing-request-breadcrumb.js +2 -1
  597. package/node_modules/@sentry/core/build/esm/integrations/http/get-outgoing-span-data.js +3 -2
  598. package/node_modules/@sentry/core/build/esm/integrations/http/server-subscription.js +7 -3
  599. package/node_modules/@sentry/core/build/esm/integrations/requestdata.js +23 -9
  600. package/node_modules/@sentry/core/build/esm/package.json +1 -1
  601. package/node_modules/@sentry/core/build/esm/server.js +1 -0
  602. package/node_modules/@sentry/core/build/esm/utils/data-collection/filterCollectedUrl.js +21 -0
  603. package/node_modules/@sentry/core/build/esm/utils/data-collection/filterKeyValueData.js +18 -25
  604. package/node_modules/@sentry/core/build/esm/utils/data-collection/filterQueryParams.js +9 -16
  605. package/node_modules/@sentry/core/build/esm/utils/data-collection/filterUrlQuery.js +18 -0
  606. package/node_modules/@sentry/core/build/esm/utils/url.js +4 -3
  607. package/node_modules/@sentry/core/build/esm/utils/version.js +1 -1
  608. package/node_modules/@sentry/core/build/types/shared-exports.d.ts +1 -0
  609. package/node_modules/@sentry/core/build/types/utils/data-collection/filterCollectedUrl.d.ts +21 -0
  610. package/node_modules/@sentry/core/build/types/utils/data-collection/filterKeyValueData.d.ts +1 -0
  611. package/node_modules/@sentry/core/build/types/utils/data-collection/filterQueryParams.d.ts +2 -3
  612. package/node_modules/@sentry/core/build/types/utils/data-collection/filterUrlQuery.d.ts +13 -0
  613. package/node_modules/@sentry/core/build/types/utils/url.d.ts +4 -1
  614. package/node_modules/@sentry/core/build/types-ts3.8/shared-exports.d.ts +1 -0
  615. package/node_modules/@sentry/core/build/types-ts3.8/utils/data-collection/filterCollectedUrl.d.ts +21 -0
  616. package/node_modules/@sentry/core/build/types-ts3.8/utils/data-collection/filterKeyValueData.d.ts +1 -0
  617. package/node_modules/@sentry/core/build/types-ts3.8/utils/data-collection/filterQueryParams.d.ts +2 -3
  618. package/node_modules/@sentry/core/build/types-ts3.8/utils/data-collection/filterUrlQuery.d.ts +13 -0
  619. package/node_modules/@sentry/core/build/types-ts3.8/utils/url.d.ts +4 -1
  620. package/node_modules/@sentry/core/package.json +3 -2
  621. package/node_modules/@sentry/node/build/cjs/integrations/tracing/vercelai/instrumentation.js +3 -0
  622. package/node_modules/@sentry/node/build/esm/integrations/tracing/vercelai/instrumentation.js +3 -0
  623. package/node_modules/@sentry/node/build/esm/package.json +1 -1
  624. package/node_modules/@sentry/node/package.json +7 -6
  625. package/node_modules/@sentry/node-core/build/cjs/integrations/anr/index.js +1 -1
  626. package/node_modules/@sentry/node-core/build/cjs/integrations/http/httpServerSpansIntegration.js +6 -3
  627. package/node_modules/@sentry/node-core/build/cjs/integrations/local-variables/local-variables-async.js +1 -1
  628. package/node_modules/@sentry/node-core/build/cjs/integrations/node-fetch/undici-instrumentation.js +2 -2
  629. package/node_modules/@sentry/node-core/build/cjs/light/client.js +7 -0
  630. package/node_modules/@sentry/node-core/build/cjs/sdk/client.js +7 -0
  631. package/node_modules/@sentry/node-core/build/cjs/utils/outgoingFetchRequest.js +1 -1
  632. package/node_modules/@sentry/node-core/build/esm/integrations/anr/index.js +1 -1
  633. package/node_modules/@sentry/node-core/build/esm/integrations/anr/worker-script.js +2 -2
  634. package/node_modules/@sentry/node-core/build/esm/integrations/http/httpServerSpansIntegration.js +7 -4
  635. package/node_modules/@sentry/node-core/build/esm/integrations/local-variables/local-variables-async.js +1 -1
  636. package/node_modules/@sentry/node-core/build/esm/integrations/local-variables/worker-script.js +1 -1
  637. package/node_modules/@sentry/node-core/build/esm/integrations/node-fetch/undici-instrumentation.js +3 -3
  638. package/node_modules/@sentry/node-core/build/esm/light/client.js +8 -1
  639. package/node_modules/@sentry/node-core/build/esm/package.json +1 -1
  640. package/node_modules/@sentry/node-core/build/esm/sdk/client.js +8 -1
  641. package/node_modules/@sentry/node-core/build/esm/utils/outgoingFetchRequest.js +2 -2
  642. package/node_modules/@sentry/node-core/build/types/light/client.d.ts +1 -0
  643. package/node_modules/@sentry/node-core/build/types/sdk/client.d.ts +1 -0
  644. package/node_modules/@sentry/node-core/build/types-ts3.8/light/client.d.ts +1 -0
  645. package/node_modules/@sentry/node-core/build/types-ts3.8/sdk/client.d.ts +1 -0
  646. package/node_modules/@sentry/node-core/package.json +5 -4
  647. package/node_modules/@sentry/opentelemetry/build/cjs/{asyncContextStrategy-BJ5buq_A.js → asyncContextStrategy-BR-l9zjD.js} +8 -6
  648. package/node_modules/@sentry/opentelemetry/build/cjs/index.browser.js +1 -1
  649. package/node_modules/@sentry/opentelemetry/build/cjs/index.js +1 -1
  650. package/node_modules/@sentry/opentelemetry/build/esm/{asyncContextStrategy-Bx5F5tCX.js → asyncContextStrategy-BQfM_LMv.js} +9 -7
  651. package/node_modules/@sentry/opentelemetry/build/esm/index.browser.js +1 -1
  652. package/node_modules/@sentry/opentelemetry/build/esm/index.js +2 -2
  653. package/node_modules/@sentry/opentelemetry/build/esm/package.json +1 -1
  654. package/node_modules/@sentry/opentelemetry/package.json +4 -3
  655. package/node_modules/@sentry/server-utils/build/cjs/tracing-channel.js +1 -0
  656. package/node_modules/@sentry/server-utils/build/esm/package.json +1 -1
  657. package/node_modules/@sentry/server-utils/build/esm/tracing-channel.js +1 -0
  658. package/node_modules/@sentry/server-utils/build/types/tracing-channel.d.ts +3 -1
  659. package/node_modules/@sentry/server-utils/build/types-ts3.8/tracing-channel.d.ts +3 -1
  660. package/node_modules/@sentry/server-utils/package.json +4 -3
  661. package/node_modules/cjs-module-lexer/README.md +8 -3
  662. package/node_modules/cjs-module-lexer/dist/lexer.js +1 -1
  663. package/node_modules/cjs-module-lexer/dist/lexer.mjs +2 -2
  664. package/node_modules/cjs-module-lexer/lexer.js +48 -9
  665. package/node_modules/cjs-module-lexer/package.json +3 -2
  666. package/node_modules/es-module-lexer/dist/lexer.asm.js +2 -2
  667. package/node_modules/es-module-lexer/dist/lexer.cjs +1 -1
  668. package/node_modules/es-module-lexer/dist/lexer.js +2 -2
  669. package/node_modules/es-module-lexer/dist/lexer.minimal.asm.js +2 -2
  670. package/node_modules/es-module-lexer/dist/lexer.minimal.cjs +1 -1
  671. package/node_modules/es-module-lexer/dist/lexer.minimal.js +2 -2
  672. package/node_modules/es-module-lexer/package.json +1 -1
  673. package/node_modules/import-in-the-middle/CHANGELOG.md +7 -0
  674. package/node_modules/import-in-the-middle/lib/get-esm-exports.mjs +7 -0
  675. package/node_modules/import-in-the-middle/package.json +1 -1
  676. package/package.json +2 -2
  677. package/packages/pm-beads/extensions/beads/runtime.ts +2 -2
  678. package/packages/pm-beads/package.json +1 -1
  679. package/packages/pm-calendar/package.json +1 -1
  680. package/packages/pm-command-kit/package.json +1 -1
  681. package/packages/pm-digital-twin/package.json +1 -1
  682. package/packages/pm-governance-audit/package.json +1 -1
  683. package/packages/pm-guide-shell/package.json +1 -1
  684. package/packages/pm-kanban/package.json +1 -1
  685. package/packages/pm-lifecycle-hooks/package.json +1 -1
  686. package/packages/pm-linked-test-adapters/package.json +1 -1
  687. package/packages/pm-search-advanced/package.json +1 -1
  688. package/packages/pm-templates/package.json +1 -1
  689. package/packages/pm-todos/package.json +1 -1
  690. package/packages/pm-vcs/package.json +1 -1
  691. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  692. package/plugins/pm-claude/package.json +1 -1
  693. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  694. package/plugins/pm-codex/package.json +1 -1
  695. package/plugins/pm-codex/plugin.json +1 -1
  696. package/runtime-dependencies.json +1 -1
  697. package/scripts/finalize-build.mjs +37 -0
  698. package/dist/cli-bundle/chunks/chunk-6PZPUJW3.js +0 -234
  699. package/dist/cli-bundle/chunks/chunk-ILQEZ4Y6.js +0 -2
  700. package/dist/cli-bundle/chunks/chunk-JRRXWH5B.js +0 -20
  701. package/dist/cli-bundle/chunks/chunk-LH5QDBMN.js +0 -2
  702. package/dist/cli-bundle/chunks/chunk-M5NDSW6E.js +0 -30
  703. package/dist/cli-bundle/focused-chunks/chunk-AXBO53EQ.js +0 -2
  704. package/dist/cli-bundle/focused-chunks/chunk-FXRWJEQ5.js +0 -3
  705. package/dist/cli-bundle/focused-chunks/chunk-IKJFAU32.js +0 -8
  706. package/dist/cli-bundle/focused-chunks/chunk-PPH5N26M.js +0 -2
  707. package/dist/cli-bundle/focused-chunks/chunk-RZVNGUT7.js +0 -26
  708. package/dist/cli-bundle/focused-chunks/chunk-YDJT33JU.js +0 -2
@@ -9,276 +9,276 @@ export declare const PM_EPISODE_SCHEMA: "pm.agent-episode/v1";
9
9
  export type RecordedStateObject = Readonly<Record<string, unknown>>;
10
10
  /** One declared read and its guaranteed token ceiling. */
11
11
  export interface ObservationReadDeclaration {
12
- /** Public SDK or CLI command name used to collect the read. */
13
- command: string;
14
- /** Maximum tokens this read may consume. */
15
- budget_tokens: number;
12
+ /** Public SDK or CLI command name used to collect the read. */
13
+ command: string;
14
+ /** Maximum tokens this read may consume. */
15
+ budget_tokens: number;
16
16
  }
17
17
  /** Emitted-byte calibration for a representative observation corpus. */
18
18
  export interface ObservationCalibration {
19
- /** Stable measurement basis; serialized payload bytes are authoritative. */
20
- basis: "emitted_bytes";
21
- /** Historical emitted-byte measurements used to calibrate expectations. */
22
- samples: readonly number[];
23
- /** Expected serialized payload size before an observation is served. */
24
- expected_emitted_bytes: number;
25
- /** Accepted drift around the expected emitted-byte measurement. */
26
- tolerance_bytes: number;
19
+ /** Stable measurement basis; serialized payload bytes are authoritative. */
20
+ basis: "emitted_bytes";
21
+ /** Historical emitted-byte measurements used to calibrate expectations. */
22
+ samples: readonly number[];
23
+ /** Expected serialized payload size before an observation is served. */
24
+ expected_emitted_bytes: number;
25
+ /** Accepted drift around the expected emitted-byte measurement. */
26
+ tolerance_bytes: number;
27
27
  }
28
28
  /** Declares whether observation cost varies with corpus size. */
29
29
  export type ObservationCorpusDependence = {
30
- readonly kind: "independent";
30
+ readonly kind: "independent";
31
31
  } | {
32
- readonly kind: "bounded";
33
- readonly dimension: string;
34
- readonly maximum: number;
32
+ readonly kind: "bounded";
33
+ readonly dimension: string;
34
+ readonly maximum: number;
35
35
  };
36
36
  /** One ordered disclosure tier in an observation degradation ladder. */
37
37
  export interface ObservationTier {
38
- /** Stable tier identity included in every observation receipt. */
39
- id: string;
40
- /** Maximum tokens this tier is permitted to emit. */
41
- max_tokens: number;
42
- /** Dot-separated recorded-state fields disclosed by the tier. */
43
- fields: readonly string[];
38
+ /** Stable tier identity included in every observation receipt. */
39
+ id: string;
40
+ /** Maximum tokens this tier is permitted to emit. */
41
+ max_tokens: number;
42
+ /** Dot-separated recorded-state fields disclosed by the tier. */
43
+ fields: readonly string[];
44
44
  }
45
45
  /** Portable declaration for a bounded, calibrated observation. */
46
46
  export interface ObservationContract {
47
- /** Versioned schema identity. */
48
- schema: typeof PM_OBSERVATION_SCHEMA;
49
- /** Stable contract identity. */
50
- id: string;
51
- /** Positive contract revision. */
52
- version: number;
53
- /** Reads whose ceilings form the guaranteed collection cost. */
54
- reads: readonly ObservationReadDeclaration[];
55
- /** Emitted-byte calibration visible before collection starts. */
56
- calibration: ObservationCalibration;
57
- /** Explicit corpus-size dependence of the cost model. */
58
- corpus_dependence: ObservationCorpusDependence;
59
- /** Ordered richest-to-smallest degradation ladder. */
60
- tiers: readonly ObservationTier[];
47
+ /** Versioned schema identity. */
48
+ schema: typeof PM_OBSERVATION_SCHEMA;
49
+ /** Stable contract identity. */
50
+ id: string;
51
+ /** Positive contract revision. */
52
+ version: number;
53
+ /** Reads whose ceilings form the guaranteed collection cost. */
54
+ reads: readonly ObservationReadDeclaration[];
55
+ /** Emitted-byte calibration visible before collection starts. */
56
+ calibration: ObservationCalibration;
57
+ /** Explicit corpus-size dependence of the cost model. */
58
+ corpus_dependence: ObservationCorpusDependence;
59
+ /** Ordered richest-to-smallest degradation ladder. */
60
+ tiers: readonly ObservationTier[];
61
61
  }
62
62
  /** Pre-call observation-cost description available to schedulers. */
63
63
  export interface ObservationCostDescription {
64
- /** Stable observation identity. */
65
- contract_id: string;
66
- /** Observation revision. */
67
- contract_version: number;
68
- /** Sum of all declared collection ceilings. */
69
- guaranteed_ceiling_tokens: number;
70
- /** Calibrated expected serialized payload size. */
71
- expected_emitted_bytes: number;
72
- /** Conservative token estimate derived from emitted bytes. */
73
- expected_tokens: number;
74
- /** Accepted emitted-byte calibration drift. */
75
- tolerance_bytes: number;
76
- /** Stable calibration basis. */
77
- calibration_basis: "emitted_bytes";
78
- /** Declared corpus-size dependence. */
79
- corpus_dependence: ObservationCorpusDependence;
64
+ /** Stable observation identity. */
65
+ contract_id: string;
66
+ /** Observation revision. */
67
+ contract_version: number;
68
+ /** Sum of all declared collection ceilings. */
69
+ guaranteed_ceiling_tokens: number;
70
+ /** Calibrated expected serialized payload size. */
71
+ expected_emitted_bytes: number;
72
+ /** Conservative token estimate derived from emitted bytes. */
73
+ expected_tokens: number;
74
+ /** Accepted emitted-byte calibration drift. */
75
+ tolerance_bytes: number;
76
+ /** Stable calibration basis. */
77
+ calibration_basis: "emitted_bytes";
78
+ /** Declared corpus-size dependence. */
79
+ corpus_dependence: ObservationCorpusDependence;
80
80
  }
81
81
  /** Audit receipt emitted for every served or refused observation. */
82
82
  export interface ObservationReceipt {
83
- /** Stable observation identity. */
84
- contract_id: string;
85
- /** Observation revision. */
86
- contract_version: number;
87
- /** Tier whose payload was returned, or null after truthful refusal. */
88
- served_tier: string | null;
89
- /** Whether a smaller tier was attempted or served. */
90
- degraded: boolean;
91
- /** Tier identities evaluated in deterministic order. */
92
- attempted_tiers: readonly string[];
93
- /** Exact serialized payload bytes, or null when nothing was served. */
94
- emitted_bytes: number | null;
95
- /** Conservative token estimate, or null when nothing was served. */
96
- estimated_tokens: number | null;
97
- /** Stable measurement basis. */
98
- calibration_basis: "emitted_bytes";
83
+ /** Stable observation identity. */
84
+ contract_id: string;
85
+ /** Observation revision. */
86
+ contract_version: number;
87
+ /** Tier whose payload was returned, or null after truthful refusal. */
88
+ served_tier: string | null;
89
+ /** Whether a smaller tier was attempted or served. */
90
+ degraded: boolean;
91
+ /** Tier identities evaluated in deterministic order. */
92
+ attempted_tiers: readonly string[];
93
+ /** Exact serialized payload bytes, or null when nothing was served. */
94
+ emitted_bytes: number | null;
95
+ /** Conservative token estimate, or null when nothing was served. */
96
+ estimated_tokens: number | null;
97
+ /** Stable measurement basis. */
98
+ calibration_basis: "emitted_bytes";
99
99
  }
100
100
  /** Successful bounded observation with its explicit receipt. */
101
101
  export interface ServedObservation<T> {
102
- /** Discriminator for a payload-bearing response. */
103
- status: "served";
104
- /** Payload produced by the declared tier. */
105
- payload: T;
106
- /** Cost and degradation evidence. */
107
- receipt: ObservationReceipt;
102
+ /** Discriminator for a payload-bearing response. */
103
+ status: "served";
104
+ /** Payload produced by the declared tier. */
105
+ payload: T;
106
+ /** Cost and degradation evidence. */
107
+ receipt: ObservationReceipt;
108
108
  }
109
109
  /** Refusal returned when no declared tier can fit the caller's ceiling. */
110
110
  export interface RefusedObservation {
111
- /** Discriminator for a payload-free refusal. */
112
- status: "refused";
113
- /** Stable reason callers can route without parsing prose. */
114
- reason: "no_declared_tier_fits_budget";
115
- /** Cost and degradation evidence. */
116
- receipt: ObservationReceipt;
111
+ /** Discriminator for a payload-free refusal. */
112
+ status: "refused";
113
+ /** Stable reason callers can route without parsing prose. */
114
+ reason: "no_declared_tier_fits_budget";
115
+ /** Cost and degradation evidence. */
116
+ receipt: ObservationReceipt;
117
117
  }
118
118
  /** Complete outcome of attempting one declared observation. */
119
119
  export type ObservationResult<T> = ServedObservation<T> | RefusedObservation;
120
120
  /** Caller-imposed ceiling for one observation response. */
121
121
  export interface ObservationRequest {
122
- /** Maximum response tokens accepted by the caller. */
123
- budget_tokens: number;
122
+ /** Maximum response tokens accepted by the caller. */
123
+ budget_tokens: number;
124
124
  }
125
125
  /** Predicate supported by the versioned total-verdict interpreter. */
126
126
  export type VerdictPredicate = {
127
- readonly id: string;
128
- readonly kind: "field_equals";
129
- readonly path: string;
130
- readonly expected: unknown;
127
+ readonly id: string;
128
+ readonly kind: "field_equals";
129
+ readonly path: string;
130
+ readonly expected: unknown;
131
131
  } | {
132
- readonly id: string;
133
- readonly kind: "field_present";
134
- readonly path: string;
132
+ readonly id: string;
133
+ readonly kind: "field_present";
134
+ readonly path: string;
135
135
  } | {
136
- readonly id: string;
137
- readonly kind: "field_absent";
138
- readonly path: string;
136
+ readonly id: string;
137
+ readonly kind: "field_absent";
138
+ readonly path: string;
139
139
  };
140
140
  /** Declarative composition applied to predicate outcomes. */
141
141
  export interface VerdictComposition {
142
- /** Whether every or at least one referenced predicate must satisfy. */
143
- operator: "all" | "any";
144
- /** Ordered predicate identities evaluated by the total verdict. */
145
- predicate_ids: readonly string[];
142
+ /** Whether every or at least one referenced predicate must satisfy. */
143
+ operator: "all" | "any";
144
+ /** Ordered predicate identities evaluated by the total verdict. */
145
+ predicate_ids: readonly string[];
146
146
  }
147
147
  /** Portable named and versioned total-verdict declaration. */
148
148
  export interface VerdictContract {
149
- /** Versioned schema identity. */
150
- schema: typeof PM_VERDICT_SCHEMA;
151
- /** Stable contract identity. */
152
- id: string;
153
- /** Positive contract revision. */
154
- version: number;
155
- /** Predicates evaluated exclusively over recorded state. */
156
- predicates: readonly VerdictPredicate[];
157
- /** Explicit deterministic predicate composition. */
158
- composition: VerdictComposition;
149
+ /** Versioned schema identity. */
150
+ schema: typeof PM_VERDICT_SCHEMA;
151
+ /** Stable contract identity. */
152
+ id: string;
153
+ /** Positive contract revision. */
154
+ version: number;
155
+ /** Predicates evaluated exclusively over recorded state. */
156
+ predicates: readonly VerdictPredicate[];
157
+ /** Explicit deterministic predicate composition. */
158
+ composition: VerdictComposition;
159
159
  }
160
160
  /** Recorded state and stable snapshot identity supplied by an adapter. */
161
161
  export interface WorkspaceRecordedState {
162
- /** Stable identity of the exact state being evaluated. */
163
- snapshot_id: string;
164
- /** Recorded, JSON-compatible project state. */
165
- state: RecordedStateObject;
162
+ /** Stable identity of the exact state being evaluated. */
163
+ snapshot_id: string;
164
+ /** Recorded, JSON-compatible project state. */
165
+ state: RecordedStateObject;
166
166
  }
167
167
  /** Per-predicate evidence in a deterministic total verdict. */
168
168
  export interface PredicateVerdict {
169
- /** Declared predicate identity. */
170
- id: string;
171
- /** Whether the predicate is satisfied by recorded state. */
172
- outcome: "satisfied" | "violated";
173
- /** Snapshot-qualified JSON pointer to the inspected field. */
174
- evidence_pointer: string;
175
- /** Hash of the observed value without duplicating potentially private data. */
176
- evidence_digest: string;
169
+ /** Declared predicate identity. */
170
+ id: string;
171
+ /** Whether the predicate is satisfied by recorded state. */
172
+ outcome: "satisfied" | "violated";
173
+ /** Snapshot-qualified JSON pointer to the inspected field. */
174
+ evidence_pointer: string;
175
+ /** Hash of the observed value without duplicating potentially private data. */
176
+ evidence_digest: string;
177
177
  }
178
178
  /** Total, reproducible result produced by a verdict contract. */
179
179
  export interface VerdictResult {
180
- /** Stable verdict identity. */
181
- contract_id: string;
182
- /** Verdict revision. */
183
- contract_version: number;
184
- /** Exact recorded-state snapshot evaluated. */
185
- snapshot_id: string;
186
- /** Total outcome, including an explicit empty-contract state. */
187
- outcome: "satisfied" | "violated" | "not_applicable";
188
- /** Satisfied fraction, or null when no predicates are declared. */
189
- score: number | null;
190
- /** Explicitly separates evaluation from reward or learning signals. */
191
- policy: "verdict_only_no_reward";
192
- /** Stable explanation for a not-applicable verdict. */
193
- reason?: "no_predicates_declared";
194
- /** Ordered predicate evidence. */
195
- predicates: readonly PredicateVerdict[];
180
+ /** Stable verdict identity. */
181
+ contract_id: string;
182
+ /** Verdict revision. */
183
+ contract_version: number;
184
+ /** Exact recorded-state snapshot evaluated. */
185
+ snapshot_id: string;
186
+ /** Total outcome, including an explicit empty-contract state. */
187
+ outcome: "satisfied" | "violated" | "not_applicable";
188
+ /** Satisfied fraction, or null when no predicates are declared. */
189
+ score: number | null;
190
+ /** Explicitly separates evaluation from reward or learning signals. */
191
+ policy: "verdict_only_no_reward";
192
+ /** Stable explanation for a not-applicable verdict. */
193
+ reason?: "no_predicates_declared";
194
+ /** Ordered predicate evidence. */
195
+ predicates: readonly PredicateVerdict[];
196
196
  }
197
197
  /** Hard limits enforced within one isolated episode. */
198
198
  export interface EpisodeLimits {
199
- /** Maximum ordinary project-management actions. */
200
- max_actions: number;
201
- /** Maximum observations, including the close-time grading read. */
202
- max_observations: number;
203
- /** Per-observation response ceiling. */
204
- max_tokens_per_observation: number;
199
+ /** Maximum ordinary project-management actions. */
200
+ max_actions: number;
201
+ /** Maximum observations, including the close-time grading read. */
202
+ max_observations: number;
203
+ /** Per-observation response ceiling. */
204
+ max_tokens_per_observation: number;
205
205
  }
206
206
  /** Portable specification shared by evaluation and training harnesses. */
207
207
  export interface EpisodeSpecification {
208
- /** Versioned schema identity. */
209
- schema: typeof PM_EPISODE_SCHEMA;
210
- /** Stable episode identity and session provenance key. */
211
- id: string;
212
- /** Positive episode revision. */
213
- version: number;
214
- /** Consumer intent without coupling the runtime to a training framework. */
215
- mode: "benchmark" | "evaluation" | "training" | "scale_transfer";
216
- /** Deterministic workspace construction recipe. */
217
- recipe: WorkspaceRecipe;
218
- /** Canonical pm items that define the task set. */
219
- task_item_ids: readonly string[];
220
- /** State fields that observations may disclose. */
221
- observable_fields: readonly string[];
222
- /** Grading-only fields that must never enter observations. */
223
- withheld_fields: readonly string[];
224
- /** Bounded observation declaration. */
225
- observation: ObservationContract;
226
- /** Recorded-state verdict declaration. */
227
- verdict: VerdictContract;
228
- /** Hard action and observation limits. */
229
- limits: EpisodeLimits;
208
+ /** Versioned schema identity. */
209
+ schema: typeof PM_EPISODE_SCHEMA;
210
+ /** Stable episode identity and session provenance key. */
211
+ id: string;
212
+ /** Positive episode revision. */
213
+ version: number;
214
+ /** Consumer intent without coupling the runtime to a training framework. */
215
+ mode: "benchmark" | "evaluation" | "training" | "scale_transfer";
216
+ /** Deterministic workspace construction recipe. */
217
+ recipe: WorkspaceRecipe;
218
+ /** Canonical pm items that define the task set. */
219
+ task_item_ids: readonly string[];
220
+ /** State fields that observations may disclose. */
221
+ observable_fields: readonly string[];
222
+ /** Grading-only fields that must never enter observations. */
223
+ withheld_fields: readonly string[];
224
+ /** Bounded observation declaration. */
225
+ observation: ObservationContract;
226
+ /** Recorded-state verdict declaration. */
227
+ verdict: VerdictContract;
228
+ /** Hard action and observation limits. */
229
+ limits: EpisodeLimits;
230
230
  }
231
231
  /** Reset receipt returned by an episode adapter. */
232
232
  export interface EpisodeResetReceipt {
233
- /** Adapter-defined isolated workspace identity. */
234
- workspace_id: string;
235
- /** Stable state identity after reset. */
236
- state_id: string;
233
+ /** Adapter-defined isolated workspace identity. */
234
+ workspace_id: string;
235
+ /** Stable state identity after reset. */
236
+ state_id: string;
237
237
  }
238
238
  /** Action receipt returned by an episode adapter. */
239
239
  export interface EpisodeActionReceipt<TOutput> {
240
- /** Stable state identity after the action. */
241
- state_id: string;
242
- /** Adapter-defined ordinary command result. */
243
- output: TOutput;
240
+ /** Stable state identity after the action. */
241
+ state_id: string;
242
+ /** Adapter-defined ordinary command result. */
243
+ output: TOutput;
244
244
  }
245
245
  /** Host boundary for ordinary pm SDK actions and recorded-state reads. */
246
246
  export interface EpisodeRuntimeAdapter<TAction, TOutput = unknown> {
247
- /** Construct a fresh isolated workspace using the declared recipe. */
248
- reset(recipe: WorkspaceRecipe): Promise<EpisodeResetReceipt>;
249
- /** Execute one ordinary action, normally by calling `PmClient.run`. */
250
- execute(action: TAction): Promise<EpisodeActionReceipt<TOutput>>;
251
- /** Read immutable grading state from the workspace system of record. */
252
- readRecordedState(): Promise<WorkspaceRecordedState>;
247
+ /** Construct a fresh isolated workspace using the declared recipe. */
248
+ reset(recipe: WorkspaceRecipe): Promise<EpisodeResetReceipt>;
249
+ /** Execute one ordinary action, normally by calling `PmClient.run`. */
250
+ execute(action: TAction): Promise<EpisodeActionReceipt<TOutput>>;
251
+ /** Read immutable grading state from the workspace system of record. */
252
+ readRecordedState(): Promise<WorkspaceRecordedState>;
253
253
  }
254
254
  /** One deterministic entry in a portable episode trajectory. */
255
255
  export interface EpisodeTrajectoryEntry {
256
- /** Monotonic event number within the isolated episode. */
257
- sequence: number;
258
- /** Stable event classification. */
259
- kind: "reset" | "observation" | "action" | "verdict" | "close";
260
- /** Snapshot, state, or observation tier associated with the event. */
261
- state_id: string;
256
+ /** Monotonic event number within the isolated episode. */
257
+ sequence: number;
258
+ /** Stable event classification. */
259
+ kind: "reset" | "observation" | "action" | "verdict" | "close";
260
+ /** Snapshot, state, or observation tier associated with the event. */
261
+ state_id: string;
262
262
  }
263
263
  /** Closed episode evidence without reward or framework-specific shaping. */
264
264
  export interface ClosedEpisode {
265
- /** Deterministic total verdict. */
266
- verdict: VerdictResult;
267
- /** Complete bounded trajectory. */
268
- trajectory: readonly EpisodeTrajectoryEntry[];
269
- /** Explicitly absent to prevent verdicts from becoming reward signals. */
270
- reward?: never;
265
+ /** Deterministic total verdict. */
266
+ verdict: VerdictResult;
267
+ /** Complete bounded trajectory. */
268
+ trajectory: readonly EpisodeTrajectoryEntry[];
269
+ /** Explicitly absent to prevent verdicts from becoming reward signals. */
270
+ reward?: never;
271
271
  }
272
272
  /** Isolated runtime returned for one declared agent episode. */
273
273
  export interface PmEpisodeSession<TAction, TOutput> {
274
- /** Observe recorded state through the declared disclosure ladder. */
275
- observe(): Promise<ObservationResult<RecordedStateObject>>;
276
- /** Execute one bounded ordinary project-management action. */
277
- step(action: TAction): Promise<EpisodeActionReceipt<TOutput>>;
278
- /** Evaluate the current recorded state without closing the session. */
279
- score(): Promise<VerdictResult>;
280
- /** Evaluate and close the episode, returning immutable evidence. */
281
- close(): Promise<ClosedEpisode>;
274
+ /** Observe recorded state through the declared disclosure ladder. */
275
+ observe(): Promise<ObservationResult<RecordedStateObject>>;
276
+ /** Execute one bounded ordinary project-management action. */
277
+ step(action: TAction): Promise<EpisodeActionReceipt<TOutput>>;
278
+ /** Evaluate the current recorded state without closing the session. */
279
+ score(): Promise<VerdictResult>;
280
+ /** Evaluate and close the episode, returning immutable evidence. */
281
+ close(): Promise<ClosedEpisode>;
282
282
  }
283
283
  /** Validate, clone, and freeze a portable observation declaration. */
284
284
  export declare function defineObservationContract(declaration: ObservationContract): ObservationContract;
@@ -4,60 +4,60 @@ export { PmCliError };
4
4
  export declare const HISTORY_ITEM_HASH_VERSION_3_INTRODUCED_IN = "2026.8.31";
5
5
  /** One discovered project pin that can prove the active executable is stale. */
6
6
  export interface ProjectRuntimeVersionPin {
7
- /** Representative date-version extracted from the project declaration. */
8
- version: string;
9
- /** Redaction-safe origin of the pin. */
10
- source: "package.json" | "installed-package" | "package-lock.json" | "pnpm-lock.yaml" | "yarn.lock";
11
- /** Whether the declaration selects one runtime, a minimum, or a bounded range. */
12
- constraint: "exact" | "minimum" | "range";
13
- /** Original package declaration when it conveys more than the representative version. */
14
- declaration?: string;
15
- /** Whether the declaration permits a reader that understands history item-hash epoch 3. */
16
- history_epoch_compatible?: boolean;
7
+ /** Representative date-version extracted from the project declaration. */
8
+ version: string;
9
+ /** Redaction-safe origin of the pin. */
10
+ source: "package.json" | "installed-package" | "package-lock.json" | "pnpm-lock.yaml" | "yarn.lock";
11
+ /** Whether the declaration selects one runtime, a minimum, or a bounded range. */
12
+ constraint: "exact" | "minimum" | "range";
13
+ /** Original package declaration when it conveys more than the representative version. */
14
+ declaration?: string;
15
+ /** Whether the declaration permits a reader that understands history item-hash epoch 3. */
16
+ history_epoch_compatible?: boolean;
17
17
  }
18
18
  /** Structured result returned by the read-only compatibility probe. */
19
19
  export interface ProjectRuntimeCompatibilityResult {
20
- /** Whether the invocation can write with the active runtime. */
21
- compatible: boolean;
22
- /** Active executable package version. */
23
- executing_version: string;
24
- /** Highest project pin discovered without exposing local paths. */
25
- project_version?: string;
26
- /** Origin of the highest project pin. */
27
- source?: ProjectRuntimeVersionPin["source"];
28
- /** Canonical command selected from the invocation. */
29
- command?: string;
30
- /** Whether the selected invocation can mutate project state. */
31
- mutating: boolean;
32
- /** Whether the active executable is older than the strongest project pin. */
33
- stale?: boolean;
34
- /** Whether this mutation would write a history epoch a project pin cannot read. */
35
- history_epoch_incompatible?: boolean;
36
- /** Item-hash epoch the executing runtime writes. */
37
- writer_item_hash_version?: 2 | 3;
38
- /** Project runtime declaration that cannot read the writer epoch. */
39
- incompatible_project_version?: string;
40
- /** Origin of the incompatible project runtime declaration. */
41
- incompatible_source?: ProjectRuntimeVersionPin["source"];
42
- /** Non-blocking diagnostic attached to stale read-only invocations. */
43
- warning?: ProjectRuntimeCompatibilityWarning;
44
- /** Whether the explicit one-invocation recovery override was accepted. */
45
- override_applied: boolean;
20
+ /** Whether the invocation can write with the active runtime. */
21
+ compatible: boolean;
22
+ /** Active executable package version. */
23
+ executing_version: string;
24
+ /** Highest project pin discovered without exposing local paths. */
25
+ project_version?: string;
26
+ /** Origin of the highest project pin. */
27
+ source?: ProjectRuntimeVersionPin["source"];
28
+ /** Canonical command selected from the invocation. */
29
+ command?: string;
30
+ /** Whether the selected invocation can mutate project state. */
31
+ mutating: boolean;
32
+ /** Whether the active executable is older than the strongest project pin. */
33
+ stale?: boolean;
34
+ /** Whether this mutation would write a history epoch a project pin cannot read. */
35
+ history_epoch_incompatible?: boolean;
36
+ /** Item-hash epoch the executing runtime writes. */
37
+ writer_item_hash_version?: 2 | 3;
38
+ /** Project runtime declaration that cannot read the writer epoch. */
39
+ incompatible_project_version?: string;
40
+ /** Origin of the incompatible project runtime declaration. */
41
+ incompatible_source?: ProjectRuntimeVersionPin["source"];
42
+ /** Non-blocking diagnostic attached to stale read-only invocations. */
43
+ warning?: ProjectRuntimeCompatibilityWarning;
44
+ /** Whether the explicit one-invocation recovery override was accepted. */
45
+ override_applied: boolean;
46
46
  }
47
47
  /** Structured, package-manager-neutral warning returned for a stale read. */
48
48
  export interface ProjectRuntimeCompatibilityWarning {
49
- /** Stable warning code for filtering and automation. */
50
- code: "project_runtime_stale_read";
51
- /** Active executable package version. */
52
- executing_version: string;
53
- /** Strongest newer project version pin. */
54
- project_version: string;
55
- /** Redaction-safe origin of the project pin. */
56
- source: ProjectRuntimeVersionPin["source"];
57
- /** Concise explanation of the mismatch. */
58
- message: string;
59
- /** Package-manager-neutral recovery actions. */
60
- next_steps: string[];
49
+ /** Stable warning code for filtering and automation. */
50
+ code: "project_runtime_stale_read";
51
+ /** Active executable package version. */
52
+ executing_version: string;
53
+ /** Strongest newer project version pin. */
54
+ project_version: string;
55
+ /** Redaction-safe origin of the project pin. */
56
+ source: ProjectRuntimeVersionPin["source"];
57
+ /** Concise explanation of the mismatch. */
58
+ message: string;
59
+ /** Package-manager-neutral recovery actions. */
60
+ next_steps: string[];
61
61
  }
62
62
  /** Compare pm date versions without accepting arbitrary semver-like prose. */
63
63
  export declare function comparePmDateVersions(left: string, right: string): number | null;
@@ -69,15 +69,15 @@ export declare function discoverProjectRuntimeVersionPins(projectRoot: string):
69
69
  export declare function isProjectMutatingInvocation(argv: readonly string[]): boolean;
70
70
  /** Inspect whether one invocation is compatible with the project's newest pin. */
71
71
  export declare function inspectProjectRuntimeCompatibility(options: {
72
- executingVersion: string;
73
- projectRoot: string;
74
- argv: readonly string[];
75
- allowStale?: boolean;
72
+ executingVersion: string;
73
+ projectRoot: string;
74
+ argv: readonly string[];
75
+ allowStale?: boolean;
76
76
  }): ProjectRuntimeCompatibilityResult;
77
77
  /** Refuse stale mutations with a stable SDK error and package-neutral recovery. */
78
78
  export declare function assertProjectRuntimeCompatibility(options: {
79
- executingVersion: string;
80
- projectRoot: string;
81
- argv: readonly string[];
82
- allowStale?: boolean;
79
+ executingVersion: string;
80
+ projectRoot: string;
81
+ argv: readonly string[];
82
+ allowStale?: boolean;
83
83
  }): ProjectRuntimeCompatibilityResult;
@@ -12,12 +12,12 @@ export declare const SOURCE_CONTEXT_WRITE_OVERRIDE_ENV = "PM_ALLOW_SOURCE_CONTEX
12
12
  export type SourceContextAccessMode = "read_only" | "write";
13
13
  /** Structured policy used by SDK adapters before selecting source coordinates. */
14
14
  export interface SourceContextWritePolicy {
15
- /** Declared access mode, with absent legacy context retaining write behavior. */
16
- access: SourceContextAccessMode;
17
- /** Whether the one-invocation write override was accepted. */
18
- write_override_applied: boolean;
19
- /** Whether a mutation may select inherited source coordinates. */
20
- source_writes_allowed: boolean;
15
+ /** Declared access mode, with absent legacy context retaining write behavior. */
16
+ access: SourceContextAccessMode;
17
+ /** Whether the one-invocation write override was accepted. */
18
+ write_override_applied: boolean;
19
+ /** Whether a mutation may select inherited source coordinates. */
20
+ source_writes_allowed: boolean;
21
21
  }
22
22
  /** Resolve inherited source-coordinate write policy without reading filesystem state. */
23
23
  export declare function resolveSourceContextWritePolicy(environment: Readonly<Record<string, string | undefined>>): SourceContextWritePolicy;