@unbrained/pm-cli 2026.10.14 → 2026.10.15

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 (692) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +54 -2
  3. package/dist/cli/after-command-context-usage.d.ts +7 -7
  4. package/dist/cli/argv-utils.d.ts +4 -4
  5. package/dist/cli/bundle-integrity.d.ts +16 -16
  6. package/dist/cli/command-namespaces.d.ts +1 -1
  7. package/dist/cli/commander-usage.d.ts +34 -34
  8. package/dist/cli/commands/governance/validate.d.ts +1 -1
  9. package/dist/cli/commands/history/history-compact.d.ts +1 -1
  10. package/dist/cli/commands/history/history-redact.d.ts +1 -1
  11. package/dist/cli/commands/history/history-repair.d.ts +1 -1
  12. package/dist/cli/commands/history/restore.d.ts +1 -1
  13. package/dist/cli/commands/lifecycle/close.d.ts +1 -1
  14. package/dist/cli/commands/lifecycle/copy.d.ts +1 -1
  15. package/dist/cli/commands/lifecycle/delete.d.ts +1 -1
  16. package/dist/cli/commands/lifecycle/focus.d.ts +1 -1
  17. package/dist/cli/commands/query/get.d.ts +1 -1
  18. package/dist/cli/commands/workspace/merge.d.ts +1 -1
  19. package/dist/cli/commands/workspace/schema.d.ts +1 -1
  20. package/dist/cli/context-intent-invocation.d.ts +1 -1
  21. package/dist/cli/description-stdin.d.ts +1 -1
  22. package/dist/cli/error-guidance.d.ts +119 -119
  23. package/dist/cli/extension-command-help.d.ts +64 -64
  24. package/dist/cli/extension-command-help.js +2 -2
  25. package/dist/cli/extension-command-options.d.ts +16 -16
  26. package/dist/cli/extension-recovery.d.ts +13 -13
  27. package/dist/cli/help-content.d.ts +22 -22
  28. package/dist/cli/help-content.js +2 -2
  29. package/dist/cli/help-json-payload.d.ts +45 -45
  30. package/dist/cli/invocation-profile.d.ts +5 -5
  31. package/dist/cli/main.d.ts +217 -217
  32. package/dist/cli/migration-gates.d.ts +24 -24
  33. package/dist/cli/option-values.d.ts +1 -1
  34. package/dist/cli/public.d.ts +1 -1
  35. package/dist/cli/register-annotations.d.ts +2 -2
  36. package/dist/cli/register-assurance.d.ts +1 -1
  37. package/dist/cli/register-files-lookup.d.ts +1 -1
  38. package/dist/cli/register-history-activity.d.ts +1 -1
  39. package/dist/cli/register-history-author.d.ts +1 -1
  40. package/dist/cli/register-history-maintenance.d.ts +1 -1
  41. package/dist/cli/register-list-query.d.ts +7 -7
  42. package/dist/cli/register-list-query.js +3 -3
  43. package/dist/cli/register-mutation-options.d.ts +1 -1
  44. package/dist/cli/register-mutation.d.ts +4 -4
  45. package/dist/cli/register-operations.d.ts +75 -75
  46. package/dist/cli/register-setup.d.ts +4 -4
  47. package/dist/cli/register-structured-mutation.d.ts +8 -8
  48. package/dist/cli/runtime/activation.d.ts +23 -23
  49. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  50. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  51. package/dist/cli/runtime/selection.d.ts +16 -16
  52. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  53. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  54. package/dist/cli/schema/registration.d.ts +1 -1
  55. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  56. package/dist/cli/stats-analytics-json.d.ts +1 -1
  57. package/dist/cli-bundle/bundle-manifest.json +1 -1
  58. package/dist/cli-bundle/chunks/{chunk-5LU6PWA4.js → chunk-52EZH2QQ.js} +2 -2
  59. package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
  60. package/dist/cli-bundle/chunks/{chunk-LKESCZEN.js → chunk-7VHINXZP.js} +2 -2
  61. package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
  62. package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
  63. package/dist/cli-bundle/chunks/{chunk-PP3BVMFL.js → chunk-JSUJWIHQ.js} +30 -30
  64. package/dist/cli-bundle/chunks/{chunk-MAT4AP7P.js → chunk-LNKLQYBG.js} +2 -2
  65. package/dist/cli-bundle/chunks/{chunk-LE4IEHDG.js → chunk-N56CAQBU.js} +63 -64
  66. package/dist/cli-bundle/chunks/{chunk-3S5SEMEB.js → chunk-NC3QVGDD.js} +2 -2
  67. package/dist/cli-bundle/chunks/{chunk-2UKKO45F.js → chunk-RJ5N44WY.js} +2 -2
  68. package/dist/cli-bundle/chunks/{chunk-LOSRTNNP.js → chunk-VIMQCFCK.js} +2 -2
  69. package/dist/cli-bundle/chunks/{chunk-JTF6VMXH.js → chunk-WBBW3WQX.js} +4 -4
  70. package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
  71. package/dist/cli-bundle/chunks/{register-list-query-GBLTOQQL.js → register-list-query-FKKFQ66D.js} +7 -7
  72. package/dist/cli-bundle/chunks/{register-mutation-TNRHNK4N.js → register-mutation-EWMMVZJB.js} +2 -2
  73. package/dist/cli-bundle/chunks/{register-operations-J3WXP3MA.js → register-operations-GEQ2H7PS.js} +2 -2
  74. package/dist/cli-bundle/chunks/{register-setup-HLSKKU4V.js → register-setup-PSJTQBBO.js} +2 -2
  75. package/dist/cli-bundle/focused-chunks/{chunk-4UA7KY4V.js → chunk-3RNUMVK4.js} +2 -2
  76. package/dist/cli-bundle/focused-chunks/{chunk-BUAGNTLG.js → chunk-4KQFMOM7.js} +6 -6
  77. package/dist/cli-bundle/focused-chunks/{chunk-QIU4Y3AB.js → chunk-52I2SNKJ.js} +2 -2
  78. package/dist/cli-bundle/focused-chunks/{chunk-Y5A4XOSK.js → chunk-5KRACGBK.js} +2 -2
  79. package/dist/cli-bundle/focused-chunks/{chunk-HNRI2KBT.js → chunk-5OO54BIV.js} +2 -2
  80. package/dist/cli-bundle/focused-chunks/{chunk-LKWDWER4.js → chunk-5TBAVZDR.js} +14 -14
  81. package/dist/cli-bundle/focused-chunks/{chunk-RHQCQTZA.js → chunk-FQKPOZKS.js} +2 -2
  82. package/dist/cli-bundle/focused-chunks/{chunk-IGBSAHCA.js → chunk-H3P77KVU.js} +2 -2
  83. package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
  84. package/dist/cli-bundle/focused-chunks/{chunk-23ACMPGB.js → chunk-JKBH7YGX.js} +2 -2
  85. package/dist/cli-bundle/focused-chunks/{chunk-AULVKHYX.js → chunk-KIIFVULU.js} +2 -2
  86. package/dist/cli-bundle/focused-chunks/{chunk-ESOW6PH4.js → chunk-N6FUKTZS.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
  88. package/dist/cli-bundle/focused-chunks/{chunk-KSMQEB3V.js → chunk-Q4VNCTR2.js} +2 -2
  89. package/dist/cli-bundle/focused-chunks/{chunk-YJNKISEI.js → chunk-THYQR3ON.js} +61 -62
  90. package/dist/cli-bundle/focused-chunks/{chunk-ELQNEJDA.js → chunk-TYLG5VEB.js} +2 -2
  91. package/dist/cli-bundle/main.js +26 -26
  92. package/dist/cli-bundle/sdk-authoring.js +1 -1
  93. package/dist/cli-bundle/sdk-contracts.js +2 -2
  94. package/dist/cli-bundle/sdk-core.js +22 -22
  95. package/dist/cli-bundle/sdk-governance.js +1 -1
  96. package/dist/cli-bundle/sdk-graph.js +1 -1
  97. package/dist/cli-bundle/sdk-merge.js +51 -51
  98. package/dist/cli-bundle/sdk-query.js +1 -1
  99. package/dist/cli-bundle/sdk-runtime.js +1 -1
  100. package/dist/cli-bundle/sdk-testing.js +1 -1
  101. package/dist/cli-bundle/sdk.js +7 -7
  102. package/dist/cli.d.ts +9 -9
  103. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  104. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  105. package/dist/core/config/nested-settings.d.ts +20 -20
  106. package/dist/core/config/positional-value.d.ts +9 -9
  107. package/dist/core/diagnostics/remediation.d.ts +7 -7
  108. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  109. package/dist/core/extensions/activation-summary.d.ts +30 -30
  110. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  111. package/dist/core/extensions/capability-usage.d.ts +25 -25
  112. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  113. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  114. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  115. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  116. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  117. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  118. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  119. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  120. package/dist/core/extensions/extension-policy.d.ts +62 -62
  121. package/dist/core/extensions/extension-registries.d.ts +8 -8
  122. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  123. package/dist/core/extensions/extension-types.d.ts +702 -702
  124. package/dist/core/extensions/flag-definition-validation.d.ts +11 -11
  125. package/dist/core/extensions/flag-value-types.d.ts +16 -4
  126. package/dist/core/extensions/flag-value-types.js +1 -1
  127. package/dist/core/extensions/index.d.ts +34 -34
  128. package/dist/core/extensions/item-field-types.d.ts +3 -3
  129. package/dist/core/extensions/item-fields.d.ts +6 -6
  130. package/dist/core/extensions/loader.d.ts +66 -66
  131. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  132. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  133. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  134. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  135. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  136. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  137. package/dist/core/extensions/registration-validation.d.ts +6 -6
  138. package/dist/core/extensions/registration-values.d.ts +19 -19
  139. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  140. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  141. package/dist/core/extensions/service-ownership.d.ts +1 -1
  142. package/dist/core/extensions/version-compat.d.ts +9 -9
  143. package/dist/core/fs/atomic-create.d.ts +1 -1
  144. package/dist/core/fs/fs-utils.d.ts +12 -12
  145. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  146. package/dist/core/fs/path-utils.d.ts +1 -1
  147. package/dist/core/governance/content-fields.d.ts +25 -25
  148. package/dist/core/governance/issue-codes.d.ts +16 -16
  149. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  150. package/dist/core/history/digest.d.ts +5 -5
  151. package/dist/core/history/drift-cache.d.ts +2 -2
  152. package/dist/core/history/drift-scan.d.ts +18 -18
  153. package/dist/core/history/event-classification.d.ts +4 -4
  154. package/dist/core/history/event-index.d.ts +33 -33
  155. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  156. package/dist/core/history/history-diff.d.ts +15 -15
  157. package/dist/core/history/history-rewrite.d.ts +43 -43
  158. package/dist/core/history/history-storage-stats.d.ts +20 -20
  159. package/dist/core/history/history-stream-policy.d.ts +12 -12
  160. package/dist/core/history/history.d.ts +45 -45
  161. package/dist/core/history/identity.d.ts +4 -4
  162. package/dist/core/history/operation-contract.d.ts +17 -17
  163. package/dist/core/history/projection.d.ts +16 -16
  164. package/dist/core/history/read.d.ts +4 -4
  165. package/dist/core/history/replay.d.ts +47 -47
  166. package/dist/core/history/tombstone.d.ts +1 -1
  167. package/dist/core/history/version-address.d.ts +2 -2
  168. package/dist/core/history/workspace-history.d.ts +72 -72
  169. package/dist/core/io/body-file.d.ts +2 -2
  170. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  171. package/dist/core/item/actionability.d.ts +30 -30
  172. package/dist/core/item/dependency-reference.d.ts +2 -2
  173. package/dist/core/item/id.d.ts +9 -9
  174. package/dist/core/item/item-format-version.d.ts +17 -15
  175. package/dist/core/item/item-format-version.js +1 -1
  176. package/dist/core/item/item-format.d.ts +54 -54
  177. package/dist/core/item/item-record.d.ts +1 -1
  178. package/dist/core/item/item-type-definition.d.ts +11 -11
  179. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  180. package/dist/core/item/parse.d.ts +37 -37
  181. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  182. package/dist/core/item/priority.d.ts +3 -3
  183. package/dist/core/item/sprint-release-format.d.ts +4 -4
  184. package/dist/core/item/status-filter.d.ts +5 -5
  185. package/dist/core/item/status.d.ts +3 -3
  186. package/dist/core/item/toon-decode.d.ts +10 -10
  187. package/dist/core/item/type-registry.d.ts +35 -35
  188. package/dist/core/item/type-synonyms.d.ts +2 -2
  189. package/dist/core/lock/lock-gc.d.ts +28 -28
  190. package/dist/core/lock/lock.d.ts +53 -53
  191. package/dist/core/output/mutation-projection.d.ts +4 -4
  192. package/dist/core/output/output-control.d.ts +4 -4
  193. package/dist/core/output/output.d.ts +30 -30
  194. package/dist/core/output/query-summary.d.ts +5 -5
  195. package/dist/core/output/tabular.d.ts +3 -3
  196. package/dist/core/packages/manifest.d.ts +30 -30
  197. package/dist/core/packages/root.d.ts +4 -4
  198. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  199. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  200. package/dist/core/policy/workflow-policy.d.ts +56 -56
  201. package/dist/core/profile/profile-describe.d.ts +22 -22
  202. package/dist/core/profile/profile-lint.d.ts +13 -13
  203. package/dist/core/profile/profile-plan.d.ts +45 -45
  204. package/dist/core/profile/profile-presets.d.ts +36 -36
  205. package/dist/core/reproducibility/context.d.ts +9 -9
  206. package/dist/core/schema/fields-file.d.ts +35 -35
  207. package/dist/core/schema/item-types-file.d.ts +29 -29
  208. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  209. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  210. package/dist/core/schema/runtime-schema.d.ts +59 -59
  211. package/dist/core/schema/status-defs-file.d.ts +29 -29
  212. package/dist/core/schema/status-token.d.ts +1 -1
  213. package/dist/core/schema/type-inference.d.ts +10 -10
  214. package/dist/core/schema/type-presets.d.ts +5 -5
  215. package/dist/core/schema/type-workflows.d.ts +14 -14
  216. package/dist/core/search/background-refresh.d.ts +12 -12
  217. package/dist/core/search/bm25.d.ts +16 -16
  218. package/dist/core/search/cache.d.ts +34 -34
  219. package/dist/core/search/corpus.d.ts +17 -17
  220. package/dist/core/search/embedding-batches.d.ts +25 -25
  221. package/dist/core/search/eval-thresholds.d.ts +4 -4
  222. package/dist/core/search/eval.d.ts +40 -40
  223. package/dist/core/search/http-client.d.ts +24 -24
  224. package/dist/core/search/providers.d.ts +30 -30
  225. package/dist/core/search/relevance.d.ts +17 -17
  226. package/dist/core/search/semantic-defaults.d.ts +5 -5
  227. package/dist/core/search/staleness.d.ts +3 -3
  228. package/dist/core/search/vector-stores.d.ts +51 -51
  229. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  230. package/dist/core/sentry/helpers.d.ts +27 -27
  231. package/dist/core/sentry/instrument.d.ts +51 -51
  232. package/dist/core/sentry/instrument.js +1 -1
  233. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  234. package/dist/core/sentry/sensitive-assignments.js +2 -0
  235. package/dist/core/session/session-state.d.ts +37 -37
  236. package/dist/core/shared/agent-session-context.d.ts +14 -14
  237. package/dist/core/shared/author.d.ts +89 -89
  238. package/dist/core/shared/command-line.d.ts +3 -3
  239. package/dist/core/shared/command-types.d.ts +20 -20
  240. package/dist/core/shared/conflict-markers.d.ts +5 -5
  241. package/dist/core/shared/constants.d.ts +30 -30
  242. package/dist/core/shared/errors.d.ts +100 -100
  243. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  244. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  245. package/dist/core/shared/lazy-module.d.ts +1 -1
  246. package/dist/core/shared/levenshtein.d.ts +1 -1
  247. package/dist/core/shared/memo.d.ts +1 -1
  248. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  249. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  250. package/dist/core/shared/primitives.d.ts +13 -13
  251. package/dist/core/shared/secret-rules.d.ts +92 -92
  252. package/dist/core/shared/serial-queue.d.ts +6 -6
  253. package/dist/core/shared/serialization.d.ts +4 -4
  254. package/dist/core/shared/split-comma-list.d.ts +4 -4
  255. package/dist/core/shared/text-normalization.d.ts +3 -3
  256. package/dist/core/shared/time.d.ts +27 -27
  257. package/dist/core/store/item-format-migration.d.ts +7 -7
  258. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  259. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  260. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  261. package/dist/core/store/item-store.d.ts +123 -123
  262. package/dist/core/store/item-store.js +1 -1
  263. package/dist/core/store/paths.d.ts +27 -27
  264. package/dist/core/store/settings-concurrency.d.ts +1 -1
  265. package/dist/core/store/settings-read-cache.d.ts +11 -11
  266. package/dist/core/store/settings-validator.d.ts +117 -117
  267. package/dist/core/store/settings.d.ts +84 -84
  268. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  269. package/dist/core/store/tracker-preflight.d.ts +3 -3
  270. package/dist/core/telemetry/consent.d.ts +1 -1
  271. package/dist/core/telemetry/observability.d.ts +16 -16
  272. package/dist/core/telemetry/policy.d.ts +7 -7
  273. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  274. package/dist/core/telemetry/runtime.d.ts +275 -275
  275. package/dist/core/test/background-runs.d.ts +123 -123
  276. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  277. package/dist/core/test/run-selectors.d.ts +12 -12
  278. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  279. package/dist/core/validate/fix-planning.d.ts +36 -36
  280. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  281. package/dist/core/validate/missing-by-type.d.ts +3 -3
  282. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  283. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  284. package/dist/mcp/http-server.d.ts +26 -26
  285. package/dist/mcp/legacy-adapter.d.ts +18 -18
  286. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  287. package/dist/mcp/server.d.ts +73 -73
  288. package/dist/mcp/tool-definitions.d.ts +27 -27
  289. package/dist/sdk/actionability.d.ts +1 -1
  290. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  291. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  292. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  293. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  294. package/dist/sdk/agent/identity-config.d.ts +18 -18
  295. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  296. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  297. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  298. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  299. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  300. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  301. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  302. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  303. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  304. package/dist/sdk/agent-session-context.d.ts +1 -1
  305. package/dist/sdk/annotations.d.ts +74 -74
  306. package/dist/sdk/author-attribution.d.ts +47 -47
  307. package/dist/sdk/authoring.d.ts +9 -9
  308. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  309. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  310. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  311. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  312. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  313. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  314. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  315. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  316. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  317. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  318. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  319. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  320. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  321. package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
  322. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  323. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  324. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  325. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  326. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  327. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  328. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  329. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  330. package/dist/sdk/cli-contracts.d.ts +15 -15
  331. package/dist/sdk/cli-program.d.ts +1 -1
  332. package/dist/sdk/cli-program.js +1 -1
  333. package/dist/sdk/command-line.d.ts +3 -3
  334. package/dist/sdk/comments.d.ts +24 -24
  335. package/dist/sdk/compile-cache.d.ts +4 -4
  336. package/dist/sdk/completion/bash.d.ts +1 -1
  337. package/dist/sdk/completion/fish.d.ts +1 -1
  338. package/dist/sdk/completion/shared.d.ts +74 -74
  339. package/dist/sdk/completion/zsh.d.ts +1 -1
  340. package/dist/sdk/completion.d.ts +3 -3
  341. package/dist/sdk/compose.d.ts +94 -94
  342. package/dist/sdk/config.d.ts +105 -105
  343. package/dist/sdk/context/recency.d.ts +1 -1
  344. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  345. package/dist/sdk/context/usage-egress.d.ts +1 -1
  346. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  347. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  348. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  349. package/dist/sdk/context-packing.d.ts +44 -44
  350. package/dist/sdk/context-relevance.d.ts +110 -110
  351. package/dist/sdk/context-signal-store.d.ts +52 -52
  352. package/dist/sdk/context-usage.d.ts +78 -78
  353. package/dist/sdk/contracts.d.ts +2 -1
  354. package/dist/sdk/contracts.js +1 -1
  355. package/dist/sdk/core-governance.d.ts +5 -5
  356. package/dist/sdk/core.d.ts +8 -8
  357. package/dist/sdk/corpus-shape.d.ts +60 -60
  358. package/dist/sdk/define.d.ts +36 -36
  359. package/dist/sdk/dependencies.d.ts +70 -70
  360. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  361. package/dist/sdk/dependency-provenance.d.ts +22 -22
  362. package/dist/sdk/docs.d.ts +17 -17
  363. package/dist/sdk/duplicates.d.ts +14 -14
  364. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  365. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  366. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  367. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  368. package/dist/sdk/environment/source-context.d.ts +4 -4
  369. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  370. package/dist/sdk/error-code-catalog.d.ts +33 -33
  371. package/dist/sdk/error-runtime.d.ts +5 -5
  372. package/dist/sdk/errors.d.ts +17 -17
  373. package/dist/sdk/eval.d.ts +27 -27
  374. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  375. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  376. package/dist/sdk/extension/concurrency.d.ts +1 -1
  377. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  378. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  379. package/dist/sdk/extension/describe.d.ts +21 -21
  380. package/dist/sdk/extension/doctor.d.ts +46 -46
  381. package/dist/sdk/extension/install-plan.d.ts +32 -32
  382. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  383. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  384. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  385. package/dist/sdk/extension/install-sources.d.ts +106 -106
  386. package/dist/sdk/extension/managed-state.d.ts +42 -42
  387. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  388. package/dist/sdk/extension/migrations.d.ts +48 -48
  389. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  390. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  391. package/dist/sdk/extension/scaffold.d.ts +15 -15
  392. package/dist/sdk/extension/shared.d.ts +16 -16
  393. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  394. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  395. package/dist/sdk/extension/update-check.d.ts +9 -9
  396. package/dist/sdk/extension-command-context.d.ts +1 -1
  397. package/dist/sdk/extension-contracts.d.ts +10 -10
  398. package/dist/sdk/extension.d.ts +221 -221
  399. package/dist/sdk/files.d.ts +101 -101
  400. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  401. package/dist/sdk/flag-invocation-contracts.js +1 -1
  402. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  403. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  404. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  405. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  406. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  407. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  408. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  409. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  410. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  411. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  412. package/dist/sdk/governance/assurance.d.ts +204 -204
  413. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  414. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  415. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  416. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  417. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  418. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  419. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  420. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  421. package/dist/sdk/governance/gc.d.ts +26 -26
  422. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  423. package/dist/sdk/governance/health.d.ts +172 -172
  424. package/dist/sdk/governance/health.js +1 -1
  425. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  426. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  427. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  428. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  429. package/dist/sdk/governance/reindex.d.ts +102 -102
  430. package/dist/sdk/governance/reliability.d.ts +29 -29
  431. package/dist/sdk/governance/stale-work.d.ts +13 -13
  432. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  433. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  434. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  435. package/dist/sdk/governance/upgrade.d.ts +77 -77
  436. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  437. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  438. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  439. package/dist/sdk/governance/validate.d.ts +176 -176
  440. package/dist/sdk/governance/validate.js +1 -1
  441. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  442. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  443. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  444. package/dist/sdk/governance.d.ts +2 -2
  445. package/dist/sdk/graph/adapter.d.ts +45 -45
  446. package/dist/sdk/graph/analytics.d.ts +36 -36
  447. package/dist/sdk/graph/assembly.d.ts +51 -51
  448. package/dist/sdk/graph/cache.d.ts +19 -19
  449. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  450. package/dist/sdk/graph/centrality.d.ts +20 -20
  451. package/dist/sdk/graph/conformance.d.ts +21 -21
  452. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  453. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  454. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  455. package/dist/sdk/graph/governance.d.ts +92 -92
  456. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  457. package/dist/sdk/graph/index.d.ts +15 -15
  458. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  459. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  460. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  461. package/dist/sdk/graph/remediation.d.ts +15 -15
  462. package/dist/sdk/graph/run.d.ts +203 -203
  463. package/dist/sdk/graph/scheduling.d.ts +21 -21
  464. package/dist/sdk/graph/traversal.d.ts +18 -18
  465. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  466. package/dist/sdk/guide-topics.d.ts +19 -19
  467. package/dist/sdk/guide.d.ts +43 -43
  468. package/dist/sdk/history/attestation-command.d.ts +8 -8
  469. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  470. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  471. package/dist/sdk/history/attestation.d.ts +4 -4
  472. package/dist/sdk/history/maintenance.d.ts +25 -25
  473. package/dist/sdk/history/salvage.d.ts +19 -19
  474. package/dist/sdk/history/subject.d.ts +8 -8
  475. package/dist/sdk/history-analytics.d.ts +64 -64
  476. package/dist/sdk/history-compact.d.ts +67 -67
  477. package/dist/sdk/history-mcp.d.ts +7 -7
  478. package/dist/sdk/history-provenance.d.ts +40 -40
  479. package/dist/sdk/history-read.d.ts +24 -24
  480. package/dist/sdk/history-redact.d.ts +68 -68
  481. package/dist/sdk/history-repair.d.ts +92 -92
  482. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  483. package/dist/sdk/improvement-ledger.d.ts +62 -62
  484. package/dist/sdk/index.d.ts +69 -69
  485. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  486. package/dist/sdk/init.d.ts +117 -117
  487. package/dist/sdk/invocation-author.d.ts +1 -1
  488. package/dist/sdk/item-children.d.ts +15 -15
  489. package/dist/sdk/item-metadata-index.d.ts +2 -2
  490. package/dist/sdk/item-schedule.d.ts +9 -9
  491. package/dist/sdk/item-transaction.d.ts +73 -73
  492. package/dist/sdk/learnings.d.ts +23 -23
  493. package/dist/sdk/lifecycle/append.d.ts +8 -8
  494. package/dist/sdk/lifecycle/claim.d.ts +38 -38
  495. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  496. package/dist/sdk/lifecycle/close.d.ts +18 -18
  497. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  498. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  499. package/dist/sdk/lifecycle/create.d.ts +88 -88
  500. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  501. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  502. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  503. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  504. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  505. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  506. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  507. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  508. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  509. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  510. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  511. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  512. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  513. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  514. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  515. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  516. package/dist/sdk/lifecycle/restore.js +1 -1
  517. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  518. package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
  519. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  520. package/dist/sdk/lifecycle/update.d.ts +120 -120
  521. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  522. package/dist/sdk/lifecycle-policy.d.ts +31 -31
  523. package/dist/sdk/linked-artifacts.d.ts +58 -58
  524. package/dist/sdk/mcp/apps.d.ts +28 -28
  525. package/dist/sdk/mcp/authorization.d.ts +66 -66
  526. package/dist/sdk/mcp/discovery.d.ts +67 -67
  527. package/dist/sdk/mcp/interactions.d.ts +49 -49
  528. package/dist/sdk/mcp/protocol.d.ts +63 -63
  529. package/dist/sdk/mcp/skills.d.ts +62 -62
  530. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  531. package/dist/sdk/mcp/tasks.d.ts +51 -51
  532. package/dist/sdk/mcp/transport.d.ts +17 -17
  533. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  534. package/dist/sdk/merge/driver.d.ts +38 -38
  535. package/dist/sdk/merge/index.d.ts +5 -5
  536. package/dist/sdk/merge/install.d.ts +48 -48
  537. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  538. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  539. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  540. package/dist/sdk/merge/receipts.d.ts +111 -111
  541. package/dist/sdk/merge/reconcile.d.ts +20 -20
  542. package/dist/sdk/merge/three-way.d.ts +50 -50
  543. package/dist/sdk/merge/three-way.js +2 -2
  544. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  545. package/dist/sdk/mutation-events.d.ts +62 -62
  546. package/dist/sdk/mutation-guard.d.ts +134 -134
  547. package/dist/sdk/notes.d.ts +28 -28
  548. package/dist/sdk/output/table-rows.d.ts +6 -6
  549. package/dist/sdk/output-contracts.d.ts +26 -26
  550. package/dist/sdk/output-projection.d.ts +108 -108
  551. package/dist/sdk/output-token-accounting.d.ts +18 -18
  552. package/dist/sdk/output.d.ts +18 -18
  553. package/dist/sdk/ownership-source.d.ts +1 -1
  554. package/dist/sdk/package-import-adapters.d.ts +51 -51
  555. package/dist/sdk/package-migrations.d.ts +3 -3
  556. package/dist/sdk/package-runtime-options.d.ts +3 -3
  557. package/dist/sdk/pagination.d.ts +28 -28
  558. package/dist/sdk/pagination.js +1 -1
  559. package/dist/sdk/profile.d.ts +72 -72
  560. package/dist/sdk/provenance.d.ts +37 -37
  561. package/dist/sdk/public-surface.json +1 -1
  562. package/dist/sdk/query/activity.d.ts +84 -84
  563. package/dist/sdk/query/aggregate.d.ts +109 -109
  564. package/dist/sdk/query/calendar.d.ts +95 -95
  565. package/dist/sdk/query/complete-list.d.ts +35 -35
  566. package/dist/sdk/query/context.d.ts +300 -300
  567. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  568. package/dist/sdk/query/get.d.ts +54 -54
  569. package/dist/sdk/query/history.d.ts +38 -38
  570. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  571. package/dist/sdk/query/light-metadata.d.ts +1 -1
  572. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  573. package/dist/sdk/query/list.d.ts +167 -167
  574. package/dist/sdk/query/list.js +1 -1
  575. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  576. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  577. package/dist/sdk/query/next.d.ts +94 -94
  578. package/dist/sdk/query/parsers.d.ts +3 -3
  579. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  580. package/dist/sdk/query/search/corpus.d.ts +15 -15
  581. package/dist/sdk/query/search/filters.d.ts +15 -15
  582. package/dist/sdk/query/search/input.d.ts +8 -8
  583. package/dist/sdk/query/search/lexical.d.ts +10 -10
  584. package/dist/sdk/query/search/response.d.ts +22 -22
  585. package/dist/sdk/query/search/semantic.d.ts +133 -133
  586. package/dist/sdk/query/search/types.d.ts +65 -65
  587. package/dist/sdk/query/search-contracts.d.ts +53 -53
  588. package/dist/sdk/query/search-pagination.d.ts +21 -21
  589. package/dist/sdk/query/search-rendering.d.ts +30 -30
  590. package/dist/sdk/query/search.d.ts +60 -60
  591. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  592. package/dist/sdk/query.d.ts +6 -6
  593. package/dist/sdk/read-output/continuation.d.ts +11 -11
  594. package/dist/sdk/read-output/extension.d.ts +3 -3
  595. package/dist/sdk/read-output/options.d.ts +7 -7
  596. package/dist/sdk/read-output/provenance.d.ts +6 -6
  597. package/dist/sdk/read-output-budget.d.ts +11 -11
  598. package/dist/sdk/read-output-contracts.d.ts +112 -112
  599. package/dist/sdk/read-output-contracts.js +1 -1
  600. package/dist/sdk/read-output-rows.d.ts +15 -15
  601. package/dist/sdk/read-output-session.d.ts +29 -29
  602. package/dist/sdk/relationship-analytics.d.ts +46 -46
  603. package/dist/sdk/relationship-context.d.ts +48 -48
  604. package/dist/sdk/relationship-history.d.ts +59 -59
  605. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  606. package/dist/sdk/relationship-migration.d.ts +14 -14
  607. package/dist/sdk/relationships.d.ts +46 -46
  608. package/dist/sdk/reproducibility/process.d.ts +9 -9
  609. package/dist/sdk/runtime/actions.d.ts +1 -1
  610. package/dist/sdk/runtime/context.d.ts +15 -15
  611. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  612. package/dist/sdk/runtime/schema.d.ts +1 -1
  613. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  614. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  615. package/dist/sdk/runtime-input.d.ts +29 -29
  616. package/dist/sdk/runtime-primitives.d.ts +53 -53
  617. package/dist/sdk/runtime-primitives.js +1 -1
  618. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  619. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  620. package/dist/sdk/runtime.d.ts +374 -374
  621. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  622. package/dist/sdk/schema-migration.d.ts +79 -79
  623. package/dist/sdk/schema.d.ts +224 -224
  624. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  625. package/dist/sdk/similarity-scoring.d.ts +10 -10
  626. package/dist/sdk/similarity.d.ts +73 -73
  627. package/dist/sdk/start-task-status.d.ts +1 -1
  628. package/dist/sdk/stats.d.ts +72 -72
  629. package/dist/sdk/structured-mutations.d.ts +13 -13
  630. package/dist/sdk/telemetry-flush.d.ts +1 -1
  631. package/dist/sdk/telemetry.d.ts +32 -32
  632. package/dist/sdk/templates.d.ts +35 -35
  633. package/dist/sdk/test/batch.d.ts +50 -50
  634. package/dist/sdk/test/command-args.d.ts +2 -2
  635. package/dist/sdk/test/entry.d.ts +4 -4
  636. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  637. package/dist/sdk/test/execution.d.ts +247 -247
  638. package/dist/sdk/test/json-path.d.ts +4 -4
  639. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  640. package/dist/sdk/test/measurements.d.ts +10 -10
  641. package/dist/sdk/test/parsers.d.ts +18 -18
  642. package/dist/sdk/test/prerequisites.d.ts +3 -3
  643. package/dist/sdk/test/runs.d.ts +43 -43
  644. package/dist/sdk/test/trust.d.ts +15 -15
  645. package/dist/sdk/test/update.d.ts +23 -23
  646. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  647. package/dist/sdk/testing.d.ts +248 -248
  648. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  649. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  650. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  651. package/dist/sdk/workspace-contracts.d.ts +20 -20
  652. package/dist/sdk/workspace-memory.d.ts +42 -42
  653. package/dist/sdk/workspace-recipe.d.ts +9 -9
  654. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  655. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  656. package/dist/sdk/workspace-transaction.d.ts +26 -26
  657. package/dist/sdk/workspace.d.ts +9 -9
  658. package/dist/types.d.ts +540 -540
  659. package/docs/COMMANDS.md +11 -2
  660. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +18 -4
  661. package/docs/LINKED_TEST_EDITS.md +15 -0
  662. package/docs/RELEASING.md +2 -0
  663. package/docs/TESTING.md +21 -1
  664. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
  665. package/marketplace.json +1 -1
  666. package/package.json +3 -1
  667. package/packages/pm-beads/package.json +1 -1
  668. package/packages/pm-calendar/package.json +1 -1
  669. package/packages/pm-command-kit/package.json +1 -1
  670. package/packages/pm-digital-twin/package.json +1 -1
  671. package/packages/pm-governance-audit/package.json +1 -1
  672. package/packages/pm-guide-shell/package.json +1 -1
  673. package/packages/pm-kanban/package.json +1 -1
  674. package/packages/pm-lifecycle-hooks/package.json +1 -1
  675. package/packages/pm-linked-test-adapters/package.json +1 -1
  676. package/packages/pm-search-advanced/package.json +1 -1
  677. package/packages/pm-templates/package.json +1 -1
  678. package/packages/pm-todos/package.json +1 -1
  679. package/packages/pm-vcs/package.json +1 -1
  680. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  681. package/plugins/pm-claude/package.json +1 -1
  682. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  683. package/plugins/pm-codex/package.json +1 -1
  684. package/plugins/pm-codex/plugin.json +1 -1
  685. package/runtime-dependencies.json +1 -1
  686. package/scripts/finalize-build.mjs +9 -3
  687. package/dist/cli-bundle/chunks/chunk-66BZVFIK.js +0 -6
  688. package/dist/cli-bundle/chunks/chunk-IDEHMKYZ.js +0 -235
  689. package/dist/cli-bundle/chunks/chunk-UNQZGMJL.js +0 -20
  690. package/dist/cli-bundle/chunks/chunk-YXRAYL7H.js +0 -2
  691. package/dist/cli-bundle/focused-chunks/chunk-JDVZF75H.js +0 -165
  692. package/dist/cli-bundle/focused-chunks/chunk-WIXZF5SS.js +0 -26
@@ -3,47 +3,47 @@
3
3
  *
4
4
  * Defines public SDK APIs and package-author helpers for Testing.
5
5
  */
6
- import type { AfterCommandHookContext, BeforeCommandHookContext, BeforeMutationHookContext, CommandHandlerResult, CommandOverrideContext, CommandOverrideResult, ExtensionActivationResult, ExtensionCapability, ExtensionCommandRegistry, ExtensionDeactivationResult, ExtensionGovernancePolicy, ExtensionHookRegistry, ExtensionCommandSdk, ExtensionLayer, ExtensionManifest, ExtensionParserRegistry, ExtensionPreflightRegistry, ExtensionRegistrationRegistry, ExtensionRendererRegistry, ExtensionServiceName, ExtensionServiceRegistry, FlagDefinition, OnIndexHookContext, OnReadHookContext, OnWriteHookContext, OutputRendererFormat, ParserOverrideContext, ParserOverrideResult, PreflightOverrideContext, PreflightOverrideResult, RegisteredExtensionCommandDefinition, RegisteredExtensionCommandOverride, RegisteredExtensionExporter, RegisteredExtensionFlagDefinitions, RegisteredExtensionImporter, RegisteredExtensionParserOverride, RegisteredExtensionPreflightOverride, RegisteredExtensionProjectProfile, RegisteredExtensionRendererOverride, RegisteredExtensionSchemaFieldDefinitions, RegisteredExtensionSchemaItemTypeDefinitions, RegisteredExtensionSchemaMigrationDefinition, RegisteredExtensionSearchProvider, RegisteredExtensionServiceOverride, RegisteredExtensionVectorStoreAdapter, RendererOverrideContext, RendererOverrideResult, SchemaFieldDefinition, SchemaItemTypeDefinition, SearchProviderEmbedBatchContext, SearchProviderEmbedContext, SearchProviderQueryContext, SearchProviderQueryExpansionContext, SearchProviderQueryExpansionResult, SearchProviderQueryResult, SearchProviderRerankContext, SearchProviderRerankResult, ServiceOverrideContext, ServiceOverrideResult, VectorStoreDeleteContext, VectorStoreQueryContext, VectorStoreQueryHit, VectorStoreUpsertContext } from "../core/extensions/loader.js";
7
- import { describeExtensionBlueprint, lintExtensionBlueprint } from "./compose.js";
6
+ import type { AfterCommandHookContext,BeforeCommandHookContext,BeforeMutationHookContext,CommandHandlerResult,CommandOverrideContext,CommandOverrideResult,ExtensionActivationResult,ExtensionCapability,ExtensionCommandRegistry,ExtensionDeactivationResult,ExtensionGovernancePolicy,ExtensionHookRegistry,ExtensionCommandSdk,ExtensionLayer,ExtensionManifest,ExtensionParserRegistry,ExtensionPreflightRegistry,ExtensionRegistrationRegistry,ExtensionRendererRegistry,ExtensionServiceName,ExtensionServiceRegistry,FlagDefinition,OnIndexHookContext,OnReadHookContext,OnWriteHookContext,OutputRendererFormat,ParserOverrideContext,ParserOverrideResult,PreflightOverrideContext,PreflightOverrideResult,RegisteredExtensionCommandDefinition,RegisteredExtensionCommandOverride,RegisteredExtensionExporter,RegisteredExtensionFlagDefinitions,RegisteredExtensionImporter,RegisteredExtensionParserOverride,RegisteredExtensionPreflightOverride,RegisteredExtensionProjectProfile,RegisteredExtensionRendererOverride,RegisteredExtensionSchemaFieldDefinitions,RegisteredExtensionSchemaItemTypeDefinitions,RegisteredExtensionSchemaMigrationDefinition,RegisteredExtensionSearchProvider,RegisteredExtensionServiceOverride,RegisteredExtensionVectorStoreAdapter,RendererOverrideContext,RendererOverrideResult,SchemaFieldDefinition,SchemaItemTypeDefinition,SearchProviderEmbedBatchContext,SearchProviderEmbedContext,SearchProviderQueryContext,SearchProviderQueryExpansionContext,SearchProviderQueryExpansionResult,SearchProviderQueryResult,SearchProviderRerankContext,SearchProviderRerankResult,ServiceOverrideContext,ServiceOverrideResult,VectorStoreDeleteContext,VectorStoreQueryContext,VectorStoreQueryHit,VectorStoreUpsertContext } from "../core/extensions/loader.js";
7
+ import { describeExtensionBlueprint,lintExtensionBlueprint } from "./compose.js";
8
8
  import { describeExtensionActivation } from "../core/extensions/activation-summary.js";
9
- import type { DescribeExtensionActivationOptions, ExtensionActivationSummary } from "../core/extensions/activation-summary.js";
9
+ import type { DescribeExtensionActivationOptions,ExtensionActivationSummary } from "../core/extensions/activation-summary.js";
10
10
  import type { ProjectProfileDefinition } from "../core/profile/profile-presets.js";
11
11
  import { type ProjectProfileLintReport } from "../core/profile/profile-lint.js";
12
12
  import { renderExtensionSurfaceMarkdown } from "../core/extensions/activation-summary-markdown.js";
13
13
  import type { ExtensionSurfaceMarkdownOptions } from "../core/extensions/activation-summary-markdown.js";
14
- import type { ExtensionBlueprint, ExtensionBlueprintLintCode, ExtensionBlueprintLintFinding, ExtensionBlueprintLintResult, ExtensionBlueprintLintSeverity, ExtensionManifestCompatibilityManifest, ExtensionManifestCompatibilityResult, ExtensionManifestCompatibilityTarget, ExtensionPreflightReport, LintExtensionBlueprintOptions, PreflightExtensionOptions } from "./compose.js";
14
+ import type { ExtensionBlueprint,ExtensionBlueprintLintCode,ExtensionBlueprintLintFinding,ExtensionBlueprintLintResult,ExtensionBlueprintLintSeverity,ExtensionManifestCompatibilityManifest,ExtensionManifestCompatibilityResult,ExtensionManifestCompatibilityTarget,ExtensionPreflightReport,LintExtensionBlueprintOptions,PreflightExtensionOptions } from "./compose.js";
15
15
  import type { GlobalOptions } from "../core/shared/command-types.js";
16
- import type { PmPackageManifest, PmPackageResourceKind } from "../core/packages/manifest.js";
16
+ import type { PmPackageManifest,PmPackageResourceKind } from "../core/packages/manifest.js";
17
17
  /** Host-pinned TOON codecs for semantic package-output assertions without deep imports. */
18
- export { decode as decodeToon, encode as encodeToon } from "@toon-format/toon";
18
+ export { decode as decodeToon,encode as encodeToon } from "@toon-format/toon";
19
19
  /** Codec options and JSON values owned by the exact implementation used by the host. */
20
- export type { DecodeOptions as ToonDecodeOptions, EncodeOptions as ToonEncodeOptions, JsonValue as ToonJsonValue } from "@toon-format/toon";
21
- export { describeExtensionActivation, renderExtensionSurfaceMarkdown };
22
- export type { DescribeExtensionActivationOptions, ExtensionActivationSummary, } from "../core/extensions/activation-summary.js";
20
+ export type { DecodeOptions as ToonDecodeOptions,EncodeOptions as ToonEncodeOptions,JsonValue as ToonJsonValue } from "@toon-format/toon";
21
+ export { describeExtensionActivation,renderExtensionSurfaceMarkdown };
22
+ export type { DescribeExtensionActivationOptions,ExtensionActivationSummary,} from "../core/extensions/activation-summary.js";
23
23
  export type { ExtensionSurfaceMarkdownOptions } from "../core/extensions/activation-summary-markdown.js";
24
- export { describeExtensionBlueprint, lintExtensionBlueprint };
25
- export type { ExtensionBlueprint, ExtensionBlueprintLintCode, ExtensionBlueprintLintFinding, ExtensionBlueprintLintResult, ExtensionBlueprintLintSeverity, LintExtensionBlueprintOptions, };
24
+ export { describeExtensionBlueprint,lintExtensionBlueprint };
25
+ export type { ExtensionBlueprint,ExtensionBlueprintLintCode,ExtensionBlueprintLintFinding,ExtensionBlueprintLintResult,ExtensionBlueprintLintSeverity,LintExtensionBlueprintOptions,};
26
26
  /** Documents the activate extension for test options payload exchanged by command, SDK, and package integrations. */
27
27
  export interface ActivateExtensionForTestOptions {
28
28
  /** Value that configures or reports name for this contract. */
29
- name?: string;
29
+ name?:string;
30
30
  /** Value that configures or reports layer for this contract. */
31
- layer?: ExtensionLayer;
31
+ layer?:ExtensionLayer;
32
32
  /** Value that configures or reports capabilities for this contract. */
33
- capabilities?: readonly ExtensionCapability[];
33
+ capabilities?:readonly ExtensionCapability[];
34
34
  /** Value that configures or reports policy for this contract. */
35
- policy?: ExtensionGovernancePolicy;
35
+ policy?:ExtensionGovernancePolicy;
36
36
  }
37
37
  /** Documents the deactivate extension for test options payload exchanged by command, SDK, and package integrations. */
38
38
  export interface DeactivateExtensionForTestOptions {
39
39
  /** Overrides the in-memory extension name (defaults to `manifest.name` or `"test-extension"`). */
40
- name?: string;
40
+ name?:string;
41
41
  /** Overrides the layer recorded for the in-memory extension (defaults to `"project"`). */
42
- layer?: ExtensionLayer;
42
+ layer?:ExtensionLayer;
43
43
  /** 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. */
44
- activation?: Pick<ExtensionActivationResult, "failed">;
44
+ activation?:Pick<ExtensionActivationResult,"failed">;
45
45
  /** Per-hook teardown bound, forwarded as `deactivate_timeout_ms`. Use `0` (or `Infinity`) to wait indefinitely; omit to keep the host default. */
46
- deactivateTimeoutMs?: number;
46
+ deactivateTimeoutMs?:number;
47
47
  }
48
48
  /**
49
49
  * Options for {@link runRegisteredCommandForTest} — the inputs forwarded to a
@@ -51,28 +51,28 @@ deactivateTimeoutMs?: number;
51
51
  */
52
52
  export interface RunRegisteredCommandForTestOptions {
53
53
  /** 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. */
54
- command: string;
54
+ command:string;
55
55
  /** Positional arguments forwarded as `context.args` (default: none). */
56
- args?: readonly string[];
56
+ args?:readonly string[];
57
57
  /** Parsed flags/options forwarded as `context.options` (default: none). */
58
- options?: Record<string, unknown>;
58
+ options?:Record<string,unknown>;
59
59
  /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
60
- global?: Partial<GlobalOptions>;
60
+ global?:Partial<GlobalOptions>;
61
61
  /** Resolved tracker storage root forwarded as `context.pm_root` (default: `""`), normally `<workspace>/.agents/pm`; this is not the workspace root. */
62
- pmRoot?: string;
62
+ pmRoot?:string;
63
63
  /** Explicit host SDK override for specialized tests. Mutually exclusive with sdkFactory. */
64
- sdk?: ExtensionCommandSdk;
64
+ sdk?:ExtensionCommandSdk;
65
65
  /** 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. */
66
- sdkFactory?: (context: {
66
+ sdkFactory?:(context:{
67
67
  /** Tracker storage root for tracker data under `.agents/pm`, not the workspace root. */
68
- pmRoot: string;
69
- global: GlobalOptions;
68
+ pmRoot:string;
69
+ global:GlobalOptions;
70
70
  }) => ExtensionCommandSdk;
71
71
  }
72
72
  /** Options for invoking a registered transactional mutation guard in package tests. */
73
73
  export interface RunRegisteredMutationGuardForTestOptions {
74
74
  /** Synthetic proposed mutation context, including a host-bound read-only SDK. */
75
- context: BeforeMutationHookContext;
75
+ context:BeforeMutationHookContext;
76
76
  }
77
77
  /**
78
78
  * Options for {@link runRegisteredHookForTest} — the lifecycle `kind` to fire and
@@ -84,20 +84,20 @@ context: BeforeMutationHookContext;
84
84
  * pass an index context to a read hook.
85
85
  */
86
86
  export type RunRegisteredHookForTestOptions = {
87
- kind: "before_command";
88
- context: BeforeCommandHookContext;
87
+ kind:"before_command";
88
+ context:BeforeCommandHookContext;
89
89
  } | {
90
- kind: "after_command";
91
- context: AfterCommandHookContext;
90
+ kind:"after_command";
91
+ context:AfterCommandHookContext;
92
92
  } | {
93
- kind: "on_read";
94
- context: OnReadHookContext;
93
+ kind:"on_read";
94
+ context:OnReadHookContext;
95
95
  } | {
96
- kind: "on_write";
97
- context: OnWriteHookContext;
96
+ kind:"on_write";
97
+ context:OnWriteHookContext;
98
98
  } | {
99
- kind: "on_index";
100
- context: OnIndexHookContext;
99
+ kind:"on_index";
100
+ context:OnIndexHookContext;
101
101
  };
102
102
  /**
103
103
  * Maps each invokable search-provider operation to the context type its function
@@ -108,15 +108,15 @@ context: OnIndexHookContext;
108
108
  */
109
109
  export interface SearchProviderOperationContexts {
110
110
  /** Value that configures or reports query for this contract. */
111
- query: SearchProviderQueryContext;
111
+ query:SearchProviderQueryContext;
112
112
  /** Value that configures or reports embed for this contract. */
113
- embed: SearchProviderEmbedContext;
113
+ embed:SearchProviderEmbedContext;
114
114
  /** Value that configures or reports embed batch for this contract. */
115
- embedBatch: SearchProviderEmbedBatchContext;
115
+ embedBatch:SearchProviderEmbedBatchContext;
116
116
  /** Value that configures or reports query expansion for this contract. */
117
- queryExpansion: SearchProviderQueryExpansionContext;
117
+ queryExpansion:SearchProviderQueryExpansionContext;
118
118
  /** Value that configures or reports rerank for this contract. */
119
- rerank: SearchProviderRerankContext;
119
+ rerank:SearchProviderRerankContext;
120
120
  }
121
121
  /**
122
122
  * Maps each invokable search-provider operation to the result type its function
@@ -125,15 +125,15 @@ rerank: SearchProviderRerankContext;
125
125
  */
126
126
  export interface SearchProviderOperationResults {
127
127
  /** Value that configures or reports query for this contract. */
128
- query: SearchProviderQueryResult;
128
+ query:SearchProviderQueryResult;
129
129
  /** Value that configures or reports embed for this contract. */
130
- embed: number[];
130
+ embed:number[];
131
131
  /** Value that configures or reports embed batch for this contract. */
132
- embedBatch: number[][];
132
+ embedBatch:number[][];
133
133
  /** Value that configures or reports query expansion for this contract. */
134
- queryExpansion: SearchProviderQueryExpansionResult;
134
+ queryExpansion:SearchProviderQueryExpansionResult;
135
135
  /** Value that configures or reports rerank for this contract. */
136
- rerank: SearchProviderRerankResult;
136
+ rerank:SearchProviderRerankResult;
137
137
  }
138
138
  /**
139
139
  * Options for {@link runRegisteredSearchProviderForTest}: the registered
@@ -144,13 +144,13 @@ rerank: SearchProviderRerankResult;
144
144
  * {@link SearchProviderRerankContext}, and so on.
145
145
  */
146
146
  export type RunRegisteredSearchProviderForTestOptions = {
147
- [Operation in keyof SearchProviderOperationContexts]: {
147
+ [Operation in keyof SearchProviderOperationContexts]:{
148
148
  /** Registered provider name to resolve, matched case-insensitively as the host does. */
149
- provider: string;
149
+ provider:string;
150
150
  /** Provider operation to invoke. */
151
- operation: Operation;
151
+ operation:Operation;
152
152
  /** Synthetic context handed to the resolved operation function. */
153
- context: SearchProviderOperationContexts[Operation];
153
+ context:SearchProviderOperationContexts[Operation];
154
154
  };
155
155
  }[keyof SearchProviderOperationContexts];
156
156
  /**
@@ -161,11 +161,11 @@ context: SearchProviderOperationContexts[Operation];
161
161
  */
162
162
  export interface VectorStoreAdapterOperationContexts {
163
163
  /** Value that configures or reports query for this contract. */
164
- query: VectorStoreQueryContext;
164
+ query:VectorStoreQueryContext;
165
165
  /** Value that configures or reports upsert for this contract. */
166
- upsert: VectorStoreUpsertContext;
166
+ upsert:VectorStoreUpsertContext;
167
167
  /** Value that configures or reports delete for this contract. */
168
- delete: VectorStoreDeleteContext;
168
+ delete:VectorStoreDeleteContext;
169
169
  }
170
170
  /**
171
171
  * Maps each invokable vector-store-adapter operation to the result type its
@@ -175,11 +175,11 @@ delete: VectorStoreDeleteContext;
175
175
  */
176
176
  export interface VectorStoreAdapterOperationResults {
177
177
  /** Value that configures or reports query for this contract. */
178
- query: VectorStoreQueryHit[];
178
+ query:VectorStoreQueryHit[];
179
179
  /** Value that configures or reports upsert for this contract. */
180
- upsert: unknown;
180
+ upsert:unknown;
181
181
  /** Value that configures or reports delete for this contract. */
182
- delete: unknown;
182
+ delete:unknown;
183
183
  }
184
184
  /**
185
185
  * Options for {@link runRegisteredVectorStoreAdapterForTest}: the registered
@@ -190,13 +190,13 @@ delete: unknown;
190
190
  * {@link VectorStoreDeleteContext}, and so on.
191
191
  */
192
192
  export type RunRegisteredVectorStoreAdapterForTestOptions = {
193
- [Operation in keyof VectorStoreAdapterOperationContexts]: {
193
+ [Operation in keyof VectorStoreAdapterOperationContexts]:{
194
194
  /** Registered adapter name to resolve, matched case-insensitively as the host does. */
195
- adapter: string;
195
+ adapter:string;
196
196
  /** Adapter operation to invoke. */
197
- operation: Operation;
197
+ operation:Operation;
198
198
  /** Synthetic context handed to the resolved operation function. */
199
- context: VectorStoreAdapterOperationContexts[Operation];
199
+ context:VectorStoreAdapterOperationContexts[Operation];
200
200
  };
201
201
  }[keyof VectorStoreAdapterOperationContexts];
202
202
  /**
@@ -205,11 +205,11 @@ context: VectorStoreAdapterOperationContexts[Operation];
205
205
  */
206
206
  export interface RunRegisteredMigrationForTestOptions {
207
207
  /** Registered migration id to resolve, matched case-insensitively against `definition.id`. */
208
- migration: string;
208
+ migration:string;
209
209
  /** Optional extension name to disambiguate when several extensions register the same id. */
210
- extensionName?: string;
210
+ extensionName?:string;
211
211
  /** Resolved pm workspace root forwarded as `context.pm_root` (default `""`). */
212
- pmRoot?: string;
212
+ pmRoot?:string;
213
213
  }
214
214
  /**
215
215
  * Options for {@link runRegisteredImporterForTest} — the registered importer name
@@ -222,17 +222,17 @@ pmRoot?: string;
222
222
  */
223
223
  export interface RunRegisteredImporterForTestOptions {
224
224
  /** Registered importer name to resolve, e.g. `"csv"` for a `"csv import"` handler. */
225
- importer: string;
225
+ importer:string;
226
226
  /** Optional extension name to disambiguate when several extensions register the same importer. */
227
- extensionName?: string;
227
+ extensionName?:string;
228
228
  /** Positional arguments forwarded as `context.args` (default: none). */
229
- args?: readonly string[];
229
+ args?:readonly string[];
230
230
  /** Parsed flags/options forwarded as `context.options` (default: none). */
231
- options?: Record<string, unknown>;
231
+ options?:Record<string,unknown>;
232
232
  /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
233
- global?: Partial<GlobalOptions>;
233
+ global?:Partial<GlobalOptions>;
234
234
  /** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
235
- pmRoot?: string;
235
+ pmRoot?:string;
236
236
  }
237
237
  /**
238
238
  * Options for {@link runRegisteredExporterForTest} — the registered exporter name
@@ -245,186 +245,186 @@ pmRoot?: string;
245
245
  */
246
246
  export interface RunRegisteredExporterForTestOptions {
247
247
  /** Registered exporter name to resolve, e.g. `"csv"` for a `"csv export"` handler. */
248
- exporter: string;
248
+ exporter:string;
249
249
  /** Optional extension name to disambiguate when several extensions register the same exporter. */
250
- extensionName?: string;
250
+ extensionName?:string;
251
251
  /** Positional arguments forwarded as `context.args` (default: none). */
252
- args?: readonly string[];
252
+ args?:readonly string[];
253
253
  /** Parsed flags/options forwarded as `context.options` (default: none). */
254
- options?: Record<string, unknown>;
254
+ options?:Record<string,unknown>;
255
255
  /** Global option overrides merged onto the agent-safe test defaults (`{ json: true, quiet: true, noPager: true }`), forwarded as `context.global`. */
256
- global?: Partial<GlobalOptions>;
256
+ global?:Partial<GlobalOptions>;
257
257
  /** Resolved pm workspace root forwarded as `context.pm_root` (default: `""`). */
258
- pmRoot?: string;
258
+ pmRoot?:string;
259
259
  }
260
260
  /** Documents the extension deactivation expectation payload exchanged by command, SDK, and package integrations. */
261
261
  export interface ExtensionDeactivationExpectation {
262
262
  /** Expected count of extensions whose `deactivate` ran without throwing (default `1`). */
263
- deactivated?: number;
263
+ deactivated?:number;
264
264
  /** Expected count of teardown failures (default `0`). */
265
- failed?: number;
265
+ failed?:number;
266
266
  }
267
- type NamedRegistrationExpectation<TLegacyKey extends string, TValue, TDetails extends object = Record<never, never>> = TDetails & (({
268
- name: TValue;
269
- } & Partial<Record<TLegacyKey, TValue>>) | ({
270
- name?: TValue;
271
- } & Record<TLegacyKey, TValue>));
267
+ type NamedRegistrationExpectation<TLegacyKey extends string,TValue,TDetails extends object = Record<never,never>> = TDetails & (({
268
+ name:TValue;
269
+ } & Partial<Record<TLegacyKey,TValue>>) | ({
270
+ name?:TValue;
271
+ } & Record<TLegacyKey,TValue>));
272
272
  /** Documents the registered command contract expectation payload exchanged by command, SDK, and package integrations. `name` is canonical; `command` remains a backward-compatible alias. */
273
- export type RegisteredCommandContractExpectation = NamedRegistrationExpectation<"command", string, {
273
+ export type RegisteredCommandContractExpectation = NamedRegistrationExpectation<"command",string,{
274
274
  /** Value that configures or reports action for this contract. */
275
- action?: string;
275
+ action?:string;
276
276
  /** Value that configures or reports extension name for this contract. */
277
- extensionName?: string;
277
+ extensionName?:string;
278
278
  /** Value that configures or reports arguments for this contract. */
279
- arguments?: string[];
279
+ arguments?:string[];
280
280
  /** Value that configures or reports flags for this contract. */
281
- flags?: string[];
281
+ flags?:string[];
282
282
  }>;
283
283
  /** Documents the registered command contract assertion payload exchanged by command, SDK, and package integrations. */
284
284
  export interface RegisteredCommandContractAssertion {
285
285
  /** Value that configures or reports command for this contract. */
286
- command: RegisteredExtensionCommandDefinition;
286
+ command:RegisteredExtensionCommandDefinition;
287
287
  /** Value that configures or reports flags for this contract. */
288
- flags: FlagDefinition[];
288
+ flags:FlagDefinition[];
289
289
  }
290
290
  /** Documents the registered flags expectation payload exchanged by command, SDK, and package integrations. */
291
- export type RegisteredFlagsExpectation = NamedRegistrationExpectation<"targetCommand", string, {
291
+ export type RegisteredFlagsExpectation = NamedRegistrationExpectation<"targetCommand",string,{
292
292
  /** Value that configures or reports extension name for this contract. */
293
- extensionName?: string;
293
+ extensionName?:string;
294
294
  /** Value that configures or reports flags for this contract. */
295
- flags?: string[];
295
+ flags?:string[];
296
296
  }>;
297
297
  /** Public hook lifecycle kinds an extension can register through `api.hooks.*`. */
298
298
  export type RegisteredHookKind = "before_command" | "before_mutation" | "after_command" | "on_read" | "on_write" | "on_index";
299
- declare const HOOK_KIND_TO_REGISTRY_FIELD: Record<RegisteredHookKind, keyof ExtensionHookRegistry>;
299
+ declare const HOOK_KIND_TO_REGISTRY_FIELD:Record<RegisteredHookKind,keyof ExtensionHookRegistry>;
300
300
  type RegisteredHookEntry<TKind extends RegisteredHookKind> = NonNullable<ExtensionHookRegistry[(typeof HOOK_KIND_TO_REGISTRY_FIELD)[TKind]]>[number];
301
301
  /** Documents the registered hook expectation payload exchanged by command, SDK, and package integrations. */
302
302
  export interface RegisteredHookExpectation {
303
303
  /** Value that configures or reports kind for this contract. */
304
- kind: RegisteredHookKind;
304
+ kind:RegisteredHookKind;
305
305
  /** Value that configures or reports extension name for this contract. */
306
- extensionName?: string;
306
+ extensionName?:string;
307
307
  }
308
308
  /** Documents the registered search provider expectation payload exchanged by command, SDK, and package integrations. */
309
- export type RegisteredSearchProviderExpectation = NamedRegistrationExpectation<"provider", string, {
309
+ export type RegisteredSearchProviderExpectation = NamedRegistrationExpectation<"provider",string,{
310
310
  /** Value that configures or reports extension name for this contract. */
311
- extensionName?: string;
311
+ extensionName?:string;
312
312
  }>;
313
313
  /** Documents the registered vector store adapter expectation payload exchanged by command, SDK, and package integrations. */
314
- export type RegisteredVectorStoreAdapterExpectation = NamedRegistrationExpectation<"adapter", string, {
314
+ export type RegisteredVectorStoreAdapterExpectation = NamedRegistrationExpectation<"adapter",string,{
315
315
  /** Value that configures or reports extension name for this contract. */
316
- extensionName?: string;
316
+ extensionName?:string;
317
317
  }>;
318
318
  /** Documents the registered importer expectation payload exchanged by command, SDK, and package integrations. */
319
- export type RegisteredImporterExpectation = NamedRegistrationExpectation<"importer", string, {
319
+ export type RegisteredImporterExpectation = NamedRegistrationExpectation<"importer",string,{
320
320
  /** Value that configures or reports extension name for this contract. */
321
- extensionName?: string;
321
+ extensionName?:string;
322
322
  }>;
323
323
  /** Documents the registered exporter expectation payload exchanged by command, SDK, and package integrations. */
324
- export type RegisteredExporterExpectation = NamedRegistrationExpectation<"exporter", string, {
324
+ export type RegisteredExporterExpectation = NamedRegistrationExpectation<"exporter",string,{
325
325
  /** Value that configures or reports extension name for this contract. */
326
- extensionName?: string;
326
+ extensionName?:string;
327
327
  }>;
328
328
  /** Documents the registered item field expectation payload exchanged by command, SDK, and package integrations. */
329
- export type RegisteredItemFieldExpectation = NamedRegistrationExpectation<"field", string, {
329
+ export type RegisteredItemFieldExpectation = NamedRegistrationExpectation<"field",string,{
330
330
  /** Value that configures or reports extension name for this contract. */
331
- extensionName?: string;
331
+ extensionName?:string;
332
332
  /** Schema type that determines the shape and validation rules for this value. */
333
- type?: SchemaFieldDefinition["type"];
333
+ type?:SchemaFieldDefinition["type"];
334
334
  }>;
335
335
  /** Documents the registered item field assertion payload exchanged by command, SDK, and package integrations. */
336
336
  export interface RegisteredItemFieldAssertion {
337
337
  /** Value that configures or reports registration for this contract. */
338
- registration: RegisteredExtensionSchemaFieldDefinitions;
338
+ registration:RegisteredExtensionSchemaFieldDefinitions;
339
339
  /** Value that configures or reports field for this contract. */
340
- field: SchemaFieldDefinition;
340
+ field:SchemaFieldDefinition;
341
341
  }
342
342
  /** Documents the registered item type expectation payload exchanged by command, SDK, and package integrations. */
343
- export type RegisteredItemTypeExpectation = NamedRegistrationExpectation<"itemType", string, {
343
+ export type RegisteredItemTypeExpectation = NamedRegistrationExpectation<"itemType",string,{
344
344
  /** Value that configures or reports extension name for this contract. */
345
- extensionName?: string;
345
+ extensionName?:string;
346
346
  /** Value that configures or reports folder for this contract. */
347
- folder?: string;
347
+ folder?:string;
348
348
  }>;
349
349
  /** Documents the registered item type assertion payload exchanged by command, SDK, and package integrations. */
350
350
  export interface RegisteredItemTypeAssertion {
351
351
  /** Value that configures or reports registration for this contract. */
352
- registration: RegisteredExtensionSchemaItemTypeDefinitions;
352
+ registration:RegisteredExtensionSchemaItemTypeDefinitions;
353
353
  /** Schema type that determines the shape and validation rules for this value. */
354
- itemType: SchemaItemTypeDefinition;
354
+ itemType:SchemaItemTypeDefinition;
355
355
  }
356
356
  /** Documents the registered command override expectation payload exchanged by command, SDK, and package integrations. */
357
- export type RegisteredCommandOverrideExpectation = NamedRegistrationExpectation<"command", string, {
357
+ export type RegisteredCommandOverrideExpectation = NamedRegistrationExpectation<"command",string,{
358
358
  /** Value that configures or reports extension name for this contract. */
359
- extensionName?: string;
359
+ extensionName?:string;
360
360
  }>;
361
361
  /** Documents the registered parser override expectation payload exchanged by command, SDK, and package integrations. */
362
- export type RegisteredParserOverrideExpectation = NamedRegistrationExpectation<"command", string, {
362
+ export type RegisteredParserOverrideExpectation = NamedRegistrationExpectation<"command",string,{
363
363
  /** Value that configures or reports extension name for this contract. */
364
- extensionName?: string;
364
+ extensionName?:string;
365
365
  }>;
366
366
  /** Documents the registered preflight override expectation payload exchanged by command, SDK, and package integrations. */
367
367
  export interface RegisteredPreflightOverrideExpectation {
368
368
  /** Value that configures or reports extension name for this contract. */
369
- extensionName?: string;
369
+ extensionName?:string;
370
370
  }
371
371
  /** Documents the registered renderer override expectation payload exchanged by command, SDK, and package integrations. */
372
- export type RegisteredRendererOverrideExpectation = NamedRegistrationExpectation<"format", OutputRendererFormat, {
372
+ export type RegisteredRendererOverrideExpectation = NamedRegistrationExpectation<"format",OutputRendererFormat,{
373
373
  /** Value that configures or reports extension name for this contract. */
374
- extensionName?: string;
374
+ extensionName?:string;
375
375
  }>;
376
376
  /** Documents the registered service override expectation payload exchanged by command, SDK, and package integrations. */
377
- export type RegisteredServiceOverrideExpectation = NamedRegistrationExpectation<"service", ExtensionServiceName, {
377
+ export type RegisteredServiceOverrideExpectation = NamedRegistrationExpectation<"service",ExtensionServiceName,{
378
378
  /** Value that configures or reports extension name for this contract. */
379
- extensionName?: string;
379
+ extensionName?:string;
380
380
  }>;
381
381
  /** Documents the registered migration expectation payload exchanged by command, SDK, and package integrations. */
382
- export type RegisteredMigrationExpectation = NamedRegistrationExpectation<"migration", string, {
382
+ export type RegisteredMigrationExpectation = NamedRegistrationExpectation<"migration",string,{
383
383
  /** Value that configures or reports extension name for this contract. */
384
- extensionName?: string;
384
+ extensionName?:string;
385
385
  /** Value that configures or reports mandatory for this contract. */
386
- mandatory?: boolean;
386
+ mandatory?:boolean;
387
387
  }>;
388
388
  /** Documents the registered project-profile expectation payload exchanged by command, SDK, and package integrations. */
389
- export type RegisteredProfileExpectation = NamedRegistrationExpectation<"profile", string, {
389
+ export type RegisteredProfileExpectation = NamedRegistrationExpectation<"profile",string,{
390
390
  /** Restrict the match to a single extension when several are active. */
391
- extensionName?: string;
391
+ extensionName?:string;
392
392
  }>;
393
393
  /** Documents the registered project-profile assertion payload exchanged by command, SDK, and package integrations. */
394
394
  export interface RegisteredProfileAssertion {
395
395
  /** The matching registration entry. */
396
- registration: RegisteredExtensionProjectProfile;
396
+ registration:RegisteredExtensionProjectProfile;
397
397
  /** The registered profile definition. */
398
- profile: ProjectProfileDefinition;
398
+ profile:ProjectProfileDefinition;
399
399
  }
400
400
  /** Documents the extension capability usage expectation payload exchanged by command, SDK, and package integrations. */
401
401
  export interface ExtensionCapabilityUsageExpectation {
402
402
  /** Capabilities the manifest declares. Mirror `manifest.capabilities` here so the assertion fails when the manifest grants more than the code uses. */
403
- declared: readonly ExtensionCapability[];
403
+ declared:readonly ExtensionCapability[];
404
404
  /** Restrict reconciliation to a single extension when the activation has several. */
405
- extensionName?: string;
405
+ extensionName?:string;
406
406
  /** 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. */
407
- allowUnused?: readonly ExtensionCapability[];
407
+ allowUnused?:readonly ExtensionCapability[];
408
408
  }
409
409
  /** Documents the extension capability usage assertion payload exchanged by command, SDK, and package integrations. */
410
410
  export interface ExtensionCapabilityUsageAssertion {
411
411
  /** Declared capabilities considered, sorted and de-duplicated. */
412
- declared: ExtensionCapability[];
412
+ declared:ExtensionCapability[];
413
413
  /** Capabilities the extension actually registered against, sorted. */
414
- used: ExtensionCapability[];
414
+ used:ExtensionCapability[];
415
415
  /** Declared capabilities with no matching registration after the allowlist. */
416
- unused: ExtensionCapability[];
416
+ unused:ExtensionCapability[];
417
417
  }
418
418
  /** Restricts package manifest resource expectation values accepted by command, SDK, and storage contracts. */
419
- export type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind, readonly string[]>>;
419
+ export type PackageManifestResourceExpectation = Partial<Record<PmPackageResourceKind,readonly string[]>>;
420
420
  /** Documents the package manifest expectation payload exchanged by command, SDK, and package integrations. */
421
421
  export interface PackageManifestExpectation {
422
422
  /** Value that configures or reports package name for this contract. */
423
- packageName?: string;
423
+ packageName?:string;
424
424
  /** Value that configures or reports aliases for this contract. */
425
- aliases?: readonly string[];
425
+ aliases?:readonly string[];
426
426
  /** Value that configures or reports resources for this contract. */
427
- resources?: PackageManifestResourceExpectation;
427
+ resources?:PackageManifestResourceExpectation;
428
428
  }
429
429
  /**
430
430
  * Options for {@link ExtensionTestHarness.renderMarkdown}.
@@ -434,7 +434,7 @@ export interface RenderExtensionHarnessMarkdownOptions extends ExtensionSurfaceM
434
434
  * Restrict the rendered summary to one activated extension by name. Defaults
435
435
  * to the full activation union, matching {@link ExtensionTestHarness.activationSummary}.
436
436
  */
437
- extensionName?: string;
437
+ extensionName?:string;
438
438
  }
439
439
  /**
440
440
  * Activate one in-memory extension module for package tests.
@@ -442,7 +442,7 @@ extensionName?: string;
442
442
  * This uses pm's real registration validation and activation engine while
443
443
  * avoiding private loader imports, filesystem manifests, or workspace setup.
444
444
  */
445
- export declare function activateExtensionForTest(module: unknown, options?: ActivateExtensionForTestOptions): Promise<ExtensionActivationResult>;
445
+ export declare function activateExtensionForTest(module:unknown,options?:ActivateExtensionForTestOptions):Promise<ExtensionActivationResult>;
446
446
  /**
447
447
  * Deactivate one in-memory extension module for package tests — the teardown
448
448
  * counterpart to {@link activateExtensionForTest}.
@@ -454,7 +454,7 @@ export declare function activateExtensionForTest(module: unknown, options?: Acti
454
454
  * workspace. Resolve `name`/`layer` the same way {@link activateExtensionForTest}
455
455
  * does so a forwarded `activation` result skips a failed extension correctly.
456
456
  */
457
- export declare function deactivateExtensionForTest(module: unknown, options?: DeactivateExtensionForTestOptions): Promise<ExtensionDeactivationResult>;
457
+ export declare function deactivateExtensionForTest(module:unknown,options?:DeactivateExtensionForTestOptions):Promise<ExtensionDeactivationResult>;
458
458
  /**
459
459
  * Invoke a registered extension command handler and return its real
460
460
  * {@link CommandHandlerResult} so package tests can assert on behavior — not
@@ -480,9 +480,9 @@ export declare function deactivateExtensionForTest(module: unknown, options?: De
480
480
  * asserted. A handler that throws an error carrying a numeric `exitCode`
481
481
  * propagates the throw, matching runtime semantics.
482
482
  */
483
- export declare function runRegisteredCommandForTest(commands: ExtensionCommandRegistry, options: RunRegisteredCommandForTestOptions): Promise<CommandHandlerResult>;
483
+ export declare function runRegisteredCommandForTest(commands:ExtensionCommandRegistry,options:RunRegisteredCommandForTestOptions):Promise<CommandHandlerResult>;
484
484
  /** Invoke registered transactional mutation guards through the same fail-closed runtime used by real writes. */
485
- export declare function runRegisteredMutationGuardForTest(hooks: ExtensionHookRegistry, options: RunRegisteredMutationGuardForTestOptions): Promise<void>;
485
+ export declare function runRegisteredMutationGuardForTest(hooks:ExtensionHookRegistry,options:RunRegisteredMutationGuardForTestOptions):Promise<void>;
486
486
  /**
487
487
  * Fire every registered lifecycle hook of a given `kind` through pm's real hook
488
488
  * runner and return the warnings array so package tests can assert on behavior —
@@ -502,7 +502,7 @@ export declare function runRegisteredMutationGuardForTest(hooks: ExtensionHookRe
502
502
  * when no hook of `kind` is registered, since firing a hook the extension never
503
503
  * registered is a wiring/typo bug in the test rather than a behavior under test.
504
504
  */
505
- export declare function runRegisteredHookForTest(hooks: ExtensionHookRegistry, options: RunRegisteredHookForTestOptions): Promise<string[]>;
505
+ export declare function runRegisteredHookForTest(hooks:ExtensionHookRegistry,options:RunRegisteredHookForTestOptions):Promise<string[]>;
506
506
  /**
507
507
  * Invoke a registered parser override through pm's real runner and return the
508
508
  * resolved {@link ParserOverrideResult}, so package tests can assert the rewritten
@@ -515,7 +515,7 @@ export declare function runRegisteredHookForTest(hooks: ExtensionHookRegistry, o
515
515
  * context on success, or `overridden: false` with an
516
516
  * `extension_parser_override_failed:*` warning when the override throws.
517
517
  */
518
- export declare function runRegisteredParserOverrideForTest(parsers: ExtensionParserRegistry, context: ParserOverrideContext): Promise<ParserOverrideResult>;
518
+ export declare function runRegisteredParserOverrideForTest(parsers:ExtensionParserRegistry,context:ParserOverrideContext):Promise<ParserOverrideResult>;
519
519
  /**
520
520
  * Invoke the active preflight override through pm's real runner and return the
521
521
  * resolved {@link PreflightOverrideResult}, so package tests can assert the
@@ -528,7 +528,7 @@ export declare function runRegisteredParserOverrideForTest(parsers: ExtensionPar
528
528
  * or `overridden: false` with an `extension_preflight_override_failed:*` warning
529
529
  * when the override throws.
530
530
  */
531
- export declare function runRegisteredPreflightOverrideForTest(preflight: ExtensionPreflightRegistry, context: PreflightOverrideContext): Promise<PreflightOverrideResult>;
531
+ export declare function runRegisteredPreflightOverrideForTest(preflight:ExtensionPreflightRegistry,context:PreflightOverrideContext):Promise<PreflightOverrideResult>;
532
532
  /**
533
533
  * Invoke a registered command-result override through pm's real runner and return
534
534
  * the resolved {@link CommandOverrideResult}, so package tests can assert how an
@@ -543,7 +543,7 @@ export declare function runRegisteredPreflightOverrideForTest(preflight: Extensi
543
543
  * runtime emits when an override returns a Promise (command overrides are
544
544
  * synchronous), or an `extension_command_override_failed:*` warning on throw.
545
545
  */
546
- export declare function runRegisteredCommandOverrideForTest(commands: ExtensionCommandRegistry, context: CommandOverrideContext): Promise<CommandOverrideResult>;
546
+ export declare function runRegisteredCommandOverrideForTest(commands:ExtensionCommandRegistry,context:CommandOverrideContext):Promise<CommandOverrideResult>;
547
547
  /**
548
548
  * Invoke a registered renderer override through pm's real runner and return the
549
549
  * resolved {@link RendererOverrideResult}, so package tests can assert the custom
@@ -556,7 +556,7 @@ export declare function runRegisteredCommandOverrideForTest(commands: ExtensionC
556
556
  * `extension_renderer_invalid_result:*` / `extension_renderer_failed:*` warning
557
557
  * where applicable) when the override returns a non-string or throws.
558
558
  */
559
- export declare function runRegisteredRendererOverrideForTest(renderers: ExtensionRendererRegistry, context: RendererOverrideContext): Promise<RendererOverrideResult>;
559
+ export declare function runRegisteredRendererOverrideForTest(renderers:ExtensionRendererRegistry,context:RendererOverrideContext):Promise<RendererOverrideResult>;
560
560
  /**
561
561
  * Invoke a registered service override through pm's real runner and return the
562
562
  * resolved {@link ServiceOverrideResult}, so package tests can assert how an
@@ -568,7 +568,7 @@ export declare function runRegisteredRendererOverrideForTest(renderers: Extensio
568
568
  * the override's result when it claims the payload, or `handled: false` with the
569
569
  * original payload (and any `extension_service_override_*` warnings) otherwise.
570
570
  */
571
- export declare function runRegisteredServiceOverrideForTest(services: ExtensionServiceRegistry, context: ServiceOverrideContext): Promise<ServiceOverrideResult>;
571
+ export declare function runRegisteredServiceOverrideForTest(services:ExtensionServiceRegistry,context:ServiceOverrideContext):Promise<ServiceOverrideResult>;
572
572
  /**
573
573
  * Invoke an operation of a registered search provider through the same name
574
574
  * resolution the host uses and return the operation's result, so package tests
@@ -589,11 +589,11 @@ export declare function runRegisteredServiceOverrideForTest(services: ExtensionS
589
589
  * the requested operation, since invoking an absent provider/operation is a
590
590
  * wiring bug in the test rather than a behavior under test.
591
591
  */
592
- export declare function runRegisteredSearchProviderForTest<Operation extends keyof SearchProviderOperationContexts>(registrations: ExtensionRegistrationRegistry, options: {
593
- provider: string;
594
- operation: Operation;
595
- context: SearchProviderOperationContexts[Operation];
596
- }): Promise<SearchProviderOperationResults[Operation]>;
592
+ export declare function runRegisteredSearchProviderForTest<Operation extends keyof SearchProviderOperationContexts>(registrations:ExtensionRegistrationRegistry,options:{
593
+ provider:string;
594
+ operation:Operation;
595
+ context:SearchProviderOperationContexts[Operation];
596
+ }):Promise<SearchProviderOperationResults[Operation]>;
597
597
  /**
598
598
  * Invoke an operation of a registered vector store adapter through the same name
599
599
  * resolution the host uses and return the operation's result, so package tests
@@ -612,11 +612,11 @@ context: SearchProviderOperationContexts[Operation];
612
612
  * registered, and a separate error when the resolved adapter does not implement
613
613
  * the requested operation.
614
614
  */
615
- export declare function runRegisteredVectorStoreAdapterForTest<Operation extends keyof VectorStoreAdapterOperationContexts>(registrations: ExtensionRegistrationRegistry, options: {
616
- adapter: string;
617
- operation: Operation;
618
- context: VectorStoreAdapterOperationContexts[Operation];
619
- }): Promise<VectorStoreAdapterOperationResults[Operation]>;
615
+ export declare function runRegisteredVectorStoreAdapterForTest<Operation extends keyof VectorStoreAdapterOperationContexts>(registrations:ExtensionRegistrationRegistry,options:{
616
+ adapter:string;
617
+ operation:Operation;
618
+ context:VectorStoreAdapterOperationContexts[Operation];
619
+ }):Promise<VectorStoreAdapterOperationResults[Operation]>;
620
620
  /**
621
621
  * Invoke a registered schema migration's `run` function through the same runtime
622
622
  * definition the host executes and return its result, so package tests can assert
@@ -637,7 +637,7 @@ context: VectorStoreAdapterOperationContexts[Operation];
637
637
  * Throws when the resolved migration declares no `run` function, since invoking a
638
638
  * runless migration is a wiring bug in the test rather than a behavior under test.
639
639
  */
640
- export declare function runRegisteredMigrationForTest(registrations: ExtensionRegistrationRegistry, options: RunRegisteredMigrationForTestOptions): Promise<unknown>;
640
+ export declare function runRegisteredMigrationForTest(registrations:ExtensionRegistrationRegistry,options:RunRegisteredMigrationForTestOptions):Promise<unknown>;
641
641
  /**
642
642
  * Invoke a registered extension importer through pm's real handler-dispatch
643
643
  * engine and return its {@link CommandHandlerResult}, so package tests can assert
@@ -666,7 +666,7 @@ export declare function runRegisteredMigrationForTest(registrations: ExtensionRe
666
666
  * when no importer matches, since that is a wiring/typo bug in the test rather
667
667
  * than a behavior under test.
668
668
  */
669
- export declare function runRegisteredImporterForTest(activation: ExtensionActivationResult, options: RunRegisteredImporterForTestOptions): Promise<CommandHandlerResult>;
669
+ export declare function runRegisteredImporterForTest(activation:ExtensionActivationResult,options:RunRegisteredImporterForTestOptions):Promise<CommandHandlerResult>;
670
670
  /**
671
671
  * Invoke a registered extension exporter through pm's real handler-dispatch
672
672
  * engine and return its {@link CommandHandlerResult}, so package tests can assert
@@ -685,20 +685,20 @@ export declare function runRegisteredImporterForTest(activation: ExtensionActiva
685
685
  * when no exporter matches, since that is a wiring/typo bug in the test rather
686
686
  * than a behavior under test.
687
687
  */
688
- export declare function runRegisteredExporterForTest(activation: ExtensionActivationResult, options: RunRegisteredExporterForTestOptions): Promise<CommandHandlerResult>;
688
+ export declare function runRegisteredExporterForTest(activation:ExtensionActivationResult,options:RunRegisteredExporterForTestOptions):Promise<CommandHandlerResult>;
689
689
  /**
690
690
  * Assert that an {@link ExtensionDeactivationResult} reports the expected clean
691
691
  * teardown counts, throwing a descriptive error otherwise. Defaults assert the
692
692
  * single-extension happy path — exactly one extension deactivated and none
693
693
  * failed. Returns the result so assertions can chain.
694
694
  */
695
- export declare function assertExtensionDeactivated(result: ExtensionDeactivationResult, expectation?: ExtensionDeactivationExpectation): ExtensionDeactivationResult;
695
+ export declare function assertExtensionDeactivated(result:ExtensionDeactivationResult,expectation?:ExtensionDeactivationExpectation):ExtensionDeactivationResult;
696
696
  /** Assert that a normalized package manifest advertises expected package resources. Pair with `readPmPackageManifest(packageRoot)` in package tests. */
697
- export declare function assertPackageManifest(manifest: PmPackageManifest, expectation: PackageManifestExpectation): PmPackageManifest;
697
+ export declare function assertPackageManifest(manifest:PmPackageManifest,expectation:PackageManifestExpectation):PmPackageManifest;
698
698
  /** Assert that an activated extension registration registry contains a command contract with the expected public metadata. */
699
- export declare function assertRegisteredCommandContract(registrations: ExtensionRegistrationRegistry, expectation: RegisteredCommandContractExpectation): RegisteredCommandContractAssertion;
699
+ export declare function assertRegisteredCommandContract(registrations:ExtensionRegistrationRegistry,expectation:RegisteredCommandContractExpectation):RegisteredCommandContractAssertion;
700
700
  /** Assert that an activated extension registration registry contains flags injected into an existing command through `api.registerFlags(...)`. */
701
- export declare function assertRegisteredFlags(registrations: ExtensionRegistrationRegistry, expectation: RegisteredFlagsExpectation): RegisteredExtensionFlagDefinitions;
701
+ export declare function assertRegisteredFlags(registrations:ExtensionRegistrationRegistry,expectation:RegisteredFlagsExpectation):RegisteredExtensionFlagDefinitions;
702
702
  /**
703
703
  * Assert that an activated extension hook registry contains a hook of the
704
704
  * expected lifecycle kind (optionally scoped to a specific extension).
@@ -706,21 +706,21 @@ export declare function assertRegisteredFlags(registrations: ExtensionRegistrati
706
706
  * Hooks are surfaced via `ExtensionActivationResult.hooks`, not the command
707
707
  * registration registry, so this helper accepts an `ExtensionHookRegistry`.
708
708
  */
709
- export declare function assertRegisteredHook<TKind extends RegisteredHookKind>(hooks: ExtensionHookRegistry, expectation: RegisteredHookExpectation & {
710
- kind: TKind;
711
- }): RegisteredHookEntry<TKind>;
709
+ export declare function assertRegisteredHook<TKind extends RegisteredHookKind>(hooks:ExtensionHookRegistry,expectation:RegisteredHookExpectation & {
710
+ kind:TKind;
711
+ }):RegisteredHookEntry<TKind>;
712
712
  /** Assert that an activated extension registration registry contains a search provider with the expected name (optionally scoped to a specific extension). */
713
- export declare function assertRegisteredSearchProvider(registrations: ExtensionRegistrationRegistry, expectation: RegisteredSearchProviderExpectation): RegisteredExtensionSearchProvider;
713
+ export declare function assertRegisteredSearchProvider(registrations:ExtensionRegistrationRegistry,expectation:RegisteredSearchProviderExpectation):RegisteredExtensionSearchProvider;
714
714
  /** Assert that an activated extension registration registry contains a vector store adapter with the expected name (optionally scoped to a specific extension). */
715
- export declare function assertRegisteredVectorStoreAdapter(registrations: ExtensionRegistrationRegistry, expectation: RegisteredVectorStoreAdapterExpectation): RegisteredExtensionVectorStoreAdapter;
715
+ export declare function assertRegisteredVectorStoreAdapter(registrations:ExtensionRegistrationRegistry,expectation:RegisteredVectorStoreAdapterExpectation):RegisteredExtensionVectorStoreAdapter;
716
716
  /** Assert that an activated extension registration registry contains an importer for the expected format/name (optionally scoped to a specific extension). */
717
- export declare function assertRegisteredImporter(registrations: ExtensionRegistrationRegistry, expectation: RegisteredImporterExpectation): RegisteredExtensionImporter;
717
+ export declare function assertRegisteredImporter(registrations:ExtensionRegistrationRegistry,expectation:RegisteredImporterExpectation):RegisteredExtensionImporter;
718
718
  /** Assert that an activated extension registration registry contains an exporter for the expected format/name (optionally scoped to a specific extension). */
719
- export declare function assertRegisteredExporter(registrations: ExtensionRegistrationRegistry, expectation: RegisteredExporterExpectation): RegisteredExtensionExporter;
719
+ export declare function assertRegisteredExporter(registrations:ExtensionRegistrationRegistry,expectation:RegisteredExporterExpectation):RegisteredExtensionExporter;
720
720
  /** Assert that an activated extension registration registry contains a custom item field definition (optionally scoped to a specific extension). */
721
- export declare function assertRegisteredItemField(registrations: ExtensionRegistrationRegistry, expectation: RegisteredItemFieldExpectation): RegisteredItemFieldAssertion;
721
+ export declare function assertRegisteredItemField(registrations:ExtensionRegistrationRegistry,expectation:RegisteredItemFieldExpectation):RegisteredItemFieldAssertion;
722
722
  /** Assert that an activated extension registration registry contains a custom item type definition (optionally scoped to a specific extension). */
723
- export declare function assertRegisteredItemType(registrations: ExtensionRegistrationRegistry, expectation: RegisteredItemTypeExpectation): RegisteredItemTypeAssertion;
723
+ export declare function assertRegisteredItemType(registrations:ExtensionRegistrationRegistry,expectation:RegisteredItemTypeExpectation):RegisteredItemTypeAssertion;
724
724
  /**
725
725
  * Assert that an activated extension registration registry contains a project
726
726
  * profile registered via `api.registerProfile(profile)` (optionally scoped to a
@@ -733,7 +733,7 @@ export declare function assertRegisteredItemType(registrations: ExtensionRegistr
733
733
  * (item types, item fields), a profile is verified by presence — it is staged,
734
734
  * not executed — so there is no `runRegisteredProfileForTest` counterpart.
735
735
  */
736
- export declare function assertRegisteredProfile(registrations: ExtensionRegistrationRegistry, expectation: RegisteredProfileExpectation): RegisteredProfileAssertion;
736
+ export declare function assertRegisteredProfile(registrations:ExtensionRegistrationRegistry,expectation:RegisteredProfileExpectation):RegisteredProfileAssertion;
737
737
  /**
738
738
  * Assert that an activated extension command registry contains a command
739
739
  * override registered via `api.registerCommand(command, override)` (optionally
@@ -743,7 +743,7 @@ export declare function assertRegisteredProfile(registrations: ExtensionRegistra
743
743
  * the command registration registry, so this helper accepts an
744
744
  * `ExtensionCommandRegistry`.
745
745
  */
746
- export declare function assertRegisteredCommandOverride(commands: ExtensionCommandRegistry, expectation: RegisteredCommandOverrideExpectation): RegisteredExtensionCommandOverride;
746
+ export declare function assertRegisteredCommandOverride(commands:ExtensionCommandRegistry,expectation:RegisteredCommandOverrideExpectation):RegisteredExtensionCommandOverride;
747
747
  /**
748
748
  * Assert that an activated extension parser registry contains a parser override
749
749
  * registered via `api.registerParser(command, override)` (optionally scoped to
@@ -753,7 +753,7 @@ export declare function assertRegisteredCommandOverride(commands: ExtensionComma
753
753
  * command registration registry, so this helper accepts an
754
754
  * `ExtensionParserRegistry`.
755
755
  */
756
- export declare function assertRegisteredParserOverride(parsers: ExtensionParserRegistry, expectation: RegisteredParserOverrideExpectation): RegisteredExtensionParserOverride;
756
+ export declare function assertRegisteredParserOverride(parsers:ExtensionParserRegistry,expectation:RegisteredParserOverrideExpectation):RegisteredExtensionParserOverride;
757
757
  /**
758
758
  * Assert that an activated extension preflight registry contains a preflight
759
759
  * override registered via `api.registerPreflight(override)` (optionally scoped
@@ -764,7 +764,7 @@ export declare function assertRegisteredParserOverride(parsers: ExtensionParserR
764
764
  * `extensionName`. Preflight overrides are surfaced via
765
765
  * `ExtensionActivationResult.preflight`.
766
766
  */
767
- export declare function assertRegisteredPreflightOverride(preflight: ExtensionPreflightRegistry, expectation?: RegisteredPreflightOverrideExpectation): RegisteredExtensionPreflightOverride;
767
+ export declare function assertRegisteredPreflightOverride(preflight:ExtensionPreflightRegistry,expectation?:RegisteredPreflightOverrideExpectation):RegisteredExtensionPreflightOverride;
768
768
  /**
769
769
  * Assert that an activated extension renderer registry contains a renderer
770
770
  * override registered via `api.registerRenderer(format, renderer)` for the
@@ -772,7 +772,7 @@ export declare function assertRegisteredPreflightOverride(preflight: ExtensionPr
772
772
  *
773
773
  * Renderer overrides are surfaced via `ExtensionActivationResult.renderers`.
774
774
  */
775
- export declare function assertRegisteredRendererOverride(renderers: ExtensionRendererRegistry, expectation: RegisteredRendererOverrideExpectation): RegisteredExtensionRendererOverride;
775
+ export declare function assertRegisteredRendererOverride(renderers:ExtensionRendererRegistry,expectation:RegisteredRendererOverrideExpectation):RegisteredExtensionRendererOverride;
776
776
  /**
777
777
  * Assert that an activated extension service registry contains a service override
778
778
  * registered via `api.registerService(service, override)` for the expected
@@ -782,7 +782,7 @@ export declare function assertRegisteredRendererOverride(renderers: ExtensionRen
782
782
  * command registration registry, so this helper accepts an
783
783
  * `ExtensionServiceRegistry`.
784
784
  */
785
- export declare function assertRegisteredServiceOverride(services: ExtensionServiceRegistry, expectation: RegisteredServiceOverrideExpectation): RegisteredExtensionServiceOverride;
785
+ export declare function assertRegisteredServiceOverride(services:ExtensionServiceRegistry,expectation:RegisteredServiceOverrideExpectation):RegisteredExtensionServiceOverride;
786
786
  /**
787
787
  * Assert that an activated extension registration registry contains a schema
788
788
  * migration registered via `api.registerMigration(definition)` with the expected
@@ -791,7 +791,7 @@ export declare function assertRegisteredServiceOverride(services: ExtensionServi
791
791
  *
792
792
  * Migrations are surfaced via `ExtensionActivationResult.registrations.migrations`.
793
793
  */
794
- export declare function assertRegisteredMigration(registrations: ExtensionRegistrationRegistry, expectation: RegisteredMigrationExpectation): RegisteredExtensionSchemaMigrationDefinition;
794
+ export declare function assertRegisteredMigration(registrations:ExtensionRegistrationRegistry,expectation:RegisteredMigrationExpectation):RegisteredExtensionSchemaMigrationDefinition;
795
795
  /**
796
796
  * Assert that an activated extension declares no capability it never uses
797
797
  * (least privilege). Pass the same capabilities as `manifest.capabilities` via
@@ -803,7 +803,7 @@ export declare function assertRegisteredMigration(registrations: ExtensionRegist
803
803
  * author catch an over-broad manifest at `npm test` time. Returns the
804
804
  * declared/used/unused breakdown for further assertions.
805
805
  */
806
- export declare function assertExtensionCapabilityUsage(activation: ExtensionActivationResult, expectation: ExtensionCapabilityUsageExpectation): ExtensionCapabilityUsageAssertion;
806
+ export declare function assertExtensionCapabilityUsage(activation:ExtensionActivationResult,expectation:ExtensionCapabilityUsageExpectation):ExtensionCapabilityUsageAssertion;
807
807
  /**
808
808
  * Preflight a declarative {@link ExtensionBlueprint} in a test, throwing if it has
809
809
  * any `error`-severity issue (today: capability the blueprint exercises but the
@@ -816,11 +816,11 @@ export declare function assertExtensionCapabilityUsage(activation: ExtensionActi
816
816
  * success so a test can still inspect advisory warnings (unused capability,
817
817
  * duplicate command, empty surface) without failing on them.
818
818
  */
819
- export declare function assertExtensionBlueprint(blueprint: ExtensionBlueprint, options?: LintExtensionBlueprintOptions): ExtensionBlueprintLintResult;
819
+ export declare function assertExtensionBlueprint(blueprint:ExtensionBlueprint,options?:LintExtensionBlueprintOptions):ExtensionBlueprintLintResult;
820
820
  /** Options for {@link assertProjectProfile}. */
821
821
  export interface AssertProjectProfileOptions {
822
822
  /** 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. */
823
- strict?: boolean;
823
+ strict?:boolean;
824
824
  }
825
825
  /**
826
826
  * Assert a {@link ProjectProfileDefinition} is internally consistent in a test,
@@ -833,7 +833,7 @@ strict?: boolean;
833
833
  * returned on success so a test can still inspect advisory warnings without
834
834
  * failing on them.
835
835
  */
836
- export declare function assertProjectProfile(profile: ProjectProfileDefinition, options?: AssertProjectProfileOptions): ProjectProfileLintReport;
836
+ export declare function assertProjectProfile(profile:ProjectProfileDefinition,options?:AssertProjectProfileOptions):ProjectProfileLintReport;
837
837
  /**
838
838
  * The structured result of {@link assertExtensionManifestMatchesBlueprint}: the
839
839
  * reconciliation between a manifest's declared capabilities and the set the
@@ -842,15 +842,15 @@ export declare function assertProjectProfile(profile: ProjectProfileDefinition,
842
842
  */
843
843
  export interface ExtensionManifestBlueprintMatch {
844
844
  /** The least-privilege capability set the blueprint exercises (from `deriveExtensionCapabilities`). */
845
- used: ExtensionCapability[];
845
+ used:ExtensionCapability[];
846
846
  /** The manifest's declared capabilities, legacy-alias resolved and normalized. */
847
- declared: ExtensionCapability[];
847
+ declared:ExtensionCapability[];
848
848
  /** Capabilities the blueprint uses but the manifest omits — would crash activation. Empty on success. */
849
- missing: ExtensionCapability[];
849
+ missing:ExtensionCapability[];
850
850
  /** Capabilities the manifest declares but no surface exercises — violates least privilege. Empty on success. */
851
- unused: ExtensionCapability[];
851
+ unused:ExtensionCapability[];
852
852
  /** Every lint finding for the blueprint, so callers can inspect advisory warnings. */
853
- findings: ExtensionBlueprintLintFinding[];
853
+ findings:ExtensionBlueprintLintFinding[];
854
854
  }
855
855
  /**
856
856
  * Strictly assert a manifest's `capabilities` equal the least-privilege set a
@@ -871,7 +871,7 @@ findings: ExtensionBlueprintLintFinding[];
871
871
  * The reconciliation is returned on success so a test can still inspect advisory
872
872
  * warnings (duplicate command, empty surface) without failing on them.
873
873
  */
874
- export declare function assertExtensionManifestMatchesBlueprint(manifest: Pick<ExtensionManifest, "capabilities">, blueprint: ExtensionBlueprint): ExtensionManifestBlueprintMatch;
874
+ export declare function assertExtensionManifestMatchesBlueprint(manifest:Pick<ExtensionManifest,"capabilities">,blueprint:ExtensionBlueprint):ExtensionManifestBlueprintMatch;
875
875
  /**
876
876
  * Assert an extension manifest's declared version bounds permit it to load on a
877
877
  * target pm CLI version, throwing when a bound blocks the load.
@@ -888,7 +888,7 @@ export declare function assertExtensionManifestMatchesBlueprint(manifest: Pick<E
888
888
  * a user's install. The full compatibility result is returned on success so a test
889
889
  * can still inspect advisory warnings.
890
890
  */
891
- export declare function assertExtensionManifestCompatible(manifest: ExtensionManifestCompatibilityManifest, target: ExtensionManifestCompatibilityTarget): ExtensionManifestCompatibilityResult;
891
+ export declare function assertExtensionManifestCompatible(manifest:ExtensionManifestCompatibilityManifest,target:ExtensionManifestCompatibilityTarget):ExtensionManifestCompatibilityResult;
892
892
  /**
893
893
  * Preflight a declarative {@link ExtensionBlueprint} through every author-time
894
894
  * check in one test, throwing if any stage produced an `error`-severity finding.
@@ -906,7 +906,7 @@ export declare function assertExtensionManifestCompatible(manifest: ExtensionMan
906
906
  * returned on success so a test can still inspect those warnings, the synthesized
907
907
  * manifest, and the derived capability set without failing on them.
908
908
  */
909
- export declare function assertExtensionPreflight(blueprint: ExtensionBlueprint, options?: PreflightExtensionOptions): ExtensionPreflightReport;
909
+ export declare function assertExtensionPreflight(blueprint:ExtensionBlueprint,options?:PreflightExtensionOptions):ExtensionPreflightReport;
910
910
  /**
911
911
  * A fluent, single-extension test fixture returned by
912
912
  * {@link createExtensionTestHarness}.
@@ -927,99 +927,99 @@ export declare function assertExtensionPreflight(blueprint: ExtensionBlueprint,
927
927
  */
928
928
  export interface ExtensionTestHarness {
929
929
  /** The in-memory extension module supplied to {@link createExtensionTestHarness}. */
930
- readonly module: unknown;
930
+ readonly module:unknown;
931
931
  /** Resolved extension name (manifest name, explicit override, or `"test-extension"`). */
932
- readonly name: string;
932
+ readonly name:string;
933
933
  /** Layer recorded for the in-memory extension (defaults to `"project"`). */
934
- readonly layer: ExtensionLayer;
934
+ readonly layer:ExtensionLayer;
935
935
  /** The underlying activation result; use it to reach standalone helpers directly. */
936
- readonly activation: ExtensionActivationResult;
936
+ readonly activation:ExtensionActivationResult;
937
937
  /** Bound {@link describeExtensionActivation} over the whole `activation`. */
938
- activationSummary(options?: DescribeExtensionActivationOptions): ExtensionActivationSummary;
938
+ activationSummary(options?:DescribeExtensionActivationOptions):ExtensionActivationSummary;
939
939
  /**
940
940
  * Bound {@link renderExtensionSurfaceMarkdown} over {@link activationSummary},
941
941
  * so tests and README generators can produce deterministic surface docs from
942
942
  * the same harness they use for assert/run coverage.
943
943
  */
944
- renderMarkdown(options?: RenderExtensionHarnessMarkdownOptions): string;
944
+ renderMarkdown(options?:RenderExtensionHarnessMarkdownOptions):string;
945
945
  /** Bound {@link assertRegisteredCommandContract} over `activation.registrations`. */
946
- assertCommandContract(expectation: RegisteredCommandContractExpectation): RegisteredCommandContractAssertion;
946
+ assertCommandContract(expectation:RegisteredCommandContractExpectation):RegisteredCommandContractAssertion;
947
947
  /** Bound {@link assertRegisteredFlags} over `activation.registrations`. */
948
- assertFlags(expectation: RegisteredFlagsExpectation): RegisteredExtensionFlagDefinitions;
948
+ assertFlags(expectation:RegisteredFlagsExpectation):RegisteredExtensionFlagDefinitions;
949
949
  /** Bound {@link assertRegisteredItemField} over `activation.registrations`. */
950
- assertItemField(expectation: RegisteredItemFieldExpectation): RegisteredItemFieldAssertion;
950
+ assertItemField(expectation:RegisteredItemFieldExpectation):RegisteredItemFieldAssertion;
951
951
  /** Bound {@link assertRegisteredItemType} over `activation.registrations`. */
952
- assertItemType(expectation: RegisteredItemTypeExpectation): RegisteredItemTypeAssertion;
952
+ assertItemType(expectation:RegisteredItemTypeExpectation):RegisteredItemTypeAssertion;
953
953
  /** Bound {@link assertRegisteredProfile} over `activation.registrations`. */
954
- assertProfile(expectation: RegisteredProfileExpectation): RegisteredProfileAssertion;
954
+ assertProfile(expectation:RegisteredProfileExpectation):RegisteredProfileAssertion;
955
955
  /** Bound {@link assertRegisteredHook} over `activation.hooks`. */
956
- assertHook<TKind extends RegisteredHookKind>(expectation: RegisteredHookExpectation & {
957
- kind: TKind;
958
- }): RegisteredHookEntry<TKind>;
956
+ assertHook<TKind extends RegisteredHookKind>(expectation:RegisteredHookExpectation & {
957
+ kind:TKind;
958
+ }):RegisteredHookEntry<TKind>;
959
959
  /** Bound {@link assertRegisteredCommandOverride} over `activation.commands`. */
960
- assertCommandOverride(expectation: RegisteredCommandOverrideExpectation): RegisteredExtensionCommandOverride;
960
+ assertCommandOverride(expectation:RegisteredCommandOverrideExpectation):RegisteredExtensionCommandOverride;
961
961
  /** Bound {@link assertRegisteredParserOverride} over `activation.parsers`. */
962
- assertParserOverride(expectation: RegisteredParserOverrideExpectation): RegisteredExtensionParserOverride;
962
+ assertParserOverride(expectation:RegisteredParserOverrideExpectation):RegisteredExtensionParserOverride;
963
963
  /** Bound {@link assertRegisteredPreflightOverride} over `activation.preflight`. */
964
- assertPreflightOverride(expectation?: RegisteredPreflightOverrideExpectation): RegisteredExtensionPreflightOverride;
964
+ assertPreflightOverride(expectation?:RegisteredPreflightOverrideExpectation):RegisteredExtensionPreflightOverride;
965
965
  /** Bound {@link assertRegisteredRendererOverride} over `activation.renderers`. */
966
- assertRendererOverride(expectation: RegisteredRendererOverrideExpectation): RegisteredExtensionRendererOverride;
966
+ assertRendererOverride(expectation:RegisteredRendererOverrideExpectation):RegisteredExtensionRendererOverride;
967
967
  /** Bound {@link assertRegisteredServiceOverride} over `activation.services`. */
968
- assertServiceOverride(expectation: RegisteredServiceOverrideExpectation): RegisteredExtensionServiceOverride;
968
+ assertServiceOverride(expectation:RegisteredServiceOverrideExpectation):RegisteredExtensionServiceOverride;
969
969
  /** Bound {@link assertRegisteredSearchProvider} over `activation.registrations`. */
970
- assertSearchProvider(expectation: RegisteredSearchProviderExpectation): RegisteredExtensionSearchProvider;
970
+ assertSearchProvider(expectation:RegisteredSearchProviderExpectation):RegisteredExtensionSearchProvider;
971
971
  /** Bound {@link assertRegisteredVectorStoreAdapter} over `activation.registrations`. */
972
- assertVectorStoreAdapter(expectation: RegisteredVectorStoreAdapterExpectation): RegisteredExtensionVectorStoreAdapter;
972
+ assertVectorStoreAdapter(expectation:RegisteredVectorStoreAdapterExpectation):RegisteredExtensionVectorStoreAdapter;
973
973
  /** Bound {@link assertRegisteredImporter} over `activation.registrations`. */
974
- assertImporter(expectation: RegisteredImporterExpectation): RegisteredExtensionImporter;
974
+ assertImporter(expectation:RegisteredImporterExpectation):RegisteredExtensionImporter;
975
975
  /** Bound {@link assertRegisteredExporter} over `activation.registrations`. */
976
- assertExporter(expectation: RegisteredExporterExpectation): RegisteredExtensionExporter;
976
+ assertExporter(expectation:RegisteredExporterExpectation):RegisteredExtensionExporter;
977
977
  /** Bound {@link assertRegisteredMigration} over `activation.registrations`. */
978
- assertMigration(expectation: RegisteredMigrationExpectation): RegisteredExtensionSchemaMigrationDefinition;
978
+ assertMigration(expectation:RegisteredMigrationExpectation):RegisteredExtensionSchemaMigrationDefinition;
979
979
  /** Bound {@link assertExtensionCapabilityUsage} over the whole `activation`. */
980
- assertCapabilityUsage(expectation: ExtensionCapabilityUsageExpectation): ExtensionCapabilityUsageAssertion;
980
+ assertCapabilityUsage(expectation:ExtensionCapabilityUsageExpectation):ExtensionCapabilityUsageAssertion;
981
981
  /** Bound {@link runRegisteredCommandForTest} over `activation.commands`. */
982
- runCommand(options: RunRegisteredCommandForTestOptions): Promise<CommandHandlerResult>;
982
+ runCommand(options:RunRegisteredCommandForTestOptions):Promise<CommandHandlerResult>;
983
983
  /** Bound {@link runRegisteredHookForTest} over `activation.hooks`. */
984
- runHook(options: RunRegisteredHookForTestOptions): Promise<string[]>;
984
+ runHook(options:RunRegisteredHookForTestOptions):Promise<string[]>;
985
985
  /** Bound transactional mutation-guard runner over `activation.hooks`. */
986
- runMutationGuard(options: RunRegisteredMutationGuardForTestOptions): Promise<void>;
986
+ runMutationGuard(options:RunRegisteredMutationGuardForTestOptions):Promise<void>;
987
987
  /** Bound {@link runRegisteredCommandOverrideForTest} over `activation.commands`. */
988
- runCommandOverride(context: CommandOverrideContext): Promise<CommandOverrideResult>;
988
+ runCommandOverride(context:CommandOverrideContext):Promise<CommandOverrideResult>;
989
989
  /** Bound {@link runRegisteredParserOverrideForTest} over `activation.parsers`. */
990
- runParserOverride(context: ParserOverrideContext): Promise<ParserOverrideResult>;
990
+ runParserOverride(context:ParserOverrideContext):Promise<ParserOverrideResult>;
991
991
  /** Bound {@link runRegisteredPreflightOverrideForTest} over `activation.preflight`. */
992
- runPreflightOverride(context: PreflightOverrideContext): Promise<PreflightOverrideResult>;
992
+ runPreflightOverride(context:PreflightOverrideContext):Promise<PreflightOverrideResult>;
993
993
  /** Bound {@link runRegisteredRendererOverrideForTest} over `activation.renderers`. */
994
- runRendererOverride(context: RendererOverrideContext): Promise<RendererOverrideResult>;
994
+ runRendererOverride(context:RendererOverrideContext):Promise<RendererOverrideResult>;
995
995
  /** Bound {@link runRegisteredServiceOverrideForTest} over `activation.services`. */
996
- runServiceOverride(context: ServiceOverrideContext): Promise<ServiceOverrideResult>;
996
+ runServiceOverride(context:ServiceOverrideContext):Promise<ServiceOverrideResult>;
997
997
  /** Bound {@link runRegisteredSearchProviderForTest} over `activation.registrations`. */
998
- runSearchProvider<Operation extends keyof SearchProviderOperationContexts>(options: {
999
- provider: string;
1000
- operation: Operation;
1001
- context: SearchProviderOperationContexts[Operation];
1002
- }): Promise<SearchProviderOperationResults[Operation]>;
998
+ runSearchProvider<Operation extends keyof SearchProviderOperationContexts>(options:{
999
+ provider:string;
1000
+ operation:Operation;
1001
+ context:SearchProviderOperationContexts[Operation];
1002
+ }):Promise<SearchProviderOperationResults[Operation]>;
1003
1003
  /** Bound {@link runRegisteredVectorStoreAdapterForTest} over `activation.registrations`. */
1004
- runVectorStoreAdapter<Operation extends keyof VectorStoreAdapterOperationContexts>(options: {
1005
- adapter: string;
1006
- operation: Operation;
1007
- context: VectorStoreAdapterOperationContexts[Operation];
1008
- }): Promise<VectorStoreAdapterOperationResults[Operation]>;
1004
+ runVectorStoreAdapter<Operation extends keyof VectorStoreAdapterOperationContexts>(options:{
1005
+ adapter:string;
1006
+ operation:Operation;
1007
+ context:VectorStoreAdapterOperationContexts[Operation];
1008
+ }):Promise<VectorStoreAdapterOperationResults[Operation]>;
1009
1009
  /** Bound {@link runRegisteredMigrationForTest} over `activation.registrations`. */
1010
- runMigration(options: RunRegisteredMigrationForTestOptions): Promise<unknown>;
1010
+ runMigration(options:RunRegisteredMigrationForTestOptions):Promise<unknown>;
1011
1011
  /** Bound {@link runRegisteredImporterForTest} over the whole `activation`. */
1012
- runImporter(options: RunRegisteredImporterForTestOptions): Promise<CommandHandlerResult>;
1012
+ runImporter(options:RunRegisteredImporterForTestOptions):Promise<CommandHandlerResult>;
1013
1013
  /** Bound {@link runRegisteredExporterForTest} over the whole `activation`. */
1014
- runExporter(options: RunRegisteredExporterForTestOptions): Promise<CommandHandlerResult>;
1014
+ runExporter(options:RunRegisteredExporterForTestOptions):Promise<CommandHandlerResult>;
1015
1015
  /**
1016
1016
  * Bound {@link deactivateExtensionForTest} — runs the real teardown engine for
1017
1017
  * this harness's module, forwarding its resolved `name`/`layer`/`activation` so
1018
1018
  * the skip-key matches and a never-initialized extension is not deactivated.
1019
1019
  */
1020
- deactivate(options?: {
1021
- deactivateTimeoutMs?: number;
1022
- }): Promise<ExtensionDeactivationResult>;
1020
+ deactivate(options?:{
1021
+ deactivateTimeoutMs?:number;
1022
+ }):Promise<ExtensionDeactivationResult>;
1023
1023
  }
1024
1024
  /**
1025
1025
  * Activate one in-memory extension module and return a fluent
@@ -1047,4 +1047,4 @@ deactivateTimeoutMs?: number;
1047
1047
  * deliberately exercise a *failed* activation should call
1048
1048
  * {@link activateExtensionForTest} directly and inspect `activation.failed`.
1049
1049
  */
1050
- export declare function createExtensionTestHarness(module: unknown, options?: ActivateExtensionForTestOptions): Promise<ExtensionTestHarness>;
1050
+ export declare function createExtensionTestHarness(module:unknown,options?:ActivateExtensionForTestOptions):Promise<ExtensionTestHarness>;