@holmes-lab/holmes-kit 0.38.0 → 0.40.0

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 (308) hide show
  1. package/CHANGELOG.md +370 -6
  2. package/README.md +58 -40
  3. package/dist/.build-id +1 -1
  4. package/dist/holmes/admission/core/admission-policy.d.ts +37 -0
  5. package/dist/holmes/admission/core/admission-policy.js +147 -0
  6. package/dist/holmes/admission/core/bounded-reader.d.ts +56 -0
  7. package/dist/holmes/admission/core/bounded-reader.js +135 -0
  8. package/dist/holmes/admission/core/change-classifier.d.ts +34 -0
  9. package/dist/holmes/admission/core/change-classifier.js +278 -0
  10. package/dist/holmes/admission/core/config-loader.d.ts +30 -0
  11. package/dist/holmes/admission/core/config-loader.js +145 -0
  12. package/dist/holmes/admission/core/event-judgement.d.ts +37 -0
  13. package/dist/holmes/admission/core/event-judgement.js +251 -0
  14. package/dist/holmes/admission/core/path-rules.d.ts +35 -0
  15. package/dist/holmes/admission/core/path-rules.js +88 -0
  16. package/dist/holmes/admission/core/pin.d.ts +7 -0
  17. package/dist/holmes/admission/core/pin.js +29 -0
  18. package/dist/holmes/admission/core/ports.d.ts +48 -0
  19. package/dist/holmes/admission/core/ports.js +11 -0
  20. package/dist/holmes/admission/core/range-resolver.d.ts +32 -0
  21. package/dist/holmes/admission/core/range-resolver.js +51 -0
  22. package/dist/holmes/admission/core/self-containment.d.ts +1 -0
  23. package/dist/holmes/admission/core/self-containment.js +125 -0
  24. package/dist/holmes/admission/core/signature-source.d.ts +9 -0
  25. package/dist/holmes/admission/core/signature-source.js +4 -0
  26. package/dist/holmes/admission/core/transition-planner.d.ts +15 -0
  27. package/dist/holmes/admission/core/transition-planner.js +14 -0
  28. package/dist/holmes/admission/core/verdict.d.ts +38 -0
  29. package/dist/holmes/admission/core/verdict.js +17 -0
  30. package/dist/holmes/admission/core/wiring.d.ts +44 -0
  31. package/dist/holmes/admission/core/wiring.js +618 -0
  32. package/dist/holmes/admission/forge/git-object-port.d.ts +4 -0
  33. package/dist/holmes/admission/forge/git-object-port.js +132 -0
  34. package/dist/holmes/assoc/assoc-arm.d.ts +1 -1
  35. package/dist/holmes/assoc/assoc-arm.js +1 -1
  36. package/dist/holmes/cli/agents.d.ts +8 -0
  37. package/dist/holmes/cli/agents.js +9 -5
  38. package/dist/holmes/cli/approve-cli.d.ts +2 -0
  39. package/dist/holmes/cli/approve-cli.js +392 -0
  40. package/dist/holmes/cli/approve-ref.d.ts +13 -7
  41. package/dist/holmes/cli/approve-ref.js +30 -10
  42. package/dist/holmes/cli/approve-status.d.ts +26 -2
  43. package/dist/holmes/cli/approve-status.js +98 -18
  44. package/dist/holmes/cli/approve-watch.d.ts +5 -0
  45. package/dist/holmes/cli/approve-watch.js +10 -5
  46. package/dist/holmes/cli/approve.d.ts +50 -13
  47. package/dist/holmes/cli/approve.js +260 -67
  48. package/dist/holmes/cli/attest.js +2 -1
  49. package/dist/holmes/cli/autonomy.d.ts +4 -1
  50. package/dist/holmes/cli/autonomy.js +17 -10
  51. package/dist/holmes/cli/codex-oracle.d.ts +11 -0
  52. package/dist/holmes/cli/codex-oracle.js +5 -1
  53. package/dist/holmes/cli/codex-toml.d.ts +10 -0
  54. package/dist/holmes/cli/codex-toml.js +36 -2
  55. package/dist/holmes/cli/doctor-boundary.d.ts +76 -0
  56. package/dist/holmes/cli/doctor-boundary.js +308 -0
  57. package/dist/holmes/cli/doctor-locks.d.ts +15 -0
  58. package/dist/holmes/cli/doctor-locks.js +119 -0
  59. package/dist/holmes/cli/doctor.d.ts +2 -0
  60. package/dist/holmes/cli/doctor.js +45 -5
  61. package/dist/holmes/cli/flags.d.ts +23 -0
  62. package/dist/holmes/cli/flags.js +89 -0
  63. package/dist/holmes/cli/index.d.ts +5 -1
  64. package/dist/holmes/cli/index.js +206 -424
  65. package/dist/holmes/cli/init.js +33 -0
  66. package/dist/holmes/cli/lock-recover.d.ts +5 -0
  67. package/dist/holmes/cli/lock-recover.js +126 -0
  68. package/dist/holmes/cli/mcp-processes.d.ts +32 -0
  69. package/dist/holmes/cli/mcp-processes.js +132 -0
  70. package/dist/holmes/cli/release-docs.js +1 -1
  71. package/dist/holmes/cli/run-exec.d.ts +141 -0
  72. package/dist/holmes/cli/run-exec.js +1435 -0
  73. package/dist/holmes/cli/run-provision.d.ts +8 -0
  74. package/dist/holmes/cli/run-provision.js +325 -0
  75. package/dist/holmes/cli/run-wiring.d.ts +69 -0
  76. package/dist/holmes/cli/run-wiring.js +270 -0
  77. package/dist/holmes/cli/run.d.ts +26 -0
  78. package/dist/holmes/cli/run.js +364 -83
  79. package/dist/holmes/cli/runtime-binding-approval.js +32 -19
  80. package/dist/holmes/cli/screen-safe.d.ts +3 -92
  81. package/dist/holmes/cli/screen-safe.js +18 -756
  82. package/dist/holmes/config/config.d.ts +2 -0
  83. package/dist/holmes/config/config.js +5 -2
  84. package/dist/holmes/cpg/foundation/language-matrix.js +2 -2
  85. package/dist/holmes/cpg/import-resolver.js +1 -1
  86. package/dist/holmes/governance/approval-decisions.d.ts +47 -0
  87. package/dist/holmes/governance/approval-decisions.js +29 -0
  88. package/dist/holmes/governance/approval-grants.d.ts +220 -1
  89. package/dist/holmes/governance/approval-grants.js +612 -33
  90. package/dist/holmes/governance/approval-queue.d.ts +31 -0
  91. package/dist/holmes/governance/approval-queue.js +122 -11
  92. package/dist/holmes/governance/approval-spend.d.ts +95 -0
  93. package/dist/holmes/governance/approval-spend.js +191 -0
  94. package/dist/holmes/governance/autonomous-shell.d.ts +61 -0
  95. package/dist/holmes/governance/autonomous-shell.js +332 -0
  96. package/dist/holmes/governance/autonomy.d.ts +5 -0
  97. package/dist/holmes/governance/autonomy.js +16 -11
  98. package/dist/holmes/governance/constitution.d.ts +5 -0
  99. package/dist/holmes/governance/constitution.js +32 -12
  100. package/dist/holmes/governance/full-autonomy.d.ts +10 -0
  101. package/dist/holmes/governance/full-autonomy.js +103 -7
  102. package/dist/holmes/governance/harness-catalog.d.ts +103 -0
  103. package/dist/holmes/governance/harness-catalog.js +348 -0
  104. package/dist/holmes/governance/human-channel.d.ts +38 -0
  105. package/dist/holmes/governance/human-channel.js +49 -0
  106. package/dist/holmes/governance/install-manifest.d.ts +22 -0
  107. package/dist/holmes/governance/install-manifest.js +160 -0
  108. package/dist/holmes/governance/ledger-rechain.js +2 -0
  109. package/dist/holmes/governance/ledger-store.conformance.d.ts +7 -1
  110. package/dist/holmes/governance/ledger-store.conformance.js +66 -0
  111. package/dist/holmes/governance/ledger-store.d.ts +88 -11
  112. package/dist/holmes/governance/ledger-store.js +186 -8
  113. package/dist/holmes/governance/provenance-chain.d.ts +16 -4
  114. package/dist/holmes/governance/provenance-chain.js +19 -4
  115. package/dist/holmes/governance/provenance-ledger.d.ts +6 -3
  116. package/dist/holmes/governance/provenance-ledger.js +53 -18
  117. package/dist/holmes/governance/push-gate-runner.js +11 -7
  118. package/dist/holmes/governance/recorded-pairs.d.ts +96 -0
  119. package/dist/holmes/governance/recorded-pairs.js +522 -0
  120. package/dist/holmes/governance/replica-id.d.ts +1 -1
  121. package/dist/holmes/governance/replica-id.js +1 -1
  122. package/dist/holmes/governance/spec-seam.d.ts +59 -0
  123. package/dist/holmes/governance/spec-seam.js +587 -0
  124. package/dist/holmes/governance/spend-kinds.d.ts +16 -0
  125. package/dist/holmes/governance/spend-kinds.js +18 -0
  126. package/dist/holmes/governance/tool-actions.js +2 -0
  127. package/dist/holmes/guardrail/decision-ledger.d.ts +2 -1
  128. package/dist/holmes/guardrail/decision-ledger.js +2 -1
  129. package/dist/holmes/guardrail/impact-gate.d.ts +1 -0
  130. package/dist/holmes/guardrail/impact-gate.js +1 -1
  131. package/dist/holmes/guardrail/line-continuation.d.ts +8 -0
  132. package/dist/holmes/guardrail/line-continuation.js +39 -0
  133. package/dist/holmes/guardrail/operator-person.d.ts +28 -4
  134. package/dist/holmes/guardrail/operator-person.js +57 -11
  135. package/dist/holmes/guardrail/refusal-codes.d.ts +8 -3
  136. package/dist/holmes/guardrail/refusal-codes.js +70 -10
  137. package/dist/holmes/guardrail/risk-classifier.d.ts +15 -9
  138. package/dist/holmes/guardrail/risk-classifier.js +245 -15
  139. package/dist/holmes/guardrail/risk-gate.d.ts +2 -8
  140. package/dist/holmes/guardrail/risk-gate.js +7 -34
  141. package/dist/holmes/guardrail/risk-types.d.ts +10 -0
  142. package/dist/holmes/guardrail/run-plan-scope.js +3 -1
  143. package/dist/holmes/guardrail/run-refusals.d.ts +6 -1
  144. package/dist/holmes/guardrail/run-refusals.js +36 -14
  145. package/dist/holmes/guardrail/run-stages.d.ts +10 -0
  146. package/dist/holmes/guardrail/run-stages.js +46 -6
  147. package/dist/holmes/guardrail/scope-judgment.js +1 -1
  148. package/dist/holmes/guardrail/shell-words.js +24 -3
  149. package/dist/holmes/guardrail/unresolved-write.d.ts +40 -0
  150. package/dist/holmes/guardrail/unresolved-write.js +556 -0
  151. package/dist/holmes/guardrail/write-target.d.ts +3 -0
  152. package/dist/holmes/guardrail/write-target.js +26 -5
  153. package/dist/holmes/hooks/pre-tool-use.d.ts +105 -1
  154. package/dist/holmes/hooks/pre-tool-use.js +1167 -168
  155. package/dist/holmes/hooks/rtm-refresh-child.d.ts +1 -1
  156. package/dist/holmes/hooks/rtm-refresh-child.js +1 -1
  157. package/dist/holmes/hooks/session-start.d.ts +5 -0
  158. package/dist/holmes/hooks/session-start.js +29 -1
  159. package/dist/holmes/hooks/stop.d.ts +23 -0
  160. package/dist/holmes/hooks/stop.js +88 -33
  161. package/dist/holmes/mcp/approval-adapters.js +3 -1
  162. package/dist/holmes/mcp/approval-commit.js +3 -2
  163. package/dist/holmes/mcp/approval-policy.d.ts +2 -1
  164. package/dist/holmes/mcp/approval-policy.js +3 -1
  165. package/dist/holmes/mcp/handlers/adoption.d.ts +1 -1
  166. package/dist/holmes/mcp/handlers/approval-ask.d.ts +14 -0
  167. package/dist/holmes/mcp/handlers/approval-ask.js +31 -6
  168. package/dist/holmes/mcp/handlers/entity-integration.d.ts +3 -3
  169. package/dist/holmes/mcp/handlers/entity-integration.js +29 -11
  170. package/dist/holmes/mcp/handlers/entity-renumber.d.ts +4 -4
  171. package/dist/holmes/mcp/handlers/entity-renumber.js +29 -11
  172. package/dist/holmes/mcp/handlers/entity-store.d.ts +2 -2
  173. package/dist/holmes/mcp/handlers/entity-store.js +133 -59
  174. package/dist/holmes/mcp/handlers/operator-inspection.d.ts +9 -5
  175. package/dist/holmes/mcp/handlers/operator-inspection.js +79 -16
  176. package/dist/holmes/mcp/handlers/phase-queries.d.ts +1 -1
  177. package/dist/holmes/mcp/handlers/requirement-triage.d.ts +4 -4
  178. package/dist/holmes/mcp/handlers/review-evidence.d.ts +2 -2
  179. package/dist/holmes/mcp/handlers/review-evidence.js +35 -11
  180. package/dist/holmes/mcp/handlers/review-queries.d.ts +5 -0
  181. package/dist/holmes/mcp/handlers/review-queries.js +8 -1
  182. package/dist/holmes/mcp/handlers/review-verdict.d.ts +3 -0
  183. package/dist/holmes/mcp/handlers/review-verdict.js +10 -3
  184. package/dist/holmes/mcp/handlers/risk-assessment.d.ts +7 -2
  185. package/dist/holmes/mcp/handlers/risk-assessment.js +34 -12
  186. package/dist/holmes/mcp/handlers/runtime-binding-tool.d.ts +2 -2
  187. package/dist/holmes/mcp/handlers/slice-orchestration.d.ts +6 -1
  188. package/dist/holmes/mcp/handlers/slice-orchestration.js +14 -1
  189. package/dist/holmes/mcp/handlers/spec-approval.d.ts +15 -3
  190. package/dist/holmes/mcp/handlers/spec-approval.js +32 -5
  191. package/dist/holmes/mcp/handlers/spec-authoring.d.ts +2 -2
  192. package/dist/holmes/mcp/handlers/spec-authoring.js +19 -2
  193. package/dist/holmes/mcp/handlers/spec-lifecycle.d.ts +11 -38
  194. package/dist/holmes/mcp/handlers/spec-lifecycle.js +441 -94
  195. package/dist/holmes/mcp/handlers/spec-queries.d.ts +2 -2
  196. package/dist/holmes/mcp/handlers/taint-screening.d.ts +1 -1
  197. package/dist/holmes/mcp/handlers/taint-screening.js +2 -2
  198. package/dist/holmes/mcp/handlers/test-execution.d.ts +1 -1
  199. package/dist/holmes/mcp/handlers/workspace-preflight.d.ts +5 -0
  200. package/dist/holmes/mcp/handlers/workspace-preflight.js +10 -2
  201. package/dist/holmes/mcp/handlers/workspace-queries.d.ts +2 -2
  202. package/dist/holmes/mcp/handlers.d.ts +99 -79
  203. package/dist/holmes/mcp/handlers.js +93 -25
  204. package/dist/holmes/mcp/harness-attestation.d.ts +78 -5
  205. package/dist/holmes/mcp/harness-attestation.js +325 -53
  206. package/dist/holmes/mcp/maintenance-analyze.d.ts +1 -1
  207. package/dist/holmes/mcp/maintenance-analyze.js +9 -9
  208. package/dist/holmes/mcp/maintenance-evidence.js +31 -2
  209. package/dist/holmes/mcp/requirement-triage-evidence.js +22 -13
  210. package/dist/holmes/mcp/server-staleness.d.ts +43 -0
  211. package/dist/holmes/mcp/server-staleness.js +158 -0
  212. package/dist/holmes/mcp/server.js +34 -9
  213. package/dist/holmes/mcp/spec-id-guard.js +1 -1
  214. package/dist/holmes/mcp/tool-schemas.d.ts +13 -0
  215. package/dist/holmes/mcp/tool-schemas.js +42 -2
  216. package/dist/holmes/project/act-root.d.ts +19 -0
  217. package/dist/holmes/project/act-root.js +100 -0
  218. package/dist/holmes/project/baseline.js +4 -3
  219. package/dist/holmes/project/bounded-group.d.ts +47 -0
  220. package/dist/holmes/project/bounded-group.js +140 -0
  221. package/dist/holmes/project/bounded-io.d.ts +50 -2
  222. package/dist/holmes/project/bounded-io.js +138 -6
  223. package/dist/holmes/project/change-source.js +2 -2
  224. package/dist/holmes/project/instance-id.d.ts +10 -0
  225. package/dist/holmes/project/instance-id.js +233 -0
  226. package/dist/holmes/project/machine-identity.d.ts +25 -0
  227. package/dist/holmes/project/machine-identity.js +133 -0
  228. package/dist/holmes/project/owned-lock.d.ts +84 -0
  229. package/dist/holmes/project/owned-lock.js +263 -0
  230. package/dist/holmes/project/plain-lock-fs.d.ts +2 -0
  231. package/dist/holmes/project/plain-lock-fs.js +126 -0
  232. package/dist/holmes/project/request-lock.d.ts +85 -0
  233. package/dist/holmes/project/request-lock.js +459 -0
  234. package/dist/holmes/project/root.d.ts +12 -4
  235. package/dist/holmes/project/root.js +26 -7
  236. package/dist/holmes/project/run-records.d.ts +19 -0
  237. package/dist/holmes/project/run-records.js +94 -12
  238. package/dist/holmes/project/screen-text.d.ts +94 -0
  239. package/dist/holmes/project/screen-text.js +763 -0
  240. package/dist/holmes/project/spend-lock.d.ts +82 -0
  241. package/dist/holmes/project/spend-lock.js +413 -0
  242. package/dist/holmes/project/workspace-preflight.d.ts +5 -0
  243. package/dist/holmes/project/workspace-preflight.js +24 -1
  244. package/dist/holmes/refresh/freshness-coordinator.d.ts +1 -1
  245. package/dist/holmes/refresh/freshness-coordinator.js +1 -1
  246. package/dist/holmes/review/condition-hunk-replay.js +4 -2
  247. package/dist/holmes/review/confidence-calibration.d.ts +1 -1
  248. package/dist/holmes/review/confidence-calibration.js +1 -1
  249. package/dist/holmes/review/content-verify.js +1 -1
  250. package/dist/holmes/review/hop-ablation.d.ts +4 -4
  251. package/dist/holmes/review/hop-ablation.js +5 -5
  252. package/dist/holmes/review/point-in-time-replay.js +12 -3
  253. package/dist/holmes/review/rank-diagnosis.d.ts +2 -2
  254. package/dist/holmes/review/rank-diagnosis.js +1 -1
  255. package/dist/holmes/review/replay-corpus.d.ts +10 -4
  256. package/dist/holmes/review/replay-corpus.js +25 -9
  257. package/dist/holmes/review/requirement-triage.js +2 -2
  258. package/dist/holmes/review/semantic-arm.d.ts +3 -3
  259. package/dist/holmes/review/semantic-arm.js +3 -3
  260. package/dist/holmes/review/test-outcomes.js +3 -1
  261. package/dist/holmes/review/test-runner.d.ts +11 -0
  262. package/dist/holmes/review/test-runner.js +31 -10
  263. package/dist/holmes/review/test-selection-breadth.js +2 -2
  264. package/dist/holmes/review/verdicts.d.ts +109 -7
  265. package/dist/holmes/review/verdicts.js +653 -34
  266. package/dist/holmes/rtm/anchor-census.d.ts +9 -0
  267. package/dist/holmes/rtm/anchor-census.js +151 -0
  268. package/dist/holmes/rtm/anchor-ids.d.ts +25 -1
  269. package/dist/holmes/rtm/anchor-ids.js +45 -2
  270. package/dist/holmes/rtm/comment-ranges.d.ts +2 -0
  271. package/dist/holmes/rtm/comment-ranges.js +104 -0
  272. package/dist/holmes/rtm/counted-tests.d.ts +1 -0
  273. package/dist/holmes/rtm/counted-tests.js +63 -0
  274. package/dist/holmes/rtm/impact-advisory.d.ts +1 -1
  275. package/dist/holmes/rtm/known-defects.js +1 -1
  276. package/dist/holmes/rtm/localize.js +1 -1
  277. package/dist/holmes/rtm/taint-benchmark.d.ts +1 -1
  278. package/dist/holmes/rtm/taint-vocabulary.d.ts +1 -1
  279. package/dist/holmes/rtm/test-scope.d.ts +31 -0
  280. package/dist/holmes/rtm/test-scope.js +166 -5
  281. package/dist/holmes/rtm/trace-gaps.js +1 -1
  282. package/dist/holmes/runtime/dispatch.d.ts +10 -0
  283. package/dist/holmes/runtime/dispatch.js +12 -1
  284. package/dist/holmes/semantic/cloud-usage.d.ts +1 -1
  285. package/dist/holmes/semantic/cloud-usage.js +1 -1
  286. package/dist/holmes/semantic/unreadable-paths.d.ts +1 -1
  287. package/dist/holmes/semantic/unreadable-paths.js +1 -1
  288. package/dist/holmes/spec/approval-blockers.js +1 -1
  289. package/dist/holmes/spec/entity-store.d.ts +6 -1
  290. package/dist/holmes/spec/entity-store.js +16 -2
  291. package/dist/holmes/spec/entity-transaction.d.ts +7 -2
  292. package/dist/holmes/spec/entity-transaction.js +87 -170
  293. package/dist/holmes/spec/spec-store.d.ts +12 -6
  294. package/dist/holmes/spec/spec-store.js +4 -2
  295. package/dist/holmes/spec/spec-types.js +1 -1
  296. package/dist/holmes/spec/succession-guard.d.ts +56 -0
  297. package/dist/holmes/spec/succession-guard.js +187 -0
  298. package/dist/holmes/spec/succession.d.ts +70 -0
  299. package/dist/holmes/spec/succession.js +171 -0
  300. package/dist/holmes/spec/transition-policy.d.ts +2 -2
  301. package/docs/install-guide.md +9 -3
  302. package/docs/language-support.md +78 -0
  303. package/package.json +4 -3
  304. package/playbooks/author-slice/PLAYBOOK.md +1 -1
  305. package/playbooks/promote-slice/PLAYBOOK.md +5 -1
  306. package/playbooks/publish/PLAYBOOK.md +45 -33
  307. package/dist/holmes/review/manual-baseline.d.ts +0 -209
  308. package/dist/holmes/review/manual-baseline.js +0 -2847
@@ -43,6 +43,6 @@ export declare function createTaintScreeningHandlers(context: TaintScreeningCont
43
43
  truncated: number;
44
44
  pairs: import("../../rtm/taint").TaintPair[];
45
45
  ok?: undefined;
46
- reason?: undefined;
46
+ readonly reason?: undefined;
47
47
  }>;
48
48
  };
@@ -34,7 +34,7 @@ var __importStar = (this && this.__importStar) || (function () {
34
34
  })();
35
35
  Object.defineProperty(exports, "__esModule", { value: true });
36
36
  exports.createTaintScreeningHandlers = createTaintScreeningHandlers;
37
- // @implements A-SPEC-611, A-SPEC-100.2, A-SPEC-128, A-SPEC-138, A-SPEC-140.2, A-SPEC-189, A-SPEC-461, A-SPEC-512.2, A-SPEC-513.1, A-SPEC-524.1
37
+ // @implements A-SPEC-611, A-SPEC-100.2, A-SPEC-128, A-SPEC-138, A-SPEC-140.2, A-SPEC-189, A-SPEC-461, A-SPEC-512.2, A-SPEC-513.1, A-SPEC-524.1, A-SPEC-794.56
38
38
  const fs = __importStar(require("node:fs"));
39
39
  const path = __importStar(require("node:path"));
40
40
  const rtm_graph_1 = require("../../rtm/rtm-graph");
@@ -79,7 +79,7 @@ function createTaintScreeningHandlers(context) {
79
79
  const { filterFindingsForFile } = require('../../rtm/reaching-def-filter');
80
80
  // @implements A-SPEC-513.1 — vocabulary is SELECTED per file language, never unioned:
81
81
  // Python's `input(` must not taint a TypeScript `input`, and `req.body` means nothing in
82
- // Python. Measured on jarvis: the shipped (JS) list missed `subprocess.run`, `os.environ`
82
+ // Python. Measured on the consumer corpus: the shipped (JS) list missed `subprocess.run`, `os.environ`
83
83
  // and `input(` entirely, so a Python repository could only ever report zero.
84
84
  const { vocabularyFor } = require('../../rtm/taint-vocabulary');
85
85
  const parser = new TreeSitterTsParser();
@@ -41,7 +41,7 @@ export declare function createTestExecutionHandlers(context: TestExecutionContex
41
41
  applied: boolean;
42
42
  verdict?: "killed" | "survived";
43
43
  mutation: import("../../spec/kills").Mutation;
44
- reason?: undefined;
44
+ readonly reason?: undefined;
45
45
  })[];
46
46
  survivors: import("../../spec/kills").Mutation[];
47
47
  unapplied: {
@@ -1,6 +1,11 @@
1
1
  import { Agent } from '../../cli/agents';
2
+ import type { InstallIdentity, StaleFact } from '../server-staleness';
2
3
  export declare function createWorkspacePreflightHandlers(context: {
3
4
  storeRoot?: string;
5
+ server?: () => {
6
+ loaded: InstallIdentity;
7
+ stale: StaleFact | null;
8
+ };
4
9
  }): {
5
10
  workspace_preflight(a: {
6
11
  root: string;
@@ -1,13 +1,21 @@
1
1
  "use strict";
2
2
  Object.defineProperty(exports, "__esModule", { value: true });
3
3
  exports.createWorkspacePreflightHandlers = createWorkspacePreflightHandlers;
4
- // @implements A-SPEC-703, A-SPEC-772.1
4
+ // @implements A-SPEC-703, A-SPEC-772.1, A-SPEC-251.4
5
5
  const agents_1 = require("../../cli/agents");
6
6
  const workspace_preflight_1 = require("../../project/workspace-preflight");
7
7
  function createWorkspacePreflightHandlers(context) {
8
8
  return { async workspace_preflight(a) {
9
9
  if (a?.harness !== undefined && !agents_1.AGENTS.includes(a.harness))
10
10
  throw new Error('Unsupported harness.');
11
- return (0, workspace_preflight_1.inspectWorkspacePreflight)({ requestedRoot: a?.root, storeRoot: context.storeRoot, ...(a?.harness !== undefined ? { harness: a.harness } : {}) });
11
+ let server;
12
+ try {
13
+ server = context.server?.();
14
+ }
15
+ catch {
16
+ server = undefined;
17
+ }
18
+ return (0, workspace_preflight_1.inspectWorkspacePreflight)({ requestedRoot: a?.root, storeRoot: context.storeRoot, ...(a?.harness !== undefined ? { harness: a.harness } : {}),
19
+ ...(server !== undefined ? { server } : {}) });
12
20
  } };
13
21
  }
@@ -28,12 +28,12 @@ export declare function createWorkspaceQueryHandlers(context: WorkspaceQueryCont
28
28
  gaps: import("../../rtm/gap-analyzer").ConvergenceGaps;
29
29
  breakingChangeDistribution: Record<string, number>;
30
30
  ok?: undefined;
31
- reason?: undefined;
31
+ readonly reason?: undefined;
32
32
  } | {
33
33
  issues: import("../../rtm/rtm-check").RtmIssue[];
34
34
  breakingChangeDistribution: Record<string, number>;
35
35
  ok?: undefined;
36
- reason?: undefined;
36
+ readonly reason?: undefined;
37
37
  gaps?: undefined;
38
38
  }>;
39
39
  cpg_scan(a: {
@@ -3,6 +3,7 @@ import { Spec } from '../spec/spec-parser';
3
3
  import { ScannedFile } from '../cpg/cpg-scanner';
4
4
  import { type DecisionRecord, type DecisionCitation } from '../rtm/rtm-builder';
5
5
  import { Basis } from './basis';
6
+ import { StaleFact } from './server-staleness';
6
7
  import { Approval } from '../guardrail/risk-gate';
7
8
  import { Elicitor } from './elicit-approval';
8
9
  import { ApprovalContinuationStore } from './approval-commit';
@@ -63,6 +64,10 @@ export interface ElicitOpts {
63
64
  };
64
65
  /** @implements A-SPEC-792.4 — the home whose `.holmes/full-autonomy.json` spec_approve reads (default: the user's). */
65
66
  fullAutonomyHome?: () => string;
67
+ /** @implements A-SPEC-251.4 — whether the install this process loaded has changed under it (null: unchanged or unread). */
68
+ serverStaleness?: () => StaleFact | null;
69
+ /** @implements A-SPEC-779.7 — this server's instance id (`<pid>:<startedAt>`): the requester key approval_withdraw checks. */
70
+ serverInstance?: () => string | undefined;
66
71
  }
67
72
  /**
68
73
  * @implements A-SPEC-299
@@ -72,6 +77,11 @@ export interface ElicitOpts {
72
77
  export declare function unreadableAmong(listed: ReadonlyArray<{
73
78
  id: string;
74
79
  }>, created: readonly string[]): string[];
80
+ /**
81
+ * @implements A-SPEC-792.26 — the in-process handle on the host-gated preparation, so a test can call it directly on a
82
+ * gated session (F1-e.0e f); a symbol key is skipped by every name-based listing, so the wire never sees it.
83
+ */
84
+ export declare const HOST_APPROVAL_PROBE: unique symbol;
75
85
  export declare function makeHandlers(store: SpecStore, opts?: ElicitOpts): RawHandlers & {
76
86
  basis_detail(a: {
77
87
  root?: string;
@@ -127,7 +137,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
127
137
  target?: undefined;
128
138
  executable?: undefined;
129
139
  code?: undefined;
130
- reason?: undefined;
140
+ readonly reason?: undefined;
131
141
  } | {
132
142
  ok: boolean;
133
143
  plan: import("../spec/entity-integration-transaction").EntityIntegrationRecoveryInspection;
@@ -135,7 +145,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
135
145
  executable: boolean;
136
146
  obligations?: undefined;
137
147
  code?: undefined;
138
- reason?: undefined;
148
+ readonly reason?: undefined;
139
149
  } | {
140
150
  blockers: string[];
141
151
  target?: string | undefined;
@@ -145,7 +155,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
145
155
  executable: boolean;
146
156
  obligations?: undefined;
147
157
  code?: undefined;
148
- reason?: undefined;
158
+ readonly reason?: undefined;
149
159
  } | {
150
160
  ok: boolean;
151
161
  code: string;
@@ -175,7 +185,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
175
185
  ok: boolean;
176
186
  plan: import("../spec/entity-renumber-transaction").EntityRenumberRecoveryPlan;
177
187
  code?: undefined;
178
- reason?: undefined;
188
+ readonly reason?: undefined;
179
189
  conflicts?: undefined;
180
190
  ids?: undefined;
181
191
  executable?: undefined;
@@ -200,7 +210,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
200
210
  code: string;
201
211
  conflicts: string[];
202
212
  plan?: undefined;
203
- reason?: undefined;
213
+ readonly reason?: undefined;
204
214
  ids?: undefined;
205
215
  executable?: undefined;
206
216
  blockers?: undefined;
@@ -248,7 +258,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
248
258
  };
249
259
  plan?: undefined;
250
260
  code?: undefined;
251
- reason?: undefined;
261
+ readonly reason?: undefined;
252
262
  conflicts?: undefined;
253
263
  ids?: undefined;
254
264
  recoveryAvailable?: undefined;
@@ -282,7 +292,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
282
292
  schema: string;
283
293
  };
284
294
  code?: undefined;
285
- reason?: undefined;
295
+ readonly reason?: undefined;
286
296
  conflicts?: undefined;
287
297
  ids?: undefined;
288
298
  }>;
@@ -304,7 +314,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
304
314
  ok: boolean;
305
315
  plan: import("../spec/entity-store").EntityAdoptionPlan;
306
316
  code?: undefined;
307
- reason?: undefined;
317
+ readonly reason?: undefined;
308
318
  } | {
309
319
  ok: boolean;
310
320
  plan: {
@@ -353,7 +363,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
353
363
  })[];
354
364
  };
355
365
  code?: undefined;
356
- reason?: undefined;
366
+ readonly reason?: undefined;
357
367
  } | {
358
368
  ok: boolean;
359
369
  code: string;
@@ -393,6 +403,11 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
393
403
  root?: string;
394
404
  id: string;
395
405
  }) => Promise<Record<string, unknown>>;
406
+ approval_withdraw: (a: {
407
+ root?: string;
408
+ id: string;
409
+ reason: string;
410
+ }) => Promise<Record<string, unknown>>;
396
411
  review_verdict: (a: {
397
412
  root?: string;
398
413
  base: string;
@@ -475,6 +490,11 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
475
490
  since?: string;
476
491
  budget?: number;
477
492
  }) => Promise<{
493
+ testCountDiagnostics?: {
494
+ file: string;
495
+ aspecs: string[];
496
+ reason: string;
497
+ }[] | undefined;
478
498
  scopeFallback?: "full" | undefined;
479
499
  package: import("../review/package").ReviewPackage;
480
500
  unscannedChangedFiles: string[];
@@ -504,7 +524,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
504
524
  };
505
525
  reviewNeeded: import("../review/review-targets").ReviewNeeded[];
506
526
  ok?: undefined;
507
- reason?: undefined;
527
+ readonly reason?: undefined;
508
528
  } | {
509
529
  reviewNeeded: Array<{
510
530
  spec: string;
@@ -521,9 +541,9 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
521
541
  minor: number;
522
542
  };
523
543
  ok?: undefined;
524
- reason?: undefined;
544
+ readonly reason?: undefined;
525
545
  }>;
526
- risk_check: (a: {
546
+ risk_check: (raw: {
527
547
  root?: string;
528
548
  action: import("../guardrail/risk-types").RiskAction;
529
549
  approval?: Approval;
@@ -534,7 +554,12 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
534
554
  rationale?: string;
535
555
  }) => Promise<{
536
556
  assessment: import("../guardrail/risk-types").RiskAssessment;
537
- gate: import("../guardrail/risk-gate").GateResult;
557
+ gate: {
558
+ blocked: boolean;
559
+ level: import("../guardrail/risk-types").RiskLevel;
560
+ requiresApproval: boolean;
561
+ reasons: string[];
562
+ };
538
563
  }>;
539
564
  reverse_scan: (a: {
540
565
  root: string;
@@ -604,7 +629,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
604
629
  reason: string;
605
630
  findings?: unknown[];
606
631
  }[];
607
- reason?: undefined;
632
+ readonly reason?: undefined;
608
633
  availableClusters?: undefined;
609
634
  }>;
610
635
  reverse_anchor: (a: {
@@ -643,7 +668,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
643
668
  ok: boolean;
644
669
  specsCreated: string[];
645
670
  unreadable: string[];
646
- reason?: undefined;
671
+ readonly reason?: undefined;
647
672
  existing?: undefined;
648
673
  }>;
649
674
  spec_slice_approve: (a: {
@@ -664,6 +689,11 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
664
689
  targetFile?: string;
665
690
  aspecId?: string;
666
691
  }) => Promise<{
692
+ diagnosis?: {
693
+ file: string;
694
+ aspecs: string[];
695
+ reason: string;
696
+ }[] | undefined;
667
697
  ok: boolean;
668
698
  actionsTaken: string[];
669
699
  refused: {
@@ -704,7 +734,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
704
734
  ok: boolean;
705
735
  applied: boolean;
706
736
  operation: string;
707
- reason?: undefined;
737
+ readonly reason?: undefined;
708
738
  } | {
709
739
  planDigest: string;
710
740
  conflicts: string[];
@@ -715,7 +745,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
715
745
  }[];
716
746
  ok: boolean;
717
747
  applied: boolean;
718
- reason?: undefined;
748
+ readonly reason?: undefined;
719
749
  } | {
720
750
  planDigest: string;
721
751
  conflicts: string[];
@@ -747,7 +777,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
747
777
  suppressed?: true | undefined;
748
778
  availability: string;
749
779
  missingLineages?: string[] | undefined;
750
- tier: "local" | "none" | "cloud";
780
+ tier: "none" | "local" | "cloud";
751
781
  covered: number;
752
782
  total: number;
753
783
  unlineaged: number;
@@ -772,7 +802,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
772
802
  };
773
803
  }[];
774
804
  graph: {
775
- status: "current" | "unreadable" | "empty" | "absent" | "stale" | "unverified";
805
+ status: "absent" | "current" | "empty" | "unreadable" | "stale" | "unverified";
776
806
  sourceCommit: string | null;
777
807
  graphAsOf: string | null;
778
808
  resolutionLimits: string[];
@@ -807,7 +837,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
807
837
  suppressed?: true | undefined;
808
838
  availability: string;
809
839
  missingLineages?: string[] | undefined;
810
- tier: "local" | "none" | "cloud";
840
+ tier: "none" | "local" | "cloud";
811
841
  covered: number;
812
842
  total: number;
813
843
  unlineaged: number;
@@ -832,7 +862,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
832
862
  };
833
863
  }[];
834
864
  graph: {
835
- status: "current" | "unreadable" | "empty" | "absent" | "stale" | "unverified";
865
+ status: "absent" | "current" | "empty" | "unreadable" | "stale" | "unverified";
836
866
  sourceCommit: string | null;
837
867
  graphAsOf: string | null;
838
868
  resolutionLimits: string[];
@@ -889,7 +919,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
889
919
  suppressed?: true | undefined;
890
920
  availability: string;
891
921
  missingLineages?: string[] | undefined;
892
- tier: "local" | "none" | "cloud";
922
+ tier: "none" | "local" | "cloud";
893
923
  covered: number;
894
924
  total: number;
895
925
  unlineaged: number;
@@ -914,7 +944,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
914
944
  };
915
945
  }[];
916
946
  graph: {
917
- status: "current" | "unreadable" | "empty" | "absent" | "stale" | "unverified";
947
+ status: "absent" | "current" | "empty" | "unreadable" | "stale" | "unverified";
918
948
  sourceCommit: string | null;
919
949
  graphAsOf: string | null;
920
950
  resolutionLimits: string[];
@@ -955,7 +985,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
955
985
  suppressed?: true | undefined;
956
986
  availability: string;
957
987
  missingLineages?: string[] | undefined;
958
- tier: "local" | "none" | "cloud";
988
+ tier: "none" | "local" | "cloud";
959
989
  covered: number;
960
990
  total: number;
961
991
  unlineaged: number;
@@ -980,7 +1010,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
980
1010
  };
981
1011
  }[];
982
1012
  graph: {
983
- status: "current" | "unreadable" | "empty" | "absent" | "stale" | "unverified";
1013
+ status: "absent" | "current" | "empty" | "unreadable" | "stale" | "unverified";
984
1014
  sourceCommit: string | null;
985
1015
  graphAsOf: string | null;
986
1016
  resolutionLimits: string[];
@@ -1066,7 +1096,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1066
1096
  ts: string;
1067
1097
  }[];
1068
1098
  remaining: string[];
1069
- reason?: undefined;
1099
+ readonly reason?: undefined;
1070
1100
  pending?: undefined;
1071
1101
  code?: undefined;
1072
1102
  }>;
@@ -1106,6 +1136,14 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1106
1136
  causes: Record<string, number>;
1107
1137
  };
1108
1138
  }>;
1139
+ [HOST_APPROVAL_PROBE]: {
1140
+ prepareHostApproval: (input: {
1141
+ kind: string;
1142
+ target: string;
1143
+ subject: string;
1144
+ root?: string;
1145
+ }) => ApprovalIntent;
1146
+ };
1109
1147
  spec_create: (a: any) => Promise<{
1110
1148
  ok: boolean;
1111
1149
  reason: string;
@@ -1113,7 +1151,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1113
1151
  } | {
1114
1152
  created: any;
1115
1153
  ok?: undefined;
1116
- reason?: undefined;
1154
+ readonly reason?: undefined;
1117
1155
  }>;
1118
1156
  spec_validate: (a: any) => Promise<{
1119
1157
  ok: boolean;
@@ -1145,31 +1183,19 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1145
1183
  type: import("../spec/spec-types").SpecType;
1146
1184
  legacyStatus: string;
1147
1185
  remaining: import("../spec/validator").Finding[];
1148
- reason?: undefined;
1186
+ readonly reason?: undefined;
1149
1187
  }>;
1150
1188
  spec_retire: (a: {
1151
1189
  root?: string;
1152
1190
  id: string;
1153
1191
  reason?: string;
1154
- }) => Promise<{
1155
- ok: boolean;
1156
- reason: string;
1157
- retired?: undefined;
1158
- id?: undefined;
1159
- dependents?: undefined;
1160
- } | {
1161
- ok: boolean;
1162
- retired: boolean;
1163
- id: string;
1164
- dependents: never[];
1165
- reason: string;
1166
- } | {
1167
- ok: boolean;
1168
- retired: boolean;
1169
- id: string;
1170
- dependents: string[];
1171
- reason?: undefined;
1172
- }>;
1192
+ supersededBy?: string;
1193
+ directive?: string;
1194
+ also?: {
1195
+ id: string;
1196
+ supersededBy: string;
1197
+ }[];
1198
+ }) => Promise<Record<string, unknown>>;
1173
1199
  spec_renumber: (a: {
1174
1200
  root?: string;
1175
1201
  oldBase: string;
@@ -1196,25 +1222,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1196
1222
  spec_unseal: (a: {
1197
1223
  root?: string;
1198
1224
  id: string;
1199
- }) => Promise<{
1200
- ok: boolean;
1201
- reason: string;
1202
- unsealed?: undefined;
1203
- id?: undefined;
1204
- dependents?: undefined;
1205
- } | {
1206
- ok: boolean;
1207
- unsealed: boolean;
1208
- id: string;
1209
- dependents: never[];
1210
- reason: string;
1211
- } | {
1212
- ok: boolean;
1213
- unsealed: boolean;
1214
- id: string;
1215
- dependents: string[];
1216
- reason?: undefined;
1217
- }>;
1225
+ }) => Promise<Record<string, unknown>>;
1218
1226
  approval_status: (a: {
1219
1227
  root?: string;
1220
1228
  id: string;
@@ -1253,7 +1261,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1253
1261
  blockers: string[];
1254
1262
  resealBlockers: string[];
1255
1263
  ok: boolean;
1256
- reason?: undefined;
1264
+ readonly reason?: undefined;
1257
1265
  }>;
1258
1266
  ledger_timeline: (a: {
1259
1267
  root?: string;
@@ -1265,7 +1273,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1265
1273
  } | {
1266
1274
  ok: boolean;
1267
1275
  events: import("../governance/ledger-timeline").TimelineEntry[];
1268
- reason?: undefined;
1276
+ readonly reason?: undefined;
1269
1277
  }>;
1270
1278
  rtm_dashboard: (a: {
1271
1279
  root?: string;
@@ -1301,7 +1309,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1301
1309
  retiredCount: number;
1302
1310
  findingsScanned: boolean;
1303
1311
  };
1304
- reason?: undefined;
1312
+ readonly reason?: undefined;
1305
1313
  }>;
1306
1314
  spec_approve: (a: {
1307
1315
  root?: string;
@@ -1316,18 +1324,28 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1316
1324
  reason: string;
1317
1325
  blockers: string[];
1318
1326
  approvalIntent?: undefined;
1327
+ code?: undefined;
1319
1328
  conflict?: undefined;
1320
1329
  } | {
1321
1330
  ok: boolean;
1322
1331
  reason: string;
1323
1332
  blockers?: undefined;
1324
1333
  approvalIntent?: undefined;
1334
+ code?: undefined;
1325
1335
  conflict?: undefined;
1326
1336
  } | {
1327
1337
  ok: boolean;
1328
1338
  reason: string;
1329
1339
  approvalIntent: ApprovalIntent;
1330
1340
  blockers?: undefined;
1341
+ code?: undefined;
1342
+ conflict?: undefined;
1343
+ } | {
1344
+ ok: boolean;
1345
+ code: string;
1346
+ reason: string;
1347
+ blockers?: undefined;
1348
+ approvalIntent?: undefined;
1331
1349
  conflict?: undefined;
1332
1350
  } | {
1333
1351
  ok: boolean;
@@ -1335,6 +1353,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1335
1353
  conflict: import("../spec/version-conflict").ConflictDetail;
1336
1354
  blockers?: undefined;
1337
1355
  approvalIntent?: undefined;
1356
+ code?: undefined;
1338
1357
  } | {
1339
1358
  ancestorWarning?: string | undefined;
1340
1359
  scaffoldWarning?: string | undefined;
@@ -1343,7 +1362,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1343
1362
  advisoryIds?: Partial<Record<string, string>> | undefined;
1344
1363
  killsAdvisory?: import("../review/kills-check").KillsAdvisory | undefined;
1345
1364
  fttFulfilment?: import("../rtm/ftt-fulfilment").FttFulfilment | undefined;
1346
- impactAdvisoryUnavailable?: "unreadable" | "empty" | undefined;
1365
+ impactAdvisoryUnavailable?: "empty" | "unreadable" | undefined;
1347
1366
  impactGraph?: {
1348
1367
  status: "current" | "stale" | "unverified";
1349
1368
  sourceCommit: string | null;
@@ -1355,9 +1374,10 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1355
1374
  approved: string;
1356
1375
  digest: string;
1357
1376
  ok?: undefined;
1358
- reason?: undefined;
1377
+ readonly reason?: undefined;
1359
1378
  blockers?: undefined;
1360
1379
  approvalIntent?: undefined;
1380
+ code?: undefined;
1361
1381
  conflict?: undefined;
1362
1382
  }>;
1363
1383
  spec_list: (a: any) => Promise<Record<string, any>>;
@@ -1389,7 +1409,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1389
1409
  chainTotal: number;
1390
1410
  note: string;
1391
1411
  ok?: undefined;
1392
- reason?: undefined;
1412
+ readonly reason?: undefined;
1393
1413
  } | {
1394
1414
  next: import("../spec/spec-types").SpecType | null;
1395
1415
  actions: {
@@ -1400,7 +1420,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1400
1420
  actionsTotal: number;
1401
1421
  note: string;
1402
1422
  ok?: undefined;
1403
- reason?: undefined;
1423
+ readonly reason?: undefined;
1404
1424
  chain?: undefined;
1405
1425
  chainTotal?: undefined;
1406
1426
  }>;
@@ -1417,12 +1437,12 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1417
1437
  gaps: import("../rtm/gap-analyzer").ConvergenceGaps;
1418
1438
  breakingChangeDistribution: Record<string, number>;
1419
1439
  ok?: undefined;
1420
- reason?: undefined;
1440
+ readonly reason?: undefined;
1421
1441
  } | {
1422
1442
  issues: import("../rtm/rtm-check").RtmIssue[];
1423
1443
  breakingChangeDistribution: Record<string, number>;
1424
1444
  ok?: undefined;
1425
- reason?: undefined;
1445
+ readonly reason?: undefined;
1426
1446
  gaps?: undefined;
1427
1447
  }>;
1428
1448
  citation_pin: (a: {
@@ -1444,7 +1464,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1444
1464
  pinned: string[];
1445
1465
  findings: import("../spec/validator").Finding[];
1446
1466
  citations: unknown[];
1447
- reason?: undefined;
1467
+ readonly reason?: undefined;
1448
1468
  }>;
1449
1469
  phase_status: (a: {
1450
1470
  root?: string;
@@ -1478,7 +1498,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1478
1498
  }[];
1479
1499
  matched: number;
1480
1500
  ok?: undefined;
1481
- reason?: undefined;
1501
+ readonly reason?: undefined;
1482
1502
  }>;
1483
1503
  phase_check: (a: {
1484
1504
  action?: import("../guardrail/phase").Action;
@@ -1548,7 +1568,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1548
1568
  truncated: number;
1549
1569
  pairs: import("../rtm/taint").TaintPair[];
1550
1570
  ok?: undefined;
1551
- reason?: undefined;
1571
+ readonly reason?: undefined;
1552
1572
  }>;
1553
1573
  test_run: (a: {
1554
1574
  root: string;
@@ -1570,7 +1590,7 @@ declare function makeRawHandlers(store: SpecStore, opts?: ElicitOpts): {
1570
1590
  applied: boolean;
1571
1591
  verdict?: "killed" | "survived";
1572
1592
  mutation: import("../spec/kills").Mutation;
1573
- reason?: undefined;
1593
+ readonly reason?: undefined;
1574
1594
  })[];
1575
1595
  survivors: import("../spec/kills").Mutation[];
1576
1596
  unapplied: {