@unbrained/pm-cli 2026.10.11 → 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 (740) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +45 -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 +31 -31
  6. package/dist/cli/commander-usage.js +3 -3
  7. package/dist/cli/error-guidance.d.ts +158 -161
  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/help-json-payload.js +1 -1
  16. package/dist/cli/invocation-profile.d.ts +8 -8
  17. package/dist/cli/main.d.ts +166 -165
  18. package/dist/cli/main.js +4 -4
  19. package/dist/cli/migration-gates.d.ts +20 -20
  20. package/dist/cli/register-list-query.d.ts +4 -4
  21. package/dist/cli/register-mutation-options.d.ts +2 -2
  22. package/dist/cli/register-operations.d.ts +68 -63
  23. package/dist/cli/register-operations.js +1 -1
  24. package/dist/cli/register-setup.d.ts +1 -1
  25. package/dist/cli/register-structured-mutation.d.ts +3 -3
  26. package/dist/cli/register-structured-mutation.js +1 -1
  27. package/dist/cli/runtime/activation.d.ts +3 -3
  28. package/dist/cli/runtime/invocation-options.js +1 -1
  29. package/dist/cli/runtime/selection.d.ts +6 -6
  30. package/dist/cli/runtime-compatibility-boundary.d.ts +12 -12
  31. package/dist/cli-bundle/bundle-manifest.json +1 -1
  32. package/dist/cli-bundle/chunks/{chunk-K2UTE75T.js → chunk-AM2XOZKE.js} +2 -2
  33. package/dist/cli-bundle/chunks/{chunk-S445XEYT.js → chunk-APWPC4ZZ.js} +2 -2
  34. package/dist/cli-bundle/chunks/chunk-DJDRHJBP.js +234 -0
  35. package/dist/cli-bundle/chunks/{chunk-RUT3CCAG.js → chunk-DUK5DHI6.js} +2 -2
  36. package/dist/cli-bundle/chunks/chunk-HXHFKXLV.js +2 -0
  37. package/dist/cli-bundle/chunks/chunk-IFPJDJUM.js +20 -0
  38. package/dist/cli-bundle/chunks/{chunk-OBLO45UM.js → chunk-LBDWFWPK.js} +2 -2
  39. package/dist/cli-bundle/chunks/{chunk-ZWRLAOA4.js → chunk-N5EXRYCZ.js} +2 -2
  40. package/dist/cli-bundle/chunks/chunk-PSNS537F.js +30 -0
  41. package/dist/cli-bundle/chunks/{chunk-2JYTSTQP.js → chunk-RL45OYTL.js} +2 -2
  42. package/dist/cli-bundle/chunks/{chunk-ESRACL6K.js → chunk-UBTYYZIE.js} +49 -49
  43. package/dist/cli-bundle/chunks/chunk-WYZGZV2M.js +2 -0
  44. package/dist/cli-bundle/chunks/{chunk-SSY4OSJR.js → chunk-YH6H3UVE.js} +10 -10
  45. package/dist/cli-bundle/chunks/{register-list-query-T6BOR67M.js → register-list-query-BJ742QOR.js} +2 -2
  46. package/dist/cli-bundle/chunks/{register-mutation-6NXR7SAJ.js → register-mutation-GGGBRIH2.js} +3 -3
  47. package/dist/cli-bundle/chunks/register-operations-E6HXYHNM.js +2 -0
  48. package/dist/cli-bundle/chunks/{register-setup-MAYFPKBX.js → register-setup-4ZVTVEPY.js} +2 -2
  49. package/dist/cli-bundle/focused-chunks/{chunk-EIOQNLBQ.js → chunk-3LQEBXU5.js} +12 -12
  50. package/dist/cli-bundle/focused-chunks/{chunk-PLTTMQAW.js → chunk-6BTUISKV.js} +2 -2
  51. package/dist/cli-bundle/focused-chunks/chunk-73UNAJHD.js +2 -0
  52. package/dist/cli-bundle/focused-chunks/{chunk-WAOXID5J.js → chunk-DVK7VKZL.js} +2 -2
  53. package/dist/cli-bundle/focused-chunks/{chunk-SIEGIPNT.js → chunk-F5J3ATMV.js} +16 -16
  54. package/dist/cli-bundle/focused-chunks/chunk-IIKFTJVC.js +2 -0
  55. package/dist/cli-bundle/focused-chunks/chunk-IOTNG6CN.js +2 -0
  56. package/dist/cli-bundle/focused-chunks/{chunk-AU6VJGTY.js → chunk-KGFRQ34R.js} +2 -2
  57. package/dist/cli-bundle/focused-chunks/chunk-NNW5BS5L.js +3 -0
  58. package/dist/cli-bundle/focused-chunks/{chunk-KNJR2WUO.js → chunk-QMNAY25P.js} +62 -62
  59. package/dist/cli-bundle/focused-chunks/{chunk-W5AE7GKZ.js → chunk-R23T7GFZ.js} +2 -2
  60. package/dist/cli-bundle/focused-chunks/chunk-RAA7SVRA.js +8 -0
  61. package/dist/cli-bundle/focused-chunks/{chunk-52UJEHEV.js → chunk-RU6GCFN3.js} +2 -2
  62. package/dist/cli-bundle/focused-chunks/{chunk-JGFSSR3G.js → chunk-S6ITXQ5T.js} +5 -5
  63. package/dist/cli-bundle/focused-chunks/{chunk-DMSADMEU.js → chunk-SOB7X4FJ.js} +2 -2
  64. package/dist/cli-bundle/focused-chunks/chunk-UPJA45K7.js +26 -0
  65. package/dist/cli-bundle/main.js +22 -22
  66. package/dist/cli-bundle/sdk-authoring.js +1 -1
  67. package/dist/cli-bundle/sdk-contracts.js +2 -2
  68. package/dist/cli-bundle/sdk-core.js +31 -31
  69. package/dist/cli-bundle/sdk-governance.js +1 -1
  70. package/dist/cli-bundle/sdk-graph.js +1 -1
  71. package/dist/cli-bundle/sdk-merge.js +51 -51
  72. package/dist/cli-bundle/sdk-query.js +1 -1
  73. package/dist/cli-bundle/sdk-runtime.js +1 -1
  74. package/dist/cli-bundle/sdk-testing.js +1 -1
  75. package/dist/cli-bundle/sdk.js +8 -8
  76. package/dist/cli.d.ts +4 -4
  77. package/dist/core/checkpoint/checkpoint-gc.d.ts +32 -32
  78. package/dist/core/checkpoint/mutation-checkpoint.d.ts +34 -34
  79. package/dist/core/config/nested-settings.d.ts +26 -26
  80. package/dist/core/config/positional-value.d.ts +16 -16
  81. package/dist/core/diagnostics/remediation.d.ts +6 -6
  82. package/dist/core/diagnostics/remediation.js +1 -1
  83. package/dist/core/extensions/activation-summary-markdown.d.ts +6 -6
  84. package/dist/core/extensions/activation-summary.d.ts +54 -54
  85. package/dist/core/extensions/activation-transaction.d.ts +7 -7
  86. package/dist/core/extensions/capability-usage.d.ts +26 -26
  87. package/dist/core/extensions/command-hook-context.d.ts +26 -26
  88. package/dist/core/extensions/contribution-inventory.d.ts +21 -21
  89. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  90. package/dist/core/extensions/extension-capability-aliases.d.ts +2 -2
  91. package/dist/core/extensions/extension-policy.d.ts +80 -80
  92. package/dist/core/extensions/extension-types.d.ts +1294 -1285
  93. package/dist/core/extensions/extension-types.js +1 -1
  94. package/dist/core/extensions/flag-definition-validation.d.ts +4 -4
  95. package/dist/core/extensions/item-fields.d.ts +3 -2
  96. package/dist/core/extensions/item-fields.js +1 -1
  97. package/dist/core/extensions/loader.d.ts +36 -36
  98. package/dist/core/extensions/loader.js +1 -1
  99. package/dist/core/extensions/manifest-schema.d.ts +16 -16
  100. package/dist/core/extensions/module-graph-snapshot.d.ts +8 -8
  101. package/dist/core/extensions/read-output-contract.d.ts +5 -0
  102. package/dist/core/extensions/read-output-contract.js +2 -0
  103. package/dist/core/extensions/registration-values.d.ts +1 -1
  104. package/dist/core/extensions/reserved-host-flags.d.ts +6 -6
  105. package/dist/core/extensions/version-compat.d.ts +10 -10
  106. package/dist/core/fs/fs-utils.d.ts +1 -1
  107. package/dist/core/fs/host-environment-errors.d.ts +14 -14
  108. package/dist/core/governance/content-fields.d.ts +31 -31
  109. package/dist/core/governance/issue-codes.d.ts +27 -27
  110. package/dist/core/governance/metadata-coverage.d.ts +91 -91
  111. package/dist/core/history/drift-scan.d.ts +26 -26
  112. package/dist/core/history/event-classification.d.ts +1 -1
  113. package/dist/core/history/event-classification.js +1 -1
  114. package/dist/core/history/event-index.d.ts +41 -41
  115. package/dist/core/history/history-compact-bulk.d.ts +22 -22
  116. package/dist/core/history/history-diff.d.ts +22 -22
  117. package/dist/core/history/history-rewrite.d.ts +66 -66
  118. package/dist/core/history/history-storage-stats.d.ts +31 -31
  119. package/dist/core/history/history-stream-policy.d.ts +12 -12
  120. package/dist/core/history/history.d.ts +22 -22
  121. package/dist/core/history/identity.d.ts +6 -6
  122. package/dist/core/history/operation-contract.d.ts +9 -9
  123. package/dist/core/history/projection.d.ts +15 -15
  124. package/dist/core/history/read.d.ts +4 -4
  125. package/dist/core/history/replay.d.ts +51 -49
  126. package/dist/core/history/replay.js +1 -1
  127. package/dist/core/history/workspace-history.d.ts +101 -101
  128. package/dist/core/io/bulk-ids-input.d.ts +4 -4
  129. package/dist/core/item/actionability.d.ts +40 -40
  130. package/dist/core/item/id.d.ts +3 -3
  131. package/dist/core/item/item-format-version.d.ts +8 -8
  132. package/dist/core/item/item-format.d.ts +37 -35
  133. package/dist/core/item/item-format.js +2 -2
  134. package/dist/core/item/item-type-definition.d.ts +2 -2
  135. package/dist/core/item/parent-reference-policy.d.ts +1 -1
  136. package/dist/core/item/parse.d.ts +12 -12
  137. package/dist/core/item/sprint-release-format.d.ts +2 -2
  138. package/dist/core/item/status-filter.d.ts +4 -4
  139. package/dist/core/item/toon-decode.d.ts +9 -9
  140. package/dist/core/item/type-registry.d.ts +40 -40
  141. package/dist/core/lock/lock-gc.d.ts +50 -50
  142. package/dist/core/lock/lock.d.ts +37 -37
  143. package/dist/core/output/mutation-projection.d.ts +6 -6
  144. package/dist/core/output/output-control.d.ts +4 -4
  145. package/dist/core/output/output.d.ts +40 -40
  146. package/dist/core/output/query-summary.d.ts +5 -5
  147. package/dist/core/packages/manifest.d.ts +50 -50
  148. package/dist/core/policy/workflow-policy-schema.d.ts +306 -306
  149. package/dist/core/policy/workflow-policy-store.d.ts +7 -7
  150. package/dist/core/policy/workflow-policy.d.ts +81 -81
  151. package/dist/core/profile/profile-describe.d.ts +40 -40
  152. package/dist/core/profile/profile-lint.d.ts +20 -20
  153. package/dist/core/profile/profile-plan.d.ts +84 -84
  154. package/dist/core/profile/profile-presets.d.ts +52 -52
  155. package/dist/core/reproducibility/context.d.ts +6 -6
  156. package/dist/core/schema/fields-file.d.ts +54 -54
  157. package/dist/core/schema/item-types-file.d.ts +36 -36
  158. package/dist/core/schema/runtime-field-values.d.ts +2 -2
  159. package/dist/core/schema/runtime-schema.d.ts +86 -86
  160. package/dist/core/schema/status-defs-file.d.ts +36 -36
  161. package/dist/core/schema/type-inference.d.ts +14 -14
  162. package/dist/core/schema/type-workflows.d.ts +22 -22
  163. package/dist/core/search/background-refresh.d.ts +9 -9
  164. package/dist/core/search/bm25.d.ts +19 -19
  165. package/dist/core/search/cache.d.ts +35 -35
  166. package/dist/core/search/corpus.d.ts +12 -12
  167. package/dist/core/search/embedding-batches.d.ts +48 -48
  168. package/dist/core/search/eval.d.ts +49 -49
  169. package/dist/core/search/http-client.d.ts +38 -38
  170. package/dist/core/search/providers.d.ts +41 -41
  171. package/dist/core/search/relevance.d.ts +20 -20
  172. package/dist/core/search/semantic-defaults.d.ts +8 -8
  173. package/dist/core/search/staleness.d.ts +4 -4
  174. package/dist/core/search/vector-stores.d.ts +78 -78
  175. package/dist/core/search/vectorization-metadata.d.ts +6 -6
  176. package/dist/core/sentry/helpers.d.ts +15 -15
  177. package/dist/core/sentry/instrument.d.ts +40 -40
  178. package/dist/core/session/session-state.d.ts +32 -32
  179. package/dist/core/shared/agent-session-context.d.ts +14 -14
  180. package/dist/core/shared/author.d.ts +128 -128
  181. package/dist/core/shared/command-types.d.ts +40 -40
  182. package/dist/core/shared/conflict-markers.d.ts +6 -6
  183. package/dist/core/shared/constants.d.ts +13 -13
  184. package/dist/core/shared/errors.d.ts +194 -183
  185. package/dist/core/shared/errors.js +1 -1
  186. package/dist/core/shared/secret-rules.d.ts +97 -97
  187. package/dist/core/shared/serial-queue.d.ts +8 -8
  188. package/dist/core/shared/split-comma-list.d.ts +6 -6
  189. package/dist/core/shared/time.d.ts +23 -23
  190. package/dist/core/store/item-format-migration.d.ts +10 -10
  191. package/dist/core/store/item-metadata-cache.d.ts +38 -38
  192. package/dist/core/store/item-metadata-query-index.d.ts +79 -79
  193. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  194. package/dist/core/store/item-store.d.ts +110 -110
  195. package/dist/core/store/paths.d.ts +2 -2
  196. package/dist/core/store/settings-read-cache.d.ts +12 -12
  197. package/dist/core/store/settings-validator.d.ts +165 -165
  198. package/dist/core/store/settings.d.ts +59 -59
  199. package/dist/core/telemetry/observability.d.ts +17 -17
  200. package/dist/core/telemetry/policy.d.ts +3 -3
  201. package/dist/core/telemetry/runtime.d.ts +242 -242
  202. package/dist/core/telemetry/runtime.js +2 -2
  203. package/dist/core/test/background-runs.d.ts +186 -185
  204. package/dist/core/test/background-runs.js +2 -2
  205. package/dist/core/test/item-test-run-tracking.d.ts +6 -6
  206. package/dist/core/test/run-selectors.d.ts +18 -18
  207. package/dist/core/validate/fix-planning.d.ts +50 -50
  208. package/dist/core/validate/missing-by-type.d.ts +4 -4
  209. package/dist/core/validate/missing-link-owners.d.ts +30 -30
  210. package/dist/core/validate/stale-file-classification.d.ts +8 -8
  211. package/dist/mcp/http-server.d.ts +28 -28
  212. package/dist/mcp/legacy-adapter.d.ts +33 -33
  213. package/dist/mcp/runtime-capabilities.d.ts +16 -16
  214. package/dist/mcp/server.d.ts +50 -50
  215. package/dist/mcp/tool-definitions.d.ts +36 -36
  216. package/dist/sdk/agent/closed-domain-contracts.d.ts +18 -18
  217. package/dist/sdk/agent/command-recovery.d.ts +4 -0
  218. package/dist/sdk/agent/command-recovery.js +1 -1
  219. package/dist/sdk/agent/command-suggestions.d.ts +2 -0
  220. package/dist/sdk/agent/command-suggestions.js +1 -1
  221. package/dist/sdk/agent/identity-config.d.ts +32 -32
  222. package/dist/sdk/agent/item-addressing.d.ts +8 -8
  223. package/dist/sdk/agent/refusal-closure-census.d.ts +34 -34
  224. package/dist/sdk/agent/refusal-closure.d.ts +42 -42
  225. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +46 -46
  226. package/dist/sdk/agent/refusal-reachability.d.ts +112 -112
  227. package/dist/sdk/agent/subcommand-recovery.d.ts +25 -25
  228. package/dist/sdk/agent/task-transcript-contracts.d.ts +30 -30
  229. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +38 -38
  230. package/dist/sdk/agent-capability-contracts.d.ts +37 -37
  231. package/dist/sdk/annotations.d.ts +106 -106
  232. package/dist/sdk/author-attribution.d.ts +76 -76
  233. package/dist/sdk/authoring.d.ts +1 -1
  234. package/dist/sdk/authoring.js +1 -1
  235. package/dist/sdk/cli-bootstrap.d.ts +70 -70
  236. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +63 -63
  237. package/dist/sdk/cli-contracts/command-aliases.d.ts +14 -14
  238. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +70 -70
  239. package/dist/sdk/cli-contracts/commander-types.d.ts +17 -17
  240. package/dist/sdk/cli-contracts/completeness.d.ts +26 -26
  241. package/dist/sdk/cli-contracts/enum-contracts.d.ts +5 -5
  242. package/dist/sdk/cli-contracts/flag-contracts.d.ts +32 -32
  243. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  244. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +42 -42
  245. package/dist/sdk/cli-contracts/flag-lexicon-contracts.js +1 -1
  246. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +84 -84
  247. package/dist/sdk/cli-contracts/grammar-contracts.js +1 -1
  248. package/dist/sdk/cli-contracts/registration-helpers.d.ts +37 -40
  249. package/dist/sdk/cli-contracts/registration-helpers.js +1 -1
  250. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +290 -294
  251. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  252. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +793 -793
  253. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +391 -391
  254. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +6 -6
  255. package/dist/sdk/cli-contracts/tool-parameter-tables.js +1 -1
  256. package/dist/sdk/cli-contracts/tool-schema.d.ts +55 -55
  257. package/dist/sdk/cli-contracts/tool-schema.js +1 -1
  258. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +24 -24
  259. package/dist/sdk/comments.d.ts +44 -44
  260. package/dist/sdk/compile-cache.d.ts +4 -4
  261. package/dist/sdk/completion/shared.d.ts +22 -22
  262. package/dist/sdk/compose.d.ts +156 -156
  263. package/dist/sdk/config.d.ts +123 -123
  264. package/dist/sdk/context/semantic-session-attribution.d.ts +14 -14
  265. package/dist/sdk/context/usage-ledger.d.ts +20 -20
  266. package/dist/sdk/context-intent-contracts.d.ts +50 -50
  267. package/dist/sdk/context-intent-contracts.js +1 -1
  268. package/dist/sdk/context-intent-runtime.d.ts +8 -8
  269. package/dist/sdk/context-packing.d.ts +78 -78
  270. package/dist/sdk/context-relevance.d.ts +189 -180
  271. package/dist/sdk/context-relevance.js +1 -1
  272. package/dist/sdk/context-signal-store.d.ts +84 -84
  273. package/dist/sdk/context-usage.d.ts +92 -92
  274. package/dist/sdk/core.d.ts +1 -0
  275. package/dist/sdk/core.js +1 -1
  276. package/dist/sdk/corpus-shape.d.ts +101 -101
  277. package/dist/sdk/define.d.ts +2 -2
  278. package/dist/sdk/dependencies.d.ts +116 -116
  279. package/dist/sdk/dependency-flag-validation.d.ts +14 -12
  280. package/dist/sdk/dependency-flag-validation.js +1 -1
  281. package/dist/sdk/dependency-provenance.d.ts +30 -30
  282. package/dist/sdk/docs.d.ts +32 -32
  283. package/dist/sdk/duplicates.d.ts +21 -21
  284. package/dist/sdk/environment/agent-environment.d.ts +196 -196
  285. package/dist/sdk/environment/project-runtime-compatibility.d.ts +56 -56
  286. package/dist/sdk/environment/source-context.d.ts +6 -6
  287. package/dist/sdk/error-code-catalog.d.ts +40 -40
  288. package/dist/sdk/errors.d.ts +29 -29
  289. package/dist/sdk/eval.d.ts +45 -45
  290. package/dist/sdk/extension/author-manifest.d.ts +14 -14
  291. package/dist/sdk/extension/bundled-catalog.d.ts +7 -7
  292. package/dist/sdk/extension/describe.d.ts +36 -36
  293. package/dist/sdk/extension/doctor.d.ts +29 -29
  294. package/dist/sdk/extension/install-plan.d.ts +55 -55
  295. package/dist/sdk/extension/install-receipts.d.ts +2 -2
  296. package/dist/sdk/extension/install-runtime.d.ts +8 -8
  297. package/dist/sdk/extension/install-snapshot.d.ts +14 -14
  298. package/dist/sdk/extension/install-sources.d.ts +96 -96
  299. package/dist/sdk/extension/managed-state.d.ts +66 -66
  300. package/dist/sdk/extension/migrations.d.ts +82 -82
  301. package/dist/sdk/extension/output-ownership.d.ts +24 -24
  302. package/dist/sdk/extension/runtime-summary.d.ts +5 -5
  303. package/dist/sdk/extension/scaffold.d.ts +12 -12
  304. package/dist/sdk/extension/shared.d.ts +15 -15
  305. package/dist/sdk/extension/source-resolution.d.ts +30 -30
  306. package/dist/sdk/extension/static-inventory.d.ts +42 -42
  307. package/dist/sdk/extension/update-check.d.ts +10 -10
  308. package/dist/sdk/extension.d.ts +320 -320
  309. package/dist/sdk/files.d.ts +157 -157
  310. package/dist/sdk/flag-invocation-contracts.d.ts +44 -44
  311. package/dist/sdk/generated/generated-error-code-catalog-part-1.js +1 -1
  312. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  313. package/dist/sdk/governance/artifact-ledgers.d.ts +35 -35
  314. package/dist/sdk/governance/artifact-ledgers.js +1 -1
  315. package/dist/sdk/governance/assurance-action.d.ts +68 -68
  316. package/dist/sdk/governance/assurance-action.js +1 -1
  317. package/dist/sdk/governance/assurance-mutation-error.d.ts +36 -36
  318. package/dist/sdk/governance/assurance-presets.d.ts +24 -24
  319. package/dist/sdk/governance/assurance-runtime.d.ts +14 -14
  320. package/dist/sdk/governance/assurance.d.ts +353 -353
  321. package/dist/sdk/governance/boundary-fixtures.d.ts +60 -60
  322. package/dist/sdk/governance/closure-timestamps.d.ts +9 -9
  323. package/dist/sdk/governance/coverage-assurance.d.ts +10 -10
  324. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +75 -75
  325. package/dist/sdk/governance/defect-recurrence-graph.d.ts +18 -18
  326. package/dist/sdk/governance/defect-recurrence.d.ts +186 -181
  327. package/dist/sdk/governance/defect-recurrence.js +1 -1
  328. package/dist/sdk/governance/extension-host-version.d.ts +16 -16
  329. package/dist/sdk/governance/gc.d.ts +48 -48
  330. package/dist/sdk/governance/health-merge-evidence.d.ts +5 -5
  331. package/dist/sdk/governance/health.d.ts +188 -188
  332. package/dist/sdk/governance/hierarchy-validation.d.ts +13 -13
  333. package/dist/sdk/governance/linked-file-report.d.ts +26 -26
  334. package/dist/sdk/governance/merge-receipt-history.d.ts +36 -36
  335. package/dist/sdk/governance/provenance-health.d.ts +64 -64
  336. package/dist/sdk/governance/reindex.d.ts +89 -89
  337. package/dist/sdk/governance/reliability.d.ts +56 -56
  338. package/dist/sdk/governance/stale-work.d.ts +22 -22
  339. package/dist/sdk/governance/status-role-diagnostics.d.ts +12 -12
  340. package/dist/sdk/governance/storage-integrity.d.ts +54 -54
  341. package/dist/sdk/governance/tracked-runtime-cache.d.ts +10 -10
  342. package/dist/sdk/governance/upgrade.d.ts +104 -104
  343. package/dist/sdk/governance/validate-history-drift.d.ts +2 -2
  344. package/dist/sdk/governance/validate-item-reader.d.ts +6 -6
  345. package/dist/sdk/governance/validate.d.ts +191 -191
  346. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  347. package/dist/sdk/governance/workflow-policy.d.ts +28 -28
  348. package/dist/sdk/governance/workspace-position.d.ts +46 -46
  349. package/dist/sdk/graph/adapter.d.ts +66 -66
  350. package/dist/sdk/graph/analytics.d.ts +54 -54
  351. package/dist/sdk/graph/assembly.d.ts +80 -80
  352. package/dist/sdk/graph/cache.d.ts +29 -29
  353. package/dist/sdk/graph/cardinality-integrity.d.ts +13 -0
  354. package/dist/sdk/graph/cardinality-integrity.js +2 -0
  355. package/dist/sdk/graph/centrality.d.ts +34 -34
  356. package/dist/sdk/graph/conformance.d.ts +33 -33
  357. package/dist/sdk/graph/deadline-scheduling.d.ts +58 -58
  358. package/dist/sdk/graph/durable-cache.d.ts +26 -26
  359. package/dist/sdk/graph/governance.d.ts +165 -165
  360. package/dist/sdk/graph/hierarchy-integrity.d.ts +52 -52
  361. package/dist/sdk/graph/index.d.ts +1 -0
  362. package/dist/sdk/graph/index.js +1 -1
  363. package/dist/sdk/graph/lifecycle-coverage.d.ts +17 -17
  364. package/dist/sdk/graph/mutation-advisory.d.ts +11 -11
  365. package/dist/sdk/graph/query-contracts.d.ts +10 -10
  366. package/dist/sdk/graph/remediation.d.ts +25 -25
  367. package/dist/sdk/graph/run.d.ts +392 -392
  368. package/dist/sdk/graph/scheduling.d.ts +38 -38
  369. package/dist/sdk/graph/traversal.d.ts +14 -14
  370. package/dist/sdk/guide-topics.d.ts +32 -32
  371. package/dist/sdk/guide.d.ts +62 -62
  372. package/dist/sdk/history/attestation-command.d.ts +12 -12
  373. package/dist/sdk/history/attestation-contract.d.ts +78 -78
  374. package/dist/sdk/history/attestation-scan.d.ts +6 -6
  375. package/dist/sdk/history/maintenance.d.ts +46 -46
  376. package/dist/sdk/history/salvage.d.ts +18 -18
  377. package/dist/sdk/history/subject.d.ts +9 -9
  378. package/dist/sdk/history-analytics.d.ts +84 -84
  379. package/dist/sdk/history-compact.d.ts +103 -103
  380. package/dist/sdk/history-mcp.d.ts +8 -8
  381. package/dist/sdk/history-provenance.d.ts +59 -59
  382. package/dist/sdk/history-read.d.ts +36 -36
  383. package/dist/sdk/history-redact.d.ts +78 -78
  384. package/dist/sdk/history-repair.d.ts +158 -158
  385. package/dist/sdk/history-repair.js +1 -1
  386. package/dist/sdk/improvement-ledger.d.ts +102 -102
  387. package/dist/sdk/index.d.ts +2 -0
  388. package/dist/sdk/index.js +1 -1
  389. package/dist/sdk/init-agent-guidance.d.ts +70 -70
  390. package/dist/sdk/init.d.ts +152 -152
  391. package/dist/sdk/item-children.d.ts +28 -28
  392. package/dist/sdk/item-schedule.d.ts +12 -12
  393. package/dist/sdk/item-transaction.d.ts +100 -100
  394. package/dist/sdk/learnings.d.ts +42 -42
  395. package/dist/sdk/lifecycle/append.d.ts +14 -14
  396. package/dist/sdk/lifecycle/claim.d.ts +60 -60
  397. package/dist/sdk/lifecycle/close-many.d.ts +94 -94
  398. package/dist/sdk/lifecycle/close.d.ts +27 -27
  399. package/dist/sdk/lifecycle/copy.d.ts +18 -18
  400. package/dist/sdk/lifecycle/core-field-recovery.d.ts +7 -0
  401. package/dist/sdk/lifecycle/core-field-recovery.js +2 -0
  402. package/dist/sdk/lifecycle/create.d.ts +82 -82
  403. package/dist/sdk/lifecycle/create.js +1 -1
  404. package/dist/sdk/lifecycle/delete.d.ts +28 -28
  405. package/dist/sdk/lifecycle/focus.d.ts +10 -10
  406. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +10 -10
  407. package/dist/sdk/lifecycle/hierarchy-mutation-lock.js +1 -1
  408. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +54 -54
  409. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +4 -4
  410. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  411. package/dist/sdk/lifecycle/mutation-command-options.d.ts +116 -116
  412. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +6 -0
  413. package/dist/sdk/lifecycle/mutation-facet-contracts.js +2 -0
  414. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +42 -42
  415. package/dist/sdk/lifecycle/plan.d.ts +217 -217
  416. package/dist/sdk/lifecycle/reopen.d.ts +29 -24
  417. package/dist/sdk/lifecycle/reopen.js +1 -1
  418. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +3 -3
  419. package/dist/sdk/lifecycle/restore.d.ts +33 -33
  420. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +19 -19
  421. package/dist/sdk/lifecycle/task-composition.d.ts +4 -4
  422. package/dist/sdk/lifecycle/update-many.d.ts +79 -79
  423. package/dist/sdk/lifecycle/update.d.ts +131 -132
  424. package/dist/sdk/lifecycle/update.js +2 -2
  425. package/dist/sdk/lifecycle-completion.d.ts +22 -22
  426. package/dist/sdk/lifecycle-policy.d.ts +52 -52
  427. package/dist/sdk/linked-artifacts.d.ts +69 -69
  428. package/dist/sdk/mcp/apps.d.ts +32 -32
  429. package/dist/sdk/mcp/authorization.d.ts +76 -76
  430. package/dist/sdk/mcp/discovery.d.ts +111 -111
  431. package/dist/sdk/mcp/interactions.d.ts +61 -61
  432. package/dist/sdk/mcp/protocol.d.ts +78 -78
  433. package/dist/sdk/mcp/skills.d.ts +88 -88
  434. package/dist/sdk/mcp/subscriptions.d.ts +39 -39
  435. package/dist/sdk/mcp/tasks.d.ts +75 -75
  436. package/dist/sdk/mcp/transport.d.ts +11 -11
  437. package/dist/sdk/merge/abandoned-receipts.d.ts +6 -6
  438. package/dist/sdk/merge/driver.d.ts +60 -60
  439. package/dist/sdk/merge/install.d.ts +64 -64
  440. package/dist/sdk/merge/receipt-file-boundary.d.ts +5 -5
  441. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  442. package/dist/sdk/merge/receipt-schema.d.ts +2 -2
  443. package/dist/sdk/merge/receipts.d.ts +156 -156
  444. package/dist/sdk/merge/reconcile.d.ts +36 -36
  445. package/dist/sdk/merge/reconcile.js +1 -1
  446. package/dist/sdk/merge/three-way.d.ts +77 -76
  447. package/dist/sdk/merge/three-way.js +1 -1
  448. package/dist/sdk/mutation-events.d.ts +84 -84
  449. package/dist/sdk/mutation-guard.d.ts +106 -106
  450. package/dist/sdk/notes.d.ts +52 -52
  451. package/dist/sdk/output/table-rows.d.ts +8 -8
  452. package/dist/sdk/output-contracts.d.ts +38 -38
  453. package/dist/sdk/output-projection.d.ts +142 -142
  454. package/dist/sdk/output-token-accounting.d.ts +27 -27
  455. package/dist/sdk/output.d.ts +28 -28
  456. package/dist/sdk/package-import-adapters.d.ts +54 -54
  457. package/dist/sdk/pagination.d.ts +29 -29
  458. package/dist/sdk/profile.d.ts +123 -123
  459. package/dist/sdk/provenance.d.ts +58 -58
  460. package/dist/sdk/public-surface.json +1 -1
  461. package/dist/sdk/query/activity.d.ts +118 -118
  462. package/dist/sdk/query/aggregate.d.ts +140 -140
  463. package/dist/sdk/query/calendar.d.ts +144 -144
  464. package/dist/sdk/query/complete-list.d.ts +53 -53
  465. package/dist/sdk/query/context.d.ts +395 -395
  466. package/dist/sdk/query/duplicate-candidates.d.ts +1 -1
  467. package/dist/sdk/query/get.d.ts +77 -77
  468. package/dist/sdk/query/history.d.ts +72 -72
  469. package/dist/sdk/query/item-filter-options.d.ts +79 -79
  470. package/dist/sdk/query/list-filter-shared.d.ts +1 -1
  471. package/dist/sdk/query/list.d.ts +188 -188
  472. package/dist/sdk/query/multi-value-filters.d.ts +4 -4
  473. package/dist/sdk/query/next-ready-budget.d.ts +14 -14
  474. package/dist/sdk/query/next.d.ts +137 -137
  475. package/dist/sdk/query/projection-contracts.d.ts +8 -8
  476. package/dist/sdk/query/search/corpus.d.ts +8 -8
  477. package/dist/sdk/query/search/filters.d.ts +5 -5
  478. package/dist/sdk/query/search/input.d.ts +4 -4
  479. package/dist/sdk/query/search/response.d.ts +8 -8
  480. package/dist/sdk/query/search/semantic.d.ts +106 -106
  481. package/dist/sdk/query/search/types.d.ts +85 -85
  482. package/dist/sdk/query/search-contracts.d.ts +65 -65
  483. package/dist/sdk/query/search-pagination.d.ts +19 -19
  484. package/dist/sdk/query/search-rendering.d.ts +25 -25
  485. package/dist/sdk/query/search.d.ts +46 -46
  486. package/dist/sdk/read-output/continuation.d.ts +8 -8
  487. package/dist/sdk/read-output/continuation.js +1 -1
  488. package/dist/sdk/read-output/extension.d.ts +7 -0
  489. package/dist/sdk/read-output/extension.js +2 -0
  490. package/dist/sdk/read-output/options.d.ts +6 -4
  491. package/dist/sdk/read-output/options.js +1 -1
  492. package/dist/sdk/read-output/provenance.d.ts +8 -8
  493. package/dist/sdk/read-output-budget.d.ts +10 -10
  494. package/dist/sdk/read-output-contracts.d.ts +192 -186
  495. package/dist/sdk/read-output-contracts.js +1 -1
  496. package/dist/sdk/read-output-rows.d.ts +6 -6
  497. package/dist/sdk/read-output-session.d.ts +50 -50
  498. package/dist/sdk/relationship-analytics.d.ts +78 -78
  499. package/dist/sdk/relationship-context.d.ts +81 -81
  500. package/dist/sdk/relationship-history.d.ts +109 -109
  501. package/dist/sdk/relationship-kinds/contract.d.ts +34 -34
  502. package/dist/sdk/relationship-migration.d.ts +26 -26
  503. package/dist/sdk/relationships.d.ts +78 -78
  504. package/dist/sdk/reproducibility/process.d.ts +3 -3
  505. package/dist/sdk/runtime/context.d.ts +11 -11
  506. package/dist/sdk/runtime-action-aliases.d.ts +2 -2
  507. package/dist/sdk/runtime-extended-actions.d.ts +8 -8
  508. package/dist/sdk/runtime-input.d.ts +3 -3
  509. package/dist/sdk/runtime-public-contracts.d.ts +78 -78
  510. package/dist/sdk/runtime.d.ts +305 -305
  511. package/dist/sdk/runtime.js +1 -1
  512. package/dist/sdk/scheduling-shortcuts.d.ts +32 -32
  513. package/dist/sdk/schema-migration.d.ts +86 -86
  514. package/dist/sdk/schema.d.ts +355 -355
  515. package/dist/sdk/similarity-scoring.d.ts +10 -10
  516. package/dist/sdk/similarity.d.ts +113 -113
  517. package/dist/sdk/stats.d.ts +108 -108
  518. package/dist/sdk/structured-mutations.d.ts +16 -16
  519. package/dist/sdk/structured-mutations.js +1 -1
  520. package/dist/sdk/telemetry.d.ts +53 -53
  521. package/dist/sdk/templates.d.ts +39 -39
  522. package/dist/sdk/test/batch.d.ts +85 -85
  523. package/dist/sdk/test/batch.js +1 -1
  524. package/dist/sdk/test/command-args.d.ts +4 -0
  525. package/dist/sdk/test/command-args.js +2 -0
  526. package/dist/sdk/test/entry.d.ts +3 -0
  527. package/dist/sdk/test/entry.js +1 -1
  528. package/dist/sdk/test/execution-receipts.d.ts +3 -3
  529. package/dist/sdk/test/execution.d.ts +279 -268
  530. package/dist/sdk/test/execution.js +2 -2
  531. package/dist/sdk/test/json-path.d.ts +2 -2
  532. package/dist/sdk/test/linked-command-detection.d.ts +10 -10
  533. package/dist/sdk/test/measurements.d.ts +11 -11
  534. package/dist/sdk/test/parsers.d.ts +1 -1
  535. package/dist/sdk/test/parsers.js +1 -1
  536. package/dist/sdk/test/prerequisites.d.ts +6 -0
  537. package/dist/sdk/test/prerequisites.js +2 -0
  538. package/dist/sdk/test/runs.d.ts +52 -52
  539. package/dist/sdk/test/trust.d.ts +12 -12
  540. package/dist/sdk/test/trust.js +1 -1
  541. package/dist/sdk/test/update.d.ts +55 -0
  542. package/dist/sdk/test/update.js +2 -0
  543. package/dist/sdk/testing.d.ts +319 -319
  544. package/dist/sdk/traceability/source-traceability.d.ts +65 -65
  545. package/dist/sdk/workspace-contracts.d.ts +37 -37
  546. package/dist/sdk/workspace-memory.d.ts +60 -60
  547. package/dist/sdk/workspace-recipe.d.ts +9 -9
  548. package/dist/sdk/workspace-snapshot.d.ts +97 -97
  549. package/dist/sdk/workspace-transaction-gc.d.ts +32 -32
  550. package/dist/sdk/workspace-transaction.d.ts +47 -47
  551. package/dist/sdk/workspace.d.ts +6 -6
  552. package/dist/types.d.ts +978 -974
  553. package/dist/types.js +1 -1
  554. package/docs/BUILD_AND_RELEASE_ACCEPTANCE.md +5 -2
  555. package/docs/DEFECT_RECURRENCE.md +12 -0
  556. package/docs/EXTENSIONS.md +2 -2
  557. package/docs/LINKED_TEST_EDITS.md +79 -0
  558. package/docs/MERGE_SAFETY.md +27 -1
  559. package/docs/RECURRENCE_RECOVERY_CONTRACTS.md +17 -4
  560. package/docs/RELATIONSHIP_GRAPH.md +26 -0
  561. package/docs/RELEASING.md +25 -8
  562. package/docs/SDK.md +204 -637
  563. package/docs/SDK_CONSUMER_RECEIPTS.md +67 -0
  564. package/docs/SDK_EVIDENCE_TRACEABILITY.md +4 -0
  565. package/docs/TESTING.md +13 -0
  566. package/docs/generated/FLAG_LEXICON_BUDGETS.md +2 -2
  567. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +11 -3
  568. package/docs/performance/runner-qualification.md +36 -0
  569. package/marketplace.json +1 -1
  570. package/node_modules/@opentelemetry/core/build/esm/version.d.ts +1 -1
  571. package/node_modules/@opentelemetry/core/build/esm/version.js +1 -1
  572. package/node_modules/@opentelemetry/core/build/esnext/version.d.ts +1 -1
  573. package/node_modules/@opentelemetry/core/build/esnext/version.js +1 -1
  574. package/node_modules/@opentelemetry/core/build/src/version.d.ts +1 -1
  575. package/node_modules/@opentelemetry/core/build/src/version.js +1 -1
  576. package/node_modules/@opentelemetry/core/package.json +2 -2
  577. package/node_modules/@opentelemetry/resources/build/esm/version.d.ts +1 -1
  578. package/node_modules/@opentelemetry/resources/build/esm/version.js +1 -1
  579. package/node_modules/@opentelemetry/resources/build/esnext/version.d.ts +1 -1
  580. package/node_modules/@opentelemetry/resources/build/esnext/version.js +1 -1
  581. package/node_modules/@opentelemetry/resources/build/src/version.d.ts +1 -1
  582. package/node_modules/@opentelemetry/resources/build/src/version.js +1 -1
  583. package/node_modules/@opentelemetry/resources/package.json +3 -3
  584. package/node_modules/@opentelemetry/sdk-trace/build/esm/StackContextManager.d.ts +57 -0
  585. package/node_modules/@opentelemetry/sdk-trace/build/esm/StackContextManager.js +105 -0
  586. package/node_modules/@opentelemetry/sdk-trace/build/esm/index.d.ts +1 -0
  587. package/node_modules/@opentelemetry/sdk-trace/build/esm/index.js +1 -0
  588. package/node_modules/@opentelemetry/sdk-trace/build/esm/version.d.ts +1 -1
  589. package/node_modules/@opentelemetry/sdk-trace/build/esm/version.js +1 -1
  590. package/node_modules/@opentelemetry/sdk-trace/build/esnext/StackContextManager.d.ts +57 -0
  591. package/node_modules/@opentelemetry/sdk-trace/build/esnext/StackContextManager.js +105 -0
  592. package/node_modules/@opentelemetry/sdk-trace/build/esnext/index.d.ts +1 -0
  593. package/node_modules/@opentelemetry/sdk-trace/build/esnext/index.js +1 -0
  594. package/node_modules/@opentelemetry/sdk-trace/build/esnext/version.d.ts +1 -1
  595. package/node_modules/@opentelemetry/sdk-trace/build/esnext/version.js +1 -1
  596. package/node_modules/@opentelemetry/sdk-trace/build/src/StackContextManager.d.ts +57 -0
  597. package/node_modules/@opentelemetry/sdk-trace/build/src/StackContextManager.js +109 -0
  598. package/node_modules/@opentelemetry/sdk-trace/build/src/index.d.ts +1 -0
  599. package/node_modules/@opentelemetry/sdk-trace/build/src/index.js +3 -1
  600. package/node_modules/@opentelemetry/sdk-trace/build/src/version.d.ts +1 -1
  601. package/node_modules/@opentelemetry/sdk-trace/build/src/version.js +1 -1
  602. package/node_modules/@opentelemetry/sdk-trace/package.json +5 -5
  603. package/node_modules/@opentelemetry/sdk-trace-base/build/esm/version.d.ts +1 -1
  604. package/node_modules/@opentelemetry/sdk-trace-base/build/esm/version.js +1 -1
  605. package/node_modules/@opentelemetry/sdk-trace-base/build/esnext/version.d.ts +1 -1
  606. package/node_modules/@opentelemetry/sdk-trace-base/build/esnext/version.js +1 -1
  607. package/node_modules/@opentelemetry/sdk-trace-base/build/src/version.d.ts +1 -1
  608. package/node_modules/@opentelemetry/sdk-trace-base/build/src/version.js +1 -1
  609. package/node_modules/@opentelemetry/sdk-trace-base/package.json +7 -7
  610. package/node_modules/@sentry/core/build/cjs/browser.js +3 -0
  611. package/node_modules/@sentry/core/build/cjs/fetch.js +10 -9
  612. package/node_modules/@sentry/core/build/cjs/index.js +3 -0
  613. package/node_modules/@sentry/core/build/cjs/integrations/http/add-outgoing-request-breadcrumb.js +2 -1
  614. package/node_modules/@sentry/core/build/cjs/integrations/http/get-outgoing-span-data.js +3 -2
  615. package/node_modules/@sentry/core/build/cjs/integrations/http/server-subscription.js +7 -3
  616. package/node_modules/@sentry/core/build/cjs/integrations/requestdata.js +23 -9
  617. package/node_modules/@sentry/core/build/cjs/server.js +3 -0
  618. package/node_modules/@sentry/core/build/cjs/utils/data-collection/filterCollectedUrl.js +24 -0
  619. package/node_modules/@sentry/core/build/cjs/utils/data-collection/filterKeyValueData.js +17 -23
  620. package/node_modules/@sentry/core/build/cjs/utils/data-collection/filterQueryParams.js +8 -15
  621. package/node_modules/@sentry/core/build/cjs/utils/data-collection/filterUrlQuery.js +20 -0
  622. package/node_modules/@sentry/core/build/cjs/utils/url.js +4 -3
  623. package/node_modules/@sentry/core/build/cjs/utils/version.js +1 -1
  624. package/node_modules/@sentry/core/build/esm/browser.js +1 -0
  625. package/node_modules/@sentry/core/build/esm/fetch.js +10 -9
  626. package/node_modules/@sentry/core/build/esm/index.js +1 -0
  627. package/node_modules/@sentry/core/build/esm/integrations/http/add-outgoing-request-breadcrumb.js +2 -1
  628. package/node_modules/@sentry/core/build/esm/integrations/http/get-outgoing-span-data.js +3 -2
  629. package/node_modules/@sentry/core/build/esm/integrations/http/server-subscription.js +7 -3
  630. package/node_modules/@sentry/core/build/esm/integrations/requestdata.js +23 -9
  631. package/node_modules/@sentry/core/build/esm/package.json +1 -1
  632. package/node_modules/@sentry/core/build/esm/server.js +1 -0
  633. package/node_modules/@sentry/core/build/esm/utils/data-collection/filterCollectedUrl.js +21 -0
  634. package/node_modules/@sentry/core/build/esm/utils/data-collection/filterKeyValueData.js +18 -25
  635. package/node_modules/@sentry/core/build/esm/utils/data-collection/filterQueryParams.js +9 -16
  636. package/node_modules/@sentry/core/build/esm/utils/data-collection/filterUrlQuery.js +18 -0
  637. package/node_modules/@sentry/core/build/esm/utils/url.js +4 -3
  638. package/node_modules/@sentry/core/build/esm/utils/version.js +1 -1
  639. package/node_modules/@sentry/core/build/types/shared-exports.d.ts +1 -0
  640. package/node_modules/@sentry/core/build/types/utils/data-collection/filterCollectedUrl.d.ts +21 -0
  641. package/node_modules/@sentry/core/build/types/utils/data-collection/filterKeyValueData.d.ts +1 -0
  642. package/node_modules/@sentry/core/build/types/utils/data-collection/filterQueryParams.d.ts +2 -3
  643. package/node_modules/@sentry/core/build/types/utils/data-collection/filterUrlQuery.d.ts +13 -0
  644. package/node_modules/@sentry/core/build/types/utils/url.d.ts +4 -1
  645. package/node_modules/@sentry/core/build/types-ts3.8/shared-exports.d.ts +1 -0
  646. package/node_modules/@sentry/core/build/types-ts3.8/utils/data-collection/filterCollectedUrl.d.ts +21 -0
  647. package/node_modules/@sentry/core/build/types-ts3.8/utils/data-collection/filterKeyValueData.d.ts +1 -0
  648. package/node_modules/@sentry/core/build/types-ts3.8/utils/data-collection/filterQueryParams.d.ts +2 -3
  649. package/node_modules/@sentry/core/build/types-ts3.8/utils/data-collection/filterUrlQuery.d.ts +13 -0
  650. package/node_modules/@sentry/core/build/types-ts3.8/utils/url.d.ts +4 -1
  651. package/node_modules/@sentry/core/package.json +3 -2
  652. package/node_modules/@sentry/node/build/cjs/integrations/tracing/vercelai/instrumentation.js +3 -0
  653. package/node_modules/@sentry/node/build/esm/integrations/tracing/vercelai/instrumentation.js +3 -0
  654. package/node_modules/@sentry/node/build/esm/package.json +1 -1
  655. package/node_modules/@sentry/node/package.json +7 -6
  656. package/node_modules/@sentry/node-core/build/cjs/integrations/anr/index.js +1 -1
  657. package/node_modules/@sentry/node-core/build/cjs/integrations/http/httpServerSpansIntegration.js +6 -3
  658. package/node_modules/@sentry/node-core/build/cjs/integrations/local-variables/local-variables-async.js +1 -1
  659. package/node_modules/@sentry/node-core/build/cjs/integrations/node-fetch/undici-instrumentation.js +2 -2
  660. package/node_modules/@sentry/node-core/build/cjs/light/client.js +7 -0
  661. package/node_modules/@sentry/node-core/build/cjs/sdk/client.js +7 -0
  662. package/node_modules/@sentry/node-core/build/cjs/utils/outgoingFetchRequest.js +1 -1
  663. package/node_modules/@sentry/node-core/build/esm/integrations/anr/index.js +1 -1
  664. package/node_modules/@sentry/node-core/build/esm/integrations/anr/worker-script.js +2 -2
  665. package/node_modules/@sentry/node-core/build/esm/integrations/http/httpServerSpansIntegration.js +7 -4
  666. package/node_modules/@sentry/node-core/build/esm/integrations/local-variables/local-variables-async.js +1 -1
  667. package/node_modules/@sentry/node-core/build/esm/integrations/local-variables/worker-script.js +1 -1
  668. package/node_modules/@sentry/node-core/build/esm/integrations/node-fetch/undici-instrumentation.js +3 -3
  669. package/node_modules/@sentry/node-core/build/esm/light/client.js +8 -1
  670. package/node_modules/@sentry/node-core/build/esm/package.json +1 -1
  671. package/node_modules/@sentry/node-core/build/esm/sdk/client.js +8 -1
  672. package/node_modules/@sentry/node-core/build/esm/utils/outgoingFetchRequest.js +2 -2
  673. package/node_modules/@sentry/node-core/build/types/light/client.d.ts +1 -0
  674. package/node_modules/@sentry/node-core/build/types/sdk/client.d.ts +1 -0
  675. package/node_modules/@sentry/node-core/build/types-ts3.8/light/client.d.ts +1 -0
  676. package/node_modules/@sentry/node-core/build/types-ts3.8/sdk/client.d.ts +1 -0
  677. package/node_modules/@sentry/node-core/package.json +5 -4
  678. package/node_modules/@sentry/opentelemetry/build/cjs/{asyncContextStrategy-BJ5buq_A.js → asyncContextStrategy-BR-l9zjD.js} +8 -6
  679. package/node_modules/@sentry/opentelemetry/build/cjs/index.browser.js +1 -1
  680. package/node_modules/@sentry/opentelemetry/build/cjs/index.js +1 -1
  681. package/node_modules/@sentry/opentelemetry/build/esm/{asyncContextStrategy-Bx5F5tCX.js → asyncContextStrategy-BQfM_LMv.js} +9 -7
  682. package/node_modules/@sentry/opentelemetry/build/esm/index.browser.js +1 -1
  683. package/node_modules/@sentry/opentelemetry/build/esm/index.js +2 -2
  684. package/node_modules/@sentry/opentelemetry/build/esm/package.json +1 -1
  685. package/node_modules/@sentry/opentelemetry/package.json +4 -3
  686. package/node_modules/@sentry/server-utils/build/cjs/tracing-channel.js +1 -0
  687. package/node_modules/@sentry/server-utils/build/esm/package.json +1 -1
  688. package/node_modules/@sentry/server-utils/build/esm/tracing-channel.js +1 -0
  689. package/node_modules/@sentry/server-utils/build/types/tracing-channel.d.ts +3 -1
  690. package/node_modules/@sentry/server-utils/build/types-ts3.8/tracing-channel.d.ts +3 -1
  691. package/node_modules/@sentry/server-utils/package.json +4 -3
  692. package/node_modules/cjs-module-lexer/README.md +8 -3
  693. package/node_modules/cjs-module-lexer/dist/lexer.js +1 -1
  694. package/node_modules/cjs-module-lexer/dist/lexer.mjs +2 -2
  695. package/node_modules/cjs-module-lexer/lexer.js +48 -9
  696. package/node_modules/cjs-module-lexer/package.json +3 -2
  697. package/node_modules/es-module-lexer/dist/lexer.asm.js +2 -2
  698. package/node_modules/es-module-lexer/dist/lexer.cjs +1 -1
  699. package/node_modules/es-module-lexer/dist/lexer.js +2 -2
  700. package/node_modules/es-module-lexer/dist/lexer.minimal.asm.js +2 -2
  701. package/node_modules/es-module-lexer/dist/lexer.minimal.cjs +1 -1
  702. package/node_modules/es-module-lexer/dist/lexer.minimal.js +2 -2
  703. package/node_modules/es-module-lexer/package.json +1 -1
  704. package/node_modules/import-in-the-middle/CHANGELOG.md +7 -0
  705. package/node_modules/import-in-the-middle/lib/get-esm-exports.mjs +7 -0
  706. package/node_modules/import-in-the-middle/package.json +1 -1
  707. package/package.json +2 -2
  708. package/packages/pm-beads/extensions/beads/runtime.ts +2 -2
  709. package/packages/pm-beads/package.json +1 -1
  710. package/packages/pm-calendar/package.json +1 -1
  711. package/packages/pm-command-kit/package.json +1 -1
  712. package/packages/pm-digital-twin/package.json +1 -1
  713. package/packages/pm-governance-audit/package.json +1 -1
  714. package/packages/pm-guide-shell/package.json +1 -1
  715. package/packages/pm-kanban/package.json +1 -1
  716. package/packages/pm-lifecycle-hooks/package.json +1 -1
  717. package/packages/pm-linked-test-adapters/package.json +1 -1
  718. package/packages/pm-search-advanced/package.json +1 -1
  719. package/packages/pm-templates/package.json +1 -1
  720. package/packages/pm-todos/package.json +1 -1
  721. package/packages/pm-vcs/package.json +1 -1
  722. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  723. package/plugins/pm-claude/package.json +1 -1
  724. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  725. package/plugins/pm-codex/package.json +1 -1
  726. package/plugins/pm-codex/plugin.json +1 -1
  727. package/runtime-dependencies.json +1 -1
  728. package/scripts/finalize-build.mjs +37 -0
  729. package/dist/cli-bundle/chunks/chunk-BXSXT5Z6.js +0 -2
  730. package/dist/cli-bundle/chunks/chunk-KNW3RSLS.js +0 -30
  731. package/dist/cli-bundle/chunks/chunk-MEWBSWE3.js +0 -2
  732. package/dist/cli-bundle/chunks/chunk-RBPOO46D.js +0 -20
  733. package/dist/cli-bundle/chunks/chunk-YMLF6QT7.js +0 -234
  734. package/dist/cli-bundle/chunks/register-operations-PDOBQZUJ.js +0 -2
  735. package/dist/cli-bundle/focused-chunks/chunk-2CJWTLQG.js +0 -2
  736. package/dist/cli-bundle/focused-chunks/chunk-B3YW6H2I.js +0 -26
  737. package/dist/cli-bundle/focused-chunks/chunk-GVGFUD52.js +0 -8
  738. package/dist/cli-bundle/focused-chunks/chunk-MJQ253F3.js +0 -2
  739. package/dist/cli-bundle/focused-chunks/chunk-PBCYGO7X.js +0 -3
  740. package/dist/cli-bundle/focused-chunks/chunk-WOEZJUA2.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";