@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
@@ -131,265 +131,265 @@ type ReadPromise<Result, Options> = Promise<PmReadOutputResultFor<Result, Option
131
131
  * per-call runtime overrides such as `cwd`, `path`, or `noExtensions`.
132
132
  */
133
133
  export declare class PmClient {
134
- private readonly defaults;
135
- /** Create a client with workspace, author, and extension-loading defaults. */
136
- constructor(options?: PmClientOptions);
137
- /** Create a native-action client that reuses an extension host's active schema context. */
138
- static forActiveExtensionHost(options: PmClientOptions): PmClient;
139
- /** Run any native or extension-contributed action through the SDK dispatcher. */
140
- run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>;
141
- private runTyped;
142
- /** Return the same context snapshot produced by `pm context`. */
143
- context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>;
144
- /** Read every item through the scalar-only metadata cache without materializing heavy collections or bodies. */
145
- listAllItemMetadataLight(): Promise<ItemMetadata[]>;
146
- /** List items with the MCP/agent compact defaults. */
147
- list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>;
148
- /** Return every status and full item row only after fail-closed corpus certification. */
149
- listAllComplete(options?: PmCompleteListOptions): Promise<PmCompleteListResult>;
150
- /** Search items with the MCP/agent compact defaults. */
151
- search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>;
152
- /** Read one item by id. */
153
- get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>;
154
- /** Return the ranked next-work recommendation produced by `pm next`. */
155
- next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>;
156
- /** Group matching items with the same semantics as `pm aggregate`. */
157
- aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>;
158
- /** Return project tracker statistics with the same sections as `pm stats`. */
159
- stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>;
160
- /** Discover existing duplicate clusters without mutating tracker state. */
161
- duplicates<Options extends ReadOptions<DuplicatesCommandOptions> = DuplicatesCommandOptions>(options?: Options): ReadPromise<DuplicatesResult, Options>;
162
- /** List or mutate comments, including lock-scoped idempotent appends. */
163
- comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>;
164
- /** List or mutate private notes, including lock-scoped idempotent appends. */
165
- notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>;
166
- /** List or mutate durable learnings, including lock-scoped idempotent appends. */
167
- learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>;
168
- /** Add, remove, clear, or list linked project files for an item. */
169
- files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>;
170
- /** Discover and optionally attach changed files for an item. */
171
- filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>;
172
- /** Find the items that reference one or more source paths. */
173
- filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>;
174
- /** Add, remove, clear, or list linked documentation for an item. */
175
- docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>;
176
- /** Inspect item dependency relationships. */
177
- deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>;
178
- /** Run bounded workspace graph traversal, analytics, or governance-audit queries. */
179
- graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: {
180
- id?: string;
181
- target?: string;
182
- }, options?: Options): ReadPromise<GraphResult, Options>;
183
- /** Append markdown/body text to an item through the mutation pipeline. */
184
- append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>;
185
- /** Initialize a workspace with the same semantics as `pm init`. */
186
- init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>;
187
- /** Read or update project/global configuration. */
188
- config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>;
189
- /** Run the schema customization surface. */
190
- schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>;
191
- /** Author, preview, or approve workflow policies in this client's workspace. */
192
- workflowPolicy(action: WorkflowPolicyAction, name?: string, options?: WorkflowPolicyActionOptions): Promise<WorkflowPolicyActionResult>;
193
- /** List built-in, custom, and extension-provided schema types/statuses. */
194
- schemaList(): Promise<SchemaListResult>;
195
- /** Show a schema item type definition. */
196
- schemaShow(name: string): Promise<SchemaShowResult>;
197
- /** Register or replace a custom item type. */
198
- schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>;
199
- /** Remove a custom item type. */
200
- schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>;
201
- /** Register or replace a custom status. */
202
- schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>;
203
- /** Remove a custom status. */
204
- schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>;
205
- /** Register or replace a runtime custom field. */
206
- schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>;
207
- /** Remove a runtime custom field. */
208
- schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>;
209
- /** List runtime custom fields. */
210
- schemaListFields(): Promise<SchemaListFieldsResult>;
211
- /** Show one runtime custom field definition. */
212
- schemaShowField(name: string): Promise<SchemaShowFieldResult>;
213
- /** Apply a built-in type preset to the workspace schema. */
214
- schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>;
215
- /** Infer item types from the current tracker and optionally apply them. */
216
- schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>;
217
- /** Rename a custom item type and migrate every affected item atomically. */
218
- schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>;
219
- /** Rename a custom metadata field and migrate every affected item atomically. */
220
- schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>;
221
- /** Remap a custom lifecycle status and migrate every affected item atomically. */
222
- schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>;
223
- /** Show one runtime status definition. */
224
- schemaShowStatus(name: string): Promise<SchemaShowStatusResult>;
225
- /** Run the profile customization surface. */
226
- profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>;
227
- /** List available project profiles. */
228
- profileList(): Promise<ProfileListResult>;
229
- /** Show a project profile. */
230
- profileShow(name: string): Promise<ProfileShowResult>;
231
- /** Apply a project profile. */
232
- profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>;
233
- /** Lint a project profile. */
234
- profileLint(name: string): Promise<ProfileLintResult>;
235
- /** Run project validation checks with counts-only diagnostics. */
236
- validate<Options extends ReadOptions<ValidateCommandOptions> & {
237
- counts: true;
238
- }>(options: Options): ReadPromise<ValidateCountsResult, Options>;
239
- /** Run project validation checks with complete diagnostic arrays. */
240
- validate<Options extends ReadOptions<ValidateCommandOptions> & {
241
- counts?: false;
242
- } = ValidateCommandOptions & {
243
- counts?: false;
244
- }>(options?: Options): ReadPromise<ValidateResult, Options>;
245
- /** Run project validation checks with a dynamically selected projection. */
246
- validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>;
247
- /** Run project health checks. */
248
- health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>;
249
- /** Run tracker cache/runtime garbage collection. */
250
- gc(options?: GcCommandOptions): Promise<GcResult>;
251
- /** Declare, inspect, or evaluate a project assurance contract. */
252
- assurance(input: AssuranceActionInput): Promise<AssuranceActionResult>;
253
- /** Redact sensitive values while preserving an audited, verified history chain. */
254
- historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>;
255
- /** Repair and re-anchor one drifted history stream. */
256
- historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>;
257
- /** Scan and repair every drifted history stream in one resilient pass. */
258
- historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>;
259
- /** Export or verify a detached history proof without activating workspace extensions. */
260
- historyAttest(options?: HistoryAttestCommandOptions): ReturnType<typeof runHistoryAttest>;
261
- /** Compact one history stream into a verified checkpoint and retained tail. */
262
- historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>;
263
- /** Compact an explicit or policy-selected set of history streams. */
264
- historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>;
265
- /** Disposition immutable unknown-author events through append-only audit history. */
266
- historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<UnknownAuthorAcknowledgmentResult>;
267
- /** Run any typed plan workflow primitive through the shared CLI/MCP engine. */
268
- plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>;
269
- /** Create a durable plan with optional ordered seed steps. */
270
- planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>;
271
- /** Read a plan using brief, standard, deep, or field-projected output. */
272
- planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>;
273
- /** Append an ordered step to a plan. */
274
- planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
275
- /** Update any mutable property of an existing plan step. */
276
- planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
277
- /** Complete a plan step and record its evidence. */
278
- planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>;
279
- /** Block a plan step with an actionable reason. */
280
- planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
281
- /** Reorder a plan step while preserving stable step identifiers. */
282
- planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>;
283
- /** Remove a step from a plan and compact the remaining order. */
284
- planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>;
285
- /** Link a tracker item to a plan step. */
286
- planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
287
- /** Remove tracker-item links from a plan step. */
288
- planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
289
- /** Append a durable plan decision. */
290
- planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
291
- /** Append a durable plan discovery. */
292
- planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
293
- /** Append a plan validation expectation or result. */
294
- planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
295
- /** Update the bounded resume context for a stateless future agent. */
296
- planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
297
- /** Approve a plan for execution. */
298
- planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>;
299
- /** Materialize selected plan steps into governed tracker items. */
300
- planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
301
- /** Create an item using the same mutation path as `pm create`. Options are contract-typed (pm-x29o): unknown keys and non-scalar values fail `tsc`; runtime-schema custom fields go through the repeatable `field` option, and {@link PmClient.run} stays the wide escape hatch. */
302
- create(options?: PmCreateActionOptions): Promise<CreateResult>;
303
- /** Update an item using the same mutation path as `pm update`. Options are contract-typed (pm-x29o): unknown keys and non-scalar values fail `tsc`; runtime-schema custom fields go through the repeatable `field` option, and {@link PmClient.run} stays the wide escape hatch. */
304
- update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>;
305
- /** Reopen terminal work as a recurrence through the canonical update path. */
306
- reopen(id: string, reason: string, options?: ReopenCommandOptions): Promise<ReopenResult>;
307
- /** Close an item using the same mutation path as `pm close`. Options are contract-typed (pm-x29o); the close reason is the positional parameter, so the option bag omits `reason`/`text`. */
308
- close(id: string, reason: string, options: PmClientCloseActionOptions & {
309
- releaseAssignment: true;
310
- }): Promise<CloseTaskResult>;
311
- /** Return the base receipt when composition is disabled or omitted. */
312
- close(id: string, reason: string, options?: PmClientCloseActionOptions & {
313
- releaseAssignment?: false;
314
- }): Promise<CloseResult>;
315
- /** Preserve both receipt shapes when the composition flag is dynamic. */
316
- close(id: string, reason: string, options?: PmClientCloseActionOptions & {
317
- releaseAssignment?: boolean;
318
- }): Promise<CloseResult | CloseTaskResult>;
319
- /** Claim an item using the same mutation path as `pm claim`. */
320
- claim(id: string, options: PmClientFullMutationOptions & {
321
- start: true;
322
- }): Promise<StartTaskResult>;
323
- /** Return the base receipt when composition is disabled or omitted. */
324
- claim(id: string, options?: PmClientFullMutationOptions & {
325
- start?: false;
326
- }): Promise<ClaimResult>;
327
- /** Preserve both receipt shapes when the composition flag is dynamic. */
328
- claim(id: string, options?: PmClientFullMutationOptions & {
329
- start?: boolean;
330
- }): Promise<ClaimResult | StartTaskResult>;
331
- /** Atomically claim the highest-ranked available item using the public next-work filters. */
332
- claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>;
333
- /** Release an item's active claim using the same mutation path as `pm release`. */
334
- release(id: string, options: PmClientFullMutationOptions & {
335
- pause: true;
336
- }): Promise<PauseTaskResult>;
337
- /** Return the base receipt when composition is disabled or omitted. */
338
- release(id: string, options?: PmClientFullMutationOptions & {
339
- pause?: false;
340
- }): Promise<ReleaseResult>;
341
- /** Preserve both receipt shapes when the composition flag is dynamic. */
342
- release(id: string, options?: PmClientFullMutationOptions & {
343
- pause?: boolean;
344
- }): Promise<ReleaseResult | PauseTaskResult>;
345
- /** Copy an item using the same mutation path as `pm copy`. */
346
- copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>;
347
- /** Delete an item using the same mutation path as `pm delete`. */
348
- delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>;
349
- /** Restore an item to a history version or timestamp using `pm restore`. */
350
- restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>;
351
- /** Set, clear, or read workspace focus using the same path as `pm focus`. */
352
- focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>;
353
- /** Claim an item and transition it to the workspace in-progress status. */
354
- startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>;
355
- /** Move an item back to the workspace open status and release the claim. */
356
- pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>;
357
- /** Close an item and release its active assignment. */
358
- closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>;
359
- /** Run the extension lifecycle surface with the same result shape as `pm extension`. */
360
- extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
361
- /** List project or global extensions without constructing command-line argv. */
362
- extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
363
- /** Enable an installed extension using the same action as `pm extension activate`. */
364
- extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
365
- /** Disable an installed extension using the same action as `pm extension deactivate`. */
366
- extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
367
- /** Run the package lifecycle surface with package vocabulary preserved. */
368
- package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
369
- /** List project or global packages through the package lifecycle primitive. */
370
- packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>;
371
- /** Install a package or extension source using the same action as `pm package install`. */
372
- packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
373
- /** Uninstall a package or extension using the same action as `pm package uninstall`. */
374
- packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
375
- /** Read package lifecycle diagnostics using the same action as `pm package doctor`. */
376
- packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>;
377
- /** Inspect managed package state using the same action as `pm package manage`. */
378
- packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
379
- /** Describe installed package surfaces using the same action as `pm package describe`. */
380
- packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
381
- /** Reload installed package extensions using the same action as `pm package reload`. */
382
- packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>;
383
- /** Read bundled package catalog metadata using the same action as `pm package catalog`. */
384
- packageCatalog<Options extends ReadOptions<PackageCommandOptions> = PackageCommandOptions>(options?: Options): ReadPromise<PackageCommandResult, Options>;
385
- /** Enable an installed package using the same action as `pm package activate`. */
386
- packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
387
- /** Disable an installed package using the same action as `pm package deactivate`. */
388
- packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
389
- /** Plan or apply active package migrations with durable workspace receipts. */
390
- packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>;
391
- /** Upgrade the pm CLI and/or managed packages through the public SDK dispatcher. */
392
- upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>;
134
+ private readonly defaults;
135
+ /** Create a client with workspace, author, and extension-loading defaults. */
136
+ constructor(options?: PmClientOptions);
137
+ /** Create a native-action client that reuses an extension host's active schema context. */
138
+ static forActiveExtensionHost(options: PmClientOptions): PmClient;
139
+ /** Run any native or extension-contributed action through the SDK dispatcher. */
140
+ run(action: PmActionName, args?: PmClientRunArgs): Promise<unknown>;
141
+ private runTyped;
142
+ /** Return the same context snapshot produced by `pm context`. */
143
+ context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options): ReadPromise<ContextResult, Options>;
144
+ /** Read every item through the scalar-only metadata cache without materializing heavy collections or bodies. */
145
+ listAllItemMetadataLight(): Promise<ItemMetadata[]>;
146
+ /** List items with the MCP/agent compact defaults. */
147
+ list<Options extends ReadOptions<ListOptions> = ListOptions>(options?: Options): ReadPromise<ListResult, Options>;
148
+ /** Return every status and full item row only after fail-closed corpus certification. */
149
+ listAllComplete(options?: PmCompleteListOptions): Promise<PmCompleteListResult>;
150
+ /** Search items with the MCP/agent compact defaults. */
151
+ search<Options extends ReadOptions<SearchOptions> = SearchOptions>(query: string, options?: Options): ReadPromise<SearchResult, Options>;
152
+ /** Read one item by id. */
153
+ get<Options extends ReadOptions<GetOptions> = GetOptions>(id: string, options?: Options): ReadPromise<GetResult, Options>;
154
+ /** Return the ranked next-work recommendation produced by `pm next`. */
155
+ next<Options extends ReadOptions<NextOptions> = NextOptions>(options?: Options): ReadPromise<NextResult, Options>;
156
+ /** Group matching items with the same semantics as `pm aggregate`. */
157
+ aggregate<Options extends ReadOptions<AggregateOptions> = AggregateOptions>(options?: Options): ReadPromise<AggregateResult, Options>;
158
+ /** Return project tracker statistics with the same sections as `pm stats`. */
159
+ stats<Options extends ReadOptions<StatsCommandOptions> = StatsCommandOptions>(options?: Options): ReadPromise<StatsResult, Options>;
160
+ /** Discover existing duplicate clusters without mutating tracker state. */
161
+ duplicates<Options extends ReadOptions<DuplicatesCommandOptions> = DuplicatesCommandOptions>(options?: Options): ReadPromise<DuplicatesResult, Options>;
162
+ /** List or mutate comments, including lock-scoped idempotent appends. */
163
+ comments<Options extends ReadOptions<CommentsCommandOptions> = CommentsCommandOptions>(id: string, options?: Options): ReadPromise<CommentsResult, Options>;
164
+ /** List or mutate private notes, including lock-scoped idempotent appends. */
165
+ notes<Options extends ReadOptions<NotesCommandOptions> = NotesCommandOptions>(id: string, options?: Options): ReadPromise<NotesResult, Options>;
166
+ /** List or mutate durable learnings, including lock-scoped idempotent appends. */
167
+ learnings(id: string, options?: LearningsCommandOptions): Promise<LearningsResult>;
168
+ /** Add, remove, clear, or list linked project files for an item. */
169
+ files<Options extends ReadOptions<FilesCommandOptions> = FilesCommandOptions>(id: string, options?: Options): ReadPromise<FilesResult, Options>;
170
+ /** Discover and optionally attach changed files for an item. */
171
+ filesDiscover(id: string, options?: FilesDiscoverOptions): Promise<FilesDiscoverResult>;
172
+ /** Find the items that reference one or more source paths. */
173
+ filesLookup(options: FilesLookupOptions): Promise<FilesLookupResult>;
174
+ /** Add, remove, clear, or list linked documentation for an item. */
175
+ docs<Options extends ReadOptions<DocsCommandOptions> = DocsCommandOptions>(id: string, options?: Options): ReadPromise<DocsResult, Options>;
176
+ /** Inspect item dependency relationships. */
177
+ deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options): ReadPromise<DepsResult, Options>;
178
+ /** Run bounded workspace graph traversal, analytics, or governance-audit queries. */
179
+ graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: {
180
+ id?: string;
181
+ target?: string;
182
+ }, options?: Options): ReadPromise<GraphResult, Options>;
183
+ /** Append markdown/body text to an item through the mutation pipeline. */
184
+ append(id: string, body: string, options?: PmClientFullMutationOptions): Promise<AppendResult>;
185
+ /** Initialize a workspace with the same semantics as `pm init`. */
186
+ init(prefix?: string, options?: InitCommandOptions): Promise<InitResult>;
187
+ /** Read or update project/global configuration. */
188
+ config(scope: string, configAction: string, key?: string, value?: string, options?: ConfigCommandOptions): Promise<ConfigResult>;
189
+ /** Run the schema customization surface. */
190
+ schema(subcommand: SchemaSubcommand, options?: PmActionOptions): Promise<SchemaResult>;
191
+ /** Author, preview, or approve workflow policies in this client's workspace. */
192
+ workflowPolicy(action: WorkflowPolicyAction, name?: string, options?: WorkflowPolicyActionOptions): Promise<WorkflowPolicyActionResult>;
193
+ /** List built-in, custom, and extension-provided schema types/statuses. */
194
+ schemaList(): Promise<SchemaListResult>;
195
+ /** Show a schema item type definition. */
196
+ schemaShow(name: string): Promise<SchemaShowResult>;
197
+ /** Register or replace a custom item type. */
198
+ schemaAddType(name: string, options?: SchemaAddTypeCommandOptions): Promise<SchemaAddTypeResult>;
199
+ /** Remove a custom item type. */
200
+ schemaRemoveType(name: string, options?: SchemaRemoveTypeCommandOptions): Promise<SchemaRemoveTypeResult>;
201
+ /** Register or replace a custom status. */
202
+ schemaAddStatus(name: string, options?: SchemaAddStatusCommandOptions): Promise<SchemaAddStatusResult>;
203
+ /** Remove a custom status. */
204
+ schemaRemoveStatus(name: string, options?: SchemaRemoveStatusCommandOptions): Promise<SchemaRemoveStatusResult>;
205
+ /** Register or replace a runtime custom field. */
206
+ schemaAddField(name: string, options?: SchemaAddFieldCommandOptions): Promise<SchemaAddFieldResult>;
207
+ /** Remove a runtime custom field. */
208
+ schemaRemoveField(name: string, options?: SchemaRemoveFieldCommandOptions): Promise<SchemaRemoveFieldResult>;
209
+ /** List runtime custom fields. */
210
+ schemaListFields(): Promise<SchemaListFieldsResult>;
211
+ /** Show one runtime custom field definition. */
212
+ schemaShowField(name: string): Promise<SchemaShowFieldResult>;
213
+ /** Apply a built-in type preset to the workspace schema. */
214
+ schemaApplyPreset(typePreset: string, options?: SchemaApplyPresetCommandOptions): Promise<SchemaApplyPresetResult>;
215
+ /** Infer item types from the current tracker and optionally apply them. */
216
+ schemaInferTypes(options?: SchemaAddTypeInferCommandOptions): Promise<SchemaAddTypeInferResult>;
217
+ /** Rename a custom item type and migrate every affected item atomically. */
218
+ schemaRenameType(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>;
219
+ /** Rename a custom metadata field and migrate every affected item atomically. */
220
+ schemaRenameField(from: string, to: string, options: RunSchemaEvolutionMigrationOptions, type?: string): Promise<SchemaEvolutionMigrationResult>;
221
+ /** Remap a custom lifecycle status and migrate every affected item atomically. */
222
+ schemaRemapStatus(from: string, to: string, options: RunSchemaEvolutionMigrationOptions): Promise<SchemaEvolutionMigrationResult>;
223
+ /** Show one runtime status definition. */
224
+ schemaShowStatus(name: string): Promise<SchemaShowStatusResult>;
225
+ /** Run the profile customization surface. */
226
+ profile(subcommand: ProfileSubcommand, options?: PmActionOptions): Promise<ProfileResult>;
227
+ /** List available project profiles. */
228
+ profileList(): Promise<ProfileListResult>;
229
+ /** Show a project profile. */
230
+ profileShow(name: string): Promise<ProfileShowResult>;
231
+ /** Apply a project profile. */
232
+ profileApply(name: string, options?: ProfileApplyCommandOptions): Promise<ProfileApplyResult>;
233
+ /** Lint a project profile. */
234
+ profileLint(name: string): Promise<ProfileLintResult>;
235
+ /** Run project validation checks with counts-only diagnostics. */
236
+ validate<Options extends ReadOptions<ValidateCommandOptions> & {
237
+ counts: true;
238
+ }>(options: Options): ReadPromise<ValidateCountsResult, Options>;
239
+ /** Run project validation checks with complete diagnostic arrays. */
240
+ validate<Options extends ReadOptions<ValidateCommandOptions> & {
241
+ counts?: false;
242
+ } = ValidateCommandOptions & {
243
+ counts?: false;
244
+ }>(options?: Options): ReadPromise<ValidateResult, Options>;
245
+ /** Run project validation checks with a dynamically selected projection. */
246
+ validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options): ReadPromise<ValidateResult | ValidateCountsResult, Options>;
247
+ /** Run project health checks. */
248
+ health<Options extends ReadOptions<RunHealthOptions> = RunHealthOptions>(options?: Options): ReadPromise<HealthResult, Options>;
249
+ /** Run tracker cache/runtime garbage collection. */
250
+ gc(options?: GcCommandOptions): Promise<GcResult>;
251
+ /** Declare, inspect, or evaluate a project assurance contract. */
252
+ assurance(input: AssuranceActionInput): Promise<AssuranceActionResult>;
253
+ /** Redact sensitive values while preserving an audited, verified history chain. */
254
+ historyRedact(id: string, options: HistoryRedactCommandOptions): Promise<HistoryRedactResult>;
255
+ /** Repair and re-anchor one drifted history stream. */
256
+ historyRepair(id: string, options?: HistoryRepairCommandOptions): Promise<HistoryRepairResult>;
257
+ /** Scan and repair every drifted history stream in one resilient pass. */
258
+ historyRepairAll(options?: HistoryRepairCommandOptions): Promise<HistoryRepairAllResult>;
259
+ /** Export or verify a detached history proof without activating workspace extensions. */
260
+ historyAttest(options?: HistoryAttestCommandOptions): ReturnType<typeof runHistoryAttest>;
261
+ /** Compact one history stream into a verified checkpoint and retained tail. */
262
+ historyCompact(id: string, options?: HistoryCompactCommandOptions): Promise<HistoryCompactResult>;
263
+ /** Compact an explicit or policy-selected set of history streams. */
264
+ historyCompactBulk(options: HistoryCompactBulkCommandOptions): Promise<HistoryCompactBulkResult>;
265
+ /** Disposition immutable unknown-author events through append-only audit history. */
266
+ historyAuthorAcknowledge(options: AcknowledgeUnknownAuthorEventsOptions): Promise<UnknownAuthorAcknowledgmentResult>;
267
+ /** Run any typed plan workflow primitive through the shared CLI/MCP engine. */
268
+ plan(subcommand: PlanSubcommand, id?: string, options?: PlanCommandOptions, stepRef?: string, reorderTo?: number): Promise<PlanCommandResult>;
269
+ /** Create a durable plan with optional ordered seed steps. */
270
+ planCreate(options: PlanCommandOptions): Promise<PlanCommandResult>;
271
+ /** Read a plan using brief, standard, deep, or field-projected output. */
272
+ planShow(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>;
273
+ /** Append an ordered step to a plan. */
274
+ planAddStep(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
275
+ /** Update any mutable property of an existing plan step. */
276
+ planUpdateStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
277
+ /** Complete a plan step and record its evidence. */
278
+ planCompleteStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>;
279
+ /** Block a plan step with an actionable reason. */
280
+ planBlockStep(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
281
+ /** Reorder a plan step while preserving stable step identifiers. */
282
+ planReorderStep(id: string, stepRef: string, reorderTo: number, options?: PlanCommandOptions): Promise<PlanCommandResult>;
283
+ /** Remove a step from a plan and compact the remaining order. */
284
+ planRemoveStep(id: string, stepRef: string, options?: PlanCommandOptions): Promise<PlanCommandResult>;
285
+ /** Link a tracker item to a plan step. */
286
+ planLink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
287
+ /** Remove tracker-item links from a plan step. */
288
+ planUnlink(id: string, stepRef: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
289
+ /** Append a durable plan decision. */
290
+ planDecision(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
291
+ /** Append a durable plan discovery. */
292
+ planDiscovery(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
293
+ /** Append a plan validation expectation or result. */
294
+ planValidation(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
295
+ /** Update the bounded resume context for a stateless future agent. */
296
+ planResume(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
297
+ /** Approve a plan for execution. */
298
+ planApprove(id: string, options?: PlanCommandOptions): Promise<PlanCommandResult>;
299
+ /** Materialize selected plan steps into governed tracker items. */
300
+ planMaterialize(id: string, options: PlanCommandOptions): Promise<PlanCommandResult>;
301
+ /** Create an item using the same mutation path as `pm create`. Options are contract-typed (pm-x29o): unknown keys and non-scalar values fail `tsc`; runtime-schema custom fields go through the repeatable `field` option, and {@link PmClient.run} stays the wide escape hatch. */
302
+ create(options?: PmCreateActionOptions): Promise<CreateResult>;
303
+ /** Update an item using the same mutation path as `pm update`. Options are contract-typed (pm-x29o): unknown keys and non-scalar values fail `tsc`; runtime-schema custom fields go through the repeatable `field` option, and {@link PmClient.run} stays the wide escape hatch. */
304
+ update(id: string, options?: PmUpdateActionOptions): Promise<UpdateResult>;
305
+ /** Reopen terminal work as a recurrence through the canonical update path. */
306
+ reopen(id: string, reason: string, options?: ReopenCommandOptions): Promise<ReopenResult>;
307
+ /** Close an item using the same mutation path as `pm close`. Options are contract-typed (pm-x29o); the close reason is the positional parameter, so the option bag omits `reason`/`text`. */
308
+ close(id: string, reason: string, options: PmClientCloseActionOptions & {
309
+ releaseAssignment: true;
310
+ }): Promise<CloseTaskResult>;
311
+ /** Return the base receipt when composition is disabled or omitted. */
312
+ close(id: string, reason: string, options?: PmClientCloseActionOptions & {
313
+ releaseAssignment?: false;
314
+ }): Promise<CloseResult>;
315
+ /** Preserve both receipt shapes when the composition flag is dynamic. */
316
+ close(id: string, reason: string, options?: PmClientCloseActionOptions & {
317
+ releaseAssignment?: boolean;
318
+ }): Promise<CloseResult | CloseTaskResult>;
319
+ /** Claim an item using the same mutation path as `pm claim`. */
320
+ claim(id: string, options: PmClientFullMutationOptions & {
321
+ start: true;
322
+ }): Promise<StartTaskResult>;
323
+ /** Return the base receipt when composition is disabled or omitted. */
324
+ claim(id: string, options?: PmClientFullMutationOptions & {
325
+ start?: false;
326
+ }): Promise<ClaimResult>;
327
+ /** Preserve both receipt shapes when the composition flag is dynamic. */
328
+ claim(id: string, options?: PmClientFullMutationOptions & {
329
+ start?: boolean;
330
+ }): Promise<ClaimResult | StartTaskResult>;
331
+ /** Atomically claim the highest-ranked available item using the public next-work filters. */
332
+ claimNext(options?: ClaimNextOptions): Promise<ClaimNextResult>;
333
+ /** Release an item's active claim using the same mutation path as `pm release`. */
334
+ release(id: string, options: PmClientFullMutationOptions & {
335
+ pause: true;
336
+ }): Promise<PauseTaskResult>;
337
+ /** Return the base receipt when composition is disabled or omitted. */
338
+ release(id: string, options?: PmClientFullMutationOptions & {
339
+ pause?: false;
340
+ }): Promise<ReleaseResult>;
341
+ /** Preserve both receipt shapes when the composition flag is dynamic. */
342
+ release(id: string, options?: PmClientFullMutationOptions & {
343
+ pause?: boolean;
344
+ }): Promise<ReleaseResult | PauseTaskResult>;
345
+ /** Copy an item using the same mutation path as `pm copy`. */
346
+ copy(id: string, options?: PmClientFullMutationOptions): Promise<CopyResult>;
347
+ /** Delete an item using the same mutation path as `pm delete`. */
348
+ delete(id: string, options?: PmClientFullMutationOptions): Promise<DeleteResult>;
349
+ /** Restore an item to a history version or timestamp using `pm restore`. */
350
+ restore(id: string, target: string, options?: PmClientFullMutationOptions): Promise<RestoreResult>;
351
+ /** Set, clear, or read workspace focus using the same path as `pm focus`. */
352
+ focus(id?: string, options?: PmClientFullMutationOptions): Promise<FocusResult>;
353
+ /** Claim an item and transition it to the workspace in-progress status. */
354
+ startTask(id: string, options?: PmClientFullMutationOptions): Promise<StartTaskResult>;
355
+ /** Move an item back to the workspace open status and release the claim. */
356
+ pauseTask(id: string, options?: PmClientFullMutationOptions): Promise<PauseTaskResult>;
357
+ /** Close an item and release its active assignment. */
358
+ closeTask(id: string, reason: string, options?: PmClientFullMutationOptions): Promise<CloseTaskResult>;
359
+ /** Run the extension lifecycle surface with the same result shape as `pm extension`. */
360
+ extension(target?: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
361
+ /** List project or global extensions without constructing command-line argv. */
362
+ extensionList(options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
363
+ /** Enable an installed extension using the same action as `pm extension activate`. */
364
+ extensionActivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
365
+ /** Disable an installed extension using the same action as `pm extension deactivate`. */
366
+ extensionDeactivate(target: string, options?: ExtensionCommandOptions): Promise<ExtensionCommandResult>;
367
+ /** Run the package lifecycle surface with package vocabulary preserved. */
368
+ package(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
369
+ /** List project or global packages through the package lifecycle primitive. */
370
+ packageList(options?: PackageCommandOptions): Promise<PackageCommandResult>;
371
+ /** Install a package or extension source using the same action as `pm package install`. */
372
+ packageInstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
373
+ /** Uninstall a package or extension using the same action as `pm package uninstall`. */
374
+ packageUninstall(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
375
+ /** Read package lifecycle diagnostics using the same action as `pm package doctor`. */
376
+ packageDoctor(options?: PackageCommandOptions): Promise<PackageCommandResult>;
377
+ /** Inspect managed package state using the same action as `pm package manage`. */
378
+ packageManage(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
379
+ /** Describe installed package surfaces using the same action as `pm package describe`. */
380
+ packageDescribe(target?: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
381
+ /** Reload installed package extensions using the same action as `pm package reload`. */
382
+ packageReload(options?: PackageCommandOptions): Promise<PackageCommandResult>;
383
+ /** Read bundled package catalog metadata using the same action as `pm package catalog`. */
384
+ packageCatalog<Options extends ReadOptions<PackageCommandOptions> = PackageCommandOptions>(options?: Options): ReadPromise<PackageCommandResult, Options>;
385
+ /** Enable an installed package using the same action as `pm package activate`. */
386
+ packageActivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
387
+ /** Disable an installed package using the same action as `pm package deactivate`. */
388
+ packageDeactivate(target: string, options?: PackageCommandOptions): Promise<PackageCommandResult>;
389
+ /** Plan or apply active package migrations with durable workspace receipts. */
390
+ packageMigrate(options?: PackageCommandOptions): Promise<PackageCommandResult>;
391
+ /** Upgrade the pm CLI and/or managed packages through the public SDK dispatcher. */
392
+ upgrade(target?: string, options?: UpgradeCommandOptions): Promise<UpgradeResult>;
393
393
  }
394
394
  /** Return the same context snapshot produced by `pm context` without constructing a reusable client. */
395
395
  export declare function context<Options extends ReadOptions<ContextOptions> = ContextOptions>(options?: Options, clientOptions?: PmClientOptions): ReadPromise<ContextResult, Options>;
@@ -427,8 +427,8 @@ export declare function docs<Options extends ReadOptions<DocsCommandOptions> = D
427
427
  export declare function deps<Options extends ReadOptions<DepsCommandOptions> = DepsCommandOptions>(id: string, options?: Options, clientOptions?: PmClientOptions): ReadPromise<DepsResult, Options>;
428
428
  /** Run bounded workspace graph queries without constructing a reusable client. */
429
429
  export declare function graph<Options extends ReadOptions<GraphCommandOptions> = GraphCommandOptions>(subcommand: GraphSubcommand, ids?: {
430
- id?: string;
431
- target?: string;
430
+ id?: string;
431
+ target?: string;
432
432
  }, options?: Options, clientOptions?: PmClientOptions): ReadPromise<GraphResult, Options>;
433
433
  /** Append markdown/body text to an item without constructing a reusable client. */
434
434
  export declare function append(id: string, body: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<AppendResult>;
@@ -482,13 +482,13 @@ export declare function profileApply(name: string, options?: ProfileApplyCommand
482
482
  export declare function profileLint(name: string, clientOptions?: PmClientOptions): Promise<ProfileLintResult>;
483
483
  /** Validate a tracker without constructing a reusable client using counts-only diagnostics. */
484
484
  export declare function validate<Options extends ReadOptions<ValidateCommandOptions> & {
485
- counts: true;
485
+ counts: true;
486
486
  }>(options: Options, clientOptions?: PmClientOptions): ReadPromise<ValidateCountsResult, Options>;
487
487
  /** Validate a tracker without constructing a reusable client using complete diagnostics. */
488
488
  export declare function validate<Options extends ReadOptions<ValidateCommandOptions> & {
489
- counts?: false;
489
+ counts?: false;
490
490
  } = ValidateCommandOptions & {
491
- counts?: false;
491
+ counts?: false;
492
492
  }>(options?: Options, clientOptions?: PmClientOptions): ReadPromise<ValidateResult, Options>;
493
493
  /** Validate a tracker without constructing a reusable client with a dynamic projection. */
494
494
  export declare function validate<Options extends ReadOptions<ValidateCommandOptions>>(options: Options, clientOptions?: PmClientOptions): ReadPromise<ValidateResult | ValidateCountsResult, Options>;
@@ -514,41 +514,41 @@ export declare function update(id: string, options?: PmUpdateActionOptions, clie
514
514
  export declare function reopen(id: string, reason: string, options?: ReopenCommandOptions, clientOptions?: PmClientOptions): Promise<ReopenResult>;
515
515
  /** Close an item without constructing a reusable client. */
516
516
  export declare function close(id: string, reason: string, options: PmClientCloseActionOptions & {
517
- releaseAssignment: true;
517
+ releaseAssignment: true;
518
518
  }, clientOptions?: PmClientOptions): Promise<CloseTaskResult>;
519
519
  /** Return the base receipt when composition is disabled or omitted. */
520
520
  export declare function close(id: string, reason: string, options?: PmClientCloseActionOptions & {
521
- releaseAssignment?: false;
521
+ releaseAssignment?: false;
522
522
  }, clientOptions?: PmClientOptions): Promise<CloseResult>;
523
523
  /** Preserve both receipt shapes when the composition flag is dynamic. */
524
524
  export declare function close(id: string, reason: string, options?: PmClientCloseActionOptions & {
525
- releaseAssignment?: boolean;
525
+ releaseAssignment?: boolean;
526
526
  }, clientOptions?: PmClientOptions): Promise<CloseResult | CloseTaskResult>;
527
527
  /** Claim an item without constructing a reusable client. */
528
528
  export declare function claim(id: string, options: PmClientFullMutationOptions & {
529
- start: true;
529
+ start: true;
530
530
  }, clientOptions?: PmClientOptions): Promise<StartTaskResult>;
531
531
  /** Return the base receipt when composition is disabled or omitted. */
532
532
  export declare function claim(id: string, options?: PmClientFullMutationOptions & {
533
- start?: false;
533
+ start?: false;
534
534
  }, clientOptions?: PmClientOptions): Promise<ClaimResult>;
535
535
  /** Preserve both receipt shapes when the composition flag is dynamic. */
536
536
  export declare function claim(id: string, options?: PmClientFullMutationOptions & {
537
- start?: boolean;
537
+ start?: boolean;
538
538
  }, clientOptions?: PmClientOptions): Promise<ClaimResult | StartTaskResult>;
539
539
  /** Atomically select and claim ranked work without constructing a reusable client. */
540
540
  export declare function claimNext(options?: ClaimNextOptions, clientOptions?: PmClientOptions): Promise<ClaimNextResult>;
541
541
  /** Release an item's active claim without constructing a reusable client. */
542
542
  export declare function release(id: string, options: PmClientFullMutationOptions & {
543
- pause: true;
543
+ pause: true;
544
544
  }, clientOptions?: PmClientOptions): Promise<PauseTaskResult>;
545
545
  /** Return the base receipt when composition is disabled or omitted. */
546
546
  export declare function release(id: string, options?: PmClientFullMutationOptions & {
547
- pause?: false;
547
+ pause?: false;
548
548
  }, clientOptions?: PmClientOptions): Promise<ReleaseResult>;
549
549
  /** Preserve both receipt shapes when the composition flag is dynamic. */
550
550
  export declare function release(id: string, options?: PmClientFullMutationOptions & {
551
- pause?: boolean;
551
+ pause?: boolean;
552
552
  }, clientOptions?: PmClientOptions): Promise<ReleaseResult | PauseTaskResult>;
553
553
  /** Copy an item without constructing a reusable client. */
554
554
  export declare function copy(id: string, options?: PmClientFullMutationOptions, clientOptions?: PmClientOptions): Promise<CopyResult>;
@@ -600,12 +600,12 @@ export declare function upgrade(target?: string, options?: UpgradeCommandOptions
600
600
  export declare function getContracts(pmRootOrOptions?: string | GetContractsOptions, options?: GetContractsOptions): Promise<ContractsResult>;
601
601
  /** Options for executing direct SDK work inside the workspace extension lifecycle. */
602
602
  export interface ActiveExtensionScopeOptions {
603
- /** Workspace resolution directory; defaults to the process working directory. */
604
- cwd?: string;
605
- /** Explicit tracker root override for sandboxed or test execution. */
606
- path?: string;
607
- /** Disable workspace extension activation for this scope. */
608
- noExtensions?: boolean;
603
+ /** Workspace resolution directory; defaults to the process working directory. */
604
+ cwd?: string;
605
+ /** Explicit tracker root override for sandboxed or test execution. */
606
+ path?: string;
607
+ /** Disable workspace extension activation for this scope. */
608
+ noExtensions?: boolean;
609
609
  }
610
610
  /**
611
611
  * Execute direct SDK work while workspace extensions are loaded and published
@@ -617,14 +617,14 @@ export declare function runWithActiveExtensions<T>(options: ActiveExtensionScope
617
617
  export declare function runAction(args: PmActionInput): Promise<unknown>;
618
618
  /** One action's static SDK dispatch-resolution proof. */
619
619
  export interface SdkActionCoverageRow {
620
- /** Public action being analyzed. */
621
- action: string;
622
- /** Canonical native action selected after alias normalization. */
623
- resolved_action: string;
624
- /** Whether the canonical action has an in-process SDK handler. */
625
- covered: boolean;
626
- /** How the public action reaches its handler. */
627
- route: "native" | "alias" | "missing";
620
+ /** Public action being analyzed. */
621
+ action: string;
622
+ /** Canonical native action selected after alias normalization. */
623
+ resolved_action: string;
624
+ /** Whether the canonical action has an in-process SDK handler. */
625
+ covered: boolean;
626
+ /** How the public action reaches its handler. */
627
+ route: "native" | "alias" | "missing";
628
628
  }
629
629
  /**
630
630
  * Derive the SDK dispatch coverage matrix from the live action and alias
@@ -632,26 +632,26 @@ export interface SdkActionCoverageRow {
632
632
  */
633
633
  export declare function analyzeSdkActionCoverage(actions?: readonly string[]): SdkActionCoverageRow[];
634
634
  declare const actionRunnerTestHooks: {
635
- closeManyOptionsFromFlat: typeof closeManyOptionsFromFlat;
636
- extensionOptionsFromArgs: typeof extensionOptionsFromArgs;
637
- globalOptions: typeof globalOptions;
638
- mutationListOptions: typeof mutationListOptions;
639
- normalizeActionName: typeof normalizeActionName;
640
- normalizeCommandPath: typeof normalizeCommandPath;
641
- normalizeMcpUpdateOptions: typeof normalizeMcpUpdateOptions;
642
- normalizeMcpOptionsArrays: typeof normalizeMcpOptionsArrays;
643
- optionsWithAuthor: typeof optionsWithAuthor;
644
- readRequiredString: typeof readRequiredString;
645
- readScalarString: typeof readScalarString;
646
- readScalarStringAllowBlank: typeof readScalarStringAllowBlank;
647
- readStringArray: typeof readStringArray;
648
- updateManyOptionsFromFlat: typeof updateManyOptionsFromFlat;
649
- withAddNoteOption: typeof withAddNoteOption;
650
- withFilesDiscoveryOptions: typeof withFilesDiscoveryOptions;
651
- withMutationCompaction: typeof withMutationCompaction;
635
+ closeManyOptionsFromFlat: typeof closeManyOptionsFromFlat;
636
+ extensionOptionsFromArgs: typeof extensionOptionsFromArgs;
637
+ globalOptions: typeof globalOptions;
638
+ mutationListOptions: typeof mutationListOptions;
639
+ normalizeActionName: typeof normalizeActionName;
640
+ normalizeCommandPath: typeof normalizeCommandPath;
641
+ normalizeMcpUpdateOptions: typeof normalizeMcpUpdateOptions;
642
+ normalizeMcpOptionsArrays: typeof normalizeMcpOptionsArrays;
643
+ optionsWithAuthor: typeof optionsWithAuthor;
644
+ readRequiredString: typeof readRequiredString;
645
+ readScalarString: typeof readScalarString;
646
+ readScalarStringAllowBlank: typeof readScalarStringAllowBlank;
647
+ readStringArray: typeof readStringArray;
648
+ updateManyOptionsFromFlat: typeof updateManyOptionsFromFlat;
649
+ withAddNoteOption: typeof withAddNoteOption;
650
+ withFilesDiscoveryOptions: typeof withFilesDiscoveryOptions;
651
+ withMutationCompaction: typeof withMutationCompaction;
652
652
  };
653
653
  declare global {
654
- var __pmCliActionRunnerTestHooks: typeof actionRunnerTestHooks | undefined;
654
+ var __pmCliActionRunnerTestHooks: typeof actionRunnerTestHooks | undefined;
655
655
  }
656
656
  export type { ContractsCommandOptions, ContractsResult };
657
657
  export { readRequiredString } from "./runtime/context.js";