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
@@ -82,29 +82,43 @@ one bounded, persisted step. Useful diagnostic and recovery commands include:
82
82
 
83
83
  ```bash
84
84
  audit-code status
85
- audit-code explain-task <task_id>
86
85
  audit-code validate
87
- audit-code validate-results --results <file>
88
- audit-code requeue
89
86
  audit-code synthesize
90
87
  audit-code resynthesize
91
- audit-code unaccept-results --work-item <id> # repeatable, or --all
92
88
  audit-code cleanup --dry-run
93
89
  ```
94
90
 
95
- Lower-level `intake`, `plan`, `ingest-results`,
96
- `import-external-analyzer`, and `update-runtime-validation` commands exist for
97
- debugging and artifact recovery. Normal conversation use should stay on
98
- `next-step`.
99
-
100
- `audit-code unaccept-results` removes entries from the run's accepted
101
- host-results pair — the supported way back out of an acceptance that turned out
102
- bad and that `next-step` does not withdraw itself (it withdraws a pending
103
- task's entry that no longer validates, for example after a validator change).
104
- It refuses a
105
- pair it cannot validate, records each removal so a repaired run stays
106
- distinguishable from a clean one, invalidates the persisted step contract, and
107
- the next `next-step` re-reads the bound result files for the dropped items.
91
+ Use `audit-code plan` to prepare the question plan without dispatching review.
92
+ Submit a response to an issued question with the exact `audit-code submit`
93
+ command in its assignment. Submit validates the binding and records the result
94
+ in the current run; a refusal does not change the ledger.
95
+
96
+ The question-based machine report records current and historical accepted
97
+ answers, part-level coverage, gaps, disagreements and their recorded decisions,
98
+ and evidence identities. A report can be incomplete while carrying confirmed
99
+ defects. Findings on one part don't close another. Design opportunities and
100
+ leads are visible but are not actionable remediation findings. Consolidation
101
+ requires a recorded same-cause, same-repair decision; each source claim and
102
+ its verification obligations remain distinct.
103
+
104
+ Before finalizing the active run, use `audit-code consolidate-findings --from <path>`
105
+ only for a reviewed same-cause, same-repair decision. The JSON records a
106
+ `decision_id`, `decided_by`, a `reason`, and at least two `sources` with exact
107
+ `answer_id` and `finding_id` values from current accepted answers. Stale or
108
+ overlapping decisions are refused. This does not rewrite a finished report.
109
+
110
+ `audit-code resynthesize` regenerates Markdown only while the current question
111
+ plan and working report still own the promoted v2 machine report. It leaves
112
+ the machine JSON unchanged and requires any explicit input to match it exactly.
113
+ After rollover, retained Markdown is left intact together with its charter
114
+ and process feedback evidence.
115
+
116
+ A reported observation should say what actually ran and under what conditions.
117
+ Analyzer findings are leads, not proof that a particular behavior occurred.
118
+ Report cases you could not observe as unmeasured or inconclusive. A copied log,
119
+ an old source key, or a reviewer assertion cannot stand in for a bound execution
120
+ receipt. Accepted question answers remain in the ledger; do not edit or delete
121
+ them to hide disagreements.
108
122
 
109
123
  A completed audit keeps `.audit-tools/audit/`: the next `next-step` rolls it
110
124
  over, keeping the derived work (so only what changed is reviewed again) and the
@@ -54,13 +54,16 @@ The intended workflow is:
54
54
 
55
55
  1. The user invokes `/audit-code`.
56
56
  2. The prompt runs `audit-code ensure --quiet`.
57
- 3. Deterministic backend steps build or refresh artifacts.
58
- 4. The backend emits complete provider-neutral host work items when semantic
59
- judgment is required.
60
- 5. The active conversation assigns them through its native facilities and
61
- returns prompt-bound `AuditResult` objects.
62
- 6. The backend ingests results, performs selective deepening and runtime
63
- validation when needed, and writes the final `audit-report.md`.
57
+ 3. `audit-code next-step` builds or refreshes the artifacts and names the
58
+ current prompt to follow.
59
+ 4. When the backend emits a question review, the active conversation uses its
60
+ native review facilities (or answers itself as directed) and submits the
61
+ bound question answers.
62
+ 5. The backend accepts eligible answers, carries forward their limitations, and
63
+ emits the next step. Continue until the current prompt says to stop.
64
+ 6. The final `audit-report.md` distinguishes findings, answered questions
65
+ without findings, and incomplete evidence. A static answer does not imply that
66
+ a runtime check ran.
64
67
 
65
68
  Semantic execution belongs entirely to the active host conversation. audit-tools
66
69
  does not configure, rank, probe, instantiate, or account for execution backends;
@@ -106,23 +109,14 @@ graph with lower-confidence edges. Deterministic tool runners should be
106
109
  project-config aware — e.g. ESLint syntax-resolution runs only when the repo has
107
110
  local ESLint configuration, not merely because the binary is installed.
108
111
 
109
- ## Packet planning
112
+ ## Question planning
110
113
 
111
- `AuditTask` is the deterministic coverage identity and the host-facing unit of
112
- understanding. Planning aims for work items that read as
113
- coherent code-ownership or execution-flow units, not merely budget-sized bundles:
114
-
115
- - build packets around coherent subsystems and execution flows
116
- - keep shared fan-in files visible as context rather than merging large parts of
117
- the repo into one packet
118
- - distinguish strong (deterministic) edges from weak or heuristic ones
119
- - group tests with the code they verify when it aids review
120
- - carry packet rationale, key edges, entrypoints, and boundary files
121
- - prefer the generic ownership-root contract (analyzers naming module roots) over
122
- a new parser per ecosystem, and keep graph/manifest parsing modular
123
-
124
- Planner observability (`audit_plan_metrics.json`: cohesion, fan-in/out, boundary
125
- crossings, weak-packet gaps) is how extraction gaps are found and prioritized.
114
+ The selected lenses determine what needs to be answered. Plans attach questions
115
+ to scoped inventory and evidence, rather than treating every file as an
116
+ independent review obligation. Graph edges and ownership can help group related
117
+ evidence and point the reviewer toward callers, boundaries and tests. Suggestions
118
+ are not proof of coverage; the submitted answer records what was actually
119
+ inspected and what could not be established.
126
120
 
127
121
  ## Non-goals
128
122
 
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "audit-tools",
3
- "version": "0.56.2",
3
+ "version": "0.57.1",
4
4
  "private": false,
5
5
  "license": "ISC",
6
6
  "description": "Provider-neutral code auditing and remediation workflows for arbitrary repositories.",
@@ -136,7 +136,6 @@
136
136
  "enum": [
137
137
  "--results",
138
138
  "--batch-results",
139
- "--updates",
140
139
  "--external-analyzer-results"
141
140
  ]
142
141
  },
@@ -0,0 +1,514 @@
1
+ {
2
+ "$schema": "https://json-schema.org/draft/2020-12/schema",
3
+ "$id": "review_submission.schema.json",
4
+ "title": "Question Review Submission",
5
+ "type": "object",
6
+ "properties": {
7
+ "schema_version": {
8
+ "type": "string",
9
+ "const": "audit-tools/question-review/v1"
10
+ },
11
+ "question_id": {
12
+ "type": "string",
13
+ "minLength": 1
14
+ },
15
+ "revision_id": {
16
+ "type": "string",
17
+ "minLength": 1
18
+ },
19
+ "snapshot_id": {
20
+ "type": "string",
21
+ "minLength": 1
22
+ },
23
+ "submission_id": {
24
+ "type": "string",
25
+ "minLength": 1
26
+ },
27
+ "assignment_id": {
28
+ "type": "string",
29
+ "minLength": 1
30
+ },
31
+ "inspected_sources": {
32
+ "type": "array",
33
+ "items": {
34
+ "type": "object",
35
+ "properties": {
36
+ "path": {
37
+ "type": "string",
38
+ "minLength": 1
39
+ },
40
+ "symbol": {
41
+ "type": "string",
42
+ "minLength": 1
43
+ },
44
+ "start_line": {
45
+ "type": "integer",
46
+ "exclusiveMinimum": 0
47
+ },
48
+ "end_line": {
49
+ "type": "integer",
50
+ "exclusiveMinimum": 0
51
+ }
52
+ },
53
+ "required": [
54
+ "path"
55
+ ],
56
+ "additionalProperties": false
57
+ }
58
+ },
59
+ "evidence_ids": {
60
+ "type": "array",
61
+ "items": {
62
+ "type": "string",
63
+ "minLength": 1
64
+ }
65
+ },
66
+ "limitations": {
67
+ "type": "array",
68
+ "items": {
69
+ "type": "string",
70
+ "minLength": 1
71
+ }
72
+ },
73
+ "answer": {
74
+ "type": "object",
75
+ "properties": {
76
+ "outcome": {
77
+ "type": "string",
78
+ "enum": [
79
+ "findings",
80
+ "clean",
81
+ "inconclusive"
82
+ ]
83
+ },
84
+ "observations": {
85
+ "type": "array",
86
+ "items": {
87
+ "type": "object",
88
+ "properties": {
89
+ "schema_version": {
90
+ "type": "string",
91
+ "const": "audit-tools/question-review/v1"
92
+ },
93
+ "question_id": {
94
+ "type": "string",
95
+ "minLength": 1
96
+ },
97
+ "revision_id": {
98
+ "type": "string",
99
+ "minLength": 1
100
+ },
101
+ "snapshot_id": {
102
+ "type": "string",
103
+ "minLength": 1
104
+ },
105
+ "observation_id": {
106
+ "type": "string",
107
+ "minLength": 1
108
+ },
109
+ "part_id": {
110
+ "type": "string",
111
+ "minLength": 1
112
+ },
113
+ "kind": {
114
+ "type": "string",
115
+ "enum": [
116
+ "source_confirmed",
117
+ "runtime_observed",
118
+ "unverified"
119
+ ]
120
+ },
121
+ "statement": {
122
+ "type": "string",
123
+ "minLength": 1
124
+ },
125
+ "source_refs": {
126
+ "type": "array",
127
+ "items": {
128
+ "type": "object",
129
+ "properties": {
130
+ "path": {
131
+ "type": "string",
132
+ "minLength": 1
133
+ },
134
+ "symbol": {
135
+ "type": "string",
136
+ "minLength": 1
137
+ },
138
+ "start_line": {
139
+ "type": "integer",
140
+ "exclusiveMinimum": 0
141
+ },
142
+ "end_line": {
143
+ "type": "integer",
144
+ "exclusiveMinimum": 0
145
+ }
146
+ },
147
+ "required": [
148
+ "path"
149
+ ],
150
+ "additionalProperties": false
151
+ }
152
+ },
153
+ "evidence_refs": {
154
+ "type": "array",
155
+ "items": {
156
+ "type": "object",
157
+ "properties": {
158
+ "evidence_id": {
159
+ "type": "string",
160
+ "minLength": 1
161
+ },
162
+ "observation_id": {
163
+ "type": "string",
164
+ "minLength": 1
165
+ }
166
+ },
167
+ "required": [
168
+ "evidence_id"
169
+ ],
170
+ "additionalProperties": false
171
+ }
172
+ }
173
+ },
174
+ "required": [
175
+ "schema_version",
176
+ "question_id",
177
+ "revision_id",
178
+ "snapshot_id",
179
+ "observation_id",
180
+ "part_id",
181
+ "kind",
182
+ "statement",
183
+ "source_refs",
184
+ "evidence_refs"
185
+ ],
186
+ "additionalProperties": false
187
+ }
188
+ },
189
+ "parts": {
190
+ "type": "array",
191
+ "items": {
192
+ "type": "object",
193
+ "properties": {
194
+ "part_id": {
195
+ "type": "string",
196
+ "minLength": 1
197
+ },
198
+ "outcome": {
199
+ "type": "string",
200
+ "enum": [
201
+ "findings",
202
+ "clean",
203
+ "inconclusive"
204
+ ]
205
+ },
206
+ "observation_ids": {
207
+ "type": "array",
208
+ "items": {
209
+ "type": "string",
210
+ "minLength": 1
211
+ }
212
+ },
213
+ "reason": {
214
+ "type": "string",
215
+ "minLength": 1
216
+ }
217
+ },
218
+ "required": [
219
+ "part_id",
220
+ "outcome",
221
+ "observation_ids"
222
+ ],
223
+ "additionalProperties": false
224
+ }
225
+ },
226
+ "findings": {
227
+ "type": "array",
228
+ "items": {
229
+ "type": "object",
230
+ "properties": {
231
+ "schema_version": {
232
+ "type": "string",
233
+ "const": "audit-tools/question-review/v1"
234
+ },
235
+ "question_id": {
236
+ "type": "string",
237
+ "minLength": 1
238
+ },
239
+ "revision_id": {
240
+ "type": "string",
241
+ "minLength": 1
242
+ },
243
+ "finding_id": {
244
+ "type": "string",
245
+ "minLength": 1
246
+ },
247
+ "kind": {
248
+ "type": "string",
249
+ "enum": [
250
+ "confirmed_defect",
251
+ "design_opportunity",
252
+ "lead"
253
+ ]
254
+ },
255
+ "severity": {
256
+ "type": "string",
257
+ "enum": [
258
+ "critical",
259
+ "high",
260
+ "medium",
261
+ "low",
262
+ "info"
263
+ ]
264
+ },
265
+ "confidence": {
266
+ "type": "string",
267
+ "enum": [
268
+ "high",
269
+ "medium",
270
+ "low"
271
+ ]
272
+ },
273
+ "claim": {
274
+ "type": "string",
275
+ "minLength": 1
276
+ },
277
+ "consequence": {
278
+ "type": "string",
279
+ "minLength": 1
280
+ },
281
+ "next_step": {
282
+ "type": "string",
283
+ "minLength": 1
284
+ },
285
+ "evidence_ids": {
286
+ "type": "array",
287
+ "items": {
288
+ "type": "string",
289
+ "minLength": 1
290
+ }
291
+ },
292
+ "observation_ids": {
293
+ "type": "array",
294
+ "items": {
295
+ "type": "string",
296
+ "minLength": 1
297
+ },
298
+ "description": "To support a findings part, cite its supported observations here (including for leads and design opportunities). Confirmed defects require a linked findings part."
299
+ },
300
+ "source_refs": {
301
+ "type": "array",
302
+ "items": {
303
+ "type": "object",
304
+ "properties": {
305
+ "path": {
306
+ "type": "string",
307
+ "minLength": 1
308
+ },
309
+ "symbol": {
310
+ "type": "string",
311
+ "minLength": 1
312
+ },
313
+ "start_line": {
314
+ "type": "integer",
315
+ "exclusiveMinimum": 0
316
+ },
317
+ "end_line": {
318
+ "type": "integer",
319
+ "exclusiveMinimum": 0
320
+ }
321
+ },
322
+ "required": [
323
+ "path"
324
+ ],
325
+ "additionalProperties": false
326
+ }
327
+ },
328
+ "verification": {
329
+ "type": "array",
330
+ "items": {
331
+ "anyOf": [
332
+ {
333
+ "type": "object",
334
+ "properties": {
335
+ "kind": {
336
+ "type": "string",
337
+ "const": "analyzer"
338
+ },
339
+ "obligation_id": {
340
+ "type": "string",
341
+ "minLength": 1
342
+ },
343
+ "provenance": {
344
+ "type": "object",
345
+ "properties": {
346
+ "analyzer_id": {
347
+ "type": "string"
348
+ },
349
+ "rule": {
350
+ "type": "string"
351
+ },
352
+ "path": {
353
+ "type": "string"
354
+ },
355
+ "snippet_hash": {
356
+ "type": "string"
357
+ }
358
+ },
359
+ "required": [
360
+ "analyzer_id",
361
+ "path",
362
+ "snippet_hash"
363
+ ],
364
+ "additionalProperties": false
365
+ }
366
+ },
367
+ "required": [
368
+ "kind",
369
+ "obligation_id",
370
+ "provenance"
371
+ ],
372
+ "additionalProperties": false
373
+ },
374
+ {
375
+ "type": "object",
376
+ "properties": {
377
+ "kind": {
378
+ "type": "string",
379
+ "const": "assertion"
380
+ },
381
+ "obligation_id": {
382
+ "type": "string",
383
+ "minLength": 1
384
+ },
385
+ "expected": {
386
+ "type": "string",
387
+ "minLength": 1
388
+ },
389
+ "source_refs": {
390
+ "type": "array",
391
+ "items": {
392
+ "type": "object",
393
+ "properties": {
394
+ "path": {
395
+ "type": "string",
396
+ "minLength": 1
397
+ },
398
+ "symbol": {
399
+ "type": "string",
400
+ "minLength": 1
401
+ },
402
+ "start_line": {
403
+ "type": "integer",
404
+ "exclusiveMinimum": 0
405
+ },
406
+ "end_line": {
407
+ "type": "integer",
408
+ "exclusiveMinimum": 0
409
+ }
410
+ },
411
+ "required": [
412
+ "path"
413
+ ],
414
+ "additionalProperties": false
415
+ },
416
+ "minItems": 1
417
+ }
418
+ },
419
+ "required": [
420
+ "kind",
421
+ "obligation_id",
422
+ "expected",
423
+ "source_refs"
424
+ ],
425
+ "additionalProperties": false
426
+ },
427
+ {
428
+ "type": "object",
429
+ "properties": {
430
+ "kind": {
431
+ "type": "string",
432
+ "const": "disposition"
433
+ },
434
+ "obligation_id": {
435
+ "type": "string",
436
+ "minLength": 1
437
+ },
438
+ "disposition": {
439
+ "type": "string",
440
+ "enum": [
441
+ "implemented",
442
+ "deferred",
443
+ "rejected",
444
+ "already_fixed",
445
+ "out_of_scope"
446
+ ]
447
+ },
448
+ "reason": {
449
+ "type": "string",
450
+ "minLength": 1
451
+ }
452
+ },
453
+ "required": [
454
+ "kind",
455
+ "obligation_id",
456
+ "disposition",
457
+ "reason"
458
+ ],
459
+ "additionalProperties": false
460
+ }
461
+ ]
462
+ }
463
+ },
464
+ "purpose": {
465
+ "type": "string",
466
+ "minLength": 1
467
+ },
468
+ "divergence": {
469
+ "type": "string",
470
+ "minLength": 1
471
+ }
472
+ },
473
+ "required": [
474
+ "schema_version",
475
+ "question_id",
476
+ "revision_id",
477
+ "finding_id",
478
+ "kind",
479
+ "severity",
480
+ "confidence",
481
+ "claim",
482
+ "consequence",
483
+ "next_step",
484
+ "evidence_ids",
485
+ "source_refs",
486
+ "verification"
487
+ ],
488
+ "additionalProperties": false
489
+ }
490
+ }
491
+ },
492
+ "required": [
493
+ "outcome",
494
+ "observations",
495
+ "parts",
496
+ "findings"
497
+ ],
498
+ "additionalProperties": false
499
+ }
500
+ },
501
+ "required": [
502
+ "schema_version",
503
+ "question_id",
504
+ "revision_id",
505
+ "snapshot_id",
506
+ "submission_id",
507
+ "assignment_id",
508
+ "inspected_sources",
509
+ "evidence_ids",
510
+ "limitations",
511
+ "answer"
512
+ ],
513
+ "additionalProperties": false
514
+ }
@@ -33,11 +33,13 @@ The command prints a JSON step record. Read the prompt file at its
33
33
  `prompt_path`, then follow only that prompt. Do not inspect workload, result,
34
34
  schema, or state files unless the current prompt directs you to them.
35
35
 
36
- When the prompt emits semantic review items, run each in a separate context
37
- when the host can, else yourself, as the prompt directs. Do not send provider, model, quota,
38
- context-window, routing, or launch configuration to audit-tools. Write the
39
- prompt-bound result artifacts exactly where requested and let the next backend
40
- step validate and ingest them.
36
+ When the prompt emits bound questions, answer the issued assignments in separate
37
+ contexts when the host can, else yourself, as the prompt directs. Follow the
38
+ current prompt's submission instructions (the bound submit command or tool, or a
39
+ result path when explicitly given). Do not substitute an old per-file result or
40
+ run an archived command to fill missing evidence. If the evidence is incomplete,
41
+ state the limitation. Do not send provider, model, quota, context-window, routing,
42
+ or launch configuration to audit-tools.
41
43
 
42
44
  When a prompt says to continue, call `audit-code next-step` again and follow
43
45
  only the new `prompt_path`. Stop when the current prompt says to stop.