@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
@@ -7,49 +7,32 @@ import csv
7
7
  import io
8
8
  import os
9
9
  import sqlite3
10
- from collections.abc import Callable
10
+ import sys
11
11
  from contextlib import closing
12
- from dataclasses import dataclass
13
12
  from pathlib import Path
14
13
  from typing import Any
15
14
  from urllib.parse import quote
16
15
 
16
+ # Some plugin hosts launch Python with safe-path isolation enabled.
17
+ sys.path.insert(0, str(Path(__file__).resolve().parent))
17
18
  from finalize_scan_contract import (
18
19
  ContractError,
20
+ SealedArtifactError,
21
+ build_threat_model_export,
19
22
  csv_cell,
20
23
  finalize_scan,
21
24
  finding_candidate_id,
25
+ finding_csv_columns,
26
+ write_export_output,
22
27
  write_sarif_projection,
23
- write_scan_local_bytes,
24
28
  )
25
29
 
26
30
 
27
- @dataclass(frozen=True)
28
- class WorkbenchPublicationContext:
29
- ARTIFACTS: dict[str, str]
30
- artifact_path: Callable[..., Path | None]
31
- available_artifact_path: Callable[[Path, Path], Path | None]
32
- database_path: Callable[[], Path]
33
- expected_coverage_mode: Callable[[sqlite3.Row], str]
34
- now: Callable[[], str]
35
- pin_legacy_manifest_digest: Callable[[sqlite3.Connection, str, str], None]
36
- published_manifest_digest: Callable[[Path, dict[str, Any]], str]
37
- read_json_object: Callable[[Path], dict[str, Any]]
38
- require_canonical_scan_directory: Callable[[Path], Path]
39
- require_recorded_manifest_digest: Callable[[sqlite3.Row, Path], str]
40
- require_scan: Callable[[sqlite3.Connection, str], sqlite3.Row]
41
- scan_result: Callable[[sqlite3.Connection, sqlite3.Row], dict[str, Any]]
42
- verify_manifest_binding: Callable[[sqlite3.Row, dict[str, Any]], None]
43
- workspace_state: Callable[[sqlite3.Connection, str], dict[str, Any]]
44
-
45
-
46
31
  def linear_publication_input(
47
- db: WorkbenchPublicationContext,
48
- args: argparse.Namespace,
32
+ payload: dict[str, Any],
49
33
  *,
50
34
  recording: bool,
51
35
  ) -> tuple[dict[str, Any], dict[str, str], list[dict[str, str]]]:
52
- payload = db.read_json_object(Path(args.input_file))
53
36
  required = {"scanId", "scanDirectory", "destination", "findings"}
54
37
  if recording:
55
38
  required.add("publications")
@@ -107,7 +90,7 @@ def linear_publication_input(
107
90
 
108
91
 
109
92
  def verify_linear_publication_scan(
110
- db: WorkbenchPublicationContext,
93
+ db: Any,
111
94
  connection: sqlite3.Connection,
112
95
  payload: dict[str, Any],
113
96
  findings: list[dict[str, str]],
@@ -153,11 +136,20 @@ def verify_linear_publication_scan(
153
136
  return scan
154
137
 
155
138
 
139
+ def _linear_publication_record(row: sqlite3.Row) -> dict[str, str]:
140
+ return {
141
+ "findingId": row["finding_id"],
142
+ "occurrenceId": row["occurrence_id"],
143
+ "issueIdentifier": row["external_id"],
144
+ **({"url": row["external_url"]} if row["external_url"] is not None else {}),
145
+ }
146
+
147
+
156
148
  def inspect_linear_publication(
157
- db: WorkbenchPublicationContext,
158
- args: argparse.Namespace,
149
+ db: Any,
150
+ payload: dict[str, Any],
159
151
  ) -> dict[str, Any]:
160
- payload, destination, findings = linear_publication_input(db, args, recording=False)
152
+ payload, destination, findings = linear_publication_input(payload, recording=False)
161
153
  database_uri = f"file:{quote(str(db.database_path()), safe='')}?mode=ro"
162
154
  with closing(sqlite3.connect(database_uri, uri=True, timeout=5)) as connection:
163
155
  connection.row_factory = sqlite3.Row
@@ -181,15 +173,7 @@ def inspect_linear_publication(
181
173
  destination.get("projectId"),
182
174
  ),
183
175
  ):
184
- recorded.setdefault(
185
- row["occurrence_id"],
186
- {
187
- "findingId": row["finding_id"],
188
- "occurrenceId": row["occurrence_id"],
189
- "issueIdentifier": row["external_id"],
190
- **({"url": row["external_url"]} if row["external_url"] is not None else {}),
191
- },
192
- )
176
+ recorded.setdefault(row["occurrence_id"], _linear_publication_record(row))
193
177
  return {
194
178
  "scanId": scan["id"],
195
179
  "destination": destination,
@@ -203,32 +187,27 @@ def inspect_linear_publication(
203
187
 
204
188
 
205
189
  def prepare_linear_publication(
206
- db: WorkbenchPublicationContext,
190
+ db: Any,
207
191
  connection: sqlite3.Connection,
208
- args: argparse.Namespace,
192
+ payload: dict[str, Any],
209
193
  ) -> dict[str, Any]:
210
- payload, destination, findings = linear_publication_input(db, args, recording=False)
194
+ payload, destination, findings = linear_publication_input(payload, recording=False)
211
195
  connection.execute("BEGIN IMMEDIATE")
212
- try:
196
+ with connection:
213
197
  scan = verify_linear_publication_scan(db, connection, payload, findings)
214
- result = {
198
+ return {
215
199
  "scanId": scan["id"],
216
200
  "destination": destination,
217
201
  "findingCount": len(findings),
218
202
  }
219
- connection.commit()
220
- except BaseException:
221
- connection.rollback()
222
- raise
223
- return result
224
203
 
225
204
 
226
205
  def record_linear_publications(
227
- db: WorkbenchPublicationContext,
206
+ db: Any,
228
207
  connection: sqlite3.Connection,
229
- args: argparse.Namespace,
208
+ payload: dict[str, Any],
230
209
  ) -> dict[str, Any]:
231
- payload, destination, findings = linear_publication_input(db, args, recording=True)
210
+ payload, destination, findings = linear_publication_input(payload, recording=True)
232
211
  publications = payload["publications"]
233
212
  if not isinstance(publications, list):
234
213
  raise SystemExit("Linear publication results must be an array.")
@@ -264,7 +243,7 @@ def record_linear_publications(
264
243
  external_ids.add(issue_identifier)
265
244
 
266
245
  connection.execute("BEGIN IMMEDIATE")
267
- try:
246
+ with connection:
268
247
  scan = verify_linear_publication_scan(db, connection, payload, findings)
269
248
  timestamp = db.now()
270
249
  for publication in publications:
@@ -340,37 +319,49 @@ def record_linear_publications(
340
319
  ).fetchone()
341
320
  if row is None:
342
321
  raise SystemExit("A created Linear issue could not be read from scan history.")
343
- created.append(
344
- {
345
- "findingId": row["finding_id"],
346
- "occurrenceId": row["occurrence_id"],
347
- "issueIdentifier": row["external_id"],
348
- **({"url": row["external_url"]} if row["external_url"] is not None else {}),
349
- }
350
- )
351
- result = {"scanId": scan["id"], "destination": destination, "created": created}
352
- connection.commit()
353
- except BaseException:
354
- connection.rollback()
355
- raise
356
- return result
322
+ created.append(_linear_publication_record(row))
323
+ return {"scanId": scan["id"], "destination": destination, "created": created}
357
324
 
358
325
 
359
326
  def export_findings(
360
- db: WorkbenchPublicationContext,
327
+ db: Any,
361
328
  connection: sqlite3.Connection,
362
329
  args: argparse.Namespace,
363
330
  ) -> dict[str, Any]:
364
331
  scan = db.require_scan(connection, args.scan_id)
365
- if scan["status"] != "complete" and not (
366
- scan["status"] == "failed" and scan["seal_manifest_digest"]
367
- ):
368
- raise SystemExit(
369
- "Findings can be exported after the scan completes or preserves stopped results."
370
- )
332
+ artifact = getattr(args, "artifact", "findings")
333
+ args.format = args.format or ("md" if artifact == "threat-model" else "csv")
334
+ if artifact == "threat-model":
335
+ if args.format != "md":
336
+ raise SystemExit("Threat models can only be exported as Markdown (md).")
337
+ else:
338
+ if args.format == "md":
339
+ raise SystemExit("Markdown export requires --artifact threat-model.")
340
+ if scan["status"] != "complete" and not (
341
+ scan["status"] == "failed" and scan["seal_manifest_digest"]
342
+ ):
343
+ raise SystemExit(
344
+ "Findings can be exported after the scan completes or preserves stopped results."
345
+ )
371
346
  scan_dir = db.require_canonical_scan_directory(Path(scan["scan_dir"]))
372
347
  db.require_recorded_manifest_digest(scan, scan_dir)
373
- db.verify_manifest_binding(scan, db.read_json_object(scan_dir / db.ARTIFACTS["manifest"]))
348
+ manifest_path = scan_dir / db.ARTIFACTS["manifest"]
349
+ db.verify_manifest_binding(scan, db.read_json_object(manifest_path))
350
+ if getattr(args, "validate_only", False):
351
+ # SDK/CLI exports use their requested destination without modifying saved artifacts.
352
+ return {"scan": {"scanId": scan["id"], "scanDir": str(scan_dir)}}
353
+ if artifact == "threat-model":
354
+ path = scan_dir / "exports" / "threatmodel.md"
355
+ try:
356
+ contents = build_threat_model_export(scan_dir)
357
+ write_export_output(scan_dir, path, "md", contents)
358
+ except ContractError as exc:
359
+ raise SystemExit(str(exc)) from exc
360
+ return {
361
+ "export": {"artifact": artifact, "format": "md", "path": str(path)},
362
+ "scan": db.scan_result(connection, scan),
363
+ "workspace": db.workspace_state(connection, scan["workspace_id"]),
364
+ }
374
365
  try:
375
366
  manifest, _, _ = finalize_scan(
376
367
  scan_dir,
@@ -401,7 +392,7 @@ def export_findings(
401
392
 
402
393
 
403
394
  def write_csv_export(
404
- db: WorkbenchPublicationContext,
395
+ db: Any,
405
396
  connection: sqlite3.Connection,
406
397
  scan: sqlite3.Row,
407
398
  ) -> Path:
@@ -422,57 +413,27 @@ def write_csv_export(
422
413
  candidate_id = finding_candidate_id(finding)
423
414
  if isinstance(occurrence_id, str) and isinstance(candidate_id, str):
424
415
  candidate_ids_by_occurrence[occurrence_id] = candidate_id
425
- columns = (
426
- "occurrence_id",
427
- "finding_id",
428
- *(("candidate_id",) if deep_scan else ()),
429
- "title",
430
- "summary",
431
- "severity",
432
- "confidence",
433
- "status",
434
- "close_reason",
435
- "note",
436
- "remediation",
437
- "path",
438
- "start_line",
439
- "end_line",
440
- )
416
+ columns = finding_csv_columns(deep_scan)
441
417
  writer.writerow(columns)
442
418
  for row in finding_export_rows(connection, scan["id"]):
443
- writer.writerow(
444
- (
445
- csv_cell(row["occurrence_id"]),
446
- csv_cell(row["finding_id"]),
447
- *(
448
- (csv_cell(candidate_ids_by_occurrence.get(row["occurrence_id"])),)
449
- if deep_scan
450
- else ()
451
- ),
452
- csv_cell(row["title"]),
453
- csv_cell(row["summary"]),
454
- csv_cell(row["severity"]),
455
- csv_cell(row["confidence"]),
456
- csv_cell(row["status"]),
457
- csv_cell(row["close_reason"]),
458
- csv_cell(row["note"]),
459
- csv_cell(row["remediation"]),
460
- csv_cell(row["relative_path"]),
461
- row["start_line"],
462
- row["end_line"],
463
- )
464
- )
419
+ values = dict(row)
420
+ values["path"] = row["relative_path"]
421
+ values["candidate_id"] = candidate_ids_by_occurrence.get(row["occurrence_id"])
422
+ writer.writerow(csv_cell(values[column]) for column in columns)
423
+ destination = scan_dir / "exports" / "findings.csv"
465
424
  try:
466
- write_scan_local_bytes(
425
+ write_export_output(
467
426
  scan_dir,
468
- "exports/findings.csv",
427
+ destination,
428
+ "csv",
469
429
  output.getvalue().encode("utf-8"),
470
430
  )
431
+ except SealedArtifactError as exc:
432
+ raise SystemExit(str(exc)) from exc
471
433
  except ContractError as exc:
472
434
  raise SystemExit(
473
435
  "exports: expected a regular directory inside the scan directory."
474
436
  ) from exc
475
- destination = scan_dir / "exports" / "findings.csv"
476
437
  path = db.available_artifact_path(scan_dir, destination)
477
438
  if path is None:
478
439
  raise SystemExit("findings.csv: expected a regular file inside the scan directory.")
@@ -34,6 +34,18 @@ def require_available(connection: sqlite3.Connection, args: Any, require_scan: A
34
34
  raise SystemExit(SCAN_STATUS_ERROR)
35
35
 
36
36
 
37
+ def require_request(
38
+ connection: sqlite3.Connection, request_id: str, occurrence: sqlite3.Row
39
+ ) -> sqlite3.Row:
40
+ current = connection.execute(
41
+ "SELECT * FROM finding_remediation_attempts WHERE request_id = ?",
42
+ (request_id,),
43
+ ).fetchone()
44
+ if current is None or current["occurrence_id"] != occurrence["id"]:
45
+ raise SystemExit("Codex Security finding remediation request not found.")
46
+ return current
47
+
48
+
37
49
  def remediation_claim_is_active(remediation: sqlite3.Row) -> bool:
38
50
  if remediation["pending_action_claim_token"] is None:
39
51
  return False
@@ -90,35 +102,25 @@ def require_pending_action(current: sqlite3.Row, requested: str) -> None:
90
102
  )
91
103
 
92
104
 
93
- def register_cancel_finding_remediation_request(subparsers: Any) -> None:
94
- parser = subparsers.add_parser("cancel-finding-remediation-request")
95
- parser.add_argument("--occurrence-id", required=True)
96
- parser.add_argument("--request-id", required=True)
97
- parser.add_argument("--action-token", required=True)
98
-
99
-
100
105
  def cancel_finding_remediation_request(
101
106
  connection: sqlite3.Connection, args: argparse.Namespace
102
107
  ) -> str:
103
108
  request_id = require_uuid(args.request_id, "request-id")
104
109
  action_token = require_uuid(args.action_token, "action-token")
105
110
  connection.execute("BEGIN IMMEDIATE")
106
- try:
111
+ with connection:
107
112
  occurrence = require_occurrence(connection, args.occurrence_id)
108
113
  current = connection.execute(
109
114
  "SELECT * FROM finding_remediation_attempts WHERE request_id = ?",
110
115
  (request_id,),
111
116
  ).fetchone()
112
117
  if current is None:
113
- connection.commit()
114
118
  return str(occurrence["scan_id"])
115
119
  if current["occurrence_id"] != occurrence["id"]:
116
120
  raise SystemExit("This remediation request belongs to a different finding.")
117
121
  if current["pending_action"] is None:
118
- connection.commit()
119
122
  return str(occurrence["scan_id"])
120
123
  if current["state"] == "failed" and current["pending_action_claim_token"] is None:
121
- connection.commit()
122
124
  return str(occurrence["scan_id"])
123
125
  if current["pending_action_claim_token"] != action_token:
124
126
  raise SystemExit("This remediation host request is owned by a different action token.")
@@ -152,10 +154,6 @@ def cancel_finding_remediation_request(
152
154
  """,
153
155
  (timestamp, request_id, action_token),
154
156
  )
155
- connection.commit()
156
- except BaseException:
157
- connection.rollback()
158
- raise
159
157
  return str(occurrence["scan_id"])
160
158
 
161
159
 
@@ -193,9 +191,5 @@ def _cancel_generation(
193
191
  )
194
192
 
195
193
 
196
- def main() -> None:
197
- argparse.ArgumentParser(description=__doc__).parse_args()
198
-
199
-
200
194
  if __name__ == "__main__":
201
- main()
195
+ argparse.ArgumentParser(description=__doc__).parse_args()