@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
@@ -15,39 +15,39 @@
15
15
  /** Minimal structural shape this module needs from an item's item metadata. */
16
16
  export interface CoverageItem {
17
17
  /** Schema type that determines the shape and validation rules for this value. */
18
- type: string;
18
+ type:string;
19
19
  /** Lifecycle state reported for status. */
20
- status: string;
20
+ status:string;
21
21
  /** Value that configures or reports assignee for this contract. */
22
- assignee?: string;
22
+ assignee?:string;
23
23
  /** Value that configures or reports tags for this contract. */
24
- tags?: string[];
24
+ tags?:string[];
25
25
  /** Value that configures or reports parent for this contract. */
26
- parent?: string;
26
+ parent?:string;
27
27
  /** Value that configures or reports priority for this contract. */
28
- priority?: number;
28
+ priority?:number;
29
29
  /** Value that configures or reports acceptance criteria for this contract. */
30
- acceptance_criteria?: string;
30
+ acceptance_criteria?:string;
31
31
  /** Value that configures or reports estimated minutes for this contract. */
32
- estimated_minutes?: number;
32
+ estimated_minutes?:number;
33
33
  /** Value that configures or reports resolution for this contract. */
34
- resolution?: string;
34
+ resolution?:string;
35
35
  /** Value that configures or reports reviewer for this contract. */
36
- reviewer?: string;
36
+ reviewer?:string;
37
37
  /** Value that configures or reports risk for this contract. */
38
- risk?: string;
38
+ risk?:string;
39
39
  /** Confidence is a string-like enum or a numeric score depending on workspace. */
40
- confidence?: string | number;
40
+ confidence?:string | number;
41
41
  /** Value that configures or reports sprint for this contract. */
42
- sprint?: string;
42
+ sprint?:string;
43
43
  /** Value that configures or reports release for this contract. */
44
- release?: string;
45
- [key: string]: unknown;
44
+ release?:string;
45
+ [key:string]:unknown;
46
46
  }
47
47
  /** Lifecycle buckets used by grouped breakdowns and distributions. */
48
48
  export type LifecycleBucket = "open" | "in_progress" | "blocked" | "draft" | "closed" | "canceled" | "other";
49
49
  /** Stable rendering order for lifecycle buckets. */
50
- export declare const LIFECYCLE_BUCKET_ORDER: readonly LifecycleBucket[];
50
+ export declare const LIFECYCLE_BUCKET_ORDER:readonly LifecycleBucket[];
51
51
  /**
52
52
  * Classifies a raw status string into a lifecycle bucket and reports whether a
53
53
  * status is terminal (closed/canceled). Callers build this from their resolved
@@ -55,26 +55,26 @@ export declare const LIFECYCLE_BUCKET_ORDER: readonly LifecycleBucket[];
55
55
  */
56
56
  export interface LifecycleClassifier {
57
57
  /** Value that configures or reports classify for this contract. */
58
- classify(status: string): LifecycleBucket;
58
+ classify(status:string):LifecycleBucket;
59
59
  /** Whether terminal applies to this operation. */
60
- isTerminal(status: string): boolean;
60
+ isTerminal(status:string):boolean;
61
61
  }
62
62
  /** The subset of a resolved runtime status registry this module consumes. */
63
63
  export interface StatusRegistryLike {
64
64
  /** Value that configures or reports alias to id for this contract. */
65
- alias_to_id: Map<string, string>;
65
+ alias_to_id:Map<string,string>;
66
66
  /** Value that configures or reports terminal statuses for this contract. */
67
- terminal_statuses: Set<string>;
67
+ terminal_statuses:Set<string>;
68
68
  /** Value that configures or reports terminal canceled statuses for this contract. */
69
- terminal_canceled_statuses: Set<string>;
69
+ terminal_canceled_statuses:Set<string>;
70
70
  /** Value that configures or reports blocked statuses for this contract. */
71
- blocked_statuses: Set<string>;
71
+ blocked_statuses:Set<string>;
72
72
  /** Value that configures or reports draft statuses for this contract. */
73
- draft_statuses: Set<string>;
73
+ draft_statuses:Set<string>;
74
74
  /** Value that configures or reports active statuses for this contract. */
75
- active_statuses: Set<string>;
75
+ active_statuses:Set<string>;
76
76
  /** Lifecycle state reported for openthe record. */
77
- open_status: string;
77
+ open_status:string;
78
78
  }
79
79
  /**
80
80
  * Adapt a resolved runtime status registry into a {@link LifecycleClassifier}.
@@ -82,54 +82,54 @@ open_status: string;
82
82
  * Precedence is deliberate and disjoint: canceled → closed → blocked → draft →
83
83
  * open → in_progress (active but not the default open status) → other.
84
84
  */
85
- export declare function lifecycleClassifierFromStatusRegistry(registry: StatusRegistryLike): LifecycleClassifier;
85
+ export declare function lifecycleClassifierFromStatusRegistry(registry:StatusRegistryLike):LifecycleClassifier;
86
86
  /** True when an item has no non-empty acceptance_criteria. */
87
- export declare function isAcMissing(item: CoverageItem): boolean;
87
+ export declare function isAcMissing(item:CoverageItem):boolean;
88
88
  /** True when an item has no finite estimated_minutes. */
89
- export declare function isEstimateMissing(item: CoverageItem): boolean;
89
+ export declare function isEstimateMissing(item:CoverageItem):boolean;
90
90
  /**
91
91
  * True when a terminal (closed/canceled) item has no non-empty resolution.
92
92
  * Resolution is only expected on terminal items, so open items are never
93
93
  * considered "resolution-missing".
94
94
  */
95
- export declare function isResolutionMissing(item: CoverageItem, classifier: LifecycleClassifier): boolean;
95
+ export declare function isResolutionMissing(item:CoverageItem,classifier:LifecycleClassifier):boolean;
96
96
  /** True when an item has no non-empty reviewer. */
97
- export declare function isReviewerMissing(item: CoverageItem): boolean;
97
+ export declare function isReviewerMissing(item:CoverageItem):boolean;
98
98
  /** True when an item has no non-empty risk level. */
99
- export declare function isRiskMissing(item: CoverageItem): boolean;
99
+ export declare function isRiskMissing(item:CoverageItem):boolean;
100
100
  /**
101
101
  * True when an item has no confidence value. Confidence is a string-like enum
102
102
  * or a numeric score depending on workspace, so a finite number counts as
103
103
  * present and only blank/absent values are treated as missing.
104
104
  */
105
- export declare function isConfidenceMissing(item: CoverageItem): boolean;
105
+ export declare function isConfidenceMissing(item:CoverageItem):boolean;
106
106
  /** True when an item has no non-empty sprint. */
107
- export declare function isSprintMissing(item: CoverageItem): boolean;
107
+ export declare function isSprintMissing(item:CoverageItem):boolean;
108
108
  /** True when an item has no non-empty release. */
109
- export declare function isReleaseMissing(item: CoverageItem): boolean;
109
+ export declare function isReleaseMissing(item:CoverageItem):boolean;
110
110
  /** Selection flags for {@link filterMissingMetadata}. */
111
111
  export interface MissingMetadataFilters {
112
112
  /** Value that configures or reports ac missing for this contract. */
113
- acMissing?: boolean;
113
+ acMissing?:boolean;
114
114
  /** Value that configures or reports estimates missing for this contract. */
115
- estimatesMissing?: boolean;
115
+ estimatesMissing?:boolean;
116
116
  /** Value that configures or reports resolution missing for this contract. */
117
- resolutionMissing?: boolean;
117
+ resolutionMissing?:boolean;
118
118
  /** Value that configures or reports reviewer missing for this contract. */
119
- reviewerMissing?: boolean;
119
+ reviewerMissing?:boolean;
120
120
  /** Value that configures or reports risk missing for this contract. */
121
- riskMissing?: boolean;
121
+ riskMissing?:boolean;
122
122
  /** Value that configures or reports confidence missing for this contract. */
123
- confidenceMissing?: boolean;
123
+ confidenceMissing?:boolean;
124
124
  /** Value that configures or reports sprint missing for this contract. */
125
- sprintMissing?: boolean;
125
+ sprintMissing?:boolean;
126
126
  /** Value that configures or reports release missing for this contract. */
127
- releaseMissing?: boolean;
127
+ releaseMissing?:boolean;
128
128
  /** Match items missing ANY of the tracked metadata fields (union). */
129
- metadataMissing?: boolean;
129
+ metadataMissing?:boolean;
130
130
  }
131
131
  /** True when any missing-metadata filter is requested. */
132
- export declare function hasMissingMetadataFilter(filters: MissingMetadataFilters): boolean;
132
+ export declare function hasMissingMetadataFilter(filters:MissingMetadataFilters):boolean;
133
133
  /**
134
134
  * Does a single item satisfy the requested missing-metadata filters?
135
135
  *
@@ -141,77 +141,77 @@ export declare function hasMissingMetadataFilter(filters: MissingMetadataFilters
141
141
  * deliberately excludes the governance fields so the long-standing flag keeps
142
142
  * its original meaning. When no filter is requested the item passes.
143
143
  */
144
- export declare function itemMatchesMissingMetadata(item: CoverageItem, filters: MissingMetadataFilters, classifier: LifecycleClassifier): boolean;
144
+ export declare function itemMatchesMissingMetadata(item:CoverageItem,filters:MissingMetadataFilters,classifier:LifecycleClassifier):boolean;
145
145
  /** Filter a list of items by the requested missing-metadata predicates. */
146
- export declare function filterMissingMetadata<T extends CoverageItem>(items: readonly T[], filters: MissingMetadataFilters, classifier: LifecycleClassifier): T[];
146
+ export declare function filterMissingMetadata<T extends CoverageItem>(items:readonly T[],filters:MissingMetadataFilters,classifier:LifecycleClassifier):T[];
147
147
  /** Coverage-tracked metadata fields. */
148
148
  export type CoverageField = "acceptance_criteria" | "estimated_minutes" | "resolution" | "tags" | "parent";
149
149
  /** Stable ordering of coverage fields for rendering. */
150
- export declare const COVERAGE_FIELD_ORDER: readonly CoverageField[];
150
+ export declare const COVERAGE_FIELD_ORDER:readonly CoverageField[];
151
151
  /** Coverage of a single field: present vs applicable, with a rounded percent. */
152
152
  export interface FieldCoverage {
153
153
  /** Value that configures or reports present for this contract. */
154
- present: number;
154
+ present:number;
155
155
  /** Items for which the field is expected (all items, except resolution = terminal only). */
156
- applicable: number;
156
+ applicable:number;
157
157
  /** present/applicable * 100, rounded to one decimal; 100 when applicable is 0. */
158
- percent: number;
158
+ percent:number;
159
159
  }
160
160
  /**
161
161
  * Documents the metadata coverage report payload exchanged by command, SDK, and package integrations.
162
162
  */
163
163
  export interface MetadataCoverageReport {
164
164
  /** Value that configures or reports overall for this contract. */
165
- overall: Record<CoverageField, FieldCoverage>;
165
+ overall:Record<CoverageField,FieldCoverage>;
166
166
  /** Schema type that determines the shape and validation rules for this value. */
167
- by_type: Record<string, Record<CoverageField, FieldCoverage>>;
167
+ by_type:Record<string,Record<CoverageField,FieldCoverage>>;
168
168
  }
169
169
  /**
170
170
  * Compute metadata coverage overall and per item type. For each tracked field
171
171
  * we report present/applicable counts and a rounded percentage. Resolution is
172
172
  * scoped to terminal items (its only applicable population).
173
173
  */
174
- export declare function computeMetadataCoverage(items: readonly CoverageItem[], classifier: LifecycleClassifier): MetadataCoverageReport;
174
+ export declare function computeMetadataCoverage(items:readonly CoverageItem[],classifier:LifecycleClassifier):MetadataCoverageReport;
175
175
  /** Dimensions a breakdown can group by. */
176
176
  export type GroupDimension = "assignee" | "priority" | "tag" | "parent" | "type" | "status";
177
177
  /** Explicit label for an empty/blank group value for a given dimension. */
178
- export declare function emptyGroupLabel(dimension: GroupDimension): string;
178
+ export declare function emptyGroupLabel(dimension:GroupDimension):string;
179
179
  /**
180
180
  * Documents the group row payload exchanged by command, SDK, and package integrations.
181
181
  */
182
182
  export interface GroupRow {
183
183
  /** Display label; explicit "(unassigned)"-style label for blank keys. */
184
- label: string;
184
+ label:string;
185
185
  /** Stable structured key (null for the empty/blank group). */
186
- key: string | null;
186
+ key:string | null;
187
187
  /** Value that configures or reports buckets for this contract. */
188
- buckets: Record<LifecycleBucket, number>;
188
+ buckets:Record<LifecycleBucket,number>;
189
189
  /** Value that configures or reports total for this contract. */
190
- total: number;
190
+ total:number;
191
191
  }
192
192
  /**
193
193
  * Documents the grouped breakdown payload exchanged by command, SDK, and package integrations.
194
194
  */
195
195
  export interface GroupedBreakdown {
196
196
  /** Value that configures or reports dimension for this contract. */
197
- dimension: GroupDimension;
197
+ dimension:GroupDimension;
198
198
  /** Value that configures or reports rows for this contract. */
199
- rows: GroupRow[];
199
+ rows:GroupRow[];
200
200
  /** Distinct items observed (an item can contribute to multiple tag rows). */
201
- total_items: number;
201
+ total_items:number;
202
202
  }
203
203
  /**
204
204
  * Documents the group options payload exchanged by command, SDK, and package integrations.
205
205
  */
206
206
  export interface GroupOptions {
207
207
  /** For dimension="tag": only consider tags starting with this prefix. */
208
- tagPrefix?: string;
208
+ tagPrefix?:string;
209
209
  }
210
210
  /**
211
211
  * Group items by a dimension into lifecycle-bucketed rows. Blank keys render
212
212
  * with an explicit "(unassigned)"-style label. Rows are sorted by total
213
213
  * descending, then label ascending, with the empty group sorted last on ties.
214
214
  */
215
- export declare function groupItemsByDimension(items: readonly CoverageItem[], dimension: GroupDimension, classifier: LifecycleClassifier, options?: GroupOptions): GroupedBreakdown;
215
+ export declare function groupItemsByDimension(items:readonly CoverageItem[],dimension:GroupDimension,classifier:LifecycleClassifier,options?:GroupOptions):GroupedBreakdown;
216
216
  /** Lifecycle-bucket distribution across all items (for stats lifecycle section). */
217
- export declare function computeLifecycleDistribution(items: readonly CoverageItem[], classifier: LifecycleClassifier): Record<LifecycleBucket, number>;
217
+ export declare function computeLifecycleDistribution(items:readonly CoverageItem[],classifier:LifecycleClassifier):Record<LifecycleBucket,number>;
@@ -1,12 +1,12 @@
1
1
  /** Digest algorithms supported for item anchors and immutable record envelopes. */
2
- export declare const HISTORY_HASH_ALGORITHMS: readonly ["sha256", "sha512"];
2
+ export declare const HISTORY_HASH_ALGORITHMS:readonly ["sha256","sha512"];
3
3
  /** Explicit algorithm accepted by history writers. */
4
4
  export type HistoryHashAlgorithm = (typeof HISTORY_HASH_ALGORITHMS)[number];
5
5
  /** Historical default, fixed permanently so unlabeled records remain readable. */
6
- export declare const LEGACY_HISTORY_HASH_ALGORITHM: "sha256";
6
+ export declare const LEGACY_HISTORY_HASH_ALGORITHM:"sha256";
7
7
  /** Algorithm written on new records unless a caller explicitly selects another. */
8
- export declare const CURRENT_HISTORY_HASH_ALGORITHM: "sha256";
8
+ export declare const CURRENT_HISTORY_HASH_ALGORITHM:"sha256";
9
9
  /** Validate a persisted algorithm before passing it to the crypto provider. */
10
- export declare function resolveHistoryHashAlgorithm(value?: string): HistoryHashAlgorithm;
10
+ export declare function resolveHistoryHashAlgorithm(value?:string):HistoryHashAlgorithm;
11
11
  /** Hash canonical UTF-8 bytes using the declared algorithm, rejecting unknown labels. */
12
- export declare function historyDigest(value: string, algorithm?: string): string;
12
+ export declare function historyDigest(value:string,algorithm?:string):string;
@@ -1,4 +1,4 @@
1
1
  /** Remove the derived drift cache after a history mutation; a missing or concurrently removed cache is already invalidated. */
2
- export declare function invalidateHistoryDriftCache(pmRoot: string): Promise<void>;
2
+ export declare function invalidateHistoryDriftCache(pmRoot:string):Promise<void>;
3
3
  /** Resolve a conventional tracker root from a history stream path and invalidate its derived verification cache. */
4
- export declare function invalidateHistoryDriftCacheForPath(historyPath: string): Promise<void>;
4
+ export declare function invalidateHistoryDriftCacheForPath(historyPath:string):Promise<void>;
@@ -3,39 +3,39 @@ import type { ItemMetadata } from "../../types/index.js";
3
3
  /** Documents the drift scan result payload exchanged by command, SDK, and package integrations. */
4
4
  export interface DriftScanResult {
5
5
  /** Repeated genesis ordinals and observed sequence, keyed by affected item. */
6
- identityDiscontinuities?: Array<HistoryIdentityDiscontinuity & {
7
- item_id: string;
6
+ identityDiscontinuities?:Array<HistoryIdentityDiscontinuity & {
7
+ item_id:string;
8
8
  }>;
9
9
  /** Value that configures or reports missing streams for this contract. */
10
- missingStreams: string[];
10
+ missingStreams:string[];
11
11
  /** Value that configures or reports unreadable streams for this contract. */
12
- unreadableStreams: string[];
12
+ unreadableStreams:string[];
13
13
  /** Value that configures or reports hash mismatches for this contract. */
14
- hashMismatches: string[];
14
+ hashMismatches:string[];
15
15
  /** Value that configures or reports chain mismatches for this contract. */
16
- chainMismatches: string[];
16
+ chainMismatches:string[];
17
17
  /** Streams written with a hash capability newer than this runtime understands. */
18
- versionSkews: string[];
18
+ versionSkews:string[];
19
19
  /** Value that configures or reports drifted items for this contract. */
20
- driftedItems: string[];
20
+ driftedItems:string[];
21
21
  /** Governed singleton files whose JSON differs from workspace-history replay. */
22
- workspaceStateMismatches: string[];
22
+ workspaceStateMismatches:string[];
23
23
  /** Governed singleton files absent from disk. */
24
- workspaceStateMissing: string[];
24
+ workspaceStateMissing:string[];
25
25
  /** Governed singleton files unreadable as safe workspace-local JSON. */
26
- workspaceStateUnreadable: string[];
26
+ workspaceStateUnreadable:string[];
27
27
  }
28
28
  /** Controls how cached history stream verification is trusted when the file stat tuple still matches a previous scan. */
29
29
  export type DriftCacheHitVerification = "content_hash" | "metadata";
30
30
  /** Documents the history drift scan options shared by health, validate, and repair callers. */
31
31
  export interface DriftScanOptions {
32
32
  /** Value that configures or reports cache hit verification for this contract. */
33
- cacheHitVerification?: DriftCacheHitVerification;
33
+ cacheHitVerification?:DriftCacheHitVerification;
34
34
  }
35
35
  /** Strictly verify one item using the shared stream verifier without reading or writing the corpus cache or inspecting workspace histories and documents. */
36
- export declare function scanItemHistoryDrift(pmRoot: string, item: ItemMetadata & {
37
- body: string;
38
- }): Promise<DriftScanResult>;
36
+ export declare function scanItemHistoryDrift(pmRoot:string,item:ItemMetadata & {
37
+ body:string;
38
+ }):Promise<DriftScanResult>;
39
39
  /**
40
40
  * Scan every item's history stream for drift (missing/unreadable streams, broken
41
41
  * hash chains, and item/history hash mismatches).
@@ -46,6 +46,6 @@ body: string;
46
46
  * content hash on metadata hits; latency-sensitive health checks can opt into
47
47
  * trusting the stat tuple and skip rereading unchanged streams.
48
48
  */
49
- export declare function scanHistoryDrift(pmRoot: string, items: Array<ItemMetadata & {
50
- body: string;
51
- }>, options?: DriftScanOptions): Promise<DriftScanResult>;
49
+ export declare function scanHistoryDrift(pmRoot:string,items:Array<ItemMetadata & {
50
+ body:string;
51
+ }>,options?:DriftScanOptions):Promise<DriftScanResult>;
@@ -6,16 +6,16 @@
6
6
  */
7
7
  import type { HistoryEntry } from "../../types/index.js";
8
8
  /** Current version of the public history-event classification policy. */
9
- export declare const HISTORY_EVENT_CLASSIFICATION_VERSION: 1;
9
+ export declare const HISTORY_EVENT_CLASSIFICATION_VERSION:1;
10
10
  /** Semantic effect of an immutable history event on project recency. */
11
11
  export type HistoryEventClass = "substantive" | "maintenance";
12
12
  /** Operations whose meaning is always governance or storage maintenance. */
13
- export declare const MAINTENANCE_HISTORY_OPERATIONS: readonly ["docs_add", "files_add", "history:author-acknowledge", "history_author_acknowledge", "history_compact", "history_compact_baseline", "history_redact", "history_repair", "history_salvage", "normalize", "release", "test_run_track", "tests_add", "tests_remove", "tests_update", "update_audit", "update_ownership_bypass"];
13
+ export declare const MAINTENANCE_HISTORY_OPERATIONS:readonly ["docs_add","files_add","history:author-acknowledge","history_author_acknowledge","history_compact","history_compact_baseline","history_redact","history_repair","history_salvage","normalize","release","test_run_track","tests_add","tests_remove","tests_update","update_audit","update_ownership_bypass"];
14
14
  /** Operations whose meaning always advances lifecycle or working context. */
15
- export declare const SUBSTANTIVE_HISTORY_OPERATIONS: readonly ["append", "cancel", "claim", "close", "comment_add", "create", "learning_add", "note_add", "reopen"];
15
+ export declare const SUBSTANTIVE_HISTORY_OPERATIONS:readonly ["append","cancel","claim","close","comment_add","create","learning_add","note_add","reopen"];
16
16
  /**
17
17
  * Classify an immutable event using its declared class when present, then the
18
18
  * versioned operation/path contract. Unknown events fail closed as substantive
19
19
  * so new work cannot silently disappear from temporal relevance.
20
20
  */
21
- export declare function classifyHistoryEvent(entry: Pick<HistoryEntry, "op" | "patch" | "event_class">): HistoryEventClass;
21
+ export declare function classifyHistoryEvent(entry:Pick<HistoryEntry,"op" | "patch" | "event_class">):HistoryEventClass;
@@ -1,84 +1,84 @@
1
1
  import type { DatabaseSync } from "node:sqlite";
2
2
  import type { HistoryEntry } from "../../types/index.js";
3
- import { loadDatabaseSync, loadStableDatabaseSync } from "../store/sqlite-runtime.js";
3
+ import { loadDatabaseSync,loadStableDatabaseSync } from "../store/sqlite-runtime.js";
4
4
  type DatabaseSyncConstructor = typeof DatabaseSync;
5
5
  /** Stable location of one history entry inside its authoritative stream. */
6
6
  export interface IndexedHistoryEvent {
7
7
  /** History stream subject, normally an item id or `_workspace`. */
8
- stream_id: string;
8
+ stream_id:string;
9
9
  /** Zero-based line position among parsed entries in the stream. */
10
- stream_offset: number;
10
+ stream_offset:number;
11
11
  /** Authoritative history entry. */
12
- entry: HistoryEntry;
12
+ entry:HistoryEntry;
13
13
  }
14
14
  /** Index-native filters and continuation bounds for mutation events. */
15
15
  export interface HistoryEventIndexQuery {
16
16
  /** Return events strictly after this timestamp. */
17
- after_ts?: string;
17
+ after_ts?:string;
18
18
  /** Stream tie-breaker paired with `after_ts`. */
19
- after_stream_id?: string;
19
+ after_stream_id?:string;
20
20
  /** Offset tie-breaker paired with `after_ts` and `after_stream_id`. */
21
- after_stream_offset?: number;
21
+ after_stream_offset?:number;
22
22
  /** Inclusive timestamp lower bound used when no cursor is supplied. */
23
- since_ts?: string;
23
+ since_ts?:string;
24
24
  /** Include only these operation names. */
25
- ops?: readonly string[];
25
+ ops?:readonly string[];
26
26
  /** Include only these authors. */
27
- authors?: readonly string[];
27
+ authors?:readonly string[];
28
28
  /** Include recorded harnesses or alias authors resolving to them. */
29
- harnesses?: readonly string[];
29
+ harnesses?:readonly string[];
30
30
  /** Legacy author literals accepted by the requested harness vocabulary. */
31
- harness_alias_authors?: readonly string[];
31
+ harness_alias_authors?:readonly string[];
32
32
  /** Include only these privacy-safe invocation fingerprints. */
33
- agent_instances?: readonly string[];
33
+ agent_instances?:readonly string[];
34
34
  /** Exact extensible provenance dimension predicates. */
35
- provenance?: ReadonlyArray<{
36
- dimension: string;
37
- values: readonly string[];
35
+ provenance?:ReadonlyArray<{
36
+ dimension:string;
37
+ values:readonly string[];
38
38
  }>;
39
39
  /** Include only these stream subjects. */
40
- stream_ids?: readonly string[];
40
+ stream_ids?:readonly string[];
41
41
  /** Maximum events returned. */
42
- limit: number;
42
+ limit:number;
43
43
  }
44
44
  /** Bounded mutation-event query result from the persistent projection. */
45
45
  export interface HistoryEventIndexQueryResult {
46
46
  /** Ordered event rows. */
47
- events: IndexedHistoryEvent[];
47
+ events:IndexedHistoryEvent[];
48
48
  /** Whether another matching event exists. */
49
- has_more: boolean;
49
+ has_more:boolean;
50
50
  }
51
51
  /** Latest substantive immutable event for each requested history stream. */
52
- export type LatestSubstantiveHistoryEvents = Readonly<Record<string, IndexedHistoryEvent>>;
52
+ export type LatestSubstantiveHistoryEvents = Readonly<Record<string,IndexedHistoryEvent>>;
53
53
  /** Rebuild the complete optional event projection from authoritative streams. */
54
- export declare function rebuildHistoryEventIndex(pmRoot: string): Promise<boolean>;
54
+ export declare function rebuildHistoryEventIndex(pmRoot:string):Promise<boolean>;
55
55
  /**
56
56
  * Query authoritative history streams when the optional SQLite accelerator is
57
57
  * unavailable. The result preserves the index contract at higher read cost.
58
58
  */
59
- export declare function queryHistoryEventStreams(pmRoot: string, query: HistoryEventIndexQuery): Promise<HistoryEventIndexQueryResult>;
59
+ export declare function queryHistoryEventStreams(pmRoot:string,query:HistoryEventIndexQuery):Promise<HistoryEventIndexQueryResult>;
60
60
  /**
61
61
  * Serialize an authoritative append with its optional SQLite projection.
62
62
  * The database write lock spans the file append and size capture, so compliant
63
63
  * cross-process writers cannot certify a newer stream size with older rows.
64
64
  */
65
- export declare function appendHistoryEntryWithEventIndex(historyPath: string, entry: HistoryEntry, append: () => Promise<void>): Promise<void>;
65
+ export declare function appendHistoryEntryWithEventIndex(historyPath:string,entry:HistoryEntry,append:() => Promise<void>):Promise<void>;
66
66
  /** Invalidate the optional event projection after a non-append rewrite. */
67
- export declare function removeHistoryEventIndexForHistoryPath(historyPath: string): Promise<void>;
67
+ export declare function removeHistoryEventIndexForHistoryPath(historyPath:string):Promise<void>;
68
68
  /** Query the optional event projection without scanning history streams. */
69
- export declare function queryHistoryEventIndex(pmRoot: string, query: HistoryEventIndexQuery): Promise<HistoryEventIndexQueryResult | null>;
70
- declare function collectLatestSubstantiveEvents(events: readonly IndexedHistoryEvent[], requested: ReadonlySet<string>): Record<string, IndexedHistoryEvent>;
69
+ export declare function queryHistoryEventIndex(pmRoot:string,query:HistoryEventIndexQuery):Promise<HistoryEventIndexQueryResult | null>;
70
+ declare function collectLatestSubstantiveEvents(events:readonly IndexedHistoryEvent[],requested:ReadonlySet<string>):Record<string,IndexedHistoryEvent>;
71
71
  /**
72
72
  * Read one latest substantive coordinate per requested stream. The optional
73
73
  * SQLite projection is preferred; individual authoritative streams are the
74
74
  * fail-closed fallback and remain the source of truth.
75
75
  */
76
- export declare function readLatestSubstantiveHistoryEvents(pmRoot: string, streamIds: readonly string[]): Promise<LatestSubstantiveHistoryEvents>;
76
+ export declare function readLatestSubstantiveHistoryEvents(pmRoot:string,streamIds:readonly string[]):Promise<LatestSubstantiveHistoryEvents>;
77
77
  /** Test-only dependency seam for runtimes without `node:sqlite`. */
78
- export declare const _testOnly: {
79
- collectLatestSubstantiveEvents: typeof collectLatestSubstantiveEvents;
80
- loadDatabaseSync: typeof loadDatabaseSync;
81
- loadStableDatabaseSync: typeof loadStableDatabaseSync;
82
- setDatabaseSync(databaseSync: DatabaseSyncConstructor | null): () => void;
78
+ export declare const _testOnly:{
79
+ collectLatestSubstantiveEvents:typeof collectLatestSubstantiveEvents;
80
+ loadDatabaseSync:typeof loadDatabaseSync;
81
+ loadStableDatabaseSync:typeof loadStableDatabaseSync;
82
+ setDatabaseSync(databaseSync:DatabaseSyncConstructor | null):() => void;
83
83
  };
84
84
  export {};
@@ -26,33 +26,33 @@ export type HistoryCompactBulkSkipReason = "no_stream" | "already_compact" | "sc
26
26
  */
27
27
  export interface HistoryCompactBulkCandidate {
28
28
  /** Stable identifier used to reference this record across commands and storage. */
29
- id: string;
29
+ id:string;
30
30
  /** Value that configures or reports entries for this contract. */
31
- entries: number;
31
+ entries:number;
32
32
  /** Value that configures or reports bucket for this contract. */
33
- bucket: LifecycleBucket | null;
33
+ bucket:LifecycleBucket | null;
34
34
  }
35
35
  /** Selection criteria resolved from the command flags + policy defaults. */
36
36
  export interface HistoryCompactBulkCriteria {
37
37
  /** Explicit, ordered list of item ids to compact. When non-empty the selection runs in "ids" mode: scope/allOver are ignored and only the `minEntries` floor applies. Duplicates are collapsed, preserving first-seen order. */
38
- ids?: string[];
38
+ ids?:string[];
39
39
  /** Lifecycle scope filter for scan mode (ignored in ids mode). */
40
- scope?: HistoryCompactScope;
40
+ scope?:HistoryCompactScope;
41
41
  /** Streams with at most this many entries are skipped as `already_compact` (compaction collapses a stream to a 2-entry baseline+audit pair, so smaller streams gain nothing). Applies in both modes. */
42
- minEntries: number;
42
+ minEntries:number;
43
43
  /** Scan mode only: when set, only streams with strictly more entries than this are selected. Streams above `minEntries` but at/below `allOver` are skipped as `below_threshold`. */
44
- allOver?: number;
44
+ allOver?:number;
45
45
  }
46
46
  /** Per-candidate selection outcome. */
47
47
  export interface HistoryCompactBulkSelectionRow {
48
48
  /** Stable identifier used to reference this record across commands and storage. */
49
- id: string;
49
+ id:string;
50
50
  /** Value that configures or reports entries for this contract. */
51
- entries: number;
51
+ entries:number;
52
52
  /** Value that configures or reports selected for this contract. */
53
- selected: boolean;
53
+ selected:boolean;
54
54
  /** Value that configures or reports skip reason for this contract. */
55
- skip_reason: HistoryCompactBulkSkipReason | null;
55
+ skip_reason:HistoryCompactBulkSkipReason | null;
56
56
  }
57
57
  /**
58
58
  * Decide which history streams to compact.
@@ -61,4 +61,4 @@ skip_reason: HistoryCompactBulkSkipReason | null;
61
61
  * honouring only the `minEntries` floor) and "scan" mode otherwise (every
62
62
  * candidate, filtered by scope and entry thresholds, ordered deepest-first).
63
63
  */
64
- export declare function selectHistoryCompactBulkTargets(candidates: HistoryCompactBulkCandidate[], criteria: HistoryCompactBulkCriteria): HistoryCompactBulkSelectionRow[];
64
+ export declare function selectHistoryCompactBulkTargets(candidates:HistoryCompactBulkCandidate[],criteria:HistoryCompactBulkCriteria):HistoryCompactBulkSelectionRow[];
@@ -2,28 +2,28 @@ import type { HistoryEntry } from "../../types/index.js";
2
2
  /** Documents the history field change payload exchanged by command, SDK, and package integrations. */
3
3
  export interface HistoryFieldChange {
4
4
  /** Value that configures or reports field for this contract. */
5
- field: string;
5
+ field:string;
6
6
  /** Value that configures or reports before for this contract. */
7
- before: unknown;
7
+ before:unknown;
8
8
  /** Value that configures or reports after for this contract. */
9
- after: unknown;
9
+ after:unknown;
10
10
  }
11
11
  /** Documents the history diff value entry payload exchanged by command, SDK, and package integrations. */
12
12
  export interface HistoryDiffValueEntry {
13
13
  /** 1-based position in the FULL stream (fullEntries index + 1). */
14
- index: number;
14
+ index:number;
15
15
  /** Value that configures or reports ts for this contract. */
16
- ts: string;
16
+ ts:string;
17
17
  /** Value that configures or reports op for this contract. */
18
- op: string;
18
+ op:string;
19
19
  /** Value that configures or reports author for this contract. */
20
- author: string;
20
+ author:string;
21
21
  /** Number of JSON-patch operations in this entry (entry.patch.length). */
22
- patch_ops: number;
22
+ patch_ops:number;
23
23
  /** Unique field names touched by this entry, sorted by localeCompare. */
24
- changed_fields: string[];
24
+ changed_fields:string[];
25
25
  /** Per-field before/after values, sorted by field name (localeCompare). */
26
- changes: HistoryFieldChange[];
26
+ changes:HistoryFieldChange[];
27
27
  }
28
28
  /**
29
29
  * Map a JSON-Patch path string to a human-readable changed-field name.
@@ -36,7 +36,7 @@ changes: HistoryFieldChange[];
36
36
  * - "/" (root pointer, empty segment after strip) → "root"
37
37
  * - anything else → decoded first path segment
38
38
  */
39
- export declare function patchPathToChangedField(path: string): string;
39
+ export declare function patchPathToChangedField(path:string):string;
40
40
  /**
41
41
  * Replay a full history entry stream and produce enriched diff entries with
42
42
  * per-field before/after values.
@@ -49,7 +49,7 @@ export declare function patchPathToChangedField(path: string): string;
49
49
  * emitted, and each emitted entry's `changes` and `changed_fields` are
50
50
  * restricted to that single field.
51
51
  */
52
- export declare function computeHistoryDiff(fullEntries: HistoryEntry[], options?: {
53
- windowStartIndex?: number;
54
- field?: string;
55
- }): HistoryDiffValueEntry[];
52
+ export declare function computeHistoryDiff(fullEntries:HistoryEntry[],options?:{
53
+ windowStartIndex?:number;
54
+ field?:string;
55
+ }):HistoryDiffValueEntry[];