audit-tools 0.56.2 → 0.57.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 (368) hide show
  1. package/README.md +8 -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 +2 -136
  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 +414 -1
  17. package/dist/audit/cli/dispatch/hostHandoff.d.ts.map +1 -1
  18. package/dist/audit/cli/dispatch/hostHandoff.js +223 -1
  19. package/dist/audit/cli/dispatch/hostHandoff.js.map +1 -1
  20. package/dist/audit/cli/dispatch/questionReviewAcceptance.d.ts +254 -0
  21. package/dist/audit/cli/dispatch/questionReviewAcceptance.d.ts.map +1 -0
  22. package/dist/audit/cli/dispatch/questionReviewAcceptance.js +181 -0
  23. package/dist/audit/cli/dispatch/questionReviewAcceptance.js.map +1 -0
  24. package/dist/audit/cli/functionalPreflight.d.ts +4 -4
  25. package/dist/audit/cli/laneSubmissions.d.ts +4 -4
  26. package/dist/audit/cli/nextStepCommand.d.ts +3 -20
  27. package/dist/audit/cli/nextStepCommand.d.ts.map +1 -1
  28. package/dist/audit/cli/nextStepCommand.js +39 -133
  29. package/dist/audit/cli/nextStepCommand.js.map +1 -1
  30. package/dist/audit/cli/nextStepHelpers.d.ts +10 -72
  31. package/dist/audit/cli/nextStepHelpers.d.ts.map +1 -1
  32. package/dist/audit/cli/nextStepHelpers.js +95 -363
  33. package/dist/audit/cli/nextStepHelpers.js.map +1 -1
  34. package/dist/audit/cli/prompts.d.ts +0 -2
  35. package/dist/audit/cli/prompts.d.ts.map +1 -1
  36. package/dist/audit/cli/prompts.js +3 -14
  37. package/dist/audit/cli/prompts.js.map +1 -1
  38. package/dist/audit/cli/questionReviewCycle.d.ts +239 -0
  39. package/dist/audit/cli/questionReviewCycle.d.ts.map +1 -0
  40. package/dist/audit/cli/questionReviewCycle.js +55 -0
  41. package/dist/audit/cli/questionReviewCycle.js.map +1 -0
  42. package/dist/audit/cli/questionReviewSession.d.ts +7 -0
  43. package/dist/audit/cli/questionReviewSession.d.ts.map +1 -0
  44. package/dist/audit/cli/questionReviewSession.js +46 -0
  45. package/dist/audit/cli/questionReviewSession.js.map +1 -0
  46. package/dist/audit/cli/questionWorkloadBindings.d.ts +7 -0
  47. package/dist/audit/cli/questionWorkloadBindings.d.ts.map +1 -0
  48. package/dist/audit/cli/questionWorkloadBindings.js +66 -0
  49. package/dist/audit/cli/questionWorkloadBindings.js.map +1 -0
  50. package/dist/audit/cli/resynthesizeCommand.d.ts +1 -0
  51. package/dist/audit/cli/resynthesizeCommand.d.ts.map +1 -1
  52. package/dist/audit/cli/resynthesizeCommand.js +52 -51
  53. package/dist/audit/cli/resynthesizeCommand.js.map +1 -1
  54. package/dist/audit/cli/sampleRunCommand.d.ts +565 -160
  55. package/dist/audit/cli/sampleRunCommand.d.ts.map +1 -1
  56. package/dist/audit/cli/sampleRunCommand.js +66 -152
  57. package/dist/audit/cli/sampleRunCommand.js.map +1 -1
  58. package/dist/audit/cli/statusCommand.d.ts.map +1 -1
  59. package/dist/audit/cli/statusCommand.js +20 -14
  60. package/dist/audit/cli/statusCommand.js.map +1 -1
  61. package/dist/audit/cli/steps.d.ts +10 -10
  62. package/dist/audit/cli/submitCommand.d.ts +11 -6
  63. package/dist/audit/cli/submitCommand.d.ts.map +1 -1
  64. package/dist/audit/cli/submitCommand.js +91 -24
  65. package/dist/audit/cli/submitCommand.js.map +1 -1
  66. package/dist/audit/cli.d.ts.map +1 -1
  67. package/dist/audit/cli.js +6 -17
  68. package/dist/audit/cli.js.map +1 -1
  69. package/dist/audit/contracts/findingContractPrompt.d.ts +4 -4
  70. package/dist/audit/contracts/workerSchemas.d.ts +69 -68
  71. package/dist/audit/contracts/workerSchemas.d.ts.map +1 -1
  72. package/dist/audit/contracts/workerSchemas.js +8 -1
  73. package/dist/audit/contracts/workerSchemas.js.map +1 -1
  74. package/dist/audit/contracts/wrapperResponse.d.ts +13 -13
  75. package/dist/audit/contracts/wrapperResponse.d.ts.map +1 -1
  76. package/dist/audit/contracts/wrapperResponse.js +0 -1
  77. package/dist/audit/contracts/wrapperResponse.js.map +1 -1
  78. package/dist/audit/extractors/designAssessment.js +2 -2
  79. package/dist/audit/extractors/designAssessment.js.map +1 -1
  80. package/dist/audit/io/artifacts.d.ts +31 -9
  81. package/dist/audit/io/artifacts.d.ts.map +1 -1
  82. package/dist/audit/io/artifacts.js +197 -31
  83. package/dist/audit/io/artifacts.js.map +1 -1
  84. package/dist/audit/io/rollover.d.ts.map +1 -1
  85. package/dist/audit/io/rollover.js +7 -16
  86. package/dist/audit/io/rollover.js.map +1 -1
  87. package/dist/audit/io/runSnapshot.d.ts +1 -1
  88. package/dist/audit/io/runSnapshot.js +1 -1
  89. package/dist/audit/orchestrator/architectureDiscovery.d.ts +9 -10
  90. package/dist/audit/orchestrator/architectureDiscovery.d.ts.map +1 -1
  91. package/dist/audit/orchestrator/architectureDiscovery.js +95 -13
  92. package/dist/audit/orchestrator/architectureDiscovery.js.map +1 -1
  93. package/dist/audit/orchestrator/charterPacketArchive.d.ts +3 -0
  94. package/dist/audit/orchestrator/charterPacketArchive.d.ts.map +1 -1
  95. package/dist/audit/orchestrator/charterPacketArchive.js +31 -2
  96. package/dist/audit/orchestrator/charterPacketArchive.js.map +1 -1
  97. package/dist/audit/orchestrator/dependencyMap.d.ts +2 -8
  98. package/dist/audit/orchestrator/dependencyMap.d.ts.map +1 -1
  99. package/dist/audit/orchestrator/dependencyMap.js +10 -105
  100. package/dist/audit/orchestrator/dependencyMap.js.map +1 -1
  101. package/dist/audit/orchestrator/dependencySlices.d.ts +2 -3
  102. package/dist/audit/orchestrator/dependencySlices.d.ts.map +1 -1
  103. package/dist/audit/orchestrator/dependencySlices.js +2 -35
  104. package/dist/audit/orchestrator/dependencySlices.js.map +1 -1
  105. package/dist/audit/orchestrator/designReviewPrompt.d.ts.map +1 -1
  106. package/dist/audit/orchestrator/designReviewPrompt.js +24 -14
  107. package/dist/audit/orchestrator/designReviewPrompt.js.map +1 -1
  108. package/dist/audit/orchestrator/executorRunners.d.ts +1 -1
  109. package/dist/audit/orchestrator/executorRunners.d.ts.map +1 -1
  110. package/dist/audit/orchestrator/executorRunners.js +14 -21
  111. package/dist/audit/orchestrator/executorRunners.js.map +1 -1
  112. package/dist/audit/orchestrator/executors.d.ts.map +1 -1
  113. package/dist/audit/orchestrator/executors.js +1 -131
  114. package/dist/audit/orchestrator/executors.js.map +1 -1
  115. package/dist/audit/orchestrator/flowPlanning.d.ts +1 -1
  116. package/dist/audit/orchestrator/flowPlanning.js +1 -1
  117. package/dist/audit/orchestrator/ingestionExecutors.d.ts.map +1 -1
  118. package/dist/audit/orchestrator/ingestionExecutors.js +19 -12
  119. package/dist/audit/orchestrator/ingestionExecutors.js.map +1 -1
  120. package/dist/audit/orchestrator/intentCheckpointExecutor.d.ts +2 -2
  121. package/dist/audit/orchestrator/intentCheckpointExecutor.d.ts.map +1 -1
  122. package/dist/audit/orchestrator/intentCheckpointExecutor.js +37 -36
  123. package/dist/audit/orchestrator/intentCheckpointExecutor.js.map +1 -1
  124. package/dist/audit/orchestrator/lensSelection.d.ts +6 -37
  125. package/dist/audit/orchestrator/lensSelection.d.ts.map +1 -1
  126. package/dist/audit/orchestrator/lensSelection.js +42 -68
  127. package/dist/audit/orchestrator/lensSelection.js.map +1 -1
  128. package/dist/audit/orchestrator/nextStep.d.ts.map +1 -1
  129. package/dist/audit/orchestrator/nextStep.js +1 -4
  130. package/dist/audit/orchestrator/nextStep.js.map +1 -1
  131. package/dist/audit/orchestrator/questionEvidence.d.ts +67 -0
  132. package/dist/audit/orchestrator/questionEvidence.d.ts.map +1 -0
  133. package/dist/audit/orchestrator/questionEvidence.js +177 -0
  134. package/dist/audit/orchestrator/questionEvidence.js.map +1 -0
  135. package/dist/audit/orchestrator/questionPlanExecutor.d.ts +10 -0
  136. package/dist/audit/orchestrator/questionPlanExecutor.d.ts.map +1 -0
  137. package/dist/audit/orchestrator/questionPlanExecutor.js +23 -0
  138. package/dist/audit/orchestrator/questionPlanExecutor.js.map +1 -0
  139. package/dist/audit/orchestrator/questionPlanning.d.ts +48 -0
  140. package/dist/audit/orchestrator/questionPlanning.d.ts.map +1 -0
  141. package/dist/audit/orchestrator/questionPlanning.js +326 -0
  142. package/dist/audit/orchestrator/questionPlanning.js.map +1 -0
  143. package/dist/audit/orchestrator/reviewLensPlaybooks.d.ts +11 -0
  144. package/dist/audit/orchestrator/reviewLensPlaybooks.d.ts.map +1 -0
  145. package/dist/audit/orchestrator/reviewLensPlaybooks.js +11 -0
  146. package/dist/audit/orchestrator/reviewLensPlaybooks.js.map +1 -0
  147. package/dist/audit/orchestrator/runtimeValidation.d.ts.map +1 -1
  148. package/dist/audit/orchestrator/runtimeValidation.js +14 -0
  149. package/dist/audit/orchestrator/runtimeValidation.js.map +1 -1
  150. package/dist/audit/orchestrator/runtimeValidationUpdate.d.ts +1 -1
  151. package/dist/audit/orchestrator/runtimeValidationUpdate.d.ts.map +1 -1
  152. package/dist/audit/orchestrator/runtimeValidationUpdate.js +13 -4
  153. package/dist/audit/orchestrator/runtimeValidationUpdate.js.map +1 -1
  154. package/dist/audit/orchestrator/selectiveDeepening/conflict.js +1 -1
  155. package/dist/audit/orchestrator/selectiveDeepening/conflict.js.map +1 -1
  156. package/dist/audit/orchestrator/selectiveDeepening/index.js +1 -1
  157. package/dist/audit/orchestrator/selectiveDeepening/index.js.map +1 -1
  158. package/dist/audit/orchestrator/state.d.ts.map +1 -1
  159. package/dist/audit/orchestrator/state.js +8 -60
  160. package/dist/audit/orchestrator/state.js.map +1 -1
  161. package/dist/audit/orchestrator/synthesisExecutors.d.ts +15 -1
  162. package/dist/audit/orchestrator/synthesisExecutors.d.ts.map +1 -1
  163. package/dist/audit/orchestrator/synthesisExecutors.js +76 -25
  164. package/dist/audit/orchestrator/synthesisExecutors.js.map +1 -1
  165. package/dist/audit/orchestrator/systemicChallengeExecutor.d.ts.map +1 -1
  166. package/dist/audit/orchestrator/systemicChallengeExecutor.js +11 -6
  167. package/dist/audit/orchestrator/systemicChallengeExecutor.js.map +1 -1
  168. package/dist/audit/orchestrator/taskAffinityGraph.d.ts +4 -4
  169. package/dist/audit/reporting/questionReport.d.ts +27 -0
  170. package/dist/audit/reporting/questionReport.d.ts.map +1 -0
  171. package/dist/audit/reporting/questionReport.js +183 -0
  172. package/dist/audit/reporting/questionReport.js.map +1 -0
  173. package/dist/audit/reporting/synthesis.d.ts +10 -1
  174. package/dist/audit/reporting/synthesis.d.ts.map +1 -1
  175. package/dist/audit/reporting/synthesis.js +161 -24
  176. package/dist/audit/reporting/synthesis.js.map +1 -1
  177. package/dist/audit/reporting/synthesisNarrativePrompt.d.ts +4 -1
  178. package/dist/audit/reporting/synthesisNarrativePrompt.d.ts.map +1 -1
  179. package/dist/audit/reporting/synthesisNarrativePrompt.js +5 -1
  180. package/dist/audit/reporting/synthesisNarrativePrompt.js.map +1 -1
  181. package/dist/audit/supervisor/operatorHandoff.d.ts +2 -3
  182. package/dist/audit/supervisor/operatorHandoff.d.ts.map +1 -1
  183. package/dist/audit/supervisor/operatorHandoff.js +3 -18
  184. package/dist/audit/supervisor/operatorHandoff.js.map +1 -1
  185. package/dist/audit/systemic/aggregateMetricsDigest.d.ts.map +1 -1
  186. package/dist/audit/systemic/aggregateMetricsDigest.js +0 -2
  187. package/dist/audit/systemic/aggregateMetricsDigest.js.map +1 -1
  188. package/dist/audit/types/artifactMetadata.d.ts +1 -2
  189. package/dist/audit/types/artifactMetadata.d.ts.map +1 -1
  190. package/dist/audit/types/auditState.d.ts +6 -6
  191. package/dist/audit/types/conceptualAdjudication.d.ts +708 -50
  192. package/dist/audit/types/conceptualAdjudication.d.ts.map +1 -1
  193. package/dist/audit/types/conceptualAdjudication.js +2 -0
  194. package/dist/audit/types/conceptualAdjudication.js.map +1 -1
  195. package/dist/audit/types/runtimeValidation.d.ts +58 -6
  196. package/dist/audit/types/runtimeValidation.d.ts.map +1 -1
  197. package/dist/audit/types/runtimeValidation.js +8 -0
  198. package/dist/audit/types/runtimeValidation.js.map +1 -1
  199. package/dist/audit/types.d.ts +539 -22
  200. package/dist/audit/types.d.ts.map +1 -1
  201. package/dist/audit/validation/auditResults.d.ts +1 -1
  202. package/dist/audit/validation/auditResults.js +1 -1
  203. package/dist/audit/validation/ingestIssueCodes.d.ts.map +1 -1
  204. package/dist/audit/validation/ingestIssueCodes.js +0 -1
  205. package/dist/audit/validation/ingestIssueCodes.js.map +1 -1
  206. package/dist/remediate/contractPipeline/executionPlan.d.ts +679 -52
  207. package/dist/remediate/contractPipeline/executionPlan.d.ts.map +1 -1
  208. package/dist/remediate/contractPipeline/executionPlan.js +23 -0
  209. package/dist/remediate/contractPipeline/executionPlan.js.map +1 -1
  210. package/dist/remediate/findingFilter.d.ts.map +1 -1
  211. package/dist/remediate/findingFilter.js +6 -2
  212. package/dist/remediate/findingFilter.js.map +1 -1
  213. package/dist/remediate/intake.d.ts +4 -4
  214. package/dist/remediate/phases/close.d.ts.map +1 -1
  215. package/dist/remediate/phases/close.js +15 -5
  216. package/dist/remediate/phases/close.js.map +1 -1
  217. package/dist/remediate/phases/closeVerifyAnalyzerLeads.d.ts +5 -0
  218. package/dist/remediate/phases/closeVerifyAnalyzerLeads.d.ts.map +1 -1
  219. package/dist/remediate/phases/closeVerifyAnalyzerLeads.js +37 -8
  220. package/dist/remediate/phases/closeVerifyAnalyzerLeads.js.map +1 -1
  221. package/dist/remediate/state/types.d.ts +619 -26
  222. package/dist/remediate/state/types.d.ts.map +1 -1
  223. package/dist/remediate/state/types.js +2 -1
  224. package/dist/remediate/state/types.js.map +1 -1
  225. package/dist/remediate/steps/contractPipeline.d.ts.map +1 -1
  226. package/dist/remediate/steps/contractPipeline.js +2 -0
  227. package/dist/remediate/steps/contractPipeline.js.map +1 -1
  228. package/dist/remediate/steps/contractPipelinePrompts.d.ts.map +1 -1
  229. package/dist/remediate/steps/contractPipelinePrompts.js +2 -0
  230. package/dist/remediate/steps/contractPipelinePrompts.js.map +1 -1
  231. package/dist/remediate/steps/dispatch/contractConformanceReview.d.ts +3 -3
  232. package/dist/remediate/steps/intakeResolver.d.ts.map +1 -1
  233. package/dist/remediate/steps/intakeResolver.js +31 -6
  234. package/dist/remediate/steps/intakeResolver.js.map +1 -1
  235. package/dist/remediate/steps/nextStep.d.ts.map +1 -1
  236. package/dist/remediate/steps/nextStep.js +31 -40
  237. package/dist/remediate/steps/nextStep.js.map +1 -1
  238. package/dist/remediate/steps/prompts.d.ts.map +1 -1
  239. package/dist/remediate/steps/prompts.js +3 -0
  240. package/dist/remediate/steps/prompts.js.map +1 -1
  241. package/dist/shared/analyzers/types.d.ts +18 -18
  242. package/dist/shared/contentKey.d.ts +1 -1
  243. package/dist/shared/contentKey.js +1 -1
  244. package/dist/shared/decompose/charterClarification.d.ts +4 -4
  245. package/dist/shared/decompose/charterExtraction.d.ts +30 -30
  246. package/dist/shared/decompose/contentCoherence.d.ts +1 -1
  247. package/dist/shared/decompose/contentCoherence.js +1 -1
  248. package/dist/shared/decompose/systemicChallenge.d.ts +629 -18
  249. package/dist/shared/decompose/systemicChallenge.d.ts.map +1 -1
  250. package/dist/shared/engine/obligationEngine.d.ts +2 -2
  251. package/dist/shared/index.d.ts +2 -0
  252. package/dist/shared/index.d.ts.map +1 -1
  253. package/dist/shared/index.js +2 -0
  254. package/dist/shared/index.js.map +1 -1
  255. package/dist/shared/io/stepContractWriter.js +1 -1
  256. package/dist/shared/io/stepContractWriter.js.map +1 -1
  257. package/dist/shared/loopCorePaths.d.ts.map +1 -1
  258. package/dist/shared/loopCorePaths.js +5 -2
  259. package/dist/shared/loopCorePaths.js.map +1 -1
  260. package/dist/shared/mcp/submitServer.d.ts +1 -0
  261. package/dist/shared/mcp/submitServer.d.ts.map +1 -1
  262. package/dist/shared/mcp/submitServer.js +1 -1
  263. package/dist/shared/mcp/submitServer.js.map +1 -1
  264. package/dist/shared/submission/hostResultOutcomes.js +1 -1
  265. package/dist/shared/submission/hostResultOutcomes.js.map +1 -1
  266. package/dist/shared/tooling/exec.js +1 -1
  267. package/dist/shared/tooling/exec.js.map +1 -1
  268. package/dist/shared/types/charter.d.ts +38 -38
  269. package/dist/shared/types/contractPropertyShapes.d.ts.map +1 -1
  270. package/dist/shared/types/contractPropertyShapes.js +7 -0
  271. package/dist/shared/types/contractPropertyShapes.js.map +1 -1
  272. package/dist/shared/types/executionPlan.d.ts +88 -12
  273. package/dist/shared/types/executionPlan.d.ts.map +1 -1
  274. package/dist/shared/types/executionPlan.js +1 -0
  275. package/dist/shared/types/executionPlan.js.map +1 -1
  276. package/dist/shared/types/finding.d.ts +1721 -56
  277. package/dist/shared/types/finding.d.ts.map +1 -1
  278. package/dist/shared/types/finding.js +7 -10
  279. package/dist/shared/types/finding.js.map +1 -1
  280. package/dist/shared/types/findingVocabulary.d.ts +8 -0
  281. package/dist/shared/types/findingVocabulary.d.ts.map +1 -0
  282. package/dist/shared/types/findingVocabulary.js +13 -0
  283. package/dist/shared/types/findingVocabulary.js.map +1 -0
  284. package/dist/shared/types/intentCheckpoint.d.ts +8 -3
  285. package/dist/shared/types/intentCheckpoint.d.ts.map +1 -1
  286. package/dist/shared/types/intentCheckpoint.js +4 -3
  287. package/dist/shared/types/intentCheckpoint.js.map +1 -1
  288. package/dist/shared/types/questionReviewReport.d.ts +9912 -0
  289. package/dist/shared/types/questionReviewReport.d.ts.map +1 -0
  290. package/dist/shared/types/questionReviewReport.js +185 -0
  291. package/dist/shared/types/questionReviewReport.js.map +1 -0
  292. package/dist/shared/types/remediationOutcome.d.ts +1379 -148
  293. package/dist/shared/types/remediationOutcome.d.ts.map +1 -1
  294. package/dist/shared/types/remediationOutcome.js +5 -0
  295. package/dist/shared/types/remediationOutcome.js.map +1 -1
  296. package/dist/shared/types/reviewIndependence.d.ts +24 -24
  297. package/dist/shared/types/reviewQuestion.d.ts +4359 -0
  298. package/dist/shared/types/reviewQuestion.d.ts.map +1 -0
  299. package/dist/shared/types/reviewQuestion.js +182 -0
  300. package/dist/shared/types/reviewQuestion.js.map +1 -0
  301. package/dist/shared/types/stepContract.js +1 -1
  302. package/dist/shared/types/stepContract.js.map +1 -1
  303. package/dist/shared/validation/designFindingGrounding.js +1 -1
  304. package/dist/shared/validation/designFindingGrounding.js.map +1 -1
  305. package/dist/shared/validation/findingsReport.d.ts.map +1 -1
  306. package/dist/shared/validation/findingsReport.js +19 -4
  307. package/dist/shared/validation/findingsReport.js.map +1 -1
  308. package/docs/audit-pkg/contracts.md +27 -56
  309. package/docs/audit-pkg/operator-guide.md +31 -17
  310. package/docs/audit-pkg/product.md +17 -23
  311. package/package.json +1 -1
  312. package/schemas/audit-code-v1alpha1.schema.json +0 -1
  313. package/schemas/review_submission.schema.json +514 -0
  314. package/skills/audit-code/audit-code.prompt.md +7 -5
  315. package/wrapper/audit-code-wrapper-lib.mjs +1 -5
  316. package/wrapper/installer-verb-help.mjs +1 -1
  317. package/dist/audit/cli/explainTaskCommand.d.ts +0 -4
  318. package/dist/audit/cli/explainTaskCommand.d.ts.map +0 -1
  319. package/dist/audit/cli/explainTaskCommand.js +0 -45
  320. package/dist/audit/cli/explainTaskCommand.js.map +0 -1
  321. package/dist/audit/cli/ingestResultsCommand.d.ts +0 -2
  322. package/dist/audit/cli/ingestResultsCommand.d.ts.map +0 -1
  323. package/dist/audit/cli/ingestResultsCommand.js +0 -42
  324. package/dist/audit/cli/ingestResultsCommand.js.map +0 -1
  325. package/dist/audit/cli/requeueCommand.d.ts +0 -2
  326. package/dist/audit/cli/requeueCommand.d.ts.map +0 -1
  327. package/dist/audit/cli/requeueCommand.js +0 -12
  328. package/dist/audit/cli/requeueCommand.js.map +0 -1
  329. package/dist/audit/cli/semanticReviewStep.d.ts +0 -41
  330. package/dist/audit/cli/semanticReviewStep.d.ts.map +0 -1
  331. package/dist/audit/cli/semanticReviewStep.js +0 -185
  332. package/dist/audit/cli/semanticReviewStep.js.map +0 -1
  333. package/dist/audit/cli/unacceptResultsCommand.d.ts +0 -19
  334. package/dist/audit/cli/unacceptResultsCommand.d.ts.map +0 -1
  335. package/dist/audit/cli/unacceptResultsCommand.js +0 -52
  336. package/dist/audit/cli/unacceptResultsCommand.js.map +0 -1
  337. package/dist/audit/cli/updateRuntimeValidationCommand.d.ts +0 -2
  338. package/dist/audit/cli/updateRuntimeValidationCommand.d.ts.map +0 -1
  339. package/dist/audit/cli/updateRuntimeValidationCommand.js +0 -18
  340. package/dist/audit/cli/updateRuntimeValidationCommand.js.map +0 -1
  341. package/dist/audit/cli/validateResultsCommand.d.ts +0 -13
  342. package/dist/audit/cli/validateResultsCommand.d.ts.map +0 -1
  343. package/dist/audit/cli/validateResultsCommand.js +0 -87
  344. package/dist/audit/cli/validateResultsCommand.js.map +0 -1
  345. package/dist/audit/cli/workerResult.d.ts +0 -2
  346. package/dist/audit/cli/workerResult.d.ts.map +0 -1
  347. package/dist/audit/cli/workerResult.js +0 -6
  348. package/dist/audit/cli/workerResult.js.map +0 -1
  349. package/dist/audit/orchestrator/coverageElementBaseline.d.ts +0 -54
  350. package/dist/audit/orchestrator/coverageElementBaseline.d.ts.map +0 -1
  351. package/dist/audit/orchestrator/coverageElementBaseline.js +0 -136
  352. package/dist/audit/orchestrator/coverageElementBaseline.js.map +0 -1
  353. package/dist/audit/orchestrator/planning.d.ts +0 -5
  354. package/dist/audit/orchestrator/planning.d.ts.map +0 -1
  355. package/dist/audit/orchestrator/planning.js +0 -79
  356. package/dist/audit/orchestrator/planning.js.map +0 -1
  357. package/dist/audit/orchestrator/planningExecutors.d.ts +0 -21
  358. package/dist/audit/orchestrator/planningExecutors.d.ts.map +0 -1
  359. package/dist/audit/orchestrator/planningExecutors.js +0 -273
  360. package/dist/audit/orchestrator/planningExecutors.js.map +0 -1
  361. package/dist/audit/orchestrator/taskBuilder.d.ts +0 -62
  362. package/dist/audit/orchestrator/taskBuilder.d.ts.map +0 -1
  363. package/dist/audit/orchestrator/taskBuilder.js +0 -412
  364. package/dist/audit/orchestrator/taskBuilder.js.map +0 -1
  365. package/dist/audit/orchestrator/trivialAudit.d.ts +0 -21
  366. package/dist/audit/orchestrator/trivialAudit.d.ts.map +0 -1
  367. package/dist/audit/orchestrator/trivialAudit.js +0 -80
  368. package/dist/audit/orchestrator/trivialAudit.js.map +0 -1
@@ -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.0",
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.
@@ -42,7 +42,7 @@ async function readPackageVersion() {
42
42
  // Informational flags (--help/--version) short-circuit the wrapper only when
43
43
  // they appear BEFORE the first non-flag token (the command). A whole-argv scan
44
44
  // hijacks post-command tokens that belong to the dist CLI — e.g.
45
- // `audit-code explain-task -v` printed the wrapper's version instead of
45
+ // `audit-code status -v` printed the wrapper's version instead of
46
46
  // forwarding `-v` to the dist command (CE-007).
47
47
  function hasLeadingFlag(argv, name) {
48
48
  for (const token of argv) {
@@ -242,10 +242,6 @@ function printHelp({ usageName, preferredEntrypoint }) {
242
242
  '- mcp serves the submit-only MCP tool (submit_result) over stdio',
243
243
  '- submit --work-item ID --from FILE checks one work item result and writes it to its bound path only when it passes',
244
244
  '- validate checks the current artifact bundle and canonical session intent and exits non-zero when issues exist',
245
- '- validate-results --results FILE validates AuditResult payloads against the active task manifest without ingesting them',
246
- '- explain-task <task_id> prints the resolved file coverage and current status for a task id',
247
- '- ingest-results --results FILE validates and ingests canonical AuditResult payloads',
248
- '- unaccept-results --work-item <id> (repeatable) or --all removes entries from the accepted host-results pair so a poisoned acceptance can be re-ingested after repair',
249
245
  '- status summarizes deterministic audit state and pending review work',
250
246
  '',
251
247
  'Defaults:',
@@ -6,7 +6,7 @@
6
6
  // command it owns — never sees them. That left `remediate-code install --help`
7
7
  // running the installer and writing four files, and `audit-code install --help`
8
8
  // doing the same, because audit's `hasLeadingFlag` deliberately stops at the
9
- // first non-flag token (it must, or `explain-task -v` would print the wrapper's
9
+ // first non-flag token (it must, or `status -v` would print the wrapper's
10
10
  // version instead of forwarding `-v`). Two reasonable local decisions adding up
11
11
  // to the same surprise on the commands a new operator touches first, two of
12
12
  // which write into the repository.
@@ -1,4 +0,0 @@
1
- import { type AuditArgumentContract } from "./argumentContract.js";
2
- export declare const EXPLAIN_TASK_ARGUMENTS: AuditArgumentContract;
3
- export declare function cmdExplainTask(argv: string[]): Promise<void>;
4
- //# sourceMappingURL=explainTaskCommand.d.ts.map
@@ -1 +0,0 @@
1
- {"version":3,"file":"explainTaskCommand.d.ts","sourceRoot":"","sources":["../../../src/audit/cli/explainTaskCommand.ts"],"names":[],"mappings":"AAKA,OAAO,EAA0B,KAAK,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAE3F,eAAO,MAAM,sBAAsB,EAAE,qBAEpC,CAAC;AAEF,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAgDlE"}