@openai/codex-security 0.2.0 → 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 (463) hide show
  1. package/README.md +437 -2692
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
  4. package/_bundled_plugin/.mcp.json +2 -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 +6 -213
  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 +2 -2
  25. package/_bundled_plugin/references/config-preflight.md +0 -4
  26. package/_bundled_plugin/references/core-scan.md +21 -9
  27. package/_bundled_plugin/references/final-report.md +10 -12
  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 +1 -2
  31. package/_bundled_plugin/references/scan-contract.md +9 -4
  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 +1 -1
  36. package/_bundled_plugin/schemas/coverage.schema.json +1 -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 +18 -45
  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 +169 -294
  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 +26 -62
  50. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  51. package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
  52. package/_bundled_plugin/scripts/finalize_scan_contract.py +315 -232
  53. package/_bundled_plugin/scripts/finding_preview.py +39 -9
  54. package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
  55. package/_bundled_plugin/scripts/generate_rank_input.py +99 -829
  56. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  58. package/_bundled_plugin/scripts/rank_preview.py +42 -918
  59. package/_bundled_plugin/scripts/report_projection.py +117 -172
  60. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  61. package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
  62. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  63. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  64. package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
  65. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  66. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  67. package/_bundled_plugin/scripts/workbench/storage.py +10 -6
  68. package/_bundled_plugin/scripts/workbench_cli.py +94 -179
  69. package/_bundled_plugin/scripts/workbench_db.py +427 -463
  70. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  71. package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
  72. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  73. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  74. package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
  75. package/_bundled_plugin/scripts/workbench_progress.py +14 -58
  76. package/_bundled_plugin/scripts/workbench_publication.py +33 -57
  77. package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
  78. package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
  79. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  80. package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
  81. package/_bundled_plugin/scripts/workbench_scan_usage.py +23 -34
  82. package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
  83. package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
  84. package/_bundled_plugin/scripts/workbench_target.py +430 -142
  85. package/_bundled_plugin/scripts/workbench_validation.py +16 -27
  86. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  87. package/_bundled_plugin/shared/workbench-migrations.json +397 -0
  88. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  89. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  90. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  91. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  92. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
  93. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  94. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  95. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  96. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  97. package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
  98. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  99. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  100. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +1 -1
  101. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
  102. package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
  103. package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
  104. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  105. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  106. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  107. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  108. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  109. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  110. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  111. package/bin/codex-security.mjs +9 -2
  112. package/dist/api.d.ts +60 -10
  113. package/dist/api.d.ts.map +1 -1
  114. package/dist/api.js +803 -380
  115. package/dist/api.js.map +1 -1
  116. package/dist/artifact-export.d.ts +1 -1
  117. package/dist/artifact-export.d.ts.map +1 -1
  118. package/dist/artifact-export.js +28 -13
  119. package/dist/artifact-export.js.map +1 -1
  120. package/dist/auth.d.ts +2 -6
  121. package/dist/auth.d.ts.map +1 -1
  122. package/dist/auth.js +19 -9
  123. package/dist/auth.js.map +1 -1
  124. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  125. package/dist/bulk-scan-discovery.js +1 -0
  126. package/dist/bulk-scan-discovery.js.map +1 -1
  127. package/dist/classify-severity.d.ts +26 -9
  128. package/dist/classify-severity.d.ts.map +1 -1
  129. package/dist/classify-severity.js +13 -30
  130. package/dist/classify-severity.js.map +1 -1
  131. package/dist/cli-help.d.ts.map +1 -1
  132. package/dist/cli-help.js +17 -13
  133. package/dist/cli-help.js.map +1 -1
  134. package/dist/cli-signals.d.ts +8 -0
  135. package/dist/cli-signals.d.ts.map +1 -0
  136. package/dist/cli-signals.js +28 -0
  137. package/dist/cli-signals.js.map +1 -0
  138. package/dist/cli.d.ts +4 -3
  139. package/dist/cli.d.ts.map +1 -1
  140. package/dist/cli.js +1087 -900
  141. package/dist/cli.js.map +1 -1
  142. package/dist/cloud-publish.d.ts.map +1 -1
  143. package/dist/cloud-publish.js +10 -9
  144. package/dist/cloud-publish.js.map +1 -1
  145. package/dist/codeowners.d.ts +19 -0
  146. package/dist/codeowners.d.ts.map +1 -0
  147. package/dist/codeowners.js +138 -0
  148. package/dist/codeowners.js.map +1 -0
  149. package/dist/codex-sdk-environment.d.ts +1 -0
  150. package/dist/codex-sdk-environment.d.ts.map +1 -1
  151. package/dist/codex-sdk-environment.js +40 -2
  152. package/dist/codex-sdk-environment.js.map +1 -1
  153. package/dist/component-plan.d.ts +2 -5
  154. package/dist/component-plan.d.ts.map +1 -1
  155. package/dist/component-plan.js +38 -30
  156. package/dist/component-plan.js.map +1 -1
  157. package/dist/component-scan.d.ts +6 -5
  158. package/dist/component-scan.d.ts.map +1 -1
  159. package/dist/component-scan.js +23 -35
  160. package/dist/component-scan.js.map +1 -1
  161. package/dist/config.d.ts.map +1 -1
  162. package/dist/config.js +64 -74
  163. package/dist/config.js.map +1 -1
  164. package/dist/contract.d.ts +15 -3
  165. package/dist/contract.d.ts.map +1 -1
  166. package/dist/contract.js +87 -252
  167. package/dist/contract.js.map +1 -1
  168. package/dist/cost-model.d.ts +13 -6
  169. package/dist/cost-model.d.ts.map +1 -1
  170. package/dist/cost-model.js +14 -4
  171. package/dist/cost-model.js.map +1 -1
  172. package/dist/cost.d.ts +10 -2
  173. package/dist/cost.d.ts.map +1 -1
  174. package/dist/cost.js +102 -104
  175. package/dist/cost.js.map +1 -1
  176. package/dist/custom-validation-prompt.d.ts.map +1 -1
  177. package/dist/custom-validation-prompt.js +6 -5
  178. package/dist/custom-validation-prompt.js.map +1 -1
  179. package/dist/custom-validation.d.ts +1 -2
  180. package/dist/custom-validation.d.ts.map +1 -1
  181. package/dist/custom-validation.js +9 -3
  182. package/dist/custom-validation.js.map +1 -1
  183. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  184. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  185. package/dist/deduplication/checkpointed-review.js +23 -9
  186. package/dist/deduplication/checkpointed-review.js.map +1 -1
  187. package/dist/deduplication/codex-review.d.ts +7 -1
  188. package/dist/deduplication/codex-review.d.ts.map +1 -1
  189. package/dist/deduplication/codex-review.js +126 -17
  190. package/dist/deduplication/codex-review.js.map +1 -1
  191. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  192. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  193. package/dist/deduplication/deduplication-prompts.js +18 -4
  194. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  195. package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
  196. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  197. package/dist/deduplication/deduplication-reviewer.js +57 -47
  198. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  199. package/dist/deduplication/deduplication.d.ts.map +1 -1
  200. package/dist/deduplication/deduplication.js +19 -51
  201. package/dist/deduplication/deduplication.js.map +1 -1
  202. package/dist/deduplication/diagnostics.d.ts +17 -0
  203. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  204. package/dist/deduplication/diagnostics.js +5 -0
  205. package/dist/deduplication/diagnostics.js.map +1 -0
  206. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  207. package/dist/deduplication/finding-schema.js +7 -1
  208. package/dist/deduplication/finding-schema.js.map +1 -1
  209. package/dist/deduplication/local.d.ts +31 -0
  210. package/dist/deduplication/local.d.ts.map +1 -0
  211. package/dist/deduplication/local.js +166 -0
  212. package/dist/deduplication/local.js.map +1 -0
  213. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  214. package/dist/deduplication/records-protocol.js +11 -24
  215. package/dist/deduplication/records-protocol.js.map +1 -1
  216. package/dist/deduplication/records.d.ts +186 -11
  217. package/dist/deduplication/records.d.ts.map +1 -1
  218. package/dist/deduplication/records.js +10 -18
  219. package/dist/deduplication/records.js.map +1 -1
  220. package/dist/deduplication/scan.d.ts +9 -3
  221. package/dist/deduplication/scan.d.ts.map +1 -1
  222. package/dist/deduplication/scan.js +158 -39
  223. package/dist/deduplication/scan.js.map +1 -1
  224. package/dist/deep-config.d.ts +2 -1
  225. package/dist/deep-config.d.ts.map +1 -1
  226. package/dist/deep-config.js +4 -4
  227. package/dist/deep-config.js.map +1 -1
  228. package/dist/deep-progress.d.ts +2 -0
  229. package/dist/deep-progress.d.ts.map +1 -1
  230. package/dist/deep-progress.js +13 -10
  231. package/dist/deep-progress.js.map +1 -1
  232. package/dist/deep-scan.d.ts +20 -0
  233. package/dist/deep-scan.d.ts.map +1 -0
  234. package/dist/deep-scan.js +113 -0
  235. package/dist/deep-scan.js.map +1 -0
  236. package/dist/errors.d.ts +2 -0
  237. package/dist/errors.d.ts.map +1 -1
  238. package/dist/errors.js +2 -0
  239. package/dist/errors.js.map +1 -1
  240. package/dist/feedback.d.ts.map +1 -1
  241. package/dist/feedback.js +53 -21
  242. package/dist/feedback.js.map +1 -1
  243. package/dist/finding-catalogue.d.ts.map +1 -1
  244. package/dist/finding-catalogue.js +4 -8
  245. package/dist/finding-catalogue.js.map +1 -1
  246. package/dist/finding-normalization.d.ts +5 -0
  247. package/dist/finding-normalization.d.ts.map +1 -0
  248. package/dist/finding-normalization.js +120 -0
  249. package/dist/finding-normalization.js.map +1 -0
  250. package/dist/finding-retrieval.d.ts +9 -0
  251. package/dist/finding-retrieval.d.ts.map +1 -1
  252. package/dist/finding-retrieval.js.map +1 -1
  253. package/dist/finding-workflow.d.ts +13 -8
  254. package/dist/finding-workflow.d.ts.map +1 -1
  255. package/dist/finding-workflow.js +14 -6
  256. package/dist/finding-workflow.js.map +1 -1
  257. package/dist/findings-client.d.ts +2 -1
  258. package/dist/findings-client.d.ts.map +1 -1
  259. package/dist/findings-client.js +36 -9
  260. package/dist/findings-client.js.map +1 -1
  261. package/dist/findings-errors.d.ts +16 -0
  262. package/dist/findings-errors.d.ts.map +1 -0
  263. package/dist/findings-errors.js +24 -0
  264. package/dist/findings-errors.js.map +1 -0
  265. package/dist/findings-import.d.ts +1 -1
  266. package/dist/findings-import.d.ts.map +1 -1
  267. package/dist/findings-import.js +12 -30
  268. package/dist/findings-import.js.map +1 -1
  269. package/dist/github.d.ts.map +1 -1
  270. package/dist/github.js +7 -1
  271. package/dist/github.js.map +1 -1
  272. package/dist/import-scan.d.ts.map +1 -1
  273. package/dist/import-scan.js +48 -38
  274. package/dist/import-scan.js.map +1 -1
  275. package/dist/index.d.ts +8 -4
  276. package/dist/index.d.ts.map +1 -1
  277. package/dist/index.js +1 -1
  278. package/dist/index.js.map +1 -1
  279. package/dist/knowledge-base.d.ts +7 -1
  280. package/dist/knowledge-base.d.ts.map +1 -1
  281. package/dist/knowledge-base.js +114 -46
  282. package/dist/knowledge-base.js.map +1 -1
  283. package/dist/linear.d.ts.map +1 -1
  284. package/dist/linear.js +2 -7
  285. package/dist/linear.js.map +1 -1
  286. package/dist/mock-scan.d.ts.map +1 -1
  287. package/dist/mock-scan.js +0 -1
  288. package/dist/mock-scan.js.map +1 -1
  289. package/dist/models.d.ts +0 -2
  290. package/dist/models.d.ts.map +1 -1
  291. package/dist/models.js.map +1 -1
  292. package/dist/multiscan.d.ts +9 -3
  293. package/dist/multiscan.d.ts.map +1 -1
  294. package/dist/multiscan.js +193 -126
  295. package/dist/multiscan.js.map +1 -1
  296. package/dist/owner-evidence.d.ts +10 -2
  297. package/dist/owner-evidence.d.ts.map +1 -1
  298. package/dist/owner-evidence.js +67 -8
  299. package/dist/owner-evidence.js.map +1 -1
  300. package/dist/patch-tui.d.ts.map +1 -1
  301. package/dist/patch-tui.js +3 -2
  302. package/dist/patch-tui.js.map +1 -1
  303. package/dist/project-config.js +3 -3
  304. package/dist/project-config.js.map +1 -1
  305. package/dist/provider-profile.d.ts +21 -0
  306. package/dist/provider-profile.d.ts.map +1 -0
  307. package/dist/provider-profile.js +133 -0
  308. package/dist/provider-profile.js.map +1 -0
  309. package/dist/publication-events.d.ts +6 -8
  310. package/dist/publication-events.d.ts.map +1 -1
  311. package/dist/publication-events.js +25 -50
  312. package/dist/publication-events.js.map +1 -1
  313. package/dist/publication-store.d.ts.map +1 -1
  314. package/dist/publication-store.js +40 -64
  315. package/dist/publication-store.js.map +1 -1
  316. package/dist/publication.d.ts +1 -2
  317. package/dist/publication.d.ts.map +1 -1
  318. package/dist/publication.js +2 -8
  319. package/dist/publication.js.map +1 -1
  320. package/dist/publish.d.ts +1 -5
  321. package/dist/publish.d.ts.map +1 -1
  322. package/dist/publish.js +109 -160
  323. package/dist/publish.js.map +1 -1
  324. package/dist/request-metadata.d.ts +9 -0
  325. package/dist/request-metadata.d.ts.map +1 -0
  326. package/dist/request-metadata.js +13 -0
  327. package/dist/request-metadata.js.map +1 -0
  328. package/dist/runtime.d.ts +15 -4
  329. package/dist/runtime.d.ts.map +1 -1
  330. package/dist/runtime.js +430 -138
  331. package/dist/runtime.js.map +1 -1
  332. package/dist/saved-scan-bootstrap.d.ts +14 -0
  333. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  334. package/dist/saved-scan-bootstrap.js +261 -0
  335. package/dist/saved-scan-bootstrap.js.map +1 -0
  336. package/dist/saved-scan.d.ts +1 -1
  337. package/dist/saved-scan.d.ts.map +1 -1
  338. package/dist/saved-scan.js +6 -12
  339. package/dist/saved-scan.js.map +1 -1
  340. package/dist/scan-activity.js +11 -8
  341. package/dist/scan-activity.js.map +1 -1
  342. package/dist/scan-comparison.d.ts +28 -15
  343. package/dist/scan-comparison.d.ts.map +1 -1
  344. package/dist/scan-comparison.js +276 -281
  345. package/dist/scan-comparison.js.map +1 -1
  346. package/dist/scan-dashboard.d.ts +3 -0
  347. package/dist/scan-dashboard.d.ts.map +1 -1
  348. package/dist/scan-dashboard.js +345 -77
  349. package/dist/scan-dashboard.js.map +1 -1
  350. package/dist/scan-history-renderer.d.ts.map +1 -1
  351. package/dist/scan-history-renderer.js +54 -13
  352. package/dist/scan-history-renderer.js.map +1 -1
  353. package/dist/scan-inputs.d.ts +6 -0
  354. package/dist/scan-inputs.d.ts.map +1 -0
  355. package/dist/scan-inputs.js +71 -0
  356. package/dist/scan-inputs.js.map +1 -0
  357. package/dist/scan-logs.d.ts +2 -3
  358. package/dist/scan-logs.d.ts.map +1 -1
  359. package/dist/scan-logs.js +12 -6
  360. package/dist/scan-logs.js.map +1 -1
  361. package/dist/scan-sessions.d.ts +4 -0
  362. package/dist/scan-sessions.d.ts.map +1 -1
  363. package/dist/scan-sessions.js +17 -0
  364. package/dist/scan-sessions.js.map +1 -1
  365. package/dist/scan-skill-paths.d.ts +8 -0
  366. package/dist/scan-skill-paths.d.ts.map +1 -0
  367. package/dist/scan-skill-paths.js +47 -0
  368. package/dist/scan-skill-paths.js.map +1 -0
  369. package/dist/security-policy-cli.d.ts.map +1 -1
  370. package/dist/security-policy-cli.js +7 -27
  371. package/dist/security-policy-cli.js.map +1 -1
  372. package/dist/security-policy.d.ts +9 -5
  373. package/dist/security-policy.d.ts.map +1 -1
  374. package/dist/security-policy.js +33 -14
  375. package/dist/security-policy.js.map +1 -1
  376. package/dist/server/api.d.ts +0 -1
  377. package/dist/server/api.d.ts.map +1 -1
  378. package/dist/server/api.js +0 -1
  379. package/dist/server/api.js.map +1 -1
  380. package/dist/server/embeddings.d.ts +3 -1
  381. package/dist/server/embeddings.d.ts.map +1 -1
  382. package/dist/server/embeddings.js +10 -3
  383. package/dist/server/embeddings.js.map +1 -1
  384. package/dist/server/errors.d.ts +5 -2
  385. package/dist/server/errors.d.ts.map +1 -1
  386. package/dist/server/errors.js +7 -0
  387. package/dist/server/errors.js.map +1 -1
  388. package/dist/server/sqlite-store.d.ts +0 -2
  389. package/dist/server/sqlite-store.d.ts.map +1 -1
  390. package/dist/server/sqlite-store.js +54 -44
  391. package/dist/server/sqlite-store.js.map +1 -1
  392. package/dist/server/storage.d.ts +0 -2
  393. package/dist/server/storage.d.ts.map +1 -1
  394. package/dist/server/storage.js.map +1 -1
  395. package/dist/severity-store.js +19 -24
  396. package/dist/severity-store.js.map +1 -1
  397. package/dist/standalone-validation-prompt.d.ts +2 -0
  398. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  399. package/dist/standalone-validation-prompt.js +10 -0
  400. package/dist/standalone-validation-prompt.js.map +1 -0
  401. package/dist/suggest-owners.d.ts +4 -2
  402. package/dist/suggest-owners.d.ts.map +1 -1
  403. package/dist/suggest-owners.js +11 -5
  404. package/dist/suggest-owners.js.map +1 -1
  405. package/dist/targets.d.ts +11 -0
  406. package/dist/targets.d.ts.map +1 -1
  407. package/dist/targets.js +106 -47
  408. package/dist/targets.js.map +1 -1
  409. package/dist/trusted-executable.d.ts +2 -2
  410. package/dist/trusted-executable.d.ts.map +1 -1
  411. package/dist/trusted-executable.js +8 -6
  412. package/dist/trusted-executable.js.map +1 -1
  413. package/dist/value.js +7 -0
  414. package/dist/value.js.map +1 -1
  415. package/dist/version.js.map +1 -1
  416. package/dist/workbench-arguments.d.ts +3 -0
  417. package/dist/workbench-arguments.d.ts.map +1 -0
  418. package/dist/workbench-arguments.js +15 -0
  419. package/dist/workbench-arguments.js.map +1 -0
  420. package/dist/worker-progress.d.ts +1 -0
  421. package/dist/worker-progress.d.ts.map +1 -1
  422. package/dist/worker-progress.js +27 -12
  423. package/dist/worker-progress.js.map +1 -1
  424. package/docs/cli.md +1778 -0
  425. package/docs/findings-service.md +402 -0
  426. package/package.json +18 -19
  427. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  428. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  429. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  430. package/_bundled_plugin/scripts/workbench_severity.py +0 -122
  431. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  432. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  433. package/dist/server/dashboard/app.css +0 -2
  434. package/dist/server/dashboard/app.js +0 -66
  435. package/dist/server/dashboard/index.html +0 -18
  436. package/dist/server/dashboard-types.d.ts +0 -48
  437. package/dist/server/dashboard-types.d.ts.map +0 -1
  438. package/dist/server/dashboard-types.js +0 -2
  439. package/dist/server/dashboard-types.js.map +0 -1
  440. package/dist/server/dashboard.d.ts +0 -6
  441. package/dist/server/dashboard.d.ts.map +0 -1
  442. package/dist/server/dashboard.js +0 -59
  443. package/dist/server/dashboard.js.map +0 -1
  444. package/dist/server/index.d.ts +0 -2
  445. package/dist/server/index.d.ts.map +0 -1
  446. package/dist/server/index.js +0 -6
  447. package/dist/server/index.js.map +0 -1
  448. package/dist/server/routes.d.ts +0 -7
  449. package/dist/server/routes.d.ts.map +0 -1
  450. package/dist/server/routes.js +0 -98
  451. package/dist/server/routes.js.map +0 -1
  452. package/dist/server/serve.d.ts +0 -2
  453. package/dist/server/serve.d.ts.map +0 -1
  454. package/dist/server/serve.js +0 -28
  455. package/dist/server/serve.js.map +0 -1
  456. package/dist/server/server.d.ts +0 -10
  457. package/dist/server/server.d.ts.map +0 -1
  458. package/dist/server/server.js +0 -16
  459. package/dist/server/server.js.map +0 -1
  460. package/dist/server/validation.d.ts +0 -17
  461. package/dist/server/validation.d.ts.map +0 -1
  462. package/dist/server/validation.js +0 -53
  463. package/dist/server/validation.js.map +0 -1
@@ -5,10 +5,12 @@ from __future__ import annotations
5
5
  import argparse
6
6
  import json
7
7
  import os
8
+ import re
8
9
  import sqlite3
9
10
  import sys
10
11
  import tempfile
11
- from collections.abc import Callable
12
+ from collections.abc import Callable, Iterator
13
+ from contextlib import contextmanager
12
14
  from datetime import datetime, timezone
13
15
  from pathlib import Path
14
16
 
@@ -16,6 +18,7 @@ from pathlib import Path
16
18
  sys.path.insert(0, str(Path(__file__).resolve().parent))
17
19
  from filesystem_identity import serialize_filesystem_identity
18
20
  from finalize_scan_contract import write_scan_local_bytes
21
+ from workbench.storage import state_dir
19
22
  from workbench_feedback import get_scan_feedback
20
23
  from workbench_target import (
21
24
  directory_content_digest,
@@ -26,10 +29,7 @@ from workbench_validation import optional_text
26
29
 
27
30
 
28
31
  def safe_segment(value: str) -> str:
29
- segment = "".join(
30
- character if character.isalnum() or character in "._-" else "-" for character in value
31
- )
32
- return segment.strip("-") or "scan"
32
+ return re.sub(r"[^\w.-]", "-", value).strip("-") or "scan"
33
33
 
34
34
 
35
35
  def compact_timestamp() -> str:
@@ -86,13 +86,16 @@ def stored_diff_target(row: sqlite3.Row) -> dict[str, str] | None:
86
86
  return target
87
87
 
88
88
 
89
+ @contextmanager
89
90
  def archive_scan(
90
91
  connection: sqlite3.Connection,
91
92
  args: argparse.Namespace,
92
93
  scan_dir: Path,
93
94
  timestamp: str,
94
95
  canonical_directory: Callable[[Path], Path],
95
- ) -> None:
96
+ *,
97
+ before_archive: Callable[[], None] | None = None,
98
+ ) -> Iterator[Path | None]:
96
99
  archived_scan_dir = (
97
100
  canonical_directory(Path(args.archived_scan_dir).expanduser())
98
101
  if args.archived_scan_dir is not None
@@ -108,44 +111,105 @@ def archive_scan(
108
111
  previous_scan = connection.execute(
109
112
  "SELECT id, status FROM scans WHERE scan_dir = ?", (str(scan_dir),)
110
113
  ).fetchone()
111
- if previous_scan is None:
112
- return
113
- if not args.archive_existing:
114
- raise SystemExit(
115
- "The scan artifact directory belongs to an existing scan. "
116
- "Use --archive-existing to preserve that scan and start a new one."
117
- )
118
- if previous_scan["status"] == "running":
119
- raise SystemExit("Cannot archive the output of a running scan.")
120
- artifacts = connection.execute(
121
- "SELECT kind, path FROM scan_artifacts WHERE scan_id = ?",
122
- (previous_scan["id"],),
123
- ).fetchall()
124
- if archived_scan_dir is None:
125
- if artifacts:
114
+ if previous_scan is not None:
115
+ if not args.archive_existing:
126
116
  raise SystemExit(
127
- "The archived scan directory is required to preserve existing scan artifacts."
117
+ "The scan artifact directory belongs to an existing scan. "
118
+ "Use --archive-existing to preserve that scan and start a new one."
128
119
  )
129
- archived_scan_dir = Path(
130
- tempfile.mkdtemp(prefix=f"{scan_dir.name}.previous-", dir=scan_dir.parent)
131
- ).resolve()
132
- connection.execute(
133
- "UPDATE scans SET scan_dir = ?, updated_at = ? WHERE id = ?",
134
- (str(archived_scan_dir), timestamp, previous_scan["id"]),
135
- )
136
- for artifact in artifacts:
137
- try:
138
- relative_path = Path(artifact["path"]).relative_to(scan_dir)
139
- except ValueError:
140
- continue
120
+ if previous_scan["status"] == "running":
121
+ raise SystemExit("Cannot archive the output of a running scan.")
122
+ has_contents = next(scan_dir.iterdir(), None) is not None
123
+ if has_contents and (not args.archive_existing or archived_scan_dir is not None):
124
+ raise SystemExit("The scan artifact directory must be empty before the scan starts.")
125
+ if previous_scan is None and not (args.archive_existing and has_contents):
126
+ yield archived_scan_dir
127
+ return
128
+ artifacts = (
141
129
  connection.execute(
142
- "UPDATE scan_artifacts SET path = ? WHERE scan_id = ? AND kind = ?",
143
- (
144
- str(archived_scan_dir / relative_path),
145
- previous_scan["id"],
146
- artifact["kind"],
147
- ),
148
- )
130
+ "SELECT kind, path FROM scan_artifacts WHERE scan_id = ?", (previous_scan["id"],)
131
+ ).fetchall()
132
+ if previous_scan is not None
133
+ else []
134
+ )
135
+ moved = False
136
+ try:
137
+ if archived_scan_dir is None:
138
+ configured_state = state_dir(canonical=False)
139
+ protected_directories = [
140
+ *(path.resolve() for path in (configured_state, *configured_state.parents)),
141
+ *(
142
+ Path(row[2]).resolve().parent
143
+ for row in connection.execute("PRAGMA database_list")
144
+ if row[2]
145
+ ),
146
+ ]
147
+ if any(path == scan_dir or scan_dir in path.parents for path in protected_directories):
148
+ raise SystemExit(
149
+ "Cannot archive output containing the workbench state or active database."
150
+ )
151
+ if artifacts and not has_contents:
152
+ raise SystemExit(
153
+ "The archived scan directory is required to preserve existing scan artifacts."
154
+ )
155
+ if before_archive is not None:
156
+ before_archive()
157
+ archived_scan_dir = Path(
158
+ tempfile.mkdtemp(prefix=f"{scan_dir.name}.previous-", dir=scan_dir.parent)
159
+ ).resolve()
160
+ archived_scan_dir.rmdir()
161
+ scan_dir.rename(archived_scan_dir)
162
+ moved = True
163
+ scan_dir.mkdir(mode=0o700)
164
+ scan_dir.chmod(0o700)
165
+ if previous_scan is not None:
166
+ connection.execute(
167
+ "UPDATE scans SET scan_dir = ?, updated_at = ? WHERE id = ?",
168
+ (str(archived_scan_dir), timestamp, previous_scan["id"]),
169
+ )
170
+ connection.execute(
171
+ """UPDATE finding_workflows SET scan_dir = ?,
172
+ results_json = CASE WHEN json_extract(results_json, '$.scan.sarifPath') = ?
173
+ THEN json_set(results_json, '$.scan.sarifPath', ?) ELSE results_json END
174
+ WHERE scan_id = ? AND scan_dir = ?""",
175
+ (
176
+ str(archived_scan_dir),
177
+ str(scan_dir / "exports" / "results.sarif"),
178
+ str(archived_scan_dir / "exports" / "results.sarif"),
179
+ previous_scan["id"],
180
+ str(scan_dir),
181
+ ),
182
+ )
183
+ for artifact in artifacts:
184
+ try:
185
+ relative_path = Path(artifact["path"]).relative_to(scan_dir)
186
+ except ValueError:
187
+ continue
188
+ connection.execute(
189
+ "UPDATE scan_artifacts SET path = ? WHERE scan_id = ? AND kind = ?",
190
+ (str(archived_scan_dir / relative_path), previous_scan["id"], artifact["kind"]),
191
+ )
192
+ # The caller commits registration before leaving this context. Older SDKs
193
+ # supplied an already-moved directory; only restore moves we own.
194
+ yield archived_scan_dir
195
+ except BaseException:
196
+ if moved:
197
+ if not connection.in_transaction:
198
+ current_owner = connection.execute(
199
+ "SELECT id FROM scans WHERE scan_dir = ?", (str(scan_dir),)
200
+ ).fetchone()
201
+ if current_owner is not None and (
202
+ previous_scan is None or current_owner["id"] != previous_scan["id"]
203
+ ):
204
+ # A post-commit interrupt must not undo the saved archive location.
205
+ raise
206
+ try:
207
+ scan_dir.rmdir()
208
+ except FileNotFoundError:
209
+ # Registration may fail before recreating the empty output directory.
210
+ pass
211
+ archived_scan_dir.rename(scan_dir)
212
+ raise
149
213
 
150
214
 
151
215
  def insert_running_scan(
@@ -13,6 +13,7 @@ from dataclasses import dataclass
13
13
  from datetime import datetime, timezone
14
14
  from pathlib import Path
15
15
  from typing import Any, Mapping
16
+ from urllib.parse import quote
16
17
 
17
18
  TOKEN_FIELDS = {
18
19
  "input_tokens": "inputTokens",
@@ -219,17 +220,19 @@ def _codex_state_database() -> Path | None:
219
220
  path = Path(configured_database).expanduser()
220
221
  return path.resolve() if path.is_file() and os.access(path, os.R_OK) else None
221
222
 
222
- configured_home = os.environ.get("CODEX_HOME", "").strip()
223
- codex_home = Path(configured_home).expanduser() if configured_home else Path.home() / ".codex"
224
- configured_sqlite_home = os.environ.get("CODEX_SQLITE_HOME", "").strip()
223
+ configured_home = os.environ.get("CODEX_HOME", "")
224
+ codex_home = Path(configured_home) if configured_home.strip() else Path.home() / ".codex"
225
+ configured_sqlite_home = os.environ.get("CODEX_SQLITE_HOME", "")
225
226
  search_roots = [
226
- *([Path(configured_sqlite_home).expanduser()] if configured_sqlite_home else []),
227
+ *([Path(configured_sqlite_home)] if configured_sqlite_home.strip() else []),
227
228
  codex_home,
228
229
  codex_home / "sqlite",
229
230
  ]
230
231
  seen: set[Path] = set()
231
232
  for search_root in search_roots:
232
233
  try:
234
+ if search_root.parts[:1] == ("~",):
235
+ search_root = search_root.expanduser()
233
236
  resolved_root = search_root.resolve()
234
237
  if resolved_root in seen:
235
238
  continue
@@ -254,21 +257,21 @@ def _discover_rollout_sessions(
254
257
  warnings: set[str],
255
258
  ) -> tuple[list[RolloutSession], set[str]]:
256
259
  database = sqlite3.connect(
257
- state_database.as_uri() + "?mode=ro",
260
+ f"file:{quote(str(state_database), safe='')}?mode=ro",
258
261
  uri=True,
259
262
  timeout=STATE_DATABASE_TIMEOUT_SECONDS,
260
263
  )
261
264
  try:
262
265
  database.row_factory = sqlite3.Row
263
266
  database.execute("PRAGMA query_only = ON")
264
- _require_state_columns(database, "threads", {"id", "rollout_path"})
265
- _require_state_columns(
266
- database,
267
- "thread_spawn_edges",
268
- {"parent_thread_id", "child_thread_id"},
269
- )
270
- sessions: list[RolloutSession] = []
271
- seen_thread_ids: set[str] = set()
267
+ for table, required in (
268
+ ("threads", {"id", "rollout_path"}),
269
+ ("thread_spawn_edges", {"parent_thread_id", "child_thread_id"}),
270
+ ):
271
+ columns = {str(row["name"]) for row in database.execute(f"PRAGMA table_info({table})")}
272
+ if not required.issubset(columns):
273
+ raise ValueError("Codex state graph does not expose the required thread columns.")
274
+ sessions: dict[str, RolloutSession] = {}
272
275
  missing_thread_ids: set[str] = set()
273
276
  for root in roots:
274
277
  row = database.execute(
@@ -279,14 +282,13 @@ def _discover_rollout_sessions(
279
282
  missing_thread_ids.add(root)
280
283
  warnings.add("scan_root_unavailable")
281
284
  continue
282
- if root not in seen_thread_ids:
285
+ if root not in sessions:
283
286
  path = _rollout_path(row["rollout_path"])
284
287
  if path is None:
285
288
  missing_thread_ids.add(root)
286
289
  warnings.add("rollout_unavailable")
287
290
  continue
288
- sessions.append(RolloutSession(root, None, path))
289
- seen_thread_ids.add(root)
291
+ sessions[root] = RolloutSession(root, None, path)
290
292
  descendants = database.execute(
291
293
  """
292
294
  WITH RECURSIVE descendants(
@@ -335,34 +337,19 @@ def _discover_rollout_sessions(
335
337
  missing_thread_ids.add(child_id)
336
338
  warnings.add("thread_lineage_cycle")
337
339
  continue
338
- if child_id in seen_thread_ids:
340
+ if child_id in sessions:
339
341
  continue
340
342
  path = _rollout_path(descendant["rollout_path"])
341
343
  if path is None:
342
344
  missing_thread_ids.add(child_id)
343
345
  warnings.add("rollout_unavailable")
344
346
  continue
345
- sessions.append(RolloutSession(child_id, parent_id, path))
346
- seen_thread_ids.add(child_id)
347
- return sessions, missing_thread_ids
347
+ sessions[child_id] = RolloutSession(child_id, parent_id, path)
348
+ return list(sessions.values()), missing_thread_ids
348
349
  finally:
349
350
  database.close()
350
351
 
351
352
 
352
- def _require_state_columns(
353
- connection: sqlite3.Connection,
354
- table: str,
355
- required: set[str],
356
- ) -> None:
357
- statements = {
358
- "threads": "PRAGMA table_info(threads)",
359
- "thread_spawn_edges": "PRAGMA table_info(thread_spawn_edges)",
360
- }
361
- columns = {str(row["name"]) for row in connection.execute(statements[table])}
362
- if not required.issubset(columns):
363
- raise ValueError("Codex state graph does not expose the required thread columns.")
364
-
365
-
366
353
  def _rollout_path(value: object) -> Path | None:
367
354
  if not isinstance(value, str) or not value:
368
355
  return None
@@ -456,6 +443,8 @@ def _read_rollout_usage(
456
443
  continue
457
444
  if event.get("type") != "event_msg" or payload.get("type") != "token_count":
458
445
  continue
446
+ if "info" in payload and payload["info"] is None:
447
+ continue
459
448
  timestamp = _timestamp(event.get("timestamp"))
460
449
  snapshot = _token_snapshot(payload)
461
450
  if timestamp is None or snapshot is None: