@openai/codex-security 0.5.1 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (313) hide show
  1. package/README.md +151 -36
  2. package/_bundled_plugin/.mcp.json +1 -0
  3. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  4. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  5. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +1 -1
  6. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  7. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  8. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  9. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  10. package/_bundled_plugin/mcp/native/linux-x64-gnu/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.part-000 +0 -0
  14. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  15. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  16. package/_bundled_plugin/references/access-advisory.md +11 -0
  17. package/_bundled_plugin/references/core-scan.md +30 -77
  18. package/_bundled_plugin/references/final-report.md +45 -189
  19. package/_bundled_plugin/references/scan-contract.md +2 -0
  20. package/_bundled_plugin/references/scan-prologue.md +1 -1
  21. package/_bundled_plugin/references/scan-runtime.md +1 -5
  22. package/_bundled_plugin/references/threat-model.md +33 -41
  23. package/_bundled_plugin/schemas/coverage.schema.json +12 -1
  24. package/_bundled_plugin/schemas/scan-manifest.schema.json +1 -0
  25. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +38 -1
  26. package/_bundled_plugin/scripts/deep_scan_config.py +39 -39
  27. package/_bundled_plugin/scripts/deep_scan_workbench.py +145 -85
  28. package/_bundled_plugin/scripts/finalize_scan_contract.py +189 -57
  29. package/_bundled_plugin/scripts/report_projection.py +44 -15
  30. package/_bundled_plugin/scripts/threat_model_projection.py +4 -2
  31. package/_bundled_plugin/scripts/windows_scan_local_files.py +43 -14
  32. package/_bundled_plugin/scripts/workbench/retained_coverage.py +3218 -0
  33. package/_bundled_plugin/scripts/workbench/retained_records.py +627 -0
  34. package/_bundled_plugin/scripts/workbench/saved_coverage.py +644 -1
  35. package/_bundled_plugin/scripts/workbench/saved_outputs.py +72 -0
  36. package/_bundled_plugin/scripts/workbench/saved_sources.py +712 -0
  37. package/_bundled_plugin/scripts/workbench_cli.py +3 -0
  38. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +479 -0
  39. package/_bundled_plugin/scripts/workbench_db.py +51 -22
  40. package/_bundled_plugin/scripts/workbench_feedback.py +0 -1
  41. package/_bundled_plugin/scripts/workbench_finding_workflows.py +53 -9
  42. package/_bundled_plugin/scripts/workbench_native_indexes.py +56 -44
  43. package/_bundled_plugin/scripts/workbench_saved_results.py +641 -2387
  44. package/_bundled_plugin/scripts/workbench_scan_history.py +72 -7
  45. package/_bundled_plugin/scripts/workbench_schema.py +1 -1
  46. package/_bundled_plugin/scripts/workbench_source_scopes.py +4 -1
  47. package/_bundled_plugin/scripts/workbench_target.py +142 -17
  48. package/_bundled_plugin/scripts/workbench_validation.py +9 -2
  49. package/_bundled_plugin/shared/workbench-history-repairs.json +21 -0
  50. package/_bundled_plugin/shared/workbench-migrations.json +44 -0
  51. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +3 -14
  52. package/_bundled_plugin/skills/assess-patch-risk/references/windows-validation.md +14 -0
  53. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +38 -103
  54. package/_bundled_plugin/skills/attack-path-analysis/references/attack-path-facts.md +11 -73
  55. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +57 -116
  56. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +28 -51
  57. package/_bundled_plugin/skills/define-security-policy/SKILL.md +9 -9
  58. package/_bundled_plugin/skills/finding-discovery/SKILL.md +26 -140
  59. package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -30
  60. package/_bundled_plugin/skills/propose-security-hardening/SKILL.md +28 -218
  61. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +29 -424
  62. package/_bundled_plugin/skills/publish-findings/SKILL.md +134 -0
  63. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +6 -0
  64. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +64 -0
  65. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +12 -12
  66. package/_bundled_plugin/skills/security-scan/SKILL.md +28 -16
  67. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +11 -17
  68. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +52 -69
  69. package/_bundled_plugin/skills/threat-model/SKILL.md +16 -9
  70. package/_bundled_plugin/skills/triage-finding/SKILL.md +5 -15
  71. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -6
  72. package/_bundled_plugin/skills/validation/SKILL.md +42 -104
  73. package/_bundled_plugin/skills/validation/references/validation-guidance.md +21 -106
  74. package/_bundled_plugin/skills/verify-fix/SKILL.md +8 -4
  75. package/_bundled_plugin/skills/vulnerability-writeup/SKILL.md +21 -159
  76. package/_bundled_plugin/skills/vulnerability-writeup/references/report-format.md +18 -60
  77. package/dist/api.d.ts +8 -3
  78. package/dist/api.d.ts.map +1 -1
  79. package/dist/api.js +414 -72
  80. package/dist/api.js.map +1 -1
  81. package/dist/auth.d.ts.map +1 -1
  82. package/dist/auth.js +4 -1
  83. package/dist/auth.js.map +1 -1
  84. package/dist/classify-severity-records.d.ts +5 -2
  85. package/dist/classify-severity-records.d.ts.map +1 -1
  86. package/dist/classify-severity-records.js +40 -34
  87. package/dist/classify-severity-records.js.map +1 -1
  88. package/dist/classify-severity.d.ts +5 -1
  89. package/dist/classify-severity.d.ts.map +1 -1
  90. package/dist/classify-severity.js +20 -30
  91. package/dist/classify-severity.js.map +1 -1
  92. package/dist/cli-help.d.ts.map +1 -1
  93. package/dist/cli-help.js +1 -0
  94. package/dist/cli-help.js.map +1 -1
  95. package/dist/cli.d.ts +9 -2
  96. package/dist/cli.d.ts.map +1 -1
  97. package/dist/cli.js +802 -149
  98. package/dist/cli.js.map +1 -1
  99. package/dist/cloud-endpoint.d.ts +6 -0
  100. package/dist/cloud-endpoint.d.ts.map +1 -0
  101. package/dist/cloud-endpoint.js +51 -0
  102. package/dist/cloud-endpoint.js.map +1 -0
  103. package/dist/cloud-publish.d.ts.map +1 -1
  104. package/dist/cloud-publish.js +7 -5
  105. package/dist/cloud-publish.js.map +1 -1
  106. package/dist/component-scan.d.ts +8 -2
  107. package/dist/component-scan.d.ts.map +1 -1
  108. package/dist/component-scan.js +2 -0
  109. package/dist/component-scan.js.map +1 -1
  110. package/dist/contract.d.ts +2 -0
  111. package/dist/contract.d.ts.map +1 -1
  112. package/dist/contract.js +67 -33
  113. package/dist/contract.js.map +1 -1
  114. package/dist/cost.d.ts +18 -0
  115. package/dist/cost.d.ts.map +1 -1
  116. package/dist/cost.js +107 -12
  117. package/dist/cost.js.map +1 -1
  118. package/dist/coverage-presentation.d.ts +6 -0
  119. package/dist/coverage-presentation.d.ts.map +1 -0
  120. package/dist/coverage-presentation.js +34 -0
  121. package/dist/coverage-presentation.js.map +1 -0
  122. package/dist/custom-validation-prompt.js +3 -3
  123. package/dist/custom-validation-prompt.js.map +1 -1
  124. package/dist/custom-validation.d.ts.map +1 -1
  125. package/dist/custom-validation.js +30 -4
  126. package/dist/custom-validation.js.map +1 -1
  127. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  128. package/dist/deduplication/checkpointed-review.js +3 -1
  129. package/dist/deduplication/checkpointed-review.js.map +1 -1
  130. package/dist/deduplication/scan.d.ts.map +1 -1
  131. package/dist/deduplication/scan.js +7 -5
  132. package/dist/deduplication/scan.js.map +1 -1
  133. package/dist/default-severity-rubric.d.ts +3 -0
  134. package/dist/default-severity-rubric.d.ts.map +1 -0
  135. package/dist/default-severity-rubric.js +67 -0
  136. package/dist/default-severity-rubric.js.map +1 -0
  137. package/dist/endor-findings.d.ts +8 -0
  138. package/dist/endor-findings.d.ts.map +1 -0
  139. package/dist/endor-findings.js +238 -0
  140. package/dist/endor-findings.js.map +1 -0
  141. package/dist/external-findings-import.d.ts +5 -0
  142. package/dist/external-findings-import.d.ts.map +1 -0
  143. package/dist/external-findings-import.js +46 -0
  144. package/dist/external-findings-import.js.map +1 -0
  145. package/dist/external-findings-local.d.ts +63 -0
  146. package/dist/external-findings-local.d.ts.map +1 -0
  147. package/dist/external-findings-local.js +344 -0
  148. package/dist/external-findings-local.js.map +1 -0
  149. package/dist/external-findings-publish.d.ts +73 -0
  150. package/dist/external-findings-publish.d.ts.map +1 -0
  151. package/dist/external-findings-publish.js +721 -0
  152. package/dist/external-findings-publish.js.map +1 -0
  153. package/dist/external-findings-read.d.ts +16 -0
  154. package/dist/external-findings-read.d.ts.map +1 -0
  155. package/dist/external-findings-read.js +97 -0
  156. package/dist/external-findings-read.js.map +1 -0
  157. package/dist/external-findings.d.ts +21 -0
  158. package/dist/external-findings.d.ts.map +1 -0
  159. package/dist/external-findings.js +2 -0
  160. package/dist/external-findings.js.map +1 -0
  161. package/dist/external-import-contract.d.ts +15 -0
  162. package/dist/external-import-contract.d.ts.map +1 -0
  163. package/dist/external-import-contract.js +262 -0
  164. package/dist/external-import-contract.js.map +1 -0
  165. package/dist/external-import-models.d.ts +362 -0
  166. package/dist/external-import-models.d.ts.map +1 -0
  167. package/dist/external-import-models.js +3 -0
  168. package/dist/external-import-models.js.map +1 -0
  169. package/dist/external-imports-feature.d.ts +6 -0
  170. package/dist/external-imports-feature.d.ts.map +1 -0
  171. package/dist/external-imports-feature.js +51 -0
  172. package/dist/external-imports-feature.js.map +1 -0
  173. package/dist/finding-workflow.d.ts +23 -6
  174. package/dist/finding-workflow.d.ts.map +1 -1
  175. package/dist/finding-workflow.js +23 -10
  176. package/dist/finding-workflow.js.map +1 -1
  177. package/dist/github-advisories.d.ts +386 -0
  178. package/dist/github-advisories.d.ts.map +1 -0
  179. package/dist/github-advisories.js +133 -0
  180. package/dist/github-advisories.js.map +1 -0
  181. package/dist/github-findings.d.ts +11 -0
  182. package/dist/github-findings.d.ts.map +1 -0
  183. package/dist/github-findings.js +258 -0
  184. package/dist/github-findings.js.map +1 -0
  185. package/dist/hosted-remediation-protocol.d.ts +2 -1
  186. package/dist/hosted-remediation-protocol.d.ts.map +1 -1
  187. package/dist/hosted-remediation-protocol.js +17 -11
  188. package/dist/hosted-remediation-protocol.js.map +1 -1
  189. package/dist/hosted-remediation.d.ts +4 -0
  190. package/dist/hosted-remediation.d.ts.map +1 -1
  191. package/dist/hosted-remediation.js +22 -3
  192. package/dist/hosted-remediation.js.map +1 -1
  193. package/dist/hosted-scan.d.ts +16 -0
  194. package/dist/hosted-scan.d.ts.map +1 -1
  195. package/dist/hosted-scan.js +9 -2
  196. package/dist/hosted-scan.js.map +1 -1
  197. package/dist/import-scan.js +1 -1
  198. package/dist/import-scan.js.map +1 -1
  199. package/dist/index.d.ts +16 -3
  200. package/dist/index.d.ts.map +1 -1
  201. package/dist/index.js +9 -1
  202. package/dist/index.js.map +1 -1
  203. package/dist/knowledge-base.d.ts +1 -0
  204. package/dist/knowledge-base.d.ts.map +1 -1
  205. package/dist/knowledge-base.js +17 -8
  206. package/dist/knowledge-base.js.map +1 -1
  207. package/dist/models.d.ts +1 -0
  208. package/dist/models.d.ts.map +1 -1
  209. package/dist/models.js.map +1 -1
  210. package/dist/owner-evidence.d.ts +2 -0
  211. package/dist/owner-evidence.d.ts.map +1 -1
  212. package/dist/owner-evidence.js +2 -1
  213. package/dist/owner-evidence.js.map +1 -1
  214. package/dist/project-config-schema.d.ts +2 -0
  215. package/dist/project-config-schema.d.ts.map +1 -1
  216. package/dist/project-config-schema.js +1 -0
  217. package/dist/project-config-schema.js.map +1 -1
  218. package/dist/project-config.d.ts +1 -0
  219. package/dist/project-config.d.ts.map +1 -1
  220. package/dist/project-config.js +2 -0
  221. package/dist/project-config.js.map +1 -1
  222. package/dist/publish.d.ts +2 -0
  223. package/dist/publish.d.ts.map +1 -1
  224. package/dist/publish.js +1 -1
  225. package/dist/publish.js.map +1 -1
  226. package/dist/remediation.d.ts +7 -25
  227. package/dist/remediation.d.ts.map +1 -1
  228. package/dist/remediation.js +18 -28
  229. package/dist/remediation.js.map +1 -1
  230. package/dist/result.d.ts +4 -0
  231. package/dist/result.d.ts.map +1 -1
  232. package/dist/result.js +10 -0
  233. package/dist/result.js.map +1 -1
  234. package/dist/runtime.d.ts +1 -0
  235. package/dist/runtime.d.ts.map +1 -1
  236. package/dist/runtime.js +10 -8
  237. package/dist/runtime.js.map +1 -1
  238. package/dist/scan-dashboard.d.ts +5 -3
  239. package/dist/scan-dashboard.d.ts.map +1 -1
  240. package/dist/scan-dashboard.js +79 -26
  241. package/dist/scan-dashboard.js.map +1 -1
  242. package/dist/scan-history-renderer.d.ts.map +1 -1
  243. package/dist/scan-history-renderer.js +8 -2
  244. package/dist/scan-history-renderer.js.map +1 -1
  245. package/dist/scan-owner-suggestions.d.ts +8 -0
  246. package/dist/scan-owner-suggestions.d.ts.map +1 -0
  247. package/dist/scan-owner-suggestions.js +33 -0
  248. package/dist/scan-owner-suggestions.js.map +1 -0
  249. package/dist/scan-settings.d.ts +1 -0
  250. package/dist/scan-settings.d.ts.map +1 -1
  251. package/dist/scan-settings.js +4 -0
  252. package/dist/scan-settings.js.map +1 -1
  253. package/dist/scan-usage-display.d.ts +8 -0
  254. package/dist/scan-usage-display.d.ts.map +1 -0
  255. package/dist/scan-usage-display.js +46 -0
  256. package/dist/scan-usage-display.js.map +1 -0
  257. package/dist/scanner-import.d.ts +20 -0
  258. package/dist/scanner-import.d.ts.map +1 -0
  259. package/dist/scanner-import.js +208 -0
  260. package/dist/scanner-import.js.map +1 -0
  261. package/dist/security-policy-diff.d.ts +2 -0
  262. package/dist/security-policy-diff.d.ts.map +1 -0
  263. package/dist/security-policy-diff.js +197 -0
  264. package/dist/security-policy-diff.js.map +1 -0
  265. package/dist/security-policy.d.ts +7 -3
  266. package/dist/security-policy.d.ts.map +1 -1
  267. package/dist/security-policy.js +11 -76
  268. package/dist/security-policy.js.map +1 -1
  269. package/dist/semgrep-findings.d.ts +10 -0
  270. package/dist/semgrep-findings.d.ts.map +1 -0
  271. package/dist/semgrep-findings.js +293 -0
  272. package/dist/semgrep-findings.js.map +1 -0
  273. package/dist/severity-review.d.ts +3 -0
  274. package/dist/severity-review.d.ts.map +1 -1
  275. package/dist/severity-review.js +19 -0
  276. package/dist/severity-review.js.map +1 -1
  277. package/dist/severity-store.js +7 -2
  278. package/dist/severity-store.js.map +1 -1
  279. package/dist/skill-authentication.d.ts +18 -0
  280. package/dist/skill-authentication.d.ts.map +1 -0
  281. package/dist/skill-authentication.js +82 -0
  282. package/dist/skill-authentication.js.map +1 -0
  283. package/dist/snyk-findings.d.ts +10 -0
  284. package/dist/snyk-findings.d.ts.map +1 -0
  285. package/dist/snyk-findings.js +350 -0
  286. package/dist/snyk-findings.js.map +1 -0
  287. package/dist/suggest-owners.d.ts +4 -1
  288. package/dist/suggest-owners.d.ts.map +1 -1
  289. package/dist/suggest-owners.js +53 -21
  290. package/dist/suggest-owners.js.map +1 -1
  291. package/dist/targets.d.ts +2 -2
  292. package/dist/targets.d.ts.map +1 -1
  293. package/dist/targets.js +16 -3
  294. package/dist/targets.js.map +1 -1
  295. package/dist/wiz-csv.d.ts +9 -0
  296. package/dist/wiz-csv.d.ts.map +1 -0
  297. package/dist/wiz-csv.js +116 -0
  298. package/dist/wiz-csv.js.map +1 -0
  299. package/dist/wiz-findings.d.ts +5 -0
  300. package/dist/wiz-findings.d.ts.map +1 -0
  301. package/dist/wiz-findings.js +464 -0
  302. package/dist/wiz-findings.js.map +1 -0
  303. package/docs/classify-severity-records.md +30 -13
  304. package/docs/cli.md +835 -47
  305. package/docs/findings-service.md +119 -118
  306. package/docs/hosted-remediation.md +43 -24
  307. package/docs/hosted-scans.md +38 -0
  308. package/package.json +11 -9
  309. package/schemas/external-findings.schema.json +1421 -0
  310. package/schemas/project-config.schema.json +4 -0
  311. package/_bundled_plugin/scripts/generate_in_scope_files.py +0 -277
  312. package/_bundled_plugin/scripts/generate_rank_input.py +0 -350
  313. package/_bundled_plugin/scripts/rank_preview.py +0 -129
@@ -1 +1 @@
1
- {"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAYA,OAAO,EAGL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AA8DtB,MAAM,WAAW,WAAY,SAAQ,OAAO,CAC1C,UAAU,CAAC,OAAO,eAAe,CAAC,CACnC;CAAG;AAEJ,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAgB;;IAkB3B,YACE,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,WAAW,EAAE,kBAAkB,EAC/B,SAAS,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAqDtC;IAED,IAAW,OAAO,IAAI,IAAI,CAEzB;IAED,IAAW,OAAO,IAAI,MAAM,GAAG,IAAI,CAElC;IAED,IAAW,eAAe,IAAI,MAAM,GAAG,IAAI,CAE1C;IAED,IAAW,QAAQ,IAAI,MAAM,GAAG,IAAI,CAEnC;IAEY,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAExC;IAEY,mBAAmB,CAC9B,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACrC,OAAO,CAAC,IAAI,CAAC,CAGf;IAEM,MAAM,IAAI,IAAI,CAoBpB;CA2CF;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAWtB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED,wBAAsB,MAAM,CAC1B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAaf"}
1
+ {"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAaA,OAAO,EAGL,eAAe,EACf,KAAK,YAAY,EACjB,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAgEtB,MAAM,WAAW,WAAY,SAAQ,OAAO,CAC1C,UAAU,CAAC,OAAO,eAAe,CAAC,CACnC;CAAG;AAEJ,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,OAAO,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,qBAAa,gBAAgB;;IAkB3B,YACE,OAAO,EAAE,YAAY,EACrB,IAAI,EAAE,SAAS,MAAM,EAAE,EACvB,WAAW,EAAE,kBAAkB,EAC/B,SAAS,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,EAqDtC;IAED,IAAW,OAAO,IAAI,IAAI,CAEzB;IAED,IAAW,OAAO,IAAI,MAAM,GAAG,IAAI,CAElC;IAED,IAAW,eAAe,IAAI,MAAM,GAAG,IAAI,CAE1C;IAED,IAAW,QAAQ,IAAI,MAAM,GAAG,IAAI,CAEnC;IAEY,IAAI,IAAI,OAAO,CAAC,WAAW,CAAC,CAExC;IAEY,mBAAmB,CAC9B,OAAO,GAAE;QAAE,UAAU,CAAC,EAAE,OAAO,CAAA;KAAO,GACrC,OAAO,CAAC,IAAI,CAAC,CAGf;IAEM,MAAM,IAAI,IAAI,CAoBpB;CA2CF;AAED,wBAAsB,WAAW,CAC/B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,WAAW,CAAC,CAWtB;AAED,wBAAsB,aAAa,CACjC,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,aAAa,CAAC,CAgBxB;AAED,wBAAsB,MAAM,CAC1B,OAAO,EAAE,YAAY,EACrB,WAAW,EAAE,kBAAkB,EAC/B,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,IAAI,CAAC,CAaf"}
package/dist/auth.js CHANGED
@@ -4,6 +4,7 @@ import { readFile } from "node:fs/promises";
4
4
  import { homedir } from "node:os";
5
5
  import { join, resolve } from "node:path";
6
6
  import { parse } from "smol-toml";
7
+ import { forwardExternalImportSetting } from "./external-imports-feature.js";
7
8
  import { CodexSecurityError, PluginBootstrapError, errorMessage, } from "./errors.js";
8
9
  import { executablePathForSpawn, expandHome, runCodexCommand, } from "./runtime.js";
9
10
  const LOGIN_CHILD_TERMINATION_GRACE_MS = 1_000;
@@ -17,7 +18,9 @@ export function environmentEntry(environment, requested) {
17
18
  }
18
19
  /** @internal */
19
20
  export function withoutOpenAiApiKeys(environment) {
20
- return Object.fromEntries(Object.entries(environment).filter(([name]) => !["OPENAI_API_KEY", "CODEX_API_KEY"].includes(name.toUpperCase())));
21
+ const child = Object.fromEntries(Object.entries(environment).filter(([name]) => !["OPENAI_API_KEY", "CODEX_API_KEY"].includes(name.toUpperCase())));
22
+ forwardExternalImportSetting(environment, child);
23
+ return child;
21
24
  }
22
25
  /** @internal */
23
26
  export function configuredCodexHome(environment) {
package/dist/auth.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn, type ChildProcessWithoutNullStreams } from \"node:child_process\";\nimport { isIP } from \"node:net\";\nimport { readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { join, resolve } from \"node:path\";\nimport { parse } from \"smol-toml\";\nimport type { JsonObject } from \"./config.js\";\nimport {\n CodexSecurityError,\n PluginBootstrapError,\n errorMessage,\n} from \"./errors.js\";\nimport {\n executablePathForSpawn,\n expandHome,\n runCodexCommand,\n type CodexCommand,\n type ProcessEnvironment,\n} from \"./runtime.js\";\n\nconst LOGIN_CHILD_TERMINATION_GRACE_MS = 1_000;\n\n/** @internal */\nexport function environmentEntry(\n environment: ProcessEnvironment,\n requested: string,\n): string | undefined {\n const exact = environment[requested];\n if (exact !== undefined || process.platform !== \"win32\") return exact;\n const upper = requested.toUpperCase();\n return Object.entries(environment).find(\n ([name]) => name.toUpperCase() === upper,\n )?.[1];\n}\n\n/** @internal */\nexport function withoutOpenAiApiKeys<Value>(\n environment: Record<string, Value>,\n): Record<string, Value> {\n return Object.fromEntries(\n Object.entries(environment).filter(\n ([name]) =>\n ![\"OPENAI_API_KEY\", \"CODEX_API_KEY\"].includes(name.toUpperCase()),\n ),\n );\n}\n\n/** @internal */\nexport function configuredCodexHome(environment: ProcessEnvironment): string {\n const configured = environmentEntry(environment, \"CODEX_HOME\");\n return resolve(\n expandHome(\n configured?.trim() ? configured : join(homedir(), \".codex\"),\n environment,\n ),\n );\n}\n\n/** @internal */\nexport async function readCodexHomeConfig(\n environment: ProcessEnvironment,\n signal?: AbortSignal,\n): Promise<JsonObject> {\n try {\n return parse(\n await readFile(join(configuredCodexHome(environment), \"config.toml\"), {\n encoding: \"utf8\",\n signal,\n }),\n ) as JsonObject;\n } catch (error) {\n signal?.throwIfAborted();\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return {};\n throw new CodexSecurityError(\n `Could not read the configured Codex provider: ${errorMessage(error)}`,\n { cause: error },\n );\n }\n}\n\nexport interface LoginResult extends Awaited<\n ReturnType<typeof runCodexCommand>\n> {}\n\nexport interface AccountStatus {\n authenticated: boolean;\n details: string;\n}\n\nexport class CodexLoginHandle {\n readonly #child: ChildProcessWithoutNullStreams;\n readonly #completion: Promise<LoginResult>;\n readonly #urlReady = Promise.withResolvers<void>();\n readonly #deviceReady = Promise.withResolvers<void>();\n #canceled = false;\n #forcedTermination: ReturnType<typeof setTimeout> | undefined;\n readonly #output = { stdout: \"\", stderr: \"\" };\n readonly #tails = { stdout: \"\", stderr: \"\" };\n readonly #urls: Record<\"stdout\" | \"stderr\", string | null> = {\n stdout: null,\n stderr: null,\n };\n readonly #codes: Record<\"stdout\" | \"stderr\", string | null> = {\n stdout: null,\n stderr: null,\n };\n\n public constructor(\n command: CodexCommand,\n args: readonly string[],\n environment: ProcessEnvironment,\n onSuccess: () => void | Promise<void>,\n ) {\n void this.#urlReady.promise.catch(() => undefined);\n void this.#deviceReady.promise.catch(() => undefined);\n this.#child = spawn(\n executablePathForSpawn(command.command),\n [...(command.args ?? []), ...args],\n {\n env: environment,\n stdio: [\"pipe\", \"pipe\", \"pipe\"],\n windowsHide: true,\n },\n );\n this.#child.stdin.end();\n this.#child.stdout.setEncoding(\"utf8\");\n this.#child.stderr.setEncoding(\"utf8\");\n this.#child.stdout.on(\"data\", (chunk: string) => {\n this.#recordOutput(\"stdout\", chunk);\n });\n this.#child.stderr.on(\"data\", (chunk: string) => {\n this.#recordOutput(\"stderr\", chunk);\n });\n this.#completion = new Promise((resolve, reject) => {\n this.#child.once(\"close\", (exitCode) => {\n clearTimeout(this.#forcedTermination);\n if (!this.#canceled) {\n this.#flushInstructionTails();\n }\n const result = {\n success: exitCode === 0 && !this.#canceled,\n exitCode,\n ...this.#output,\n };\n this.#settleInstructionWaiters(result);\n if (result.success) {\n Promise.resolve()\n .then(onSuccess)\n .then(() => resolve(result), reject);\n } else {\n resolve(result);\n }\n });\n this.#child.once(\"error\", (error) => {\n clearTimeout(this.#forcedTermination);\n this.#settleInstructionWaiters({\n success: false,\n exitCode: null,\n stdout: this.#output.stdout,\n stderr: error.message,\n });\n reject(error);\n });\n });\n }\n\n public get loginId(): null {\n return null;\n }\n\n public get authUrl(): string | null {\n return this.#urls.stdout ?? this.#urls.stderr;\n }\n\n public get verificationUrl(): string | null {\n return this.authUrl;\n }\n\n public get userCode(): string | null {\n return this.#codes.stdout ?? this.#codes.stderr;\n }\n\n public async wait(): Promise<LoginResult> {\n return await this.#completion;\n }\n\n public async waitForInstructions(\n options: { deviceCode?: boolean } = {},\n ): Promise<void> {\n await (options.deviceCode === true ? this.#deviceReady : this.#urlReady)\n .promise;\n }\n\n public cancel(): void {\n this.#canceled = true;\n if (this.#child.exitCode !== null || this.#child.signalCode !== null) {\n // Descendants can retain inherited pipes after the login process exits.\n // Cancellation must release those pipes so the close event can settle.\n this.#child.stdin.destroy();\n this.#child.stdout.destroy();\n this.#child.stderr.destroy();\n return;\n }\n this.#child.kill(\"SIGTERM\");\n if (this.#forcedTermination !== undefined) return;\n this.#forcedTermination = setTimeout(() => {\n if (this.#child.exitCode === null && this.#child.signalCode === null) {\n this.#child.kill(\"SIGKILL\");\n }\n this.#child.stdin.destroy();\n this.#child.stdout.destroy();\n this.#child.stderr.destroy();\n }, LOGIN_CHILD_TERMINATION_GRACE_MS);\n }\n\n #recordOutput(stream: \"stdout\" | \"stderr\", chunk: string): void {\n this.#output[stream] += chunk;\n const output = `${this.#tails[stream]}${chunk.replaceAll(\"\\r\", \"\\n\")}`;\n const lastDelimiter = output.lastIndexOf(\"\\n\");\n const completed =\n lastDelimiter === -1 ? \"\" : output.slice(0, lastDelimiter + 1);\n this.#urls[stream] ??= preferredAuthUrl(completed);\n this.#codes[stream] ??= userCodeFromOutput(completed);\n this.#tails[stream] =\n lastDelimiter === -1 ? output : output.slice(lastDelimiter + 1);\n this.#notifyInstructions();\n }\n\n #flushInstructionTails(): void {\n for (const stream of [\"stdout\", \"stderr\"] as const) {\n this.#urls[stream] ??= preferredAuthUrl(this.#tails[stream]);\n this.#codes[stream] ??= userCodeFromOutput(this.#tails[stream]);\n }\n }\n\n #notifyInstructions(): void {\n if (this.authUrl !== null) this.#urlReady.resolve();\n if (this.verificationUrl !== null && this.userCode !== null)\n this.#deviceReady.resolve();\n }\n\n #settleInstructionWaiters(result: LoginResult): void {\n this.#notifyInstructions();\n if (result.success) {\n this.#urlReady.resolve();\n this.#deviceReady.resolve();\n return;\n }\n const error = new PluginBootstrapError(\n this.#canceled\n ? \"Codex login was canceled.\"\n : `Codex login exited before authentication instructions were available: ${result.stderr.trim() || result.stdout.trim() || result.exitCode || \"unknown error\"}`,\n );\n this.#urlReady.reject(error);\n this.#deviceReady.reject(error);\n }\n}\n\nexport async function loginApiKey(\n command: CodexCommand,\n environment: ProcessEnvironment,\n apiKey: string,\n signal?: AbortSignal,\n): Promise<LoginResult> {\n if (apiKey.trim().length === 0) {\n throw new PluginBootstrapError(\"The API key must be non-empty.\");\n }\n return await runCodexCommand(\n command,\n [\"login\", \"--with-api-key\"],\n environment,\n `${apiKey}\\n`,\n signal,\n );\n}\n\nexport async function accountStatus(\n command: CodexCommand,\n environment: ProcessEnvironment,\n signal?: AbortSignal,\n): Promise<AccountStatus> {\n const result = await runCodexCommand(\n command,\n [\"login\", \"status\"],\n environment,\n undefined,\n signal,\n );\n const details = [result.stdout.trim(), result.stderr.trim()]\n .filter(Boolean)\n .join(\"\\n\");\n return {\n authenticated:\n result.exitCode === 0 && !/not logged in|unauthenticated/i.test(details),\n details,\n };\n}\n\nexport async function logout(\n command: CodexCommand,\n environment: ProcessEnvironment,\n signal?: AbortSignal,\n): Promise<void> {\n const result = await runCodexCommand(\n command,\n [\"logout\"],\n environment,\n undefined,\n signal,\n );\n if (!result.success) {\n throw new PluginBootstrapError(\n `Codex logout failed: ${result.stderr.trim() || result.stdout.trim() || \"unknown error\"}`,\n );\n }\n}\n\n/** @internal Authentication settings shared by login and model commands. */\nexport const CODEX_AUTH_CONFIG_KEYS = [\n \"cli_auth_credentials_store\",\n \"forced_login_method\",\n \"forced_chatgpt_workspace_id\",\n] as const;\n\n/** @internal Shared login recovery guidance for model commands. */\nexport const NO_CREDENTIALS_MESSAGE =\n \"No credentials were found. Run 'codex-security login'. On a remote or headless \" +\n \"machine, use 'codex-security login --device-auth' if your workspace allows it. \" +\n \"If device auth is disabled, see 'codex-security login --help' for browser login over SSH. \" +\n \"For CI, set OPENAI_API_KEY or CODEX_API_KEY.\";\n\nfunction preferredAuthUrl(value: string): string | null {\n for (const match of plainTerminalText(value).matchAll(\n /https?:\\/\\/[^\\s<>\"']+/g,\n )) {\n const url = match[0].replace(/[.,;:!?)\\]}]+$/, \"\");\n try {\n const parsed = new URL(url);\n const hostname = parsed.hostname.toLowerCase().replace(/\\.$/, \"\");\n if (\n parsed.protocol === \"https:\" &&\n hostname !== \"localhost\" &&\n !hostname.endsWith(\".localhost\") &&\n !(isIP(hostname) === 4 && hostname.startsWith(\"127.\")) &&\n hostname !== \"0.0.0.0\" &&\n hostname !== \"[::1]\" &&\n hostname !== \"[::]\" &&\n hostname !== \"[::ffff:0:0]\" &&\n !hostname.startsWith(\"[::ffff:7f\") &&\n !hostname.startsWith(\"[::7f\")\n ) {\n return url;\n }\n } catch {\n continue;\n }\n }\n return null;\n}\n\nfunction userCodeFromOutput(value: string): string | null {\n const output = plainTerminalText(value).replace(/https?:\\/\\/[^\\s<>\"']+/g, \"\");\n return (\n output.match(/(?:code|user code)\\s*[:=]\\s*([A-Z0-9-]{4,})/i)?.[1] ??\n output.match(/\\b[A-Z0-9]{4,}(?:-[A-Z0-9]{4,})+\\b/)?.[0] ??\n null\n );\n}\n\nfunction plainTerminalText(value: string): string {\n return value\n .replace(/\\u001b\\][^\\u0007]*(?:\\u0007|\\u001b\\\\)/g, \"\")\n .replace(/\\u001b\\[[0-?]*[ -/]*[@-~]/g, \"\")\n .replace(/\\r/g, \"\");\n}\n"]}
1
+ {"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn, type ChildProcessWithoutNullStreams } from \"node:child_process\";\nimport { isIP } from \"node:net\";\nimport { readFile } from \"node:fs/promises\";\nimport { homedir } from \"node:os\";\nimport { join, resolve } from \"node:path\";\nimport { parse } from \"smol-toml\";\nimport { forwardExternalImportSetting } from \"./external-imports-feature.js\";\nimport type { JsonObject } from \"./config.js\";\nimport {\n CodexSecurityError,\n PluginBootstrapError,\n errorMessage,\n} from \"./errors.js\";\nimport {\n executablePathForSpawn,\n expandHome,\n runCodexCommand,\n type CodexCommand,\n type ProcessEnvironment,\n} from \"./runtime.js\";\n\nconst LOGIN_CHILD_TERMINATION_GRACE_MS = 1_000;\n\n/** @internal */\nexport function environmentEntry(\n environment: ProcessEnvironment,\n requested: string,\n): string | undefined {\n const exact = environment[requested];\n if (exact !== undefined || process.platform !== \"win32\") return exact;\n const upper = requested.toUpperCase();\n return Object.entries(environment).find(\n ([name]) => name.toUpperCase() === upper,\n )?.[1];\n}\n\n/** @internal */\nexport function withoutOpenAiApiKeys<Value>(\n environment: Record<string, Value>,\n): Record<string, Value> {\n const child = Object.fromEntries(\n Object.entries(environment).filter(\n ([name]) =>\n ![\"OPENAI_API_KEY\", \"CODEX_API_KEY\"].includes(name.toUpperCase()),\n ),\n );\n forwardExternalImportSetting(environment, child);\n return child;\n}\n\n/** @internal */\nexport function configuredCodexHome(environment: ProcessEnvironment): string {\n const configured = environmentEntry(environment, \"CODEX_HOME\");\n return resolve(\n expandHome(\n configured?.trim() ? configured : join(homedir(), \".codex\"),\n environment,\n ),\n );\n}\n\n/** @internal */\nexport async function readCodexHomeConfig(\n environment: ProcessEnvironment,\n signal?: AbortSignal,\n): Promise<JsonObject> {\n try {\n return parse(\n await readFile(join(configuredCodexHome(environment), \"config.toml\"), {\n encoding: \"utf8\",\n signal,\n }),\n ) as JsonObject;\n } catch (error) {\n signal?.throwIfAborted();\n if ((error as NodeJS.ErrnoException).code === \"ENOENT\") return {};\n throw new CodexSecurityError(\n `Could not read the configured Codex provider: ${errorMessage(error)}`,\n { cause: error },\n );\n }\n}\n\nexport interface LoginResult extends Awaited<\n ReturnType<typeof runCodexCommand>\n> {}\n\nexport interface AccountStatus {\n authenticated: boolean;\n details: string;\n}\n\nexport class CodexLoginHandle {\n readonly #child: ChildProcessWithoutNullStreams;\n readonly #completion: Promise<LoginResult>;\n readonly #urlReady = Promise.withResolvers<void>();\n readonly #deviceReady = Promise.withResolvers<void>();\n #canceled = false;\n #forcedTermination: ReturnType<typeof setTimeout> | undefined;\n readonly #output = { stdout: \"\", stderr: \"\" };\n readonly #tails = { stdout: \"\", stderr: \"\" };\n readonly #urls: Record<\"stdout\" | \"stderr\", string | null> = {\n stdout: null,\n stderr: null,\n };\n readonly #codes: Record<\"stdout\" | \"stderr\", string | null> = {\n stdout: null,\n stderr: null,\n };\n\n public constructor(\n command: CodexCommand,\n args: readonly string[],\n environment: ProcessEnvironment,\n onSuccess: () => void | Promise<void>,\n ) {\n void this.#urlReady.promise.catch(() => undefined);\n void this.#deviceReady.promise.catch(() => undefined);\n this.#child = spawn(\n executablePathForSpawn(command.command),\n [...(command.args ?? []), ...args],\n {\n env: environment,\n stdio: [\"pipe\", \"pipe\", \"pipe\"],\n windowsHide: true,\n },\n );\n this.#child.stdin.end();\n this.#child.stdout.setEncoding(\"utf8\");\n this.#child.stderr.setEncoding(\"utf8\");\n this.#child.stdout.on(\"data\", (chunk: string) => {\n this.#recordOutput(\"stdout\", chunk);\n });\n this.#child.stderr.on(\"data\", (chunk: string) => {\n this.#recordOutput(\"stderr\", chunk);\n });\n this.#completion = new Promise((resolve, reject) => {\n this.#child.once(\"close\", (exitCode) => {\n clearTimeout(this.#forcedTermination);\n if (!this.#canceled) {\n this.#flushInstructionTails();\n }\n const result = {\n success: exitCode === 0 && !this.#canceled,\n exitCode,\n ...this.#output,\n };\n this.#settleInstructionWaiters(result);\n if (result.success) {\n Promise.resolve()\n .then(onSuccess)\n .then(() => resolve(result), reject);\n } else {\n resolve(result);\n }\n });\n this.#child.once(\"error\", (error) => {\n clearTimeout(this.#forcedTermination);\n this.#settleInstructionWaiters({\n success: false,\n exitCode: null,\n stdout: this.#output.stdout,\n stderr: error.message,\n });\n reject(error);\n });\n });\n }\n\n public get loginId(): null {\n return null;\n }\n\n public get authUrl(): string | null {\n return this.#urls.stdout ?? this.#urls.stderr;\n }\n\n public get verificationUrl(): string | null {\n return this.authUrl;\n }\n\n public get userCode(): string | null {\n return this.#codes.stdout ?? this.#codes.stderr;\n }\n\n public async wait(): Promise<LoginResult> {\n return await this.#completion;\n }\n\n public async waitForInstructions(\n options: { deviceCode?: boolean } = {},\n ): Promise<void> {\n await (options.deviceCode === true ? this.#deviceReady : this.#urlReady)\n .promise;\n }\n\n public cancel(): void {\n this.#canceled = true;\n if (this.#child.exitCode !== null || this.#child.signalCode !== null) {\n // Descendants can retain inherited pipes after the login process exits.\n // Cancellation must release those pipes so the close event can settle.\n this.#child.stdin.destroy();\n this.#child.stdout.destroy();\n this.#child.stderr.destroy();\n return;\n }\n this.#child.kill(\"SIGTERM\");\n if (this.#forcedTermination !== undefined) return;\n this.#forcedTermination = setTimeout(() => {\n if (this.#child.exitCode === null && this.#child.signalCode === null) {\n this.#child.kill(\"SIGKILL\");\n }\n this.#child.stdin.destroy();\n this.#child.stdout.destroy();\n this.#child.stderr.destroy();\n }, LOGIN_CHILD_TERMINATION_GRACE_MS);\n }\n\n #recordOutput(stream: \"stdout\" | \"stderr\", chunk: string): void {\n this.#output[stream] += chunk;\n const output = `${this.#tails[stream]}${chunk.replaceAll(\"\\r\", \"\\n\")}`;\n const lastDelimiter = output.lastIndexOf(\"\\n\");\n const completed =\n lastDelimiter === -1 ? \"\" : output.slice(0, lastDelimiter + 1);\n this.#urls[stream] ??= preferredAuthUrl(completed);\n this.#codes[stream] ??= userCodeFromOutput(completed);\n this.#tails[stream] =\n lastDelimiter === -1 ? output : output.slice(lastDelimiter + 1);\n this.#notifyInstructions();\n }\n\n #flushInstructionTails(): void {\n for (const stream of [\"stdout\", \"stderr\"] as const) {\n this.#urls[stream] ??= preferredAuthUrl(this.#tails[stream]);\n this.#codes[stream] ??= userCodeFromOutput(this.#tails[stream]);\n }\n }\n\n #notifyInstructions(): void {\n if (this.authUrl !== null) this.#urlReady.resolve();\n if (this.verificationUrl !== null && this.userCode !== null)\n this.#deviceReady.resolve();\n }\n\n #settleInstructionWaiters(result: LoginResult): void {\n this.#notifyInstructions();\n if (result.success) {\n this.#urlReady.resolve();\n this.#deviceReady.resolve();\n return;\n }\n const error = new PluginBootstrapError(\n this.#canceled\n ? \"Codex login was canceled.\"\n : `Codex login exited before authentication instructions were available: ${result.stderr.trim() || result.stdout.trim() || result.exitCode || \"unknown error\"}`,\n );\n this.#urlReady.reject(error);\n this.#deviceReady.reject(error);\n }\n}\n\nexport async function loginApiKey(\n command: CodexCommand,\n environment: ProcessEnvironment,\n apiKey: string,\n signal?: AbortSignal,\n): Promise<LoginResult> {\n if (apiKey.trim().length === 0) {\n throw new PluginBootstrapError(\"The API key must be non-empty.\");\n }\n return await runCodexCommand(\n command,\n [\"login\", \"--with-api-key\"],\n environment,\n `${apiKey}\\n`,\n signal,\n );\n}\n\nexport async function accountStatus(\n command: CodexCommand,\n environment: ProcessEnvironment,\n signal?: AbortSignal,\n): Promise<AccountStatus> {\n const result = await runCodexCommand(\n command,\n [\"login\", \"status\"],\n environment,\n undefined,\n signal,\n );\n const details = [result.stdout.trim(), result.stderr.trim()]\n .filter(Boolean)\n .join(\"\\n\");\n return {\n authenticated:\n result.exitCode === 0 && !/not logged in|unauthenticated/i.test(details),\n details,\n };\n}\n\nexport async function logout(\n command: CodexCommand,\n environment: ProcessEnvironment,\n signal?: AbortSignal,\n): Promise<void> {\n const result = await runCodexCommand(\n command,\n [\"logout\"],\n environment,\n undefined,\n signal,\n );\n if (!result.success) {\n throw new PluginBootstrapError(\n `Codex logout failed: ${result.stderr.trim() || result.stdout.trim() || \"unknown error\"}`,\n );\n }\n}\n\n/** @internal Authentication settings shared by login and model commands. */\nexport const CODEX_AUTH_CONFIG_KEYS = [\n \"cli_auth_credentials_store\",\n \"forced_login_method\",\n \"forced_chatgpt_workspace_id\",\n] as const;\n\n/** @internal Shared login recovery guidance for model commands. */\nexport const NO_CREDENTIALS_MESSAGE =\n \"No credentials were found. Run 'codex-security login'. On a remote or headless \" +\n \"machine, use 'codex-security login --device-auth' if your workspace allows it. \" +\n \"If device auth is disabled, see 'codex-security login --help' for browser login over SSH. \" +\n \"For CI, set OPENAI_API_KEY or CODEX_API_KEY.\";\n\nfunction preferredAuthUrl(value: string): string | null {\n for (const match of plainTerminalText(value).matchAll(\n /https?:\\/\\/[^\\s<>\"']+/g,\n )) {\n const url = match[0].replace(/[.,;:!?)\\]}]+$/, \"\");\n try {\n const parsed = new URL(url);\n const hostname = parsed.hostname.toLowerCase().replace(/\\.$/, \"\");\n if (\n parsed.protocol === \"https:\" &&\n hostname !== \"localhost\" &&\n !hostname.endsWith(\".localhost\") &&\n !(isIP(hostname) === 4 && hostname.startsWith(\"127.\")) &&\n hostname !== \"0.0.0.0\" &&\n hostname !== \"[::1]\" &&\n hostname !== \"[::]\" &&\n hostname !== \"[::ffff:0:0]\" &&\n !hostname.startsWith(\"[::ffff:7f\") &&\n !hostname.startsWith(\"[::7f\")\n ) {\n return url;\n }\n } catch {\n continue;\n }\n }\n return null;\n}\n\nfunction userCodeFromOutput(value: string): string | null {\n const output = plainTerminalText(value).replace(/https?:\\/\\/[^\\s<>\"']+/g, \"\");\n return (\n output.match(/(?:code|user code)\\s*[:=]\\s*([A-Z0-9-]{4,})/i)?.[1] ??\n output.match(/\\b[A-Z0-9]{4,}(?:-[A-Z0-9]{4,})+\\b/)?.[0] ??\n null\n );\n}\n\nfunction plainTerminalText(value: string): string {\n return value\n .replace(/\\u001b\\][^\\u0007]*(?:\\u0007|\\u001b\\\\)/g, \"\")\n .replace(/\\u001b\\[[0-?]*[ -/]*[@-~]/g, \"\")\n .replace(/\\r/g, \"\");\n}\n"]}
@@ -3,11 +3,11 @@ import { type SeverityDecision } from "./severity-review.js";
3
3
  /** Versioned input for repository-free classification of canonical records. */
4
4
  export declare const classifySeverityRecordsInputSchema: z.ZodObject<{
5
5
  version: z.ZodLiteral<1>;
6
- rubric: z.ZodObject<{
6
+ rubric: z.ZodOptional<z.ZodObject<{
7
7
  revision: z.ZodNumber;
8
8
  markdown: z.ZodString;
9
9
  sha256: z.ZodString;
10
- }, z.core.$strict>;
10
+ }, z.core.$strict>>;
11
11
  model: z.ZodString;
12
12
  effort: z.ZodEnum<{
13
13
  high: "high";
@@ -36,6 +36,8 @@ export interface SeverityClassificationReviewRequest {
36
36
  schema: unknown;
37
37
  }
38
38
  export interface ClassifySeverityRecordsOptions {
39
+ /** Independent reviews per record: integer 1–10, default 3. */
40
+ classificationRuns?: number;
39
41
  reviewRunner: {
40
42
  run(request: SeverityClassificationReviewRequest, options?: {
41
43
  signal?: AbortSignal;
@@ -49,6 +51,7 @@ export type CanonicalSeverityAssessment = Omit<SeverityDecision, "findingId"> &
49
51
  inputSha256: string;
50
52
  };
51
53
  interface RecordsResultBinding {
54
+ classificationRuns: number;
52
55
  version: 1;
53
56
  rubric: {
54
57
  revision: number;
@@ -1 +1 @@
1
- {"version":3,"file":"classify-severity-records.d.ts","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAIL,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAwB9B,+EAA+E;AAC/E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;kBA+BpC,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,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,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,CAmFxC"}
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;AAwB9B,+EAA+E;AAC/E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;kBAgCpC,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,CAuFxC"}
@@ -1,8 +1,9 @@
1
1
  import { SCAN_SEVERITIES } from "./scan-settings.js";
2
+ import { defaultSeverityRubric } from "./default-severity-rubric.js";
2
3
  import { createHash, randomUUID } from "node:crypto";
3
4
  import { z } from "zod";
4
5
  import { abortable } from "./targets.js";
5
- import { parseSeverityDecision, severityDecisionSchema, severityReviewInstructions, } from "./severity-review.js";
6
+ import { parseSeverityDecision, reviewSeverity, classificationRunsSchema, severityDecisionSchema, severityReviewInstructions, } from "./severity-review.js";
6
7
  const text = z
7
8
  .string()
8
9
  .refine((value) => value.trim().length > 0, "Must not be blank.");
@@ -34,7 +35,8 @@ export const classifySeverityRecordsInputSchema = z
34
35
  markdown: text,
35
36
  sha256: digest,
36
37
  })
37
- .strict(),
38
+ .strict()
39
+ .optional(),
38
40
  model: text,
39
41
  effort: z.enum([
40
42
  "minimal",
@@ -64,8 +66,16 @@ function sha256(value) {
64
66
  */
65
67
  export async function classifySeverityRecords(input, options) {
66
68
  options.signal?.throwIfAborted();
69
+ const classificationRuns = classificationRunsSchema
70
+ .default(3)
71
+ .parse(options.classificationRuns);
67
72
  const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));
68
- if (sha256(data.rubric.markdown) !== data.rubric.sha256)
73
+ const rubric = data.rubric ?? {
74
+ revision: 1,
75
+ markdown: defaultSeverityRubric,
76
+ sha256: sha256(defaultSeverityRubric),
77
+ };
78
+ if (sha256(rubric.markdown) !== rubric.sha256)
69
79
  throw new Error("Rubric SHA-256 does not match its exact UTF-8 Markdown.");
70
80
  const ids = new Set();
71
81
  for (const record of data.records) {
@@ -79,43 +89,34 @@ export async function classifySeverityRecords(input, options) {
79
89
  throw new Error("The report findingId must equal its canonical record ID.");
80
90
  }
81
91
  const binding = {
92
+ classificationRuns,
82
93
  version: 1,
83
- rubric: { revision: data.rubric.revision, sha256: data.rubric.sha256 },
94
+ rubric: { revision: rubric.revision, sha256: rubric.sha256 },
84
95
  };
85
96
  const assessments = [];
86
97
  for (const record of data.records) {
87
98
  options.signal?.throwIfAborted();
88
- let response;
99
+ let code = "review_failed";
89
100
  try {
90
- response = await abortable(() => {
101
+ const { findingId: _findingId, ...decision } = await reviewSeverity(async () => {
102
+ code = "review_failed";
103
+ const response = await abortable(() => {
104
+ options.signal?.throwIfAborted();
105
+ return options.reviewRunner.run({
106
+ requestId: randomUUID(),
107
+ stage: "severity-classification",
108
+ model: data.model,
109
+ effort: data.effort,
110
+ trustedInstructions: severityReviewInstructions,
111
+ prompt: `{"rubric":${JSON.stringify([rubric.markdown])},"knowledgeBase":null,"finding":${record.findingJson}}`,
112
+ schema: z.toJSONSchema(severityDecisionSchema),
113
+ }, { signal: options.signal });
114
+ }, options.signal);
91
115
  options.signal?.throwIfAborted();
92
- return options.reviewRunner.run({
93
- requestId: randomUUID(),
94
- stage: "severity-classification",
95
- model: data.model,
96
- effort: data.effort,
97
- trustedInstructions: severityReviewInstructions,
98
- prompt: `{"rubric":${JSON.stringify([data.rubric.markdown])},"knowledgeBase":null,"finding":${record.findingJson}}`,
99
- schema: z.toJSONSchema(severityDecisionSchema),
100
- }, { signal: options.signal });
101
- }, options.signal);
102
- }
103
- catch (error) {
116
+ code = "invalid_assessment";
117
+ return parseSeverityDecision(response, record.id);
118
+ }, classificationRuns);
104
119
  options.signal?.throwIfAborted();
105
- return {
106
- ...binding,
107
- status: "unresolved",
108
- assessments: [],
109
- error: {
110
- recordId: record.id,
111
- code: "review_failed",
112
- message: error instanceof Error ? error.message : "Host review failed.",
113
- },
114
- };
115
- }
116
- options.signal?.throwIfAborted();
117
- try {
118
- const { findingId: _findingId, ...decision } = parseSeverityDecision(response, record.id);
119
120
  assessments.push({
120
121
  ...decision,
121
122
  id: record.id,
@@ -124,14 +125,19 @@ export async function classifySeverityRecords(input, options) {
124
125
  });
125
126
  }
126
127
  catch (error) {
128
+ options.signal?.throwIfAborted();
127
129
  return {
128
130
  ...binding,
129
131
  status: "unresolved",
130
132
  assessments: [],
131
133
  error: {
132
134
  recordId: record.id,
133
- code: "invalid_assessment",
134
- message: error instanceof Error ? error.message : "Invalid assessment.",
135
+ code,
136
+ message: error instanceof Error
137
+ ? error.message
138
+ : code === "review_failed"
139
+ ? "Host review failed."
140
+ : "Invalid assessment.",
135
141
  },
136
142
  };
137
143
  }
@@ -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 { createHash, randomUUID } from \"node:crypto\";\nimport { z } from \"zod\";\nimport { abortable } from \"./targets.js\";\nimport {\n parseSeverityDecision,\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();\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: z\n .object({\n revision: revision.positive(),\n markdown: text,\n sha256: digest,\n })\n .strict(),\n model: text,\n effort: z.enum([\n \"minimal\",\n \"low\",\n \"medium\",\n \"high\",\n \"xhigh\",\n \"max\",\n \"ultra\",\n ]),\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 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 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 data = classifySeverityRecordsInputSchema.parse(structuredClone(input));\n if (sha256(data.rubric.markdown) !== data.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 version: 1,\n rubric: { revision: data.rubric.revision, sha256: data.rubric.sha256 },\n };\n const assessments: CanonicalSeverityAssessment[] = [];\n for (const record of data.records) {\n options.signal?.throwIfAborted();\n let response: unknown;\n try {\n 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([data.rubric.markdown])},\"knowledgeBase\":null,\"finding\":${record.findingJson}}`,\n schema: z.toJSONSchema(severityDecisionSchema),\n },\n { signal: options.signal },\n );\n }, options.signal);\n } catch (error) {\n options.signal?.throwIfAborted();\n return {\n ...binding,\n status: \"unresolved\",\n assessments: [],\n error: {\n recordId: record.id,\n code: \"review_failed\",\n message:\n error instanceof Error ? error.message : \"Host review failed.\",\n },\n };\n }\n options.signal?.throwIfAborted();\n try {\n const { findingId: _findingId, ...decision } = parseSeverityDecision(\n response,\n record.id,\n );\n assessments.push({\n ...decision,\n id: record.id,\n revision: record.revision,\n inputSha256: record.inputSha256,\n });\n } catch (error) {\n return {\n ...binding,\n status: \"unresolved\",\n assessments: [],\n error: {\n recordId: record.id,\n code: \"invalid_assessment\",\n message:\n error instanceof Error ? error.message : \"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":"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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 classificationRunsSchema,\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();\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: z\n .object({\n revision: revision.positive(),\n markdown: text,\n sha256: digest,\n })\n .strict()\n .optional(),\n model: text,\n effort: z.enum([\n \"minimal\",\n \"low\",\n \"medium\",\n \"high\",\n \"xhigh\",\n \"max\",\n \"ultra\",\n ]),\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 = classificationRunsSchema\n .default(3)\n .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"]}
@@ -5,8 +5,10 @@ import { severityDecisionSchema as decisionSchema } from "./severity-review.js";
5
5
  /** Full reports and explicitly supplied context from any finding source. */
6
6
  export type SeverityClassificationFinding = Pick<Finding, "findingId" | "title" | "summary"> & Partial<Pick<Finding, "occurrenceId" | "severity">> & Record<string, unknown>;
7
7
  export interface ClassifySeverityOptions extends Pick<ReadOnlyCodexOptions, "config" | "environment" | "model" | "reasoningEffort" | "signal" | "workingDirectory"> {
8
- /** Classification policy. Omit to inherit existing severity without a model call. */
8
+ /** Classification policy override. Omit to use the built-in severity rubric. */
9
9
  rubricPath?: string;
10
+ /** Independent reviews per finding: integer 1–10, default 3. */
11
+ classificationRuns?: number;
10
12
  /** Supporting evidence, separate from classification policy. */
11
13
  knowledgeBasePaths?: readonly string[];
12
14
  }
@@ -18,6 +20,8 @@ export interface SeverityAssessment extends z.infer<typeof decisionSchema> {
18
20
  export interface SeverityClassification {
19
21
  schemaVersion: 1;
20
22
  assessedAt: string;
23
+ /** Absent on legacy results whose review count was not recorded. */
24
+ classificationRuns?: number;
21
25
  rubricSha256: string | null;
22
26
  knowledgeBaseSha256: string | null;
23
27
  assessments: SeverityAssessment[];
@@ -1 +1 @@
1
- {"version":3,"file":"classify-severity.d.ts","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"AAEA,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,EAGzC,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,qFAAqF;IACrF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,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,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAiCD,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":"AAEA,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,EAKzC,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,gFAAgF;IAChF,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,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAiCD,yFAAyF;AACzF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,EAClD,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAEjC"}
@@ -1,13 +1,12 @@
1
- import { SCAN_SEVERITIES } from "./scan-settings.js";
1
+ import { defaultSeverityRubric } from "./default-severity-rubric.js";
2
2
  import { findingEntry } from "./value.js";
3
3
  import { z } from "zod";
4
4
  import { CodexSecurityError } from "./errors.js";
5
5
  import { workflowDigest } from "./finding-workflow.js";
6
6
  import { readKnowledgeBaseDocuments } from "./knowledge-base.js";
7
7
  import { runReadOnlyCodex, } from "./scan-comparison.js";
8
- import { severityDecisionSchema as decisionSchema, severityReviewInstructions, parseSeverityDecision, } from "./severity-review.js";
8
+ import { severityDecisionSchema as decisionSchema, severityReviewInstructions, parseSeverityDecision, reviewSeverity, classificationRunsSchema, } from "./severity-review.js";
9
9
  import { CODEX_SECURITY_THREAD_SOURCES } from "./thread-source.js";
10
- const levelSchema = z.enum(SCAN_SEVERITIES);
11
10
  const textSchema = z
12
11
  .string()
13
12
  .min(1)
@@ -17,6 +16,7 @@ const digestSchema = z.string().regex(/^[a-f0-9]{64}$/u);
17
16
  export const severityClassificationSchema = z.strictObject({
18
17
  schemaVersion: z.literal(1),
19
18
  assessedAt: z.string().datetime(),
19
+ classificationRuns: classificationRunsSchema.optional(),
20
20
  rubricSha256: digestSchema.nullable(),
21
21
  knowledgeBaseSha256: digestSchema.nullable(),
22
22
  assessments: z.array(decisionSchema.extend({
@@ -32,6 +32,9 @@ export async function classifySeverity(findings, options = {}) {
32
32
  /** @internal */
33
33
  export async function classifySeverityInternal(findings, options = {}, surface = "sdk", checkpoint) {
34
34
  options.signal?.throwIfAborted();
35
+ const classificationRuns = classificationRunsSchema
36
+ .default(3)
37
+ .parse(options.classificationRuns);
35
38
  const ids = new Set();
36
39
  for (const finding of findings) {
37
40
  if (!finding.findingId?.trim() || ids.has(finding.findingId)) {
@@ -40,15 +43,16 @@ export async function classifySeverityInternal(findings, options = {}, surface =
40
43
  ids.add(finding.findingId);
41
44
  }
42
45
  const rubric = options.rubricPath === undefined
43
- ? null
46
+ ? [defaultSeverityRubric]
44
47
  : await readDocuments([options.rubricPath], options.signal);
45
48
  const knowledge = options.knowledgeBasePaths?.length
46
49
  ? await readDocuments(options.knowledgeBasePaths, options.signal)
47
50
  : null;
48
51
  const result = {
49
52
  schemaVersion: 1,
53
+ classificationRuns,
50
54
  assessedAt: new Date().toISOString(),
51
- rubricSha256: rubric === null ? null : workflowDigest(rubric),
55
+ rubricSha256: workflowDigest(rubric),
52
56
  knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),
53
57
  assessments: [],
54
58
  };
@@ -64,45 +68,31 @@ export async function classifySeverityInternal(findings, options = {}, surface =
64
68
  result.assessments.push(previous);
65
69
  continue;
66
70
  }
67
- let decision;
68
- if (rubric === null) {
69
- const parsed = levelSchema.safeParse(finding.severity?.level);
70
- if (!parsed.success) {
71
- throw new CodexSecurityError(`Finding ${finding.findingId} has no existing severity; supply a rubric.`);
72
- }
73
- decision = {
74
- findingId: finding.findingId,
75
- decision: "assessed",
76
- level: parsed.data,
77
- rubricLabel: null,
78
- rationale: finding.severity?.rationale?.trim() ||
79
- "Inherited the finding's existing severity.",
80
- confidence: null,
81
- reviewTrigger: finding.severity?.changeConditions?.trim() || null,
82
- };
83
- }
84
- else {
85
- const response = await runReadOnlyCodex([
86
- severityReviewInstructions,
87
- JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),
88
- ].join("\n\n"), z.toJSONSchema(decisionSchema), options, {
71
+ const prompt = [
72
+ severityReviewInstructions,
73
+ JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),
74
+ ].join("\n\n");
75
+ const decision = await reviewSeverity(async () => {
76
+ options.signal?.throwIfAborted();
77
+ const response = await runReadOnlyCodex(prompt, z.toJSONSchema(decisionSchema), options, {
89
78
  surface,
90
79
  command: "classify-severity",
91
80
  threadSource: CODEX_SECURITY_THREAD_SOURCES.severityClassification,
92
81
  });
93
82
  options.signal?.throwIfAborted();
94
83
  try {
95
- decision = parseSeverityDecision(JSON.parse(response), finding.findingId);
84
+ return parseSeverityDecision(JSON.parse(response), finding.findingId);
96
85
  }
97
86
  catch (error) {
98
87
  throw new CodexSecurityError("Severity classification returned an invalid assessment.", { cause: error });
99
88
  }
100
- }
89
+ }, classificationRuns);
90
+ options.signal?.throwIfAborted();
101
91
  const assessment = {
102
92
  ...decision,
103
93
  occurrenceId: finding.occurrenceId ?? null,
104
94
  inputSha256,
105
- source: rubric === null ? "existing-severity" : "rubric",
95
+ source: "rubric",
106
96
  };
107
97
  await checkpoint?.save(finding, assessment, result);
108
98
  result.assessments.push(assessment);
@@ -1 +1 @@
1
- {"version":3,"file":"classify-severity.js","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"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","sourcesContent":["import { SCAN_SEVERITIES } from \"./scan-settings.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} 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 /** Classification policy. Omit to inherit existing severity without a model call. */\n rubricPath?: string;\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 rubricSha256: string | null;\n knowledgeBaseSha256: string | null;\n assessments: SeverityAssessment[];\n}\n\n/** @internal Per-finding persistence used by saved-scan classification. */\nexport interface SeverityClassificationCheckpoint {\n load(result: SeverityClassification): Promise<SeverityAssessment[]>;\n save(\n finding: SeverityClassificationFinding,\n assessment: SeverityAssessment,\n result: SeverityClassification,\n ): Promise<void>;\n}\n\nconst levelSchema = z.enum(SCAN_SEVERITIES);\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 rubricSha256: digestSchema.nullable(),\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 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 const rubric =\n options.rubricPath === undefined\n ? null\n : await readDocuments([options.rubricPath], options.signal);\n const knowledge = options.knowledgeBasePaths?.length\n ? await readDocuments(options.knowledgeBasePaths, options.signal)\n : null;\n const result: SeverityClassification = {\n schemaVersion: 1,\n assessedAt: new Date().toISOString(),\n rubricSha256: rubric === null ? null : workflowDigest(rubric),\n knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),\n assessments: [],\n };\n const cached = new Map((await checkpoint?.load(result))?.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 let decision: z.infer<typeof decisionSchema>;\n if (rubric === null) {\n const parsed = levelSchema.safeParse(finding.severity?.level);\n if (!parsed.success) {\n throw new CodexSecurityError(\n `Finding ${finding.findingId} has no existing severity; supply a rubric.`,\n );\n }\n decision = {\n findingId: finding.findingId,\n decision: \"assessed\",\n level: parsed.data,\n rubricLabel: null,\n rationale:\n finding.severity?.rationale?.trim() ||\n \"Inherited the finding's existing severity.\",\n confidence: null,\n reviewTrigger: finding.severity?.changeConditions?.trim() || null,\n };\n } else {\n const response = await runReadOnlyCodex(\n [\n severityReviewInstructions,\n JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),\n ].join(\"\\n\\n\"),\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 decision = parseSeverityDecision(\n JSON.parse(response),\n finding.findingId,\n );\n } catch (error) {\n throw new CodexSecurityError(\n \"Severity classification returned an invalid assessment.\",\n { cause: error },\n );\n }\n }\n const assessment: SeverityAssessment = {\n ...decision,\n occurrenceId: finding.occurrenceId ?? null,\n inputSha256,\n source: rubric === null ? \"existing-severity\" : \"rubric\",\n };\n await checkpoint?.save(finding, assessment, result);\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 { defaultSeverityRubric } from \"./default-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} 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 /** Classification policy override. Omit to use the built-in severity rubric. */\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 rubricSha256: string | null;\n knowledgeBaseSha256: string | null;\n assessments: SeverityAssessment[];\n}\n\n/** @internal Per-finding persistence used by saved-scan classification. */\nexport interface SeverityClassificationCheckpoint {\n load(result: SeverityClassification): Promise<SeverityAssessment[]>;\n save(\n finding: SeverityClassificationFinding,\n assessment: SeverityAssessment,\n result: SeverityClassification,\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 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 = classificationRunsSchema\n .default(3)\n .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 const rubric =\n options.rubricPath === undefined\n ? [defaultSeverityRubric]\n : await readDocuments([options.rubricPath], options.signal);\n const knowledge = options.knowledgeBasePaths?.length\n ? await readDocuments(options.knowledgeBasePaths, options.signal)\n : null;\n const result: SeverityClassification = {\n schemaVersion: 1,\n classificationRuns,\n assessedAt: new Date().toISOString(),\n rubricSha256: workflowDigest(rubric),\n knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),\n assessments: [],\n };\n const cached = new Map((await checkpoint?.load(result))?.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, result);\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 +1 @@
1
- {"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AA8OA,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":"AA+OA,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM,CA4HhE"}
package/dist/cli-help.js CHANGED
@@ -30,6 +30,7 @@ const SCAN_GROUPS = [
30
30
  [
31
31
  "output-dir",
32
32
  "archive-existing",
33
+ "owner-suggestions",
33
34
  "max-cost",
34
35
  "max-time",
35
36
  "show-cost",