@openai/codex-security 0.9.1 → 0.10.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 (444) hide show
  1. package/README.md +37 -788
  2. package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
  3. package/_bundled_plugin/.mcp.json +3 -0
  4. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  5. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  6. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  7. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  8. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  9. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  10. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  12. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  13. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  14. package/_bundled_plugin/references/access-advisory.md +1 -1
  15. package/_bundled_plugin/references/artifact-storage.md +1 -1
  16. package/_bundled_plugin/references/baseline-auditor.md +18 -0
  17. package/_bundled_plugin/references/core-scan.md +5 -42
  18. package/_bundled_plugin/references/final-report.md +1 -1
  19. package/_bundled_plugin/references/focused-investigator.md +13 -0
  20. package/_bundled_plugin/references/scan-prologue.md +2 -2
  21. package/_bundled_plugin/references/scan-runtime.md +4 -2
  22. package/_bundled_plugin/references/security-guidance.md +14 -1
  23. package/_bundled_plugin/references/threat-model.md +1 -0
  24. package/_bundled_plugin/references/validate-scan-findings.md +3 -0
  25. package/_bundled_plugin/scripts/deep_scan_workbench.py +30 -12
  26. package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
  27. package/_bundled_plugin/scripts/finalize_scan_contract.py +47 -9
  28. package/_bundled_plugin/scripts/launch_codex_security_mcp +54 -16
  29. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +2 -0
  30. package/_bundled_plugin/scripts/posix_scan_local_files.py +26 -1
  31. package/_bundled_plugin/scripts/snapshot_sqlite.py +8 -2
  32. package/_bundled_plugin/scripts/windows_scan_local_files.py +216 -25
  33. package/_bundled_plugin/scripts/workbench/handoff.py +55 -25
  34. package/_bundled_plugin/scripts/workbench/storage.py +25 -5
  35. package/_bundled_plugin/scripts/workbench_cli.py +24 -2
  36. package/_bundled_plugin/scripts/workbench_constants.py +2 -0
  37. package/_bundled_plugin/scripts/workbench_db.py +257 -268
  38. package/_bundled_plugin/scripts/workbench_feedback.py +49 -4
  39. package/_bundled_plugin/scripts/workbench_native_indexes.py +226 -29
  40. package/_bundled_plugin/scripts/workbench_progress.py +159 -3
  41. package/_bundled_plugin/scripts/workbench_publication.py +2 -3
  42. package/_bundled_plugin/scripts/workbench_remediation.py +142 -2
  43. package/_bundled_plugin/scripts/workbench_saved_results.py +48 -8
  44. package/_bundled_plugin/scripts/workbench_scan_history.py +291 -134
  45. package/_bundled_plugin/scripts/workbench_scan_start.py +208 -11
  46. package/_bundled_plugin/scripts/workbench_scan_usage.py +36 -10
  47. package/_bundled_plugin/scripts/workbench_schema.py +220 -14
  48. package/_bundled_plugin/scripts/workbench_setup.py +1 -1
  49. package/_bundled_plugin/scripts/workbench_source_scopes.py +8 -0
  50. package/_bundled_plugin/scripts/workbench_target.py +486 -85
  51. package/_bundled_plugin/scripts/workbench_target_state.py +1108 -22
  52. package/_bundled_plugin/shared/workbench-history-repairs.json +64 -14
  53. package/_bundled_plugin/shared/workbench-migrations.json +66 -0
  54. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +4 -2
  55. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +2 -2
  56. package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -0
  57. package/_bundled_plugin/skills/publish-findings/SKILL.md +26 -160
  58. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
  59. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +2 -2
  60. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +3 -58
  61. package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
  62. package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
  63. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
  64. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
  65. package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
  66. package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
  67. package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
  68. package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
  69. package/bin/codex-security.mjs +2 -2
  70. package/dist/api.d.ts +7 -1
  71. package/dist/api.d.ts.map +1 -1
  72. package/dist/api.js +459 -157
  73. package/dist/api.js.map +1 -1
  74. package/dist/armorcode-findings.d.ts +9 -0
  75. package/dist/armorcode-findings.d.ts.map +1 -0
  76. package/dist/armorcode-findings.js +145 -0
  77. package/dist/armorcode-findings.js.map +1 -0
  78. package/dist/artifact-export.d.ts +2 -0
  79. package/dist/artifact-export.d.ts.map +1 -1
  80. package/dist/artifact-export.js +29 -13
  81. package/dist/artifact-export.js.map +1 -1
  82. package/dist/auth.d.ts +6 -2
  83. package/dist/auth.d.ts.map +1 -1
  84. package/dist/auth.js +33 -12
  85. package/dist/auth.js.map +1 -1
  86. package/dist/batch-cost.d.ts +18 -0
  87. package/dist/batch-cost.d.ts.map +1 -0
  88. package/dist/batch-cost.js +41 -0
  89. package/dist/batch-cost.js.map +1 -0
  90. package/dist/blackduck-findings.d.ts +1 -1
  91. package/dist/blackduck-findings.d.ts.map +1 -1
  92. package/dist/blackduck-findings.js +5 -18
  93. package/dist/blackduck-findings.js.map +1 -1
  94. package/dist/bundled-plugin.d.ts +4 -0
  95. package/dist/bundled-plugin.d.ts.map +1 -0
  96. package/dist/bundled-plugin.js +23 -0
  97. package/dist/bundled-plugin.js.map +1 -0
  98. package/dist/classify-scan-severity.d.ts +1 -1
  99. package/dist/classify-scan-severity.d.ts.map +1 -1
  100. package/dist/classify-scan-severity.js +11 -3
  101. package/dist/classify-scan-severity.js.map +1 -1
  102. package/dist/classify-severity-diagnostics.d.ts +10 -0
  103. package/dist/classify-severity-diagnostics.d.ts.map +1 -0
  104. package/dist/classify-severity-diagnostics.js +57 -0
  105. package/dist/classify-severity-diagnostics.js.map +1 -0
  106. package/dist/classify-severity-records.d.ts +4 -0
  107. package/dist/classify-severity-records.d.ts.map +1 -1
  108. package/dist/classify-severity-records.js +35 -8
  109. package/dist/classify-severity-records.js.map +1 -1
  110. package/dist/classify-severity.d.ts.map +1 -1
  111. package/dist/classify-severity.js +9 -6
  112. package/dist/classify-severity.js.map +1 -1
  113. package/dist/cli-argument.d.ts +4 -0
  114. package/dist/cli-argument.d.ts.map +1 -0
  115. package/dist/cli-argument.js +17 -0
  116. package/dist/cli-argument.js.map +1 -0
  117. package/dist/cli-help.d.ts +1 -1
  118. package/dist/cli-help.d.ts.map +1 -1
  119. package/dist/cli-help.js +71 -29
  120. package/dist/cli-help.js.map +1 -1
  121. package/dist/cli-hook.d.ts +3 -0
  122. package/dist/cli-hook.d.ts.map +1 -0
  123. package/dist/cli-hook.js +87 -0
  124. package/dist/cli-hook.js.map +1 -0
  125. package/dist/cli-integrations.d.ts +13 -0
  126. package/dist/cli-integrations.d.ts.map +1 -0
  127. package/dist/cli-integrations.js +333 -0
  128. package/dist/cli-integrations.js.map +1 -0
  129. package/dist/cli-mcp.d.ts +15 -0
  130. package/dist/cli-mcp.d.ts.map +1 -0
  131. package/dist/cli-mcp.js +178 -0
  132. package/dist/cli-mcp.js.map +1 -0
  133. package/dist/cli-token-view.d.ts +10 -0
  134. package/dist/cli-token-view.d.ts.map +1 -0
  135. package/dist/cli-token-view.js +41 -0
  136. package/dist/cli-token-view.js.map +1 -0
  137. package/dist/cli.d.ts +8 -3
  138. package/dist/cli.d.ts.map +1 -1
  139. package/dist/cli.js +1860 -903
  140. package/dist/cli.js.map +1 -1
  141. package/dist/cloud-publish.d.ts.map +1 -1
  142. package/dist/cloud-publish.js +33 -31
  143. package/dist/cloud-publish.js.map +1 -1
  144. package/dist/codex-sdk-environment.d.ts +6 -0
  145. package/dist/codex-sdk-environment.d.ts.map +1 -1
  146. package/dist/codex-sdk-environment.js +19 -0
  147. package/dist/codex-sdk-environment.js.map +1 -1
  148. package/dist/command-words.d.ts +3 -0
  149. package/dist/command-words.d.ts.map +1 -0
  150. package/dist/command-words.js +46 -0
  151. package/dist/command-words.js.map +1 -0
  152. package/dist/component-plan.d.ts.map +1 -1
  153. package/dist/component-plan.js +3 -3
  154. package/dist/component-plan.js.map +1 -1
  155. package/dist/component-scan.d.ts +3 -1
  156. package/dist/component-scan.d.ts.map +1 -1
  157. package/dist/component-scan.js +40 -7
  158. package/dist/component-scan.js.map +1 -1
  159. package/dist/config.d.ts +1 -1
  160. package/dist/config.d.ts.map +1 -1
  161. package/dist/config.js +30 -1
  162. package/dist/config.js.map +1 -1
  163. package/dist/continuum-aws.d.ts +6 -0
  164. package/dist/continuum-aws.d.ts.map +1 -0
  165. package/dist/continuum-aws.js +202 -0
  166. package/dist/continuum-aws.js.map +1 -0
  167. package/dist/continuum-collector.d.ts +44 -0
  168. package/dist/continuum-collector.d.ts.map +1 -0
  169. package/dist/continuum-collector.js +266 -0
  170. package/dist/continuum-collector.js.map +1 -0
  171. package/dist/continuum-findings.d.ts +31 -2
  172. package/dist/continuum-findings.d.ts.map +1 -1
  173. package/dist/continuum-findings.js +497 -59
  174. package/dist/continuum-findings.js.map +1 -1
  175. package/dist/contract.d.ts +1 -0
  176. package/dist/contract.d.ts.map +1 -1
  177. package/dist/contract.js +3 -0
  178. package/dist/contract.js.map +1 -1
  179. package/dist/cost.d.ts.map +1 -1
  180. package/dist/cost.js +1 -45
  181. package/dist/cost.js.map +1 -1
  182. package/dist/crowdstrike-findings.d.ts +7 -0
  183. package/dist/crowdstrike-findings.d.ts.map +1 -0
  184. package/dist/crowdstrike-findings.js +210 -0
  185. package/dist/crowdstrike-findings.js.map +1 -0
  186. package/dist/custom-validation-prompt.d.ts +1 -1
  187. package/dist/custom-validation-prompt.d.ts.map +1 -1
  188. package/dist/custom-validation-prompt.js +29 -19
  189. package/dist/custom-validation-prompt.js.map +1 -1
  190. package/dist/deduplication/local.d.ts +3 -1
  191. package/dist/deduplication/local.d.ts.map +1 -1
  192. package/dist/deduplication/local.js +8 -1
  193. package/dist/deduplication/local.js.map +1 -1
  194. package/dist/deduplication/refusal.d.ts.map +1 -1
  195. package/dist/deduplication/refusal.js +2 -1
  196. package/dist/deduplication/refusal.js.map +1 -1
  197. package/dist/deduplication/scan.d.ts +2 -0
  198. package/dist/deduplication/scan.d.ts.map +1 -1
  199. package/dist/deduplication/scan.js +24 -7
  200. package/dist/deduplication/scan.js.map +1 -1
  201. package/dist/deep-scan.d.ts.map +1 -1
  202. package/dist/deep-scan.js +16 -15
  203. package/dist/deep-scan.js.map +1 -1
  204. package/dist/endor-findings.d.ts +2 -2
  205. package/dist/endor-findings.d.ts.map +1 -1
  206. package/dist/endor-findings.js +6 -23
  207. package/dist/endor-findings.js.map +1 -1
  208. package/dist/errors.d.ts +3 -1
  209. package/dist/errors.d.ts.map +1 -1
  210. package/dist/errors.js +7 -3
  211. package/dist/errors.js.map +1 -1
  212. package/dist/executable-path.d.ts +3 -0
  213. package/dist/executable-path.d.ts.map +1 -1
  214. package/dist/executable-path.js +26 -0
  215. package/dist/executable-path.js.map +1 -1
  216. package/dist/external-findings-import.d.ts.map +1 -1
  217. package/dist/external-findings-import.js +12 -1
  218. package/dist/external-findings-import.js.map +1 -1
  219. package/dist/external-findings-local.d.ts +66 -4
  220. package/dist/external-findings-local.d.ts.map +1 -1
  221. package/dist/external-findings-local.js +258 -59
  222. package/dist/external-findings-local.js.map +1 -1
  223. package/dist/external-findings-publish.d.ts +6 -1
  224. package/dist/external-findings-publish.d.ts.map +1 -1
  225. package/dist/external-findings-publish.js +330 -1633
  226. package/dist/external-findings-publish.js.map +1 -1
  227. package/dist/external-findings-read.d.ts +11 -2
  228. package/dist/external-findings-read.d.ts.map +1 -1
  229. package/dist/external-findings-read.js +56 -53
  230. package/dist/external-findings-read.js.map +1 -1
  231. package/dist/external-findings.d.ts +1 -1
  232. package/dist/external-findings.d.ts.map +1 -1
  233. package/dist/external-findings.js +12 -1
  234. package/dist/external-findings.js.map +1 -1
  235. package/dist/external-import-contract.d.ts +6 -11
  236. package/dist/external-import-contract.d.ts.map +1 -1
  237. package/dist/external-import-contract.js +35 -177
  238. package/dist/external-import-contract.js.map +1 -1
  239. package/dist/external-import-models.d.ts +1 -1
  240. package/dist/external-import-models.d.ts.map +1 -1
  241. package/dist/external-import-models.js.map +1 -1
  242. package/dist/finding-prompt.d.ts.map +1 -1
  243. package/dist/finding-prompt.js +2 -2
  244. package/dist/finding-prompt.js.map +1 -1
  245. package/dist/github-dependabot-findings.d.ts.map +1 -1
  246. package/dist/github-dependabot-findings.js +3 -4
  247. package/dist/github-dependabot-findings.js.map +1 -1
  248. package/dist/github-findings.d.ts.map +1 -1
  249. package/dist/github-findings.js +19 -287
  250. package/dist/github-findings.js.map +1 -1
  251. package/dist/host-protocol.d.ts +6 -0
  252. package/dist/host-protocol.d.ts.map +1 -1
  253. package/dist/host-protocol.js +11 -1
  254. package/dist/host-protocol.js.map +1 -1
  255. package/dist/host-records-protocol.d.ts +2 -0
  256. package/dist/host-records-protocol.d.ts.map +1 -1
  257. package/dist/host-records-protocol.js +4 -0
  258. package/dist/host-records-protocol.js.map +1 -1
  259. package/dist/hosted-remediation.d.ts +1 -0
  260. package/dist/hosted-remediation.d.ts.map +1 -1
  261. package/dist/hosted-remediation.js +23 -3
  262. package/dist/hosted-remediation.js.map +1 -1
  263. package/dist/index.d.ts +5 -3
  264. package/dist/index.d.ts.map +1 -1
  265. package/dist/index.js +3 -1
  266. package/dist/index.js.map +1 -1
  267. package/dist/inspector-findings.d.ts.map +1 -1
  268. package/dist/inspector-findings.js +19 -35
  269. package/dist/inspector-findings.js.map +1 -1
  270. package/dist/knowledge-base.d.ts +1 -1
  271. package/dist/knowledge-base.d.ts.map +1 -1
  272. package/dist/knowledge-base.js +34 -27
  273. package/dist/knowledge-base.js.map +1 -1
  274. package/dist/linear.d.ts +11 -0
  275. package/dist/linear.d.ts.map +1 -1
  276. package/dist/linear.js.map +1 -1
  277. package/dist/local-git-metadata.d.ts +5 -2
  278. package/dist/local-git-metadata.d.ts.map +1 -1
  279. package/dist/local-git-metadata.js +8 -4
  280. package/dist/local-git-metadata.js.map +1 -1
  281. package/dist/multiscan.d.ts +4 -0
  282. package/dist/multiscan.d.ts.map +1 -1
  283. package/dist/multiscan.js +83 -39
  284. package/dist/multiscan.js.map +1 -1
  285. package/dist/opengrep-findings.d.ts +4 -2
  286. package/dist/opengrep-findings.d.ts.map +1 -1
  287. package/dist/opengrep-findings.js +39 -22
  288. package/dist/opengrep-findings.js.map +1 -1
  289. package/dist/private-finding-import.d.ts +8 -13
  290. package/dist/private-finding-import.d.ts.map +1 -1
  291. package/dist/private-finding-import.js +69 -129
  292. package/dist/private-finding-import.js.map +1 -1
  293. package/dist/project-config-schema.d.ts +2 -0
  294. package/dist/project-config-schema.d.ts.map +1 -1
  295. package/dist/project-config-schema.js +1 -0
  296. package/dist/project-config-schema.js.map +1 -1
  297. package/dist/project-config.d.ts +1 -0
  298. package/dist/project-config.d.ts.map +1 -1
  299. package/dist/project-config.js +56 -13
  300. package/dist/project-config.js.map +1 -1
  301. package/dist/prompt-files.d.ts +7 -2
  302. package/dist/prompt-files.d.ts.map +1 -1
  303. package/dist/prompt-files.js +42 -20
  304. package/dist/prompt-files.js.map +1 -1
  305. package/dist/provider-profile.d.ts.map +1 -1
  306. package/dist/provider-profile.js +4 -9
  307. package/dist/provider-profile.js.map +1 -1
  308. package/dist/publication.d.ts +1 -1
  309. package/dist/publication.d.ts.map +1 -1
  310. package/dist/publication.js.map +1 -1
  311. package/dist/record.d.ts +1 -5
  312. package/dist/record.d.ts.map +1 -1
  313. package/dist/record.js +3 -51
  314. package/dist/record.js.map +1 -1
  315. package/dist/remediation.d.ts.map +1 -1
  316. package/dist/remediation.js +3 -1
  317. package/dist/remediation.js.map +1 -1
  318. package/dist/runtime.d.ts +35 -7
  319. package/dist/runtime.d.ts.map +1 -1
  320. package/dist/runtime.js +782 -153
  321. package/dist/runtime.js.map +1 -1
  322. package/dist/saved-scan-bootstrap.d.ts +6 -1
  323. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  324. package/dist/saved-scan-bootstrap.js +267 -115
  325. package/dist/saved-scan-bootstrap.js.map +1 -1
  326. package/dist/scan-archive-path.d.ts +2 -0
  327. package/dist/scan-archive-path.d.ts.map +1 -0
  328. package/dist/scan-archive-path.js +5 -0
  329. package/dist/scan-archive-path.js.map +1 -0
  330. package/dist/scan-comparison.d.ts +20 -2
  331. package/dist/scan-comparison.d.ts.map +1 -1
  332. package/dist/scan-comparison.js +26 -5
  333. package/dist/scan-comparison.js.map +1 -1
  334. package/dist/scan-dashboard.d.ts +1 -0
  335. package/dist/scan-dashboard.d.ts.map +1 -1
  336. package/dist/scan-dashboard.js +18 -2
  337. package/dist/scan-dashboard.js.map +1 -1
  338. package/dist/scan-executor.d.ts.map +1 -1
  339. package/dist/scan-executor.js +4 -2
  340. package/dist/scan-executor.js.map +1 -1
  341. package/dist/scan-history-renderer.d.ts +1 -0
  342. package/dist/scan-history-renderer.d.ts.map +1 -1
  343. package/dist/scan-history-renderer.js +25 -9
  344. package/dist/scan-history-renderer.js.map +1 -1
  345. package/dist/scan-logs.d.ts.map +1 -1
  346. package/dist/scan-logs.js +28 -4
  347. package/dist/scan-logs.js.map +1 -1
  348. package/dist/scan-settings.d.ts +1 -0
  349. package/dist/scan-settings.d.ts.map +1 -1
  350. package/dist/scan-settings.js +1 -0
  351. package/dist/scan-settings.js.map +1 -1
  352. package/dist/scanner-import.d.ts +5 -11
  353. package/dist/scanner-import.d.ts.map +1 -1
  354. package/dist/scanner-import.js +16 -89
  355. package/dist/scanner-import.js.map +1 -1
  356. package/dist/security-policy.d.ts.map +1 -1
  357. package/dist/security-policy.js +26 -6
  358. package/dist/security-policy.js.map +1 -1
  359. package/dist/semgrep-findings.d.ts.map +1 -1
  360. package/dist/semgrep-findings.js +14 -48
  361. package/dist/semgrep-findings.js.map +1 -1
  362. package/dist/semgrep-platform-findings.d.ts +20 -70
  363. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  364. package/dist/semgrep-platform-findings.js +116 -333
  365. package/dist/semgrep-platform-findings.js.map +1 -1
  366. package/dist/severity-review.d.ts.map +1 -1
  367. package/dist/severity-review.js +1 -0
  368. package/dist/severity-review.js.map +1 -1
  369. package/dist/snyk-findings.d.ts +2 -0
  370. package/dist/snyk-findings.d.ts.map +1 -1
  371. package/dist/snyk-findings.js +5 -8
  372. package/dist/snyk-findings.js.map +1 -1
  373. package/dist/snyk-rest-findings.d.ts +3 -20
  374. package/dist/snyk-rest-findings.d.ts.map +1 -1
  375. package/dist/snyk-rest-findings.js +45 -217
  376. package/dist/snyk-rest-findings.js.map +1 -1
  377. package/dist/sonar-findings.d.ts +1 -1
  378. package/dist/sonar-findings.d.ts.map +1 -1
  379. package/dist/sonar-findings.js +2 -4
  380. package/dist/sonar-findings.js.map +1 -1
  381. package/dist/sonar-import.d.ts +3 -0
  382. package/dist/sonar-import.d.ts.map +1 -1
  383. package/dist/sonar-import.js +28 -30
  384. package/dist/sonar-import.js.map +1 -1
  385. package/dist/stored-finding-projection.d.ts +6 -0
  386. package/dist/stored-finding-projection.d.ts.map +1 -0
  387. package/dist/stored-finding-projection.js +129 -0
  388. package/dist/stored-finding-projection.js.map +1 -0
  389. package/dist/stored-findings-publication.d.ts +23 -0
  390. package/dist/stored-findings-publication.d.ts.map +1 -0
  391. package/dist/stored-findings-publication.js +169 -0
  392. package/dist/stored-findings-publication.js.map +1 -0
  393. package/dist/targets.d.ts +8 -1
  394. package/dist/targets.d.ts.map +1 -1
  395. package/dist/targets.js +103 -23
  396. package/dist/targets.js.map +1 -1
  397. package/dist/tenable-findings.d.ts +1 -4
  398. package/dist/tenable-findings.d.ts.map +1 -1
  399. package/dist/tenable-findings.js.map +1 -1
  400. package/dist/trivy-findings.d.ts.map +1 -1
  401. package/dist/trivy-findings.js +0 -11
  402. package/dist/trivy-findings.js.map +1 -1
  403. package/dist/trusted-executable.d.ts +7 -0
  404. package/dist/trusted-executable.d.ts.map +1 -1
  405. package/dist/trusted-executable.js +148 -37
  406. package/dist/trusted-executable.js.map +1 -1
  407. package/dist/value.js +3 -1
  408. package/dist/value.js.map +1 -1
  409. package/dist/veracode-findings.d.ts +1 -3
  410. package/dist/veracode-findings.d.ts.map +1 -1
  411. package/dist/veracode-findings.js +13 -38
  412. package/dist/veracode-findings.js.map +1 -1
  413. package/dist/version.d.ts +3 -1
  414. package/dist/version.d.ts.map +1 -1
  415. package/dist/version.js +184 -32
  416. package/dist/version.js.map +1 -1
  417. package/dist/wiz-findings.d.ts +2 -2
  418. package/dist/wiz-findings.d.ts.map +1 -1
  419. package/dist/wiz-findings.js +14 -92
  420. package/dist/wiz-findings.js.map +1 -1
  421. package/docs/classify-severity-records.md +30 -0
  422. package/docs/cli.md +537 -124
  423. package/docs/findings-service.md +22 -9
  424. package/docs/hosted-remediation.md +13 -4
  425. package/docs/sdk.md +918 -0
  426. package/package.json +15 -6
  427. package/schemas/external-findings.schema.json +2 -1
  428. package/schemas/project-config.schema.json +5 -0
  429. package/dist/hosted-scanner-v1.d.ts +0 -6
  430. package/dist/hosted-scanner-v1.d.ts.map +0 -1
  431. package/dist/hosted-scanner-v1.js +0 -60
  432. package/dist/hosted-scanner-v1.js.map +0 -1
  433. package/dist/reader-selection.d.ts +0 -15
  434. package/dist/reader-selection.d.ts.map +0 -1
  435. package/dist/reader-selection.js +0 -89
  436. package/dist/reader-selection.js.map +0 -1
  437. package/dist/semgrep-platform-v1.d.ts +0 -6
  438. package/dist/semgrep-platform-v1.d.ts.map +0 -1
  439. package/dist/semgrep-platform-v1.js +0 -83
  440. package/dist/semgrep-platform-v1.js.map +0 -1
  441. package/dist/snyk-rest-v1.d.ts +0 -28
  442. package/dist/snyk-rest-v1.d.ts.map +0 -1
  443. package/dist/snyk-rest-v1.js +0 -132
  444. package/dist/snyk-rest-v1.js.map +0 -1
@@ -0,0 +1,57 @@
1
+ /** Node resolves the private import only when the host activates this condition. */
2
+ export function severityDiagnosticsEnabled() {
3
+ try {
4
+ import.meta.resolve("#classify-severity-records-logs");
5
+ return true;
6
+ }
7
+ catch {
8
+ return false;
9
+ }
10
+ }
11
+ /** The host receives the CLI's original JSON lines on existing protocol writes. */
12
+ export function createSeverityDiagnostics(now) {
13
+ let records = [];
14
+ let dropped = 0;
15
+ function emit(code, ordinal) {
16
+ try {
17
+ records.push(JSON.stringify({
18
+ schema: "codex-security.classify-severity.v1",
19
+ at: new Date(now()).toISOString(),
20
+ code,
21
+ ordinal,
22
+ }));
23
+ }
24
+ catch {
25
+ dropped++;
26
+ }
27
+ }
28
+ emit("invocation_started");
29
+ return {
30
+ emit,
31
+ take(message) {
32
+ if ("error" in message) {
33
+ const error = message.error;
34
+ const cancelled = typeof error === "object" &&
35
+ error !== null &&
36
+ "code" in error &&
37
+ error.code === -32800;
38
+ emit(cancelled ? "exit_cancelled" : "exit_error");
39
+ }
40
+ else if ("result" in message) {
41
+ const result = message.result;
42
+ const completed = typeof result === "object" &&
43
+ result !== null &&
44
+ "status" in result &&
45
+ result.status === "completed";
46
+ emit(completed ? "exit_completed" : "exit_unresolved");
47
+ }
48
+ if (!records.length && !dropped)
49
+ return;
50
+ const batch = { records, dropped };
51
+ records = [];
52
+ dropped = 0;
53
+ return batch;
54
+ },
55
+ };
56
+ }
57
+ //# sourceMappingURL=classify-severity-diagnostics.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"classify-severity-diagnostics.js","sourceRoot":"","sources":["../src/classify-severity-diagnostics.ts"],"names":[],"mappings":"AAGA,oFAAoF;AACpF,MAAM,UAAU,0BAA0B;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,CAAC,iCAAiC,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,yBAAyB,CAAC,GAAiB;IACzD,IAAI,OAAO,GAAa,EAAE,CAAC;IAC3B,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,SAAS,IAAI,CAAC,IAA4B,EAAE,OAAgB;QAC1D,IAAI,CAAC;YACH,OAAO,CAAC,IAAI,CACV,IAAI,CAAC,SAAS,CAAC;gBACb,MAAM,EAAE,qCAAqC;gBAC7C,EAAE,EAAE,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE;gBACjC,IAAI;gBACJ,OAAO;aACR,CAAC,CACH,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC3B,OAAO;QACL,IAAI;QACJ,IAAI,CAAC,OAAe;YAClB,IAAI,OAAO,IAAI,OAAO,EAAE,CAAC;gBACvB,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;gBAC5B,MAAM,SAAS,GACb,OAAO,KAAK,KAAK,QAAQ;oBACzB,KAAK,KAAK,IAAI;oBACd,MAAM,IAAI,KAAK;oBACf,KAAK,CAAC,IAAI,KAAK,CAAC,KAAK,CAAC;gBACxB,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;YACpD,CAAC;iBAAM,IAAI,QAAQ,IAAI,OAAO,EAAE,CAAC;gBAC/B,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;gBAC9B,MAAM,SAAS,GACb,OAAO,MAAM,KAAK,QAAQ;oBAC1B,MAAM,KAAK,IAAI;oBACf,QAAQ,IAAI,MAAM;oBAClB,MAAM,CAAC,MAAM,KAAK,WAAW,CAAC;gBAChC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,iBAAiB,CAAC,CAAC;YACzD,CAAC;YACD,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO;gBAAE,OAAO;YACxC,MAAM,KAAK,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;YACnC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,GAAG,CAAC,CAAC;YACZ,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC","sourcesContent":["import type { SeverityDiagnosticCode } from \"./classify-severity-records.js\";\nimport type { HostDiagnosticBatch } from \"./host-protocol.js\";\n\n/** Node resolves the private import only when the host activates this condition. */\nexport function severityDiagnosticsEnabled(): boolean {\n try {\n import.meta.resolve(\"#classify-severity-records-logs\");\n return true;\n } catch {\n return false;\n }\n}\n\n/** The host receives the CLI's original JSON lines on existing protocol writes. */\nexport function createSeverityDiagnostics(now: () => number) {\n let records: string[] = [];\n let dropped = 0;\n\n function emit(code: SeverityDiagnosticCode, ordinal?: number) {\n try {\n records.push(\n JSON.stringify({\n schema: \"codex-security.classify-severity.v1\",\n at: new Date(now()).toISOString(),\n code,\n ordinal,\n }),\n );\n } catch {\n dropped++;\n }\n }\n\n emit(\"invocation_started\");\n return {\n emit,\n take(message: object): HostDiagnosticBatch | undefined {\n if (\"error\" in message) {\n const error = message.error;\n const cancelled =\n typeof error === \"object\" &&\n error !== null &&\n \"code\" in error &&\n error.code === -32800;\n emit(cancelled ? \"exit_cancelled\" : \"exit_error\");\n } else if (\"result\" in message) {\n const result = message.result;\n const completed =\n typeof result === \"object\" &&\n result !== null &&\n \"status\" in result &&\n result.status === \"completed\";\n emit(completed ? \"exit_completed\" : \"exit_unresolved\");\n }\n if (!records.length && !dropped) return;\n const batch = { records, dropped };\n records = [];\n dropped = 0;\n return batch;\n },\n };\n}\n"]}
@@ -32,7 +32,11 @@ export interface SeverityClassificationReviewRequest {
32
32
  prompt: string;
33
33
  schema: unknown;
34
34
  }
35
+ export type SeverityRecordDiagnosticCode = "input_validated" | "input_rejected" | "review_requested" | "review_accepted" | "review_failed" | "invalid_assessment" | "vote_resolved";
36
+ export type SeverityDiagnosticCode = SeverityRecordDiagnosticCode | "invocation_started" | "exit_completed" | "exit_unresolved" | "exit_error" | "exit_cancelled";
35
37
  export interface ClassifySeverityRecordsOptions {
38
+ /** Content-free operational events; omitted for ordinary SDK calls. */
39
+ onDiagnostic?: (code: SeverityRecordDiagnosticCode, ordinal?: number) => void;
36
40
  /** Independent reviews per record: integer 1–10, default 3. */
37
41
  classificationRuns?: number;
38
42
  reviewRunner: {
@@ -1 +1 @@
1
- {"version":3,"file":"classify-severity-records.d.ts","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAO9B,eAAO,MAAM,4BAA4B;;;;kBAIvC,CAAC;AAmBH,+EAA+E;AAC/E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;kBAiBpC,CAAC;AAEZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AAEF,MAAM,WAAW,mCAAmC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,yBAAyB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAC/C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC7C,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE;QACZ,GAAG,CACD,OAAO,EAAE,mCAAmC,EAC5C,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,GACjC,OAAO,CAAC,OAAO,CAAC,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,gBAAgB,EAChB,WAAW,CACZ,GAAG;IACF,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,UAAU,oBAAoB;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,MAAM,6BAA6B,GAAG,oBAAoB,GAC9D,CACI;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,2BAA2B,EAAE,CAAA;CAAE,GACnE;IACE,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,EAAE,CAAC;IAChB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,eAAe,GAAG,oBAAoB,CAAC;QAC7C,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CACJ,CAAC;AAMJ;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAqFxC"}
1
+ {"version":3,"file":"classify-severity-records.d.ts","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAO9B,eAAO,MAAM,4BAA4B;;;;kBAIvC,CAAC;AAmBH,+EAA+E;AAC/E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;kBAiBpC,CAAC;AAEZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AAEF,MAAM,WAAW,mCAAmC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,yBAAyB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAC/C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,MAAM,4BAA4B,GACpC,iBAAiB,GACjB,gBAAgB,GAChB,kBAAkB,GAClB,iBAAiB,GACjB,eAAe,GACf,oBAAoB,GACpB,eAAe,CAAC;AAEpB,MAAM,MAAM,sBAAsB,GAC9B,4BAA4B,GAC5B,oBAAoB,GACpB,gBAAgB,GAChB,iBAAiB,GACjB,YAAY,GACZ,gBAAgB,CAAC;AAErB,MAAM,WAAW,8BAA8B;IAC7C,uEAAuE;IACvE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,4BAA4B,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9E,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE;QACZ,GAAG,CACD,OAAO,EAAE,mCAAmC,EAC5C,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,GACjC,OAAO,CAAC,OAAO,CAAC,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,gBAAgB,EAChB,WAAW,CACZ,GAAG;IACF,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,UAAU,oBAAoB;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,MAAM,6BAA6B,GAAG,oBAAoB,GAC9D,CACI;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,2BAA2B,EAAE,CAAA;CAAE,GACnE;IACE,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,EAAE,CAAC;IAChB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,eAAe,GAAG,oBAAoB,CAAC;QAC7C,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CACJ,CAAC;AAmCJ;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAqFxC"}
@@ -3,6 +3,7 @@ import { defaultSeverityRubric } from "./default-severity-rubric.js";
3
3
  import { createHash, randomUUID } from "node:crypto";
4
4
  import { z } from "zod";
5
5
  import { abortable } from "./targets.js";
6
+ import { notify } from "./value.js";
6
7
  import { parseSeverityDecision, reviewSeverity, reviewRunsOption, severityDecisionSchema, severityReviewInstructions, } from "./severity-review.js";
7
8
  const text = z
8
9
  .string()
@@ -50,13 +51,8 @@ export const classifySeverityRecordsInputSchema = z
50
51
  function sha256(value) {
51
52
  return createHash("sha256").update(value, "utf8").digest("hex");
52
53
  }
53
- /**
54
- * Classify immutable host-provided reports. No filesystem, auth, local model,
55
- * repository access, retries, or persistence. The host owns those lifecycles.
56
- */
57
- export async function classifySeverityRecords(input, options) {
58
- options.signal?.throwIfAborted();
59
- const classificationRuns = reviewRunsOption.parse(options.classificationRuns);
54
+ function validateRecords(input, requestedRuns) {
55
+ const classificationRuns = reviewRunsOption.parse(requestedRuns);
60
56
  const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));
61
57
  const rubric = data.rubric ?? {
62
58
  revision: 1,
@@ -76,6 +72,29 @@ export async function classifySeverityRecords(input, options) {
76
72
  if (report.findingId !== record.id)
77
73
  throw new Error("The report findingId must equal its canonical record ID.");
78
74
  }
75
+ return { classificationRuns, data, rubric };
76
+ }
77
+ /**
78
+ * Classify immutable host-provided reports. No filesystem, auth, local model,
79
+ * repository access, retries, or persistence. The host owns those lifecycles.
80
+ */
81
+ export async function classifySeverityRecords(input, options) {
82
+ options.signal?.throwIfAborted();
83
+ const emit = (code, ordinal) => {
84
+ if ("onDiagnostic" in options)
85
+ notify(() => options.onDiagnostic?.(code, ordinal));
86
+ options.signal?.throwIfAborted();
87
+ };
88
+ let validated;
89
+ try {
90
+ validated = validateRecords(input, options.classificationRuns);
91
+ }
92
+ catch (error) {
93
+ emit("input_rejected");
94
+ throw error;
95
+ }
96
+ const { classificationRuns, data, rubric } = validated;
97
+ emit("input_validated");
79
98
  const binding = {
80
99
  classificationRuns,
81
100
  version: 1,
@@ -84,11 +103,15 @@ export async function classifySeverityRecords(input, options) {
84
103
  const assessments = [];
85
104
  for (const record of data.records) {
86
105
  options.signal?.throwIfAborted();
106
+ let ordinal = 0;
87
107
  let code = "review_failed";
88
108
  try {
89
109
  const { findingId: _findingId, ...decision } = await reviewSeverity(async () => {
90
110
  code = "review_failed";
91
111
  const response = await abortable(() => {
112
+ options.signal?.throwIfAborted();
113
+ ordinal++;
114
+ emit("review_requested", ordinal);
92
115
  options.signal?.throwIfAborted();
93
116
  return options.reviewRunner.run({
94
117
  requestId: randomUUID(),
@@ -102,9 +125,12 @@ export async function classifySeverityRecords(input, options) {
102
125
  }, options.signal);
103
126
  options.signal?.throwIfAborted();
104
127
  code = "invalid_assessment";
105
- return parseSeverityDecision(response, record.id);
128
+ const decision = parseSeverityDecision(response, record.id);
129
+ emit("review_accepted", ordinal);
130
+ return decision;
106
131
  }, classificationRuns);
107
132
  options.signal?.throwIfAborted();
133
+ emit("vote_resolved");
108
134
  assessments.push({
109
135
  ...decision,
110
136
  id: record.id,
@@ -114,6 +140,7 @@ export async function classifySeverityRecords(input, options) {
114
140
  }
115
141
  catch (error) {
116
142
  options.signal?.throwIfAborted();
143
+ emit(code, ordinal);
117
144
  return {
118
145
  ...binding,
119
146
  status: "unresolved",
@@ -1 +1 @@
1
- {"version":3,"file":"classify-severity-records.js","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"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","sourcesContent":["import { SCAN_SEVERITIES } from \"./scan-settings.js\";\nimport { defaultSeverityRubric } from \"./default-severity-rubric.js\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { z } from \"zod\";\nimport { abortable } from \"./targets.js\";\nimport {\n parseSeverityDecision,\n reviewSeverity,\n reviewRunsOption,\n severityDecisionSchema,\n severityReviewInstructions,\n type SeverityDecision,\n} from \"./severity-review.js\";\n\nconst text = z\n .string()\n .refine((value) => value.trim().length > 0, \"Must not be blank.\");\nconst digest = z.string().regex(/^[a-f0-9]{64}$/u);\nconst revision = z.number().int().nonnegative();\nexport const severityRubricSnapshotSchema = z.strictObject({\n revision: revision.positive(),\n markdown: text,\n sha256: digest,\n});\n\nconst reportSchema = z\n .object({\n findingId: text,\n title: text,\n summary: text,\n occurrenceId: text.optional(),\n severity: z\n .object({\n level: z.enum(SCAN_SEVERITIES),\n rationale: z.string().optional(),\n changeConditions: z.string().optional(),\n })\n .passthrough()\n .optional(),\n })\n .passthrough();\n\n/** Versioned input for repository-free classification of canonical records. */\nexport const classifySeverityRecordsInputSchema = z\n .object({\n version: z.literal(1),\n rubric: severityRubricSnapshotSchema.optional(),\n model: text,\n effort: z.string(),\n records: z.array(\n z\n .object({\n id: text,\n revision,\n findingJson: text,\n inputSha256: digest,\n })\n .strict(),\n ),\n })\n .strict();\n\nexport type ClassifySeverityRecordsInput = z.infer<\n typeof classifySeverityRecordsInputSchema\n>;\n\nexport interface SeverityClassificationReviewRequest {\n requestId: string;\n stage: \"severity-classification\";\n model: string;\n effort: ClassifySeverityRecordsInput[\"effort\"];\n trustedInstructions: string;\n prompt: string;\n schema: unknown;\n}\n\nexport interface ClassifySeverityRecordsOptions {\n /** Independent reviews per record: integer 1–10, default 3. */\n classificationRuns?: number;\n reviewRunner: {\n run(\n request: SeverityClassificationReviewRequest,\n options?: { signal?: AbortSignal },\n ): Promise<unknown>;\n };\n signal?: AbortSignal;\n}\n\nexport type CanonicalSeverityAssessment = Omit<\n SeverityDecision,\n \"findingId\"\n> & {\n id: string;\n revision: number;\n inputSha256: string;\n};\n\ninterface RecordsResultBinding {\n classificationRuns: number;\n version: 1;\n rubric: { revision: number; sha256: string };\n}\n\nexport type ClassifySeverityRecordsResult = RecordsResultBinding &\n (\n | { status: \"completed\"; assessments: CanonicalSeverityAssessment[] }\n | {\n status: \"unresolved\";\n assessments: [];\n error: {\n recordId: string;\n code: \"review_failed\" | \"invalid_assessment\";\n message: string;\n };\n }\n );\n\nfunction sha256(value: string): string {\n return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\n/**\n * Classify immutable host-provided reports. No filesystem, auth, local model,\n * repository access, retries, or persistence. The host owns those lifecycles.\n */\nexport async function classifySeverityRecords(\n input: ClassifySeverityRecordsInput,\n options: ClassifySeverityRecordsOptions,\n): Promise<ClassifySeverityRecordsResult> {\n options.signal?.throwIfAborted();\n const classificationRuns = reviewRunsOption.parse(options.classificationRuns);\n const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));\n const rubric = data.rubric ?? {\n revision: 1,\n markdown: defaultSeverityRubric,\n sha256: sha256(defaultSeverityRubric),\n };\n if (sha256(rubric.markdown) !== rubric.sha256)\n throw new Error(\"Rubric SHA-256 does not match its exact UTF-8 Markdown.\");\n const ids = new Set<string>();\n for (const record of data.records) {\n if (ids.has(record.id))\n throw new Error(\"Canonical record IDs must be unique.\");\n ids.add(record.id);\n if (sha256(record.findingJson) !== record.inputSha256)\n throw new Error(\"Finding SHA-256 does not match its exact UTF-8 JSON.\");\n const report = reportSchema.parse(JSON.parse(record.findingJson));\n if (report.findingId !== record.id)\n throw new Error(\n \"The report findingId must equal its canonical record ID.\",\n );\n }\n const binding: RecordsResultBinding = {\n classificationRuns,\n version: 1,\n rubric: { revision: rubric.revision, sha256: rubric.sha256 },\n };\n const assessments: CanonicalSeverityAssessment[] = [];\n for (const record of data.records) {\n options.signal?.throwIfAborted();\n let code: \"review_failed\" | \"invalid_assessment\" = \"review_failed\";\n try {\n const { findingId: _findingId, ...decision } = await reviewSeverity(\n async () => {\n code = \"review_failed\";\n const response = await abortable(() => {\n options.signal?.throwIfAborted();\n return options.reviewRunner.run(\n {\n requestId: randomUUID(),\n stage: \"severity-classification\",\n model: data.model,\n effort: data.effort,\n trustedInstructions: severityReviewInstructions,\n prompt: `{\"rubric\":${JSON.stringify([rubric.markdown])},\"knowledgeBase\":null,\"finding\":${record.findingJson}}`,\n schema: z.toJSONSchema(severityDecisionSchema),\n },\n { signal: options.signal },\n );\n }, options.signal);\n options.signal?.throwIfAborted();\n code = \"invalid_assessment\";\n return parseSeverityDecision(response, record.id);\n },\n classificationRuns,\n );\n options.signal?.throwIfAborted();\n assessments.push({\n ...decision,\n id: record.id,\n revision: record.revision,\n inputSha256: record.inputSha256,\n });\n } catch (error) {\n options.signal?.throwIfAborted();\n return {\n ...binding,\n status: \"unresolved\",\n assessments: [],\n error: {\n recordId: record.id,\n code,\n message:\n error instanceof Error\n ? error.message\n : code === \"review_failed\"\n ? \"Host review failed.\"\n : \"Invalid assessment.\",\n },\n };\n }\n }\n return { ...binding, status: \"completed\", assessments };\n}\n"]}
1
+ {"version":3,"file":"classify-severity-records.js","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AACpC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,gBAAgB,EAChB,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,IAAI,GAAG,CAAC;KACX,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,oBAAoB,CAAC,CAAC;AACpE,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACnD,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;AAChD,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,YAAY,CAAC;IACzD,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,IAAI;IACd,MAAM,EAAE,MAAM;CACf,CAAC,CAAC;AAEH,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,CAAC;IACN,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;QAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACxC,CAAC;SACD,WAAW,EAAE;SACb,QAAQ,EAAE;CACd,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC;KAChD,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,4BAA4B,CAAC,QAAQ,EAAE;IAC/C,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC;SACE,MAAM,CAAC;QACN,EAAE,EAAE,IAAI;QACR,QAAQ;QACR,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,MAAM;KACpB,CAAC;SACD,MAAM,EAAE,CACZ;CACF,CAAC;KACD,MAAM,EAAE,CAAC;AA4EZ,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED,SAAS,eAAe,CACtB,KAAmC,EACnC,aAAsB;IAEtB,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,kCAAkC,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI;QAC5B,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,qBAAqB;QAC/B,MAAM,EAAE,MAAM,CAAC,qBAAqB,CAAC;KACtC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,MAAM;QAC3C,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,MAAM,CAAC,WAAW;YACnD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,EAAE;YAChC,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;IACN,CAAC;IACD,OAAO,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AAC9C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAmC,EACnC,OAAuC;IAEvC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,IAAI,GAAG,CAAC,IAAkC,EAAE,OAAgB,EAAE,EAAE;QACpE,IAAI,cAAc,IAAI,OAAO;YAC3B,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;QACtD,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACnC,CAAC,CAAC;IACF,IAAI,SAA6C,CAAC;IAClD,IAAI,CAAC;QACH,SAAS,GAAG,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACjE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,gBAAgB,CAAC,CAAC;QACvB,MAAM,KAAK,CAAC;IACd,CAAC;IACD,MAAM,EAAE,kBAAkB,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,SAAS,CAAC;IACvD,IAAI,CAAC,iBAAiB,CAAC,CAAC;IACxB,MAAM,OAAO,GAAyB;QACpC,kBAAkB;QAClB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;KAC7D,CAAC;IACF,MAAM,WAAW,GAAkC,EAAE,CAAC;IACtD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,IAAI,IAAI,GAA2C,eAAe,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,cAAc,CACjE,KAAK,IAAI,EAAE;gBACT,IAAI,GAAG,eAAe,CAAC;gBACvB,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;oBACpC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;oBACjC,OAAO,EAAE,CAAC;oBACV,IAAI,CAAC,kBAAkB,EAAE,OAAO,CAAC,CAAC;oBAClC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;oBACjC,OAAO,OAAO,CAAC,YAAY,CAAC,GAAG,CAC7B;wBACE,SAAS,EAAE,UAAU,EAAE;wBACvB,KAAK,EAAE,yBAAyB;wBAChC,KAAK,EAAE,IAAI,CAAC,KAAK;wBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,mBAAmB,EAAE,0BAA0B;wBAC/C,MAAM,EAAE,aAAa,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,mCAAmC,MAAM,CAAC,WAAW,GAAG;wBAC9G,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,sBAAsB,CAAC;qBAC/C,EACD,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;gBACJ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;gBACjC,IAAI,GAAG,oBAAoB,CAAC;gBAC5B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;gBAC5D,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;gBACjC,OAAO,QAAQ,CAAC;YAClB,CAAC,EACD,kBAAkB,CACnB,CAAC;YACF,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,IAAI,CAAC,eAAe,CAAC,CAAC;YACtB,WAAW,CAAC,IAAI,CAAC;gBACf,GAAG,QAAQ;gBACX,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YACpB,OAAO;gBACL,GAAG,OAAO;gBACV,MAAM,EAAE,YAAY;gBACpB,WAAW,EAAE,EAAE;gBACf,KAAK,EAAE;oBACL,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,IAAI;oBACJ,OAAO,EACL,KAAK,YAAY,KAAK;wBACpB,CAAC,CAAC,KAAK,CAAC,OAAO;wBACf,CAAC,CAAC,IAAI,KAAK,eAAe;4BACxB,CAAC,CAAC,qBAAqB;4BACvB,CAAC,CAAC,qBAAqB;iBAC9B;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAC1D,CAAC","sourcesContent":["import { SCAN_SEVERITIES } from \"./scan-settings.js\";\nimport { defaultSeverityRubric } from \"./default-severity-rubric.js\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { z } from \"zod\";\nimport { abortable } from \"./targets.js\";\nimport { notify } from \"./value.js\";\nimport {\n parseSeverityDecision,\n reviewSeverity,\n reviewRunsOption,\n severityDecisionSchema,\n severityReviewInstructions,\n type SeverityDecision,\n} from \"./severity-review.js\";\n\nconst text = z\n .string()\n .refine((value) => value.trim().length > 0, \"Must not be blank.\");\nconst digest = z.string().regex(/^[a-f0-9]{64}$/u);\nconst revision = z.number().int().nonnegative();\nexport const severityRubricSnapshotSchema = z.strictObject({\n revision: revision.positive(),\n markdown: text,\n sha256: digest,\n});\n\nconst reportSchema = z\n .object({\n findingId: text,\n title: text,\n summary: text,\n occurrenceId: text.optional(),\n severity: z\n .object({\n level: z.enum(SCAN_SEVERITIES),\n rationale: z.string().optional(),\n changeConditions: z.string().optional(),\n })\n .passthrough()\n .optional(),\n })\n .passthrough();\n\n/** Versioned input for repository-free classification of canonical records. */\nexport const classifySeverityRecordsInputSchema = z\n .object({\n version: z.literal(1),\n rubric: severityRubricSnapshotSchema.optional(),\n model: text,\n effort: z.string(),\n records: z.array(\n z\n .object({\n id: text,\n revision,\n findingJson: text,\n inputSha256: digest,\n })\n .strict(),\n ),\n })\n .strict();\n\nexport type ClassifySeverityRecordsInput = z.infer<\n typeof classifySeverityRecordsInputSchema\n>;\n\nexport interface SeverityClassificationReviewRequest {\n requestId: string;\n stage: \"severity-classification\";\n model: string;\n effort: ClassifySeverityRecordsInput[\"effort\"];\n trustedInstructions: string;\n prompt: string;\n schema: unknown;\n}\n\nexport type SeverityRecordDiagnosticCode =\n | \"input_validated\"\n | \"input_rejected\"\n | \"review_requested\"\n | \"review_accepted\"\n | \"review_failed\"\n | \"invalid_assessment\"\n | \"vote_resolved\";\n\nexport type SeverityDiagnosticCode =\n | SeverityRecordDiagnosticCode\n | \"invocation_started\"\n | \"exit_completed\"\n | \"exit_unresolved\"\n | \"exit_error\"\n | \"exit_cancelled\";\n\nexport interface ClassifySeverityRecordsOptions {\n /** Content-free operational events; omitted for ordinary SDK calls. */\n onDiagnostic?: (code: SeverityRecordDiagnosticCode, ordinal?: number) => void;\n /** Independent reviews per record: integer 1–10, default 3. */\n classificationRuns?: number;\n reviewRunner: {\n run(\n request: SeverityClassificationReviewRequest,\n options?: { signal?: AbortSignal },\n ): Promise<unknown>;\n };\n signal?: AbortSignal;\n}\n\nexport type CanonicalSeverityAssessment = Omit<\n SeverityDecision,\n \"findingId\"\n> & {\n id: string;\n revision: number;\n inputSha256: string;\n};\n\ninterface RecordsResultBinding {\n classificationRuns: number;\n version: 1;\n rubric: { revision: number; sha256: string };\n}\n\nexport type ClassifySeverityRecordsResult = RecordsResultBinding &\n (\n | { status: \"completed\"; assessments: CanonicalSeverityAssessment[] }\n | {\n status: \"unresolved\";\n assessments: [];\n error: {\n recordId: string;\n code: \"review_failed\" | \"invalid_assessment\";\n message: string;\n };\n }\n );\n\nfunction sha256(value: string): string {\n return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\nfunction validateRecords(\n input: ClassifySeverityRecordsInput,\n requestedRuns?: number,\n) {\n const classificationRuns = reviewRunsOption.parse(requestedRuns);\n const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));\n const rubric = data.rubric ?? {\n revision: 1,\n markdown: defaultSeverityRubric,\n sha256: sha256(defaultSeverityRubric),\n };\n if (sha256(rubric.markdown) !== rubric.sha256)\n throw new Error(\"Rubric SHA-256 does not match its exact UTF-8 Markdown.\");\n const ids = new Set<string>();\n for (const record of data.records) {\n if (ids.has(record.id))\n throw new Error(\"Canonical record IDs must be unique.\");\n ids.add(record.id);\n if (sha256(record.findingJson) !== record.inputSha256)\n throw new Error(\"Finding SHA-256 does not match its exact UTF-8 JSON.\");\n const report = reportSchema.parse(JSON.parse(record.findingJson));\n if (report.findingId !== record.id)\n throw new Error(\n \"The report findingId must equal its canonical record ID.\",\n );\n }\n return { classificationRuns, data, rubric };\n}\n\n/**\n * Classify immutable host-provided reports. No filesystem, auth, local model,\n * repository access, retries, or persistence. The host owns those lifecycles.\n */\nexport async function classifySeverityRecords(\n input: ClassifySeverityRecordsInput,\n options: ClassifySeverityRecordsOptions,\n): Promise<ClassifySeverityRecordsResult> {\n options.signal?.throwIfAborted();\n const emit = (code: SeverityRecordDiagnosticCode, ordinal?: number) => {\n if (\"onDiagnostic\" in options)\n notify(() => options.onDiagnostic?.(code, ordinal));\n options.signal?.throwIfAborted();\n };\n let validated: ReturnType<typeof validateRecords>;\n try {\n validated = validateRecords(input, options.classificationRuns);\n } catch (error) {\n emit(\"input_rejected\");\n throw error;\n }\n const { classificationRuns, data, rubric } = validated;\n emit(\"input_validated\");\n const binding: RecordsResultBinding = {\n classificationRuns,\n version: 1,\n rubric: { revision: rubric.revision, sha256: rubric.sha256 },\n };\n const assessments: CanonicalSeverityAssessment[] = [];\n for (const record of data.records) {\n options.signal?.throwIfAborted();\n let ordinal = 0;\n let code: \"review_failed\" | \"invalid_assessment\" = \"review_failed\";\n try {\n const { findingId: _findingId, ...decision } = await reviewSeverity(\n async () => {\n code = \"review_failed\";\n const response = await abortable(() => {\n options.signal?.throwIfAborted();\n ordinal++;\n emit(\"review_requested\", ordinal);\n options.signal?.throwIfAborted();\n return options.reviewRunner.run(\n {\n requestId: randomUUID(),\n stage: \"severity-classification\",\n model: data.model,\n effort: data.effort,\n trustedInstructions: severityReviewInstructions,\n prompt: `{\"rubric\":${JSON.stringify([rubric.markdown])},\"knowledgeBase\":null,\"finding\":${record.findingJson}}`,\n schema: z.toJSONSchema(severityDecisionSchema),\n },\n { signal: options.signal },\n );\n }, options.signal);\n options.signal?.throwIfAborted();\n code = \"invalid_assessment\";\n const decision = parseSeverityDecision(response, record.id);\n emit(\"review_accepted\", ordinal);\n return decision;\n },\n classificationRuns,\n );\n options.signal?.throwIfAborted();\n emit(\"vote_resolved\");\n assessments.push({\n ...decision,\n id: record.id,\n revision: record.revision,\n inputSha256: record.inputSha256,\n });\n } catch (error) {\n options.signal?.throwIfAborted();\n emit(code, ordinal);\n return {\n ...binding,\n status: \"unresolved\",\n assessments: [],\n error: {\n recordId: record.id,\n code,\n message:\n error instanceof Error\n ? error.message\n : code === \"review_failed\"\n ? \"Host review failed.\"\n : \"Invalid assessment.\",\n },\n };\n }\n }\n return { ...binding, status: \"completed\", assessments };\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"classify-severity.d.ts","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,IAAI,cAAc,EAMzC,MAAM,sBAAsB,CAAC;AAG9B,4EAA4E;AAC5E,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,OAAO,EACP,WAAW,GAAG,OAAO,GAAG,SAAS,CAClC,GACC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAAC,CAAC,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1B,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CACnD,oBAAoB,EAClB,QAAQ,GACR,aAAa,GACb,OAAO,GACP,iBAAiB,GACjB,QAAQ,GACR,kBAAkB,CACrB;IACC,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAGxC;AAED,MAAM,WAAW,kBAAmB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC;IACxE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,mBAAmB,GAAG,QAAQ,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,CAAC,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2GAA2G;IAC3G,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oGAAoG;IACpG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AA0CD,yFAAyF;AACzF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,EAClD,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAEjC"}
1
+ {"version":3,"file":"classify-severity.d.ts","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAKxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,IAAI,cAAc,EAMzC,MAAM,sBAAsB,CAAC;AAG9B,4EAA4E;AAC5E,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,OAAO,EACP,WAAW,GAAG,OAAO,GAAG,SAAS,CAClC,GACC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAAC,CAAC,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1B,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CACnD,oBAAoB,EAClB,QAAQ,GACR,aAAa,GACb,OAAO,GACP,iBAAiB,GACjB,QAAQ,GACR,kBAAkB,CACrB;IACC,0EAA0E;IAC1E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAGxC;AAED,MAAM,WAAW,kBAAmB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC;IACxE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,mBAAmB,GAAG,QAAQ,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,CAAC,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,2GAA2G;IAC3G,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,oGAAoG;IACpG,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AA0CD,yFAAyF;AACzF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,EAClD,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAEjC"}
@@ -4,7 +4,7 @@ import { findingEntry } from "./value.js";
4
4
  import { z } from "zod";
5
5
  import { CodexSecurityError } from "./errors.js";
6
6
  import { workflowDigest } from "./finding-workflow.js";
7
- import { readKnowledgeBaseDocuments } from "./knowledge-base.js";
7
+ import { readKnowledgeBaseSnapshot } from "./knowledge-base.js";
8
8
  import { runReadOnlyCodex, } from "./scan-comparison.js";
9
9
  import { severityDecisionSchema as decisionSchema, severityReviewInstructions, parseSeverityDecision, reviewSeverity, classificationRunsSchema, reviewRunsOption, } from "./severity-review.js";
10
10
  import { CODEX_SECURITY_THREAD_SOURCES } from "./thread-source.js";
@@ -32,7 +32,7 @@ export async function classifySeverity(findings, options = {}) {
32
32
  return classifySeverityInternal(findings, options);
33
33
  }
34
34
  /** @internal */
35
- export async function classifySeverityInternal(findings, options = {}, surface = "sdk", checkpoint) {
35
+ export async function classifySeverityInternal(findings, options = {}, surface = "sdk", checkpoint, roots) {
36
36
  options.signal?.throwIfAborted();
37
37
  const classificationRuns = reviewRunsOption.parse(options.classificationRuns);
38
38
  const ids = new Set();
@@ -49,10 +49,10 @@ export async function classifySeverityInternal(findings, options = {}, surface =
49
49
  rubric = [defaultRubric.markdown];
50
50
  }
51
51
  else {
52
- rubric = await readDocuments([options.rubricPath], options.signal);
52
+ rubric = await readDocuments([options.rubricPath], options.signal, roots);
53
53
  }
54
54
  const knowledge = options.knowledgeBasePaths?.length
55
- ? await readDocuments(options.knowledgeBasePaths, options.signal)
55
+ ? await readDocuments(options.knowledgeBasePaths, options.signal, roots)
56
56
  : null;
57
57
  const rubricCheckpointSha256 = workflowDigest(rubric);
58
58
  const metadata = {
@@ -117,8 +117,11 @@ export async function classifySeverityInternal(findings, options = {}, surface =
117
117
  options.signal?.throwIfAborted();
118
118
  return result;
119
119
  }
120
- async function readDocuments(paths, signal) {
121
- const contents = await readKnowledgeBaseDocuments(paths, signal);
120
+ async function readDocuments(paths, signal, roots) {
121
+ const { documents } = await readKnowledgeBaseSnapshot(paths, signal, roots);
122
+ const contents = Object.keys(documents)
123
+ .sort()
124
+ .map((name) => documents[name]);
122
125
  if (contents.every((text) => !text.trim())) {
123
126
  throw new CodexSecurityError("Classification documents must not be empty.");
124
127
  }
@@ -1 +1 @@
1
- {"version":3,"file":"classify-severity.js","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EACL,wBAAwB,GAEzB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,EACL,gBAAgB,GAEjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,IAAI,cAAc,EACxC,0BAA0B,EAC1B,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,gBAAgB,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,6BAA6B,EAAE,MAAM,oBAAoB,CAAC;AAkEnE,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,EAAE;KACR,GAAG,CAAC,CAAC,CAAC;KACN,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AAC9C,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACzD,gBAAgB;AAChB,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAAC,CAAC,YAAY,CAAC;IACzD,aAAa,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAC3B,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,kBAAkB,EAAE,wBAAwB,CAAC,QAAQ,EAAE;IACvD,YAAY,EAAE,YAAY,CAAC,QAAQ,EAAE;IACrC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACtD,mBAAmB,EAAE,YAAY,CAAC,QAAQ,EAAE;IAC5C,WAAW,EAAE,CAAC,CAAC,KAAK,CAClB,cAAc,CAAC,MAAM,CAAC;QACpB,YAAY,EAAE,UAAU,CAAC,QAAQ,EAAE;QACnC,WAAW,EAAE,YAAY;QACzB,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,mBAAmB,EAAE,QAAQ,CAAC,CAAC;KAChD,CAAC,CACH;CACF,CAA6C,CAAC;AAE/C,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAkD,EAClD,OAAO,GAA4B,EAAE;IAErC,OAAO,wBAAwB,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,gBAAgB;AAChB,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,QAAkD,EAClD,OAAO,GAA4B,EAAE,EACrC,OAAO,GAAkB,KAAK,EAC9B,UAA6C;IAE7C,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,kBAAkB,GAAG,gBAAgB,CAAC,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IAC9E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,kBAAkB,CAC1B,sDAAsD,CACvD,CAAC;QACJ,CAAC;QACD,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7B,CAAC;IACD,IAAI,MAAgB,CAAC;IACrB,IAAI,aAAiD,CAAC;IACtD,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,aAAa,GAAG,MAAM,wBAAwB,CAAC,OAAO,CAAC,CAAC;QACxD,MAAM,GAAG,CAAC,aAAa,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;SAAM,CAAC;QACN,MAAM,GAAG,MAAM,aAAa,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IACrE,CAAC;IACD,MAAM,SAAS,GAAG,OAAO,CAAC,kBAAkB,EAAE,MAAM;QAClD,CAAC,CAAC,MAAM,aAAa,CAAC,OAAO,CAAC,kBAAkB,EAAE,OAAO,CAAC,MAAM,CAAC;QACjE,CAAC,CAAC,IAAI,CAAC;IACT,MAAM,sBAAsB,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACtD,MAAM,QAAQ,GAAG;QACf,aAAa,EAAE,CAAU;QACzB,kBAAkB;QAClB,UAAU,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACpC,GAAG,CAAC,aAAa;YACf,CAAC,CAAC;gBACE,YAAY,EAAE,aAAa,CAAC,MAAM;gBAClC,cAAc,EAAE,aAAa,CAAC,QAAQ;aACvC;YACH,CAAC,CAAC;gBACE,YAAY,EACV,MAAM,CAAC,MAAM,KAAK,CAAC;oBACjB,CAAC,CAAC,IAAI,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,CAAE,CAAC;oBAC5B,CAAC,CAAC,sBAAsB;aAC7B,CAAC;QACN,mBAAmB,EAAE,SAAS,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAAC;KAC3E,CAAC;IACF,MAAM,MAAM,GAA2B,EAAE,GAAG,QAAQ,EAAE,WAAW,EAAE,EAAE,EAAE,CAAC;IACxE,MAAM,OAAO,GAAG,EAAE,GAAG,QAAQ,EAAE,sBAAsB,EAAE,CAAC;IACxD,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,UAAU,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IAC7E,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,MAAM,WAAW,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;QAC/C,IAAI,QAAQ,EAAE,WAAW,KAAK,WAAW,EAAE,CAAC;YAC1C,8BAA8B,CAAC,EAAE,GAAG,MAAM,EAAE,WAAW,EAAE,CAAC,QAAQ,CAAC,EAAE,EAAE;gBACrE,OAAO;aACR,CAAC,CAAC;YACH,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAClC,SAAS;QACX,CAAC;QACD,MAAM,MAAM,GAAG;YACb,0BAA0B;YAC1B,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,aAAa,EAAE,SAAS,EAAE,OAAO,EAAE,CAAC;SAC9D,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACf,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,KAAK,IAAI,EAAE;YAC/C,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CACrC,MAAM,EACN,CAAC,CAAC,YAAY,CAAC,cAAc,CAAC,EAC9B,OAAO,EACP;gBACE,OAAO;gBACP,OAAO,EAAE,mBAAmB;gBAC5B,YAAY,EAAE,6BAA6B,CAAC,sBAAsB;aACnE,CACF,CAAC;YACF,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,IAAI,CAAC;gBACH,OAAO,qBAAqB,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,SAAS,CAAC,CAAC;YACxE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,IAAI,kBAAkB,CAC1B,yDAAyD,EACzD,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;YACJ,CAAC;QACH,CAAC,EAAE,kBAAkB,CAAC,CAAC;QACvB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,MAAM,UAAU,GAAuB;YACrC,GAAG,QAAQ;YACX,YAAY,EAAE,OAAO,CAAC,YAAY,IAAI,IAAI;YAC1C,WAAW;YACX,MAAM,EAAE,QAAQ;SACjB,CAAC;QACF,MAAM,UAAU,EAAE,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;QACrD,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,KAAwB,EACxB,MAAoB;IAEpB,MAAM,QAAQ,GAAG,MAAM,0BAA0B,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IACjE,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,kBAAkB,CAAC,6CAA6C,CAAC,CAAC;IAC9E,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,8EAA8E;AAC9E,MAAM,UAAU,8BAA8B,CAC5C,MAA8B,EAC9B,QAAkD;IAElD,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;IACjD,KAAK,MAAM,UAAU,IAAI,MAAM,CAAC,WAAW,EAAE,CAAC;QAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;QAC/C,IACE,CAAC,OAAO;YACR,UAAU,CAAC,YAAY,KAAK,CAAC,OAAO,CAAC,YAAY,IAAI,IAAI,CAAC;YAC1D,UAAU,CAAC,WAAW,KAAK,cAAc,CAAC,OAAO,CAAC;YAClD,CAAC,UAAU,CAAC,MAAM,KAAK,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,YAAY,KAAK,IAAI,CAAC;YACnE,CAAC,UAAU,CAAC,QAAQ,KAAK,UAAU;gBACjC,CAAC,CAAC,UAAU,CAAC,KAAK,KAAK,IAAI;gBAC3B,CAAC,CAAC,UAAU,CAAC,KAAK,KAAK,IAAI,CAAC;YAC9B,CAAC,UAAU,CAAC,MAAM,KAAK,QAAQ;gBAC7B,CAAC,UAAU,CAAC,QAAQ,KAAK,UAAU;oBACjC,CAAC,CAAC,UAAU,CAAC,WAAW,KAAK,IAAI;oBACjC,CAAC,CAAC,UAAU,CAAC,WAAW,KAAK,IAAI,CAAC,CAAC;YACvC,CAAC,UAAU,CAAC,MAAM,KAAK,mBAAmB;gBACxC,CAAC,UAAU,CAAC,QAAQ,KAAK,UAAU;oBACjC,UAAU,CAAC,KAAK,KAAK,OAAO,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,EAClD,CAAC;YACD,MAAM,IAAI,kBAAkB,CAC1B,wFAAwF,CACzF,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { hash } from \"node:crypto\";\nimport {\n getDefaultSeverityRubric,\n type SeverityRubricSnapshot,\n} from \"./severity-rubric.js\";\nimport { findingEntry } from \"./value.js\";\nimport { z } from \"zod\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport { workflowDigest } from \"./finding-workflow.js\";\nimport { readKnowledgeBaseDocuments } from \"./knowledge-base.js\";\nimport type { Finding } from \"./models.js\";\nimport {\n runReadOnlyCodex,\n type ReadOnlyCodexOptions,\n} from \"./scan-comparison.js\";\nimport {\n severityDecisionSchema as decisionSchema,\n severityReviewInstructions,\n parseSeverityDecision,\n reviewSeverity,\n classificationRunsSchema,\n reviewRunsOption,\n} from \"./severity-review.js\";\nimport { CODEX_SECURITY_THREAD_SOURCES } from \"./thread-source.js\";\n\n/** Full reports and explicitly supplied context from any finding source. */\nexport type SeverityClassificationFinding = Pick<\n Finding,\n \"findingId\" | \"title\" | \"summary\"\n> &\n Partial<Pick<Finding, \"occurrenceId\" | \"severity\">> &\n Record<string, unknown>;\n\nexport interface ClassifySeverityOptions extends Pick<\n ReadOnlyCodexOptions,\n | \"config\"\n | \"environment\"\n | \"model\"\n | \"reasoningEffort\"\n | \"signal\"\n | \"workingDirectory\"\n> {\n /** Overrides both the bundled default and the optional remote default. */\n rubricPath?: string;\n /** Independent reviews per finding: integer 1–10, default 3. */\n classificationRuns?: number;\n /** Supporting evidence, separate from classification policy. */\n knowledgeBasePaths?: readonly string[];\n /** @internal Test client for the shared read-only runtime. */\n codex?: ReadOnlyCodexOptions[\"codex\"];\n}\n\nexport interface SeverityAssessment extends z.infer<typeof decisionSchema> {\n occurrenceId: string | null;\n inputSha256: string;\n source: \"existing-severity\" | \"rubric\";\n}\n\nexport interface SeverityClassification {\n schemaVersion: 1;\n assessedAt: string;\n /** Absent on legacy results whose review count was not recorded. */\n classificationRuns?: number;\n /** SHA-256 of the exact policy text, or the ordered document digest for collections and legacy results. */\n rubricSha256: string | null;\n /** Revision of the bundled or remote rubric. Unversioned file inputs and legacy results omit it. */\n rubricRevision?: number;\n knowledgeBaseSha256: string | null;\n assessments: SeverityAssessment[];\n}\n\n/** @internal Document collections retain their original checkpoint key. */\nexport type SeverityClassificationBinding = Omit<\n SeverityClassification,\n \"assessments\"\n> & {\n rubricCheckpointSha256: string | null;\n};\n\n/** @internal Per-finding persistence used by saved-scan classification. */\nexport interface SeverityClassificationCheckpoint {\n load(binding: SeverityClassificationBinding): Promise<SeverityAssessment[]>;\n save(\n finding: SeverityClassificationFinding,\n assessment: SeverityAssessment,\n binding: SeverityClassificationBinding,\n ): Promise<void>;\n}\n\nconst textSchema = z\n .string()\n .min(1)\n .refine((value) => value.trim().length > 0);\nconst digestSchema = z.string().regex(/^[a-f0-9]{64}$/u);\n/** @internal */\nexport const severityClassificationSchema = z.strictObject({\n schemaVersion: z.literal(1),\n assessedAt: z.string().datetime(),\n classificationRuns: classificationRunsSchema.optional(),\n rubricSha256: digestSchema.nullable(),\n rubricRevision: z.number().int().positive().optional(),\n knowledgeBaseSha256: digestSchema.nullable(),\n assessments: z.array(\n decisionSchema.extend({\n occurrenceId: textSchema.nullable(),\n inputSha256: digestSchema,\n source: z.enum([\"existing-severity\", \"rubric\"]),\n }),\n ),\n}) satisfies z.ZodType<SeverityClassification>;\n\n/** Classify each supplied report independently, without scanning or writing findings. */\nexport async function classifySeverity(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n): Promise<SeverityClassification> {\n return classifySeverityInternal(findings, options);\n}\n\n/** @internal */\nexport async function classifySeverityInternal(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n surface: \"sdk\" | \"cli\" = \"sdk\",\n checkpoint?: SeverityClassificationCheckpoint,\n): Promise<SeverityClassification> {\n options.signal?.throwIfAborted();\n const classificationRuns = reviewRunsOption.parse(options.classificationRuns);\n const ids = new Set<string>();\n for (const finding of findings) {\n if (!finding.findingId?.trim() || ids.has(finding.findingId)) {\n throw new CodexSecurityError(\n \"Severity classification requires unique finding IDs.\",\n );\n }\n ids.add(finding.findingId);\n }\n let rubric: string[];\n let defaultRubric: SeverityRubricSnapshot | undefined;\n if (options.rubricPath === undefined) {\n defaultRubric = await getDefaultSeverityRubric(options);\n rubric = [defaultRubric.markdown];\n } else {\n rubric = await readDocuments([options.rubricPath], options.signal);\n }\n const knowledge = options.knowledgeBasePaths?.length\n ? await readDocuments(options.knowledgeBasePaths, options.signal)\n : null;\n const rubricCheckpointSha256 = workflowDigest(rubric);\n const metadata = {\n schemaVersion: 1 as const,\n classificationRuns,\n assessedAt: new Date().toISOString(),\n ...(defaultRubric\n ? {\n rubricSha256: defaultRubric.sha256,\n rubricRevision: defaultRubric.revision,\n }\n : {\n rubricSha256:\n rubric.length === 1\n ? hash(\"sha256\", rubric[0]!)\n : rubricCheckpointSha256,\n }),\n knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),\n };\n const result: SeverityClassification = { ...metadata, assessments: [] };\n const binding = { ...metadata, rubricCheckpointSha256 };\n const cached = new Map((await checkpoint?.load(binding))?.map(findingEntry));\n for (const finding of findings) {\n options.signal?.throwIfAborted();\n const inputSha256 = workflowDigest(finding);\n const previous = cached.get(finding.findingId);\n if (previous?.inputSha256 === inputSha256) {\n validateSeverityClassification({ ...result, assessments: [previous] }, [\n finding,\n ]);\n result.assessments.push(previous);\n continue;\n }\n const prompt = [\n severityReviewInstructions,\n JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),\n ].join(\"\\n\\n\");\n const decision = await reviewSeverity(async () => {\n options.signal?.throwIfAborted();\n const response = await runReadOnlyCodex(\n prompt,\n z.toJSONSchema(decisionSchema),\n options,\n {\n surface,\n command: \"classify-severity\",\n threadSource: CODEX_SECURITY_THREAD_SOURCES.severityClassification,\n },\n );\n options.signal?.throwIfAborted();\n try {\n return parseSeverityDecision(JSON.parse(response), finding.findingId);\n } catch (error) {\n throw new CodexSecurityError(\n \"Severity classification returned an invalid assessment.\",\n { cause: error },\n );\n }\n }, classificationRuns);\n options.signal?.throwIfAborted();\n const assessment: SeverityAssessment = {\n ...decision,\n occurrenceId: finding.occurrenceId ?? null,\n inputSha256,\n source: \"rubric\",\n };\n await checkpoint?.save(finding, assessment, binding);\n result.assessments.push(assessment);\n }\n options.signal?.throwIfAborted();\n return result;\n}\n\nasync function readDocuments(\n paths: readonly string[],\n signal?: AbortSignal,\n): Promise<string[]> {\n const contents = await readKnowledgeBaseDocuments(paths, signal);\n if (contents.every((text) => !text.trim())) {\n throw new CodexSecurityError(\"Classification documents must not be empty.\");\n }\n return contents;\n}\n\n/** @internal Check parsed assessments against the actual finding evidence. */\nexport function validateSeverityClassification(\n result: SeverityClassification,\n findings: readonly SeverityClassificationFinding[],\n): SeverityClassification {\n const byId = new Map(findings.map(findingEntry));\n for (const assessment of result.assessments) {\n const finding = byId.get(assessment.findingId);\n if (\n !finding ||\n assessment.occurrenceId !== (finding.occurrenceId ?? null) ||\n assessment.inputSha256 !== workflowDigest(finding) ||\n (assessment.source === \"rubric\") !== (result.rubricSha256 !== null) ||\n (assessment.decision === \"assessed\"\n ? assessment.level === null\n : assessment.level !== null) ||\n (assessment.source === \"rubric\" &&\n (assessment.decision === \"assessed\"\n ? assessment.rubricLabel === null\n : assessment.rubricLabel !== null)) ||\n (assessment.source === \"existing-severity\" &&\n (assessment.decision !== \"assessed\" ||\n assessment.level !== finding.severity?.level))\n ) {\n throw new CodexSecurityError(\n \"Severity assessment does not match the supplied findings. Classify the findings again.\",\n );\n }\n byId.delete(assessment.findingId);\n }\n return result;\n}\n"]}
1
+ {"version":3,"file":"classify-severity.js","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"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","sourcesContent":["import { hash } from \"node:crypto\";\nimport {\n getDefaultSeverityRubric,\n type SeverityRubricSnapshot,\n} from \"./severity-rubric.js\";\nimport { findingEntry } from \"./value.js\";\nimport { z } from \"zod\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport { workflowDigest } from \"./finding-workflow.js\";\nimport { readKnowledgeBaseSnapshot } from \"./knowledge-base.js\";\nimport type { DocumentRoots } from \"./prompt-files.js\";\nimport type { Finding } from \"./models.js\";\nimport {\n runReadOnlyCodex,\n type ReadOnlyCodexOptions,\n} from \"./scan-comparison.js\";\nimport {\n severityDecisionSchema as decisionSchema,\n severityReviewInstructions,\n parseSeverityDecision,\n reviewSeverity,\n classificationRunsSchema,\n reviewRunsOption,\n} from \"./severity-review.js\";\nimport { CODEX_SECURITY_THREAD_SOURCES } from \"./thread-source.js\";\n\n/** Full reports and explicitly supplied context from any finding source. */\nexport type SeverityClassificationFinding = Pick<\n Finding,\n \"findingId\" | \"title\" | \"summary\"\n> &\n Partial<Pick<Finding, \"occurrenceId\" | \"severity\">> &\n Record<string, unknown>;\n\nexport interface ClassifySeverityOptions extends Pick<\n ReadOnlyCodexOptions,\n | \"config\"\n | \"environment\"\n | \"model\"\n | \"reasoningEffort\"\n | \"signal\"\n | \"workingDirectory\"\n> {\n /** Overrides both the bundled default and the optional remote default. */\n rubricPath?: string;\n /** Independent reviews per finding: integer 1–10, default 3. */\n classificationRuns?: number;\n /** Supporting evidence, separate from classification policy. */\n knowledgeBasePaths?: readonly string[];\n /** @internal Test client for the shared read-only runtime. */\n codex?: ReadOnlyCodexOptions[\"codex\"];\n}\n\nexport interface SeverityAssessment extends z.infer<typeof decisionSchema> {\n occurrenceId: string | null;\n inputSha256: string;\n source: \"existing-severity\" | \"rubric\";\n}\n\nexport interface SeverityClassification {\n schemaVersion: 1;\n assessedAt: string;\n /** Absent on legacy results whose review count was not recorded. */\n classificationRuns?: number;\n /** SHA-256 of the exact policy text, or the ordered document digest for collections and legacy results. */\n rubricSha256: string | null;\n /** Revision of the bundled or remote rubric. Unversioned file inputs and legacy results omit it. */\n rubricRevision?: number;\n knowledgeBaseSha256: string | null;\n assessments: SeverityAssessment[];\n}\n\n/** @internal Document collections retain their original checkpoint key. */\nexport type SeverityClassificationBinding = Omit<\n SeverityClassification,\n \"assessments\"\n> & {\n rubricCheckpointSha256: string | null;\n};\n\n/** @internal Per-finding persistence used by saved-scan classification. */\nexport interface SeverityClassificationCheckpoint {\n load(binding: SeverityClassificationBinding): Promise<SeverityAssessment[]>;\n save(\n finding: SeverityClassificationFinding,\n assessment: SeverityAssessment,\n binding: SeverityClassificationBinding,\n ): Promise<void>;\n}\n\nconst textSchema = z\n .string()\n .min(1)\n .refine((value) => value.trim().length > 0);\nconst digestSchema = z.string().regex(/^[a-f0-9]{64}$/u);\n/** @internal */\nexport const severityClassificationSchema = z.strictObject({\n schemaVersion: z.literal(1),\n assessedAt: z.string().datetime(),\n classificationRuns: classificationRunsSchema.optional(),\n rubricSha256: digestSchema.nullable(),\n rubricRevision: z.number().int().positive().optional(),\n knowledgeBaseSha256: digestSchema.nullable(),\n assessments: z.array(\n decisionSchema.extend({\n occurrenceId: textSchema.nullable(),\n inputSha256: digestSchema,\n source: z.enum([\"existing-severity\", \"rubric\"]),\n }),\n ),\n}) satisfies z.ZodType<SeverityClassification>;\n\n/** Classify each supplied report independently, without scanning or writing findings. */\nexport async function classifySeverity(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n): Promise<SeverityClassification> {\n return classifySeverityInternal(findings, options);\n}\n\n/** @internal */\nexport async function classifySeverityInternal(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n surface: \"sdk\" | \"cli\" = \"sdk\",\n checkpoint?: SeverityClassificationCheckpoint,\n roots?: DocumentRoots,\n): Promise<SeverityClassification> {\n options.signal?.throwIfAborted();\n const classificationRuns = reviewRunsOption.parse(options.classificationRuns);\n const ids = new Set<string>();\n for (const finding of findings) {\n if (!finding.findingId?.trim() || ids.has(finding.findingId)) {\n throw new CodexSecurityError(\n \"Severity classification requires unique finding IDs.\",\n );\n }\n ids.add(finding.findingId);\n }\n let rubric: string[];\n let defaultRubric: SeverityRubricSnapshot | undefined;\n if (options.rubricPath === undefined) {\n defaultRubric = await getDefaultSeverityRubric(options);\n rubric = [defaultRubric.markdown];\n } else {\n rubric = await readDocuments([options.rubricPath], options.signal, roots);\n }\n const knowledge = options.knowledgeBasePaths?.length\n ? await readDocuments(options.knowledgeBasePaths, options.signal, roots)\n : null;\n const rubricCheckpointSha256 = workflowDigest(rubric);\n const metadata = {\n schemaVersion: 1 as const,\n classificationRuns,\n assessedAt: new Date().toISOString(),\n ...(defaultRubric\n ? {\n rubricSha256: defaultRubric.sha256,\n rubricRevision: defaultRubric.revision,\n }\n : {\n rubricSha256:\n rubric.length === 1\n ? hash(\"sha256\", rubric[0]!)\n : rubricCheckpointSha256,\n }),\n knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),\n };\n const result: SeverityClassification = { ...metadata, assessments: [] };\n const binding = { ...metadata, rubricCheckpointSha256 };\n const cached = new Map((await checkpoint?.load(binding))?.map(findingEntry));\n for (const finding of findings) {\n options.signal?.throwIfAborted();\n const inputSha256 = workflowDigest(finding);\n const previous = cached.get(finding.findingId);\n if (previous?.inputSha256 === inputSha256) {\n validateSeverityClassification({ ...result, assessments: [previous] }, [\n finding,\n ]);\n result.assessments.push(previous);\n continue;\n }\n const prompt = [\n severityReviewInstructions,\n JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),\n ].join(\"\\n\\n\");\n const decision = await reviewSeverity(async () => {\n options.signal?.throwIfAborted();\n const response = await runReadOnlyCodex(\n prompt,\n z.toJSONSchema(decisionSchema),\n options,\n {\n surface,\n command: \"classify-severity\",\n threadSource: CODEX_SECURITY_THREAD_SOURCES.severityClassification,\n },\n );\n options.signal?.throwIfAborted();\n try {\n return parseSeverityDecision(JSON.parse(response), finding.findingId);\n } catch (error) {\n throw new CodexSecurityError(\n \"Severity classification returned an invalid assessment.\",\n { cause: error },\n );\n }\n }, classificationRuns);\n options.signal?.throwIfAborted();\n const assessment: SeverityAssessment = {\n ...decision,\n occurrenceId: finding.occurrenceId ?? null,\n inputSha256,\n source: \"rubric\",\n };\n await checkpoint?.save(finding, assessment, binding);\n result.assessments.push(assessment);\n }\n options.signal?.throwIfAborted();\n return result;\n}\n\nasync function readDocuments(\n paths: readonly string[],\n signal?: AbortSignal,\n roots?: DocumentRoots,\n): Promise<string[]> {\n const { documents } = await readKnowledgeBaseSnapshot(paths, signal, roots);\n const contents = Object.keys(documents)\n .sort()\n .map((name) => documents[name]!);\n if (contents.every((text) => !text.trim())) {\n throw new CodexSecurityError(\"Classification documents must not be empty.\");\n }\n return contents;\n}\n\n/** @internal Check parsed assessments against the actual finding evidence. */\nexport function validateSeverityClassification(\n result: SeverityClassification,\n findings: readonly SeverityClassificationFinding[],\n): SeverityClassification {\n const byId = new Map(findings.map(findingEntry));\n for (const assessment of result.assessments) {\n const finding = byId.get(assessment.findingId);\n if (\n !finding ||\n assessment.occurrenceId !== (finding.occurrenceId ?? null) ||\n assessment.inputSha256 !== workflowDigest(finding) ||\n (assessment.source === \"rubric\") !== (result.rubricSha256 !== null) ||\n (assessment.decision === \"assessed\"\n ? assessment.level === null\n : assessment.level !== null) ||\n (assessment.source === \"rubric\" &&\n (assessment.decision === \"assessed\"\n ? assessment.rubricLabel === null\n : assessment.rubricLabel !== null)) ||\n (assessment.source === \"existing-severity\" &&\n (assessment.decision !== \"assessed\" ||\n assessment.level !== finding.severity?.level))\n ) {\n throw new CodexSecurityError(\n \"Severity assessment does not match the supplied findings. Classify the findings again.\",\n );\n }\n byId.delete(assessment.findingId);\n }\n return result;\n}\n"]}
@@ -0,0 +1,4 @@
1
+ /** Quote a literal argument for the user's shell (PowerShell on Windows). */
2
+ export declare function quoteCliPath(value: string): string;
3
+ export declare function cliShellLabel(quotedArgument: string): string;
4
+ //# sourceMappingURL=cli-argument.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-argument.d.ts","sourceRoot":"","sources":["../src/cli-argument.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CASlD;AAED,wBAAgB,aAAa,CAAC,cAAc,EAAE,MAAM,GAAG,MAAM,CAI5D"}
@@ -0,0 +1,17 @@
1
+ /** Quote a literal argument for the user's shell (PowerShell on Windows). */
2
+ export function quoteCliPath(value) {
3
+ if (/^[A-Za-z0-9_./:-]+$/u.test(value))
4
+ return value;
5
+ if (process.platform === "win32" && /^[A-Za-z0-9_./:\\-]+$/u.test(value))
6
+ return value;
7
+ const escaped = process.platform === "win32"
8
+ ? value.replace(/['\u2018\u2019\u201a\u201b]/gu, (quote) => quote + quote)
9
+ : value.replaceAll("'", `'"'"'`);
10
+ return `'${escaped}'`;
11
+ }
12
+ export function cliShellLabel(quotedArgument) {
13
+ return process.platform === "win32" && quotedArgument.startsWith("'")
14
+ ? " (PowerShell)"
15
+ : "";
16
+ }
17
+ //# sourceMappingURL=cli-argument.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"cli-argument.js","sourceRoot":"","sources":["../src/cli-argument.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,MAAM,UAAU,YAAY,CAAC,KAAa;IACxC,IAAI,sBAAsB,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACrD,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,KAAK,CAAC;QACtE,OAAO,KAAK,CAAC;IACf,MAAM,OAAO,GACX,OAAO,CAAC,QAAQ,KAAK,OAAO;QAC1B,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,+BAA+B,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,GAAG,KAAK,CAAC;QAC1E,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,IAAI,OAAO,GAAG,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,cAAsB;IAClD,OAAO,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,cAAc,CAAC,UAAU,CAAC,GAAG,CAAC;QACnE,CAAC,CAAC,eAAe;QACjB,CAAC,CAAC,EAAE,CAAC;AACT,CAAC","sourcesContent":["/** Quote a literal argument for the user's shell (PowerShell on Windows). */\nexport function quoteCliPath(value: string): string {\n if (/^[A-Za-z0-9_./:-]+$/u.test(value)) return value;\n if (process.platform === \"win32\" && /^[A-Za-z0-9_./:\\\\-]+$/u.test(value))\n return value;\n const escaped =\n process.platform === \"win32\"\n ? value.replace(/['\\u2018\\u2019\\u201a\\u201b]/gu, (quote) => quote + quote)\n : value.replaceAll(\"'\", `'\"'\"'`);\n return `'${escaped}'`;\n}\n\nexport function cliShellLabel(quotedArgument: string): string {\n return process.platform === \"win32\" && quotedArgument.startsWith(\"'\")\n ? \" (PowerShell)\"\n : \"\";\n}\n"]}
@@ -1,3 +1,3 @@
1
1
  /** Present Incur's generated help without changing its routing or command output. */
2
- export declare function formatCliHelp(text: string, columns?: number): string;
2
+ export declare function formatCliHelp(text: string, columns?: number): string | undefined;
3
3
  //# sourceMappingURL=cli-help.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AAgPA,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM,CA4HhE"}
1
+ {"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AAsPA,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM,GAAG,SAAS,CAgL5E"}
package/dist/cli-help.js CHANGED
@@ -1,21 +1,16 @@
1
1
  import { DEEP_SCAN_SETTINGS, DeepScanSettingsSchema } from "./scan-settings.js";
2
2
  const COMMAND_GROUPS = [
3
- ["Scan and fix", ["scan", "policy", "validate", "patch", "verify-fix"]],
3
+ ["Scan and remediate", ["scan", "policy", "validate", "patch", "verify-fix"]],
4
4
  [
5
- "Review and share",
6
- [
7
- "scans",
8
- "findings",
9
- "classify-severity",
10
- "dedupe",
11
- "suggest-owners",
12
- "export",
13
- "import",
14
- "publish",
15
- ],
5
+ "Review results",
6
+ ["scans", "findings", "classify-severity", "dedupe", "suggest-owners"],
16
7
  ],
8
+ ["Import and share", ["import", "publish", "export"]],
17
9
  ["Automate", ["bulk-scan", "scan-components", "install-hook"]],
18
- ["Setup and support", ["login", "logout", "init", "info", "feedback"]],
10
+ [
11
+ "Configure and troubleshoot",
12
+ ["login", "logout", "init", "info", "feedback", "update"],
13
+ ],
19
14
  ];
20
15
  const SCAN_GROUPS = [
21
16
  ["Scope", ["path", "diff", "head", "working-tree", "base"]],
@@ -42,7 +37,7 @@ const SCAN_GROUPS = [
42
37
  ["Patch after scanning", ["patch", "patch-severity", "create-pr"]],
43
38
  ];
44
39
  const PUBLISH_GROUPS = [
45
- ["Input", ["scan", "scan-dir", "csv", "finding-id", "workflow-id"]],
40
+ ["Input", ["scan", "scan-dir", "finding-id", "workflow-id"]],
46
41
  ["Destination", ["to", "findings-url"]],
47
42
  [
48
43
  "Linear",
@@ -78,6 +73,7 @@ const VALUE_LABELS = {
78
73
  python: "path",
79
74
  codex: "key=value",
80
75
  "max-cost": "usd",
76
+ "max-total-cost": "usd",
81
77
  "max-time": "minutes",
82
78
  "max-time-hours": "hours",
83
79
  "fail-on-severity": "level",
@@ -96,9 +92,10 @@ const VALUE_LABELS = {
96
92
  "token-offset": "count",
97
93
  to: "destination",
98
94
  };
95
+ const OUTPUT_FLAGS = ["format", "json", "filter-output", "full-output"];
99
96
  const OUTPUT_GROUPS = [
100
- ["Help and updates", ["help", "version", "update"]],
101
- ["Output", ["format", "json", "filter-output", "full-output"]],
97
+ ["Help and version", ["help", "version"]],
98
+ ["Output", OUTPUT_FLAGS],
102
99
  ];
103
100
  function rowName(row) {
104
101
  return row.label.match(/--([\w-]+)/u)?.[1] ?? row.label;
@@ -166,6 +163,10 @@ function optionRow(row, command) {
166
163
  }
167
164
  return `<${VALUE_LABELS[name] ?? (type === "number" ? "count" : name)}>`;
168
165
  });
166
+ if (name === "token-limit")
167
+ description = "Maximum tokens in the text view (nonnegative integer).";
168
+ if (name === "token-offset")
169
+ description = "Start the text view at this token (nonnegative integer).";
169
170
  label = label.replace(/^--([\w-]+), (-\w)/u, "$2, --$1");
170
171
  if (command === "scan" && !/default:/iu.test(description)) {
171
172
  const setting = DEEP_SCAN_SETTINGS.find(([, , , flag]) => flag === `--${name}`);
@@ -181,16 +182,19 @@ function globalRows(rows, command) {
181
182
  const scan = command === "scan" || command === "scan import";
182
183
  const plainOutput = ["validate", "login", "logout", "export"].includes(command);
183
184
  const visible = rows.filter(({ label }) => {
185
+ if (label === "--update")
186
+ return false;
184
187
  if (scan && label.startsWith("--filter-output"))
185
188
  return false;
186
189
  return !(plainOutput &&
187
190
  /^(--format |--filter-output |--full-output$|--token-)/u.test(label));
188
191
  });
189
192
  const formats = visible.find((row) => rowName(row) === "format");
190
- if (formats && (scan || command === "scans rerun")) {
193
+ if (formats &&
194
+ (scan || command === "scans rerun" || command === "scans resume")) {
191
195
  formats.label = formats.label.replace("|md", "");
192
196
  }
193
- if (formats && command !== "scan import") {
197
+ if (formats) {
194
198
  visible.push({
195
199
  label: "--json",
196
200
  description: "Shorthand for --format json.",
@@ -202,7 +206,7 @@ function globalRows(rows, command) {
202
206
  export function formatCliHelp(text, columns = 80) {
203
207
  const header = text.match(/^(codex-security(?:@[^\s]+)?((?: [a-z][a-z-]*)*))(?: — ([^\n]*))?\n\nUsage: /u);
204
208
  if (!header)
205
- return text;
209
+ return undefined;
206
210
  const command = header[2].trim();
207
211
  const sections = [];
208
212
  // Presentation width only; long paths and copyable commands remain intact.
@@ -224,22 +228,41 @@ export function formatCliHelp(text, columns = 80) {
224
228
  }
225
229
  sections.push(usage
226
230
  .split("\n")
227
- .map((line) => wrap(line, width, "", " "))
231
+ .map((line) => wrap(line.trimStart(), width, line.startsWith(" ") ? " " : "", " "))
228
232
  .join("\n"));
229
233
  if (command === "") {
230
234
  sections.push([
231
235
  "Get started:",
236
+ " codex-security scan . --dry-run",
232
237
  " codex-security login",
233
- "",
234
- wrap("In your repository, draft SECURITY.md (optional):", width, " ", " "),
235
- " codex-security policy .",
236
- wrap("Review the diff and notes. Edit the draft, then copy only SECURITY.md to the Policy target shown.", width, " ", " "),
237
- wrap("Skip this step to keep your existing policy or scan without one.", width, " ", " "),
238
- "",
239
238
  " codex-security scan .",
240
- " codex-security findings",
239
+ " codex-security scans show",
241
240
  ].join("\n"));
242
241
  }
242
+ else if (command === "import") {
243
+ sections.push(renderRows("Choose your input", [
244
+ {
245
+ label: "Live provider",
246
+ description: "Choose a collector below.",
247
+ },
248
+ {
249
+ label: "CLI, API, or MCP source",
250
+ description: "Ask Codex to import it using the publish-findings skill.",
251
+ },
252
+ {
253
+ label: "Workbench findings",
254
+ description: "Ask Codex to publish a stored import or selected finding versions.",
255
+ },
256
+ {
257
+ label: "Saved vendor report",
258
+ description: "See codex-security publish findings --help for local storage and publication.",
259
+ },
260
+ {
261
+ label: "Codex Security CSV or JSON",
262
+ description: "See codex-security scan import --help to add the export to local scan history.",
263
+ },
264
+ ], width));
265
+ }
243
266
  else if (examples) {
244
267
  sections.push(examples);
245
268
  }
@@ -254,15 +277,31 @@ export function formatCliHelp(text, columns = 80) {
254
277
  : [renderRows("Commands", rows, width)]));
255
278
  }
256
279
  else if (title === "Options:") {
257
- const rows = parseRows(lines).map((row) => optionRow(row, command));
280
+ const options = parseRows(lines)
281
+ .filter((row) => !(command === "publish scan" && rowName(row) === "csv") &&
282
+ !(command === "publish check" && rowName(row) === "to"))
283
+ .map((row) => optionRow(row, command));
284
+ const rows = options.filter((row) => !row.description.startsWith("[deprecated]"));
258
285
  sections.push(...(command === "scan"
259
286
  ? groupedRows(rows, SCAN_GROUPS, "Advanced", width)
260
287
  : command === "publish scan"
261
288
  ? groupedRows(rows, PUBLISH_GROUPS, "Options", width)
262
289
  : [renderRows("Options", rows, width)]));
290
+ const deprecated = options.filter((row) => row.description.startsWith("[deprecated]"));
291
+ if (deprecated.length)
292
+ sections.push(renderRows("Deprecated options", deprecated, width));
263
293
  }
264
294
  else if (title === "Global Options:") {
265
- sections.push(...groupedRows(globalRows(parseRows(lines), command), OUTPUT_GROUPS, "Agent options", width));
295
+ const rows = globalRows(parseRows(lines), command);
296
+ if (command === "") {
297
+ sections.push(...groupedRows(rows, OUTPUT_GROUPS, "Agent options", width));
298
+ }
299
+ else {
300
+ const outputRows = rows.filter((row) => OUTPUT_FLAGS.includes(rowName(row)));
301
+ if (outputRows.length)
302
+ sections.push(renderRows("Output", outputRows, width));
303
+ sections.push(wrap("See codex-security --help for shared help and agent options.", width));
304
+ }
266
305
  }
267
306
  else if (["Arguments:", "Integrations:", "Environment Variables:"].includes(title)) {
268
307
  const rows = parseRows(lines).map((row) => ({
@@ -280,6 +319,9 @@ export function formatCliHelp(text, columns = 80) {
280
319
  .join("\n"));
281
320
  }
282
321
  }
322
+ if (command === "completions") {
323
+ sections.push(wrap("Shell setup: https://github.com/openai/codex-security/blob/main/sdk/typescript/docs/cli.md#shell-completions", width));
324
+ }
283
325
  if (command === "") {
284
326
  sections.push(wrap("Use codex-security <command> --help for options and examples.", width));
285
327
  sections.push("Docs: https://learn.chatgpt.com/docs/security/cli");