@unbrained/pm-cli 2026.10.13 → 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 (708) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/CHANGELOG.md +72 -1
  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-command-options.js +1 -1
  27. package/dist/cli/extension-recovery.d.ts +13 -13
  28. package/dist/cli/help-content.d.ts +22 -22
  29. package/dist/cli/help-content.js +2 -2
  30. package/dist/cli/help-json-payload.d.ts +45 -45
  31. package/dist/cli/invocation-profile.d.ts +5 -5
  32. package/dist/cli/main.d.ts +217 -217
  33. package/dist/cli/main.js +2 -2
  34. package/dist/cli/migration-gates.d.ts +24 -24
  35. package/dist/cli/option-values.d.ts +1 -1
  36. package/dist/cli/public.d.ts +1 -1
  37. package/dist/cli/register-annotations.d.ts +2 -2
  38. package/dist/cli/register-assurance.d.ts +1 -1
  39. package/dist/cli/register-files-lookup.d.ts +1 -1
  40. package/dist/cli/register-history-activity.d.ts +1 -1
  41. package/dist/cli/register-history-author.d.ts +1 -1
  42. package/dist/cli/register-history-maintenance.d.ts +1 -1
  43. package/dist/cli/register-list-query.d.ts +7 -7
  44. package/dist/cli/register-list-query.js +3 -3
  45. package/dist/cli/register-mutation-options.d.ts +1 -1
  46. package/dist/cli/register-mutation.d.ts +4 -4
  47. package/dist/cli/register-operations.d.ts +75 -75
  48. package/dist/cli/register-setup.d.ts +4 -4
  49. package/dist/cli/register-structured-mutation.d.ts +8 -8
  50. package/dist/cli/runtime/activation.d.ts +23 -23
  51. package/dist/cli/runtime/invocation-options.d.ts +12 -12
  52. package/dist/cli/runtime/projection-retry.d.ts +1 -1
  53. package/dist/cli/runtime/selection.d.ts +16 -16
  54. package/dist/cli/runtime/telemetry-outcome.d.ts +11 -11
  55. package/dist/cli/runtime-compatibility-boundary.d.ts +7 -7
  56. package/dist/cli/schema/registration.d.ts +1 -1
  57. package/dist/cli/schema-registration-helpers.d.ts +2 -2
  58. package/dist/cli/stats-analytics-json.d.ts +1 -1
  59. package/dist/cli-bundle/bundle-manifest.json +1 -1
  60. package/dist/cli-bundle/chunks/{chunk-LBDWFWPK.js → chunk-52EZH2QQ.js} +2 -2
  61. package/dist/cli-bundle/chunks/chunk-7OEGNA4X.js +20 -0
  62. package/dist/cli-bundle/chunks/{chunk-APWPC4ZZ.js → chunk-7VHINXZP.js} +2 -2
  63. package/dist/cli-bundle/chunks/chunk-EMEEHV2Y.js +2 -0
  64. package/dist/cli-bundle/chunks/chunk-JGKTOBVB.js +6 -0
  65. package/dist/cli-bundle/chunks/{chunk-PSNS537F.js → chunk-JSUJWIHQ.js} +30 -30
  66. package/dist/cli-bundle/chunks/{chunk-N5EXRYCZ.js → chunk-LNKLQYBG.js} +2 -2
  67. package/dist/cli-bundle/chunks/{chunk-YH6H3UVE.js → chunk-N56CAQBU.js} +63 -64
  68. package/dist/cli-bundle/chunks/chunk-NC3QVGDD.js +8 -0
  69. package/dist/cli-bundle/chunks/{chunk-AM2XOZKE.js → chunk-RJ5N44WY.js} +2 -2
  70. package/dist/cli-bundle/chunks/{chunk-HXHFKXLV.js → chunk-VIMQCFCK.js} +2 -2
  71. package/dist/cli-bundle/chunks/{chunk-UBTYYZIE.js → chunk-WBBW3WQX.js} +4 -4
  72. package/dist/cli-bundle/chunks/chunk-X2H6UR26.js +236 -0
  73. package/dist/cli-bundle/chunks/{register-list-query-BJ742QOR.js → register-list-query-FKKFQ66D.js} +7 -7
  74. package/dist/cli-bundle/chunks/{register-mutation-GGGBRIH2.js → register-mutation-EWMMVZJB.js} +2 -2
  75. package/dist/cli-bundle/chunks/{register-operations-E6HXYHNM.js → register-operations-GEQ2H7PS.js} +2 -2
  76. package/dist/cli-bundle/chunks/{register-setup-4ZVTVEPY.js → register-setup-PSJTQBBO.js} +2 -2
  77. package/dist/cli-bundle/focused-chunks/{chunk-NNW5BS5L.js → chunk-3RNUMVK4.js} +2 -2
  78. package/dist/cli-bundle/focused-chunks/{chunk-3LQEBXU5.js → chunk-4KQFMOM7.js} +6 -6
  79. package/dist/cli-bundle/focused-chunks/{chunk-RAA7SVRA.js → chunk-52I2SNKJ.js} +2 -2
  80. package/dist/cli-bundle/focused-chunks/{chunk-6BTUISKV.js → chunk-5KRACGBK.js} +2 -2
  81. package/dist/cli-bundle/focused-chunks/chunk-5OO54BIV.js +3 -0
  82. package/dist/cli-bundle/focused-chunks/chunk-5TBAVZDR.js +20 -0
  83. package/dist/cli-bundle/focused-chunks/{chunk-R23T7GFZ.js → chunk-FQKPOZKS.js} +2 -2
  84. package/dist/cli-bundle/focused-chunks/{chunk-IIKFTJVC.js → chunk-H3P77KVU.js} +2 -2
  85. package/dist/cli-bundle/focused-chunks/chunk-HTA3TNC3.js +26 -0
  86. package/dist/cli-bundle/focused-chunks/{chunk-73UNAJHD.js → chunk-JKBH7YGX.js} +2 -2
  87. package/dist/cli-bundle/focused-chunks/{chunk-KGFRQ34R.js → chunk-KIIFVULU.js} +2 -2
  88. package/dist/cli-bundle/focused-chunks/{chunk-SOB7X4FJ.js → chunk-N6FUKTZS.js} +2 -2
  89. package/dist/cli-bundle/focused-chunks/chunk-PDYE7QDX.js +166 -0
  90. package/dist/cli-bundle/focused-chunks/{chunk-RU6GCFN3.js → chunk-Q4VNCTR2.js} +2 -2
  91. package/dist/cli-bundle/focused-chunks/{chunk-QMNAY25P.js → chunk-THYQR3ON.js} +61 -62
  92. package/dist/cli-bundle/focused-chunks/{chunk-DVK7VKZL.js → chunk-TYLG5VEB.js} +2 -2
  93. package/dist/cli-bundle/main.js +27 -27
  94. package/dist/cli-bundle/sdk-authoring.js +1 -1
  95. package/dist/cli-bundle/sdk-contracts.js +2 -2
  96. package/dist/cli-bundle/sdk-core.js +23 -23
  97. package/dist/cli-bundle/sdk-governance.js +1 -1
  98. package/dist/cli-bundle/sdk-graph.js +1 -1
  99. package/dist/cli-bundle/sdk-merge.js +51 -51
  100. package/dist/cli-bundle/sdk-query.js +1 -1
  101. package/dist/cli-bundle/sdk-runtime.js +1 -1
  102. package/dist/cli-bundle/sdk-testing.js +1 -1
  103. package/dist/cli-bundle/sdk.js +7 -7
  104. package/dist/cli.d.ts +9 -9
  105. package/dist/core/checkpoint/checkpoint-gc.d.ts +17 -17
  106. package/dist/core/checkpoint/mutation-checkpoint.d.ts +26 -26
  107. package/dist/core/config/nested-settings.d.ts +20 -20
  108. package/dist/core/config/positional-value.d.ts +9 -9
  109. package/dist/core/diagnostics/remediation.d.ts +7 -7
  110. package/dist/core/extensions/activation-summary-markdown.d.ts +4 -4
  111. package/dist/core/extensions/activation-summary.d.ts +30 -30
  112. package/dist/core/extensions/activation-transaction.d.ts +9 -9
  113. package/dist/core/extensions/capability-usage.d.ts +25 -25
  114. package/dist/core/extensions/command-hook-context.d.ts +15 -15
  115. package/dist/core/extensions/command-metadata-contract.d.ts +1 -1
  116. package/dist/core/extensions/command-visibility-tier.d.ts +1 -1
  117. package/dist/core/extensions/contribution-inventory.d.ts +24 -24
  118. package/dist/core/extensions/exporter-output-contract.d.ts +4 -4
  119. package/dist/core/extensions/extension-candidate.d.ts +14 -14
  120. package/dist/core/extensions/extension-capability-aliases.d.ts +14 -14
  121. package/dist/core/extensions/extension-hook-runtime.d.ts +14 -14
  122. package/dist/core/extensions/extension-policy.d.ts +62 -62
  123. package/dist/core/extensions/extension-registries.d.ts +8 -8
  124. package/dist/core/extensions/extension-runtime-helpers.d.ts +5 -5
  125. package/dist/core/extensions/extension-types.d.ts +702 -702
  126. package/dist/core/extensions/flag-definition-validation.d.ts +19 -6
  127. package/dist/core/extensions/flag-definition-validation.js +1 -1
  128. package/dist/core/extensions/flag-value-types.d.ts +16 -4
  129. package/dist/core/extensions/flag-value-types.js +1 -1
  130. package/dist/core/extensions/index.d.ts +34 -34
  131. package/dist/core/extensions/item-field-types.d.ts +3 -3
  132. package/dist/core/extensions/item-fields.d.ts +6 -6
  133. package/dist/core/extensions/loader.d.ts +66 -66
  134. package/dist/core/extensions/manifest-parser.d.ts +1 -1
  135. package/dist/core/extensions/manifest-schema.d.ts +13 -13
  136. package/dist/core/extensions/module-graph-snapshot.d.ts +5 -5
  137. package/dist/core/extensions/preflight-ownership.d.ts +3 -3
  138. package/dist/core/extensions/read-output-contract.d.ts +2 -2
  139. package/dist/core/extensions/registration-contracts.d.ts +12 -12
  140. package/dist/core/extensions/registration-validation.d.ts +6 -6
  141. package/dist/core/extensions/registration-values.d.ts +19 -19
  142. package/dist/core/extensions/reserved-host-flags.d.ts +5 -5
  143. package/dist/core/extensions/runtime-registrations.d.ts +6 -6
  144. package/dist/core/extensions/service-ownership.d.ts +1 -1
  145. package/dist/core/extensions/version-compat.d.ts +9 -9
  146. package/dist/core/fs/atomic-create.d.ts +1 -1
  147. package/dist/core/fs/fs-utils.d.ts +12 -12
  148. package/dist/core/fs/host-environment-errors.d.ts +10 -10
  149. package/dist/core/fs/path-utils.d.ts +1 -1
  150. package/dist/core/governance/content-fields.d.ts +25 -25
  151. package/dist/core/governance/issue-codes.d.ts +16 -16
  152. package/dist/core/governance/metadata-coverage.d.ts +64 -64
  153. package/dist/core/history/digest.d.ts +5 -5
  154. package/dist/core/history/drift-cache.d.ts +2 -2
  155. package/dist/core/history/drift-scan.d.ts +18 -18
  156. package/dist/core/history/event-classification.d.ts +4 -4
  157. package/dist/core/history/event-index.d.ts +33 -33
  158. package/dist/core/history/history-compact-bulk.d.ts +12 -12
  159. package/dist/core/history/history-diff.d.ts +15 -15
  160. package/dist/core/history/history-rewrite.d.ts +43 -43
  161. package/dist/core/history/history-storage-stats.d.ts +20 -20
  162. package/dist/core/history/history-stream-policy.d.ts +12 -12
  163. package/dist/core/history/history.d.ts +45 -45
  164. package/dist/core/history/identity.d.ts +4 -4
  165. package/dist/core/history/operation-contract.d.ts +17 -17
  166. package/dist/core/history/projection.d.ts +16 -16
  167. package/dist/core/history/read.d.ts +4 -4
  168. package/dist/core/history/replay.d.ts +47 -47
  169. package/dist/core/history/tombstone.d.ts +1 -1
  170. package/dist/core/history/version-address.d.ts +2 -2
  171. package/dist/core/history/workspace-history.d.ts +72 -72
  172. package/dist/core/io/body-file.d.ts +2 -2
  173. package/dist/core/io/bulk-ids-input.d.ts +7 -7
  174. package/dist/core/item/actionability.d.ts +30 -30
  175. package/dist/core/item/dependency-reference.d.ts +2 -2
  176. package/dist/core/item/id.d.ts +9 -9
  177. package/dist/core/item/item-format-version.d.ts +17 -15
  178. package/dist/core/item/item-format-version.js +1 -1
  179. package/dist/core/item/item-format.d.ts +54 -54
  180. package/dist/core/item/item-record.d.ts +1 -1
  181. package/dist/core/item/item-type-definition.d.ts +11 -11
  182. package/dist/core/item/parent-reference-policy.d.ts +6 -6
  183. package/dist/core/item/parse.d.ts +37 -37
  184. package/dist/core/item/plan-lifecycle.d.ts +4 -4
  185. package/dist/core/item/priority.d.ts +3 -3
  186. package/dist/core/item/sprint-release-format.d.ts +4 -4
  187. package/dist/core/item/status-filter.d.ts +5 -5
  188. package/dist/core/item/status.d.ts +3 -3
  189. package/dist/core/item/toon-decode.d.ts +10 -10
  190. package/dist/core/item/type-registry.d.ts +35 -35
  191. package/dist/core/item/type-synonyms.d.ts +2 -2
  192. package/dist/core/lock/lock-gc.d.ts +28 -28
  193. package/dist/core/lock/lock.d.ts +53 -53
  194. package/dist/core/output/mutation-projection.d.ts +4 -4
  195. package/dist/core/output/output-control.d.ts +4 -4
  196. package/dist/core/output/output.d.ts +30 -30
  197. package/dist/core/output/query-summary.d.ts +5 -5
  198. package/dist/core/output/tabular.d.ts +3 -3
  199. package/dist/core/packages/manifest.d.ts +30 -30
  200. package/dist/core/packages/root.d.ts +4 -4
  201. package/dist/core/policy/workflow-policy-schema.d.ts +291 -291
  202. package/dist/core/policy/workflow-policy-store.d.ts +15 -15
  203. package/dist/core/policy/workflow-policy.d.ts +56 -56
  204. package/dist/core/profile/profile-describe.d.ts +22 -22
  205. package/dist/core/profile/profile-lint.d.ts +13 -13
  206. package/dist/core/profile/profile-plan.d.ts +45 -45
  207. package/dist/core/profile/profile-presets.d.ts +36 -36
  208. package/dist/core/reproducibility/context.d.ts +9 -9
  209. package/dist/core/schema/fields-file.d.ts +35 -35
  210. package/dist/core/schema/item-types-file.d.ts +29 -29
  211. package/dist/core/schema/runtime-field-filters.d.ts +3 -3
  212. package/dist/core/schema/runtime-field-values.d.ts +7 -7
  213. package/dist/core/schema/runtime-schema.d.ts +59 -59
  214. package/dist/core/schema/status-defs-file.d.ts +29 -29
  215. package/dist/core/schema/status-token.d.ts +1 -1
  216. package/dist/core/schema/type-inference.d.ts +10 -10
  217. package/dist/core/schema/type-presets.d.ts +5 -5
  218. package/dist/core/schema/type-workflows.d.ts +14 -14
  219. package/dist/core/search/background-refresh.d.ts +12 -12
  220. package/dist/core/search/bm25.d.ts +16 -16
  221. package/dist/core/search/cache.d.ts +34 -34
  222. package/dist/core/search/corpus.d.ts +17 -17
  223. package/dist/core/search/embedding-batches.d.ts +25 -25
  224. package/dist/core/search/eval-thresholds.d.ts +4 -4
  225. package/dist/core/search/eval.d.ts +40 -40
  226. package/dist/core/search/http-client.d.ts +24 -24
  227. package/dist/core/search/providers.d.ts +30 -30
  228. package/dist/core/search/relevance.d.ts +17 -17
  229. package/dist/core/search/semantic-defaults.d.ts +5 -5
  230. package/dist/core/search/staleness.d.ts +3 -3
  231. package/dist/core/search/vector-stores.d.ts +51 -51
  232. package/dist/core/search/vectorization-metadata.d.ts +9 -9
  233. package/dist/core/sentry/helpers.d.ts +28 -26
  234. package/dist/core/sentry/helpers.js +1 -1
  235. package/dist/core/sentry/instrument.d.ts +52 -50
  236. package/dist/core/sentry/instrument.js +1 -1
  237. package/dist/core/sentry/sensitive-assignments.d.ts +9 -0
  238. package/dist/core/sentry/sensitive-assignments.js +2 -0
  239. package/dist/core/session/session-state.d.ts +37 -37
  240. package/dist/core/shared/agent-session-context.d.ts +14 -14
  241. package/dist/core/shared/author.d.ts +89 -89
  242. package/dist/core/shared/command-line.d.ts +3 -3
  243. package/dist/core/shared/command-types.d.ts +20 -20
  244. package/dist/core/shared/conflict-markers.d.ts +5 -5
  245. package/dist/core/shared/constants.d.ts +30 -30
  246. package/dist/core/shared/errors.d.ts +100 -100
  247. package/dist/core/shared/html-entity-decode.d.ts +2 -2
  248. package/dist/core/shared/item-metadata-contract.d.ts +2 -2
  249. package/dist/core/shared/lazy-module.d.ts +1 -1
  250. package/dist/core/shared/levenshtein.d.ts +1 -1
  251. package/dist/core/shared/memo.d.ts +1 -1
  252. package/dist/core/shared/numeric-parsers.d.ts +1 -1
  253. package/dist/core/shared/option-alias-visibility.d.ts +3 -3
  254. package/dist/core/shared/primitives.d.ts +13 -13
  255. package/dist/core/shared/secret-rules.d.ts +92 -92
  256. package/dist/core/shared/serial-queue.d.ts +6 -6
  257. package/dist/core/shared/serialization.d.ts +4 -4
  258. package/dist/core/shared/split-comma-list.d.ts +4 -4
  259. package/dist/core/shared/text-normalization.d.ts +3 -3
  260. package/dist/core/shared/time.d.ts +27 -27
  261. package/dist/core/store/item-format-migration.d.ts +7 -7
  262. package/dist/core/store/item-metadata-cache.d.ts +30 -30
  263. package/dist/core/store/item-metadata-query-index.d.ts +66 -66
  264. package/dist/core/store/item-metadata-read-work.d.ts +6 -6
  265. package/dist/core/store/item-store.d.ts +123 -123
  266. package/dist/core/store/item-store.js +1 -1
  267. package/dist/core/store/paths.d.ts +27 -27
  268. package/dist/core/store/settings-concurrency.d.ts +1 -1
  269. package/dist/core/store/settings-read-cache.d.ts +11 -11
  270. package/dist/core/store/settings-validator.d.ts +117 -117
  271. package/dist/core/store/settings.d.ts +84 -84
  272. package/dist/core/store/sqlite-runtime.d.ts +2 -2
  273. package/dist/core/store/tracker-preflight.d.ts +3 -3
  274. package/dist/core/telemetry/consent.d.ts +1 -1
  275. package/dist/core/telemetry/observability.d.ts +16 -16
  276. package/dist/core/telemetry/policy.d.ts +7 -7
  277. package/dist/core/telemetry/read-sampling.d.ts +1 -1
  278. package/dist/core/telemetry/runtime.d.ts +275 -275
  279. package/dist/core/telemetry/runtime.js +2 -2
  280. package/dist/core/test/background-runs.d.ts +123 -123
  281. package/dist/core/test/item-test-run-tracking.d.ts +10 -10
  282. package/dist/core/test/run-selectors.d.ts +12 -12
  283. package/dist/core/validate/estimate-defaults.d.ts +3 -3
  284. package/dist/core/validate/fix-planning.d.ts +36 -36
  285. package/dist/core/validate/linked-artifact-reference.d.ts +1 -1
  286. package/dist/core/validate/missing-by-type.d.ts +3 -3
  287. package/dist/core/validate/missing-link-owners.d.ts +17 -17
  288. package/dist/core/validate/stale-file-classification.d.ts +6 -6
  289. package/dist/mcp/http-server.d.ts +26 -26
  290. package/dist/mcp/legacy-adapter.d.ts +18 -18
  291. package/dist/mcp/runtime-capabilities.d.ts +18 -18
  292. package/dist/mcp/server.d.ts +73 -73
  293. package/dist/mcp/tool-definitions.d.ts +27 -27
  294. package/dist/sdk/actionability.d.ts +1 -1
  295. package/dist/sdk/agent/closed-domain-contracts.d.ts +11 -11
  296. package/dist/sdk/agent/command-recovery.d.ts +5 -5
  297. package/dist/sdk/agent/command-suggestions.d.ts +4 -4
  298. package/dist/sdk/agent/create-option-policy.d.ts +2 -2
  299. package/dist/sdk/agent/identity-config.d.ts +18 -18
  300. package/dist/sdk/agent/item-addressing.d.ts +6 -6
  301. package/dist/sdk/agent/refusal-closure-census.d.ts +26 -26
  302. package/dist/sdk/agent/refusal-closure.d.ts +22 -22
  303. package/dist/sdk/agent/refusal-corpus-contracts.d.ts +26 -26
  304. package/dist/sdk/agent/refusal-reachability.d.ts +65 -65
  305. package/dist/sdk/agent/subcommand-recovery.d.ts +20 -20
  306. package/dist/sdk/agent/task-transcript-contracts.d.ts +18 -18
  307. package/dist/sdk/agent/tracker-preflight-contracts.d.ts +21 -21
  308. package/dist/sdk/agent-capability-contracts.d.ts +41 -41
  309. package/dist/sdk/agent-session-context.d.ts +1 -1
  310. package/dist/sdk/annotations.d.ts +74 -74
  311. package/dist/sdk/author-attribution.d.ts +47 -47
  312. package/dist/sdk/authoring.d.ts +9 -9
  313. package/dist/sdk/cli-bootstrap.d.ts +65 -65
  314. package/dist/sdk/cli-contracts/agent-output-contracts.d.ts +56 -56
  315. package/dist/sdk/cli-contracts/bootstrap-command-scanner.d.ts +6 -6
  316. package/dist/sdk/cli-contracts/command-aliases.d.ts +19 -19
  317. package/dist/sdk/cli-contracts/command-exit-contracts.d.ts +66 -66
  318. package/dist/sdk/cli-contracts/commander-mutation-options.d.ts +7 -7
  319. package/dist/sdk/cli-contracts/commander-types.d.ts +18 -18
  320. package/dist/sdk/cli-contracts/completeness.d.ts +14 -14
  321. package/dist/sdk/cli-contracts/enum-contracts.d.ts +28 -28
  322. package/dist/sdk/cli-contracts/flag-contracts.d.ts +114 -112
  323. package/dist/sdk/cli-contracts/flag-contracts.js +1 -1
  324. package/dist/sdk/cli-contracts/flag-lexicon-contracts.d.ts +27 -27
  325. package/dist/sdk/cli-contracts/grammar-contracts.d.ts +61 -61
  326. package/dist/sdk/cli-contracts/registration-helpers.d.ts +56 -56
  327. package/dist/sdk/cli-contracts/runtime-contracts.d.ts +250 -250
  328. package/dist/sdk/cli-contracts/runtime-contracts.js +1 -1
  329. package/dist/sdk/cli-contracts/schemas/assurance-definition.d.ts +678 -678
  330. package/dist/sdk/cli-contracts/string-lists.d.ts +1 -1
  331. package/dist/sdk/cli-contracts/tool-option-contracts.d.ts +564 -564
  332. package/dist/sdk/cli-contracts/tool-parameter-tables.d.ts +13 -13
  333. package/dist/sdk/cli-contracts/tool-schema.d.ts +54 -54
  334. package/dist/sdk/cli-contracts/typed-action-inputs.d.ts +20 -20
  335. package/dist/sdk/cli-contracts.d.ts +15 -15
  336. package/dist/sdk/cli-program.d.ts +1 -1
  337. package/dist/sdk/cli-program.js +1 -1
  338. package/dist/sdk/command-line.d.ts +3 -3
  339. package/dist/sdk/comments.d.ts +24 -24
  340. package/dist/sdk/compile-cache.d.ts +4 -4
  341. package/dist/sdk/completion/bash.d.ts +1 -1
  342. package/dist/sdk/completion/fish.d.ts +1 -1
  343. package/dist/sdk/completion/shared.d.ts +74 -74
  344. package/dist/sdk/completion/zsh.d.ts +1 -1
  345. package/dist/sdk/completion.d.ts +3 -3
  346. package/dist/sdk/compose.d.ts +94 -94
  347. package/dist/sdk/config.d.ts +105 -105
  348. package/dist/sdk/context/recency.d.ts +1 -1
  349. package/dist/sdk/context/semantic-session-attribution.d.ts +23 -23
  350. package/dist/sdk/context/usage-egress.d.ts +1 -1
  351. package/dist/sdk/context/usage-ledger.d.ts +18 -18
  352. package/dist/sdk/context-intent-contracts.d.ts +37 -37
  353. package/dist/sdk/context-intent-runtime.d.ts +10 -10
  354. package/dist/sdk/context-packing.d.ts +44 -44
  355. package/dist/sdk/context-relevance.d.ts +110 -110
  356. package/dist/sdk/context-signal-store.d.ts +52 -52
  357. package/dist/sdk/context-usage.d.ts +78 -78
  358. package/dist/sdk/contracts.d.ts +2 -1
  359. package/dist/sdk/contracts.js +1 -1
  360. package/dist/sdk/core-governance.d.ts +5 -5
  361. package/dist/sdk/core.d.ts +8 -8
  362. package/dist/sdk/corpus-shape.d.ts +60 -60
  363. package/dist/sdk/define.d.ts +36 -36
  364. package/dist/sdk/dependencies.d.ts +70 -70
  365. package/dist/sdk/dependency-flag-validation.d.ts +17 -17
  366. package/dist/sdk/dependency-provenance.d.ts +22 -22
  367. package/dist/sdk/docs.d.ts +17 -17
  368. package/dist/sdk/duplicates.d.ts +14 -14
  369. package/dist/sdk/environment/agent-environment.d.ts +118 -118
  370. package/dist/sdk/environment/host-environment-errors.d.ts +1 -1
  371. package/dist/sdk/environment/project-runtime-compatibility.d.ts +42 -40
  372. package/dist/sdk/environment/project-runtime-compatibility.js +2 -2
  373. package/dist/sdk/environment/source-context.d.ts +4 -4
  374. package/dist/sdk/environment/tracker-preflight.d.ts +1 -1
  375. package/dist/sdk/error-code-catalog.d.ts +33 -33
  376. package/dist/sdk/error-runtime.d.ts +5 -5
  377. package/dist/sdk/errors.d.ts +17 -17
  378. package/dist/sdk/eval.d.ts +27 -27
  379. package/dist/sdk/extension/author-manifest.d.ts +9 -9
  380. package/dist/sdk/extension/bundled-catalog.d.ts +18 -18
  381. package/dist/sdk/extension/concurrency.d.ts +1 -1
  382. package/dist/sdk/extension/copy-scope.d.ts +1 -1
  383. package/dist/sdk/extension/custom-field-collisions.d.ts +1 -1
  384. package/dist/sdk/extension/describe.d.ts +21 -21
  385. package/dist/sdk/extension/doctor.d.ts +46 -46
  386. package/dist/sdk/extension/install-plan.d.ts +32 -32
  387. package/dist/sdk/extension/install-receipts.d.ts +4 -4
  388. package/dist/sdk/extension/install-runtime.d.ts +12 -12
  389. package/dist/sdk/extension/install-snapshot.d.ts +10 -10
  390. package/dist/sdk/extension/install-sources.d.ts +106 -106
  391. package/dist/sdk/extension/managed-state.d.ts +42 -42
  392. package/dist/sdk/extension/managed-update-status.d.ts +1 -1
  393. package/dist/sdk/extension/migrations.d.ts +48 -48
  394. package/dist/sdk/extension/output-ownership.d.ts +19 -19
  395. package/dist/sdk/extension/runtime-summary.d.ts +7 -7
  396. package/dist/sdk/extension/scaffold.d.ts +15 -15
  397. package/dist/sdk/extension/shared.d.ts +16 -16
  398. package/dist/sdk/extension/source-resolution.d.ts +16 -16
  399. package/dist/sdk/extension/static-inventory.d.ts +23 -23
  400. package/dist/sdk/extension/update-check.d.ts +9 -9
  401. package/dist/sdk/extension-command-context.d.ts +1 -1
  402. package/dist/sdk/extension-contracts.d.ts +10 -10
  403. package/dist/sdk/extension.d.ts +221 -221
  404. package/dist/sdk/files.d.ts +101 -101
  405. package/dist/sdk/flag-invocation-contracts.d.ts +25 -25
  406. package/dist/sdk/flag-invocation-contracts.js +1 -1
  407. package/dist/sdk/generated/generated-error-code-catalog-part-1.d.ts +1 -1
  408. package/dist/sdk/generated/generated-error-code-catalog-part-2.d.ts +1 -1
  409. package/dist/sdk/generated/generated-error-code-catalog-part-2.js +1 -1
  410. package/dist/sdk/generated-error-code-catalog.d.ts +1 -1
  411. package/dist/sdk/governance/artifact-ledgers.d.ts +19 -19
  412. package/dist/sdk/governance/assurance-action-contracts.d.ts +1 -1
  413. package/dist/sdk/governance/assurance-action.d.ts +46 -46
  414. package/dist/sdk/governance/assurance-mutation-error.d.ts +20 -20
  415. package/dist/sdk/governance/assurance-presets.d.ts +25 -25
  416. package/dist/sdk/governance/assurance-runtime.d.ts +10 -10
  417. package/dist/sdk/governance/assurance.d.ts +204 -204
  418. package/dist/sdk/governance/boundary-fixtures.d.ts +32 -32
  419. package/dist/sdk/governance/closure-timestamps.d.ts +10 -10
  420. package/dist/sdk/governance/coverage-assurance.d.ts +7 -7
  421. package/dist/sdk/governance/defect-recurrence-coverage.d.ts +40 -40
  422. package/dist/sdk/governance/defect-recurrence-graph.d.ts +11 -11
  423. package/dist/sdk/governance/defect-recurrence-signals.d.ts +1 -1
  424. package/dist/sdk/governance/defect-recurrence.d.ts +97 -97
  425. package/dist/sdk/governance/defect-recurrence.js +2 -1
  426. package/dist/sdk/governance/extension-host-version.d.ts +9 -9
  427. package/dist/sdk/governance/gc.d.ts +26 -26
  428. package/dist/sdk/governance/health-merge-evidence.d.ts +8 -8
  429. package/dist/sdk/governance/health.d.ts +172 -172
  430. package/dist/sdk/governance/health.js +1 -1
  431. package/dist/sdk/governance/hierarchy-validation.d.ts +16 -16
  432. package/dist/sdk/governance/linked-file-report.d.ts +15 -15
  433. package/dist/sdk/governance/merge-receipt-history.d.ts +24 -24
  434. package/dist/sdk/governance/provenance-health.d.ts +35 -35
  435. package/dist/sdk/governance/reindex.d.ts +102 -102
  436. package/dist/sdk/governance/reliability.d.ts +29 -29
  437. package/dist/sdk/governance/stale-work.d.ts +13 -13
  438. package/dist/sdk/governance/status-role-diagnostics.d.ts +8 -8
  439. package/dist/sdk/governance/storage-integrity.d.ts +28 -28
  440. package/dist/sdk/governance/tracked-runtime-cache.d.ts +7 -7
  441. package/dist/sdk/governance/upgrade.d.ts +77 -77
  442. package/dist/sdk/governance/validate-history-drift.d.ts +3 -3
  443. package/dist/sdk/governance/validate-item-reader.d.ts +9 -9
  444. package/dist/sdk/governance/validate-normalization.d.ts +4 -4
  445. package/dist/sdk/governance/validate.d.ts +176 -176
  446. package/dist/sdk/governance/validate.js +1 -1
  447. package/dist/sdk/governance/workflow-completeness.d.ts +15 -15
  448. package/dist/sdk/governance/workflow-policy.d.ts +18 -18
  449. package/dist/sdk/governance/workspace-position.d.ts +40 -40
  450. package/dist/sdk/governance.d.ts +2 -2
  451. package/dist/sdk/graph/adapter.d.ts +45 -45
  452. package/dist/sdk/graph/analytics.d.ts +36 -36
  453. package/dist/sdk/graph/assembly.d.ts +51 -51
  454. package/dist/sdk/graph/cache.d.ts +19 -19
  455. package/dist/sdk/graph/cardinality-integrity.d.ts +4 -4
  456. package/dist/sdk/graph/centrality.d.ts +20 -20
  457. package/dist/sdk/graph/conformance.d.ts +21 -21
  458. package/dist/sdk/graph/deadline-scheduling.d.ts +30 -30
  459. package/dist/sdk/graph/durable-cache.d.ts +22 -22
  460. package/dist/sdk/graph/governance-contracts.d.ts +1 -1
  461. package/dist/sdk/graph/governance.d.ts +92 -92
  462. package/dist/sdk/graph/hierarchy-integrity.d.ts +32 -32
  463. package/dist/sdk/graph/index.d.ts +15 -15
  464. package/dist/sdk/graph/lifecycle-coverage.d.ts +12 -12
  465. package/dist/sdk/graph/mutation-advisory.d.ts +15 -15
  466. package/dist/sdk/graph/query-contracts.d.ts +6 -6
  467. package/dist/sdk/graph/remediation.d.ts +15 -15
  468. package/dist/sdk/graph/run.d.ts +203 -203
  469. package/dist/sdk/graph/scheduling.d.ts +21 -21
  470. package/dist/sdk/graph/traversal.d.ts +18 -18
  471. package/dist/sdk/graph/workspace-relationship-kind-registry.d.ts +1 -1
  472. package/dist/sdk/guide-topics.d.ts +19 -19
  473. package/dist/sdk/guide.d.ts +43 -43
  474. package/dist/sdk/history/attestation-command.d.ts +8 -8
  475. package/dist/sdk/history/attestation-contract.d.ts +43 -43
  476. package/dist/sdk/history/attestation-scan.d.ts +4 -4
  477. package/dist/sdk/history/attestation.d.ts +4 -4
  478. package/dist/sdk/history/maintenance.d.ts +25 -25
  479. package/dist/sdk/history/salvage.d.ts +19 -19
  480. package/dist/sdk/history/subject.d.ts +8 -8
  481. package/dist/sdk/history-analytics.d.ts +64 -64
  482. package/dist/sdk/history-compact.d.ts +67 -67
  483. package/dist/sdk/history-mcp.d.ts +7 -7
  484. package/dist/sdk/history-provenance.d.ts +40 -40
  485. package/dist/sdk/history-read.d.ts +24 -24
  486. package/dist/sdk/history-redact.d.ts +68 -68
  487. package/dist/sdk/history-repair.d.ts +92 -92
  488. package/dist/sdk/improvement-ledger-validation.d.ts +1 -1
  489. package/dist/sdk/improvement-ledger.d.ts +62 -62
  490. package/dist/sdk/index.d.ts +69 -69
  491. package/dist/sdk/init-agent-guidance.d.ts +68 -68
  492. package/dist/sdk/init.d.ts +117 -117
  493. package/dist/sdk/invocation-author.d.ts +1 -1
  494. package/dist/sdk/item-children.d.ts +15 -15
  495. package/dist/sdk/item-metadata-index.d.ts +2 -2
  496. package/dist/sdk/item-schedule.d.ts +9 -9
  497. package/dist/sdk/item-transaction.d.ts +73 -73
  498. package/dist/sdk/learnings.d.ts +23 -23
  499. package/dist/sdk/lifecycle/append.d.ts +8 -8
  500. package/dist/sdk/lifecycle/claim.d.ts +38 -38
  501. package/dist/sdk/lifecycle/close-many.d.ts +71 -71
  502. package/dist/sdk/lifecycle/close.d.ts +18 -18
  503. package/dist/sdk/lifecycle/copy.d.ts +10 -10
  504. package/dist/sdk/lifecycle/core-field-recovery.d.ts +1 -1
  505. package/dist/sdk/lifecycle/create.d.ts +88 -88
  506. package/dist/sdk/lifecycle/delete.d.ts +15 -15
  507. package/dist/sdk/lifecycle/event-validation-messages.d.ts +1 -1
  508. package/dist/sdk/lifecycle/focus.d.ts +6 -6
  509. package/dist/sdk/lifecycle/hierarchy-mutation-lock.d.ts +6 -6
  510. package/dist/sdk/lifecycle/legacy-none-tokens.d.ts +35 -35
  511. package/dist/sdk/lifecycle/lifecycle-transitions.d.ts +3 -3
  512. package/dist/sdk/lifecycle/mcp-actions.d.ts +10 -10
  513. package/dist/sdk/lifecycle/metadata-normalizers.d.ts +4 -4
  514. package/dist/sdk/lifecycle/mutation-command-options.d.ts +58 -58
  515. package/dist/sdk/lifecycle/mutation-facet-contracts.d.ts +1 -1
  516. package/dist/sdk/lifecycle/plan-mutation-receipt.d.ts +24 -24
  517. package/dist/sdk/lifecycle/plan.d.ts +127 -127
  518. package/dist/sdk/lifecycle/recurrence-parsers.d.ts +5 -5
  519. package/dist/sdk/lifecycle/reopen.d.ts +15 -15
  520. package/dist/sdk/lifecycle/repeatable-metadata-parsers.d.ts +7 -7
  521. package/dist/sdk/lifecycle/restore.d.ts +34 -34
  522. package/dist/sdk/lifecycle/restore.js +1 -1
  523. package/dist/sdk/lifecycle/shared-unset-fields.d.ts +20 -20
  524. package/dist/sdk/lifecycle/task-composition.d.ts +7 -7
  525. package/dist/sdk/lifecycle/update-many.d.ts +61 -61
  526. package/dist/sdk/lifecycle/update.d.ts +120 -120
  527. package/dist/sdk/lifecycle-completion.d.ts +14 -14
  528. package/dist/sdk/lifecycle-policy.d.ts +31 -31
  529. package/dist/sdk/linked-artifacts.d.ts +58 -58
  530. package/dist/sdk/mcp/apps.d.ts +28 -28
  531. package/dist/sdk/mcp/authorization.d.ts +66 -66
  532. package/dist/sdk/mcp/discovery.d.ts +67 -67
  533. package/dist/sdk/mcp/interactions.d.ts +49 -49
  534. package/dist/sdk/mcp/protocol.d.ts +63 -63
  535. package/dist/sdk/mcp/skills.d.ts +62 -62
  536. package/dist/sdk/mcp/subscriptions.d.ts +26 -26
  537. package/dist/sdk/mcp/tasks.d.ts +51 -51
  538. package/dist/sdk/mcp/transport.d.ts +17 -17
  539. package/dist/sdk/merge/abandoned-receipts.d.ts +8 -8
  540. package/dist/sdk/merge/driver.d.ts +38 -38
  541. package/dist/sdk/merge/index.d.ts +5 -5
  542. package/dist/sdk/merge/install.d.ts +48 -48
  543. package/dist/sdk/merge/install.js +1 -1
  544. package/dist/sdk/merge/receipt-file-boundary.d.ts +6 -6
  545. package/dist/sdk/merge/receipt-operation.d.ts +6 -6
  546. package/dist/sdk/merge/receipt-schema.d.ts +11 -11
  547. package/dist/sdk/merge/receipts.d.ts +111 -111
  548. package/dist/sdk/merge/reconcile.d.ts +20 -20
  549. package/dist/sdk/merge/three-way.d.ts +50 -50
  550. package/dist/sdk/merge/three-way.js +2 -2
  551. package/dist/sdk/merge/worktree-config.d.ts +3 -3
  552. package/dist/sdk/mutation-events.d.ts +62 -62
  553. package/dist/sdk/mutation-guard.d.ts +134 -134
  554. package/dist/sdk/notes.d.ts +28 -28
  555. package/dist/sdk/output/table-rows.d.ts +6 -6
  556. package/dist/sdk/output-contracts.d.ts +26 -26
  557. package/dist/sdk/output-projection.d.ts +108 -108
  558. package/dist/sdk/output-token-accounting.d.ts +18 -18
  559. package/dist/sdk/output.d.ts +18 -18
  560. package/dist/sdk/ownership-source.d.ts +1 -1
  561. package/dist/sdk/package-import-adapters.d.ts +51 -51
  562. package/dist/sdk/package-migrations.d.ts +3 -3
  563. package/dist/sdk/package-runtime-options.d.ts +3 -3
  564. package/dist/sdk/pagination.d.ts +28 -28
  565. package/dist/sdk/pagination.js +1 -1
  566. package/dist/sdk/profile.d.ts +72 -72
  567. package/dist/sdk/provenance.d.ts +37 -37
  568. package/dist/sdk/public-surface.json +1 -1
  569. package/dist/sdk/query/activity.d.ts +84 -84
  570. package/dist/sdk/query/aggregate.d.ts +109 -109
  571. package/dist/sdk/query/calendar.d.ts +95 -95
  572. package/dist/sdk/query/complete-list.d.ts +35 -35
  573. package/dist/sdk/query/context.d.ts +300 -300
  574. package/dist/sdk/query/duplicate-candidates.d.ts +3 -3
  575. package/dist/sdk/query/get.d.ts +54 -54
  576. package/dist/sdk/query/history.d.ts +38 -38
  577. package/dist/sdk/query/item-filter-options.d.ts +41 -41
  578. package/dist/sdk/query/light-metadata.d.ts +1 -1
  579. package/dist/sdk/query/list-filter-shared.d.ts +4 -4
  580. package/dist/sdk/query/list.d.ts +167 -167
  581. package/dist/sdk/query/list.js +1 -1
  582. package/dist/sdk/query/multi-value-filters.d.ts +6 -6
  583. package/dist/sdk/query/next-ready-budget.d.ts +8 -8
  584. package/dist/sdk/query/next.d.ts +94 -94
  585. package/dist/sdk/query/parsers.d.ts +3 -3
  586. package/dist/sdk/query/projection-contracts.d.ts +18 -18
  587. package/dist/sdk/query/search/corpus.d.ts +15 -15
  588. package/dist/sdk/query/search/filters.d.ts +15 -15
  589. package/dist/sdk/query/search/input.d.ts +8 -8
  590. package/dist/sdk/query/search/lexical.d.ts +10 -10
  591. package/dist/sdk/query/search/response.d.ts +22 -22
  592. package/dist/sdk/query/search/semantic.d.ts +133 -133
  593. package/dist/sdk/query/search/types.d.ts +65 -65
  594. package/dist/sdk/query/search-contracts.d.ts +53 -53
  595. package/dist/sdk/query/search-pagination.d.ts +21 -21
  596. package/dist/sdk/query/search-rendering.d.ts +30 -30
  597. package/dist/sdk/query/search.d.ts +60 -60
  598. package/dist/sdk/query/workspace-contracts.d.ts +2 -2
  599. package/dist/sdk/query.d.ts +6 -6
  600. package/dist/sdk/read-output/continuation.d.ts +11 -11
  601. package/dist/sdk/read-output/extension.d.ts +3 -3
  602. package/dist/sdk/read-output/options.d.ts +7 -7
  603. package/dist/sdk/read-output/provenance.d.ts +6 -6
  604. package/dist/sdk/read-output-budget.d.ts +11 -11
  605. package/dist/sdk/read-output-contracts.d.ts +112 -112
  606. package/dist/sdk/read-output-contracts.js +1 -1
  607. package/dist/sdk/read-output-rows.d.ts +15 -15
  608. package/dist/sdk/read-output-session.d.ts +29 -29
  609. package/dist/sdk/relationship-analytics.d.ts +46 -46
  610. package/dist/sdk/relationship-context.d.ts +48 -48
  611. package/dist/sdk/relationship-history.d.ts +59 -59
  612. package/dist/sdk/relationship-kinds/contract.d.ts +18 -18
  613. package/dist/sdk/relationship-migration.d.ts +14 -14
  614. package/dist/sdk/relationships.d.ts +46 -46
  615. package/dist/sdk/reproducibility/process.d.ts +9 -9
  616. package/dist/sdk/runtime/actions.d.ts +1 -1
  617. package/dist/sdk/runtime/context.d.ts +15 -15
  618. package/dist/sdk/runtime/schema-preview.d.ts +1 -1
  619. package/dist/sdk/runtime/schema.d.ts +1 -1
  620. package/dist/sdk/runtime-action-aliases.d.ts +3 -3
  621. package/dist/sdk/runtime-extended-actions.d.ts +9 -9
  622. package/dist/sdk/runtime-input.d.ts +29 -29
  623. package/dist/sdk/runtime-primitives.d.ts +54 -52
  624. package/dist/sdk/runtime-primitives.js +1 -1
  625. package/dist/sdk/runtime-public-contracts.d.ts +46 -46
  626. package/dist/sdk/runtime-stats-options.d.ts +1 -1
  627. package/dist/sdk/runtime.d.ts +374 -374
  628. package/dist/sdk/scheduling-shortcuts.d.ts +19 -19
  629. package/dist/sdk/schema-migration.d.ts +79 -79
  630. package/dist/sdk/schema.d.ts +224 -224
  631. package/dist/sdk/search-refresh-worker.d.ts +1 -1
  632. package/dist/sdk/similarity-scoring.d.ts +10 -10
  633. package/dist/sdk/similarity.d.ts +73 -73
  634. package/dist/sdk/start-task-status.d.ts +1 -1
  635. package/dist/sdk/stats.d.ts +72 -72
  636. package/dist/sdk/structured-mutations.d.ts +13 -13
  637. package/dist/sdk/telemetry-flush.d.ts +1 -1
  638. package/dist/sdk/telemetry.d.ts +32 -32
  639. package/dist/sdk/templates.d.ts +35 -35
  640. package/dist/sdk/test/batch.d.ts +50 -50
  641. package/dist/sdk/test/command-args.d.ts +2 -2
  642. package/dist/sdk/test/entry.d.ts +4 -4
  643. package/dist/sdk/test/execution-receipts.d.ts +5 -5
  644. package/dist/sdk/test/execution.d.ts +247 -247
  645. package/dist/sdk/test/json-path.d.ts +4 -4
  646. package/dist/sdk/test/linked-command-detection.d.ts +36 -36
  647. package/dist/sdk/test/measurements.d.ts +10 -10
  648. package/dist/sdk/test/parsers.d.ts +18 -18
  649. package/dist/sdk/test/prerequisites.d.ts +3 -3
  650. package/dist/sdk/test/runs.d.ts +43 -43
  651. package/dist/sdk/test/trust.d.ts +15 -15
  652. package/dist/sdk/test/update.d.ts +23 -23
  653. package/dist/sdk/test/workspace-snapshot.d.ts +1 -1
  654. package/dist/sdk/testing.d.ts +250 -246
  655. package/dist/sdk/testing.js +2 -2
  656. package/dist/sdk/traceability/runtime-files-lookup.d.ts +1 -1
  657. package/dist/sdk/traceability/source-traceability.d.ts +50 -50
  658. package/dist/sdk/workspace-contracts-cache.d.ts +2 -2
  659. package/dist/sdk/workspace-contracts.d.ts +20 -20
  660. package/dist/sdk/workspace-memory.d.ts +42 -42
  661. package/dist/sdk/workspace-recipe.d.ts +9 -9
  662. package/dist/sdk/workspace-snapshot.d.ts +60 -60
  663. package/dist/sdk/workspace-transaction-gc.d.ts +17 -17
  664. package/dist/sdk/workspace-transaction.d.ts +26 -26
  665. package/dist/sdk/workspace.d.ts +9 -9
  666. package/dist/types.d.ts +540 -540
  667. package/docs/COMMANDS.md +11 -2
  668. package/docs/CONFIGURATION.md +43 -0
  669. package/docs/DEFECT_RECURRENCE.md +8 -0
  670. package/docs/EXTENSIONS.md +1 -1
  671. package/docs/EXTENSION_AUTHOR_CONTRACTS.md +33 -0
  672. package/docs/LINKED_TEST_EDITS.md +15 -0
  673. package/docs/MERGE_SAFETY.md +8 -0
  674. package/docs/RELEASING.md +2 -0
  675. package/docs/SDK.md +19 -0
  676. package/docs/TESTING.md +21 -1
  677. package/docs/generated/REFUSAL_CLOSURE_CENSUS.md +4 -3
  678. package/marketplace.json +1 -1
  679. package/package.json +3 -1
  680. package/packages/pm-beads/package.json +1 -1
  681. package/packages/pm-calendar/package.json +1 -1
  682. package/packages/pm-command-kit/package.json +1 -1
  683. package/packages/pm-digital-twin/package.json +1 -1
  684. package/packages/pm-governance-audit/package.json +1 -1
  685. package/packages/pm-guide-shell/package.json +1 -1
  686. package/packages/pm-kanban/package.json +1 -1
  687. package/packages/pm-lifecycle-hooks/package.json +1 -1
  688. package/packages/pm-linked-test-adapters/package.json +1 -1
  689. package/packages/pm-search-advanced/package.json +1 -1
  690. package/packages/pm-templates/package.json +1 -1
  691. package/packages/pm-todos/package.json +1 -1
  692. package/packages/pm-vcs/package.json +1 -1
  693. package/plugins/pm-claude/.claude-plugin/plugin.json +1 -1
  694. package/plugins/pm-claude/package.json +1 -1
  695. package/plugins/pm-codex/.codex-plugin/plugin.json +1 -1
  696. package/plugins/pm-codex/package.json +1 -1
  697. package/plugins/pm-codex/plugin.json +1 -1
  698. package/runtime-dependencies.json +1 -1
  699. package/scripts/finalize-build.mjs +9 -3
  700. package/dist/cli-bundle/chunks/chunk-DJDRHJBP.js +0 -234
  701. package/dist/cli-bundle/chunks/chunk-DUK5DHI6.js +0 -8
  702. package/dist/cli-bundle/chunks/chunk-IFPJDJUM.js +0 -20
  703. package/dist/cli-bundle/chunks/chunk-RL45OYTL.js +0 -6
  704. package/dist/cli-bundle/chunks/chunk-WYZGZV2M.js +0 -2
  705. package/dist/cli-bundle/focused-chunks/chunk-F5J3ATMV.js +0 -165
  706. package/dist/cli-bundle/focused-chunks/chunk-IOTNG6CN.js +0 -2
  707. package/dist/cli-bundle/focused-chunks/chunk-S6ITXQ5T.js +0 -20
  708. package/dist/cli-bundle/focused-chunks/chunk-UPJA45K7.js +0 -26
@@ -3,380 +3,380 @@
3
3
  *
4
4
  * Implements the pm test command surface and its agent-facing runtime behavior.
5
5
  */
6
- import { readJsonPathValue, splitJsonPathSegments } from "./json-path.js";
6
+ import { readJsonPathValue,splitJsonPathSegments } from "./json-path.js";
7
7
  import type { GlobalOptions } from "../../core/shared/command-types.js";
8
8
  import { resolveAuthor } from "../../core/shared/author.js";
9
9
  import { runInit } from "../init.js";
10
- import { type LinkedTestPmContextMode, type LinkedTestWorkspaceContextMode } from "./parsers.js";
10
+ import { type LinkedTestPmContextMode,type LinkedTestWorkspaceContextMode } from "./parsers.js";
11
11
  import { type LinkedTestRunSelection } from "../../core/test/run-selectors.js";
12
- import type { LinkedTest, LinkScope, TestRunMeasurement } from "../../types/index.js";
12
+ import type { LinkedTest,LinkScope,TestRunMeasurement } from "../../types/index.js";
13
13
  import { type TestRunMeasurementDiff } from "./measurements.js";
14
14
  import { type LinkedTestTrustDecision } from "./trust.js";
15
- type ResolvedLinkedTestPmContextMode = Exclude<LinkedTestPmContextMode, "auto">;
15
+ type ResolvedLinkedTestPmContextMode = Exclude<LinkedTestPmContextMode,"auto">;
16
16
  interface LinkedTestExecutionResult {
17
- stdout: string;
18
- stderr: string;
19
- exitCode: number | null;
20
- signal?: NodeJS.Signals | null;
21
- timedOut: boolean;
22
- maxBufferExceeded: boolean;
23
- outputTruncated: boolean;
24
- spawnError?: string;
17
+ stdout:string;
18
+ stderr:string;
19
+ exitCode:number | null;
20
+ signal?:NodeJS.Signals | null;
21
+ timedOut:boolean;
22
+ maxBufferExceeded:boolean;
23
+ outputTruncated:boolean;
24
+ spawnError?:string;
25
25
  }
26
26
  interface LinkedTestProgressContext {
27
- index: number;
28
- total: number;
29
- timeoutMs: number;
30
- command: string;
27
+ index:number;
28
+ total:number;
29
+ timeoutMs:number;
30
+ command:string;
31
31
  }
32
32
  type LinkedTestProgressMode = "auto" | "always" | "off";
33
33
  interface LinkedTestSandboxSourceRoots {
34
- projectPmRoot: string;
35
- globalPmRoot: string;
34
+ projectPmRoot:string;
35
+ globalPmRoot:string;
36
36
  }
37
37
  /** Documents the test command options payload exchanged by command, SDK, and package integrations. */
38
38
  export interface TestCommandOptions {
39
39
  /** Value that configures or reports add for this contract. */
40
- add?: string[];
40
+ add?:string[];
41
41
  /** Value that configures or reports add json for this contract. */
42
- addJson?: string[];
42
+ addJson?:string[];
43
43
  /** Value that configures or reports remove for this contract. */
44
- remove?: string[];
44
+ remove?:string[];
45
45
  /** Remove linked tests by their stable 1-based list position. */
46
- removeIndex?: Array<string | number>;
46
+ removeIndex?:Array<string | number>;
47
47
  /** Exact command=<value> or path=<value> selector for a metadata edit. */
48
- update?: string;
48
+ update?:string;
49
49
  /** One-based linked-test position for a metadata edit. */
50
- updateIndex?: string | number;
50
+ updateIndex?:string | number;
51
51
  /** JSON object containing explicit metadata changes; null clears optional fields. */
52
- setJson?: string;
52
+ setJson?:string;
53
53
  /** Value that configures or reports list for this contract. */
54
- list?: boolean;
54
+ list?:boolean;
55
55
  /** Value that configures or reports run for this contract. */
56
- run?: boolean;
56
+ run?:boolean;
57
57
  /** Value that configures or reports match for this contract. */
58
- match?: string;
58
+ match?:string;
59
59
  /** Value that configures or reports only index for this contract. */
60
- onlyIndex?: string | number;
60
+ onlyIndex?:string | number;
61
61
  /** Value that configures or reports only last for this contract. */
62
- onlyLast?: boolean;
62
+ onlyLast?:boolean;
63
63
  /** Value that configures or reports timeout for this contract. */
64
- timeout?: string;
64
+ timeout?:string;
65
65
  /** Value that configures or reports progress for this contract. */
66
- progress?: boolean;
66
+ progress?:boolean;
67
67
  /** Value that configures or reports env set for this contract. */
68
- envSet?: string[];
68
+ envSet?:string[];
69
69
  /** Value that configures or reports env clear for this contract. */
70
- envClear?: string[];
70
+ envClear?:string[];
71
71
  /** Value that configures or reports shared host safe for this contract. */
72
- sharedHostSafe?: boolean;
72
+ sharedHostSafe?:boolean;
73
73
  /** Value that configures or reports pm context for this contract. */
74
- pmContext?: string;
74
+ pmContext?:string;
75
75
  /** Value that configures or reports override linked pm context for this contract. */
76
- overrideLinkedPmContext?: boolean;
76
+ overrideLinkedPmContext?:boolean;
77
77
  /** Source-workspace visibility and working-directory mode. */
78
- workspaceContext?: string;
78
+ workspaceContext?:string;
79
79
  /** Force the run-level workspace mode over per-test metadata. */
80
- overrideLinkedWorkspaceContext?: boolean;
80
+ overrideLinkedWorkspaceContext?:boolean;
81
81
  /** Explicitly permit an untrusted linked command when project policy also permits it. */
82
- allowUntrustedLinkedTests?: boolean;
82
+ allowUntrustedLinkedTests?:boolean;
83
83
  /** Record clone-local acknowledgement for the item's current linked tests. */
84
- acknowledgeLinkedTests?: boolean;
84
+ acknowledgeLinkedTests?:boolean;
85
85
  /** Value that configures or reports fail on context mismatch for this contract. */
86
- failOnContextMismatch?: boolean;
86
+ failOnContextMismatch?:boolean;
87
87
  /** Value that configures or reports fail on skipped for this contract. */
88
- failOnSkipped?: boolean;
88
+ failOnSkipped?:boolean;
89
89
  /** Value that configures or reports fail on empty test run for this contract. */
90
- failOnEmptyTestRun?: boolean;
90
+ failOnEmptyTestRun?:boolean;
91
91
  /** Value that configures or reports require assertions for pm for this contract. */
92
- requireAssertionsForPm?: boolean;
92
+ requireAssertionsForPm?:boolean;
93
93
  /** Value that configures or reports check context for this contract. */
94
- checkContext?: boolean;
94
+ checkContext?:boolean;
95
95
  /** Value that configures or reports auto pm context for this contract. */
96
- autoPmContext?: boolean;
96
+ autoPmContext?:boolean;
97
97
  /** Value that configures or reports author for this contract. */
98
- author?: string;
98
+ author?:string;
99
99
  /** Human-readable explanation suitable for logs and agent-facing output. */
100
- message?: string;
100
+ message?:string;
101
101
  /** Value that configures or reports force for this contract. */
102
- force?: boolean;
102
+ force?:boolean;
103
103
  /** Repeatable `name=value[,unit=...][,threshold=...]` numeric evidence; requires run=true. */
104
- measure?: string[];
104
+ measure?:string[];
105
105
  /** Filter recorded evidence below `name=value`. */
106
- metricBelow?: string;
106
+ metricBelow?:string;
107
107
  /** Compare the latest and previous values for one metric name. */
108
- metricDiff?: string;
108
+ metricDiff?:string;
109
109
  }
110
110
  /** Restricts linked test failure category values accepted by command, SDK, and storage contracts. */
111
111
  export type LinkedTestFailureCategory = "infra_collision" | "trust_refusal" | "config_refusal" | "assertion_failure" | "empty_run" | "timeout" | "max_buffer" | "spawn_error" | "signal";
112
112
  /** Documents the test run result payload exchanged by command, SDK, and package integrations. */
113
113
  export interface TestRunResult {
114
114
  /** Value that configures or reports command for this contract. */
115
- command?: string;
115
+ command?:string;
116
116
  /** Filesystem path used for path resolution. */
117
- path?: string;
117
+ path?:string;
118
118
  /** Lifecycle state reported for status. */
119
- status: "passed" | "failed" | "skipped" | "refused";
119
+ status:"passed" | "failed" | "skipped" | "refused";
120
120
  /** Value that configures or reports exit code for this contract. */
121
- exit_code?: number | null;
121
+ exit_code?:number | null;
122
122
  /** Value that configures or reports failure category for this contract. */
123
- failure_category?: LinkedTestFailureCategory;
123
+ failure_category?:LinkedTestFailureCategory;
124
124
  /** Recognized runner summary proving execution, including the stream that supplied it. */
125
- execution_receipt?: {
126
- code: string;
127
- stream: "stdout" | "stderr";
125
+ execution_receipt?:{
126
+ code:string;
127
+ stream:"stdout" | "stderr";
128
128
  };
129
129
  /** Value that configures or reports execution context for this contract. */
130
- execution_context?: {
131
- requested_pm_context_mode: LinkedTestPmContextMode;
132
- pm_context_mode: LinkedTestPmContextMode;
133
- auto_pm_context_applied: boolean;
134
- is_pm_command: boolean;
135
- is_pm_tracker_read_command: boolean;
136
- source_project_pm_path: string;
137
- sandbox_project_pm_path: string;
138
- source_global_pm_path: string;
139
- sandbox_global_pm_path: string;
140
- source_project_item_count: number;
141
- sandbox_project_item_count: number;
142
- source_global_item_count: number;
143
- sandbox_global_item_count: number;
144
- mismatch_detected: boolean;
145
- project_extensions_seeded: boolean;
146
- global_extensions_seeded: boolean;
147
- requested_workspace_context_mode: LinkedTestWorkspaceContextMode;
148
- workspace_context_mode: LinkedTestWorkspaceContextMode;
149
- working_directory: string;
150
- source_workspace_root: string;
151
- trust: LinkedTestTrustDecision;
130
+ execution_context?:{
131
+ requested_pm_context_mode:LinkedTestPmContextMode;
132
+ pm_context_mode:LinkedTestPmContextMode;
133
+ auto_pm_context_applied:boolean;
134
+ is_pm_command:boolean;
135
+ is_pm_tracker_read_command:boolean;
136
+ source_project_pm_path:string;
137
+ sandbox_project_pm_path:string;
138
+ source_global_pm_path:string;
139
+ sandbox_global_pm_path:string;
140
+ source_project_item_count:number;
141
+ sandbox_project_item_count:number;
142
+ source_global_item_count:number;
143
+ sandbox_global_item_count:number;
144
+ mismatch_detected:boolean;
145
+ project_extensions_seeded:boolean;
146
+ global_extensions_seeded:boolean;
147
+ requested_workspace_context_mode:LinkedTestWorkspaceContextMode;
148
+ workspace_context_mode:LinkedTestWorkspaceContextMode;
149
+ working_directory:string;
150
+ source_workspace_root:string;
151
+ trust:LinkedTestTrustDecision;
152
152
  };
153
153
  /** Value that configures or reports stdout for this contract. */
154
- stdout?: string;
154
+ stdout?:string;
155
155
  /** Value that configures or reports stderr for this contract. */
156
- stderr?: string;
156
+ stderr?:string;
157
157
  /** Value that configures or reports error for this contract. */
158
- error?: string;
158
+ error?:string;
159
159
  }
160
160
  /** Documents the test result payload exchanged by command, SDK, and package integrations. */
161
161
  export interface TestResult {
162
162
  /** Whether the operation completed without a blocking failure. */
163
- ok: boolean;
163
+ ok:boolean;
164
164
  /** Stable identifier used to reference this record across commands and storage. */
165
- id: string;
165
+ id:string;
166
166
  /** Value that configures or reports tests for this contract. */
167
- tests: LinkedTest[];
167
+ tests:LinkedTest[];
168
168
  /** Executes the results operation through the package runtime. */
169
- run_results: TestRunResult[];
169
+ run_results:TestRunResult[];
170
170
  /** Value that configures or reports failure categories for this contract. */
171
- failure_categories: Record<LinkedTestFailureCategory, number>;
171
+ failure_categories:Record<LinkedTestFailureCategory,number>;
172
172
  /** Value that configures or reports selection for this contract. */
173
- selection?: Omit<LinkedTestRunSelection, "selected">;
173
+ selection?:Omit<LinkedTestRunSelection,"selected">;
174
174
  /** Value that configures or reports fail on skipped triggered for this contract. */
175
- fail_on_skipped_triggered?: boolean;
175
+ fail_on_skipped_triggered?:boolean;
176
176
  /** Value that configures or reports warnings for this contract. */
177
- warnings?: string[];
177
+ warnings?:string[];
178
178
  /** Value that configures or reports changed for this contract. */
179
- changed: boolean;
179
+ changed:boolean;
180
180
  /** Whether this execution appended evidence to the item's immutable history. */
181
- evidence_recording?: {
181
+ evidence_recording?:{
182
182
  /** True only after the item history mutation succeeds. */
183
- recorded: boolean;
183
+ recorded:boolean;
184
184
  /** Why the current execution did or did not reach item history. */
185
- reason: "recorded" | "tracking_disabled" | "write_failed";
185
+ reason:"recorded" | "tracking_disabled" | "write_failed";
186
186
  /** Identifier of the execution summary, even when item tracking is disabled. */
187
- run_id: string;
187
+ run_id:string;
188
188
  /** Executable next step when recording was disabled. */
189
- recovery_command?: string;
189
+ recovery_command?:string;
190
190
  };
191
191
  /** Value that configures or reports count for this contract. */
192
- count: number;
192
+ count:number;
193
193
  /** Number of linked-test entries removed by this mutation. */
194
- removed?: number;
194
+ removed?:number;
195
195
  /** One-based position selected by an explicit linked-test metadata edit. */
196
- updated_index?: number;
196
+ updated_index?:number;
197
197
  /** Normalized metadata fields changed by an explicit edit. */
198
- updated_fields?: string[];
198
+ updated_fields?:string[];
199
199
  /** Measurements supplied for the current producing run. */
200
- measurements?: TestRunMeasurement[];
200
+ measurements?:TestRunMeasurement[];
201
201
  /** Existing and current measurements below the selected threshold. */
202
- metric_below?: Array<TestRunMeasurement & {
203
- run_id: string;
202
+ metric_below?:Array<TestRunMeasurement & {
203
+ run_id:string;
204
204
  }>;
205
205
  /** Latest-versus-previous comparison for the selected metric. */
206
- metric_diff?: TestRunMeasurementDiff;
206
+ metric_diff?:TestRunMeasurementDiff;
207
207
  }
208
- declare function resolveTrackedRunId(kind: "test" | "test-all"): string;
208
+ declare function resolveTrackedRunId(kind:"test" | "test-all"):string;
209
209
  /** Count execution refusals alongside failures while keeping skipped runs separate. */
210
- declare function summarizeRunResultStatuses(results: TestRunResult[]): {
211
- passed: number;
212
- failed: number;
213
- skipped: number;
210
+ declare function summarizeRunResultStatuses(results:TestRunResult[]):{
211
+ passed:number;
212
+ failed:number;
213
+ skipped:number;
214
214
  };
215
215
  /** Implements summarize context preflight for the public runtime surface of this module. */
216
- export declare function summarizeContextPreflight(runResults: TestRunResult[]): {
217
- checked_pm_commands: number;
218
- tracker_read_commands: number;
219
- mismatches: number;
220
- auto_remediated: number;
216
+ export declare function summarizeContextPreflight(runResults:TestRunResult[]):{
217
+ checked_pm_commands:number;
218
+ tracker_read_commands:number;
219
+ mismatches:number;
220
+ auto_remediated:number;
221
221
  };
222
- declare function ensureScope(raw: string | undefined): LinkScope;
223
- declare function parsePmContextMode(raw: string | undefined): LinkedTestPmContextMode;
224
- declare function resolveLinkedTestRequestedContextMode(linkedTest: LinkedTest, runLevelMode: LinkedTestPmContextMode, overrideLinkedPmContext: boolean): LinkedTestPmContextMode;
225
- declare function resolveLinkedTestEffectiveContextMode(requestedMode: LinkedTestPmContextMode, isPmTrackerReadCommand: boolean): ResolvedLinkedTestPmContextMode;
226
- declare function hasLinkedTestAssertions(linkedTest: LinkedTest): boolean;
227
- declare function buildPmContextMismatchHint(params: {
228
- executionContext: NonNullable<TestRunResult["execution_context"]>;
229
- runLevelPmContextMode: LinkedTestPmContextMode;
230
- linkedOverridePmContextMode: LinkedTestPmContextMode | undefined;
231
- }): string;
222
+ declare function ensureScope(raw:string | undefined):LinkScope;
223
+ declare function parsePmContextMode(raw:string | undefined):LinkedTestPmContextMode;
224
+ declare function resolveLinkedTestRequestedContextMode(linkedTest:LinkedTest,runLevelMode:LinkedTestPmContextMode,overrideLinkedPmContext:boolean):LinkedTestPmContextMode;
225
+ declare function resolveLinkedTestEffectiveContextMode(requestedMode:LinkedTestPmContextMode,isPmTrackerReadCommand:boolean):ResolvedLinkedTestPmContextMode;
226
+ declare function hasLinkedTestAssertions(linkedTest:LinkedTest):boolean;
227
+ declare function buildPmContextMismatchHint(params:{
228
+ executionContext:NonNullable<TestRunResult["execution_context"]>;
229
+ runLevelPmContextMode:LinkedTestPmContextMode;
230
+ linkedOverridePmContextMode:LinkedTestPmContextMode | undefined;
231
+ }):string;
232
232
  import { extractPmInvocationArgsFromSegment } from "./linked-command-detection.js";
233
233
  export { extractReferencedPmItemIdsFromCommand } from "./linked-command-detection.js";
234
- declare function commandInvokesPmCli(command: string): boolean;
235
- declare function commandInvokesPmTrackerReadCommand(command: string): boolean;
236
- declare function resolveDirectRunnerSubcommand(parsed: {
237
- subcommand: string;
238
- args: string[];
239
- } | null): string | undefined;
240
- declare function firstDirectTestRunnerSubcommand(executable: string, args: string[]): string | undefined;
241
- declare function segmentInvokesRecursiveTestAll(segment: string): boolean;
234
+ declare function commandInvokesPmCli(command:string):boolean;
235
+ declare function commandInvokesPmTrackerReadCommand(command:string):boolean;
236
+ declare function resolveDirectRunnerSubcommand(parsed:{
237
+ subcommand:string;
238
+ args:string[];
239
+ } | null):string | undefined;
240
+ declare function firstDirectTestRunnerSubcommand(executable:string,args:string[]):string | undefined;
241
+ declare function segmentInvokesRecursiveTestAll(segment:string):boolean;
242
242
  /** Describes the SDK-owned safety policy applied when a linked command is recorded. */
243
243
  export interface LinkedTestCommandSafetyClassification {
244
244
  /** Whether intake accepts the command before provenance checks at execution time. */
245
- accepted: true;
245
+ accepted:true;
246
246
  /** Capability-oriented command family, independent of shell wrapping. */
247
- command_kind: "direct_runner" | "sandbox_runner" | "other";
247
+ command_kind:"direct_runner" | "sandbox_runner" | "other";
248
248
  /** Tracker isolation is injected by the linked-test runtime for every command. */
249
- tracker_isolation: "runtime_injected";
249
+ tracker_isolation:"runtime_injected";
250
250
  /** Stored-command provenance and explicit acknowledgment form the execution trust boundary. */
251
- trust_boundary: "provenance";
251
+ trust_boundary:"provenance";
252
252
  /** Human guidance for reproducible execution without presenting string shape as enforcement. */
253
- advisory: string;
253
+ advisory:string;
254
254
  }
255
255
  /** Classify linked-test commands without pretending string shape is a security boundary. */
256
- export declare function classifyLinkedTestCommandSafety(command: string): LinkedTestCommandSafetyClassification;
257
- declare function parseLinkedTestTimeoutSeconds(timeoutSecondsRaw: string | undefined, timeoutAliasRaw: string | undefined): number | undefined;
258
- declare function parseAddJsonEntries(raw: string[] | undefined): LinkedTest[];
259
- declare function endLinkedTestProgress(context: LinkedTestProgressContext, executionResult: Pick<LinkedTestExecutionResult, "timedOut" | "maxBufferExceeded" | "outputTruncated" | "exitCode" | "signal">, startedAt: number, mode: LinkedTestProgressMode): void;
260
- declare function runLinkedTestCommand(command: string, timeoutMs: number, env: NodeJS.ProcessEnv, progressContext: LinkedTestProgressContext, progressMode: LinkedTestProgressMode, cwd?: string): Promise<LinkedTestExecutionResult>;
261
- declare function formatLinkedTestExecutionError(result: LinkedTestExecutionResult, timeoutMs: number): string;
256
+ export declare function classifyLinkedTestCommandSafety(command:string):LinkedTestCommandSafetyClassification;
257
+ declare function parseLinkedTestTimeoutSeconds(timeoutSecondsRaw:string | undefined,timeoutAliasRaw:string | undefined):number | undefined;
258
+ declare function parseAddJsonEntries(raw:string[] | undefined):LinkedTest[];
259
+ declare function endLinkedTestProgress(context:LinkedTestProgressContext,executionResult:Pick<LinkedTestExecutionResult,"timedOut" | "maxBufferExceeded" | "outputTruncated" | "exitCode" | "signal">,startedAt:number,mode:LinkedTestProgressMode):void;
260
+ declare function runLinkedTestCommand(command:string,timeoutMs:number,env:NodeJS.ProcessEnv,progressContext:LinkedTestProgressContext,progressMode:LinkedTestProgressMode,cwd?:string):Promise<LinkedTestExecutionResult>;
261
+ declare function formatLinkedTestExecutionError(result:LinkedTestExecutionResult,timeoutMs:number):string;
262
262
  /** Implements classify linked test failure for the public runtime surface of this module. */
263
- export declare function classifyLinkedTestFailure(result: Pick<LinkedTestExecutionResult, "stdout" | "stderr" | "spawnError" | "signal" | "timedOut" | "maxBufferExceeded">): LinkedTestFailureCategory;
263
+ export declare function classifyLinkedTestFailure(result:Pick<LinkedTestExecutionResult,"stdout" | "stderr" | "spawnError" | "signal" | "timedOut" | "maxBufferExceeded">):LinkedTestFailureCategory;
264
264
  /** Implements count failure categories for the public runtime surface of this module. */
265
- export declare function countFailureCategories(runResults: TestRunResult[]): Record<LinkedTestFailureCategory, number>;
266
- declare function copyIntoSandboxIfPresent(sourcePath: string, targetPath: string, recursive?: boolean, makeDirectory?: (targetPath: string, options: {
267
- recursive: true;
268
- }) => Promise<unknown>): Promise<void>;
265
+ export declare function countFailureCategories(runResults:TestRunResult[]):Record<LinkedTestFailureCategory,number>;
266
+ declare function copyIntoSandboxIfPresent(sourcePath:string,targetPath:string,recursive?:boolean,makeDirectory?:(targetPath:string,options:{
267
+ recursive:true;
268
+ }) => Promise<unknown>):Promise<void>;
269
269
  /** Seed settings and extension configuration, auditing schema-only copies against their own initialized history. */
270
- declare function seedLinkedTestSandbox(sandboxPmPath: string, sandboxGlobalPath: string, sourceRoots: LinkedTestSandboxSourceRoots, auditSettings?: boolean): Promise<void>;
271
- declare function seedLinkedTestTrackerData(sourceRoot: string, sandboxRoot: string): Promise<void>;
270
+ declare function seedLinkedTestSandbox(sandboxPmPath:string,sandboxGlobalPath:string,sourceRoots:LinkedTestSandboxSourceRoots,auditSettings?:boolean):Promise<void>;
271
+ declare function seedLinkedTestTrackerData(sourceRoot:string,sandboxRoot:string):Promise<void>;
272
272
  /**
273
273
  * Create an audited settings snapshot only for source trackers that predate
274
274
  * workspace history, while preserving any existing source history verbatim.
275
275
  */
276
- declare function seedMissingLinkedTestSettingsHistory(sourceRoot: string, sandboxRoot: string): Promise<void>;
277
- declare function countLinkedTestItemFiles(pmRoot: string): Promise<number>;
276
+ declare function seedMissingLinkedTestSettingsHistory(sourceRoot:string,sandboxRoot:string):Promise<void>;
277
+ declare function countLinkedTestItemFiles(pmRoot:string):Promise<number>;
278
278
  /** Implements resolve linked test failure exit code for the public runtime surface of this module. */
279
- export declare function resolveLinkedTestFailureExitCode(execution: Pick<LinkedTestExecutionResult, "exitCode" | "timedOut" | "maxBufferExceeded">): number;
280
- declare function evaluateLinkedTestAssertions(linkedTest: LinkedTest, stdout: string, stderr: string): string[];
279
+ export declare function resolveLinkedTestFailureExitCode(execution:Pick<LinkedTestExecutionResult,"exitCode" | "timedOut" | "maxBufferExceeded">):number;
280
+ declare function evaluateLinkedTestAssertions(linkedTest:LinkedTest,stdout:string,stderr:string):string[];
281
281
  /** Return whether a linked command applies a runner-level test-name filter that must match at least one test. */
282
- declare function commandUsesTestNameFilter(command: string): boolean;
282
+ declare function commandUsesTestNameFilter(command:string):boolean;
283
283
  interface RunLinkedTestsOptions {
284
- progress?: boolean;
285
- sourceRoots?: LinkedTestSandboxSourceRoots;
286
- envSet?: string[];
287
- envClear?: string[];
288
- sharedHostSafe?: boolean;
289
- pmContext?: string;
290
- overrideLinkedPmContext?: boolean;
291
- failOnContextMismatch?: boolean;
292
- failOnEmptyTestRun?: boolean;
293
- requireAssertionsForPm?: boolean;
294
- checkContext?: boolean;
295
- autoPmContext?: boolean;
296
- workspaceContext?: string;
297
- overrideLinkedWorkspaceContext?: boolean;
298
- pmRoot?: string;
299
- allowUntrustedLinkedTests?: boolean;
300
- untrustedLinkedTestsPolicyEnabled?: boolean;
284
+ progress?:boolean;
285
+ sourceRoots?:LinkedTestSandboxSourceRoots;
286
+ envSet?:string[];
287
+ envClear?:string[];
288
+ sharedHostSafe?:boolean;
289
+ pmContext?:string;
290
+ overrideLinkedPmContext?:boolean;
291
+ failOnContextMismatch?:boolean;
292
+ failOnEmptyTestRun?:boolean;
293
+ requireAssertionsForPm?:boolean;
294
+ checkContext?:boolean;
295
+ autoPmContext?:boolean;
296
+ workspaceContext?:string;
297
+ overrideLinkedWorkspaceContext?:boolean;
298
+ pmRoot?:string;
299
+ allowUntrustedLinkedTests?:boolean;
300
+ untrustedLinkedTestsPolicyEnabled?:boolean;
301
301
  }
302
302
  interface LinkedTestSandboxLayout {
303
- root: string;
304
- schemaProjectPmPath: string;
305
- schemaGlobalPmPath: string;
306
- trackerProjectPmPath: string;
307
- trackerGlobalPmPath: string;
308
- workspaceSnapshotRoot: string;
309
- workspaceIsolatedRoot: string;
303
+ root:string;
304
+ schemaProjectPmPath:string;
305
+ schemaGlobalPmPath:string;
306
+ trackerProjectPmPath:string;
307
+ trackerGlobalPmPath:string;
308
+ workspaceSnapshotRoot:string;
309
+ workspaceIsolatedRoot:string;
310
310
  }
311
311
  interface LinkedTestSandboxCounts {
312
- sourceProjectItemCount: number;
313
- sourceGlobalItemCount: number;
314
- schemaProjectItemCount: number;
315
- schemaGlobalItemCount: number;
316
- trackerProjectItemCount: number;
317
- trackerGlobalItemCount: number;
312
+ sourceProjectItemCount:number;
313
+ sourceGlobalItemCount:number;
314
+ schemaProjectItemCount:number;
315
+ schemaGlobalItemCount:number;
316
+ trackerProjectItemCount:number;
317
+ trackerGlobalItemCount:number;
318
318
  }
319
- declare function initializeLinkedTestSandboxes(layout: LinkedTestSandboxLayout, initialize?: (...args: Parameters<typeof runInit>) => Promise<unknown>, includeTrackerData?: boolean): Promise<void>;
320
- declare function linkedTestsRequireTrackerData(tests: LinkedTest[], runLevelPmContextMode: LinkedTestPmContextMode, options: RunLinkedTestsOptions | undefined): boolean;
321
- declare function buildLinkedTestExecutionContext(params: {
322
- layout: LinkedTestSandboxLayout;
323
- counts: LinkedTestSandboxCounts;
324
- sourceRoots: LinkedTestSandboxSourceRoots | undefined;
325
- isPmCommand: boolean;
326
- isPmTrackerReadCommand: boolean;
327
- requestedPmContextMode: LinkedTestPmContextMode;
328
- effectivePmContextMode: ResolvedLinkedTestPmContextMode;
329
- autoPmContextApplied: boolean;
330
- requestedWorkspaceContextMode: LinkedTestWorkspaceContextMode;
331
- workspaceContextMode: LinkedTestWorkspaceContextMode;
332
- sourceWorkspaceRoot: string;
333
- trust: LinkedTestTrustDecision;
334
- }): NonNullable<TestRunResult["execution_context"]>;
319
+ declare function initializeLinkedTestSandboxes(layout:LinkedTestSandboxLayout,initialize?:(...args:Parameters<typeof runInit>) => Promise<unknown>,includeTrackerData?:boolean):Promise<void>;
320
+ declare function linkedTestsRequireTrackerData(tests:LinkedTest[],runLevelPmContextMode:LinkedTestPmContextMode,options:RunLinkedTestsOptions | undefined):boolean;
321
+ declare function buildLinkedTestExecutionContext(params:{
322
+ layout:LinkedTestSandboxLayout;
323
+ counts:LinkedTestSandboxCounts;
324
+ sourceRoots:LinkedTestSandboxSourceRoots | undefined;
325
+ isPmCommand:boolean;
326
+ isPmTrackerReadCommand:boolean;
327
+ requestedPmContextMode:LinkedTestPmContextMode;
328
+ effectivePmContextMode:ResolvedLinkedTestPmContextMode;
329
+ autoPmContextApplied:boolean;
330
+ requestedWorkspaceContextMode:LinkedTestWorkspaceContextMode;
331
+ workspaceContextMode:LinkedTestWorkspaceContextMode;
332
+ sourceWorkspaceRoot:string;
333
+ trust:LinkedTestTrustDecision;
334
+ }):NonNullable<TestRunResult["execution_context"]>;
335
335
  /** Implements run linked tests for the public runtime surface of this module. */
336
- export declare function runLinkedTests(tests: LinkedTest[], defaultTimeoutSeconds: number | undefined, options?: RunLinkedTestsOptions): Promise<TestRunResult[]>;
336
+ export declare function runLinkedTests(tests:LinkedTest[],defaultTimeoutSeconds:number | undefined,options?:RunLinkedTestsOptions):Promise<TestRunResult[]>;
337
337
  interface ResolvedTestRunOptions {
338
- defaultTimeoutSeconds: number | undefined;
339
- pmContextMode: LinkedTestPmContextMode;
340
- runSelection: LinkedTestRunSelection | undefined;
341
- testsToRun: LinkedTest[];
338
+ defaultTimeoutSeconds:number | undefined;
339
+ pmContextMode:LinkedTestPmContextMode;
340
+ runSelection:LinkedTestRunSelection | undefined;
341
+ testsToRun:LinkedTest[];
342
342
  }
343
- declare function resolveTestRunOptions(options: TestCommandOptions, tests: LinkedTest[]): ResolvedTestRunOptions;
343
+ declare function resolveTestRunOptions(options:TestCommandOptions,tests:LinkedTest[]):ResolvedTestRunOptions;
344
344
  /** Implements run test for the public runtime surface of this module. */
345
- export declare function runTest(id: string, options: TestCommandOptions, global: GlobalOptions): Promise<TestResult>;
345
+ export declare function runTest(id:string,options:TestCommandOptions,global:GlobalOptions):Promise<TestResult>;
346
346
  /** Public contract for test only test command, shared by SDK and presentation-layer consumers. */
347
- export declare const _testOnlyTestCommand: {
348
- buildLinkedTestExecutionContext: typeof buildLinkedTestExecutionContext;
349
- buildPmContextMismatchHint: typeof buildPmContextMismatchHint;
350
- commandInvokesPmCli: typeof commandInvokesPmCli;
351
- commandInvokesPmTrackerReadCommand: typeof commandInvokesPmTrackerReadCommand;
352
- commandUsesTestNameFilter: typeof commandUsesTestNameFilter;
353
- copyIntoSandboxIfPresent: typeof copyIntoSandboxIfPresent;
354
- countLinkedTestItemFiles: typeof countLinkedTestItemFiles;
355
- ensureScope: typeof ensureScope;
356
- evaluateLinkedTestAssertions: typeof evaluateLinkedTestAssertions;
357
- endLinkedTestProgress: typeof endLinkedTestProgress;
358
- extractPmInvocationArgsFromSegment: typeof extractPmInvocationArgsFromSegment;
359
- firstDirectTestRunnerSubcommand: typeof firstDirectTestRunnerSubcommand;
360
- formatLinkedTestExecutionError: typeof formatLinkedTestExecutionError;
361
- hasLinkedTestAssertions: typeof hasLinkedTestAssertions;
362
- initializeLinkedTestSandboxes: typeof initializeLinkedTestSandboxes;
363
- linkedTestsRequireTrackerData: typeof linkedTestsRequireTrackerData;
364
- parseAddJsonEntries: typeof parseAddJsonEntries;
365
- parseLinkedTestTimeoutSeconds: typeof parseLinkedTestTimeoutSeconds;
366
- parsePmContextMode: typeof parsePmContextMode;
367
- readJsonPathValue: typeof readJsonPathValue;
368
- resolveAuthor: typeof resolveAuthor;
369
- resolveDirectRunnerSubcommand: typeof resolveDirectRunnerSubcommand;
370
- resolveLinkedTestEffectiveContextMode: typeof resolveLinkedTestEffectiveContextMode;
371
- resolveLinkedTestFailureExitCode: typeof resolveLinkedTestFailureExitCode;
372
- resolveLinkedTestRequestedContextMode: typeof resolveLinkedTestRequestedContextMode;
373
- resolveTestRunOptions: typeof resolveTestRunOptions;
374
- resolveTrackedRunId: typeof resolveTrackedRunId;
375
- runLinkedTestCommand: typeof runLinkedTestCommand;
376
- seedMissingLinkedTestSettingsHistory: typeof seedMissingLinkedTestSettingsHistory;
377
- seedLinkedTestSandbox: typeof seedLinkedTestSandbox;
378
- seedLinkedTestTrackerData: typeof seedLinkedTestTrackerData;
379
- segmentInvokesRecursiveTestAll: typeof segmentInvokesRecursiveTestAll;
380
- splitJsonPathSegments: typeof splitJsonPathSegments;
381
- summarizeRunResultStatuses: typeof summarizeRunResultStatuses;
347
+ export declare const _testOnlyTestCommand:{
348
+ buildLinkedTestExecutionContext:typeof buildLinkedTestExecutionContext;
349
+ buildPmContextMismatchHint:typeof buildPmContextMismatchHint;
350
+ commandInvokesPmCli:typeof commandInvokesPmCli;
351
+ commandInvokesPmTrackerReadCommand:typeof commandInvokesPmTrackerReadCommand;
352
+ commandUsesTestNameFilter:typeof commandUsesTestNameFilter;
353
+ copyIntoSandboxIfPresent:typeof copyIntoSandboxIfPresent;
354
+ countLinkedTestItemFiles:typeof countLinkedTestItemFiles;
355
+ ensureScope:typeof ensureScope;
356
+ evaluateLinkedTestAssertions:typeof evaluateLinkedTestAssertions;
357
+ endLinkedTestProgress:typeof endLinkedTestProgress;
358
+ extractPmInvocationArgsFromSegment:typeof extractPmInvocationArgsFromSegment;
359
+ firstDirectTestRunnerSubcommand:typeof firstDirectTestRunnerSubcommand;
360
+ formatLinkedTestExecutionError:typeof formatLinkedTestExecutionError;
361
+ hasLinkedTestAssertions:typeof hasLinkedTestAssertions;
362
+ initializeLinkedTestSandboxes:typeof initializeLinkedTestSandboxes;
363
+ linkedTestsRequireTrackerData:typeof linkedTestsRequireTrackerData;
364
+ parseAddJsonEntries:typeof parseAddJsonEntries;
365
+ parseLinkedTestTimeoutSeconds:typeof parseLinkedTestTimeoutSeconds;
366
+ parsePmContextMode:typeof parsePmContextMode;
367
+ readJsonPathValue:typeof readJsonPathValue;
368
+ resolveAuthor:typeof resolveAuthor;
369
+ resolveDirectRunnerSubcommand:typeof resolveDirectRunnerSubcommand;
370
+ resolveLinkedTestEffectiveContextMode:typeof resolveLinkedTestEffectiveContextMode;
371
+ resolveLinkedTestFailureExitCode:typeof resolveLinkedTestFailureExitCode;
372
+ resolveLinkedTestRequestedContextMode:typeof resolveLinkedTestRequestedContextMode;
373
+ resolveTestRunOptions:typeof resolveTestRunOptions;
374
+ resolveTrackedRunId:typeof resolveTrackedRunId;
375
+ runLinkedTestCommand:typeof runLinkedTestCommand;
376
+ seedMissingLinkedTestSettingsHistory:typeof seedMissingLinkedTestSettingsHistory;
377
+ seedLinkedTestSandbox:typeof seedLinkedTestSandbox;
378
+ seedLinkedTestTrackerData:typeof seedLinkedTestTrackerData;
379
+ segmentInvokesRecursiveTestAll:typeof segmentInvokesRecursiveTestAll;
380
+ splitJsonPathSegments:typeof splitJsonPathSegments;
381
+ summarizeRunResultStatuses:typeof summarizeRunResultStatuses;
382
382
  };
@@ -3,9 +3,9 @@
3
3
  * Own-data lookup for linked-test assertions.
4
4
  */
5
5
  /** Parse the linked-test dotted and bracket-index path grammar. */
6
- export declare function splitJsonPathSegments(fieldPath: string): Array<string | number>;
6
+ export declare function splitJsonPathSegments(fieldPath:string):Array<string | number>;
7
7
  /** Read own JSON data properties without invoking getters or following prototypes. */
8
- export declare function readJsonPathValue(root: unknown, fieldPath: string): {
9
- found: boolean;
10
- value: unknown;
8
+ export declare function readJsonPathValue(root:unknown,fieldPath:string):{
9
+ found:boolean;
10
+ value:unknown;
11
11
  };