@openai/codex-security 0.1.31 → 0.3.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 (514) hide show
  1. package/README.md +442 -2434
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
  4. package/_bundled_plugin/.mcp.json +3 -0
  5. package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
  6. package/_bundled_plugin/examples/completed-scan/report.md +28 -26
  7. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
  8. package/_bundled_plugin/mcp/helpers.mjs +1 -0
  9. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +7 -214
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +563 -0
  20. package/_bundled_plugin/mcp/server.mjs +1 -0
  21. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  22. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  23. package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
  24. package/_bundled_plugin/references/artifact-storage.md +5 -5
  25. package/_bundled_plugin/references/config-preflight.md +1 -5
  26. package/_bundled_plugin/references/core-scan.md +34 -10
  27. package/_bundled_plugin/references/final-report.md +13 -13
  28. package/_bundled_plugin/references/finding-detail-fields.md +90 -80
  29. package/_bundled_plugin/references/sarif-adapter.md +1 -1
  30. package/_bundled_plugin/references/scan-artifacts.md +3 -4
  31. package/_bundled_plugin/references/scan-contract.md +11 -6
  32. package/_bundled_plugin/references/scan-prologue.md +12 -0
  33. package/_bundled_plugin/references/security-guidance.md +2 -2
  34. package/_bundled_plugin/references/standalone-validation.md +11 -0
  35. package/_bundled_plugin/references/threat-model.md +2 -2
  36. package/_bundled_plugin/schemas/coverage.schema.json +23 -47
  37. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
  38. package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
  39. package/_bundled_plugin/schemas/findings.schema.json +71 -192
  40. package/_bundled_plugin/schemas/scan-manifest.schema.json +83 -95
  41. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  42. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  43. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  44. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  45. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  46. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +245 -356
  47. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  48. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  49. package/_bundled_plugin/scripts/config_preflight.py +29 -69
  50. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  51. package/_bundled_plugin/scripts/deep_scan_workbench.py +208 -363
  52. package/_bundled_plugin/scripts/filesystem_identity.py +1 -5
  53. package/_bundled_plugin/scripts/finalize_scan_contract.py +733 -375
  54. package/_bundled_plugin/scripts/finding_preview.py +81 -91
  55. package/_bundled_plugin/scripts/generate_in_scope_files.py +48 -102
  56. package/_bundled_plugin/scripts/generate_rank_input.py +117 -888
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -6
  58. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  59. package/_bundled_plugin/scripts/rank_preview.py +43 -902
  60. package/_bundled_plugin/scripts/report_projection.py +143 -219
  61. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  62. package/_bundled_plugin/scripts/threat_model_projection.py +161 -0
  63. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  64. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  65. package/_bundled_plugin/scripts/windows_scan_local_files.py +59 -9
  66. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  67. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  68. package/_bundled_plugin/scripts/workbench/storage.py +21 -6
  69. package/_bundled_plugin/scripts/workbench_cli.py +99 -190
  70. package/_bundled_plugin/scripts/workbench_constants.py +6 -14
  71. package/_bundled_plugin/scripts/workbench_db.py +524 -672
  72. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  73. package/_bundled_plugin/scripts/workbench_finding_index.py +20 -7
  74. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  75. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  76. package/_bundled_plugin/scripts/workbench_native_indexes.py +28 -18
  77. package/_bundled_plugin/scripts/workbench_progress.py +26 -92
  78. package/_bundled_plugin/scripts/workbench_publication.py +77 -116
  79. package/_bundled_plugin/scripts/workbench_remediation.py +14 -20
  80. package/_bundled_plugin/scripts/workbench_saved_results.py +1402 -263
  81. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  82. package/_bundled_plugin/scripts/workbench_scan_start.py +109 -52
  83. package/_bundled_plugin/scripts/workbench_scan_usage.py +30 -49
  84. package/_bundled_plugin/scripts/workbench_schema.py +71 -1370
  85. package/_bundled_plugin/scripts/workbench_source_excerpt.py +16 -7
  86. package/_bundled_plugin/scripts/workbench_target.py +526 -150
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1 -5
  88. package/_bundled_plugin/scripts/workbench_validation.py +19 -44
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  90. package/_bundled_plugin/shared/workbench-migrations.json +397 -0
  91. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  92. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  93. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  94. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  95. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +6 -6
  96. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  97. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  98. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  99. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  100. package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  104. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
  105. package/_bundled_plugin/skills/threat-model/SKILL.md +2 -2
  106. package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
  107. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  108. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  109. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  110. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  111. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  112. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  113. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  114. package/bin/codex-security.mjs +9 -2
  115. package/dist/api.d.ts +63 -15
  116. package/dist/api.d.ts.map +1 -1
  117. package/dist/api.js +970 -553
  118. package/dist/api.js.map +1 -1
  119. package/dist/artifact-export.d.ts +70 -0
  120. package/dist/artifact-export.d.ts.map +1 -0
  121. package/dist/artifact-export.js +292 -0
  122. package/dist/artifact-export.js.map +1 -0
  123. package/dist/auth.d.ts +2 -6
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +27 -12
  126. package/dist/auth.js.map +1 -1
  127. package/dist/bulk-scan-discovery.d.ts +1 -0
  128. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  129. package/dist/bulk-scan-discovery.js +9 -9
  130. package/dist/bulk-scan-discovery.js.map +1 -1
  131. package/dist/classify-scan-severity.d.ts.map +1 -1
  132. package/dist/classify-scan-severity.js +2 -5
  133. package/dist/classify-scan-severity.js.map +1 -1
  134. package/dist/classify-severity.d.ts +28 -17
  135. package/dist/classify-severity.d.ts.map +1 -1
  136. package/dist/classify-severity.js +16 -35
  137. package/dist/classify-severity.js.map +1 -1
  138. package/dist/cli-help.d.ts +3 -0
  139. package/dist/cli-help.d.ts.map +1 -0
  140. package/dist/cli-help.js +285 -0
  141. package/dist/cli-help.js.map +1 -0
  142. package/dist/cli-signals.d.ts +8 -0
  143. package/dist/cli-signals.d.ts.map +1 -0
  144. package/dist/cli-signals.js +28 -0
  145. package/dist/cli-signals.js.map +1 -0
  146. package/dist/cli.d.ts +22 -24
  147. package/dist/cli.d.ts.map +1 -1
  148. package/dist/cli.js +1660 -1556
  149. package/dist/cli.js.map +1 -1
  150. package/dist/cloud-publish.d.ts.map +1 -1
  151. package/dist/cloud-publish.js +11 -17
  152. package/dist/cloud-publish.js.map +1 -1
  153. package/dist/codeowners.d.ts +19 -0
  154. package/dist/codeowners.d.ts.map +1 -0
  155. package/dist/codeowners.js +138 -0
  156. package/dist/codeowners.js.map +1 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +1 -2
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/codex-sdk-environment.d.ts +3 -0
  161. package/dist/codex-sdk-environment.d.ts.map +1 -0
  162. package/dist/codex-sdk-environment.js +68 -0
  163. package/dist/codex-sdk-environment.js.map +1 -0
  164. package/dist/component-plan.d.ts +2 -5
  165. package/dist/component-plan.d.ts.map +1 -1
  166. package/dist/component-plan.js +38 -34
  167. package/dist/component-plan.js.map +1 -1
  168. package/dist/component-scan.d.ts +7 -5
  169. package/dist/component-scan.d.ts.map +1 -1
  170. package/dist/component-scan.js +54 -44
  171. package/dist/component-scan.js.map +1 -1
  172. package/dist/config.d.ts.map +1 -1
  173. package/dist/config.js +93 -104
  174. package/dist/config.js.map +1 -1
  175. package/dist/contract.d.ts +15 -2
  176. package/dist/contract.d.ts.map +1 -1
  177. package/dist/contract.js +124 -348
  178. package/dist/contract.js.map +1 -1
  179. package/dist/cost-model.d.ts +13 -6
  180. package/dist/cost-model.d.ts.map +1 -1
  181. package/dist/cost-model.js +75 -34
  182. package/dist/cost-model.js.map +1 -1
  183. package/dist/cost.d.ts +10 -2
  184. package/dist/cost.d.ts.map +1 -1
  185. package/dist/cost.js +116 -134
  186. package/dist/cost.js.map +1 -1
  187. package/dist/custom-validation-prompt.d.ts.map +1 -1
  188. package/dist/custom-validation-prompt.js +7 -6
  189. package/dist/custom-validation-prompt.js.map +1 -1
  190. package/dist/custom-validation.d.ts +1 -2
  191. package/dist/custom-validation.d.ts.map +1 -1
  192. package/dist/custom-validation.js +23 -16
  193. package/dist/custom-validation.js.map +1 -1
  194. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  195. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  196. package/dist/deduplication/checkpointed-review.js +33 -20
  197. package/dist/deduplication/checkpointed-review.js.map +1 -1
  198. package/dist/deduplication/codex-review.d.ts +9 -1
  199. package/dist/deduplication/codex-review.d.ts.map +1 -1
  200. package/dist/deduplication/codex-review.js +129 -20
  201. package/dist/deduplication/codex-review.js.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  203. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  204. package/dist/deduplication/deduplication-prompts.js +18 -4
  205. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
  207. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  208. package/dist/deduplication/deduplication-reviewer.js +59 -47
  209. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  210. package/dist/deduplication/deduplication.d.ts.map +1 -1
  211. package/dist/deduplication/deduplication.js +59 -113
  212. package/dist/deduplication/deduplication.js.map +1 -1
  213. package/dist/deduplication/diagnostics.d.ts +17 -0
  214. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  215. package/dist/deduplication/diagnostics.js +5 -0
  216. package/dist/deduplication/diagnostics.js.map +1 -0
  217. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  218. package/dist/deduplication/finding-schema.js +7 -1
  219. package/dist/deduplication/finding-schema.js.map +1 -1
  220. package/dist/deduplication/local.d.ts +31 -0
  221. package/dist/deduplication/local.d.ts.map +1 -0
  222. package/dist/deduplication/local.js +166 -0
  223. package/dist/deduplication/local.js.map +1 -0
  224. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  225. package/dist/deduplication/records-protocol.js +12 -28
  226. package/dist/deduplication/records-protocol.js.map +1 -1
  227. package/dist/deduplication/records.d.ts +188 -12
  228. package/dist/deduplication/records.d.ts.map +1 -1
  229. package/dist/deduplication/records.js +34 -24
  230. package/dist/deduplication/records.js.map +1 -1
  231. package/dist/deduplication/review.d.ts +7 -0
  232. package/dist/deduplication/review.d.ts.map +1 -1
  233. package/dist/deduplication/review.js.map +1 -1
  234. package/dist/deduplication/scan.d.ts +9 -3
  235. package/dist/deduplication/scan.d.ts.map +1 -1
  236. package/dist/deduplication/scan.js +159 -44
  237. package/dist/deduplication/scan.js.map +1 -1
  238. package/dist/deep-config.d.ts +2 -1
  239. package/dist/deep-config.d.ts.map +1 -1
  240. package/dist/deep-config.js +7 -23
  241. package/dist/deep-config.js.map +1 -1
  242. package/dist/deep-progress.d.ts +2 -1
  243. package/dist/deep-progress.d.ts.map +1 -1
  244. package/dist/deep-progress.js +32 -47
  245. package/dist/deep-progress.js.map +1 -1
  246. package/dist/deep-scan.d.ts +20 -0
  247. package/dist/deep-scan.d.ts.map +1 -0
  248. package/dist/deep-scan.js +113 -0
  249. package/dist/deep-scan.js.map +1 -0
  250. package/dist/errors.d.ts +5 -2
  251. package/dist/errors.d.ts.map +1 -1
  252. package/dist/errors.js +7 -7
  253. package/dist/errors.js.map +1 -1
  254. package/dist/feedback.d.ts.map +1 -1
  255. package/dist/feedback.js +53 -21
  256. package/dist/feedback.js.map +1 -1
  257. package/dist/finding-catalogue.d.ts.map +1 -1
  258. package/dist/finding-catalogue.js +26 -30
  259. package/dist/finding-catalogue.js.map +1 -1
  260. package/dist/finding-normalization.d.ts +5 -0
  261. package/dist/finding-normalization.d.ts.map +1 -0
  262. package/dist/finding-normalization.js +120 -0
  263. package/dist/finding-normalization.js.map +1 -0
  264. package/dist/finding-retrieval.d.ts +9 -0
  265. package/dist/finding-retrieval.d.ts.map +1 -1
  266. package/dist/finding-retrieval.js.map +1 -1
  267. package/dist/finding-workflow.d.ts +13 -8
  268. package/dist/finding-workflow.d.ts.map +1 -1
  269. package/dist/finding-workflow.js +18 -13
  270. package/dist/finding-workflow.js.map +1 -1
  271. package/dist/findings-client.d.ts +2 -1
  272. package/dist/findings-client.d.ts.map +1 -1
  273. package/dist/findings-client.js +36 -9
  274. package/dist/findings-client.js.map +1 -1
  275. package/dist/findings-errors.d.ts +16 -0
  276. package/dist/findings-errors.d.ts.map +1 -0
  277. package/dist/findings-errors.js +24 -0
  278. package/dist/findings-errors.js.map +1 -0
  279. package/dist/findings-import.d.ts +1 -1
  280. package/dist/findings-import.d.ts.map +1 -1
  281. package/dist/findings-import.js +16 -44
  282. package/dist/findings-import.js.map +1 -1
  283. package/dist/github.d.ts.map +1 -1
  284. package/dist/github.js +9 -4
  285. package/dist/github.js.map +1 -1
  286. package/dist/import-scan.d.ts.map +1 -1
  287. package/dist/import-scan.js +49 -39
  288. package/dist/import-scan.js.map +1 -1
  289. package/dist/index.d.ts +11 -5
  290. package/dist/index.d.ts.map +1 -1
  291. package/dist/index.js +2 -1
  292. package/dist/index.js.map +1 -1
  293. package/dist/knowledge-base.d.ts +7 -1
  294. package/dist/knowledge-base.d.ts.map +1 -1
  295. package/dist/knowledge-base.js +115 -47
  296. package/dist/knowledge-base.js.map +1 -1
  297. package/dist/linear.d.ts.map +1 -1
  298. package/dist/linear.js +4 -10
  299. package/dist/linear.js.map +1 -1
  300. package/dist/mock-scan.d.ts.map +1 -1
  301. package/dist/mock-scan.js +0 -1
  302. package/dist/mock-scan.js.map +1 -1
  303. package/dist/models.d.ts +24 -2
  304. package/dist/models.d.ts.map +1 -1
  305. package/dist/models.js.map +1 -1
  306. package/dist/multiscan.d.ts +9 -3
  307. package/dist/multiscan.d.ts.map +1 -1
  308. package/dist/multiscan.js +225 -153
  309. package/dist/multiscan.js.map +1 -1
  310. package/dist/owner-evidence.d.ts +10 -2
  311. package/dist/owner-evidence.d.ts.map +1 -1
  312. package/dist/owner-evidence.js +69 -14
  313. package/dist/owner-evidence.js.map +1 -1
  314. package/dist/patch-tui.d.ts.map +1 -1
  315. package/dist/patch-tui.js +5 -6
  316. package/dist/patch-tui.js.map +1 -1
  317. package/dist/project-config-schema.d.ts +10 -0
  318. package/dist/project-config-schema.d.ts.map +1 -1
  319. package/dist/project-config-schema.js +1 -0
  320. package/dist/project-config-schema.js.map +1 -1
  321. package/dist/project-config.d.ts +1 -0
  322. package/dist/project-config.d.ts.map +1 -1
  323. package/dist/project-config.js +5 -3
  324. package/dist/project-config.js.map +1 -1
  325. package/dist/prompt-files.d.ts +0 -1
  326. package/dist/prompt-files.d.ts.map +1 -1
  327. package/dist/prompt-files.js +2 -4
  328. package/dist/prompt-files.js.map +1 -1
  329. package/dist/provider-profile.d.ts +21 -0
  330. package/dist/provider-profile.d.ts.map +1 -0
  331. package/dist/provider-profile.js +133 -0
  332. package/dist/provider-profile.js.map +1 -0
  333. package/dist/publication-events.d.ts +6 -8
  334. package/dist/publication-events.d.ts.map +1 -1
  335. package/dist/publication-events.js +40 -79
  336. package/dist/publication-events.js.map +1 -1
  337. package/dist/publication-store.d.ts.map +1 -1
  338. package/dist/publication-store.js +48 -76
  339. package/dist/publication-store.js.map +1 -1
  340. package/dist/publication.d.ts +1 -2
  341. package/dist/publication.d.ts.map +1 -1
  342. package/dist/publication.js +7 -16
  343. package/dist/publication.js.map +1 -1
  344. package/dist/publish.d.ts +1 -5
  345. package/dist/publish.d.ts.map +1 -1
  346. package/dist/publish.js +138 -199
  347. package/dist/publish.js.map +1 -1
  348. package/dist/record.d.ts +2 -0
  349. package/dist/record.d.ts.map +1 -0
  350. package/dist/record.js +4 -0
  351. package/dist/record.js.map +1 -0
  352. package/dist/request-metadata.d.ts +9 -0
  353. package/dist/request-metadata.d.ts.map +1 -0
  354. package/dist/request-metadata.js +13 -0
  355. package/dist/request-metadata.js.map +1 -0
  356. package/dist/result.d.ts +4 -1
  357. package/dist/result.d.ts.map +1 -1
  358. package/dist/result.js +7 -0
  359. package/dist/result.js.map +1 -1
  360. package/dist/runtime.d.ts +25 -17
  361. package/dist/runtime.d.ts.map +1 -1
  362. package/dist/runtime.js +619 -255
  363. package/dist/runtime.js.map +1 -1
  364. package/dist/saved-scan-bootstrap.d.ts +14 -0
  365. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  366. package/dist/saved-scan-bootstrap.js +261 -0
  367. package/dist/saved-scan-bootstrap.js.map +1 -0
  368. package/dist/saved-scan.d.ts +1 -1
  369. package/dist/saved-scan.d.ts.map +1 -1
  370. package/dist/saved-scan.js +16 -32
  371. package/dist/saved-scan.js.map +1 -1
  372. package/dist/scan-activity.d.ts.map +1 -1
  373. package/dist/scan-activity.js +19 -30
  374. package/dist/scan-activity.js.map +1 -1
  375. package/dist/scan-comparison.d.ts +31 -18
  376. package/dist/scan-comparison.d.ts.map +1 -1
  377. package/dist/scan-comparison.js +307 -347
  378. package/dist/scan-comparison.js.map +1 -1
  379. package/dist/scan-dashboard.d.ts +3 -1
  380. package/dist/scan-dashboard.d.ts.map +1 -1
  381. package/dist/scan-dashboard.js +351 -92
  382. package/dist/scan-dashboard.js.map +1 -1
  383. package/dist/scan-history-renderer.d.ts.map +1 -1
  384. package/dist/scan-history-renderer.js +55 -15
  385. package/dist/scan-history-renderer.js.map +1 -1
  386. package/dist/scan-inputs.d.ts +6 -0
  387. package/dist/scan-inputs.d.ts.map +1 -0
  388. package/dist/scan-inputs.js +71 -0
  389. package/dist/scan-inputs.js.map +1 -0
  390. package/dist/scan-logs.d.ts +2 -3
  391. package/dist/scan-logs.d.ts.map +1 -1
  392. package/dist/scan-logs.js +14 -12
  393. package/dist/scan-logs.js.map +1 -1
  394. package/dist/scan-sessions.d.ts +4 -0
  395. package/dist/scan-sessions.d.ts.map +1 -1
  396. package/dist/scan-sessions.js +18 -3
  397. package/dist/scan-sessions.js.map +1 -1
  398. package/dist/scan-settings.d.ts +5 -0
  399. package/dist/scan-settings.d.ts.map +1 -1
  400. package/dist/scan-settings.js +4 -0
  401. package/dist/scan-settings.js.map +1 -1
  402. package/dist/scan-skill-paths.d.ts +8 -0
  403. package/dist/scan-skill-paths.d.ts.map +1 -0
  404. package/dist/scan-skill-paths.js +47 -0
  405. package/dist/scan-skill-paths.js.map +1 -0
  406. package/dist/security-policy-cli.d.ts.map +1 -1
  407. package/dist/security-policy-cli.js +15 -33
  408. package/dist/security-policy-cli.js.map +1 -1
  409. package/dist/security-policy.d.ts +17 -9
  410. package/dist/security-policy.d.ts.map +1 -1
  411. package/dist/security-policy.js +131 -98
  412. package/dist/security-policy.js.map +1 -1
  413. package/dist/server/api.d.ts +0 -1
  414. package/dist/server/api.d.ts.map +1 -1
  415. package/dist/server/api.js +0 -1
  416. package/dist/server/api.js.map +1 -1
  417. package/dist/server/embeddings.d.ts +3 -1
  418. package/dist/server/embeddings.d.ts.map +1 -1
  419. package/dist/server/embeddings.js +11 -3
  420. package/dist/server/embeddings.js.map +1 -1
  421. package/dist/server/errors.d.ts +5 -2
  422. package/dist/server/errors.d.ts.map +1 -1
  423. package/dist/server/errors.js +7 -0
  424. package/dist/server/errors.js.map +1 -1
  425. package/dist/server/sqlite-store.d.ts +0 -2
  426. package/dist/server/sqlite-store.d.ts.map +1 -1
  427. package/dist/server/sqlite-store.js +55 -55
  428. package/dist/server/sqlite-store.js.map +1 -1
  429. package/dist/server/storage.d.ts +0 -2
  430. package/dist/server/storage.d.ts.map +1 -1
  431. package/dist/server/storage.js.map +1 -1
  432. package/dist/severity-store.js +20 -32
  433. package/dist/severity-store.js.map +1 -1
  434. package/dist/standalone-validation-prompt.d.ts +2 -0
  435. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  436. package/dist/standalone-validation-prompt.js +10 -0
  437. package/dist/standalone-validation-prompt.js.map +1 -0
  438. package/dist/suggest-owners.d.ts +6 -5
  439. package/dist/suggest-owners.d.ts.map +1 -1
  440. package/dist/suggest-owners.js +15 -10
  441. package/dist/suggest-owners.js.map +1 -1
  442. package/dist/targets.d.ts +12 -0
  443. package/dist/targets.d.ts.map +1 -1
  444. package/dist/targets.js +124 -62
  445. package/dist/targets.js.map +1 -1
  446. package/dist/trusted-executable.d.ts +6 -1
  447. package/dist/trusted-executable.d.ts.map +1 -1
  448. package/dist/trusted-executable.js +28 -9
  449. package/dist/trusted-executable.js.map +1 -1
  450. package/dist/value.d.ts +2 -0
  451. package/dist/value.d.ts.map +1 -0
  452. package/dist/value.js +27 -0
  453. package/dist/value.js.map +1 -0
  454. package/dist/version.d.ts.map +1 -1
  455. package/dist/version.js +3 -6
  456. package/dist/version.js.map +1 -1
  457. package/dist/windows-path.d.ts.map +1 -1
  458. package/dist/windows-path.js +1 -2
  459. package/dist/windows-path.js.map +1 -1
  460. package/dist/workbench-arguments.d.ts +3 -0
  461. package/dist/workbench-arguments.d.ts.map +1 -0
  462. package/dist/workbench-arguments.js +15 -0
  463. package/dist/workbench-arguments.js.map +1 -0
  464. package/dist/worker-progress.d.ts +2 -0
  465. package/dist/worker-progress.d.ts.map +1 -1
  466. package/dist/worker-progress.js +40 -46
  467. package/dist/worker-progress.js.map +1 -1
  468. package/docs/cli.md +1778 -0
  469. package/docs/dedupe-records.md +24 -0
  470. package/docs/findings-service.md +402 -0
  471. package/package.json +23 -23
  472. package/schemas/project-config.schema.json +5 -0
  473. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  474. package/_bundled_plugin/scripts/normalize_candidates.py +0 -338
  475. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  476. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  477. package/_bundled_plugin/scripts/workbench_severity.py +0 -119
  478. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  479. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  480. package/dist/server/dashboard/app.css +0 -2
  481. package/dist/server/dashboard/app.js +0 -66
  482. package/dist/server/dashboard/index.html +0 -18
  483. package/dist/server/dashboard-types.d.ts +0 -48
  484. package/dist/server/dashboard-types.d.ts.map +0 -1
  485. package/dist/server/dashboard-types.js +0 -2
  486. package/dist/server/dashboard-types.js.map +0 -1
  487. package/dist/server/dashboard.d.ts +0 -6
  488. package/dist/server/dashboard.d.ts.map +0 -1
  489. package/dist/server/dashboard.js +0 -59
  490. package/dist/server/dashboard.js.map +0 -1
  491. package/dist/server/findings-service.d.ts +0 -20
  492. package/dist/server/findings-service.d.ts.map +0 -1
  493. package/dist/server/findings-service.js +0 -31
  494. package/dist/server/findings-service.js.map +0 -1
  495. package/dist/server/index.d.ts +0 -2
  496. package/dist/server/index.d.ts.map +0 -1
  497. package/dist/server/index.js +0 -6
  498. package/dist/server/index.js.map +0 -1
  499. package/dist/server/routes.d.ts +0 -6
  500. package/dist/server/routes.d.ts.map +0 -1
  501. package/dist/server/routes.js +0 -86
  502. package/dist/server/routes.js.map +0 -1
  503. package/dist/server/serve.d.ts +0 -2
  504. package/dist/server/serve.d.ts.map +0 -1
  505. package/dist/server/serve.js +0 -28
  506. package/dist/server/serve.js.map +0 -1
  507. package/dist/server/server.d.ts +0 -10
  508. package/dist/server/server.d.ts.map +0 -1
  509. package/dist/server/server.js +0 -17
  510. package/dist/server/server.js.map +0 -1
  511. package/dist/server/validation.d.ts +0 -17
  512. package/dist/server/validation.d.ts.map +0 -1
  513. package/dist/server/validation.js +0 -53
  514. package/dist/server/validation.js.map +0 -1
@@ -1,221 +0,0 @@
1
- """Storage operations for complete findings imported without a scan."""
2
-
3
- from __future__ import annotations
4
-
5
- import argparse
6
- import hashlib
7
- import json
8
- import math
9
- import sqlite3
10
- import sys
11
- from pathlib import Path
12
- from typing import Any
13
-
14
- sys.path.insert(0, str(Path(__file__).resolve().parent))
15
- from workbench_finding_index import upsert_finding
16
-
17
-
18
- def store_findings(
19
- connection: sqlite3.Connection,
20
- entries: list[dict[str, Any]],
21
- timestamp: str,
22
- repository_id: str | None = None,
23
- ) -> dict[str, Any]:
24
- try:
25
- with connection:
26
- connection.execute("BEGIN IMMEDIATE")
27
- for entry in entries:
28
- finding = entry["finding"]
29
- embedding = entry["embedding"]
30
- identity = (
31
- finding["fingerprints"]["primary"],
32
- finding["ruleId"],
33
- finding["identity"]["anchor"],
34
- finding["identity"].get("instance"),
35
- )
36
- current = connection.execute(
37
- "SELECT fingerprint, rule_id, identity_anchor, identity_instance "
38
- "FROM findings WHERE id = ?",
39
- (finding["findingId"],),
40
- ).fetchone()
41
- if current is not None and tuple(current) != identity:
42
- raise sqlite3.IntegrityError("The stored finding identity cannot be replaced.")
43
- upsert_finding(connection, finding, timestamp, repository_id)
44
- connection.execute(
45
- """
46
- INSERT INTO finding_embeddings (finding_id, model, vector_json)
47
- VALUES (?, ?, ?)
48
- ON CONFLICT(finding_id) DO UPDATE SET
49
- model = excluded.model, vector_json = excluded.vector_json
50
- """,
51
- (
52
- finding["findingId"],
53
- embedding["model"],
54
- json.dumps(embedding["vector"], allow_nan=False),
55
- ),
56
- )
57
- except sqlite3.IntegrityError:
58
- return {"error": "finding_conflict"}
59
- return {"findingIds": [entry["finding"]["findingId"] for entry in entries]}
60
-
61
-
62
- def list_stored_findings(
63
- connection: sqlite3.Connection, *, limit: int, offset: int
64
- ) -> dict[str, Any]:
65
- connection.execute("BEGIN")
66
- with connection:
67
- total = connection.execute(
68
- "SELECT COUNT(*) FROM findings WHERE details_json IS NOT NULL"
69
- ).fetchone()[0]
70
- rows = connection.execute(
71
- """
72
- SELECT details_json FROM findings WHERE details_json IS NOT NULL
73
- ORDER BY created_at, id LIMIT ? OFFSET ?
74
- """,
75
- (limit, offset),
76
- ).fetchall()
77
- next_offset = offset + len(rows)
78
- return {
79
- "findings": [json.loads(row["details_json"]) for row in rows],
80
- "limit": limit,
81
- "offset": offset,
82
- "total": total,
83
- "nextOffset": next_offset if next_offset < total else None,
84
- }
85
-
86
-
87
- def find_potential_duplicates(
88
- connection: sqlite3.Connection, finding_id: str, repository_id: str | None
89
- ) -> dict[str, Any]:
90
- """Rank IDs and vectors in the requested scope before loading finding documents."""
91
- connection.execute("BEGIN")
92
- with connection:
93
- if repository_id is None:
94
- source = "finding_embeddings AS embeddings"
95
- predicate = ""
96
- scope_parameters: tuple[str, ...] = ()
97
- else:
98
- source = (
99
- "finding_repositories AS repositories JOIN finding_embeddings AS embeddings "
100
- "ON embeddings.finding_id = repositories.finding_id"
101
- )
102
- predicate = "repositories.repository_id = ? AND "
103
- scope_parameters = (repository_id,)
104
- anchor = connection.execute(
105
- f"SELECT embeddings.model, embeddings.vector_json FROM {source} "
106
- f"WHERE {predicate}embeddings.finding_id = ?",
107
- (*scope_parameters, finding_id),
108
- ).fetchone()
109
- if anchor is None:
110
- return {"error": "finding_not_indexed"}
111
- rows = connection.execute(
112
- f"SELECT embeddings.finding_id, embeddings.vector_json FROM {source} "
113
- "JOIN findings ON findings.id = embeddings.finding_id "
114
- f"WHERE {predicate}embeddings.model = ? AND embeddings.finding_id != ? "
115
- "ORDER BY findings.created_at, findings.id",
116
- (*scope_parameters, anchor["model"], finding_id),
117
- )
118
- ranked: list[tuple[str, float]] = []
119
- try:
120
- vector = normalized_vector(json.loads(anchor["vector_json"]))
121
- for row in rows:
122
- candidate = json.loads(row["vector_json"])
123
- if len(candidate) != len(vector):
124
- continue
125
- other = normalized_vector(candidate)
126
- similarity = sum(left * right for left, right in zip(vector, other))
127
- if similarity >= 0.55:
128
- ranked.append((row["finding_id"], similarity))
129
- except ValueError:
130
- return {"error": "embedding_failed"}
131
- # Stable sorting retains insertion-time / finding-ID order for ties.
132
- ranked.sort(key=lambda candidate: candidate[1], reverse=True)
133
- selected_ids = [finding_id, *(candidate[0] for candidate in ranked[:50])]
134
- documents = {
135
- row["id"]: json.loads(row["details_json"])
136
- for row in connection.execute(
137
- "SELECT id, details_json FROM findings WHERE id IN ("
138
- + ",".join("?" for _ in selected_ids)
139
- + ")",
140
- selected_ids,
141
- )
142
- }
143
- return {
144
- "finding": documents[finding_id],
145
- "potentialDuplicates": [documents[id] for id in selected_ids[1:]],
146
- }
147
-
148
-
149
- def store_dedupe_groups(
150
- connection: sqlite3.Connection, groups: list[list[str]], timestamp: str
151
- ) -> dict[str, Any]:
152
- """Persist reviewed sets independently, including overlapping groups, in one transaction."""
153
- stored: dict[str, dict[str, Any]] = {}
154
- try:
155
- with connection:
156
- connection.execute("BEGIN IMMEDIATE")
157
- for group in groups:
158
- members = sorted(set(group))
159
- # Membership, not input order, identifies a group on retries.
160
- group_id = (
161
- "fdg_"
162
- + hashlib.sha256(
163
- json.dumps(members, ensure_ascii=True, separators=(",", ":")).encode(
164
- "utf-8"
165
- )
166
- ).hexdigest()
167
- )
168
- connection.execute(
169
- "INSERT INTO finding_dedupe_groups (id, created_at) VALUES (?, ?) "
170
- "ON CONFLICT(id) DO NOTHING",
171
- (group_id, timestamp),
172
- )
173
- connection.executemany(
174
- "INSERT INTO finding_dedupe_group_members (group_id, finding_id) VALUES (?, ?) "
175
- "ON CONFLICT(group_id, finding_id) DO NOTHING",
176
- ((group_id, finding_id) for finding_id in members),
177
- )
178
- created_at = connection.execute(
179
- "SELECT created_at FROM finding_dedupe_groups WHERE id = ?", (group_id,)
180
- ).fetchone()[0]
181
- stored[group_id] = {
182
- "groupId": group_id,
183
- "findingIds": members,
184
- "createdAt": created_at,
185
- }
186
- except sqlite3.IntegrityError:
187
- return {"error": "finding_conflict"}
188
- return {"groups": list(stored.values())}
189
-
190
-
191
- def list_dedupe_groups(connection: sqlite3.Connection, finding_id: str) -> dict[str, Any]:
192
- groups: dict[str, dict[str, Any]] = {}
193
- rows = connection.execute(
194
- """
195
- SELECT groups.id, groups.created_at, members.finding_id
196
- FROM finding_dedupe_group_members AS matched
197
- JOIN finding_dedupe_groups AS groups ON groups.id = matched.group_id
198
- JOIN finding_dedupe_group_members AS members ON members.group_id = groups.id
199
- WHERE matched.finding_id = ?
200
- ORDER BY groups.created_at, groups.id, members.finding_id
201
- """,
202
- (finding_id,),
203
- )
204
- for row in rows:
205
- group = groups.setdefault(
206
- row["id"],
207
- {"groupId": row["id"], "findingIds": [], "createdAt": row["created_at"]},
208
- )
209
- group["findingIds"].append(row["finding_id"])
210
- return {"groups": list(groups.values())}
211
-
212
-
213
- def normalized_vector(vector: list[float]) -> list[float]:
214
- norm = math.hypot(*vector)
215
- if norm == 0 or not math.isfinite(norm):
216
- raise ValueError("A stored embedding cannot be compared.")
217
- return [value / norm for value in vector]
218
-
219
-
220
- if __name__ == "__main__":
221
- argparse.ArgumentParser(description=__doc__).parse_args()
@@ -1,119 +0,0 @@
1
- """Per-finding severity checkpoints and the selection requested for each scan."""
2
-
3
- import argparse
4
- import json
5
- import sqlite3
6
- from contextlib import closing
7
- from pathlib import Path
8
- from typing import Any
9
- from urllib.parse import quote
10
-
11
- from workbench_finding_index import upsert_finding
12
-
13
- FIELDS = {
14
- "findingId": "finding_id",
15
- "occurrenceId": "occurrence_id",
16
- "inputSha256": "input_sha256",
17
- "rubricSha256": "rubric_sha256",
18
- "knowledgeBaseSha256": "knowledge_base_sha256",
19
- "assessedAt": "assessed_at",
20
- "source": "source",
21
- "decision": "decision",
22
- "level": "level",
23
- "rubricLabel": "rubric_label",
24
- "rationale": "rationale",
25
- "confidence": "confidence",
26
- "reviewTrigger": "review_trigger",
27
- }
28
-
29
-
30
- def assessments(connection: sqlite3.Connection, finding_ids: list[str]) -> list[dict[str, Any]]:
31
- rows = connection.execute(
32
- """SELECT assessment.* FROM json_each(?) AS selected
33
- JOIN finding_severity_assessments AS assessment ON assessment.finding_id = selected.value
34
- ORDER BY selected.key""",
35
- (json.dumps(finding_ids),),
36
- )
37
- return [{key: row[column] for key, column in FIELDS.items()} for row in rows]
38
-
39
-
40
- def checkpoint(
41
- connection: sqlite3.Connection, payload: dict[str, Any], timestamp: str
42
- ) -> dict[str, Any]:
43
- if payload["action"] == "begin":
44
- with connection:
45
- connection.execute(
46
- """INSERT INTO scan_severity_classifications (
47
- scan_id, finding_ids_json, assessed_at, rubric_sha256, knowledge_base_sha256
48
- ) VALUES (?, ?, ?, ?, ?)
49
- ON CONFLICT(scan_id) DO UPDATE SET
50
- finding_ids_json = excluded.finding_ids_json,
51
- assessed_at = excluded.assessed_at,
52
- rubric_sha256 = excluded.rubric_sha256,
53
- knowledge_base_sha256 = excluded.knowledge_base_sha256""",
54
- (
55
- payload["scanId"],
56
- json.dumps(payload["findingIds"]),
57
- payload["assessedAt"],
58
- payload["rubricSha256"],
59
- payload["knowledgeBaseSha256"],
60
- ),
61
- )
62
- return {"assessments": assessments(connection, payload["findingIds"])}
63
- if payload["action"] != "save":
64
- raise SystemExit("Unknown severity checkpoint action.")
65
- finding = payload["finding"]
66
- assessment = {**payload["assessment"], "assessedAt": timestamp}
67
- with connection:
68
- # External scan directories may not have been indexed on this machine.
69
- if (
70
- connection.execute(
71
- "SELECT 1 FROM findings WHERE id = ?", (finding["findingId"],)
72
- ).fetchone()
73
- is None
74
- ):
75
- upsert_finding(connection, finding, timestamp)
76
- columns = ", ".join(FIELDS.values())
77
- parameters = ", ".join("?" for _ in FIELDS)
78
- updates = ", ".join(f"{column} = excluded.{column}" for column in FIELDS.values())
79
- connection.execute(
80
- f"""INSERT INTO finding_severity_assessments ({columns})
81
- VALUES ({parameters})
82
- ON CONFLICT(finding_id) DO UPDATE SET
83
- {updates}""",
84
- tuple(assessment[key] for key in FIELDS),
85
- )
86
- return {}
87
-
88
-
89
- def read_classification(database: Path, scan_id: str) -> dict[str, Any]:
90
- uri = f"file:{quote(str(database), safe='')}?mode=ro"
91
- with closing(sqlite3.connect(uri, uri=True, timeout=5)) as connection:
92
- connection.row_factory = sqlite3.Row
93
- connection.execute("BEGIN")
94
- if (
95
- connection.execute(
96
- "SELECT 1 FROM sqlite_master WHERE type = 'table' "
97
- "AND name = 'scan_severity_classifications'"
98
- ).fetchone()
99
- is None
100
- ):
101
- return {}
102
- row = connection.execute(
103
- "SELECT * FROM scan_severity_classifications WHERE scan_id = ?", (scan_id,)
104
- ).fetchone()
105
- if row is None:
106
- return {}
107
- finding_ids = json.loads(row["finding_ids_json"])
108
- return {
109
- "scanId": scan_id,
110
- "findingIds": finding_ids,
111
- "assessedAt": row["assessed_at"],
112
- "rubricSha256": row["rubric_sha256"],
113
- "knowledgeBaseSha256": row["knowledge_base_sha256"],
114
- "assessments": assessments(connection, finding_ids),
115
- }
116
-
117
-
118
- if __name__ == "__main__":
119
- argparse.ArgumentParser(description=__doc__).parse_args()
@@ -1,163 +0,0 @@
1
- #!/usr/bin/env python3
2
- from __future__ import annotations
3
-
4
- import argparse
5
- import importlib.util
6
- import json
7
- import sys
8
- from pathlib import Path
9
- from types import ModuleType
10
- from typing import Any
11
-
12
- PLUGIN_ROOT = Path(__file__).resolve().parents[3]
13
- SCHEMA_PATH = PLUGIN_ROOT / "schemas" / "patch-risk-assessment.schema.json"
14
- NON_APPLICABLE = {"no_live_effect", "wrong_owner", "duplicate", "superseded"}
15
-
16
-
17
- def load_scan_contract_validator() -> ModuleType:
18
- script = PLUGIN_ROOT / "scripts" / "finalize_scan_contract.py"
19
- spec = importlib.util.spec_from_file_location("codex_security_scan_contract", script)
20
- if spec is None or spec.loader is None:
21
- raise RuntimeError(f"could not load scan contract validator: {script}")
22
- module = importlib.util.module_from_spec(spec)
23
- spec.loader.exec_module(module)
24
- return module
25
-
26
-
27
- SCAN_CONTRACT = load_scan_contract_validator()
28
-
29
-
30
- def parse_args() -> argparse.Namespace:
31
- parser = argparse.ArgumentParser(description="Validate a patch-risk assessment.")
32
- parser.add_argument("assessment", help="Assessment JSON path, or - for stdin.")
33
- return parser.parse_args()
34
-
35
-
36
- def reject_duplicate_keys(pairs: list[tuple[str, Any]]) -> dict[str, Any]:
37
- value: dict[str, Any] = {}
38
- for key, item in pairs:
39
- if key in value:
40
- raise ValueError(f"duplicate JSON object key: {key}")
41
- value[key] = item
42
- return value
43
-
44
-
45
- def read_object(path: str) -> dict[str, Any]:
46
- try:
47
- text = sys.stdin.read() if path == "-" else Path(path).read_text(encoding="utf-8")
48
- value = json.loads(text, object_pairs_hook=reject_duplicate_keys)
49
- except (OSError, json.JSONDecodeError) as error:
50
- raise ValueError(f"cannot read assessment: {error}") from error
51
- if not isinstance(value, dict):
52
- raise ValueError("assessment must be a JSON object")
53
- return value
54
-
55
-
56
- def schema_errors(value: dict[str, Any]) -> list[str]:
57
- try:
58
- SCAN_CONTRACT.validate_against_schema(value, SCHEMA_PATH)
59
- except (OSError, ValueError, RecursionError) as error:
60
- return [str(error)]
61
- return []
62
-
63
-
64
- def semantic_errors(value: dict[str, Any]) -> list[str]:
65
- recommendation = value["recommendation"]
66
- workflow_label = value["workflowLabel"]
67
- unknowns = value["unknowns"]
68
- evidence_plan = value["evidencePlan"]
69
- boundaries = value["materialBoundaries"]
70
- applicability_status = value["applicability"]["status"]
71
- affirmative_failure = (
72
- value["regressionLikelihood"]["rating"] == "critical"
73
- or any(item["result"] == "contradicted" for item in boundaries)
74
- or any(item["status"] == "failed" for item in value["validation"])
75
- )
76
- errors: list[str] = []
77
-
78
- if recommendation == "merge":
79
- if workflow_label not in {"auto_merge_candidate", "human_review_required"}:
80
- errors.append("merge requires an auto-merge or human-review workflow label")
81
- if value["applicability"]["status"] != "confirmed":
82
- errors.append("merge requires confirmed applicability")
83
- if any(item["decisionCritical"] for item in unknowns):
84
- errors.append("merge cannot retain a decision-critical unknown")
85
- if any(item["result"] != "supported" for item in boundaries):
86
- errors.append("merge requires every material boundary to be supported")
87
- if any(item["status"] == "failed" for item in value["validation"]):
88
- errors.append("merge cannot retain a failed validation")
89
- if evidence_plan:
90
- errors.append("merge cannot retain an evidence plan")
91
- elif workflow_label != recommendation:
92
- errors.append("non-merge workflow label must match the recommendation")
93
-
94
- if recommendation == "hold_for_evidence":
95
- if not any(item["decisionCritical"] for item in unknowns):
96
- errors.append("hold_for_evidence requires a decision-critical unknown")
97
- if not evidence_plan:
98
- errors.append("hold_for_evidence requires a bounded evidence plan")
99
- if affirmative_failure:
100
- errors.append("hold_for_evidence cannot defer an established defect")
101
- elif evidence_plan:
102
- errors.append("only hold_for_evidence may include an evidence plan")
103
-
104
- if recommendation == "no_op":
105
- if applicability_status not in NON_APPLICABLE:
106
- errors.append("no_op requires an established non-applicable disposition")
107
- if any(item["decisionCritical"] for item in unknowns):
108
- errors.append("no_op cannot retain a decision-critical unknown")
109
- elif applicability_status in NON_APPLICABLE:
110
- errors.append("an established non-applicable disposition requires no_op")
111
-
112
- if recommendation in {"revise", "block"}:
113
- if not affirmative_failure:
114
- errors.append(f"{recommendation} requires affirmative failure evidence")
115
-
116
- if workflow_label == "auto_merge_candidate":
117
- auto_merge_requirements = {
118
- "impact.rating": value["impact"]["rating"] == "low",
119
- "regressionLikelihood.rating": value["regressionLikelihood"]["rating"] == "low",
120
- "regressionProtection.rating": value["regressionProtection"]["rating"] == "strong",
121
- "regressionProtection.exactHeadChecksPassed": value["regressionProtection"][
122
- "exactHeadChecksPassed"
123
- ],
124
- "recoverability.rating": value["recoverability"]["rating"] == "easy",
125
- "confidence.rating": value["confidence"]["rating"] == "high",
126
- "applicability.status": value["applicability"]["status"] == "confirmed",
127
- "affectedRuntimeRoots": bool(value["affectedRuntimeRoots"]),
128
- "statusQuoRisk.rating": value["statusQuoRisk"]["rating"] != "unknown",
129
- "autoMergeExclusions": not value["autoMergeExclusions"],
130
- "unknowns": not unknowns,
131
- "validation": all(item["status"] == "passed" for item in value["validation"]),
132
- }
133
- for field, passed in auto_merge_requirements.items():
134
- if not passed:
135
- errors.append(f"auto_merge_candidate gate failed: {field}")
136
-
137
- return errors
138
-
139
-
140
- def validate(value: dict[str, Any]) -> list[str]:
141
- errors = schema_errors(value)
142
- if errors:
143
- return errors
144
- return semantic_errors(value)
145
-
146
-
147
- def main() -> int:
148
- args = parse_args()
149
- try:
150
- value = read_object(args.assessment)
151
- errors = validate(value)
152
- except ValueError as error:
153
- print(error, file=sys.stderr)
154
- return 1
155
- if errors:
156
- for error in errors:
157
- print(error, file=sys.stderr)
158
- return 1
159
- return 0
160
-
161
-
162
- if __name__ == "__main__":
163
- raise SystemExit(main())