audit-tools 0.56.2 → 0.57.1

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 (374) hide show
  1. package/README.md +24 -22
  2. package/dist/audit/cli/args.d.ts +0 -1
  3. package/dist/audit/cli/args.d.ts.map +1 -1
  4. package/dist/audit/cli/args.js +0 -14
  5. package/dist/audit/cli/args.js.map +1 -1
  6. package/dist/audit/cli/auditStep.d.ts +0 -59
  7. package/dist/audit/cli/auditStep.d.ts.map +1 -1
  8. package/dist/audit/cli/auditStep.js +7 -139
  9. package/dist/audit/cli/auditStep.js.map +1 -1
  10. package/dist/audit/cli/cleanup.d.ts.map +1 -1
  11. package/dist/audit/cli/cleanup.js +4 -1
  12. package/dist/audit/cli/cleanup.js.map +1 -1
  13. package/dist/audit/cli/confirmIntentStep.d.ts.map +1 -1
  14. package/dist/audit/cli/confirmIntentStep.js +16 -31
  15. package/dist/audit/cli/confirmIntentStep.js.map +1 -1
  16. package/dist/audit/cli/dispatch/hostHandoff.d.ts +459 -1
  17. package/dist/audit/cli/dispatch/hostHandoff.d.ts.map +1 -1
  18. package/dist/audit/cli/dispatch/hostHandoff.js +312 -1
  19. package/dist/audit/cli/dispatch/hostHandoff.js.map +1 -1
  20. package/dist/audit/cli/dispatch/packetFilter.d.ts +1 -1
  21. package/dist/audit/cli/dispatch/questionReviewAcceptance.d.ts +254 -0
  22. package/dist/audit/cli/dispatch/questionReviewAcceptance.d.ts.map +1 -0
  23. package/dist/audit/cli/dispatch/questionReviewAcceptance.js +183 -0
  24. package/dist/audit/cli/dispatch/questionReviewAcceptance.js.map +1 -0
  25. package/dist/audit/cli/foldTransaction.d.ts +1 -1
  26. package/dist/audit/cli/foldTransaction.d.ts.map +1 -1
  27. package/dist/audit/cli/foldTransaction.js +3 -2
  28. package/dist/audit/cli/foldTransaction.js.map +1 -1
  29. package/dist/audit/cli/functionalPreflight.d.ts +4 -4
  30. package/dist/audit/cli/laneSubmissions.d.ts +4 -4
  31. package/dist/audit/cli/nextStepCommand.d.ts +3 -20
  32. package/dist/audit/cli/nextStepCommand.d.ts.map +1 -1
  33. package/dist/audit/cli/nextStepCommand.js +64 -141
  34. package/dist/audit/cli/nextStepCommand.js.map +1 -1
  35. package/dist/audit/cli/nextStepHelpers.d.ts +10 -72
  36. package/dist/audit/cli/nextStepHelpers.d.ts.map +1 -1
  37. package/dist/audit/cli/nextStepHelpers.js +115 -375
  38. package/dist/audit/cli/nextStepHelpers.js.map +1 -1
  39. package/dist/audit/cli/prompts.d.ts +0 -2
  40. package/dist/audit/cli/prompts.d.ts.map +1 -1
  41. package/dist/audit/cli/prompts.js +3 -14
  42. package/dist/audit/cli/prompts.js.map +1 -1
  43. package/dist/audit/cli/questionReviewCycle.d.ts +281 -0
  44. package/dist/audit/cli/questionReviewCycle.d.ts.map +1 -0
  45. package/dist/audit/cli/questionReviewCycle.js +87 -0
  46. package/dist/audit/cli/questionReviewCycle.js.map +1 -0
  47. package/dist/audit/cli/questionReviewSession.d.ts +21 -0
  48. package/dist/audit/cli/questionReviewSession.d.ts.map +1 -0
  49. package/dist/audit/cli/questionReviewSession.js +111 -0
  50. package/dist/audit/cli/questionReviewSession.js.map +1 -0
  51. package/dist/audit/cli/questionWorkloadBindings.d.ts +7 -0
  52. package/dist/audit/cli/questionWorkloadBindings.d.ts.map +1 -0
  53. package/dist/audit/cli/questionWorkloadBindings.js +68 -0
  54. package/dist/audit/cli/questionWorkloadBindings.js.map +1 -0
  55. package/dist/audit/cli/resynthesizeCommand.d.ts +1 -0
  56. package/dist/audit/cli/resynthesizeCommand.d.ts.map +1 -1
  57. package/dist/audit/cli/resynthesizeCommand.js +52 -51
  58. package/dist/audit/cli/resynthesizeCommand.js.map +1 -1
  59. package/dist/audit/cli/sampleRunCommand.d.ts +600 -159
  60. package/dist/audit/cli/sampleRunCommand.d.ts.map +1 -1
  61. package/dist/audit/cli/sampleRunCommand.js +66 -152
  62. package/dist/audit/cli/sampleRunCommand.js.map +1 -1
  63. package/dist/audit/cli/statusCommand.d.ts.map +1 -1
  64. package/dist/audit/cli/statusCommand.js +20 -14
  65. package/dist/audit/cli/statusCommand.js.map +1 -1
  66. package/dist/audit/cli/steps.d.ts +10 -10
  67. package/dist/audit/cli/submitCommand.d.ts +13 -6
  68. package/dist/audit/cli/submitCommand.d.ts.map +1 -1
  69. package/dist/audit/cli/submitCommand.js +121 -24
  70. package/dist/audit/cli/submitCommand.js.map +1 -1
  71. package/dist/audit/cli.d.ts.map +1 -1
  72. package/dist/audit/cli.js +7 -17
  73. package/dist/audit/cli.js.map +1 -1
  74. package/dist/audit/contracts/findingContractPrompt.d.ts +4 -4
  75. package/dist/audit/contracts/workerSchemas.d.ts +83 -82
  76. package/dist/audit/contracts/workerSchemas.d.ts.map +1 -1
  77. package/dist/audit/contracts/workerSchemas.js +8 -1
  78. package/dist/audit/contracts/workerSchemas.js.map +1 -1
  79. package/dist/audit/contracts/wrapperResponse.d.ts +13 -13
  80. package/dist/audit/contracts/wrapperResponse.d.ts.map +1 -1
  81. package/dist/audit/contracts/wrapperResponse.js +0 -1
  82. package/dist/audit/contracts/wrapperResponse.js.map +1 -1
  83. package/dist/audit/extractors/designAssessment.js +2 -2
  84. package/dist/audit/extractors/designAssessment.js.map +1 -1
  85. package/dist/audit/io/artifacts.d.ts +37 -10
  86. package/dist/audit/io/artifacts.d.ts.map +1 -1
  87. package/dist/audit/io/artifacts.js +217 -33
  88. package/dist/audit/io/artifacts.js.map +1 -1
  89. package/dist/audit/io/rollover.d.ts.map +1 -1
  90. package/dist/audit/io/rollover.js +7 -16
  91. package/dist/audit/io/rollover.js.map +1 -1
  92. package/dist/audit/io/runSnapshot.d.ts +1 -1
  93. package/dist/audit/io/runSnapshot.js +1 -1
  94. package/dist/audit/orchestrator/architectureDiscovery.d.ts +9 -10
  95. package/dist/audit/orchestrator/architectureDiscovery.d.ts.map +1 -1
  96. package/dist/audit/orchestrator/architectureDiscovery.js +95 -13
  97. package/dist/audit/orchestrator/architectureDiscovery.js.map +1 -1
  98. package/dist/audit/orchestrator/charterPacketArchive.d.ts +3 -0
  99. package/dist/audit/orchestrator/charterPacketArchive.d.ts.map +1 -1
  100. package/dist/audit/orchestrator/charterPacketArchive.js +31 -2
  101. package/dist/audit/orchestrator/charterPacketArchive.js.map +1 -1
  102. package/dist/audit/orchestrator/dependencyMap.d.ts +2 -8
  103. package/dist/audit/orchestrator/dependencyMap.d.ts.map +1 -1
  104. package/dist/audit/orchestrator/dependencyMap.js +10 -105
  105. package/dist/audit/orchestrator/dependencyMap.js.map +1 -1
  106. package/dist/audit/orchestrator/dependencySlices.d.ts +2 -3
  107. package/dist/audit/orchestrator/dependencySlices.d.ts.map +1 -1
  108. package/dist/audit/orchestrator/dependencySlices.js +2 -35
  109. package/dist/audit/orchestrator/dependencySlices.js.map +1 -1
  110. package/dist/audit/orchestrator/designReviewPrompt.d.ts.map +1 -1
  111. package/dist/audit/orchestrator/designReviewPrompt.js +24 -14
  112. package/dist/audit/orchestrator/designReviewPrompt.js.map +1 -1
  113. package/dist/audit/orchestrator/executorRunners.d.ts +1 -1
  114. package/dist/audit/orchestrator/executorRunners.d.ts.map +1 -1
  115. package/dist/audit/orchestrator/executorRunners.js +14 -21
  116. package/dist/audit/orchestrator/executorRunners.js.map +1 -1
  117. package/dist/audit/orchestrator/executors.d.ts.map +1 -1
  118. package/dist/audit/orchestrator/executors.js +1 -131
  119. package/dist/audit/orchestrator/executors.js.map +1 -1
  120. package/dist/audit/orchestrator/flowPlanning.d.ts +1 -1
  121. package/dist/audit/orchestrator/flowPlanning.js +1 -1
  122. package/dist/audit/orchestrator/ingestionExecutors.d.ts.map +1 -1
  123. package/dist/audit/orchestrator/ingestionExecutors.js +19 -12
  124. package/dist/audit/orchestrator/ingestionExecutors.js.map +1 -1
  125. package/dist/audit/orchestrator/intentCheckpointExecutor.d.ts +2 -2
  126. package/dist/audit/orchestrator/intentCheckpointExecutor.d.ts.map +1 -1
  127. package/dist/audit/orchestrator/intentCheckpointExecutor.js +37 -36
  128. package/dist/audit/orchestrator/intentCheckpointExecutor.js.map +1 -1
  129. package/dist/audit/orchestrator/lensSelection.d.ts +6 -37
  130. package/dist/audit/orchestrator/lensSelection.d.ts.map +1 -1
  131. package/dist/audit/orchestrator/lensSelection.js +42 -68
  132. package/dist/audit/orchestrator/lensSelection.js.map +1 -1
  133. package/dist/audit/orchestrator/nextStep.d.ts.map +1 -1
  134. package/dist/audit/orchestrator/nextStep.js +1 -4
  135. package/dist/audit/orchestrator/nextStep.js.map +1 -1
  136. package/dist/audit/orchestrator/questionEvidence.d.ts +67 -0
  137. package/dist/audit/orchestrator/questionEvidence.d.ts.map +1 -0
  138. package/dist/audit/orchestrator/questionEvidence.js +177 -0
  139. package/dist/audit/orchestrator/questionEvidence.js.map +1 -0
  140. package/dist/audit/orchestrator/questionPlanExecutor.d.ts +10 -0
  141. package/dist/audit/orchestrator/questionPlanExecutor.d.ts.map +1 -0
  142. package/dist/audit/orchestrator/questionPlanExecutor.js +23 -0
  143. package/dist/audit/orchestrator/questionPlanExecutor.js.map +1 -0
  144. package/dist/audit/orchestrator/questionPlanning.d.ts +48 -0
  145. package/dist/audit/orchestrator/questionPlanning.d.ts.map +1 -0
  146. package/dist/audit/orchestrator/questionPlanning.js +326 -0
  147. package/dist/audit/orchestrator/questionPlanning.js.map +1 -0
  148. package/dist/audit/orchestrator/requeueCommand.d.ts +1 -1
  149. package/dist/audit/orchestrator/reviewLensPlaybooks.d.ts +11 -0
  150. package/dist/audit/orchestrator/reviewLensPlaybooks.d.ts.map +1 -0
  151. package/dist/audit/orchestrator/reviewLensPlaybooks.js +11 -0
  152. package/dist/audit/orchestrator/reviewLensPlaybooks.js.map +1 -0
  153. package/dist/audit/orchestrator/runtimeValidation.d.ts.map +1 -1
  154. package/dist/audit/orchestrator/runtimeValidation.js +14 -0
  155. package/dist/audit/orchestrator/runtimeValidation.js.map +1 -1
  156. package/dist/audit/orchestrator/runtimeValidationUpdate.d.ts +1 -1
  157. package/dist/audit/orchestrator/runtimeValidationUpdate.d.ts.map +1 -1
  158. package/dist/audit/orchestrator/runtimeValidationUpdate.js +13 -4
  159. package/dist/audit/orchestrator/runtimeValidationUpdate.js.map +1 -1
  160. package/dist/audit/orchestrator/selectiveDeepening/conflict.js +1 -1
  161. package/dist/audit/orchestrator/selectiveDeepening/conflict.js.map +1 -1
  162. package/dist/audit/orchestrator/selectiveDeepening/index.js +1 -1
  163. package/dist/audit/orchestrator/selectiveDeepening/index.js.map +1 -1
  164. package/dist/audit/orchestrator/state.d.ts.map +1 -1
  165. package/dist/audit/orchestrator/state.js +8 -60
  166. package/dist/audit/orchestrator/state.js.map +1 -1
  167. package/dist/audit/orchestrator/synthesisExecutors.d.ts +15 -1
  168. package/dist/audit/orchestrator/synthesisExecutors.d.ts.map +1 -1
  169. package/dist/audit/orchestrator/synthesisExecutors.js +76 -25
  170. package/dist/audit/orchestrator/synthesisExecutors.js.map +1 -1
  171. package/dist/audit/orchestrator/systemicChallengeExecutor.d.ts.map +1 -1
  172. package/dist/audit/orchestrator/systemicChallengeExecutor.js +11 -6
  173. package/dist/audit/orchestrator/systemicChallengeExecutor.js.map +1 -1
  174. package/dist/audit/orchestrator/taskAffinityGraph.d.ts +4 -4
  175. package/dist/audit/reporting/questionReport.d.ts +28 -0
  176. package/dist/audit/reporting/questionReport.d.ts.map +1 -0
  177. package/dist/audit/reporting/questionReport.js +186 -0
  178. package/dist/audit/reporting/questionReport.js.map +1 -0
  179. package/dist/audit/reporting/synthesis.d.ts +10 -1
  180. package/dist/audit/reporting/synthesis.d.ts.map +1 -1
  181. package/dist/audit/reporting/synthesis.js +161 -24
  182. package/dist/audit/reporting/synthesis.js.map +1 -1
  183. package/dist/audit/reporting/synthesisNarrativePrompt.d.ts +4 -1
  184. package/dist/audit/reporting/synthesisNarrativePrompt.d.ts.map +1 -1
  185. package/dist/audit/reporting/synthesisNarrativePrompt.js +5 -1
  186. package/dist/audit/reporting/synthesisNarrativePrompt.js.map +1 -1
  187. package/dist/audit/supervisor/operatorHandoff.d.ts +2 -3
  188. package/dist/audit/supervisor/operatorHandoff.d.ts.map +1 -1
  189. package/dist/audit/supervisor/operatorHandoff.js +3 -18
  190. package/dist/audit/supervisor/operatorHandoff.js.map +1 -1
  191. package/dist/audit/systemic/aggregateMetricsDigest.d.ts.map +1 -1
  192. package/dist/audit/systemic/aggregateMetricsDigest.js +0 -2
  193. package/dist/audit/systemic/aggregateMetricsDigest.js.map +1 -1
  194. package/dist/audit/types/artifactMetadata.d.ts +1 -2
  195. package/dist/audit/types/artifactMetadata.d.ts.map +1 -1
  196. package/dist/audit/types/auditState.d.ts +6 -6
  197. package/dist/audit/types/conceptualAdjudication.d.ts +708 -50
  198. package/dist/audit/types/conceptualAdjudication.d.ts.map +1 -1
  199. package/dist/audit/types/conceptualAdjudication.js +2 -0
  200. package/dist/audit/types/conceptualAdjudication.js.map +1 -1
  201. package/dist/audit/types/runtimeValidation.d.ts +58 -6
  202. package/dist/audit/types/runtimeValidation.d.ts.map +1 -1
  203. package/dist/audit/types/runtimeValidation.js +8 -0
  204. package/dist/audit/types/runtimeValidation.js.map +1 -1
  205. package/dist/audit/types.d.ts +551 -34
  206. package/dist/audit/types.d.ts.map +1 -1
  207. package/dist/audit/validation/auditResults.d.ts +1 -1
  208. package/dist/audit/validation/auditResults.js +1 -1
  209. package/dist/audit/validation/ingestIssueCodes.d.ts.map +1 -1
  210. package/dist/audit/validation/ingestIssueCodes.js +0 -1
  211. package/dist/audit/validation/ingestIssueCodes.js.map +1 -1
  212. package/dist/remediate/contractPipeline/executionPlan.d.ts +679 -52
  213. package/dist/remediate/contractPipeline/executionPlan.d.ts.map +1 -1
  214. package/dist/remediate/contractPipeline/executionPlan.js +23 -0
  215. package/dist/remediate/contractPipeline/executionPlan.js.map +1 -1
  216. package/dist/remediate/findingFilter.d.ts.map +1 -1
  217. package/dist/remediate/findingFilter.js +6 -2
  218. package/dist/remediate/findingFilter.js.map +1 -1
  219. package/dist/remediate/intake.d.ts +4 -4
  220. package/dist/remediate/phases/close.d.ts.map +1 -1
  221. package/dist/remediate/phases/close.js +15 -5
  222. package/dist/remediate/phases/close.js.map +1 -1
  223. package/dist/remediate/phases/closeVerifyAnalyzerLeads.d.ts +5 -0
  224. package/dist/remediate/phases/closeVerifyAnalyzerLeads.d.ts.map +1 -1
  225. package/dist/remediate/phases/closeVerifyAnalyzerLeads.js +37 -8
  226. package/dist/remediate/phases/closeVerifyAnalyzerLeads.js.map +1 -1
  227. package/dist/remediate/state/types.d.ts +619 -26
  228. package/dist/remediate/state/types.d.ts.map +1 -1
  229. package/dist/remediate/state/types.js +2 -1
  230. package/dist/remediate/state/types.js.map +1 -1
  231. package/dist/remediate/steps/contractPipeline.d.ts.map +1 -1
  232. package/dist/remediate/steps/contractPipeline.js +2 -0
  233. package/dist/remediate/steps/contractPipeline.js.map +1 -1
  234. package/dist/remediate/steps/contractPipelinePrompts.d.ts.map +1 -1
  235. package/dist/remediate/steps/contractPipelinePrompts.js +2 -0
  236. package/dist/remediate/steps/contractPipelinePrompts.js.map +1 -1
  237. package/dist/remediate/steps/dispatch/contractConformanceReview.d.ts +3 -3
  238. package/dist/remediate/steps/intakeResolver.d.ts.map +1 -1
  239. package/dist/remediate/steps/intakeResolver.js +31 -6
  240. package/dist/remediate/steps/intakeResolver.js.map +1 -1
  241. package/dist/remediate/steps/nextStep.d.ts.map +1 -1
  242. package/dist/remediate/steps/nextStep.js +47 -44
  243. package/dist/remediate/steps/nextStep.js.map +1 -1
  244. package/dist/remediate/steps/prompts.d.ts.map +1 -1
  245. package/dist/remediate/steps/prompts.js +3 -0
  246. package/dist/remediate/steps/prompts.js.map +1 -1
  247. package/dist/shared/analyzers/types.d.ts +18 -18
  248. package/dist/shared/contentKey.d.ts +1 -1
  249. package/dist/shared/contentKey.js +1 -1
  250. package/dist/shared/decompose/charterClarification.d.ts +4 -4
  251. package/dist/shared/decompose/charterExtraction.d.ts +31 -31
  252. package/dist/shared/decompose/contentCoherence.d.ts +1 -1
  253. package/dist/shared/decompose/contentCoherence.js +1 -1
  254. package/dist/shared/decompose/systemicChallenge.d.ts +629 -18
  255. package/dist/shared/decompose/systemicChallenge.d.ts.map +1 -1
  256. package/dist/shared/engine/obligationEngine.d.ts +2 -2
  257. package/dist/shared/index.d.ts +2 -0
  258. package/dist/shared/index.d.ts.map +1 -1
  259. package/dist/shared/index.js +2 -0
  260. package/dist/shared/index.js.map +1 -1
  261. package/dist/shared/io/stepContractWriter.js +1 -1
  262. package/dist/shared/io/stepContractWriter.js.map +1 -1
  263. package/dist/shared/loopCorePaths.d.ts.map +1 -1
  264. package/dist/shared/loopCorePaths.js +5 -2
  265. package/dist/shared/loopCorePaths.js.map +1 -1
  266. package/dist/shared/mcp/submitServer.d.ts +1 -0
  267. package/dist/shared/mcp/submitServer.d.ts.map +1 -1
  268. package/dist/shared/mcp/submitServer.js +1 -1
  269. package/dist/shared/mcp/submitServer.js.map +1 -1
  270. package/dist/shared/submission/hostResultOutcomes.js +1 -1
  271. package/dist/shared/submission/hostResultOutcomes.js.map +1 -1
  272. package/dist/shared/tooling/exec.js +1 -1
  273. package/dist/shared/tooling/exec.js.map +1 -1
  274. package/dist/shared/types/charter.d.ts +38 -38
  275. package/dist/shared/types/contractPropertyShapes.d.ts.map +1 -1
  276. package/dist/shared/types/contractPropertyShapes.js +7 -0
  277. package/dist/shared/types/contractPropertyShapes.js.map +1 -1
  278. package/dist/shared/types/executionPlan.d.ts +88 -12
  279. package/dist/shared/types/executionPlan.d.ts.map +1 -1
  280. package/dist/shared/types/executionPlan.js +1 -0
  281. package/dist/shared/types/executionPlan.js.map +1 -1
  282. package/dist/shared/types/finding.d.ts +1721 -56
  283. package/dist/shared/types/finding.d.ts.map +1 -1
  284. package/dist/shared/types/finding.js +7 -10
  285. package/dist/shared/types/finding.js.map +1 -1
  286. package/dist/shared/types/findingVocabulary.d.ts +8 -0
  287. package/dist/shared/types/findingVocabulary.d.ts.map +1 -0
  288. package/dist/shared/types/findingVocabulary.js +13 -0
  289. package/dist/shared/types/findingVocabulary.js.map +1 -0
  290. package/dist/shared/types/intentCheckpoint.d.ts +8 -3
  291. package/dist/shared/types/intentCheckpoint.d.ts.map +1 -1
  292. package/dist/shared/types/intentCheckpoint.js +4 -3
  293. package/dist/shared/types/intentCheckpoint.js.map +1 -1
  294. package/dist/shared/types/questionReviewReport.d.ts +10574 -0
  295. package/dist/shared/types/questionReviewReport.d.ts.map +1 -0
  296. package/dist/shared/types/questionReviewReport.js +186 -0
  297. package/dist/shared/types/questionReviewReport.js.map +1 -0
  298. package/dist/shared/types/remediationOutcome.d.ts +1379 -148
  299. package/dist/shared/types/remediationOutcome.d.ts.map +1 -1
  300. package/dist/shared/types/remediationOutcome.js +5 -0
  301. package/dist/shared/types/remediationOutcome.js.map +1 -1
  302. package/dist/shared/types/reviewIndependence.d.ts +24 -24
  303. package/dist/shared/types/reviewQuestion.d.ts +4710 -0
  304. package/dist/shared/types/reviewQuestion.d.ts.map +1 -0
  305. package/dist/shared/types/reviewQuestion.js +216 -0
  306. package/dist/shared/types/reviewQuestion.js.map +1 -0
  307. package/dist/shared/types/stepContract.js +1 -1
  308. package/dist/shared/types/stepContract.js.map +1 -1
  309. package/dist/shared/validation/designFindingGrounding.js +1 -1
  310. package/dist/shared/validation/designFindingGrounding.js.map +1 -1
  311. package/dist/shared/validation/findingsReport.d.ts.map +1 -1
  312. package/dist/shared/validation/findingsReport.js +19 -4
  313. package/dist/shared/validation/findingsReport.js.map +1 -1
  314. package/docs/audit-pkg/contracts.md +27 -56
  315. package/docs/audit-pkg/operator-guide.md +31 -17
  316. package/docs/audit-pkg/product.md +17 -23
  317. package/package.json +1 -1
  318. package/schemas/audit-code-v1alpha1.schema.json +0 -1
  319. package/schemas/review_submission.schema.json +514 -0
  320. package/skills/audit-code/audit-code.prompt.md +7 -5
  321. package/wrapper/audit-code-wrapper-lib.mjs +1 -5
  322. package/wrapper/installer-verb-help.mjs +1 -1
  323. package/dist/audit/cli/explainTaskCommand.d.ts +0 -4
  324. package/dist/audit/cli/explainTaskCommand.d.ts.map +0 -1
  325. package/dist/audit/cli/explainTaskCommand.js +0 -45
  326. package/dist/audit/cli/explainTaskCommand.js.map +0 -1
  327. package/dist/audit/cli/ingestResultsCommand.d.ts +0 -2
  328. package/dist/audit/cli/ingestResultsCommand.d.ts.map +0 -1
  329. package/dist/audit/cli/ingestResultsCommand.js +0 -42
  330. package/dist/audit/cli/ingestResultsCommand.js.map +0 -1
  331. package/dist/audit/cli/requeueCommand.d.ts +0 -2
  332. package/dist/audit/cli/requeueCommand.d.ts.map +0 -1
  333. package/dist/audit/cli/requeueCommand.js +0 -12
  334. package/dist/audit/cli/requeueCommand.js.map +0 -1
  335. package/dist/audit/cli/semanticReviewStep.d.ts +0 -41
  336. package/dist/audit/cli/semanticReviewStep.d.ts.map +0 -1
  337. package/dist/audit/cli/semanticReviewStep.js +0 -185
  338. package/dist/audit/cli/semanticReviewStep.js.map +0 -1
  339. package/dist/audit/cli/unacceptResultsCommand.d.ts +0 -19
  340. package/dist/audit/cli/unacceptResultsCommand.d.ts.map +0 -1
  341. package/dist/audit/cli/unacceptResultsCommand.js +0 -52
  342. package/dist/audit/cli/unacceptResultsCommand.js.map +0 -1
  343. package/dist/audit/cli/updateRuntimeValidationCommand.d.ts +0 -2
  344. package/dist/audit/cli/updateRuntimeValidationCommand.d.ts.map +0 -1
  345. package/dist/audit/cli/updateRuntimeValidationCommand.js +0 -18
  346. package/dist/audit/cli/updateRuntimeValidationCommand.js.map +0 -1
  347. package/dist/audit/cli/validateResultsCommand.d.ts +0 -13
  348. package/dist/audit/cli/validateResultsCommand.d.ts.map +0 -1
  349. package/dist/audit/cli/validateResultsCommand.js +0 -87
  350. package/dist/audit/cli/validateResultsCommand.js.map +0 -1
  351. package/dist/audit/cli/workerResult.d.ts +0 -2
  352. package/dist/audit/cli/workerResult.d.ts.map +0 -1
  353. package/dist/audit/cli/workerResult.js +0 -6
  354. package/dist/audit/cli/workerResult.js.map +0 -1
  355. package/dist/audit/orchestrator/coverageElementBaseline.d.ts +0 -54
  356. package/dist/audit/orchestrator/coverageElementBaseline.d.ts.map +0 -1
  357. package/dist/audit/orchestrator/coverageElementBaseline.js +0 -136
  358. package/dist/audit/orchestrator/coverageElementBaseline.js.map +0 -1
  359. package/dist/audit/orchestrator/planning.d.ts +0 -5
  360. package/dist/audit/orchestrator/planning.d.ts.map +0 -1
  361. package/dist/audit/orchestrator/planning.js +0 -79
  362. package/dist/audit/orchestrator/planning.js.map +0 -1
  363. package/dist/audit/orchestrator/planningExecutors.d.ts +0 -21
  364. package/dist/audit/orchestrator/planningExecutors.d.ts.map +0 -1
  365. package/dist/audit/orchestrator/planningExecutors.js +0 -273
  366. package/dist/audit/orchestrator/planningExecutors.js.map +0 -1
  367. package/dist/audit/orchestrator/taskBuilder.d.ts +0 -62
  368. package/dist/audit/orchestrator/taskBuilder.d.ts.map +0 -1
  369. package/dist/audit/orchestrator/taskBuilder.js +0 -412
  370. package/dist/audit/orchestrator/taskBuilder.js.map +0 -1
  371. package/dist/audit/orchestrator/trivialAudit.d.ts +0 -21
  372. package/dist/audit/orchestrator/trivialAudit.d.ts.map +0 -1
  373. package/dist/audit/orchestrator/trivialAudit.js +0 -80
  374. package/dist/audit/orchestrator/trivialAudit.js.map +0 -1
@@ -2,6 +2,11 @@ import { recordHostRootLogBoundary } from "../../../shared/observability/rootLog
2
2
  // sites-pinned: tests/audit/host-handoff.test.ts, tests/audit/inspection-handoff-binding.test.ts
3
3
  import { errorMessage } from "../../../shared/io/json.js";
4
4
  import { STEP_CONTRACT_VERSION } from "../steps.js";
5
+ import { acceptQuestionReview, projectQuestionReview, validateQuestionAdjudication, validateQuestionSource } from "./questionReviewAcceptance.js";
6
+ import { REVIEW_QUESTION_CONTRACT_VERSION, ReviewAcceptedAnswerSchema, ReviewAdjudicationSchema, ReviewAssignmentSchema, ReviewDependencySchema, ReviewEvidenceSchema, ReviewQuestionSchema, ReviewReopenEventSchema, ReviewReopenRequestSchema, ReviewSubmissionSchema, questionReopenDependencies } from "../../../shared/types/reviewQuestion.js";
7
+ import { projectQuestionForReport } from "../../reporting/questionReport.js";
8
+ import { questionClaimKey, ReviewFindingConsolidationSchema } from "../../../shared/types/questionReviewReport.js";
9
+ import { z } from "zod";
5
10
  import { ActiveReviewRunSchema } from "../../contracts/wrapperResponse.js";
6
11
  import { sourceTreeInstruction } from "../../io/runSnapshot.js";
7
12
  import { CURRENT_TASK_FILENAME } from "../../supervisor/operatorHandoff.js";
@@ -250,6 +255,312 @@ function resultPathFor(paths, workItemId) {
250
255
  // a field the shared rule later starts reading.
251
256
  return hostHandoffResultPath(paths, workItemId);
252
257
  }
258
+ // sites-pinned: tests/audit/question-review-acceptance.test.ts
259
+ const QuestionSourceFileSchema = z.strictObject({ path: z.string().min(1), line_count: z.number().int().nonnegative(), fingerprint: z.string().min(1) });
260
+ const QuestionHandoffBindingSchema = z.strictObject({
261
+ question: ReviewQuestionSchema,
262
+ assignment: ReviewAssignmentSchema,
263
+ dependencies: z.array(ReviewDependencySchema),
264
+ });
265
+ const QuestionWorkloadSchema = z.strictObject({
266
+ contract_version: z.literal(REVIEW_QUESTION_CONTRACT_VERSION),
267
+ run_id: z.string().min(1),
268
+ source_root: z.string().min(1),
269
+ source_files: z.array(QuestionSourceFileSchema),
270
+ evidence: z.array(ReviewEvidenceSchema),
271
+ work_items: z.array(z.strictObject({ binding: QuestionHandoffBindingSchema, result_path: z.string().min(1) })),
272
+ });
273
+ const QuestionLedgerSchema = z.strictObject({
274
+ contract_version: z.literal(REVIEW_QUESTION_CONTRACT_VERSION),
275
+ run_id: z.string().min(1),
276
+ answers: z.array(ReviewAcceptedAnswerSchema),
277
+ adjudications: z.array(ReviewAdjudicationSchema),
278
+ consolidations: z.array(ReviewFindingConsolidationSchema).default([]),
279
+ reopens: z.array(ReviewReopenEventSchema).default([]),
280
+ });
281
+ function hydrateQuestionBinding(workload, binding) {
282
+ return { ...binding, sourceFiles: workload.source_files, evidence: workload.evidence.filter((item) => binding.assignment.available_evidence_ids.includes(item.evidence_id)) };
283
+ }
284
+ const questionWorkloadPointer = (paths) => join(paths.runDir, "question-workload-current.json");
285
+ const questionWorkloadSnapshot = (paths, digest) => join(paths.runDir, "question-workloads", digest, "host-workload.json");
286
+ const questionWorkloadDigest = (workload) => contentSha256(workload);
287
+ async function readQuestionWorkload(paths) {
288
+ let digest;
289
+ try {
290
+ digest = z.strictObject({ sha256: z.string().regex(/^[0-9a-f]{64}$/u) })
291
+ .parse(await readJsonFile(questionWorkloadPointer(paths))).sha256;
292
+ }
293
+ catch (error) {
294
+ if (!isFileMissingError(error))
295
+ throw error;
296
+ }
297
+ // Preserve the old mutable filename as read-only legacy dispatch input.
298
+ const workload = QuestionWorkloadSchema.parse(await readJsonFile(digest ? questionWorkloadSnapshot(paths, digest) : paths.workloadPath));
299
+ if (workload.run_id !== paths.runId)
300
+ throw new Error("Question workload belongs to a different run");
301
+ for (const item of workload.work_items) {
302
+ if (item.result_path !== resultPathFor(paths, item.binding.assignment.assignment_id))
303
+ throw new Error("Question result path differs from its issued assignment");
304
+ }
305
+ if (digest && digest !== questionWorkloadDigest(workload))
306
+ throw new Error("Question workload no longer matches its issued digest");
307
+ return workload;
308
+ }
309
+ async function readQuestionLedger(paths) {
310
+ let raw;
311
+ try {
312
+ raw = await readJsonFile(paths.acceptedLedgerPath);
313
+ }
314
+ catch (error) {
315
+ if (!isFileMissingError(error))
316
+ throw error;
317
+ return { contract_version: REVIEW_QUESTION_CONTRACT_VERSION, run_id: paths.runId, answers: [], adjudications: [], consolidations: [], reopens: [] };
318
+ }
319
+ const ledger = QuestionLedgerSchema.parse(raw);
320
+ if (ledger.run_id !== paths.runId)
321
+ throw new Error("Question acceptance ledger belongs to a different run");
322
+ return ledger;
323
+ }
324
+ export async function publishAuditQuestionWorkload(params) {
325
+ const paths = resolveBoundaryPaths(params);
326
+ const ids = new Set();
327
+ const sourceFiles = [...(params.bindings[0]?.sourceFiles ?? [])].sort((a, b) => compareCodeUnits(a.path, b.path));
328
+ if (new Set(sourceFiles.map((item) => item.path)).size !== sourceFiles.length)
329
+ throw new Error("Duplicate issued source path");
330
+ const sourceWire = stableStringify(sourceFiles);
331
+ const evidence = new Map();
332
+ for (const binding of params.bindings) {
333
+ if (stableStringify([...binding.sourceFiles].sort((a, b) => compareCodeUnits(a.path, b.path))) !== sourceWire) {
334
+ throw new Error("Every issued assignment must use the same pinned source inventory; constrain each assignment through its authorized scope");
335
+ }
336
+ for (const item of binding.evidence) {
337
+ const prior = evidence.get(item.evidence_id);
338
+ if (prior && stableStringify(prior) !== stableStringify(item))
339
+ throw new Error("Conflicting issued evidence identity");
340
+ evidence.set(item.evidence_id, item);
341
+ }
342
+ }
343
+ const workload = QuestionWorkloadSchema.parse({
344
+ contract_version: REVIEW_QUESTION_CONTRACT_VERSION, run_id: paths.runId, source_root: toPosixPath(params.sourceRoot),
345
+ source_files: sourceFiles,
346
+ evidence: [...evidence.values()].sort((a, b) => compareCodeUnits(a.evidence_id, b.evidence_id)),
347
+ work_items: params.bindings.map((binding) => {
348
+ const { question, assignment } = binding;
349
+ if (ids.has(assignment.assignment_id) || assignment.question_id !== question.question_id ||
350
+ assignment.revision_id !== question.revision_id || assignment.snapshot_id !== question.snapshot_id) {
351
+ throw new Error("Duplicate or misbound review assignment");
352
+ }
353
+ ids.add(assignment.assignment_id);
354
+ for (const ref of assignment.suggested_sources)
355
+ validateQuestionSource(binding, ref);
356
+ return { binding: { question, assignment, dependencies: binding.dependencies }, result_path: resultPathFor(paths, assignment.assignment_id) };
357
+ }),
358
+ });
359
+ const digest = questionWorkloadDigest(workload);
360
+ const snapshot = questionWorkloadSnapshot(paths, digest);
361
+ await withFileLock(paths.acceptedLockPath, async () => {
362
+ try {
363
+ const prior = await readQuestionWorkload(paths);
364
+ for (const item of workload.work_items) {
365
+ const old = prior.work_items.find((entry) => entry.binding.assignment.assignment_id === item.binding.assignment.assignment_id);
366
+ if (old && (prior.source_root !== workload.source_root ||
367
+ stableStringify(hydrateQuestionBinding(prior, old.binding)) !== stableStringify(hydrateQuestionBinding(workload, item.binding)))) {
368
+ throw new Error("Changed question binding requires a newly issued assignment ID");
369
+ }
370
+ }
371
+ }
372
+ catch (error) {
373
+ if (!isFileMissingError(error))
374
+ throw error;
375
+ }
376
+ // Pin bytes before advancing the internal current pointer. A crash between
377
+ // writes leaves a harmless immutable snapshot, never a partial dispatch.
378
+ try {
379
+ const prior = QuestionWorkloadSchema.parse(await readJsonFile(snapshot));
380
+ if (questionWorkloadDigest(prior) !== digest)
381
+ throw new Error("Question workload no longer matches its issued digest");
382
+ }
383
+ catch (error) {
384
+ if (!isFileMissingError(error))
385
+ throw error;
386
+ await writeJsonFile(snapshot, workload);
387
+ }
388
+ await writeJsonFile(questionWorkloadPointer(paths), { sha256: digest });
389
+ });
390
+ return { workload, workload_path: snapshot };
391
+ }
392
+ export async function readAuditQuestionWorkload(params) {
393
+ const paths = resolveBoundaryPaths(params);
394
+ return withFileLock(paths.acceptedLockPath, () => readQuestionWorkload(paths));
395
+ }
396
+ /** Operator inspection never folds queued worker results. */
397
+ export async function readAuditQuestionLedger(params) {
398
+ const paths = resolveBoundaryPaths(params);
399
+ return withFileLock(paths.acceptedLockPath, () => readQuestionLedger(paths));
400
+ }
401
+ function isCurrentQuestionEpoch(binding, epochs) {
402
+ const epoch = epochs.get(binding.question.question_id);
403
+ return epoch === undefined || binding.dependencies.some(item => item.kind === epoch.kind &&
404
+ item.key === epoch.key && item.fingerprint === epoch.fingerprint);
405
+ }
406
+ /** One atomic ledger write preserves original submissions and reopens every
407
+ * selected question, or none. Exact replay cannot invalidate the replacement. */
408
+ export async function reopenAuditQuestions(params) {
409
+ const paths = resolveBoundaryPaths(params);
410
+ const request = ReviewReopenRequestSchema.parse(params.request);
411
+ return withFileLock(paths.acceptedLockPath, async () => {
412
+ const ledger = await readQuestionLedger(paths);
413
+ const prior = ledger.reopens.find(event => event.reopen_id === request.reopen_id);
414
+ if (prior) {
415
+ const { reopened_at: _timestamp, tooling_qualification: _qualification, ...original } = prior;
416
+ if (stableStringify(original) !== stableStringify(request))
417
+ throw new Error("Conflicting reopen ID.");
418
+ return "replay";
419
+ }
420
+ if (request.tooling_transition && (!params.qualification || params.qualification.run_id !== params.runId ||
421
+ params.qualification.prior.implementation_hash !== request.tooling_transition.prior_implementation_hash ||
422
+ params.qualification.current.implementation_hash !== request.tooling_transition.current_implementation_hash)) {
423
+ throw new Error("Tooling transition was not qualified on this review run.");
424
+ }
425
+ const questions = new Map(params.questions.map(question => [question.question_id, question]));
426
+ const selected = new Set();
427
+ for (const target of request.questions) {
428
+ if (selected.has(target.question_id))
429
+ throw new Error("Duplicate reopen question.");
430
+ selected.add(target.question_id);
431
+ const question = questions.get(target.question_id);
432
+ if (!question || question.revision_id !== target.revision_id || question.snapshot_id !== target.snapshot_id ||
433
+ (question.plan_status !== "pending" && question.plan_status !== "active")) {
434
+ throw new Error("Reopen target is not an active question revision in this run.");
435
+ }
436
+ const current = projectQuestionReview(question, ledger.answers, params.dependenciesByQuestion.get(question.question_id)).current;
437
+ const actual = uniqueSorted(current.map(row => row.submission.submission_id));
438
+ const expected = uniqueSorted(target.expected_submission_ids);
439
+ if (!actual.length || expected.length !== target.expected_submission_ids.length || !sameStrings(expected, actual)) {
440
+ throw new Error("Reopen must name exactly the current accepted submission IDs.");
441
+ }
442
+ }
443
+ await writeJsonFile(paths.acceptedLedgerPath, {
444
+ ...ledger, reopens: [...ledger.reopens, {
445
+ ...request, reopened_at: new Date().toISOString(),
446
+ ...(request.tooling_transition ? { tooling_qualification: params.qualification } : {}),
447
+ }],
448
+ });
449
+ return "accepted";
450
+ });
451
+ }
452
+ // sites-pinned: tests/audit/question-review-acceptance.test.ts, tests/audit/question-consolidation-cli.test.ts
453
+ export async function consolidateAuditQuestionFindings(params) {
454
+ const paths = resolveBoundaryPaths(params);
455
+ const decision = ReviewFindingConsolidationSchema.parse(params.decision);
456
+ if (!decision.reason.trim() || !decision.decided_by.trim())
457
+ throw new Error("Consolidation requires a named reviewer and a reason.");
458
+ const key = ({ answer_id, finding_id }) => questionClaimKey(answer_id, finding_id);
459
+ const keys = new Set(decision.sources.map(key));
460
+ if (keys.size !== decision.sources.length)
461
+ throw new Error("Consolidation requires distinct accepted claim references.");
462
+ return withFileLock(paths.acceptedLockPath, async () => {
463
+ const ledger = await readQuestionLedger(paths);
464
+ const prior = ledger.consolidations.find(row => row.decision_id === decision.decision_id);
465
+ if (prior) {
466
+ if (stableStringify(prior) !== stableStringify(decision))
467
+ throw new Error("Conflicting consolidation decision ID.");
468
+ return "replay";
469
+ }
470
+ const evidence = new Map(params.evidence.map(item => [item.evidence_id, item]));
471
+ const actionable = new Set(params.questions.flatMap(question => projectQuestionForReport(question, ledger.answers.filter(({ submission }) => submission.question_id === question.question_id), ledger.adjudications, evidence, params.dependenciesByQuestion.get(question.question_id)).claims.filter(claim => claim.actionable).map(({ answerId, source }) => questionClaimKey(answerId, source.finding_id))));
472
+ if ([...keys].some(id => !actionable.has(id))) {
473
+ throw new Error("Consolidation must reference distinct current actionable confirmed-defect claims.");
474
+ }
475
+ const consumed = new Set(ledger.consolidations.flatMap(row => {
476
+ const sources = row.sources.map(key);
477
+ return sources.every(id => actionable.has(id)) ? sources : [];
478
+ }));
479
+ if ([...keys].some(id => consumed.has(id)))
480
+ throw new Error("An accepted claim is already in a consolidation.");
481
+ await writeJsonFile(paths.acceptedLedgerPath, {
482
+ ...ledger, consolidations: [...ledger.consolidations, decision],
483
+ });
484
+ return "accepted";
485
+ });
486
+ }
487
+ /** Submit and fold share the normal run's lock and its canonical ledger. */
488
+ export async function submitAuditQuestionResult(params) {
489
+ const paths = resolveBoundaryPaths(params);
490
+ const submission = ReviewSubmissionSchema.parse(JSON.parse(params.source));
491
+ if (params.assignmentId !== submission.assignment_id)
492
+ throw new Error("Result assignment differs from its destination");
493
+ return withFileLock(paths.acceptedLockPath, async () => {
494
+ const workload = await readQuestionWorkload(paths);
495
+ const ledger = await readQuestionLedger(paths);
496
+ const item = workload.work_items.find((entry) => entry.binding.assignment.assignment_id === params.assignmentId);
497
+ if (!item || !isCurrentQuestionEpoch(item.binding, questionReopenDependencies(ledger.reopens))) {
498
+ throw new Error("Review assignment is not in the current issued workload");
499
+ }
500
+ const accepted = acceptQuestionReview(ledger.answers, hydrateQuestionBinding(workload, item.binding), submission, new Date().toISOString());
501
+ if (accepted.kind === "accepted")
502
+ await writeJsonFile(paths.acceptedLedgerPath, { ...ledger, answers: [...ledger.answers, accepted.record] });
503
+ return accepted;
504
+ });
505
+ }
506
+ export async function ingestAuditQuestionResults(params, currentAssignmentIds) {
507
+ const paths = resolveBoundaryPaths(params);
508
+ return withFileLock(paths.acceptedLockPath, async () => {
509
+ const workload = await readQuestionWorkload(paths);
510
+ const ledger = await readQuestionLedger(paths);
511
+ const answers = [...ledger.answers];
512
+ const epochs = questionReopenDependencies(ledger.reopens);
513
+ const issues = [];
514
+ for (const item of workload.work_items) {
515
+ // A re-intake or evidence refresh can supersede an issued answer before
516
+ // the next workload is published. Do not read or admit its old result.
517
+ if (!isCurrentQuestionEpoch(item.binding, epochs) ||
518
+ (currentAssignmentIds && !currentAssignmentIds.has(item.binding.assignment.assignment_id)))
519
+ continue;
520
+ try {
521
+ const submission = ReviewSubmissionSchema.parse(await readJsonFile(resolveContainedPath(paths.root, item.result_path, "issued question result path")));
522
+ if (submission.assignment_id !== item.binding.assignment.assignment_id)
523
+ throw new Error("Result assignment differs from its destination");
524
+ const decision = acceptQuestionReview(answers, hydrateQuestionBinding(workload, item.binding), submission, new Date().toISOString());
525
+ if (decision.kind === "accepted")
526
+ answers.push(decision.record);
527
+ }
528
+ catch (error) {
529
+ if (!isFileMissingError(error))
530
+ issues.push({ assignment_id: item.binding.assignment.assignment_id, reason: errorMessage(error) });
531
+ }
532
+ }
533
+ const accepted_count = answers.length - ledger.answers.length;
534
+ if (accepted_count)
535
+ await writeJsonFile(paths.acceptedLedgerPath, { ...ledger, answers });
536
+ return { accepted_count, answers, adjudications: ledger.adjudications, consolidations: ledger.consolidations, reopens: ledger.reopens, issues };
537
+ });
538
+ }
539
+ /** Record an operator-authorized decision separately from the immutable answers. */
540
+ export async function adjudicateAuditQuestionResult(params) {
541
+ const paths = resolveBoundaryPaths(params);
542
+ const adjudication = ReviewAdjudicationSchema.parse(params.adjudication);
543
+ return withFileLock(paths.acceptedLockPath, async () => {
544
+ const workload = await readQuestionWorkload(paths);
545
+ const ledger = await readQuestionLedger(paths);
546
+ const epochs = questionReopenDependencies(ledger.reopens);
547
+ const candidates = workload.work_items.filter(({ binding }) => isCurrentQuestionEpoch(binding, epochs))
548
+ .map(({ binding }) => hydrateQuestionBinding(workload, binding)).filter(({ question }) => question.question_id === adjudication.question_id && question.revision_id === adjudication.revision_id &&
549
+ question.snapshot_id === adjudication.snapshot_id);
550
+ const question = candidates[0]?.question;
551
+ if (!question)
552
+ throw new Error("Adjudication question is not current in this review run");
553
+ const dependencies = candidates.flatMap((binding) => [
554
+ ...binding.dependencies,
555
+ ...binding.sourceFiles.map((source) => ({ kind: "source", key: source.path, fingerprint: source.fingerprint })),
556
+ ...binding.evidence.flatMap((evidence) => evidence.dependencies),
557
+ ]);
558
+ const decision = validateQuestionAdjudication(ledger.answers, ledger.adjudications, adjudication, question, dependencies);
559
+ if (decision === "accepted")
560
+ await writeJsonFile(paths.acceptedLedgerPath, { ...ledger, adjudications: [...ledger.adjudications, adjudication] });
561
+ return decision;
562
+ });
563
+ }
253
564
  /** The boundary's source root; a prompt or a grounding without one would read the live tree. */
254
565
  function boundarySourceRoot(paths) {
255
566
  if (paths.sourceRoot === undefined) {
@@ -977,7 +1288,7 @@ class StaleAuditHostWorkloadError extends Error {
977
1288
  * It exists as a CLASS and not as a plain throw because of what the fold does
978
1289
  * with an uncaught error: `runHostDelegationObligation` rethrows everything that
979
1290
  * is not ENOENT, and it ingests BEFORE the one path that re-prepares
980
- * (`ensureSemanticReviewRunUnlocked` → `renderSemanticReviewStep` →
1291
+ * (`ensureSemanticReviewRunUnlocked` → the retired semantic review step →
981
1292
  * `prepareAuditHostHandoff`, the ONLY writer of this file). A bare throw
982
1293
  * therefore aborted the fold before the re-prepare, the blocked-step backstop
983
1294
  * wrote a blocked step, and every later `next-step` failed identically with the