@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
@@ -1,211 +1,211 @@
1
1
  import type { Stats } from "node:fs";
2
- import { type ItemMergeConflictDecision, type ItemScalarConflictResolution, type MergePreferredSide } from "./three-way.js";
2
+ import { type ItemMergeConflictDecision,type ItemScalarConflictResolution,type MergePreferredSide } from "./three-way.js";
3
3
  import type { MergeReceiptOperation } from "./receipt-operation.js";
4
4
  import { DURABLE_VALUE_POLICY } from "./receipt-schema.js";
5
5
  export { isSafeReceiptId } from "./receipt-schema.js";
6
6
  /** One clone-local merge receipt with recoverable branch values. */
7
7
  export interface MergeDecisionReceipt {
8
8
  /** Receipt schema version. */
9
- version: 1;
9
+ version:1;
10
10
  /** Opaque receipt identity referenced from public history. */
11
- id: string;
11
+ id:string;
12
12
  /** Repository-relative item path supplied by Git as `%P`. */
13
- item_path: string;
13
+ item_path:string;
14
14
  /** Item id derived from the merged document path. */
15
- item_id: string;
15
+ item_id:string;
16
16
  /** Side requested by the caller; stable-value decisions can retain either side. */
17
- requested_preference?: MergePreferredSide;
17
+ requested_preference?:MergePreferredSide;
18
18
  /** Whether requested preference participates in item scalar selection. */
19
- requested_preference_applied?: boolean;
19
+ requested_preference_applied?:boolean;
20
20
  /** Legacy schema-v1 key accepted while reading older clone-local receipts. */
21
- preferred?: MergePreferredSide;
21
+ preferred?:MergePreferredSide;
22
22
  /** Scalar-conflict selection contract used by the item driver. */
23
- conflict_resolution: ItemScalarConflictResolution;
23
+ conflict_resolution:ItemScalarConflictResolution;
24
24
  /** Fields selected cleanly from the other branch. */
25
- fields_from_theirs: string[];
25
+ fields_from_theirs:string[];
26
26
  /** Collections combined from both branches. */
27
- union_fields: string[];
27
+ union_fields:string[];
28
28
  /** SHA-256 hashes of the merged values for every field represented by this receipt. Absent on legacy receipts, which cannot prove drift attribution. */
29
- merged_field_hashes?: Record<string, string>;
29
+ merged_field_hashes?:Record<string,string>;
30
30
  /** Full recoverable scalar decisions, retained only in the clone. */
31
- decisions: ItemMergeConflictDecision[];
31
+ decisions:ItemMergeConflictDecision[];
32
32
  /** Immutable original Git coordinates captured while the driver runs during a merge or rebase. */
33
- operation?: MergeReceiptOperation;
33
+ operation?:MergeReceiptOperation;
34
34
  /** Explicit audited disposition when the original Git state was restored instead of merging. */
35
- settlement?: "original_git_state_restored";
35
+ settlement?:"original_git_state_restored";
36
36
  /** Whether a reconciliation history event settled this receipt. */
37
- state: "pending" | "reconciled";
37
+ state:"pending" | "reconciled";
38
38
  /** Receipt creation timestamp. */
39
- created_at: string;
39
+ created_at:string;
40
40
  /** Reconciliation timestamp, when consumed. */
41
- reconciled_at?: string;
41
+ reconciled_at?:string;
42
42
  /** Whether decision values are recoverable locally or represented by hashes only. */
43
- value_availability?: "clone_local" | "hash_only" | "bounded_inline" | "mixed";
43
+ value_availability?:"clone_local" | "hash_only" | "bounded_inline" | "mixed";
44
44
  /** Versioned rule governing which durable scalar previews may be committed. */
45
- value_policy?: typeof DURABLE_VALUE_POLICY;
45
+ value_policy?:typeof DURABLE_VALUE_POLICY;
46
46
  /** Runtime-only provenance assigned by the reader; serialized values are ignored. */
47
- evidence_source?: "clone_local" | "durable";
47
+ evidence_source?:"clone_local" | "durable";
48
48
  }
49
49
  /** Privacy-safe receipt summary suitable for committed history context. */
50
50
  export interface MergeDecisionReceiptSummary {
51
51
  /** Opaque clone-local receipt identity. */
52
- receipt_id: string;
52
+ receipt_id:string;
53
53
  /** Item whose merge produced the receipt. */
54
- item_id: string;
54
+ item_id:string;
55
55
  /** Repository-relative item path. */
56
- item_path: string;
56
+ item_path:string;
57
57
  /** Scalar fields that required a preferred-side decision. */
58
- conflict_fields: string[];
58
+ conflict_fields:string[];
59
59
  /** Fields selected cleanly from the other branch. */
60
- fields_from_theirs: string[];
60
+ fields_from_theirs:string[];
61
61
  /** Collections combined from both branches. */
62
- union_fields: string[];
62
+ union_fields:string[];
63
63
  /** Side requested by the caller; decision hashes prove the actual retained values. */
64
- requested_preference: MergePreferredSide;
64
+ requested_preference:MergePreferredSide;
65
65
  /** Whether requested preference participated in item scalar selection. */
66
- requested_preference_applied: boolean;
66
+ requested_preference_applied:boolean;
67
67
  /** Scalar-conflict selection contract used by the item driver. */
68
- conflict_resolution: ItemScalarConflictResolution;
68
+ conflict_resolution:ItemScalarConflictResolution;
69
69
  /** Hashes proving the retained and discarded values without publishing them. */
70
- decisions: Array<{
71
- field: string;
72
- retained_hash: string;
73
- discarded_hash: string;
70
+ decisions:Array<{
71
+ field:string;
72
+ retained_hash:string;
73
+ discarded_hash:string;
74
74
  }>;
75
75
  }
76
76
  /** Structured result for the explicit clone-local merge report command. */
77
77
  export interface MergeReceiptReport {
78
78
  /** Whether the report was read successfully. */
79
- ok: true;
79
+ ok:true;
80
80
  /** Number of receipts returned. */
81
- count: number;
81
+ count:number;
82
82
  /** Receipts including recoverable values from the local clone only. */
83
- receipts: MergeDecisionReceipt[];
83
+ receipts:MergeDecisionReceipt[];
84
84
  /** ISO timestamp for the report. */
85
- generated_at: string;
85
+ generated_at:string;
86
86
  }
87
87
  /** Loss-aware merge receipt report for integrity gates and diagnostic adapters. */
88
88
  export interface MergeReceiptEvidenceReport {
89
89
  /** Whether clone-local evidence resolved and every candidate was read and validated successfully. */
90
- ok: boolean;
90
+ ok:boolean;
91
91
  /** Whether clone-local evidence resolved and every discovered JSON candidate was read and validated successfully. */
92
- complete: boolean;
92
+ complete:boolean;
93
93
  /** Number of valid receipts returned. */
94
- count: number;
94
+ count:number;
95
95
  /** Number of candidates rejected by bounded-file, schema, identity, or copy-consistency validation. */
96
- invalid_evidence_count: number;
96
+ invalid_evidence_count:number;
97
97
  /** Bounded privacy-safe identities and reason codes for rejected evidence. */
98
- invalid_evidence: MergeReceiptInvalidEvidence[];
98
+ invalid_evidence:MergeReceiptInvalidEvidence[];
99
99
  /** Whether additional rejected evidence was omitted from the bounded detail list. */
100
- invalid_evidence_truncated: boolean;
100
+ invalid_evidence_truncated:boolean;
101
101
  /** Whether the clone-local Git receipt directory was resolved successfully; always emitted by current implementations and optional for structural compatibility. */
102
- clone_local_evidence_resolved?: boolean;
102
+ clone_local_evidence_resolved?:boolean;
103
103
  /** Receipts including recoverable values from the local clone only. */
104
- receipts: MergeDecisionReceipt[];
104
+ receipts:MergeDecisionReceipt[];
105
105
  /** ISO timestamp for the report. */
106
- generated_at: string;
106
+ generated_at:string;
107
107
  }
108
108
  /** Loss-aware receipt inspection result that never exposes malformed file contents. */
109
109
  export interface MergeReceiptEvidenceScan {
110
110
  /** Valid receipts that passed bounded-file, schema, and identity validation. */
111
- receipts: MergeDecisionReceipt[];
111
+ receipts:MergeDecisionReceipt[];
112
112
  /** Number of JSON receipt candidates that could not be validated safely. */
113
- invalid_evidence_count: number;
113
+ invalid_evidence_count:number;
114
114
  /** Bounded privacy-safe identities and reason codes for rejected evidence. */
115
- invalid_evidence: MergeReceiptInvalidEvidence[];
115
+ invalid_evidence:MergeReceiptInvalidEvidence[];
116
116
  /** Whether additional rejected evidence was omitted from the bounded detail list. */
117
- invalid_evidence_truncated: boolean;
117
+ invalid_evidence_truncated:boolean;
118
118
  /** Whether the clone-local Git receipt directory was resolved successfully; always emitted by current implementations and optional for structural compatibility. */
119
- clone_local_evidence_resolved?: boolean;
119
+ clone_local_evidence_resolved?:boolean;
120
120
  }
121
121
  /** Stable privacy-safe classification for one rejected receipt candidate or source. */
122
122
  export interface MergeReceiptInvalidEvidence {
123
123
  /** Evidence store that produced the rejected candidate. */
124
- evidence_source: "clone_local" | "durable" | "clone_local_and_durable";
124
+ evidence_source:"clone_local" | "durable" | "clone_local_and_durable";
125
125
  /** Stable failure class suitable for remediation routing and graph analytics. */
126
- reason: "directory_unreadable" | "candidate_not_bounded_regular_file" | "candidate_unreadable" | "candidate_invalid_json" | "schema_or_identity_invalid" | "schema_invalid" | "identity_invalid" | "copy_provenance_mismatch";
126
+ reason:"directory_unreadable" | "candidate_not_bounded_regular_file" | "candidate_unreadable" | "candidate_invalid_json" | "schema_or_identity_invalid" | "schema_invalid" | "identity_invalid" | "copy_provenance_mismatch";
127
127
  /** Exact validation boundary when schema or identity evidence is rejected. */
128
- validation_error?: "required_fields" | "receipt_id" | "item_id" | "item_path" | "filename" | "collections" | "enums" | "timestamps" | "durable_decisions" | "operation";
128
+ validation_error?:"required_fields" | "receipt_id" | "item_id" | "item_path" | "filename" | "collections" | "enums" | "timestamps" | "durable_decisions" | "operation";
129
129
  /** Exact schema coordinate, excluding rejected values and user-controlled field names. */
130
- validation_path?: string;
130
+ validation_path?:string;
131
131
  /** Receipt identity when the bounded filename itself is a valid receipt id. */
132
- receipt_id?: string;
132
+ receipt_id?:string;
133
133
  /** SHA-256 locator for an unsafe or malformed candidate filename. */
134
- candidate_name_hash?: string;
134
+ candidate_name_hash?:string;
135
135
  }
136
136
  /** Revalidate one receipt and stage its atomic reconciled-state replacement. */
137
- declare function prepareReceiptSettlement(params: {
138
- receiptPath: string;
139
- receiptId: string;
140
- evidenceSource: "clone_local" | "durable";
141
- reconciledAt: string;
142
- settlement?: "original_git_state_restored";
143
- readReceipt?: (receiptPath: string) => Promise<string | null>;
144
- }): Promise<{
145
- path: string;
146
- content: string;
147
- fingerprints: string[];
148
- modern: boolean;
137
+ declare function prepareReceiptSettlement(params:{
138
+ receiptPath:string;
139
+ receiptId:string;
140
+ evidenceSource:"clone_local" | "durable";
141
+ reconciledAt:string;
142
+ settlement?:"original_git_state_restored";
143
+ readReceipt?:(receiptPath:string) => Promise<string | null>;
144
+ }):Promise<{
145
+ path:string;
146
+ content:string;
147
+ fingerprints:string[];
148
+ modern:boolean;
149
149
  } | null>;
150
150
  /** Convert a raw receipt into privacy-safe history context. */
151
- export declare function summarizeMergeReceipt(receipt: MergeDecisionReceipt): MergeDecisionReceiptSummary;
151
+ export declare function summarizeMergeReceipt(receipt:MergeDecisionReceipt):MergeDecisionReceiptSummary;
152
152
  /** Persist one item-driver outcome in the clone-local Git directory. */
153
- export declare function writeMergeReceipt(params: {
154
- cwd: string;
155
- itemPath: string;
156
- preferred: MergePreferredSide;
157
- conflictResolution?: ItemScalarConflictResolution;
158
- fieldsFromTheirs: string[];
159
- unionFields: string[];
160
- mergedFieldHashes?: Record<string, string>;
161
- decisions: ItemMergeConflictDecision[];
162
- operation?: MergeReceiptOperation;
163
- }): Promise<MergeDecisionReceipt | null>;
153
+ export declare function writeMergeReceipt(params:{
154
+ cwd:string;
155
+ itemPath:string;
156
+ preferred:MergePreferredSide;
157
+ conflictResolution?:ItemScalarConflictResolution;
158
+ fieldsFromTheirs:string[];
159
+ unionFields:string[];
160
+ mergedFieldHashes?:Record<string,string>;
161
+ decisions:ItemMergeConflictDecision[];
162
+ operation?:MergeReceiptOperation;
163
+ }):Promise<MergeDecisionReceipt | null>;
164
164
  /** Distinguish a missing optional receipt store from an unreadable one. */
165
- declare function receiptDirectoryFailureMeansAbsent(directory: string, error: unknown, inspectAncestor?: (ancestor: string) => Promise<Pick<Stats, "isDirectory">>): Promise<boolean>;
165
+ declare function receiptDirectoryFailureMeansAbsent(directory:string,error:unknown,inspectAncestor?:(ancestor:string) => Promise<Pick<Stats,"isDirectory">>):Promise<boolean>;
166
166
  /** Inspect valid receipts and count invalid evidence without returning untrusted file contents. */
167
- export declare function inspectMergeReceiptEvidence(cwd: string, options?: {
167
+ export declare function inspectMergeReceiptEvidence(cwd:string,options?:{
168
168
  /** Include receipts whose reconciliation state is already settled. */
169
- includeReconciled?: boolean;
169
+ includeReconciled?:boolean;
170
170
  /** Include receipts that contain no discarded scalar values. */
171
- includeLossless?: boolean;
171
+ includeLossless?:boolean;
172
172
  /** Explicit tracker root used to locate durable receipt evidence. */
173
- pmRoot?: string;
174
- }): Promise<MergeReceiptEvidenceScan>;
173
+ pmRoot?:string;
174
+ }):Promise<MergeReceiptEvidenceScan>;
175
175
  /** Read clone-local receipts with explicit reconciled/lossless classification controls. */
176
- export declare function listMergeReceipts(cwd: string, options?: {
177
- includeReconciled?: boolean;
178
- includeLossless?: boolean;
179
- pmRoot?: string;
180
- }): Promise<MergeDecisionReceipt[]>;
176
+ export declare function listMergeReceipts(cwd:string,options?:{
177
+ includeReconciled?:boolean;
178
+ includeLossless?:boolean;
179
+ pmRoot?:string;
180
+ }):Promise<MergeDecisionReceipt[]>;
181
181
  /** Split merge provenance into receipts with discarded values and receipts whose composition was lossless. */
182
- export declare function partitionMergeReceipts(receipts: MergeDecisionReceipt[]): {
182
+ export declare function partitionMergeReceipts(receipts:MergeDecisionReceipt[]):{
183
183
  /** Receipts that require an explicit decision because at least one competing scalar value was discarded. */
184
- pendingDecisions: MergeDecisionReceipt[];
184
+ pendingDecisions:MergeDecisionReceipt[];
185
185
  /** Receipts that record provenance without a discarded competing scalar value. */
186
- lossless: MergeDecisionReceipt[];
186
+ lossless:MergeDecisionReceipt[];
187
187
  };
188
188
  /** Mark a receipt as represented by a committed merge history event. */
189
- export declare function markMergeReceiptReconciled(cwd: string, receipt: MergeDecisionReceipt, options?: {
190
- requireExisting?: boolean;
191
- settlement?: "original_git_state_restored";
192
- }): Promise<void>;
189
+ export declare function markMergeReceiptReconciled(cwd:string,receipt:MergeDecisionReceipt,options?:{
190
+ requireExisting?:boolean;
191
+ settlement?:"original_git_state_restored";
192
+ }):Promise<void>;
193
193
  /** Report pending or historical clone-local merge decisions. */
194
- export declare function runMergeReceiptReport(options: {
194
+ export declare function runMergeReceiptReport(options:{
195
195
  /** Include receipts already represented by merge history events. */
196
- includeReconciled?: boolean;
196
+ includeReconciled?:boolean;
197
197
  /** Repository directory to inspect; defaults to the process working directory. */
198
- cwd?: string;
199
- }): Promise<MergeReceiptReport>;
198
+ cwd?:string;
199
+ }):Promise<MergeReceiptReport>;
200
200
  /** Inspect every receipt candidate and retain completeness diagnostics without exposing rejected file contents. */
201
- export declare function runMergeReceiptEvidenceReport(options: {
201
+ export declare function runMergeReceiptEvidenceReport(options:{
202
202
  /** Include receipts already represented by merge history events. */
203
- includeReconciled?: boolean;
203
+ includeReconciled?:boolean;
204
204
  /** Repository directory to inspect; defaults to the process working directory. */
205
- cwd?: string;
206
- }): Promise<MergeReceiptEvidenceReport>;
205
+ cwd?:string;
206
+ }):Promise<MergeReceiptEvidenceReport>;
207
207
  /** Test-only seams for deterministic receipt-boundary fault coverage. */
208
- export declare const _testOnlyMergeReceipts: {
209
- prepareReceiptSettlement: typeof prepareReceiptSettlement;
210
- receiptDirectoryFailureMeansAbsent: typeof receiptDirectoryFailureMeansAbsent;
208
+ export declare const _testOnlyMergeReceipts:{
209
+ prepareReceiptSettlement:typeof prepareReceiptSettlement;
210
+ receiptDirectoryFailureMeansAbsent:typeof receiptDirectoryFailureMeansAbsent;
211
211
  };
@@ -5,13 +5,13 @@ import { type MergeDecisionReceiptSummary } from "./receipts.js";
5
5
  /** Options for the audited post-merge reconciliation workflow. */
6
6
  export interface MergeReconcileOptions {
7
7
  /** Preview drifted streams without mutating history. */
8
- dryRun?: boolean;
8
+ dryRun?:boolean;
9
9
  /** Attribution recorded on repair audit entries. */
10
- author?: string;
10
+ author?:string;
11
11
  /** Human-readable reason recorded on repair audit entries. */
12
- message?: string;
12
+ message?:string;
13
13
  /** Permit ownership overrides already supported by history repair. */
14
- force?: boolean;
14
+ force?:boolean;
15
15
  }
16
16
  /** Structured post-merge reconciliation and verification result. */
17
17
  export interface MergeReconcileResult {
@@ -20,33 +20,33 @@ export interface MergeReconcileResult {
20
20
  * merge-critical validation. Dry-run previews therefore fail closed while
21
21
  * drift or pending merge decisions still require an apply pass.
22
22
  */
23
- ok: boolean;
23
+ ok:boolean;
24
24
  /** Whether this invocation only previewed repairs. */
25
- dry_run: boolean;
25
+ dry_run:boolean;
26
26
  /** Bulk history repair preview or apply result. */
27
- repair: HistoryRepairAllResult;
27
+ repair:HistoryRepairAllResult;
28
28
  /** Clone-local merge receipts represented by merge history events. */
29
- receipts: {
30
- pending_before: number;
31
- reconciled: number;
29
+ receipts:{
30
+ pending_before:number;
31
+ reconciled:number;
32
32
  /** Receipts proven to restore their original Git state; these do not represent applied merges. */
33
- abandoned: number;
34
- summaries: MergeDecisionReceiptSummary[];
33
+ abandoned:number;
34
+ summaries:MergeDecisionReceiptSummary[];
35
35
  /** Missing durable references discovered before this reconciliation. */
36
- missing_history_references_before: number;
36
+ missing_history_references_before:number;
37
37
  /** Pre-durable references eligible for explicit audited disposition. */
38
- legacy_disposition_eligible: number;
38
+ legacy_disposition_eligible:number;
39
39
  /** Eligible references dispositioned by this apply pass. */
40
- legacy_disposition_recorded: number;
40
+ legacy_disposition_recorded:number;
41
41
  /** Missing durable references still blocking health after this pass. */
42
- missing_history_references_after: number;
42
+ missing_history_references_after:number;
43
43
  };
44
44
  /** Post-operation history-drift and storage-integrity validation. */
45
- validation: ValidateResult;
45
+ validation:ValidateResult;
46
46
  /** Stable next-step guidance for Git hooks and interactive agents. */
47
- guidance: string[];
47
+ guidance:string[];
48
48
  /** ISO timestamp copied from the validation pass. */
49
- generated_at: string;
49
+ generated_at:string;
50
50
  }
51
51
  /**
52
52
  * Preview or apply post-merge history reconciliation and immediately validate
@@ -54,4 +54,4 @@ generated_at: string;
54
54
  * callers opt into this command after Git finishes; installing merge drivers
55
55
  * does not silently install or mutate repository hooks.
56
56
  */
57
- export declare function runMergeReconcile(options: MergeReconcileOptions, global: GlobalOptions): Promise<MergeReconcileResult>;
57
+ export declare function runMergeReconcile(options:MergeReconcileOptions,global:GlobalOptions):Promise<MergeReconcileResult>;
@@ -6,33 +6,33 @@ export type ItemScalarConflictResolution = "preferred_side" | "stable_value_orde
6
6
  /** Explains the exact evidence used to select one conflicting item scalar. */
7
7
  export type ItemScalarResolutionBasis = "requested_preference" | "document_updated_at" | "stable_value_tiebreak";
8
8
  /** JSON-stable marker used when a conflict decision refers to an absent scalar. */
9
- export declare const ITEM_SCALAR_MISSING_VALUE: Readonly<{
10
- readonly pm_item_scalar_missing: true;
9
+ export declare const ITEM_SCALAR_MISSING_VALUE:Readonly<{
10
+ readonly pm_item_scalar_missing:true;
11
11
  }>;
12
12
  /** Return whether receipt evidence represents an absent item scalar. */
13
- export declare function isItemScalarMissingValue(value: unknown): value is typeof ITEM_SCALAR_MISSING_VALUE;
13
+ export declare function isItemScalarMissingValue(value:unknown):value is typeof ITEM_SCALAR_MISSING_VALUE;
14
14
  /** Encode an absent scalar so every decision property survives JSON serialization. */
15
- export declare function encodeItemScalarDecisionValue(value: unknown): unknown;
15
+ export declare function encodeItemScalarDecisionValue(value:unknown):unknown;
16
16
  /** Hash scalars in disjoint present/missing domains for collision-free evidence. */
17
- export declare function hashItemScalarDecisionValue(value: unknown): string;
17
+ export declare function hashItemScalarDecisionValue(value:unknown):string;
18
18
  /** Restricts the strategy labels reported by the history stream merge. */
19
19
  export type HistoryMergeStrategy = "identical" | "fast_forward_ours" | "fast_forward_theirs" | "union_reanchor";
20
20
  /** Documents the history stream merge result payload exchanged by command, SDK, and package integrations. */
21
21
  export interface HistoryMergeResult {
22
22
  /** Merged JSONL content ready to be written as the resolved history stream. */
23
- merged: string;
23
+ merged:string;
24
24
  /** Strategy the merge used: identical inputs, one-sided fast-forward, or a deterministic union with a re-anchored hash chain. */
25
- strategy: HistoryMergeStrategy;
25
+ strategy:HistoryMergeStrategy;
26
26
  /** Number of entries shared by both sides before their streams diverged. */
27
- common_entries: number;
27
+ common_entries:number;
28
28
  /** Number of divergent entries contributed by the ours side. */
29
- entries_from_ours: number;
29
+ entries_from_ours:number;
30
30
  /** Number of divergent entries contributed by the theirs side. */
31
- entries_from_theirs: number;
31
+ entries_from_theirs:number;
32
32
  /** Total entries in the merged stream. */
33
- entries_total: number;
33
+ entries_total:number;
34
34
  /** Whether the merged chain required hash re-anchoring (true for every union merge). */
35
- reanchored: boolean;
35
+ reanchored:boolean;
36
36
  }
37
37
  /**
38
38
  * Deterministically merge two diverged versions of one append-only history
@@ -47,23 +47,23 @@ reanchored: boolean;
47
47
  * deterministic ordering, the merge fails closed instead of publishing a
48
48
  * hash-valid stream that omitted a branch effect.
49
49
  */
50
- export declare function mergeHistoryStreams(baseRaw: string, oursRaw: string, theirsRaw: string): HistoryMergeResult;
50
+ export declare function mergeHistoryStreams(baseRaw:string,oursRaw:string,theirsRaw:string):HistoryMergeResult;
51
51
  /** Documents the relationship event stream merge result payload exchanged by command, SDK, and package integrations. */
52
52
  export interface RelationshipStreamMergeResult {
53
53
  /** Merged JSONL content with consecutively renumbered `sequence` values, ready to be written as the resolved event store. */
54
- merged: string;
54
+ merged:string;
55
55
  /** Strategy the merge used: identical inputs, one-sided fast-forward, or a deterministic union with renumbered sequences. */
56
- strategy: HistoryMergeStrategy;
56
+ strategy:HistoryMergeStrategy;
57
57
  /** Number of events shared by both sides before their streams diverged. */
58
- common_entries: number;
58
+ common_entries:number;
59
59
  /** Number of divergent events contributed by the ours side. */
60
- entries_from_ours: number;
60
+ entries_from_ours:number;
61
61
  /** Number of divergent events contributed by the theirs side. */
62
- entries_from_theirs: number;
62
+ entries_from_theirs:number;
63
63
  /** Total events in the merged stream. */
64
- entries_total: number;
64
+ entries_total:number;
65
65
  /** Whether merged events required sequence renumbering (true for every union merge). */
66
- reanchored: boolean;
66
+ reanchored:boolean;
67
67
  }
68
68
  /**
69
69
  * Deterministically merge two diverged versions of one append-only
@@ -74,7 +74,7 @@ reanchored: boolean;
74
74
  * ours-first on ties), and renumbers every merged sequence consecutively so
75
75
  * the resulting stream loads again. No side's events are ever discarded.
76
76
  */
77
- export declare function mergeRelationshipEventStreams(baseRaw: string, oursRaw: string, theirsRaw: string): RelationshipStreamMergeResult;
77
+ export declare function mergeRelationshipEventStreams(baseRaw:string,oursRaw:string,theirsRaw:string):RelationshipStreamMergeResult;
78
78
  /**
79
79
  * Item metadata collections merged by element-identity set semantics instead
80
80
  * of whole-field three-way comparison: concurrent commutative appends from two
@@ -85,46 +85,46 @@ export declare function mergeRelationshipEventStreams(baseRaw: string, oursRaw:
85
85
  * steps carry cross-element ordering invariants that set-union would corrupt,
86
86
  * so they stay under scalar three-way semantics with explicit conflicts.
87
87
  */
88
- export declare const ITEM_UNION_COLLECTION_FIELDS: readonly ["tags", "dependencies", "comments", "notes", "learnings", "files", "tests", "test_runs", "docs", "reminders", "events"];
88
+ export declare const ITEM_UNION_COLLECTION_FIELDS:readonly ["tags","dependencies","comments","notes","learnings","files","tests","test_runs","docs","reminders","events"];
89
89
  /** Item metadata fields resolved by deterministic latest-timestamp-wins instead of three-way conflict, so disjoint-field edits never conflict on the shared freshness scalar every mutation rewrites. */
90
- export declare const ITEM_LATEST_TIMESTAMP_FIELDS: readonly ["updated_at"];
90
+ export declare const ITEM_LATEST_TIMESTAMP_FIELDS:readonly ["updated_at"];
91
91
  /** Documents one recoverable scalar decision made during an item merge. */
92
92
  export interface ItemMergeConflictDecision {
93
93
  /** Metadata field name, or `body`. */
94
- field: string;
94
+ field:string;
95
95
  /** Common-ancestor value. */
96
- base: unknown;
96
+ base:unknown;
97
97
  /** Current-branch value. */
98
- ours: unknown;
98
+ ours:unknown;
99
99
  /** Other-branch value. */
100
- theirs: unknown;
100
+ theirs:unknown;
101
101
  /** Value retained in the merged item. */
102
- retained: unknown;
102
+ retained:unknown;
103
103
  /** Value not retained in the merged item. */
104
- discarded: unknown;
104
+ discarded:unknown;
105
105
  /** Branch coordinate whose value was retained. */
106
- retained_side?: MergePreferredSide;
106
+ retained_side?:MergePreferredSide;
107
107
  /** Evidence class that selected the retained value. */
108
- resolution_basis?: ItemScalarResolutionBasis;
108
+ resolution_basis?:ItemScalarResolutionBasis;
109
109
  }
110
110
  /** Documents the item document merge result payload exchanged by command, SDK, and package integrations. */
111
111
  export interface ItemDocumentMergeResult {
112
112
  /** Serialized merged item document (always parseable; count headers recomputed by canonical serialization). */
113
- merged: string;
113
+ merged:string;
114
114
  /** Metadata fields (plus `body`) where both sides changed to different values; resolved toward the preferred side. */
115
- conflict_fields: string[];
115
+ conflict_fields:string[];
116
116
  /** Fields taken from the theirs side by clean three-way resolution. */
117
- fields_from_theirs: string[];
117
+ fields_from_theirs:string[];
118
118
  /** Collection fields that merged by element-identity union. */
119
- union_fields: string[];
119
+ union_fields:string[];
120
120
  /** Scalar conflict decisions; callers choose a privacy-appropriate persistence boundary. */
121
- conflict_decisions: ItemMergeConflictDecision[];
121
+ conflict_decisions:ItemMergeConflictDecision[];
122
122
  /** Side requested by the caller; stable-value decisions can retain either side. */
123
- requested_preference: MergePreferredSide;
123
+ requested_preference:MergePreferredSide;
124
124
  /** Whether the requested side participates in item scalar selection under the declared policy. */
125
- requested_preference_applied: boolean;
125
+ requested_preference_applied:boolean;
126
126
  /** Scalar-conflict selection contract used for this merge. */
127
- conflict_resolution: ItemScalarConflictResolution;
127
+ conflict_resolution:ItemScalarConflictResolution;
128
128
  }
129
129
  /**
130
130
  * Field-aware three-way merge of one tracker item document. Commutative
@@ -138,22 +138,22 @@ conflict_resolution: ItemScalarConflictResolution;
138
138
  * recomputed, so the hand-resolution corruption class (stale `notes[N]`
139
139
  * headers) cannot be produced by this merge.
140
140
  */
141
- export declare function mergeItemDocuments(baseRaw: string, oursRaw: string, theirsRaw: string, options?: ItemDocumentFormatOptions & {
141
+ export declare function mergeItemDocuments(baseRaw:string,oursRaw:string,theirsRaw:string,options?:ItemDocumentFormatOptions & {
142
142
  /** Side that wins unresolvable conflicts (default "ours"). */
143
- preferred?: MergePreferredSide;
143
+ preferred?:MergePreferredSide;
144
144
  /** Direction-independent scalar selection used by the Git driver. */
145
- conflictResolution?: ItemScalarConflictResolution;
146
- }): ItemDocumentMergeResult;
145
+ conflictResolution?:ItemScalarConflictResolution;
146
+ }):ItemDocumentMergeResult;
147
147
  /** Documents the JSON document merge result payload exchanged by command, SDK, and package integrations. */
148
148
  export interface JsonDocumentMergeResult {
149
149
  /** Serialized merged JSON document (two-space indent, trailing newline — the tracker's canonical config style). */
150
- merged: string;
150
+ merged:string;
151
151
  /** Dotted key paths where both sides changed to different values; resolved toward the preferred side. */
152
- conflict_paths: string[];
152
+ conflict_paths:string[];
153
153
  /** Dotted key paths taken from the theirs side by clean three-way resolution. */
154
- paths_from_theirs: string[];
154
+ paths_from_theirs:string[];
155
155
  /** Which side unresolvable conflicts were resolved toward. */
156
- preferred: MergePreferredSide;
156
+ preferred:MergePreferredSide;
157
157
  }
158
158
  /**
159
159
  * Key-level three-way merge for the tracker's JSON configuration artifacts.
@@ -163,7 +163,7 @@ preferred: MergePreferredSide;
163
163
  * always valid JSON, so merged configuration cannot regress into the
164
164
  * silent-defaults fallback that raw conflict markers cause.
165
165
  */
166
- export declare function mergeJsonDocuments(baseRaw: string, oursRaw: string, theirsRaw: string, options?: {
166
+ export declare function mergeJsonDocuments(baseRaw:string,oursRaw:string,theirsRaw:string,options?:{
167
167
  /** Side that wins unresolvable conflicts (default "ours"). */
168
- preferred?: MergePreferredSide;
169
- }): JsonDocumentMergeResult;
168
+ preferred?:MergePreferredSide;
169
+ }):JsonDocumentMergeResult;