@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
@@ -21,54 +21,54 @@ export { describeExtensionBlueprint, lintExtensionBlueprint };
21
21
  export type { ExtensionBlueprint, ExtensionBlueprintLintCode, ExtensionBlueprintLintFinding, ExtensionBlueprintLintResult, ExtensionBlueprintLintSeverity, LintExtensionBlueprintOptions, };
22
22
  /** Documents the activate extension for test options payload exchanged by command, SDK, and package integrations. */
23
23
  export interface ActivateExtensionForTestOptions {
24
- /** Value that configures or reports name for this contract. */
25
- name?: string;
26
- /** Value that configures or reports layer for this contract. */
27
- layer?: ExtensionLayer;
28
- /** Value that configures or reports capabilities for this contract. */
29
- capabilities?: readonly ExtensionCapability[];
30
- /** Value that configures or reports policy for this contract. */
31
- policy?: ExtensionGovernancePolicy;
24
+ /** Value that configures or reports name for this contract. */
25
+ name?: string;
26
+ /** Value that configures or reports layer for this contract. */
27
+ layer?: ExtensionLayer;
28
+ /** Value that configures or reports capabilities for this contract. */
29
+ capabilities?: readonly ExtensionCapability[];
30
+ /** Value that configures or reports policy for this contract. */
31
+ policy?: ExtensionGovernancePolicy;
32
32
  }
33
33
  /** Documents the deactivate extension for test options payload exchanged by command, SDK, and package integrations. */
34
34
  export interface DeactivateExtensionForTestOptions {
35
- /** Overrides the in-memory extension name (defaults to `manifest.name` or `"test-extension"`). */
36
- name?: string;
37
- /** Overrides the layer recorded for the in-memory extension (defaults to `"project"`). */
38
- layer?: ExtensionLayer;
39
- /** Activation result returned by `activateExtensionForTest`. When provided, an extension whose `activate` failed is skipped — mirroring the host teardown contract that never deactivates a never-initialized extension. Pass the same `name`/`layer` to both helpers so the skip key matches. */
40
- activation?: Pick<ExtensionActivationResult, "failed">;
41
- /** Per-hook teardown bound, forwarded as `deactivate_timeout_ms`. Use `0` (or `Infinity`) to wait indefinitely; omit to keep the host default. */
42
- deactivateTimeoutMs?: number;
35
+ /** Overrides the in-memory extension name (defaults to `manifest.name` or `"test-extension"`). */
36
+ name?: string;
37
+ /** Overrides the layer recorded for the in-memory extension (defaults to `"project"`). */
38
+ layer?: ExtensionLayer;
39
+ /** Activation result returned by `activateExtensionForTest`. When provided, an extension whose `activate` failed is skipped — mirroring the host teardown contract that never deactivates a never-initialized extension. Pass the same `name`/`layer` to both helpers so the skip key matches. */
40
+ activation?: Pick<ExtensionActivationResult, "failed">;
41
+ /** Per-hook teardown bound, forwarded as `deactivate_timeout_ms`. Use `0` (or `Infinity`) to wait indefinitely; omit to keep the host default. */
42
+ deactivateTimeoutMs?: number;
43
43
  }
44
44
  /**
45
45
  * Options for {@link runRegisteredCommandForTest} — the inputs forwarded to a
46
46
  * registered extension command handler when exercising its behavior in a test.
47
47
  */
48
48
  export interface RunRegisteredCommandForTestOptions {
49
- /** Full registered command path to invoke, e.g. `"hello"` or `"todos import"`. Matched against `commands.handlers[].command` after normalization (trimmed, lower-cased, internal whitespace collapsed), mirroring runtime dispatch. */
50
- command: string;
51
- /** Positional arguments forwarded as `context.args` (default: none). */
52
- args?: readonly string[];
53
- /** Parsed flags/options forwarded as `context.options` (default: none). */
54
- options?: Record<string, unknown>;
55
- /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
56
- global?: Partial<GlobalOptions>;
57
- /** Resolved tracker storage root forwarded as `context.pm_root` (default: `""`), normally `<workspace>/.agents/pm`; this is not the workspace root. */
58
- pmRoot?: string;
59
- /** Explicit host SDK override for specialized tests. Mutually exclusive with sdkFactory. */
60
- sdk?: ExtensionCommandSdk;
61
- /** Lazily build a typed host SDK override from the resolved test context. `pmRoot` is the tracker storage root (normally `<workspace>/.agents/pm`), not the workspace root. */
62
- sdkFactory?: (context: {
63
- /** Tracker storage root for tracker data under `.agents/pm`, not the workspace root. */
64
- pmRoot: string;
65
- global: GlobalOptions;
66
- }) => ExtensionCommandSdk;
49
+ /** Full registered command path to invoke, e.g. `"hello"` or `"todos import"`. Matched against `commands.handlers[].command` after normalization (trimmed, lower-cased, internal whitespace collapsed), mirroring runtime dispatch. */
50
+ command: string;
51
+ /** Positional arguments forwarded as `context.args` (default: none). */
52
+ args?: readonly string[];
53
+ /** Parsed flags/options forwarded as `context.options` (default: none). */
54
+ options?: Record<string, unknown>;
55
+ /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
56
+ global?: Partial<GlobalOptions>;
57
+ /** Resolved tracker storage root forwarded as `context.pm_root` (default: `""`), normally `<workspace>/.agents/pm`; this is not the workspace root. */
58
+ pmRoot?: string;
59
+ /** Explicit host SDK override for specialized tests. Mutually exclusive with sdkFactory. */
60
+ sdk?: ExtensionCommandSdk;
61
+ /** Lazily build a typed host SDK override from the resolved test context. `pmRoot` is the tracker storage root (normally `<workspace>/.agents/pm`), not the workspace root. */
62
+ sdkFactory?: (context: {
63
+ /** Tracker storage root for tracker data under `.agents/pm`, not the workspace root. */
64
+ pmRoot: string;
65
+ global: GlobalOptions;
66
+ }) => ExtensionCommandSdk;
67
67
  }
68
68
  /** Options for invoking a registered transactional mutation guard in package tests. */
69
69
  export interface RunRegisteredMutationGuardForTestOptions {
70
- /** Synthetic proposed mutation context, including a host-bound read-only SDK. */
71
- context: BeforeMutationHookContext;
70
+ /** Synthetic proposed mutation context, including a host-bound read-only SDK. */
71
+ context: BeforeMutationHookContext;
72
72
  }
73
73
  /**
74
74
  * Options for {@link runRegisteredHookForTest} — the lifecycle `kind` to fire and
@@ -80,20 +80,20 @@ export interface RunRegisteredMutationGuardForTestOptions {
80
80
  * pass an index context to a read hook.
81
81
  */
82
82
  export type RunRegisteredHookForTestOptions = {
83
- kind: "before_command";
84
- context: BeforeCommandHookContext;
83
+ kind: "before_command";
84
+ context: BeforeCommandHookContext;
85
85
  } | {
86
- kind: "after_command";
87
- context: AfterCommandHookContext;
86
+ kind: "after_command";
87
+ context: AfterCommandHookContext;
88
88
  } | {
89
- kind: "on_read";
90
- context: OnReadHookContext;
89
+ kind: "on_read";
90
+ context: OnReadHookContext;
91
91
  } | {
92
- kind: "on_write";
93
- context: OnWriteHookContext;
92
+ kind: "on_write";
93
+ context: OnWriteHookContext;
94
94
  } | {
95
- kind: "on_index";
96
- context: OnIndexHookContext;
95
+ kind: "on_index";
96
+ context: OnIndexHookContext;
97
97
  };
98
98
  /**
99
99
  * Maps each invokable search-provider operation to the context type its function
@@ -103,16 +103,16 @@ export type RunRegisteredHookForTestOptions = {
103
103
  * `queryExpansion`, and `rerank`.
104
104
  */
105
105
  export interface SearchProviderOperationContexts {
106
- /** Value that configures or reports query for this contract. */
107
- query: SearchProviderQueryContext;
108
- /** Value that configures or reports embed for this contract. */
109
- embed: SearchProviderEmbedContext;
110
- /** Value that configures or reports embed batch for this contract. */
111
- embedBatch: SearchProviderEmbedBatchContext;
112
- /** Value that configures or reports query expansion for this contract. */
113
- queryExpansion: SearchProviderQueryExpansionContext;
114
- /** Value that configures or reports rerank for this contract. */
115
- rerank: SearchProviderRerankContext;
106
+ /** Value that configures or reports query for this contract. */
107
+ query: SearchProviderQueryContext;
108
+ /** Value that configures or reports embed for this contract. */
109
+ embed: SearchProviderEmbedContext;
110
+ /** Value that configures or reports embed batch for this contract. */
111
+ embedBatch: SearchProviderEmbedBatchContext;
112
+ /** Value that configures or reports query expansion for this contract. */
113
+ queryExpansion: SearchProviderQueryExpansionContext;
114
+ /** Value that configures or reports rerank for this contract. */
115
+ rerank: SearchProviderRerankContext;
116
116
  }
117
117
  /**
118
118
  * Maps each invokable search-provider operation to the result type its function
@@ -120,16 +120,16 @@ export interface SearchProviderOperationContexts {
120
120
  * type from the chosen `operation` instead of a union the caller must narrow.
121
121
  */
122
122
  export interface SearchProviderOperationResults {
123
- /** Value that configures or reports query for this contract. */
124
- query: SearchProviderQueryResult;
125
- /** Value that configures or reports embed for this contract. */
126
- embed: number[];
127
- /** Value that configures or reports embed batch for this contract. */
128
- embedBatch: number[][];
129
- /** Value that configures or reports query expansion for this contract. */
130
- queryExpansion: SearchProviderQueryExpansionResult;
131
- /** Value that configures or reports rerank for this contract. */
132
- rerank: SearchProviderRerankResult;
123
+ /** Value that configures or reports query for this contract. */
124
+ query: SearchProviderQueryResult;
125
+ /** Value that configures or reports embed for this contract. */
126
+ embed: number[];
127
+ /** Value that configures or reports embed batch for this contract. */
128
+ embedBatch: number[][];
129
+ /** Value that configures or reports query expansion for this contract. */
130
+ queryExpansion: SearchProviderQueryExpansionResult;
131
+ /** Value that configures or reports rerank for this contract. */
132
+ rerank: SearchProviderRerankResult;
133
133
  }
134
134
  /**
135
135
  * Options for {@link runRegisteredSearchProviderForTest}: the registered
@@ -140,14 +140,14 @@ export interface SearchProviderOperationResults {
140
140
  * {@link SearchProviderRerankContext}, and so on.
141
141
  */
142
142
  export type RunRegisteredSearchProviderForTestOptions = {
143
- [Operation in keyof SearchProviderOperationContexts]: {
144
- /** Registered provider name to resolve, matched case-insensitively as the host does. */
145
- provider: string;
146
- /** Provider operation to invoke. */
147
- operation: Operation;
148
- /** Synthetic context handed to the resolved operation function. */
149
- context: SearchProviderOperationContexts[Operation];
150
- };
143
+ [Operation in keyof SearchProviderOperationContexts]: {
144
+ /** Registered provider name to resolve, matched case-insensitively as the host does. */
145
+ provider: string;
146
+ /** Provider operation to invoke. */
147
+ operation: Operation;
148
+ /** Synthetic context handed to the resolved operation function. */
149
+ context: SearchProviderOperationContexts[Operation];
150
+ };
151
151
  }[keyof SearchProviderOperationContexts];
152
152
  /**
153
153
  * Maps each invokable vector-store-adapter operation to the context type its
@@ -156,12 +156,12 @@ export type RunRegisteredSearchProviderForTestOptions = {
156
156
  * registered adapter: nearest-neighbour `query`, `upsert`, and `delete`.
157
157
  */
158
158
  export interface VectorStoreAdapterOperationContexts {
159
- /** Value that configures or reports query for this contract. */
160
- query: VectorStoreQueryContext;
161
- /** Value that configures or reports upsert for this contract. */
162
- upsert: VectorStoreUpsertContext;
163
- /** Value that configures or reports delete for this contract. */
164
- delete: VectorStoreDeleteContext;
159
+ /** Value that configures or reports query for this contract. */
160
+ query: VectorStoreQueryContext;
161
+ /** Value that configures or reports upsert for this contract. */
162
+ upsert: VectorStoreUpsertContext;
163
+ /** Value that configures or reports delete for this contract. */
164
+ delete: VectorStoreDeleteContext;
165
165
  }
166
166
  /**
167
167
  * Maps each invokable vector-store-adapter operation to the result type its
@@ -170,12 +170,12 @@ export interface VectorStoreAdapterOperationContexts {
170
170
  * throwing, so their result is `unknown` and typically ignored.
171
171
  */
172
172
  export interface VectorStoreAdapterOperationResults {
173
- /** Value that configures or reports query for this contract. */
174
- query: VectorStoreQueryHit[];
175
- /** Value that configures or reports upsert for this contract. */
176
- upsert: unknown;
177
- /** Value that configures or reports delete for this contract. */
178
- delete: unknown;
173
+ /** Value that configures or reports query for this contract. */
174
+ query: VectorStoreQueryHit[];
175
+ /** Value that configures or reports upsert for this contract. */
176
+ upsert: unknown;
177
+ /** Value that configures or reports delete for this contract. */
178
+ delete: unknown;
179
179
  }
180
180
  /**
181
181
  * Options for {@link runRegisteredVectorStoreAdapterForTest}: the registered
@@ -186,26 +186,26 @@ export interface VectorStoreAdapterOperationResults {
186
186
  * {@link VectorStoreDeleteContext}, and so on.
187
187
  */
188
188
  export type RunRegisteredVectorStoreAdapterForTestOptions = {
189
- [Operation in keyof VectorStoreAdapterOperationContexts]: {
190
- /** Registered adapter name to resolve, matched case-insensitively as the host does. */
191
- adapter: string;
192
- /** Adapter operation to invoke. */
193
- operation: Operation;
194
- /** Synthetic context handed to the resolved operation function. */
195
- context: VectorStoreAdapterOperationContexts[Operation];
196
- };
189
+ [Operation in keyof VectorStoreAdapterOperationContexts]: {
190
+ /** Registered adapter name to resolve, matched case-insensitively as the host does. */
191
+ adapter: string;
192
+ /** Adapter operation to invoke. */
193
+ operation: Operation;
194
+ /** Synthetic context handed to the resolved operation function. */
195
+ context: VectorStoreAdapterOperationContexts[Operation];
196
+ };
197
197
  }[keyof VectorStoreAdapterOperationContexts];
198
198
  /**
199
199
  * Options for {@link runRegisteredMigrationForTest}: which registered migration
200
200
  * to invoke and the workspace root its run context reports.
201
201
  */
202
202
  export interface RunRegisteredMigrationForTestOptions {
203
- /** Registered migration id to resolve, matched case-insensitively against `definition.id`. */
204
- migration: string;
205
- /** Optional extension name to disambiguate when several extensions register the same id. */
206
- extensionName?: string;
207
- /** Resolved pm workspace root forwarded as `context.pm_root` (default `""`). */
208
- pmRoot?: string;
203
+ /** Registered migration id to resolve, matched case-insensitively against `definition.id`. */
204
+ migration: string;
205
+ /** Optional extension name to disambiguate when several extensions register the same id. */
206
+ extensionName?: string;
207
+ /** Resolved pm workspace root forwarded as `context.pm_root` (default `""`). */
208
+ pmRoot?: string;
209
209
  }
210
210
  /**
211
211
  * Options for {@link runRegisteredImporterForTest} — the registered importer name
@@ -217,18 +217,18 @@ export interface RunRegisteredMigrationForTestOptions {
217
217
  * path internally, so authors never hand-build it.
218
218
  */
219
219
  export interface RunRegisteredImporterForTestOptions {
220
- /** Registered importer name to resolve, e.g. `"csv"` for a `"csv import"` handler. */
221
- importer: string;
222
- /** Optional extension name to disambiguate when several extensions register the same importer. */
223
- extensionName?: string;
224
- /** Positional arguments forwarded as `context.args` (default: none). */
225
- args?: readonly string[];
226
- /** Parsed flags/options forwarded as `context.options` (default: none). */
227
- options?: Record<string, unknown>;
228
- /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
229
- global?: Partial<GlobalOptions>;
230
- /** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
231
- pmRoot?: string;
220
+ /** Registered importer name to resolve, e.g. `"csv"` for a `"csv import"` handler. */
221
+ importer: string;
222
+ /** Optional extension name to disambiguate when several extensions register the same importer. */
223
+ extensionName?: string;
224
+ /** Positional arguments forwarded as `context.args` (default: none). */
225
+ args?: readonly string[];
226
+ /** Parsed flags/options forwarded as `context.options` (default: none). */
227
+ options?: Record<string, unknown>;
228
+ /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
229
+ global?: Partial<GlobalOptions>;
230
+ /** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
231
+ pmRoot?: string;
232
232
  }
233
233
  /**
234
234
  * Options for {@link runRegisteredExporterForTest} — the registered exporter name
@@ -240,55 +240,55 @@ export interface RunRegisteredImporterForTestOptions {
240
240
  * path internally, so authors never hand-build it.
241
241
  */
242
242
  export interface RunRegisteredExporterForTestOptions {
243
- /** Registered exporter name to resolve, e.g. `"csv"` for a `"csv export"` handler. */
244
- exporter: string;
245
- /** Optional extension name to disambiguate when several extensions register the same exporter. */
246
- extensionName?: string;
247
- /** Positional arguments forwarded as `context.args` (default: none). */
248
- args?: readonly string[];
249
- /** Parsed flags/options forwarded as `context.options` (default: none). */
250
- options?: Record<string, unknown>;
251
- /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
252
- global?: Partial<GlobalOptions>;
253
- /** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
254
- pmRoot?: string;
243
+ /** Registered exporter name to resolve, e.g. `"csv"` for a `"csv export"` handler. */
244
+ exporter: string;
245
+ /** Optional extension name to disambiguate when several extensions register the same exporter. */
246
+ extensionName?: string;
247
+ /** Positional arguments forwarded as `context.args` (default: none). */
248
+ args?: readonly string[];
249
+ /** Parsed flags/options forwarded as `context.options` (default: none). */
250
+ options?: Record<string, unknown>;
251
+ /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
252
+ global?: Partial<GlobalOptions>;
253
+ /** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
254
+ pmRoot?: string;
255
255
  }
256
256
  /** Documents the extension deactivation expectation payload exchanged by command, SDK, and package integrations. */
257
257
  export interface ExtensionDeactivationExpectation {
258
- /** Expected count of extensions whose `deactivate` ran without throwing (default `1`). */
259
- deactivated?: number;
260
- /** Expected count of teardown failures (default `0`). */
261
- failed?: number;
258
+ /** Expected count of extensions whose `deactivate` ran without throwing (default `1`). */
259
+ deactivated?: number;
260
+ /** Expected count of teardown failures (default `0`). */
261
+ failed?: number;
262
262
  }
263
263
  type NamedRegistrationExpectation<TLegacyKey extends string, TValue, TDetails extends object = Record<never, never>> = TDetails & (({
264
- name: TValue;
264
+ name: TValue;
265
265
  } & Partial<Record<TLegacyKey, TValue>>) | ({
266
- name?: TValue;
266
+ name?: TValue;
267
267
  } & Record<TLegacyKey, TValue>));
268
268
  /** Documents the registered command contract expectation payload exchanged by command, SDK, and package integrations. `name` is canonical; `command` remains a backward-compatible alias. */
269
269
  export type RegisteredCommandContractExpectation = NamedRegistrationExpectation<"command", string, {
270
- /** Value that configures or reports action for this contract. */
271
- action?: string;
272
- /** Value that configures or reports extension name for this contract. */
273
- extensionName?: string;
274
- /** Value that configures or reports arguments for this contract. */
275
- arguments?: string[];
276
- /** Value that configures or reports flags for this contract. */
277
- flags?: string[];
270
+ /** Value that configures or reports action for this contract. */
271
+ action?: string;
272
+ /** Value that configures or reports extension name for this contract. */
273
+ extensionName?: string;
274
+ /** Value that configures or reports arguments for this contract. */
275
+ arguments?: string[];
276
+ /** Value that configures or reports flags for this contract. */
277
+ flags?: string[];
278
278
  }>;
279
279
  /** Documents the registered command contract assertion payload exchanged by command, SDK, and package integrations. */
280
280
  export interface RegisteredCommandContractAssertion {
281
- /** Value that configures or reports command for this contract. */
282
- command: RegisteredExtensionCommandDefinition;
283
- /** Value that configures or reports flags for this contract. */
284
- flags: FlagDefinition[];
281
+ /** Value that configures or reports command for this contract. */
282
+ command: RegisteredExtensionCommandDefinition;
283
+ /** Value that configures or reports flags for this contract. */
284
+ flags: FlagDefinition[];
285
285
  }
286
286
  /** Documents the registered flags expectation payload exchanged by command, SDK, and package integrations. */
287
287
  export type RegisteredFlagsExpectation = NamedRegistrationExpectation<"targetCommand", string, {
288
- /** Value that configures or reports extension name for this contract. */
289
- extensionName?: string;
290
- /** Value that configures or reports flags for this contract. */
291
- flags?: string[];
288
+ /** Value that configures or reports extension name for this contract. */
289
+ extensionName?: string;
290
+ /** Value that configures or reports flags for this contract. */
291
+ flags?: string[];
292
292
  }>;
293
293
  /** Public hook lifecycle kinds an extension can register through `api.hooks.*`. */
294
294
  export type RegisteredHookKind = "before_command" | "before_mutation" | "after_command" | "on_read" | "on_write" | "on_index";
@@ -296,141 +296,141 @@ declare const HOOK_KIND_TO_REGISTRY_FIELD: Record<RegisteredHookKind, keyof Exte
296
296
  type RegisteredHookEntry<TKind extends RegisteredHookKind> = NonNullable<ExtensionHookRegistry[(typeof HOOK_KIND_TO_REGISTRY_FIELD)[TKind]]>[number];
297
297
  /** Documents the registered hook expectation payload exchanged by command, SDK, and package integrations. */
298
298
  export interface RegisteredHookExpectation {
299
- /** Value that configures or reports kind for this contract. */
300
- kind: RegisteredHookKind;
301
- /** Value that configures or reports extension name for this contract. */
302
- extensionName?: string;
299
+ /** Value that configures or reports kind for this contract. */
300
+ kind: RegisteredHookKind;
301
+ /** Value that configures or reports extension name for this contract. */
302
+ extensionName?: string;
303
303
  }
304
304
  /** Documents the registered search provider expectation payload exchanged by command, SDK, and package integrations. */
305
305
  export type RegisteredSearchProviderExpectation = NamedRegistrationExpectation<"provider", string, {
306
- /** Value that configures or reports extension name for this contract. */
307
- extensionName?: string;
306
+ /** Value that configures or reports extension name for this contract. */
307
+ extensionName?: string;
308
308
  }>;
309
309
  /** Documents the registered vector store adapter expectation payload exchanged by command, SDK, and package integrations. */
310
310
  export type RegisteredVectorStoreAdapterExpectation = NamedRegistrationExpectation<"adapter", string, {
311
- /** Value that configures or reports extension name for this contract. */
312
- extensionName?: string;
311
+ /** Value that configures or reports extension name for this contract. */
312
+ extensionName?: string;
313
313
  }>;
314
314
  /** Documents the registered importer expectation payload exchanged by command, SDK, and package integrations. */
315
315
  export type RegisteredImporterExpectation = NamedRegistrationExpectation<"importer", string, {
316
- /** Value that configures or reports extension name for this contract. */
317
- extensionName?: string;
316
+ /** Value that configures or reports extension name for this contract. */
317
+ extensionName?: string;
318
318
  }>;
319
319
  /** Documents the registered exporter expectation payload exchanged by command, SDK, and package integrations. */
320
320
  export type RegisteredExporterExpectation = NamedRegistrationExpectation<"exporter", string, {
321
- /** Value that configures or reports extension name for this contract. */
322
- extensionName?: string;
321
+ /** Value that configures or reports extension name for this contract. */
322
+ extensionName?: string;
323
323
  }>;
324
324
  /** Documents the registered item field expectation payload exchanged by command, SDK, and package integrations. */
325
325
  export type RegisteredItemFieldExpectation = NamedRegistrationExpectation<"field", string, {
326
- /** Value that configures or reports extension name for this contract. */
327
- extensionName?: string;
328
- /** Schema type that determines the shape and validation rules for this value. */
329
- type?: SchemaFieldDefinition["type"];
326
+ /** Value that configures or reports extension name for this contract. */
327
+ extensionName?: string;
328
+ /** Schema type that determines the shape and validation rules for this value. */
329
+ type?: SchemaFieldDefinition["type"];
330
330
  }>;
331
331
  /** Documents the registered item field assertion payload exchanged by command, SDK, and package integrations. */
332
332
  export interface RegisteredItemFieldAssertion {
333
- /** Value that configures or reports registration for this contract. */
334
- registration: RegisteredExtensionSchemaFieldDefinitions;
335
- /** Value that configures or reports field for this contract. */
336
- field: SchemaFieldDefinition;
333
+ /** Value that configures or reports registration for this contract. */
334
+ registration: RegisteredExtensionSchemaFieldDefinitions;
335
+ /** Value that configures or reports field for this contract. */
336
+ field: SchemaFieldDefinition;
337
337
  }
338
338
  /** Documents the registered item type expectation payload exchanged by command, SDK, and package integrations. */
339
339
  export type RegisteredItemTypeExpectation = NamedRegistrationExpectation<"itemType", string, {
340
- /** Value that configures or reports extension name for this contract. */
341
- extensionName?: string;
342
- /** Value that configures or reports folder for this contract. */
343
- folder?: string;
340
+ /** Value that configures or reports extension name for this contract. */
341
+ extensionName?: string;
342
+ /** Value that configures or reports folder for this contract. */
343
+ folder?: string;
344
344
  }>;
345
345
  /** Documents the registered item type assertion payload exchanged by command, SDK, and package integrations. */
346
346
  export interface RegisteredItemTypeAssertion {
347
- /** Value that configures or reports registration for this contract. */
348
- registration: RegisteredExtensionSchemaItemTypeDefinitions;
349
- /** Schema type that determines the shape and validation rules for this value. */
350
- itemType: SchemaItemTypeDefinition;
347
+ /** Value that configures or reports registration for this contract. */
348
+ registration: RegisteredExtensionSchemaItemTypeDefinitions;
349
+ /** Schema type that determines the shape and validation rules for this value. */
350
+ itemType: SchemaItemTypeDefinition;
351
351
  }
352
352
  /** Documents the registered command override expectation payload exchanged by command, SDK, and package integrations. */
353
353
  export type RegisteredCommandOverrideExpectation = NamedRegistrationExpectation<"command", string, {
354
- /** Value that configures or reports extension name for this contract. */
355
- extensionName?: string;
354
+ /** Value that configures or reports extension name for this contract. */
355
+ extensionName?: string;
356
356
  }>;
357
357
  /** Documents the registered parser override expectation payload exchanged by command, SDK, and package integrations. */
358
358
  export type RegisteredParserOverrideExpectation = NamedRegistrationExpectation<"command", string, {
359
- /** Value that configures or reports extension name for this contract. */
360
- extensionName?: string;
359
+ /** Value that configures or reports extension name for this contract. */
360
+ extensionName?: string;
361
361
  }>;
362
362
  /** Documents the registered preflight override expectation payload exchanged by command, SDK, and package integrations. */
363
363
  export interface RegisteredPreflightOverrideExpectation {
364
- /** Value that configures or reports extension name for this contract. */
365
- extensionName?: string;
364
+ /** Value that configures or reports extension name for this contract. */
365
+ extensionName?: string;
366
366
  }
367
367
  /** Documents the registered renderer override expectation payload exchanged by command, SDK, and package integrations. */
368
368
  export type RegisteredRendererOverrideExpectation = NamedRegistrationExpectation<"format", OutputRendererFormat, {
369
- /** Value that configures or reports extension name for this contract. */
370
- extensionName?: string;
369
+ /** Value that configures or reports extension name for this contract. */
370
+ extensionName?: string;
371
371
  }>;
372
372
  /** Documents the registered service override expectation payload exchanged by command, SDK, and package integrations. */
373
373
  export type RegisteredServiceOverrideExpectation = NamedRegistrationExpectation<"service", ExtensionServiceName, {
374
- /** Value that configures or reports extension name for this contract. */
375
- extensionName?: string;
374
+ /** Value that configures or reports extension name for this contract. */
375
+ extensionName?: string;
376
376
  }>;
377
377
  /** Documents the registered migration expectation payload exchanged by command, SDK, and package integrations. */
378
378
  export type RegisteredMigrationExpectation = NamedRegistrationExpectation<"migration", string, {
379
- /** Value that configures or reports extension name for this contract. */
380
- extensionName?: string;
381
- /** Value that configures or reports mandatory for this contract. */
382
- mandatory?: boolean;
379
+ /** Value that configures or reports extension name for this contract. */
380
+ extensionName?: string;
381
+ /** Value that configures or reports mandatory for this contract. */
382
+ mandatory?: boolean;
383
383
  }>;
384
384
  /** Documents the registered project-profile expectation payload exchanged by command, SDK, and package integrations. */
385
385
  export type RegisteredProfileExpectation = NamedRegistrationExpectation<"profile", string, {
386
- /** Restrict the match to a single extension when several are active. */
387
- extensionName?: string;
386
+ /** Restrict the match to a single extension when several are active. */
387
+ extensionName?: string;
388
388
  }>;
389
389
  /** Documents the registered project-profile assertion payload exchanged by command, SDK, and package integrations. */
390
390
  export interface RegisteredProfileAssertion {
391
- /** The matching registration entry. */
392
- registration: RegisteredExtensionProjectProfile;
393
- /** The registered profile definition. */
394
- profile: ProjectProfileDefinition;
391
+ /** The matching registration entry. */
392
+ registration: RegisteredExtensionProjectProfile;
393
+ /** The registered profile definition. */
394
+ profile: ProjectProfileDefinition;
395
395
  }
396
396
  /** Documents the extension capability usage expectation payload exchanged by command, SDK, and package integrations. */
397
397
  export interface ExtensionCapabilityUsageExpectation {
398
- /** Capabilities the manifest declares. Mirror `manifest.capabilities` here so the assertion fails when the manifest grants more than the code uses. */
399
- declared: readonly ExtensionCapability[];
400
- /** Restrict reconciliation to a single extension when the activation has several. */
401
- extensionName?: string;
402
- /** Capabilities allowed to be declared without being exercised (e.g. ones a runtime registers only behind a config flag). These are excluded from the least-privilege failure. */
403
- allowUnused?: readonly ExtensionCapability[];
398
+ /** Capabilities the manifest declares. Mirror `manifest.capabilities` here so the assertion fails when the manifest grants more than the code uses. */
399
+ declared: readonly ExtensionCapability[];
400
+ /** Restrict reconciliation to a single extension when the activation has several. */
401
+ extensionName?: string;
402
+ /** Capabilities allowed to be declared without being exercised (e.g. ones a runtime registers only behind a config flag). These are excluded from the least-privilege failure. */
403
+ allowUnused?: readonly ExtensionCapability[];
404
404
  }
405
405
  /** Documents the extension capability usage assertion payload exchanged by command, SDK, and package integrations. */
406
406
  export interface ExtensionCapabilityUsageAssertion {
407
- /** Declared capabilities considered, sorted and de-duplicated. */
408
- declared: ExtensionCapability[];
409
- /** Capabilities the extension actually registered against, sorted. */
410
- used: ExtensionCapability[];
411
- /** Declared capabilities with no matching registration after the allowlist. */
412
- unused: ExtensionCapability[];
407
+ /** Declared capabilities considered, sorted and de-duplicated. */
408
+ declared: ExtensionCapability[];
409
+ /** Capabilities the extension actually registered against, sorted. */
410
+ used: ExtensionCapability[];
411
+ /** Declared capabilities with no matching registration after the allowlist. */
412
+ unused: ExtensionCapability[];
413
413
  }
414
414
  /** Restricts package manifest resource expectation values accepted by command, SDK, and storage contracts. */
415
415
  export type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind, readonly string[]>>;
416
416
  /** Documents the package manifest expectation payload exchanged by command, SDK, and package integrations. */
417
417
  export interface PackageManifestExpectation {
418
- /** Value that configures or reports package name for this contract. */
419
- packageName?: string;
420
- /** Value that configures or reports aliases for this contract. */
421
- aliases?: readonly string[];
422
- /** Value that configures or reports resources for this contract. */
423
- resources?: PackageManifestResourceExpectation;
418
+ /** Value that configures or reports package name for this contract. */
419
+ packageName?: string;
420
+ /** Value that configures or reports aliases for this contract. */
421
+ aliases?: readonly string[];
422
+ /** Value that configures or reports resources for this contract. */
423
+ resources?: PackageManifestResourceExpectation;
424
424
  }
425
425
  /**
426
426
  * Options for {@link ExtensionTestHarness.renderMarkdown}.
427
427
  */
428
428
  export interface RenderExtensionHarnessMarkdownOptions extends ExtensionSurfaceMarkdownOptions {
429
- /**
429
+ /**
430
430
  * Restrict the rendered summary to one activated extension by name. Defaults
431
431
  * to the full activation union, matching {@link ExtensionTestHarness.activationSummary}.
432
432
  */
433
- extensionName?: string;
433
+ extensionName?: string;
434
434
  }
435
435
  /**
436
436
  * Activate one in-memory extension module for package tests.
@@ -586,9 +586,9 @@ export declare function runRegisteredServiceOverrideForTest(services: ExtensionS
586
586
  * wiring bug in the test rather than a behavior under test.
587
587
  */
588
588
  export declare function runRegisteredSearchProviderForTest<Operation extends keyof SearchProviderOperationContexts>(registrations: ExtensionRegistrationRegistry, options: {
589
- provider: string;
590
- operation: Operation;
591
- context: SearchProviderOperationContexts[Operation];
589
+ provider: string;
590
+ operation: Operation;
591
+ context: SearchProviderOperationContexts[Operation];
592
592
  }): Promise<SearchProviderOperationResults[Operation]>;
593
593
  /**
594
594
  * Invoke an operation of a registered vector store adapter through the same name
@@ -609,9 +609,9 @@ export declare function runRegisteredSearchProviderForTest<Operation extends key
609
609
  * the requested operation.
610
610
  */
611
611
  export declare function runRegisteredVectorStoreAdapterForTest<Operation extends keyof VectorStoreAdapterOperationContexts>(registrations: ExtensionRegistrationRegistry, options: {
612
- adapter: string;
613
- operation: Operation;
614
- context: VectorStoreAdapterOperationContexts[Operation];
612
+ adapter: string;
613
+ operation: Operation;
614
+ context: VectorStoreAdapterOperationContexts[Operation];
615
615
  }): Promise<VectorStoreAdapterOperationResults[Operation]>;
616
616
  /**
617
617
  * Invoke a registered schema migration's `run` function through the same runtime
@@ -703,7 +703,7 @@ export declare function assertRegisteredFlags(registrations: ExtensionRegistrati
703
703
  * registration registry, so this helper accepts an `ExtensionHookRegistry`.
704
704
  */
705
705
  export declare function assertRegisteredHook<TKind extends RegisteredHookKind>(hooks: ExtensionHookRegistry, expectation: RegisteredHookExpectation & {
706
- kind: TKind;
706
+ kind: TKind;
707
707
  }): RegisteredHookEntry<TKind>;
708
708
  /** Assert that an activated extension registration registry contains a search provider with the expected name (optionally scoped to a specific extension). */
709
709
  export declare function assertRegisteredSearchProvider(registrations: ExtensionRegistrationRegistry, expectation: RegisteredSearchProviderExpectation): RegisteredExtensionSearchProvider;
@@ -815,8 +815,8 @@ export declare function assertExtensionCapabilityUsage(activation: ExtensionActi
815
815
  export declare function assertExtensionBlueprint(blueprint: ExtensionBlueprint, options?: LintExtensionBlueprintOptions): ExtensionBlueprintLintResult;
816
816
  /** Options for {@link assertProjectProfile}. */
817
817
  export interface AssertProjectProfileOptions {
818
- /** Also throw when the profile produces `warning`-severity findings (e.g. a workflow transition referencing a status no profile or built-in defines). Off by default so warnings stay advisory; turn on for strict CI gates. */
819
- strict?: boolean;
818
+ /** Also throw when the profile produces `warning`-severity findings (e.g. a workflow transition referencing a status no profile or built-in defines). Off by default so warnings stay advisory; turn on for strict CI gates. */
819
+ strict?: boolean;
820
820
  }
821
821
  /**
822
822
  * Assert a {@link ProjectProfileDefinition} is internally consistent in a test,
@@ -837,16 +837,16 @@ export declare function assertProjectProfile(profile: ProjectProfileDefinition,
837
837
  * assertion throws otherwise).
838
838
  */
839
839
  export interface ExtensionManifestBlueprintMatch {
840
- /** The least-privilege capability set the blueprint exercises (from `deriveExtensionCapabilities`). */
841
- used: ExtensionCapability[];
842
- /** The manifest's declared capabilities, legacy-alias resolved and normalized. */
843
- declared: ExtensionCapability[];
844
- /** Capabilities the blueprint uses but the manifest omits — would crash activation. Empty on success. */
845
- missing: ExtensionCapability[];
846
- /** Capabilities the manifest declares but no surface exercises — violates least privilege. Empty on success. */
847
- unused: ExtensionCapability[];
848
- /** Every lint finding for the blueprint, so callers can inspect advisory warnings. */
849
- findings: ExtensionBlueprintLintFinding[];
840
+ /** The least-privilege capability set the blueprint exercises (from `deriveExtensionCapabilities`). */
841
+ used: ExtensionCapability[];
842
+ /** The manifest's declared capabilities, legacy-alias resolved and normalized. */
843
+ declared: ExtensionCapability[];
844
+ /** Capabilities the blueprint uses but the manifest omits — would crash activation. Empty on success. */
845
+ missing: ExtensionCapability[];
846
+ /** Capabilities the manifest declares but no surface exercises — violates least privilege. Empty on success. */
847
+ unused: ExtensionCapability[];
848
+ /** Every lint finding for the blueprint, so callers can inspect advisory warnings. */
849
+ findings: ExtensionBlueprintLintFinding[];
850
850
  }
851
851
  /**
852
852
  * Strictly assert a manifest's `capabilities` equal the least-privilege set a
@@ -922,100 +922,100 @@ export declare function assertExtensionPreflight(blueprint: ExtensionBlueprint,
922
922
  * the standalone helpers for any surface not covered by a convenience method.
923
923
  */
924
924
  export interface ExtensionTestHarness {
925
- /** The in-memory extension module supplied to {@link createExtensionTestHarness}. */
926
- readonly module: unknown;
927
- /** Resolved extension name (manifest name, explicit override, or `"test-extension"`). */
928
- readonly name: string;
929
- /** Layer recorded for the in-memory extension (defaults to `"project"`). */
930
- readonly layer: ExtensionLayer;
931
- /** The underlying activation result; use it to reach standalone helpers directly. */
932
- readonly activation: ExtensionActivationResult;
933
- /** Bound {@link describeExtensionActivation} over the whole `activation`. */
934
- activationSummary(options?: DescribeExtensionActivationOptions): ExtensionActivationSummary;
935
- /**
925
+ /** The in-memory extension module supplied to {@link createExtensionTestHarness}. */
926
+ readonly module: unknown;
927
+ /** Resolved extension name (manifest name, explicit override, or `"test-extension"`). */
928
+ readonly name: string;
929
+ /** Layer recorded for the in-memory extension (defaults to `"project"`). */
930
+ readonly layer: ExtensionLayer;
931
+ /** The underlying activation result; use it to reach standalone helpers directly. */
932
+ readonly activation: ExtensionActivationResult;
933
+ /** Bound {@link describeExtensionActivation} over the whole `activation`. */
934
+ activationSummary(options?: DescribeExtensionActivationOptions): ExtensionActivationSummary;
935
+ /**
936
936
  * Bound {@link renderExtensionSurfaceMarkdown} over {@link activationSummary},
937
937
  * so tests and README generators can produce deterministic surface docs from
938
938
  * the same harness they use for assert/run coverage.
939
939
  */
940
- renderMarkdown(options?: RenderExtensionHarnessMarkdownOptions): string;
941
- /** Bound {@link assertRegisteredCommandContract} over `activation.registrations`. */
942
- assertCommandContract(expectation: RegisteredCommandContractExpectation): RegisteredCommandContractAssertion;
943
- /** Bound {@link assertRegisteredFlags} over `activation.registrations`. */
944
- assertFlags(expectation: RegisteredFlagsExpectation): RegisteredExtensionFlagDefinitions;
945
- /** Bound {@link assertRegisteredItemField} over `activation.registrations`. */
946
- assertItemField(expectation: RegisteredItemFieldExpectation): RegisteredItemFieldAssertion;
947
- /** Bound {@link assertRegisteredItemType} over `activation.registrations`. */
948
- assertItemType(expectation: RegisteredItemTypeExpectation): RegisteredItemTypeAssertion;
949
- /** Bound {@link assertRegisteredProfile} over `activation.registrations`. */
950
- assertProfile(expectation: RegisteredProfileExpectation): RegisteredProfileAssertion;
951
- /** Bound {@link assertRegisteredHook} over `activation.hooks`. */
952
- assertHook<TKind extends RegisteredHookKind>(expectation: RegisteredHookExpectation & {
953
- kind: TKind;
954
- }): RegisteredHookEntry<TKind>;
955
- /** Bound {@link assertRegisteredCommandOverride} over `activation.commands`. */
956
- assertCommandOverride(expectation: RegisteredCommandOverrideExpectation): RegisteredExtensionCommandOverride;
957
- /** Bound {@link assertRegisteredParserOverride} over `activation.parsers`. */
958
- assertParserOverride(expectation: RegisteredParserOverrideExpectation): RegisteredExtensionParserOverride;
959
- /** Bound {@link assertRegisteredPreflightOverride} over `activation.preflight`. */
960
- assertPreflightOverride(expectation?: RegisteredPreflightOverrideExpectation): RegisteredExtensionPreflightOverride;
961
- /** Bound {@link assertRegisteredRendererOverride} over `activation.renderers`. */
962
- assertRendererOverride(expectation: RegisteredRendererOverrideExpectation): RegisteredExtensionRendererOverride;
963
- /** Bound {@link assertRegisteredServiceOverride} over `activation.services`. */
964
- assertServiceOverride(expectation: RegisteredServiceOverrideExpectation): RegisteredExtensionServiceOverride;
965
- /** Bound {@link assertRegisteredSearchProvider} over `activation.registrations`. */
966
- assertSearchProvider(expectation: RegisteredSearchProviderExpectation): RegisteredExtensionSearchProvider;
967
- /** Bound {@link assertRegisteredVectorStoreAdapter} over `activation.registrations`. */
968
- assertVectorStoreAdapter(expectation: RegisteredVectorStoreAdapterExpectation): RegisteredExtensionVectorStoreAdapter;
969
- /** Bound {@link assertRegisteredImporter} over `activation.registrations`. */
970
- assertImporter(expectation: RegisteredImporterExpectation): RegisteredExtensionImporter;
971
- /** Bound {@link assertRegisteredExporter} over `activation.registrations`. */
972
- assertExporter(expectation: RegisteredExporterExpectation): RegisteredExtensionExporter;
973
- /** Bound {@link assertRegisteredMigration} over `activation.registrations`. */
974
- assertMigration(expectation: RegisteredMigrationExpectation): RegisteredExtensionSchemaMigrationDefinition;
975
- /** Bound {@link assertExtensionCapabilityUsage} over the whole `activation`. */
976
- assertCapabilityUsage(expectation: ExtensionCapabilityUsageExpectation): ExtensionCapabilityUsageAssertion;
977
- /** Bound {@link runRegisteredCommandForTest} over `activation.commands`. */
978
- runCommand(options: RunRegisteredCommandForTestOptions): Promise<CommandHandlerResult>;
979
- /** Bound {@link runRegisteredHookForTest} over `activation.hooks`. */
980
- runHook(options: RunRegisteredHookForTestOptions): Promise<string[]>;
981
- /** Bound transactional mutation-guard runner over `activation.hooks`. */
982
- runMutationGuard(options: RunRegisteredMutationGuardForTestOptions): Promise<void>;
983
- /** Bound {@link runRegisteredCommandOverrideForTest} over `activation.commands`. */
984
- runCommandOverride(context: CommandOverrideContext): Promise<CommandOverrideResult>;
985
- /** Bound {@link runRegisteredParserOverrideForTest} over `activation.parsers`. */
986
- runParserOverride(context: ParserOverrideContext): Promise<ParserOverrideResult>;
987
- /** Bound {@link runRegisteredPreflightOverrideForTest} over `activation.preflight`. */
988
- runPreflightOverride(context: PreflightOverrideContext): Promise<PreflightOverrideResult>;
989
- /** Bound {@link runRegisteredRendererOverrideForTest} over `activation.renderers`. */
990
- runRendererOverride(context: RendererOverrideContext): Promise<RendererOverrideResult>;
991
- /** Bound {@link runRegisteredServiceOverrideForTest} over `activation.services`. */
992
- runServiceOverride(context: ServiceOverrideContext): Promise<ServiceOverrideResult>;
993
- /** Bound {@link runRegisteredSearchProviderForTest} over `activation.registrations`. */
994
- runSearchProvider<Operation extends keyof SearchProviderOperationContexts>(options: {
995
- provider: string;
996
- operation: Operation;
997
- context: SearchProviderOperationContexts[Operation];
998
- }): Promise<SearchProviderOperationResults[Operation]>;
999
- /** Bound {@link runRegisteredVectorStoreAdapterForTest} over `activation.registrations`. */
1000
- runVectorStoreAdapter<Operation extends keyof VectorStoreAdapterOperationContexts>(options: {
1001
- adapter: string;
1002
- operation: Operation;
1003
- context: VectorStoreAdapterOperationContexts[Operation];
1004
- }): Promise<VectorStoreAdapterOperationResults[Operation]>;
1005
- /** Bound {@link runRegisteredMigrationForTest} over `activation.registrations`. */
1006
- runMigration(options: RunRegisteredMigrationForTestOptions): Promise<unknown>;
1007
- /** Bound {@link runRegisteredImporterForTest} over the whole `activation`. */
1008
- runImporter(options: RunRegisteredImporterForTestOptions): Promise<CommandHandlerResult>;
1009
- /** Bound {@link runRegisteredExporterForTest} over the whole `activation`. */
1010
- runExporter(options: RunRegisteredExporterForTestOptions): Promise<CommandHandlerResult>;
1011
- /**
940
+ renderMarkdown(options?: RenderExtensionHarnessMarkdownOptions): string;
941
+ /** Bound {@link assertRegisteredCommandContract} over `activation.registrations`. */
942
+ assertCommandContract(expectation: RegisteredCommandContractExpectation): RegisteredCommandContractAssertion;
943
+ /** Bound {@link assertRegisteredFlags} over `activation.registrations`. */
944
+ assertFlags(expectation: RegisteredFlagsExpectation): RegisteredExtensionFlagDefinitions;
945
+ /** Bound {@link assertRegisteredItemField} over `activation.registrations`. */
946
+ assertItemField(expectation: RegisteredItemFieldExpectation): RegisteredItemFieldAssertion;
947
+ /** Bound {@link assertRegisteredItemType} over `activation.registrations`. */
948
+ assertItemType(expectation: RegisteredItemTypeExpectation): RegisteredItemTypeAssertion;
949
+ /** Bound {@link assertRegisteredProfile} over `activation.registrations`. */
950
+ assertProfile(expectation: RegisteredProfileExpectation): RegisteredProfileAssertion;
951
+ /** Bound {@link assertRegisteredHook} over `activation.hooks`. */
952
+ assertHook<TKind extends RegisteredHookKind>(expectation: RegisteredHookExpectation & {
953
+ kind: TKind;
954
+ }): RegisteredHookEntry<TKind>;
955
+ /** Bound {@link assertRegisteredCommandOverride} over `activation.commands`. */
956
+ assertCommandOverride(expectation: RegisteredCommandOverrideExpectation): RegisteredExtensionCommandOverride;
957
+ /** Bound {@link assertRegisteredParserOverride} over `activation.parsers`. */
958
+ assertParserOverride(expectation: RegisteredParserOverrideExpectation): RegisteredExtensionParserOverride;
959
+ /** Bound {@link assertRegisteredPreflightOverride} over `activation.preflight`. */
960
+ assertPreflightOverride(expectation?: RegisteredPreflightOverrideExpectation): RegisteredExtensionPreflightOverride;
961
+ /** Bound {@link assertRegisteredRendererOverride} over `activation.renderers`. */
962
+ assertRendererOverride(expectation: RegisteredRendererOverrideExpectation): RegisteredExtensionRendererOverride;
963
+ /** Bound {@link assertRegisteredServiceOverride} over `activation.services`. */
964
+ assertServiceOverride(expectation: RegisteredServiceOverrideExpectation): RegisteredExtensionServiceOverride;
965
+ /** Bound {@link assertRegisteredSearchProvider} over `activation.registrations`. */
966
+ assertSearchProvider(expectation: RegisteredSearchProviderExpectation): RegisteredExtensionSearchProvider;
967
+ /** Bound {@link assertRegisteredVectorStoreAdapter} over `activation.registrations`. */
968
+ assertVectorStoreAdapter(expectation: RegisteredVectorStoreAdapterExpectation): RegisteredExtensionVectorStoreAdapter;
969
+ /** Bound {@link assertRegisteredImporter} over `activation.registrations`. */
970
+ assertImporter(expectation: RegisteredImporterExpectation): RegisteredExtensionImporter;
971
+ /** Bound {@link assertRegisteredExporter} over `activation.registrations`. */
972
+ assertExporter(expectation: RegisteredExporterExpectation): RegisteredExtensionExporter;
973
+ /** Bound {@link assertRegisteredMigration} over `activation.registrations`. */
974
+ assertMigration(expectation: RegisteredMigrationExpectation): RegisteredExtensionSchemaMigrationDefinition;
975
+ /** Bound {@link assertExtensionCapabilityUsage} over the whole `activation`. */
976
+ assertCapabilityUsage(expectation: ExtensionCapabilityUsageExpectation): ExtensionCapabilityUsageAssertion;
977
+ /** Bound {@link runRegisteredCommandForTest} over `activation.commands`. */
978
+ runCommand(options: RunRegisteredCommandForTestOptions): Promise<CommandHandlerResult>;
979
+ /** Bound {@link runRegisteredHookForTest} over `activation.hooks`. */
980
+ runHook(options: RunRegisteredHookForTestOptions): Promise<string[]>;
981
+ /** Bound transactional mutation-guard runner over `activation.hooks`. */
982
+ runMutationGuard(options: RunRegisteredMutationGuardForTestOptions): Promise<void>;
983
+ /** Bound {@link runRegisteredCommandOverrideForTest} over `activation.commands`. */
984
+ runCommandOverride(context: CommandOverrideContext): Promise<CommandOverrideResult>;
985
+ /** Bound {@link runRegisteredParserOverrideForTest} over `activation.parsers`. */
986
+ runParserOverride(context: ParserOverrideContext): Promise<ParserOverrideResult>;
987
+ /** Bound {@link runRegisteredPreflightOverrideForTest} over `activation.preflight`. */
988
+ runPreflightOverride(context: PreflightOverrideContext): Promise<PreflightOverrideResult>;
989
+ /** Bound {@link runRegisteredRendererOverrideForTest} over `activation.renderers`. */
990
+ runRendererOverride(context: RendererOverrideContext): Promise<RendererOverrideResult>;
991
+ /** Bound {@link runRegisteredServiceOverrideForTest} over `activation.services`. */
992
+ runServiceOverride(context: ServiceOverrideContext): Promise<ServiceOverrideResult>;
993
+ /** Bound {@link runRegisteredSearchProviderForTest} over `activation.registrations`. */
994
+ runSearchProvider<Operation extends keyof SearchProviderOperationContexts>(options: {
995
+ provider: string;
996
+ operation: Operation;
997
+ context: SearchProviderOperationContexts[Operation];
998
+ }): Promise<SearchProviderOperationResults[Operation]>;
999
+ /** Bound {@link runRegisteredVectorStoreAdapterForTest} over `activation.registrations`. */
1000
+ runVectorStoreAdapter<Operation extends keyof VectorStoreAdapterOperationContexts>(options: {
1001
+ adapter: string;
1002
+ operation: Operation;
1003
+ context: VectorStoreAdapterOperationContexts[Operation];
1004
+ }): Promise<VectorStoreAdapterOperationResults[Operation]>;
1005
+ /** Bound {@link runRegisteredMigrationForTest} over `activation.registrations`. */
1006
+ runMigration(options: RunRegisteredMigrationForTestOptions): Promise<unknown>;
1007
+ /** Bound {@link runRegisteredImporterForTest} over the whole `activation`. */
1008
+ runImporter(options: RunRegisteredImporterForTestOptions): Promise<CommandHandlerResult>;
1009
+ /** Bound {@link runRegisteredExporterForTest} over the whole `activation`. */
1010
+ runExporter(options: RunRegisteredExporterForTestOptions): Promise<CommandHandlerResult>;
1011
+ /**
1012
1012
  * Bound {@link deactivateExtensionForTest} — runs the real teardown engine for
1013
1013
  * this harness's module, forwarding its resolved `name`/`layer`/`activation` so
1014
1014
  * the skip-key matches and a never-initialized extension is not deactivated.
1015
1015
  */
1016
- deactivate(options?: {
1017
- deactivateTimeoutMs?: number;
1018
- }): Promise<ExtensionDeactivationResult>;
1016
+ deactivate(options?: {
1017
+ deactivateTimeoutMs?: number;
1018
+ }): Promise<ExtensionDeactivationResult>;
1019
1019
  }
1020
1020
  /**
1021
1021
  * Activate one in-memory extension module and return a fluent