@openai/codex-security 0.9.1 → 0.10.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (444) hide show
  1. package/README.md +37 -788
  2. package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
  3. package/_bundled_plugin/.mcp.json +3 -0
  4. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  5. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  6. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  7. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  8. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  9. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  10. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  12. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  13. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  14. package/_bundled_plugin/references/access-advisory.md +1 -1
  15. package/_bundled_plugin/references/artifact-storage.md +1 -1
  16. package/_bundled_plugin/references/baseline-auditor.md +18 -0
  17. package/_bundled_plugin/references/core-scan.md +5 -42
  18. package/_bundled_plugin/references/final-report.md +1 -1
  19. package/_bundled_plugin/references/focused-investigator.md +13 -0
  20. package/_bundled_plugin/references/scan-prologue.md +2 -2
  21. package/_bundled_plugin/references/scan-runtime.md +4 -2
  22. package/_bundled_plugin/references/security-guidance.md +14 -1
  23. package/_bundled_plugin/references/threat-model.md +1 -0
  24. package/_bundled_plugin/references/validate-scan-findings.md +3 -0
  25. package/_bundled_plugin/scripts/deep_scan_workbench.py +30 -12
  26. package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
  27. package/_bundled_plugin/scripts/finalize_scan_contract.py +47 -9
  28. package/_bundled_plugin/scripts/launch_codex_security_mcp +54 -16
  29. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +2 -0
  30. package/_bundled_plugin/scripts/posix_scan_local_files.py +26 -1
  31. package/_bundled_plugin/scripts/snapshot_sqlite.py +8 -2
  32. package/_bundled_plugin/scripts/windows_scan_local_files.py +216 -25
  33. package/_bundled_plugin/scripts/workbench/handoff.py +55 -25
  34. package/_bundled_plugin/scripts/workbench/storage.py +25 -5
  35. package/_bundled_plugin/scripts/workbench_cli.py +24 -2
  36. package/_bundled_plugin/scripts/workbench_constants.py +2 -0
  37. package/_bundled_plugin/scripts/workbench_db.py +257 -268
  38. package/_bundled_plugin/scripts/workbench_feedback.py +49 -4
  39. package/_bundled_plugin/scripts/workbench_native_indexes.py +226 -29
  40. package/_bundled_plugin/scripts/workbench_progress.py +159 -3
  41. package/_bundled_plugin/scripts/workbench_publication.py +2 -3
  42. package/_bundled_plugin/scripts/workbench_remediation.py +142 -2
  43. package/_bundled_plugin/scripts/workbench_saved_results.py +48 -8
  44. package/_bundled_plugin/scripts/workbench_scan_history.py +291 -134
  45. package/_bundled_plugin/scripts/workbench_scan_start.py +208 -11
  46. package/_bundled_plugin/scripts/workbench_scan_usage.py +36 -10
  47. package/_bundled_plugin/scripts/workbench_schema.py +220 -14
  48. package/_bundled_plugin/scripts/workbench_setup.py +1 -1
  49. package/_bundled_plugin/scripts/workbench_source_scopes.py +8 -0
  50. package/_bundled_plugin/scripts/workbench_target.py +486 -85
  51. package/_bundled_plugin/scripts/workbench_target_state.py +1108 -22
  52. package/_bundled_plugin/shared/workbench-history-repairs.json +64 -14
  53. package/_bundled_plugin/shared/workbench-migrations.json +66 -0
  54. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +4 -2
  55. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +2 -2
  56. package/_bundled_plugin/skills/fix-finding/SKILL.md +1 -0
  57. package/_bundled_plugin/skills/publish-findings/SKILL.md +26 -160
  58. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
  59. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +2 -2
  60. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +3 -58
  61. package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
  62. package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
  63. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
  64. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
  65. package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
  66. package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
  67. package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
  68. package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
  69. package/bin/codex-security.mjs +2 -2
  70. package/dist/api.d.ts +7 -1
  71. package/dist/api.d.ts.map +1 -1
  72. package/dist/api.js +459 -157
  73. package/dist/api.js.map +1 -1
  74. package/dist/armorcode-findings.d.ts +9 -0
  75. package/dist/armorcode-findings.d.ts.map +1 -0
  76. package/dist/armorcode-findings.js +145 -0
  77. package/dist/armorcode-findings.js.map +1 -0
  78. package/dist/artifact-export.d.ts +2 -0
  79. package/dist/artifact-export.d.ts.map +1 -1
  80. package/dist/artifact-export.js +29 -13
  81. package/dist/artifact-export.js.map +1 -1
  82. package/dist/auth.d.ts +6 -2
  83. package/dist/auth.d.ts.map +1 -1
  84. package/dist/auth.js +33 -12
  85. package/dist/auth.js.map +1 -1
  86. package/dist/batch-cost.d.ts +18 -0
  87. package/dist/batch-cost.d.ts.map +1 -0
  88. package/dist/batch-cost.js +41 -0
  89. package/dist/batch-cost.js.map +1 -0
  90. package/dist/blackduck-findings.d.ts +1 -1
  91. package/dist/blackduck-findings.d.ts.map +1 -1
  92. package/dist/blackduck-findings.js +5 -18
  93. package/dist/blackduck-findings.js.map +1 -1
  94. package/dist/bundled-plugin.d.ts +4 -0
  95. package/dist/bundled-plugin.d.ts.map +1 -0
  96. package/dist/bundled-plugin.js +23 -0
  97. package/dist/bundled-plugin.js.map +1 -0
  98. package/dist/classify-scan-severity.d.ts +1 -1
  99. package/dist/classify-scan-severity.d.ts.map +1 -1
  100. package/dist/classify-scan-severity.js +11 -3
  101. package/dist/classify-scan-severity.js.map +1 -1
  102. package/dist/classify-severity-diagnostics.d.ts +10 -0
  103. package/dist/classify-severity-diagnostics.d.ts.map +1 -0
  104. package/dist/classify-severity-diagnostics.js +57 -0
  105. package/dist/classify-severity-diagnostics.js.map +1 -0
  106. package/dist/classify-severity-records.d.ts +4 -0
  107. package/dist/classify-severity-records.d.ts.map +1 -1
  108. package/dist/classify-severity-records.js +35 -8
  109. package/dist/classify-severity-records.js.map +1 -1
  110. package/dist/classify-severity.d.ts.map +1 -1
  111. package/dist/classify-severity.js +9 -6
  112. package/dist/classify-severity.js.map +1 -1
  113. package/dist/cli-argument.d.ts +4 -0
  114. package/dist/cli-argument.d.ts.map +1 -0
  115. package/dist/cli-argument.js +17 -0
  116. package/dist/cli-argument.js.map +1 -0
  117. package/dist/cli-help.d.ts +1 -1
  118. package/dist/cli-help.d.ts.map +1 -1
  119. package/dist/cli-help.js +71 -29
  120. package/dist/cli-help.js.map +1 -1
  121. package/dist/cli-hook.d.ts +3 -0
  122. package/dist/cli-hook.d.ts.map +1 -0
  123. package/dist/cli-hook.js +87 -0
  124. package/dist/cli-hook.js.map +1 -0
  125. package/dist/cli-integrations.d.ts +13 -0
  126. package/dist/cli-integrations.d.ts.map +1 -0
  127. package/dist/cli-integrations.js +333 -0
  128. package/dist/cli-integrations.js.map +1 -0
  129. package/dist/cli-mcp.d.ts +15 -0
  130. package/dist/cli-mcp.d.ts.map +1 -0
  131. package/dist/cli-mcp.js +178 -0
  132. package/dist/cli-mcp.js.map +1 -0
  133. package/dist/cli-token-view.d.ts +10 -0
  134. package/dist/cli-token-view.d.ts.map +1 -0
  135. package/dist/cli-token-view.js +41 -0
  136. package/dist/cli-token-view.js.map +1 -0
  137. package/dist/cli.d.ts +8 -3
  138. package/dist/cli.d.ts.map +1 -1
  139. package/dist/cli.js +1860 -903
  140. package/dist/cli.js.map +1 -1
  141. package/dist/cloud-publish.d.ts.map +1 -1
  142. package/dist/cloud-publish.js +33 -31
  143. package/dist/cloud-publish.js.map +1 -1
  144. package/dist/codex-sdk-environment.d.ts +6 -0
  145. package/dist/codex-sdk-environment.d.ts.map +1 -1
  146. package/dist/codex-sdk-environment.js +19 -0
  147. package/dist/codex-sdk-environment.js.map +1 -1
  148. package/dist/command-words.d.ts +3 -0
  149. package/dist/command-words.d.ts.map +1 -0
  150. package/dist/command-words.js +46 -0
  151. package/dist/command-words.js.map +1 -0
  152. package/dist/component-plan.d.ts.map +1 -1
  153. package/dist/component-plan.js +3 -3
  154. package/dist/component-plan.js.map +1 -1
  155. package/dist/component-scan.d.ts +3 -1
  156. package/dist/component-scan.d.ts.map +1 -1
  157. package/dist/component-scan.js +40 -7
  158. package/dist/component-scan.js.map +1 -1
  159. package/dist/config.d.ts +1 -1
  160. package/dist/config.d.ts.map +1 -1
  161. package/dist/config.js +30 -1
  162. package/dist/config.js.map +1 -1
  163. package/dist/continuum-aws.d.ts +6 -0
  164. package/dist/continuum-aws.d.ts.map +1 -0
  165. package/dist/continuum-aws.js +202 -0
  166. package/dist/continuum-aws.js.map +1 -0
  167. package/dist/continuum-collector.d.ts +44 -0
  168. package/dist/continuum-collector.d.ts.map +1 -0
  169. package/dist/continuum-collector.js +266 -0
  170. package/dist/continuum-collector.js.map +1 -0
  171. package/dist/continuum-findings.d.ts +31 -2
  172. package/dist/continuum-findings.d.ts.map +1 -1
  173. package/dist/continuum-findings.js +497 -59
  174. package/dist/continuum-findings.js.map +1 -1
  175. package/dist/contract.d.ts +1 -0
  176. package/dist/contract.d.ts.map +1 -1
  177. package/dist/contract.js +3 -0
  178. package/dist/contract.js.map +1 -1
  179. package/dist/cost.d.ts.map +1 -1
  180. package/dist/cost.js +1 -45
  181. package/dist/cost.js.map +1 -1
  182. package/dist/crowdstrike-findings.d.ts +7 -0
  183. package/dist/crowdstrike-findings.d.ts.map +1 -0
  184. package/dist/crowdstrike-findings.js +210 -0
  185. package/dist/crowdstrike-findings.js.map +1 -0
  186. package/dist/custom-validation-prompt.d.ts +1 -1
  187. package/dist/custom-validation-prompt.d.ts.map +1 -1
  188. package/dist/custom-validation-prompt.js +29 -19
  189. package/dist/custom-validation-prompt.js.map +1 -1
  190. package/dist/deduplication/local.d.ts +3 -1
  191. package/dist/deduplication/local.d.ts.map +1 -1
  192. package/dist/deduplication/local.js +8 -1
  193. package/dist/deduplication/local.js.map +1 -1
  194. package/dist/deduplication/refusal.d.ts.map +1 -1
  195. package/dist/deduplication/refusal.js +2 -1
  196. package/dist/deduplication/refusal.js.map +1 -1
  197. package/dist/deduplication/scan.d.ts +2 -0
  198. package/dist/deduplication/scan.d.ts.map +1 -1
  199. package/dist/deduplication/scan.js +24 -7
  200. package/dist/deduplication/scan.js.map +1 -1
  201. package/dist/deep-scan.d.ts.map +1 -1
  202. package/dist/deep-scan.js +16 -15
  203. package/dist/deep-scan.js.map +1 -1
  204. package/dist/endor-findings.d.ts +2 -2
  205. package/dist/endor-findings.d.ts.map +1 -1
  206. package/dist/endor-findings.js +6 -23
  207. package/dist/endor-findings.js.map +1 -1
  208. package/dist/errors.d.ts +3 -1
  209. package/dist/errors.d.ts.map +1 -1
  210. package/dist/errors.js +7 -3
  211. package/dist/errors.js.map +1 -1
  212. package/dist/executable-path.d.ts +3 -0
  213. package/dist/executable-path.d.ts.map +1 -1
  214. package/dist/executable-path.js +26 -0
  215. package/dist/executable-path.js.map +1 -1
  216. package/dist/external-findings-import.d.ts.map +1 -1
  217. package/dist/external-findings-import.js +12 -1
  218. package/dist/external-findings-import.js.map +1 -1
  219. package/dist/external-findings-local.d.ts +66 -4
  220. package/dist/external-findings-local.d.ts.map +1 -1
  221. package/dist/external-findings-local.js +258 -59
  222. package/dist/external-findings-local.js.map +1 -1
  223. package/dist/external-findings-publish.d.ts +6 -1
  224. package/dist/external-findings-publish.d.ts.map +1 -1
  225. package/dist/external-findings-publish.js +330 -1633
  226. package/dist/external-findings-publish.js.map +1 -1
  227. package/dist/external-findings-read.d.ts +11 -2
  228. package/dist/external-findings-read.d.ts.map +1 -1
  229. package/dist/external-findings-read.js +56 -53
  230. package/dist/external-findings-read.js.map +1 -1
  231. package/dist/external-findings.d.ts +1 -1
  232. package/dist/external-findings.d.ts.map +1 -1
  233. package/dist/external-findings.js +12 -1
  234. package/dist/external-findings.js.map +1 -1
  235. package/dist/external-import-contract.d.ts +6 -11
  236. package/dist/external-import-contract.d.ts.map +1 -1
  237. package/dist/external-import-contract.js +35 -177
  238. package/dist/external-import-contract.js.map +1 -1
  239. package/dist/external-import-models.d.ts +1 -1
  240. package/dist/external-import-models.d.ts.map +1 -1
  241. package/dist/external-import-models.js.map +1 -1
  242. package/dist/finding-prompt.d.ts.map +1 -1
  243. package/dist/finding-prompt.js +2 -2
  244. package/dist/finding-prompt.js.map +1 -1
  245. package/dist/github-dependabot-findings.d.ts.map +1 -1
  246. package/dist/github-dependabot-findings.js +3 -4
  247. package/dist/github-dependabot-findings.js.map +1 -1
  248. package/dist/github-findings.d.ts.map +1 -1
  249. package/dist/github-findings.js +19 -287
  250. package/dist/github-findings.js.map +1 -1
  251. package/dist/host-protocol.d.ts +6 -0
  252. package/dist/host-protocol.d.ts.map +1 -1
  253. package/dist/host-protocol.js +11 -1
  254. package/dist/host-protocol.js.map +1 -1
  255. package/dist/host-records-protocol.d.ts +2 -0
  256. package/dist/host-records-protocol.d.ts.map +1 -1
  257. package/dist/host-records-protocol.js +4 -0
  258. package/dist/host-records-protocol.js.map +1 -1
  259. package/dist/hosted-remediation.d.ts +1 -0
  260. package/dist/hosted-remediation.d.ts.map +1 -1
  261. package/dist/hosted-remediation.js +23 -3
  262. package/dist/hosted-remediation.js.map +1 -1
  263. package/dist/index.d.ts +5 -3
  264. package/dist/index.d.ts.map +1 -1
  265. package/dist/index.js +3 -1
  266. package/dist/index.js.map +1 -1
  267. package/dist/inspector-findings.d.ts.map +1 -1
  268. package/dist/inspector-findings.js +19 -35
  269. package/dist/inspector-findings.js.map +1 -1
  270. package/dist/knowledge-base.d.ts +1 -1
  271. package/dist/knowledge-base.d.ts.map +1 -1
  272. package/dist/knowledge-base.js +34 -27
  273. package/dist/knowledge-base.js.map +1 -1
  274. package/dist/linear.d.ts +11 -0
  275. package/dist/linear.d.ts.map +1 -1
  276. package/dist/linear.js.map +1 -1
  277. package/dist/local-git-metadata.d.ts +5 -2
  278. package/dist/local-git-metadata.d.ts.map +1 -1
  279. package/dist/local-git-metadata.js +8 -4
  280. package/dist/local-git-metadata.js.map +1 -1
  281. package/dist/multiscan.d.ts +4 -0
  282. package/dist/multiscan.d.ts.map +1 -1
  283. package/dist/multiscan.js +83 -39
  284. package/dist/multiscan.js.map +1 -1
  285. package/dist/opengrep-findings.d.ts +4 -2
  286. package/dist/opengrep-findings.d.ts.map +1 -1
  287. package/dist/opengrep-findings.js +39 -22
  288. package/dist/opengrep-findings.js.map +1 -1
  289. package/dist/private-finding-import.d.ts +8 -13
  290. package/dist/private-finding-import.d.ts.map +1 -1
  291. package/dist/private-finding-import.js +69 -129
  292. package/dist/private-finding-import.js.map +1 -1
  293. package/dist/project-config-schema.d.ts +2 -0
  294. package/dist/project-config-schema.d.ts.map +1 -1
  295. package/dist/project-config-schema.js +1 -0
  296. package/dist/project-config-schema.js.map +1 -1
  297. package/dist/project-config.d.ts +1 -0
  298. package/dist/project-config.d.ts.map +1 -1
  299. package/dist/project-config.js +56 -13
  300. package/dist/project-config.js.map +1 -1
  301. package/dist/prompt-files.d.ts +7 -2
  302. package/dist/prompt-files.d.ts.map +1 -1
  303. package/dist/prompt-files.js +42 -20
  304. package/dist/prompt-files.js.map +1 -1
  305. package/dist/provider-profile.d.ts.map +1 -1
  306. package/dist/provider-profile.js +4 -9
  307. package/dist/provider-profile.js.map +1 -1
  308. package/dist/publication.d.ts +1 -1
  309. package/dist/publication.d.ts.map +1 -1
  310. package/dist/publication.js.map +1 -1
  311. package/dist/record.d.ts +1 -5
  312. package/dist/record.d.ts.map +1 -1
  313. package/dist/record.js +3 -51
  314. package/dist/record.js.map +1 -1
  315. package/dist/remediation.d.ts.map +1 -1
  316. package/dist/remediation.js +3 -1
  317. package/dist/remediation.js.map +1 -1
  318. package/dist/runtime.d.ts +35 -7
  319. package/dist/runtime.d.ts.map +1 -1
  320. package/dist/runtime.js +782 -153
  321. package/dist/runtime.js.map +1 -1
  322. package/dist/saved-scan-bootstrap.d.ts +6 -1
  323. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  324. package/dist/saved-scan-bootstrap.js +267 -115
  325. package/dist/saved-scan-bootstrap.js.map +1 -1
  326. package/dist/scan-archive-path.d.ts +2 -0
  327. package/dist/scan-archive-path.d.ts.map +1 -0
  328. package/dist/scan-archive-path.js +5 -0
  329. package/dist/scan-archive-path.js.map +1 -0
  330. package/dist/scan-comparison.d.ts +20 -2
  331. package/dist/scan-comparison.d.ts.map +1 -1
  332. package/dist/scan-comparison.js +26 -5
  333. package/dist/scan-comparison.js.map +1 -1
  334. package/dist/scan-dashboard.d.ts +1 -0
  335. package/dist/scan-dashboard.d.ts.map +1 -1
  336. package/dist/scan-dashboard.js +18 -2
  337. package/dist/scan-dashboard.js.map +1 -1
  338. package/dist/scan-executor.d.ts.map +1 -1
  339. package/dist/scan-executor.js +4 -2
  340. package/dist/scan-executor.js.map +1 -1
  341. package/dist/scan-history-renderer.d.ts +1 -0
  342. package/dist/scan-history-renderer.d.ts.map +1 -1
  343. package/dist/scan-history-renderer.js +25 -9
  344. package/dist/scan-history-renderer.js.map +1 -1
  345. package/dist/scan-logs.d.ts.map +1 -1
  346. package/dist/scan-logs.js +28 -4
  347. package/dist/scan-logs.js.map +1 -1
  348. package/dist/scan-settings.d.ts +1 -0
  349. package/dist/scan-settings.d.ts.map +1 -1
  350. package/dist/scan-settings.js +1 -0
  351. package/dist/scan-settings.js.map +1 -1
  352. package/dist/scanner-import.d.ts +5 -11
  353. package/dist/scanner-import.d.ts.map +1 -1
  354. package/dist/scanner-import.js +16 -89
  355. package/dist/scanner-import.js.map +1 -1
  356. package/dist/security-policy.d.ts.map +1 -1
  357. package/dist/security-policy.js +26 -6
  358. package/dist/security-policy.js.map +1 -1
  359. package/dist/semgrep-findings.d.ts.map +1 -1
  360. package/dist/semgrep-findings.js +14 -48
  361. package/dist/semgrep-findings.js.map +1 -1
  362. package/dist/semgrep-platform-findings.d.ts +20 -70
  363. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  364. package/dist/semgrep-platform-findings.js +116 -333
  365. package/dist/semgrep-platform-findings.js.map +1 -1
  366. package/dist/severity-review.d.ts.map +1 -1
  367. package/dist/severity-review.js +1 -0
  368. package/dist/severity-review.js.map +1 -1
  369. package/dist/snyk-findings.d.ts +2 -0
  370. package/dist/snyk-findings.d.ts.map +1 -1
  371. package/dist/snyk-findings.js +5 -8
  372. package/dist/snyk-findings.js.map +1 -1
  373. package/dist/snyk-rest-findings.d.ts +3 -20
  374. package/dist/snyk-rest-findings.d.ts.map +1 -1
  375. package/dist/snyk-rest-findings.js +45 -217
  376. package/dist/snyk-rest-findings.js.map +1 -1
  377. package/dist/sonar-findings.d.ts +1 -1
  378. package/dist/sonar-findings.d.ts.map +1 -1
  379. package/dist/sonar-findings.js +2 -4
  380. package/dist/sonar-findings.js.map +1 -1
  381. package/dist/sonar-import.d.ts +3 -0
  382. package/dist/sonar-import.d.ts.map +1 -1
  383. package/dist/sonar-import.js +28 -30
  384. package/dist/sonar-import.js.map +1 -1
  385. package/dist/stored-finding-projection.d.ts +6 -0
  386. package/dist/stored-finding-projection.d.ts.map +1 -0
  387. package/dist/stored-finding-projection.js +129 -0
  388. package/dist/stored-finding-projection.js.map +1 -0
  389. package/dist/stored-findings-publication.d.ts +23 -0
  390. package/dist/stored-findings-publication.d.ts.map +1 -0
  391. package/dist/stored-findings-publication.js +169 -0
  392. package/dist/stored-findings-publication.js.map +1 -0
  393. package/dist/targets.d.ts +8 -1
  394. package/dist/targets.d.ts.map +1 -1
  395. package/dist/targets.js +103 -23
  396. package/dist/targets.js.map +1 -1
  397. package/dist/tenable-findings.d.ts +1 -4
  398. package/dist/tenable-findings.d.ts.map +1 -1
  399. package/dist/tenable-findings.js.map +1 -1
  400. package/dist/trivy-findings.d.ts.map +1 -1
  401. package/dist/trivy-findings.js +0 -11
  402. package/dist/trivy-findings.js.map +1 -1
  403. package/dist/trusted-executable.d.ts +7 -0
  404. package/dist/trusted-executable.d.ts.map +1 -1
  405. package/dist/trusted-executable.js +148 -37
  406. package/dist/trusted-executable.js.map +1 -1
  407. package/dist/value.js +3 -1
  408. package/dist/value.js.map +1 -1
  409. package/dist/veracode-findings.d.ts +1 -3
  410. package/dist/veracode-findings.d.ts.map +1 -1
  411. package/dist/veracode-findings.js +13 -38
  412. package/dist/veracode-findings.js.map +1 -1
  413. package/dist/version.d.ts +3 -1
  414. package/dist/version.d.ts.map +1 -1
  415. package/dist/version.js +184 -32
  416. package/dist/version.js.map +1 -1
  417. package/dist/wiz-findings.d.ts +2 -2
  418. package/dist/wiz-findings.d.ts.map +1 -1
  419. package/dist/wiz-findings.js +14 -92
  420. package/dist/wiz-findings.js.map +1 -1
  421. package/docs/classify-severity-records.md +30 -0
  422. package/docs/cli.md +537 -124
  423. package/docs/findings-service.md +22 -9
  424. package/docs/hosted-remediation.md +13 -4
  425. package/docs/sdk.md +918 -0
  426. package/package.json +15 -6
  427. package/schemas/external-findings.schema.json +2 -1
  428. package/schemas/project-config.schema.json +5 -0
  429. package/dist/hosted-scanner-v1.d.ts +0 -6
  430. package/dist/hosted-scanner-v1.d.ts.map +0 -1
  431. package/dist/hosted-scanner-v1.js +0 -60
  432. package/dist/hosted-scanner-v1.js.map +0 -1
  433. package/dist/reader-selection.d.ts +0 -15
  434. package/dist/reader-selection.d.ts.map +0 -1
  435. package/dist/reader-selection.js +0 -89
  436. package/dist/reader-selection.js.map +0 -1
  437. package/dist/semgrep-platform-v1.d.ts +0 -6
  438. package/dist/semgrep-platform-v1.d.ts.map +0 -1
  439. package/dist/semgrep-platform-v1.js +0 -83
  440. package/dist/semgrep-platform-v1.js.map +0 -1
  441. package/dist/snyk-rest-v1.d.ts +0 -28
  442. package/dist/snyk-rest-v1.d.ts.map +0 -1
  443. package/dist/snyk-rest-v1.js +0 -132
  444. package/dist/snyk-rest-v1.js.map +0 -1
@@ -1,6 +1,10 @@
1
1
  import type { SavedScanDependencies } from "./saved-scan.js";
2
2
  import { type ProcessEnvironment } from "./runtime.js";
3
- /** Read only enough history to protect Python discovery; the workbench still validates the scan. */
3
+ export interface SavedToolDiscovery {
4
+ protectedRoots: readonly string[];
5
+ allowPathLookup: boolean;
6
+ }
7
+ /** Read saved checkout boundaries before starting tools. The workbench validates the scan. */
4
8
  export declare function savedScanWorkbench(requestedId: string | {
5
9
  workflowId: string;
6
10
  }, options: {
@@ -11,6 +15,7 @@ export declare function savedScanWorkbench(requestedId: string | {
11
15
  }): Promise<SavedScanDependencies["runWorkbench"] & {
12
16
  environment: ProcessEnvironment;
13
17
  readonly protectedRoots: readonly string[];
18
+ readonly nodeDiscovery: SavedToolDiscovery;
14
19
  }>;
15
20
  export declare function readSavedScanLifecycle(environment: ProcessEnvironment, scanId: string): unknown;
16
21
  //# sourceMappingURL=saved-scan-bootstrap.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"saved-scan-bootstrap.d.ts","sourceRoot":"","sources":["../src/saved-scan-bootstrap.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAKL,KAAK,kBAAkB,EAGxB,MAAM,cAAc,CAAC;AAQtB,oGAAoG;AACpG,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EAC5C,OAAO,EAAE;IACP,WAAW,EAAE,kBAAkB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CACR,qBAAqB,CAAC,cAAc,CAAC,GAAG;IACtC,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;CAC5C,CACF,CAoHA;AAWD,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,kBAAkB,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAcT"}
1
+ {"version":3,"file":"saved-scan-bootstrap.d.ts","sourceRoot":"","sources":["../src/saved-scan-bootstrap.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAML,KAAK,kBAAkB,EAGxB,MAAM,cAAc,CAAC;AAqBtB,MAAM,WAAW,kBAAkB;IACjC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,eAAe,EAAE,OAAO,CAAC;CAC1B;AAED,8FAA8F;AAC9F,wBAAsB,kBAAkB,CACtC,WAAW,EAAE,MAAM,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,EAC5C,OAAO,EAAE;IACP,WAAW,EAAE,kBAAkB,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,gBAAgB,EAAE,MAAM,CAAC;IACzB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,GACA,OAAO,CACR,qBAAqB,CAAC,cAAc,CAAC,GAAG;IACtC,WAAW,EAAE,kBAAkB,CAAC;IAChC,QAAQ,CAAC,cAAc,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,kBAAkB,CAAC;CAC5C,CACF,CAiLA;AAsED,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,kBAAkB,EAC/B,MAAM,EAAE,MAAM,GACb,OAAO,CAaT"}
@@ -1,17 +1,16 @@
1
1
  import { isRecord } from "./record.js";
2
- import { compareTimestamps } from "./timestamps.js";
3
2
  import { environmentEntry } from "./auth.js";
4
3
  import { inspectTrustedExecutable } from "./trusted-executable.js";
5
- import { realpath } from "node:fs/promises";
4
+ import { access } from "node:fs/promises";
6
5
  import { isAbsolute, join, resolve } from "node:path";
7
6
  import { gitHistoryIdentity, gitMarkerRoot, gitProtectionRoots, } from "./targets.js";
8
7
  import { CodexSecurityError, errorMessage } from "./errors.js";
9
- import { codexSecurityStateDirectory, resolvePluginPython, runWorkbench, workbenchEnvironment, sqliteDatabaseOpener, } from "./runtime.js";
10
- /** Read only enough history to protect Python discovery; the workbench still validates the scan. */
8
+ import { codexSecurityStateDirectory, resolvePluginPython, runWorkbench, sameFile, workbenchEnvironment, sqliteDatabaseOpener, } from "./runtime.js";
9
+ /** Read saved checkout boundaries before starting tools. The workbench validates the scan. */
11
10
  export async function savedScanWorkbench(requestedId, options) {
12
11
  options.signal?.throwIfAborted();
13
12
  const environment = workbenchEnvironment(options.environment);
14
- const targets = await readTargets(requestedId, environment, options.currentDirectory, options.signal);
13
+ const { targets, checkouts } = await readTargets(requestedId, environment, options.currentDirectory, options.signal);
15
14
  const latest = requestedId === "latest" || typeof requestedId !== "string";
16
15
  if (targets.length === 0)
17
16
  throw new CodexSecurityError(typeof requestedId !== "string"
@@ -25,17 +24,21 @@ export async function savedScanWorkbench(requestedId, options) {
25
24
  !isAbsolute(target.target_path)))
26
25
  throw new CodexSecurityError("Saved scan history has no absolute repository target.");
27
26
  const callerRoots = await gitProtectionRoots(options.currentDirectory, options.signal);
27
+ const liveTargets = targets.filter((target) => target.protectPython !== false);
28
28
  const protectedRoots = [
29
29
  ...callerRoots,
30
- ...targets.map((row) => row.target_path),
31
- ...(await Promise.all(targets.map((row) => gitProtectionRoots(row.target_path, options.signal)))).flat(),
30
+ ...liveTargets.flatMap((row) => {
31
+ const root = checkouts.byTarget.get(row.target_path);
32
+ return root ? [root] : [];
33
+ }),
34
+ ...liveTargets.map((row) => row.target_path),
35
+ ...(await Promise.all(liveTargets.map((row) => gitProtectionRoots(row.target_path, options.signal)))).flat(),
32
36
  ];
37
+ const discoveryProtectedRoots = await savedDiscoveryRoots(checkouts, [options.currentDirectory, ...targets.map((row) => row.target_path)], options.signal);
33
38
  let python;
34
39
  const workbench = async (args, input, signal = options.signal) => {
35
40
  signal?.throwIfAborted();
36
- // Return the selected ID directly: probing Python must not revisit unrelated history.
37
- if (requestedId === "latest" && args[0] === "list-scans")
38
- return { scans: targets.map((target) => ({ scanId: target.id })) };
41
+ const selectingLatest = requestedId === "latest" && args[0] === "list-scans";
39
42
  const target = args[0] === "get-scan"
40
43
  ? latest
41
44
  ? targets.find((row) => row.id === args[2])
@@ -43,15 +46,17 @@ export async function savedScanWorkbench(requestedId, options) {
43
46
  : undefined;
44
47
  if (args[0] === "get-scan" && !target)
45
48
  throw new CodexSecurityError("Saved scan history changed during lookup. Retry the command.");
46
- // Pin the interpreter selected with every candidate and the caller checkout protected.
49
+ // Pin one interpreter; ambient discovery also excludes historical candidate paths.
47
50
  python ??= await resolvePluginPython({
48
51
  environment,
49
52
  protectedRoot: protectedRoots,
53
+ discoveryProtectedRoots,
54
+ allowPathLookup: checkouts.complete,
50
55
  currentDirectory: options.currentDirectory,
51
56
  signal,
52
57
  });
53
58
  environment["PYTHON"] = python;
54
- const result = await runWorkbench({
59
+ const execute = (command) => runWorkbench({
55
60
  environment,
56
61
  pluginRoot: options.pluginRoot,
57
62
  python,
@@ -59,7 +64,43 @@ export async function savedScanWorkbench(requestedId, options) {
59
64
  protectedRoot: protectedRoots,
60
65
  currentDirectory: options.currentDirectory,
61
66
  failureMessage: "Could not read Codex Security scan history",
62
- }, target ? ["get-scan", "--scan-id", target.id] : args, input);
67
+ }, command, input);
68
+ if (selectingLatest) {
69
+ // Let the workbench enforce the caller's persisted generation and component scope,
70
+ // including history whose original linked worktree has since been removed.
71
+ const scoped = new Map();
72
+ const scansAt = async (repository) => {
73
+ let scans = scoped.get(repository);
74
+ if (scans === undefined) {
75
+ const result = await execute([
76
+ "list-scans",
77
+ "--repository",
78
+ repository,
79
+ "--status",
80
+ "complete",
81
+ ]);
82
+ scans = Array.isArray(result["scans"]) ? result["scans"] : [];
83
+ scoped.set(repository, scans);
84
+ }
85
+ return scans;
86
+ };
87
+ const callerScans = await scansAt(options.currentDirectory);
88
+ for (const candidate of targets) {
89
+ let selected = callerScans.find((scan) => isRecord(scan) && scan["scanId"] === candidate.id);
90
+ // Dedupe also accepts the same component of an independent same-origin clone.
91
+ // Validate that clone's current ownership before using its saved history.
92
+ if (selected === undefined && candidate.originFallback) {
93
+ selected = (await scansAt(candidate.target_path)).find((scan) => isRecord(scan) && scan["scanId"] === candidate.id);
94
+ }
95
+ if (selected !== undefined)
96
+ return { scans: [selected] };
97
+ }
98
+ if (environment["CODEX_SECURITY_GIT"] === "") {
99
+ throw new CodexSecurityError("Could not verify the saved checkout automatically without a trusted Git executable. Use an explicit saved scan ID: codex-security dedupe --scan SCAN_ID");
100
+ }
101
+ return { scans: [] };
102
+ }
103
+ const result = await execute(target ? ["get-scan", "--scan-id", target.id] : args);
63
104
  if (typeof requestedId !== "string" && args[0] === "finding-workflow") {
64
105
  const workflow = result["workflow"];
65
106
  if (!isRecord(workflow) || workflow["scanId"] !== targets[0].id)
@@ -78,61 +119,135 @@ export async function savedScanWorkbench(requestedId, options) {
78
119
  return Object.assign(workbench, {
79
120
  environment,
80
121
  protectedRoots: [options.currentDirectory, ...protectedRoots],
122
+ nodeDiscovery: {
123
+ protectedRoots: discoveryProtectedRoots,
124
+ allowPathLookup: checkouts.complete,
125
+ },
81
126
  });
82
127
  }
83
- function openSavedScanDatabase(environment) {
84
- const openDatabase = sqliteDatabaseOpener("read-existing");
85
- return openDatabase(join(codexSecurityStateDirectory(environment), "workbench.sqlite3"));
128
+ async function readTargets(requestedId, environment, currentDirectory, signal) {
129
+ try {
130
+ const latest = requestedId === "latest";
131
+ const snapshot = readSnapshot(workbenchDatabasePath(environment), (database) => {
132
+ const targets = latest
133
+ ? completedScans(database)
134
+ : exactTargets(database, requestedId);
135
+ const checkouts = savedCheckouts(database);
136
+ return { targets, checkouts };
137
+ });
138
+ if (latest)
139
+ snapshot.targets = await latestTargets(snapshot.targets, currentDirectory, environment, snapshot.checkouts, signal);
140
+ return snapshot;
141
+ }
142
+ catch (error) {
143
+ signal?.throwIfAborted();
144
+ if (error instanceof CodexSecurityError)
145
+ throw error;
146
+ throw new CodexSecurityError(`Could not read saved scan targets before Python discovery: ${errorMessage(error)}`, { cause: error });
147
+ }
86
148
  }
87
- export function readSavedScanLifecycle(environment, scanId) {
88
- const database = openSavedScanDatabase(environment);
149
+ function workbenchDatabasePath(environment) {
150
+ return join(codexSecurityStateDirectory(environment), "workbench.sqlite3");
151
+ }
152
+ /** @internal Read executable exclusions before launching an ordinary history command. */
153
+ export async function savedCheckoutBoundaries(environment) {
154
+ const path = workbenchDatabasePath(environment);
89
155
  try {
90
- database.exec("PRAGMA busy_timeout = 0");
91
- database.exec("PRAGMA query_only = ON");
156
+ await access(path);
157
+ }
158
+ catch (error) {
159
+ if (error.code === "ENOENT")
160
+ return undefined;
161
+ throw error;
162
+ }
163
+ return readSnapshot(path, (database) => savedCheckouts(database));
164
+ }
165
+ /** @internal Exclude both recorded checkout roots and the currently visible checkouts. */
166
+ export async function savedDiscoveryRoots(checkouts, paths, signal) {
167
+ const targets = [...new Set([...paths, ...(checkouts?.roots ?? [])])];
168
+ const currentRoots = await Promise.all(targets.map((path) => gitProtectionRoots(path, signal)));
169
+ return [...new Set([...targets, ...currentRoots.flat()])];
170
+ }
171
+ export function readSavedScanLifecycle(environment, scanId) {
172
+ return readSnapshot(workbenchDatabasePath(environment), (database) => {
92
173
  const [row] = readRows(database, "SELECT snapshot FROM scan_lifecycles WHERE scan_id = ?", scanId);
93
174
  return row && JSON.parse(row.snapshot);
175
+ }, 0);
176
+ }
177
+ function readSnapshot(path, select, timeout = 5000) {
178
+ const database = sqliteDatabaseOpener("read-existing")(path);
179
+ try {
180
+ database.exec(`PRAGMA busy_timeout = ${timeout}`);
181
+ database.exec("PRAGMA query_only = ON");
182
+ // Select scans and their saved boundaries from the same snapshot.
183
+ database.exec("BEGIN");
184
+ return select(database);
94
185
  }
95
186
  finally {
96
187
  database.close();
97
188
  }
98
189
  }
99
- async function readTargets(requestedId, environment, currentDirectory, signal) {
100
- let database;
101
- try {
102
- database = openSavedScanDatabase(environment);
103
- database.exec("PRAGMA busy_timeout = 5000");
104
- database.exec("PRAGMA query_only = ON");
105
- if (typeof requestedId !== "string") {
106
- const columns = readRows(database, "PRAGMA table_info(finding_workflows)");
107
- const scanId = columns.some((column) => column.name === "scan_id")
108
- ? "workflow.scan_id"
109
- : "json_extract(workflow.state_json, '$.scanId')";
110
- return readRows(database, `SELECT scans.id, scans.target_path FROM scans
190
+ function exactTargets(database, requestedId) {
191
+ if (typeof requestedId !== "string") {
192
+ const scanId = tableColumns(database, "finding_workflows").has("scan_id")
193
+ ? "workflow.scan_id"
194
+ : "json_extract(workflow.state_json, '$.scanId')";
195
+ return readRows(database, `SELECT scans.id, scans.target_path FROM scans
111
196
  JOIN finding_workflows AS workflow ON scans.id = ${scanId} WHERE workflow.id = ?`, requestedId.workflowId);
112
- }
113
- if (requestedId === "latest")
114
- return await latestTargets(database, currentDirectory, environment, signal);
115
- // Match uuid.UUID's accepted full-ID spellings before considering a prefix.
116
- const compact = trimBoundary(requestedId.replaceAll("urn:", "").replaceAll("uuid:", ""), "{", "}").replaceAll("-", "");
117
- if (/^[0-9a-f]{32}$/i.test(compact)) {
118
- const id = compact
119
- .toLowerCase()
120
- .replace(/^(.{8})(.{4})(.{4})(.{4})(.{12})$/, "$1-$2-$3-$4-$5");
121
- return readRows(database, "SELECT id, target_path FROM scans WHERE id = ?", id);
122
- }
123
- if (requestedId.length < 8)
124
- throw new CodexSecurityError("Scan ID prefixes must be at least eight characters.");
125
- return readRows(database, "SELECT id, target_path FROM scans WHERE substr(id, 1, ?) = ? LIMIT 2", requestedId.length, requestedId.toLowerCase());
126
197
  }
127
- catch (error) {
128
- signal?.throwIfAborted();
129
- if (error instanceof CodexSecurityError)
130
- throw error;
131
- throw new CodexSecurityError(`Could not read saved scan targets before Python discovery: ${errorMessage(error)}`, { cause: error });
198
+ // Match uuid.UUID's accepted full-ID spellings before considering a prefix.
199
+ const compact = trimBoundary(requestedId.replaceAll("urn:", "").replaceAll("uuid:", ""), "{", "}").replaceAll("-", "");
200
+ if (/^[0-9a-f]{32}$/i.test(compact)) {
201
+ const id = compact
202
+ .toLowerCase()
203
+ .replace(/^(.{8})(.{4})(.{4})(.{4})(.{12})$/, "$1-$2-$3-$4-$5");
204
+ return readRows(database, "SELECT id, target_path FROM scans WHERE id = ?", id);
132
205
  }
133
- finally {
134
- database?.close();
206
+ if (requestedId.length < 8)
207
+ throw new CodexSecurityError("Scan ID prefixes must be at least eight characters.");
208
+ return readRows(database, "SELECT id, target_path FROM scans WHERE substr(id, 1, ?) = ? LIMIT 2", requestedId.length, requestedId.toLowerCase());
209
+ }
210
+ function tableColumns(database, table) {
211
+ return new Set(readRows(database, `PRAGMA table_info(${table})`).map((row) => row.name));
212
+ }
213
+ /** Read registered boundaries without assuming an unversioned scan was outside Git. */
214
+ function savedCheckouts(database) {
215
+ const scan = tableColumns(database, "scans");
216
+ const registry = tableColumns(database, "security_targets");
217
+ const workspace = tableColumns(database, "workspaces");
218
+ const sources = [];
219
+ if (scan.has("target_path"))
220
+ sources.push("SELECT target_path, NULL AS checkout_root FROM scans");
221
+ if (workspace.has("target_path")) {
222
+ const validated = workspace.has("target_path_unvalidated")
223
+ ? " AND (target_path_unvalidated = 0 OR target_id IS NOT NULL)"
224
+ : "";
225
+ sources.push(`SELECT target_path, NULL AS checkout_root FROM workspaces
226
+ WHERE target_path IS NOT NULL${validated}`);
135
227
  }
228
+ if (registry.has("current_path")) {
229
+ sources.push(`SELECT current_path AS target_path,
230
+ ${registry.has("git_checkout_root") ? "git_checkout_root" : "NULL"} AS checkout_root
231
+ FROM security_targets`);
232
+ }
233
+ const rows = sources.length === 0
234
+ ? []
235
+ : readRows(database, `SELECT target_path, MAX(checkout_root) AS checkout_root
236
+ FROM (${sources.join(" UNION ALL ")}) GROUP BY target_path`);
237
+ const saved = workspace.has("rejected_checkout_roots_json")
238
+ ? "rejected_checkout_roots_json"
239
+ : "NULL";
240
+ const rejected = workspace.has("target_path_unvalidated")
241
+ ? readRows(database, `SELECT DISTINCT value AS root FROM workspaces LEFT JOIN json_each(${saved})
242
+ WHERE ${saved} IS NOT NULL OR
243
+ (target_path IS NOT NULL AND target_path_unvalidated = 1 AND target_id IS NULL)`).map((row) => row.root)
244
+ : [];
245
+ const roots = [...rows.map((row) => row.checkout_root), ...rejected];
246
+ return {
247
+ byTarget: new Map(rows.map((row) => [row.target_path, row.checkout_root])),
248
+ roots: roots.filter((root) => root !== null),
249
+ complete: !roots.includes(null),
250
+ };
136
251
  }
137
252
  function readRows(database, sql, ...parameters) {
138
253
  const statement = database.prepare(sql);
@@ -145,90 +260,127 @@ function readRows(database, sql, ...parameters) {
145
260
  statement.finalize?.();
146
261
  }
147
262
  }
148
- async function latestTargets(database, directory, environment, signal) {
149
- const current = await pathKey(directory);
150
- const columns = new Set(readRows(database, "PRAGMA table_info(scans)").map((column) => column.name));
151
- // The workbench migrates after discovery; schemas before v16 have no target registry.
152
- const hasTargets = readRows(database, "PRAGMA table_info(security_targets)").length > 0;
153
- const registered = readRows(database, hasTargets
154
- ? "SELECT id, current_path AS target_path FROM security_targets"
155
- : "SELECT DISTINCT target_path AS id, target_path FROM scans");
156
- const related = new Set();
157
- for (const target of registered)
158
- if ((await pathKey(target.target_path)) === current)
159
- related.add(target.id);
263
+ function completedScans(database) {
264
+ const columns = tableColumns(database, "scans");
265
+ return readRows(database, `SELECT scans.id, scans.target_path, scans.updated_at, scans.started_at,
266
+ progress.updated_at AS progress_updated_at,
267
+ ${columns.has("repository_generation") ? "scans.repository_generation" : "NULL"} AS repository_generation
268
+ FROM scans JOIN scan_progress AS progress ON progress.scan_id = scans.id
269
+ WHERE scans.status = 'complete' ${columns.has("canceled_at") ? "AND scans.canceled_at IS NULL" : ""}`)
270
+ .map((scan) => {
271
+ const updated = timestampOrderKey(scan.updated_at);
272
+ const progress = timestampOrderKey(scan.progress_updated_at);
273
+ return {
274
+ ...scan,
275
+ updatedKey: updated > progress ? updated : progress,
276
+ startedKey: timestampOrderKey(scan.started_at),
277
+ };
278
+ })
279
+ .sort((left, right) => compareOrderKeys(right.updatedKey, left.updatedKey) ||
280
+ compareOrderKeys(right.startedKey, left.startedKey) ||
281
+ compareOrderKeys(left.id, right.id));
282
+ }
283
+ async function latestTargets(scans, directory, environment, checkouts, signal) {
284
+ const paths = [...new Set(scans.map((scan) => scan.target_path))];
285
+ const related = new Map();
286
+ for (const path of paths)
287
+ if (await sameFile(path, directory))
288
+ related.set(path, { originFallback: false });
289
+ const protectedAncestorPaths = new Set();
160
290
  let gitMatchingUnavailable = false;
161
291
  const caller = await gitMarkerRoot(directory, signal, "outermost");
162
292
  if (caller !== null) {
163
293
  // Resolve metadata with a host Git, never a Git executable from any candidate checkout.
164
- const roots = await Promise.all(registered.map((target) => gitProtectionRoots(target.target_path, signal)));
165
- const protectedRoots = [
166
- ...(await gitProtectionRoots(directory, signal)),
167
- ...registered.map((target) => target.target_path),
168
- ...roots.flat(),
169
- ];
294
+ const protectedRoots = await savedDiscoveryRoots(checkouts, [directory, ...checkouts.byTarget.keys()], signal);
170
295
  const configured = environmentEntry(environment, "CODEX_SECURITY_GIT");
171
- const inspected = configured === ""
296
+ const inspected = configured === "" ||
297
+ (!checkouts.complete && !isAbsolute(configured ?? ""))
172
298
  ? { executable: null, environment }
173
299
  : await inspectTrustedExecutable(configured ?? "git", environment, protectedRoots);
174
- // Keep subsequent workbench operations on this host Git without changing Python's PATH.
175
300
  for (const key of Object.keys(environment))
176
301
  if (key.toUpperCase() === "CODEX_SECURITY_GIT")
177
302
  delete environment[key];
178
303
  environment["CODEX_SECURITY_GIT"] = inspected.executable ?? "";
179
304
  gitMatchingUnavailable = inspected.executable === null;
180
- const git = inspected.executable === null
181
- ? null
182
- : {
305
+ if (inspected.executable !== null) {
306
+ const git = {
183
307
  executable: inspected.executable,
184
308
  environment: inspected.environment,
185
309
  };
186
- const identity = git === null
187
- ? { commonDirectory: null, origin: null }
188
- : await gitHistoryIdentity(directory, git, signal);
189
- const common = identity.commonDirectory === null
190
- ? null
191
- : await pathKey(identity.commonDirectory);
192
- const origin = repositoryOrigin(identity.origin);
193
- for (const [index, target] of registered.entries()) {
194
- signal?.throwIfAborted();
195
- if (related.has(target.id) || roots[index] === null || git === null)
196
- continue;
197
- const candidate = await gitHistoryIdentity(target.target_path, git, signal);
198
- if ((common !== null &&
199
- candidate.commonDirectory !== null &&
200
- (await pathKey(candidate.commonDirectory)) === common) ||
201
- (origin !== null && repositoryOrigin(candidate.origin) === origin))
202
- related.add(target.id);
310
+ const identity = await gitHistoryIdentity(directory, git, signal);
311
+ const origin = repositoryOrigin(identity.origin);
312
+ for (const path of paths) {
313
+ signal?.throwIfAborted();
314
+ if (related.has(path))
315
+ continue;
316
+ const candidate = await gitHistoryIdentity(path, git, signal);
317
+ if (candidate.commonDirectory === null &&
318
+ identity.commonDirectory !== null) {
319
+ const enclosing = await gitMarkerRoot(path, signal, "outermost");
320
+ if (enclosing !== null) {
321
+ const ancestor = await gitHistoryIdentity(enclosing, git, signal);
322
+ if (ancestor.commonDirectory !== null &&
323
+ (await sameFile(identity.commonDirectory, ancestor.commonDirectory)))
324
+ protectedAncestorPaths.add(path);
325
+ }
326
+ }
327
+ if (identity.relativePath === null ||
328
+ candidate.relativePath !== identity.relativePath)
329
+ continue;
330
+ const common = identity.commonDirectory !== null &&
331
+ candidate.commonDirectory !== null &&
332
+ (await sameFile(identity.commonDirectory, candidate.commonDirectory));
333
+ const clone = !common &&
334
+ identity.commonDirectory !== null &&
335
+ candidate.commonDirectory !== null &&
336
+ origin !== null &&
337
+ repositoryOrigin(candidate.origin) === origin;
338
+ if (common || clone)
339
+ related.set(path, { originFallback: clone });
340
+ }
203
341
  }
204
342
  }
205
- const scans = readRows(database, `SELECT scans.id, scans.target_path, scans.updated_at, scans.started_at,
206
- progress.updated_at AS progress_updated_at,
207
- ${columns.has("target_id") ? "scans.target_id" : "scans.target_path"} AS target_id
208
- FROM scans JOIN scan_progress AS progress ON progress.scan_id = scans.id
209
- WHERE scans.status = 'complete' ${columns.has("canceled_at") ? "AND scans.canceled_at IS NULL" : ""}
210
- ORDER BY scans.id`)
211
- .map((scan) => ({
212
- ...scan,
213
- updatedAt: compareTimestamps(scan.updated_at, scan.progress_updated_at) > 0
214
- ? scan.updated_at
215
- : scan.progress_updated_at,
216
- }))
217
- .sort((a, b) => compareTimestamps(b.updatedAt, a.updatedAt) ||
218
- compareTimestamps(b.started_at, a.started_at));
343
+ const selected = [];
219
344
  for (const scan of scans) {
220
345
  signal?.throwIfAborted();
221
- if (related.has(scan.target_id ?? "") ||
222
- (await pathKey(scan.target_path)) === current)
223
- return [scan];
346
+ const match = related.get(scan.target_path);
347
+ // Scan generations survive legacy unbound registry rows and removed or reused paths.
348
+ // The caller-scoped workbench query remains authoritative for membership.
349
+ if (match || (caller !== null && scan.repository_generation != null))
350
+ selected.push({
351
+ ...scan,
352
+ originFallback: match?.originFallback ?? false,
353
+ // An existing path unrelated to the caller no longer supplies its source.
354
+ // Keep the historical binding for lookup without trusting it as a live target.
355
+ protectPython: match !== undefined || protectedAncestorPaths.has(scan.target_path),
356
+ });
224
357
  }
225
- if (gitMatchingUnavailable)
358
+ if (related.size === 0 && gitMatchingUnavailable)
226
359
  throw new CodexSecurityError("No completed saved scan matched this exact path, and Git-based matching across worktrees or clones is unavailable. Use an explicit saved scan ID: codex-security dedupe --scan SCAN_ID");
227
- return [];
360
+ return selected;
361
+ }
362
+ function timestampOrderKey(value) {
363
+ const match = /^(\d{4}-\d{2}-\d{2}[Tt]\d{2}:\d{2}:\d{2})(?:\.([0-9]+))?([Zz]|[+-]\d{2}:\d{2})$/.exec(value);
364
+ const seconds = match
365
+ ? Date.parse(`${match[1]}${match[3]}`.toUpperCase())
366
+ : NaN;
367
+ // Legacy naive or malformed rows retain opaque text ordering. The scoped
368
+ // workbench query still owns their diagnostics, without using the host timezone.
369
+ if (!Number.isFinite(seconds))
370
+ return `0${value}`;
371
+ const instant = new Date(seconds);
372
+ const whole = instant.toISOString().slice(0, -5);
373
+ // An offset can carry a supported four-digit local year into UTC year 10000.
374
+ const year = String(instant.getUTCFullYear()).padStart(5, "0");
375
+ const digits = match[2] ?? "";
376
+ let fractionEnd = digits.length;
377
+ while (fractionEnd > 0 && digits[fractionEnd - 1] === "0")
378
+ fractionEnd--;
379
+ const fraction = digits.slice(0, fractionEnd);
380
+ return `${year}${whole.slice(whole.indexOf("-"))}${fraction ? `.${fraction}` : ""}`;
228
381
  }
229
- async function pathKey(path) {
230
- const canonical = await realpath(path).catch(() => resolve(path));
231
- return process.platform === "win32" ? canonical.toLowerCase() : canonical;
382
+ function compareOrderKeys(left, right) {
383
+ return left < right ? -1 : left > right ? 1 : 0;
232
384
  }
233
385
  // Match the workbench history's host/path identity across HTTPS and SSH origins.
234
386
  function repositoryOrigin(remote) {