@openai/codex-security 0.8.3 → 0.10.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 (658) hide show
  1. package/README.md +36 -746
  2. package/_bundled_plugin/.codex-plugin/plugin.json +2 -0
  3. package/_bundled_plugin/.mcp.json +7 -1
  4. package/_bundled_plugin/examples/completed-scan/findings.json +16 -4
  5. package/_bundled_plugin/examples/completed-scan/report.md +11 -8
  6. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +4 -2
  7. package/_bundled_plugin/mcp/fzstd-LICENSE.txt +21 -0
  8. package/_bundled_plugin/mcp/helpers.mjs +2 -11
  9. package/_bundled_plugin/mcp/helpers.mjs.br +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +3 -210
  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/package.json +1 -0
  20. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +5 -2
  21. package/_bundled_plugin/mcp/server.mjs +2 -11
  22. package/_bundled_plugin/mcp/server.mjs.br +0 -0
  23. package/_bundled_plugin/mcp/session-decompression.mjs +712 -0
  24. package/_bundled_plugin/references/artifact-storage.md +1 -1
  25. package/_bundled_plugin/references/baseline-auditor.md +18 -0
  26. package/_bundled_plugin/references/core-scan.md +5 -42
  27. package/_bundled_plugin/references/default-severity-rubric.md +9 -4
  28. package/_bundled_plugin/references/final-report.md +5 -3
  29. package/_bundled_plugin/references/finding-detail-fields.md +18 -18
  30. package/_bundled_plugin/references/focused-investigator.md +13 -0
  31. package/_bundled_plugin/references/sarif-adapter.md +8 -2
  32. package/_bundled_plugin/references/scan-artifacts.md +21 -12
  33. package/_bundled_plugin/references/scan-contract.md +27 -33
  34. package/_bundled_plugin/references/scan-prologue.md +2 -2
  35. package/_bundled_plugin/references/scan-runtime.md +4 -2
  36. package/_bundled_plugin/references/security-guidance.md +14 -1
  37. package/_bundled_plugin/references/validate-scan-findings.md +3 -0
  38. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +2 -2
  39. package/_bundled_plugin/scripts/check_deep_scan_target.py +97 -0
  40. package/_bundled_plugin/scripts/codex_profile.mjs +7 -1
  41. package/_bundled_plugin/scripts/deep_scan_config.py +20 -1
  42. package/_bundled_plugin/scripts/deep_scan_workbench.py +192 -352
  43. package/_bundled_plugin/scripts/dispatch_inventory_tool +7 -0
  44. package/_bundled_plugin/scripts/filesystem_identity.py +1 -0
  45. package/_bundled_plugin/scripts/finalize_scan_contract.py +182 -230
  46. package/_bundled_plugin/scripts/finding_preview.py +20 -0
  47. package/_bundled_plugin/scripts/launch_codex_security_mcp +55 -16
  48. package/_bundled_plugin/scripts/legacy_findings.py +148 -0
  49. package/_bundled_plugin/scripts/posix_scan_local_files.py +37 -1
  50. package/_bundled_plugin/scripts/read_codex_session.mjs +21 -0
  51. package/_bundled_plugin/scripts/report_projection.py +81 -43
  52. package/_bundled_plugin/scripts/review_state.py +8 -2
  53. package/_bundled_plugin/scripts/servicenow_avit.py +20 -0
  54. package/_bundled_plugin/scripts/snapshot_sqlite.py +9 -2
  55. package/_bundled_plugin/scripts/threat_model_projection.py +22 -26
  56. package/_bundled_plugin/scripts/validate_scan_contract.py +7 -1
  57. package/_bundled_plugin/scripts/windows_scan_local_files.py +582 -20
  58. package/_bundled_plugin/scripts/workbench/__init__.py +1 -1
  59. package/_bundled_plugin/scripts/workbench/handoff.py +100 -23
  60. package/_bundled_plugin/scripts/workbench/retained_coverage.py +30 -51
  61. package/_bundled_plugin/scripts/workbench/retained_records.py +18 -30
  62. package/_bundled_plugin/scripts/workbench/runtime_toml.py +4 -1
  63. package/_bundled_plugin/scripts/workbench/saved_coverage.py +9 -17
  64. package/_bundled_plugin/scripts/workbench/saved_outputs.py +9 -0
  65. package/_bundled_plugin/scripts/workbench/saved_sources.py +47 -40
  66. package/_bundled_plugin/scripts/workbench/storage.py +91 -7
  67. package/_bundled_plugin/scripts/workbench_cli.py +54 -14
  68. package/_bundled_plugin/scripts/workbench_constants.py +12 -0
  69. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +3 -3
  70. package/_bundled_plugin/scripts/workbench_db.py +562 -303
  71. package/_bundled_plugin/scripts/workbench_feedback.py +57 -11
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +1 -0
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +4 -0
  74. package/_bundled_plugin/scripts/workbench_native_indexes.py +238 -41
  75. package/_bundled_plugin/scripts/workbench_progress.py +169 -4
  76. package/_bundled_plugin/scripts/workbench_publication.py +16 -13
  77. package/_bundled_plugin/scripts/workbench_remediation.py +155 -2
  78. package/_bundled_plugin/scripts/workbench_saved_results.py +176 -81
  79. package/_bundled_plugin/scripts/workbench_scan_history.py +398 -174
  80. package/_bundled_plugin/scripts/workbench_scan_start.py +224 -31
  81. package/_bundled_plugin/scripts/workbench_scan_usage.py +675 -73
  82. package/_bundled_plugin/scripts/workbench_schema.py +258 -63
  83. package/_bundled_plugin/scripts/workbench_setup.py +14 -2
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +13 -0
  85. package/_bundled_plugin/scripts/workbench_source_scopes.py +18 -0
  86. package/_bundled_plugin/scripts/workbench_target.py +594 -136
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1110 -21
  88. package/_bundled_plugin/scripts/workbench_validation.py +43 -3
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +77 -35
  90. package/_bundled_plugin/shared/workbench-migrations.json +100 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +5 -5
  92. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +7 -50
  93. package/_bundled_plugin/skills/fix-finding/SKILL.md +2 -1
  94. package/_bundled_plugin/skills/publish-findings/SKILL.md +24 -153
  95. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +2 -2
  96. package/_bundled_plugin/skills/publish-findings/references/checkmarx-import.md +37 -0
  97. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +3 -3
  98. package/_bundled_plugin/skills/publish-findings/scripts/collect_checkmarx.py +409 -0
  99. package/_bundled_plugin/skills/publish-findings/scripts/collect_continuum.py +224 -0
  100. package/_bundled_plugin/skills/publish-findings/scripts/collector_paths.py +63 -0
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +9 -46
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +2 -2
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +3 -21
  104. package/_bundled_plugin/skills/security-scan/references/managed-scan.md +11 -0
  105. package/_bundled_plugin/skills/security-scan/references/scan-results.md +15 -0
  106. package/_bundled_plugin/skills/security-scan/references/scoped-paths.md +23 -0
  107. package/_bundled_plugin/skills/security-scan/references/sdk-files.md +24 -0
  108. package/_bundled_plugin/skills/threat-model-visualize/scripts/build_explorer.py +22 -1
  109. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -2
  110. package/bin/codex-security.mjs +2 -2
  111. package/dist/api.d.ts +45 -5
  112. package/dist/api.d.ts.map +1 -1
  113. package/dist/api.js +1192 -427
  114. package/dist/api.js.map +1 -1
  115. package/dist/armorcode-findings.d.ts +9 -0
  116. package/dist/armorcode-findings.d.ts.map +1 -0
  117. package/dist/armorcode-findings.js +145 -0
  118. package/dist/armorcode-findings.js.map +1 -0
  119. package/dist/artifact-export.d.ts +2 -0
  120. package/dist/artifact-export.d.ts.map +1 -1
  121. package/dist/artifact-export.js +29 -13
  122. package/dist/artifact-export.js.map +1 -1
  123. package/dist/auth.d.ts +6 -2
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +37 -18
  126. package/dist/auth.js.map +1 -1
  127. package/dist/batch-cost.d.ts +18 -0
  128. package/dist/batch-cost.d.ts.map +1 -0
  129. package/dist/batch-cost.js +41 -0
  130. package/dist/batch-cost.js.map +1 -0
  131. package/dist/bedrock-oss-pricing.d.ts +6 -0
  132. package/dist/bedrock-oss-pricing.d.ts.map +1 -0
  133. package/dist/bedrock-oss-pricing.js +58 -0
  134. package/dist/bedrock-oss-pricing.js.map +1 -0
  135. package/dist/bedrock-pricing.d.ts +15 -0
  136. package/dist/bedrock-pricing.d.ts.map +1 -0
  137. package/dist/bedrock-pricing.js +117 -0
  138. package/dist/bedrock-pricing.js.map +1 -0
  139. package/dist/blackduck-findings.d.ts +1 -1
  140. package/dist/blackduck-findings.d.ts.map +1 -1
  141. package/dist/blackduck-findings.js +24 -22
  142. package/dist/blackduck-findings.js.map +1 -1
  143. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  144. package/dist/bulk-scan-discovery.js +4 -4
  145. package/dist/bulk-scan-discovery.js.map +1 -1
  146. package/dist/bundled-plugin.d.ts +4 -0
  147. package/dist/bundled-plugin.d.ts.map +1 -0
  148. package/dist/bundled-plugin.js +23 -0
  149. package/dist/bundled-plugin.js.map +1 -0
  150. package/dist/checkmarx-evidence.d.ts +19 -0
  151. package/dist/checkmarx-evidence.d.ts.map +1 -0
  152. package/dist/checkmarx-evidence.js +36 -0
  153. package/dist/checkmarx-evidence.js.map +1 -0
  154. package/dist/checkmarx-findings.d.ts +4 -0
  155. package/dist/checkmarx-findings.d.ts.map +1 -0
  156. package/dist/checkmarx-findings.js +27 -0
  157. package/dist/checkmarx-findings.js.map +1 -0
  158. package/dist/checkmarx-one.d.ts +4 -0
  159. package/dist/checkmarx-one.d.ts.map +1 -0
  160. package/dist/checkmarx-one.js +53 -0
  161. package/dist/checkmarx-one.js.map +1 -0
  162. package/dist/checkmarx-repository.d.ts +12 -0
  163. package/dist/checkmarx-repository.d.ts.map +1 -0
  164. package/dist/checkmarx-repository.js +181 -0
  165. package/dist/checkmarx-repository.js.map +1 -0
  166. package/dist/checkmarx-xml.d.ts +12 -0
  167. package/dist/checkmarx-xml.d.ts.map +1 -0
  168. package/dist/checkmarx-xml.js +196 -0
  169. package/dist/checkmarx-xml.js.map +1 -0
  170. package/dist/classify-scan-severity.d.ts +1 -1
  171. package/dist/classify-scan-severity.d.ts.map +1 -1
  172. package/dist/classify-scan-severity.js +11 -3
  173. package/dist/classify-scan-severity.js.map +1 -1
  174. package/dist/classify-severity-records.d.ts +1 -9
  175. package/dist/classify-severity-records.d.ts.map +1 -1
  176. package/dist/classify-severity-records.js +3 -13
  177. package/dist/classify-severity-records.js.map +1 -1
  178. package/dist/classify-severity.d.ts.map +1 -1
  179. package/dist/classify-severity.js +11 -10
  180. package/dist/classify-severity.js.map +1 -1
  181. package/dist/cli-argument.d.ts +4 -0
  182. package/dist/cli-argument.d.ts.map +1 -0
  183. package/dist/cli-argument.js +17 -0
  184. package/dist/cli-argument.js.map +1 -0
  185. package/dist/cli-help.d.ts +1 -1
  186. package/dist/cli-help.d.ts.map +1 -1
  187. package/dist/cli-help.js +71 -29
  188. package/dist/cli-help.js.map +1 -1
  189. package/dist/cli-hook.d.ts +3 -0
  190. package/dist/cli-hook.d.ts.map +1 -0
  191. package/dist/cli-hook.js +87 -0
  192. package/dist/cli-hook.js.map +1 -0
  193. package/dist/cli-integrations.d.ts +13 -0
  194. package/dist/cli-integrations.d.ts.map +1 -0
  195. package/dist/cli-integrations.js +333 -0
  196. package/dist/cli-integrations.js.map +1 -0
  197. package/dist/cli-mcp.d.ts +15 -0
  198. package/dist/cli-mcp.d.ts.map +1 -0
  199. package/dist/cli-mcp.js +178 -0
  200. package/dist/cli-mcp.js.map +1 -0
  201. package/dist/cli-token-view.d.ts +10 -0
  202. package/dist/cli-token-view.d.ts.map +1 -0
  203. package/dist/cli-token-view.js +41 -0
  204. package/dist/cli-token-view.js.map +1 -0
  205. package/dist/cli.d.ts +16 -8
  206. package/dist/cli.d.ts.map +1 -1
  207. package/dist/cli.js +3382 -2017
  208. package/dist/cli.js.map +1 -1
  209. package/dist/cloud-publish.d.ts.map +1 -1
  210. package/dist/cloud-publish.js +35 -33
  211. package/dist/cloud-publish.js.map +1 -1
  212. package/dist/codex-sdk-environment.d.ts +6 -0
  213. package/dist/codex-sdk-environment.d.ts.map +1 -1
  214. package/dist/codex-sdk-environment.js +19 -0
  215. package/dist/codex-sdk-environment.js.map +1 -1
  216. package/dist/command-words.d.ts +3 -0
  217. package/dist/command-words.d.ts.map +1 -0
  218. package/dist/command-words.js +46 -0
  219. package/dist/command-words.js.map +1 -0
  220. package/dist/component-scan.d.ts +19 -4
  221. package/dist/component-scan.d.ts.map +1 -1
  222. package/dist/component-scan.js +67 -9
  223. package/dist/component-scan.js.map +1 -1
  224. package/dist/config.d.ts +1 -1
  225. package/dist/config.d.ts.map +1 -1
  226. package/dist/config.js +130 -67
  227. package/dist/config.js.map +1 -1
  228. package/dist/continuum-findings.d.ts +1 -1
  229. package/dist/continuum-findings.d.ts.map +1 -1
  230. package/dist/continuum-findings.js +149 -19
  231. package/dist/continuum-findings.js.map +1 -1
  232. package/dist/contract-values.d.ts +2 -0
  233. package/dist/contract-values.d.ts.map +1 -1
  234. package/dist/contract-values.js +12 -9
  235. package/dist/contract-values.js.map +1 -1
  236. package/dist/cost-model.d.ts +13 -1
  237. package/dist/cost-model.d.ts.map +1 -1
  238. package/dist/cost-model.js +66 -112
  239. package/dist/cost-model.js.map +1 -1
  240. package/dist/cost.d.ts +42 -3
  241. package/dist/cost.d.ts.map +1 -1
  242. package/dist/cost.js +484 -149
  243. package/dist/cost.js.map +1 -1
  244. package/dist/custom-publish.d.ts +4 -0
  245. package/dist/custom-publish.d.ts.map +1 -1
  246. package/dist/custom-publish.js +40 -3
  247. package/dist/custom-publish.js.map +1 -1
  248. package/dist/custom-validation-prompt.d.ts +1 -1
  249. package/dist/custom-validation-prompt.d.ts.map +1 -1
  250. package/dist/custom-validation-prompt.js +29 -19
  251. package/dist/custom-validation-prompt.js.map +1 -1
  252. package/dist/deduplication/local.d.ts +4 -2
  253. package/dist/deduplication/local.d.ts.map +1 -1
  254. package/dist/deduplication/local.js +9 -2
  255. package/dist/deduplication/local.js.map +1 -1
  256. package/dist/deduplication/refusal.d.ts.map +1 -1
  257. package/dist/deduplication/refusal.js +26 -5
  258. package/dist/deduplication/refusal.js.map +1 -1
  259. package/dist/deduplication/scan.d.ts +5 -0
  260. package/dist/deduplication/scan.d.ts.map +1 -1
  261. package/dist/deduplication/scan.js +24 -7
  262. package/dist/deduplication/scan.js.map +1 -1
  263. package/dist/deep-config.d.ts +0 -1
  264. package/dist/deep-config.d.ts.map +1 -1
  265. package/dist/deep-config.js +22 -33
  266. package/dist/deep-config.js.map +1 -1
  267. package/dist/deep-scan-defaults.d.ts +2 -0
  268. package/dist/deep-scan-defaults.d.ts.map +1 -1
  269. package/dist/deep-scan-defaults.js +28 -1
  270. package/dist/deep-scan-defaults.js.map +1 -1
  271. package/dist/deep-scan.d.ts +2 -0
  272. package/dist/deep-scan.d.ts.map +1 -1
  273. package/dist/deep-scan.js +44 -19
  274. package/dist/deep-scan.js.map +1 -1
  275. package/dist/default-severity-rubric.d.ts +1 -1
  276. package/dist/default-severity-rubric.d.ts.map +1 -1
  277. package/dist/default-severity-rubric.js +1 -1
  278. package/dist/default-severity-rubric.js.map +1 -1
  279. package/dist/endor-findings.d.ts +3 -1
  280. package/dist/endor-findings.d.ts.map +1 -1
  281. package/dist/endor-findings.js +86 -45
  282. package/dist/endor-findings.js.map +1 -1
  283. package/dist/errors.d.ts +4 -2
  284. package/dist/errors.d.ts.map +1 -1
  285. package/dist/errors.js +15 -4
  286. package/dist/errors.js.map +1 -1
  287. package/dist/executable-path.d.ts +3 -0
  288. package/dist/executable-path.d.ts.map +1 -1
  289. package/dist/executable-path.js +26 -0
  290. package/dist/executable-path.js.map +1 -1
  291. package/dist/external-findings-import.d.ts +5 -3
  292. package/dist/external-findings-import.d.ts.map +1 -1
  293. package/dist/external-findings-import.js +19 -7
  294. package/dist/external-findings-import.js.map +1 -1
  295. package/dist/external-findings-local.d.ts +69 -5
  296. package/dist/external-findings-local.d.ts.map +1 -1
  297. package/dist/external-findings-local.js +537 -108
  298. package/dist/external-findings-local.js.map +1 -1
  299. package/dist/external-findings-publish.d.ts +13 -6
  300. package/dist/external-findings-publish.d.ts.map +1 -1
  301. package/dist/external-findings-publish.js +895 -1142
  302. package/dist/external-findings-publish.js.map +1 -1
  303. package/dist/external-findings-read.d.ts +21 -2
  304. package/dist/external-findings-read.d.ts.map +1 -1
  305. package/dist/external-findings-read.js +130 -68
  306. package/dist/external-findings-read.js.map +1 -1
  307. package/dist/external-findings.d.ts +15 -3
  308. package/dist/external-findings.d.ts.map +1 -1
  309. package/dist/external-findings.js +54 -2
  310. package/dist/external-findings.js.map +1 -1
  311. package/dist/external-import-contract.d.ts +8 -12
  312. package/dist/external-import-contract.d.ts.map +1 -1
  313. package/dist/external-import-contract.js +51 -184
  314. package/dist/external-import-contract.js.map +1 -1
  315. package/dist/external-import-models.d.ts +1 -1
  316. package/dist/external-import-models.d.ts.map +1 -1
  317. package/dist/external-import-models.js.map +1 -1
  318. package/dist/feedback.d.ts.map +1 -1
  319. package/dist/feedback.js +5 -4
  320. package/dist/feedback.js.map +1 -1
  321. package/dist/finding-prompt.d.ts +5 -0
  322. package/dist/finding-prompt.d.ts.map +1 -0
  323. package/dist/finding-prompt.js +32 -0
  324. package/dist/finding-prompt.js.map +1 -0
  325. package/dist/findings-client.d.ts +1 -0
  326. package/dist/findings-client.d.ts.map +1 -1
  327. package/dist/findings-client.js +27 -3
  328. package/dist/findings-client.js.map +1 -1
  329. package/dist/github-advisories.d.ts.map +1 -1
  330. package/dist/github-advisories.js +0 -2
  331. package/dist/github-advisories.js.map +1 -1
  332. package/dist/github-dependabot-findings.d.ts.map +1 -1
  333. package/dist/github-dependabot-findings.js +18 -8
  334. package/dist/github-dependabot-findings.js.map +1 -1
  335. package/dist/github-findings.d.ts +4 -1
  336. package/dist/github-findings.d.ts.map +1 -1
  337. package/dist/github-findings.js +73 -316
  338. package/dist/github-findings.js.map +1 -1
  339. package/dist/hosted-git-remotes.d.ts +5 -0
  340. package/dist/hosted-git-remotes.d.ts.map +1 -0
  341. package/dist/hosted-git-remotes.js +285 -0
  342. package/dist/hosted-git-remotes.js.map +1 -0
  343. package/dist/hosted-git-repository.d.ts +28 -0
  344. package/dist/hosted-git-repository.d.ts.map +1 -0
  345. package/dist/hosted-git-repository.js +222 -0
  346. package/dist/hosted-git-repository.js.map +1 -0
  347. package/dist/hosted-remediation.d.ts +1 -0
  348. package/dist/hosted-remediation.d.ts.map +1 -1
  349. package/dist/hosted-remediation.js +23 -3
  350. package/dist/hosted-remediation.js.map +1 -1
  351. package/dist/hosted-scan-protocol.js +2 -2
  352. package/dist/hosted-scan-protocol.js.map +1 -1
  353. package/dist/hosted-scan.d.ts.map +1 -1
  354. package/dist/hosted-scan.js +16 -11
  355. package/dist/hosted-scan.js.map +1 -1
  356. package/dist/hosted-scanner-http.d.ts +21 -0
  357. package/dist/hosted-scanner-http.d.ts.map +1 -0
  358. package/dist/hosted-scanner-http.js +204 -0
  359. package/dist/hosted-scanner-http.js.map +1 -0
  360. package/dist/import-scan.d.ts.map +1 -1
  361. package/dist/import-scan.js +3 -0
  362. package/dist/import-scan.js.map +1 -1
  363. package/dist/index.d.ts +21 -9
  364. package/dist/index.d.ts.map +1 -1
  365. package/dist/index.js +12 -3
  366. package/dist/index.js.map +1 -1
  367. package/dist/inspector-findings.d.ts.map +1 -1
  368. package/dist/inspector-findings.js +52 -86
  369. package/dist/inspector-findings.js.map +1 -1
  370. package/dist/knowledge-base.d.ts +1 -1
  371. package/dist/knowledge-base.d.ts.map +1 -1
  372. package/dist/knowledge-base.js +102 -32
  373. package/dist/knowledge-base.js.map +1 -1
  374. package/dist/linear.d.ts +11 -0
  375. package/dist/linear.d.ts.map +1 -1
  376. package/dist/linear.js.map +1 -1
  377. package/dist/local-git-metadata.d.ts +5 -2
  378. package/dist/local-git-metadata.d.ts.map +1 -1
  379. package/dist/local-git-metadata.js +8 -5
  380. package/dist/local-git-metadata.js.map +1 -1
  381. package/dist/multiscan.d.ts +10 -4
  382. package/dist/multiscan.d.ts.map +1 -1
  383. package/dist/multiscan.js +217 -102
  384. package/dist/multiscan.js.map +1 -1
  385. package/dist/native-json-findings.d.ts +2 -1
  386. package/dist/native-json-findings.d.ts.map +1 -1
  387. package/dist/native-json-findings.js +12 -2
  388. package/dist/native-json-findings.js.map +1 -1
  389. package/dist/opengrep-findings.d.ts +5 -2
  390. package/dist/opengrep-findings.d.ts.map +1 -1
  391. package/dist/opengrep-findings.js +54 -33
  392. package/dist/opengrep-findings.js.map +1 -1
  393. package/dist/operation-telemetry.d.ts +104 -0
  394. package/dist/operation-telemetry.d.ts.map +1 -0
  395. package/dist/operation-telemetry.js +293 -0
  396. package/dist/operation-telemetry.js.map +1 -0
  397. package/dist/plugin-python-probe.d.ts +4 -0
  398. package/dist/plugin-python-probe.d.ts.map +1 -0
  399. package/dist/plugin-python-probe.js +10 -0
  400. package/dist/plugin-python-probe.js.map +1 -0
  401. package/dist/private-finding-import.d.ts +99 -9
  402. package/dist/private-finding-import.d.ts.map +1 -1
  403. package/dist/private-finding-import.js +116 -152
  404. package/dist/private-finding-import.js.map +1 -1
  405. package/dist/project-config.d.ts.map +1 -1
  406. package/dist/project-config.js +53 -13
  407. package/dist/project-config.js.map +1 -1
  408. package/dist/prompt-files.d.ts +7 -2
  409. package/dist/prompt-files.d.ts.map +1 -1
  410. package/dist/prompt-files.js +42 -20
  411. package/dist/prompt-files.js.map +1 -1
  412. package/dist/provider-profile.d.ts +1 -1
  413. package/dist/provider-profile.d.ts.map +1 -1
  414. package/dist/provider-profile.js +12 -10
  415. package/dist/provider-profile.js.map +1 -1
  416. package/dist/publication-telemetry.d.ts +45 -0
  417. package/dist/publication-telemetry.d.ts.map +1 -0
  418. package/dist/publication-telemetry.js +50 -0
  419. package/dist/publication-telemetry.js.map +1 -0
  420. package/dist/publication.d.ts +1 -1
  421. package/dist/publication.d.ts.map +1 -1
  422. package/dist/publication.js.map +1 -1
  423. package/dist/publish.d.ts +4 -0
  424. package/dist/publish.d.ts.map +1 -1
  425. package/dist/publish.js +42 -2
  426. package/dist/publish.js.map +1 -1
  427. package/dist/record.d.ts +1 -5
  428. package/dist/record.d.ts.map +1 -1
  429. package/dist/record.js +3 -51
  430. package/dist/record.js.map +1 -1
  431. package/dist/remediation.d.ts +1 -4
  432. package/dist/remediation.d.ts.map +1 -1
  433. package/dist/remediation.js +6 -8
  434. package/dist/remediation.js.map +1 -1
  435. package/dist/request-metadata.d.ts +3 -0
  436. package/dist/request-metadata.d.ts.map +1 -1
  437. package/dist/request-metadata.js +9 -0
  438. package/dist/request-metadata.js.map +1 -1
  439. package/dist/result.d.ts +4 -0
  440. package/dist/result.d.ts.map +1 -1
  441. package/dist/result.js +1 -1
  442. package/dist/result.js.map +1 -1
  443. package/dist/retry-windows-rename.d.ts +8 -0
  444. package/dist/retry-windows-rename.d.ts.map +1 -0
  445. package/dist/retry-windows-rename.js +24 -0
  446. package/dist/retry-windows-rename.js.map +1 -0
  447. package/dist/runtime.d.ts +54 -6
  448. package/dist/runtime.d.ts.map +1 -1
  449. package/dist/runtime.js +1084 -256
  450. package/dist/runtime.js.map +1 -1
  451. package/dist/saved-scan-bootstrap.d.ts +7 -1
  452. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  453. package/dist/saved-scan-bootstrap.js +269 -114
  454. package/dist/saved-scan-bootstrap.js.map +1 -1
  455. package/dist/scan-activity.d.ts.map +1 -1
  456. package/dist/scan-activity.js +141 -56
  457. package/dist/scan-activity.js.map +1 -1
  458. package/dist/scan-archive-path.d.ts +2 -0
  459. package/dist/scan-archive-path.d.ts.map +1 -0
  460. package/dist/scan-archive-path.js +5 -0
  461. package/dist/scan-archive-path.js.map +1 -0
  462. package/dist/scan-comparison.d.ts +10 -5
  463. package/dist/scan-comparison.d.ts.map +1 -1
  464. package/dist/scan-comparison.js +66 -17
  465. package/dist/scan-comparison.js.map +1 -1
  466. package/dist/scan-dashboard.d.ts +7 -6
  467. package/dist/scan-dashboard.d.ts.map +1 -1
  468. package/dist/scan-dashboard.js +92 -43
  469. package/dist/scan-dashboard.js.map +1 -1
  470. package/dist/scan-executor.d.ts +10 -1
  471. package/dist/scan-executor.d.ts.map +1 -1
  472. package/dist/scan-executor.js +24 -2
  473. package/dist/scan-executor.js.map +1 -1
  474. package/dist/scan-history-renderer.d.ts +1 -0
  475. package/dist/scan-history-renderer.d.ts.map +1 -1
  476. package/dist/scan-history-renderer.js +34 -28
  477. package/dist/scan-history-renderer.js.map +1 -1
  478. package/dist/scan-logs.d.ts +12 -0
  479. package/dist/scan-logs.d.ts.map +1 -1
  480. package/dist/scan-logs.js +131 -78
  481. package/dist/scan-logs.js.map +1 -1
  482. package/dist/scan-measurement.d.ts +26 -0
  483. package/dist/scan-measurement.d.ts.map +1 -0
  484. package/dist/scan-measurement.js +77 -0
  485. package/dist/scan-measurement.js.map +1 -0
  486. package/dist/scan-progress.d.ts +1 -0
  487. package/dist/scan-progress.d.ts.map +1 -1
  488. package/dist/scan-progress.js +3 -0
  489. package/dist/scan-progress.js.map +1 -1
  490. package/dist/scan-sessions.d.ts.map +1 -1
  491. package/dist/scan-sessions.js +4 -1
  492. package/dist/scan-sessions.js.map +1 -1
  493. package/dist/scan-settings.d.ts +1 -1
  494. package/dist/scan-settings.d.ts.map +1 -1
  495. package/dist/scan-settings.js +1 -24
  496. package/dist/scan-settings.js.map +1 -1
  497. package/dist/scanner-import.d.ts +25 -13
  498. package/dist/scanner-import.d.ts.map +1 -1
  499. package/dist/scanner-import.js +216 -97
  500. package/dist/scanner-import.js.map +1 -1
  501. package/dist/scanner-repository-url.d.ts +4 -1
  502. package/dist/scanner-repository-url.d.ts.map +1 -1
  503. package/dist/scanner-repository-url.js +10 -6
  504. package/dist/scanner-repository-url.js.map +1 -1
  505. package/dist/security-policy.d.ts +1 -1
  506. package/dist/security-policy.d.ts.map +1 -1
  507. package/dist/security-policy.js +26 -6
  508. package/dist/security-policy.js.map +1 -1
  509. package/dist/semgrep-findings.d.ts +6 -3
  510. package/dist/semgrep-findings.d.ts.map +1 -1
  511. package/dist/semgrep-findings.js +72 -42
  512. package/dist/semgrep-findings.js.map +1 -1
  513. package/dist/semgrep-guardian-findings.d.ts +38 -0
  514. package/dist/semgrep-guardian-findings.d.ts.map +1 -0
  515. package/dist/semgrep-guardian-findings.js +165 -0
  516. package/dist/semgrep-guardian-findings.js.map +1 -0
  517. package/dist/semgrep-platform-collector.d.ts +26 -0
  518. package/dist/semgrep-platform-collector.d.ts.map +1 -0
  519. package/dist/semgrep-platform-collector.js +108 -0
  520. package/dist/semgrep-platform-collector.js.map +1 -0
  521. package/dist/semgrep-platform-findings.d.ts +157 -6
  522. package/dist/semgrep-platform-findings.d.ts.map +1 -1
  523. package/dist/semgrep-platform-findings.js +766 -103
  524. package/dist/semgrep-platform-findings.js.map +1 -1
  525. package/dist/server/api.d.ts +1 -1
  526. package/dist/server/api.d.ts.map +1 -1
  527. package/dist/server/api.js.map +1 -1
  528. package/dist/server/embedding-tokenizer.cdx.json +33 -0
  529. package/dist/server/embedding-tokenizer.d.ts +2 -0
  530. package/dist/server/embedding-tokenizer.d.ts.map +1 -0
  531. package/dist/server/embedding-tokenizer.js +322 -0
  532. package/dist/server/embedding-tokenizer.js.map +6 -0
  533. package/dist/server/embeddings.d.ts +16 -2
  534. package/dist/server/embeddings.d.ts.map +1 -1
  535. package/dist/server/embeddings.js +35 -5
  536. package/dist/server/embeddings.js.map +1 -1
  537. package/dist/session-lines.d.ts +5 -0
  538. package/dist/session-lines.d.ts.map +1 -0
  539. package/dist/session-lines.js +60 -0
  540. package/dist/session-lines.js.map +1 -0
  541. package/dist/severity-review.d.ts +3 -1
  542. package/dist/severity-review.d.ts.map +1 -1
  543. package/dist/severity-review.js +3 -2
  544. package/dist/severity-review.js.map +1 -1
  545. package/dist/skill-authentication.d.ts +1 -0
  546. package/dist/skill-authentication.d.ts.map +1 -1
  547. package/dist/skill-authentication.js +1 -0
  548. package/dist/skill-authentication.js.map +1 -1
  549. package/dist/snyk-findings.d.ts +9 -2
  550. package/dist/snyk-findings.d.ts.map +1 -1
  551. package/dist/snyk-findings.js +90 -70
  552. package/dist/snyk-findings.js.map +1 -1
  553. package/dist/snyk-rest-findings.d.ts +59 -0
  554. package/dist/snyk-rest-findings.d.ts.map +1 -0
  555. package/dist/snyk-rest-findings.js +879 -0
  556. package/dist/snyk-rest-findings.js.map +1 -0
  557. package/dist/snyk-token-origin.d.ts +4 -0
  558. package/dist/snyk-token-origin.d.ts.map +1 -0
  559. package/dist/snyk-token-origin.js +82 -0
  560. package/dist/snyk-token-origin.js.map +1 -0
  561. package/dist/sonar-collector.d.ts.map +1 -1
  562. package/dist/sonar-collector.js +0 -3
  563. package/dist/sonar-collector.js.map +1 -1
  564. package/dist/sonar-findings.d.ts +1 -1
  565. package/dist/sonar-findings.d.ts.map +1 -1
  566. package/dist/sonar-findings.js +2 -4
  567. package/dist/sonar-findings.js.map +1 -1
  568. package/dist/sonar-import.d.ts +3 -0
  569. package/dist/sonar-import.d.ts.map +1 -1
  570. package/dist/sonar-import.js +30 -34
  571. package/dist/sonar-import.js.map +1 -1
  572. package/dist/stored-finding-projection.d.ts +6 -0
  573. package/dist/stored-finding-projection.d.ts.map +1 -0
  574. package/dist/stored-finding-projection.js +104 -0
  575. package/dist/stored-finding-projection.js.map +1 -0
  576. package/dist/stored-findings-publication.d.ts +23 -0
  577. package/dist/stored-findings-publication.d.ts.map +1 -0
  578. package/dist/stored-findings-publication.js +169 -0
  579. package/dist/stored-findings-publication.js.map +1 -0
  580. package/dist/target-drift.d.ts +9 -0
  581. package/dist/target-drift.d.ts.map +1 -0
  582. package/dist/target-drift.js +27 -0
  583. package/dist/target-drift.js.map +1 -0
  584. package/dist/targets.d.ts +8 -1
  585. package/dist/targets.d.ts.map +1 -1
  586. package/dist/targets.js +131 -42
  587. package/dist/targets.js.map +1 -1
  588. package/dist/tenable-findings.d.ts +6 -0
  589. package/dist/tenable-findings.d.ts.map +1 -0
  590. package/dist/tenable-findings.js +122 -0
  591. package/dist/tenable-findings.js.map +1 -0
  592. package/dist/terminal-stream.d.ts +13 -0
  593. package/dist/terminal-stream.d.ts.map +1 -0
  594. package/dist/terminal-stream.js +35 -0
  595. package/dist/terminal-stream.js.map +1 -0
  596. package/dist/trivy-findings.d.ts +19 -0
  597. package/dist/trivy-findings.d.ts.map +1 -0
  598. package/dist/trivy-findings.js +424 -0
  599. package/dist/trivy-findings.js.map +1 -0
  600. package/dist/trivy-import.d.ts +19 -0
  601. package/dist/trivy-import.d.ts.map +1 -0
  602. package/dist/trivy-import.js +151 -0
  603. package/dist/trivy-import.js.map +1 -0
  604. package/dist/trusted-executable.d.ts +6 -0
  605. package/dist/trusted-executable.d.ts.map +1 -1
  606. package/dist/trusted-executable.js +140 -37
  607. package/dist/trusted-executable.js.map +1 -1
  608. package/dist/validation-records.js +1 -1
  609. package/dist/validation-records.js.map +1 -1
  610. package/dist/veracode-findings.d.ts +1 -1
  611. package/dist/veracode-findings.d.ts.map +1 -1
  612. package/dist/veracode-findings.js +19 -6
  613. package/dist/veracode-findings.js.map +1 -1
  614. package/dist/version.d.ts +3 -1
  615. package/dist/version.d.ts.map +1 -1
  616. package/dist/version.js +184 -32
  617. package/dist/version.js.map +1 -1
  618. package/dist/vertex-pricing.d.ts +8 -0
  619. package/dist/vertex-pricing.d.ts.map +1 -0
  620. package/dist/vertex-pricing.js +20 -0
  621. package/dist/vertex-pricing.js.map +1 -0
  622. package/dist/windows-path.d.ts +1 -0
  623. package/dist/windows-path.d.ts.map +1 -1
  624. package/dist/windows-path.js +26 -1
  625. package/dist/windows-path.js.map +1 -1
  626. package/dist/wiz-findings.d.ts +6 -2
  627. package/dist/wiz-findings.d.ts.map +1 -1
  628. package/dist/wiz-findings.js +65 -89
  629. package/dist/wiz-findings.js.map +1 -1
  630. package/docs/classify-severity-records.md +27 -12
  631. package/docs/cli.md +853 -639
  632. package/docs/dedupe-records.md +44 -24
  633. package/docs/findings-service.md +84 -44
  634. package/docs/hosted-remediation.md +27 -11
  635. package/docs/hosted-scans.md +50 -42
  636. package/docs/sdk.md +903 -0
  637. package/docs/telemetry.md +236 -0
  638. package/docs/validate-records.md +78 -44
  639. package/package.json +23 -16
  640. package/schemas/external-findings.schema.json +4 -1
  641. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  642. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  643. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  644. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  645. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  646. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +0 -96
  647. package/dist/external-imports-feature.d.ts +0 -6
  648. package/dist/external-imports-feature.d.ts.map +0 -1
  649. package/dist/external-imports-feature.js +0 -51
  650. package/dist/external-imports-feature.js.map +0 -1
  651. package/dist/finding-normalization.d.ts +0 -5
  652. package/dist/finding-normalization.d.ts.map +0 -1
  653. package/dist/finding-normalization.js +0 -155
  654. package/dist/finding-normalization.js.map +0 -1
  655. package/dist/reader-selection.d.ts +0 -13
  656. package/dist/reader-selection.d.ts.map +0 -1
  657. package/dist/reader-selection.js +0 -81
  658. package/dist/reader-selection.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,5 +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
  }>;
20
+ export declare function readSavedScanLifecycle(environment: ProcessEnvironment, scanId: string): unknown;
15
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":"AAaA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,iBAAiB,CAAC;AAC7D,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,cAAc,CAAC;AAiBtB,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"}
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,18 +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";
6
- import { createRequire } from "node:module";
4
+ import { access } from "node:fs/promises";
7
5
  import { isAbsolute, join, resolve } from "node:path";
8
6
  import { gitHistoryIdentity, gitMarkerRoot, gitProtectionRoots, } from "./targets.js";
9
7
  import { CodexSecurityError, errorMessage } from "./errors.js";
10
- import { codexSecurityStateDirectory, resolvePluginPython, runWorkbench, workbenchEnvironment, } from "./runtime.js";
11
- /** 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. */
12
10
  export async function savedScanWorkbench(requestedId, options) {
13
11
  options.signal?.throwIfAborted();
14
12
  const environment = workbenchEnvironment(options.environment);
15
- const targets = await readTargets(requestedId, environment, options.currentDirectory, options.signal);
13
+ const { targets, checkouts } = await readTargets(requestedId, environment, options.currentDirectory, options.signal);
16
14
  const latest = requestedId === "latest" || typeof requestedId !== "string";
17
15
  if (targets.length === 0)
18
16
  throw new CodexSecurityError(typeof requestedId !== "string"
@@ -26,17 +24,21 @@ export async function savedScanWorkbench(requestedId, options) {
26
24
  !isAbsolute(target.target_path)))
27
25
  throw new CodexSecurityError("Saved scan history has no absolute repository target.");
28
26
  const callerRoots = await gitProtectionRoots(options.currentDirectory, options.signal);
27
+ const liveTargets = targets.filter((target) => target.protectPython !== false);
29
28
  const protectedRoots = [
30
29
  ...callerRoots,
31
- ...targets.map((row) => row.target_path),
32
- ...(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(),
33
36
  ];
37
+ const discoveryProtectedRoots = await savedDiscoveryRoots(checkouts, [options.currentDirectory, ...targets.map((row) => row.target_path)], options.signal);
34
38
  let python;
35
39
  const workbench = async (args, input, signal = options.signal) => {
36
40
  signal?.throwIfAborted();
37
- // Return the selected ID directly: probing Python must not revisit unrelated history.
38
- if (requestedId === "latest" && args[0] === "list-scans")
39
- return { scans: targets.map((target) => ({ scanId: target.id })) };
41
+ const selectingLatest = requestedId === "latest" && args[0] === "list-scans";
40
42
  const target = args[0] === "get-scan"
41
43
  ? latest
42
44
  ? targets.find((row) => row.id === args[2])
@@ -44,15 +46,17 @@ export async function savedScanWorkbench(requestedId, options) {
44
46
  : undefined;
45
47
  if (args[0] === "get-scan" && !target)
46
48
  throw new CodexSecurityError("Saved scan history changed during lookup. Retry the command.");
47
- // Pin the interpreter selected with every candidate and the caller checkout protected.
49
+ // Pin one interpreter; ambient discovery also excludes historical candidate paths.
48
50
  python ??= await resolvePluginPython({
49
51
  environment,
50
52
  protectedRoot: protectedRoots,
53
+ discoveryProtectedRoots,
54
+ allowPathLookup: checkouts.complete,
51
55
  currentDirectory: options.currentDirectory,
52
56
  signal,
53
57
  });
54
58
  environment["PYTHON"] = python;
55
- const result = await runWorkbench({
59
+ const execute = (command) => runWorkbench({
56
60
  environment,
57
61
  pluginRoot: options.pluginRoot,
58
62
  python,
@@ -60,7 +64,43 @@ export async function savedScanWorkbench(requestedId, options) {
60
64
  protectedRoot: protectedRoots,
61
65
  currentDirectory: options.currentDirectory,
62
66
  failureMessage: "Could not read Codex Security scan history",
63
- }, 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);
64
104
  if (typeof requestedId !== "string" && args[0] === "finding-workflow") {
65
105
  const workflow = result["workflow"];
66
106
  if (!isRecord(workflow) || workflow["scanId"] !== targets[0].id)
@@ -79,47 +119,25 @@ export async function savedScanWorkbench(requestedId, options) {
79
119
  return Object.assign(workbench, {
80
120
  environment,
81
121
  protectedRoots: [options.currentDirectory, ...protectedRoots],
122
+ nodeDiscovery: {
123
+ protectedRoots: discoveryProtectedRoots,
124
+ allowPathLookup: checkouts.complete,
125
+ },
82
126
  });
83
127
  }
84
128
  async function readTargets(requestedId, environment, currentDirectory, signal) {
85
- const require = createRequire(import.meta.url);
86
- const bun = process.versions["bun"] !== undefined;
87
- const Database = (bun ? require("bun:sqlite").Database : require("node:sqlite").DatabaseSync);
88
- let database;
89
129
  try {
90
- database = new Database(join(codexSecurityStateDirectory(environment), "workbench.sqlite3"),
91
- // Apple's SQLite cannot initialize absent WAL sidecars through a read-only handle.
92
- // Open only an existing file there; query_only still prevents SQL data/schema writes.
93
- bun
94
- ? {
95
- readonly: process.platform !== "darwin",
96
- readwrite: process.platform === "darwin",
97
- create: false,
98
- }
99
- : { readOnly: true });
100
- database.exec("PRAGMA busy_timeout = 5000");
101
- database.exec("PRAGMA query_only = ON");
102
- if (typeof requestedId !== "string") {
103
- const columns = readRows(database, "PRAGMA table_info(finding_workflows)");
104
- const scanId = columns.some((column) => column.name === "scan_id")
105
- ? "workflow.scan_id"
106
- : "json_extract(workflow.state_json, '$.scanId')";
107
- return readRows(database, `SELECT scans.id, scans.target_path FROM scans
108
- JOIN finding_workflows AS workflow ON scans.id = ${scanId} WHERE workflow.id = ?`, requestedId.workflowId);
109
- }
110
- if (requestedId === "latest")
111
- return await latestTargets(database, currentDirectory, environment, signal);
112
- // Match uuid.UUID's accepted full-ID spellings before considering a prefix.
113
- const compact = trimBoundary(requestedId.replaceAll("urn:", "").replaceAll("uuid:", ""), "{", "}").replaceAll("-", "");
114
- if (/^[0-9a-f]{32}$/i.test(compact)) {
115
- const id = compact
116
- .toLowerCase()
117
- .replace(/^(.{8})(.{4})(.{4})(.{4})(.{12})$/, "$1-$2-$3-$4-$5");
118
- return readRows(database, "SELECT id, target_path FROM scans WHERE id = ?", id);
119
- }
120
- if (requestedId.length < 8)
121
- throw new CodexSecurityError("Scan ID prefixes must be at least eight characters.");
122
- return readRows(database, "SELECT id, target_path FROM scans WHERE substr(id, 1, ?) = ? LIMIT 2", requestedId.length, requestedId.toLowerCase());
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;
123
141
  }
124
142
  catch (error) {
125
143
  signal?.throwIfAborted();
@@ -127,9 +145,109 @@ async function readTargets(requestedId, environment, currentDirectory, signal) {
127
145
  throw error;
128
146
  throw new CodexSecurityError(`Could not read saved scan targets before Python discovery: ${errorMessage(error)}`, { cause: error });
129
147
  }
148
+ }
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);
155
+ try {
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) => {
173
+ const [row] = readRows(database, "SELECT snapshot FROM scan_lifecycles WHERE scan_id = ?", scanId);
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);
185
+ }
130
186
  finally {
131
- database?.close();
187
+ database.close();
188
+ }
189
+ }
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
196
+ JOIN finding_workflows AS workflow ON scans.id = ${scanId} WHERE workflow.id = ?`, requestedId.workflowId);
197
+ }
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
  }
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}`);
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
+ };
133
251
  }
134
252
  function readRows(database, sql, ...parameters) {
135
253
  const statement = database.prepare(sql);
@@ -142,90 +260,127 @@ function readRows(database, sql, ...parameters) {
142
260
  statement.finalize?.();
143
261
  }
144
262
  }
145
- async function latestTargets(database, directory, environment, signal) {
146
- const current = await pathKey(directory);
147
- const columns = new Set(readRows(database, "PRAGMA table_info(scans)").map((column) => column.name));
148
- // The workbench migrates after discovery; schemas before v16 have no target registry.
149
- const hasTargets = readRows(database, "PRAGMA table_info(security_targets)").length > 0;
150
- const registered = readRows(database, hasTargets
151
- ? "SELECT id, current_path AS target_path FROM security_targets"
152
- : "SELECT DISTINCT target_path AS id, target_path FROM scans");
153
- const related = new Set();
154
- for (const target of registered)
155
- if ((await pathKey(target.target_path)) === current)
156
- 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();
157
290
  let gitMatchingUnavailable = false;
158
291
  const caller = await gitMarkerRoot(directory, signal, "outermost");
159
292
  if (caller !== null) {
160
293
  // Resolve metadata with a host Git, never a Git executable from any candidate checkout.
161
- const roots = await Promise.all(registered.map((target) => gitProtectionRoots(target.target_path, signal)));
162
- const protectedRoots = [
163
- ...(await gitProtectionRoots(directory, signal)),
164
- ...registered.map((target) => target.target_path),
165
- ...roots.flat(),
166
- ];
294
+ const protectedRoots = await savedDiscoveryRoots(checkouts, [directory, ...checkouts.byTarget.keys()], signal);
167
295
  const configured = environmentEntry(environment, "CODEX_SECURITY_GIT");
168
- const inspected = configured === ""
296
+ const inspected = configured === "" ||
297
+ (!checkouts.complete && !isAbsolute(configured ?? ""))
169
298
  ? { executable: null, environment }
170
299
  : await inspectTrustedExecutable(configured ?? "git", environment, protectedRoots);
171
- // Keep subsequent workbench operations on this host Git without changing Python's PATH.
172
300
  for (const key of Object.keys(environment))
173
301
  if (key.toUpperCase() === "CODEX_SECURITY_GIT")
174
302
  delete environment[key];
175
303
  environment["CODEX_SECURITY_GIT"] = inspected.executable ?? "";
176
304
  gitMatchingUnavailable = inspected.executable === null;
177
- const git = inspected.executable === null
178
- ? null
179
- : {
305
+ if (inspected.executable !== null) {
306
+ const git = {
180
307
  executable: inspected.executable,
181
308
  environment: inspected.environment,
182
309
  };
183
- const identity = git === null
184
- ? { commonDirectory: null, origin: null }
185
- : await gitHistoryIdentity(directory, git, signal);
186
- const common = identity.commonDirectory === null
187
- ? null
188
- : await pathKey(identity.commonDirectory);
189
- const origin = repositoryOrigin(identity.origin);
190
- for (const [index, target] of registered.entries()) {
191
- signal?.throwIfAborted();
192
- if (related.has(target.id) || roots[index] === null || git === null)
193
- continue;
194
- const candidate = await gitHistoryIdentity(target.target_path, git, signal);
195
- if ((common !== null &&
196
- candidate.commonDirectory !== null &&
197
- (await pathKey(candidate.commonDirectory)) === common) ||
198
- (origin !== null && repositoryOrigin(candidate.origin) === origin))
199
- 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
+ }
200
341
  }
201
342
  }
202
- const scans = readRows(database, `SELECT scans.id, scans.target_path, scans.updated_at, scans.started_at,
203
- progress.updated_at AS progress_updated_at,
204
- ${columns.has("target_id") ? "scans.target_id" : "scans.target_path"} AS target_id
205
- FROM scans JOIN scan_progress AS progress ON progress.scan_id = scans.id
206
- WHERE scans.status = 'complete' ${columns.has("canceled_at") ? "AND scans.canceled_at IS NULL" : ""}
207
- ORDER BY scans.id`)
208
- .map((scan) => ({
209
- ...scan,
210
- updatedAt: compareTimestamps(scan.updated_at, scan.progress_updated_at) > 0
211
- ? scan.updated_at
212
- : scan.progress_updated_at,
213
- }))
214
- .sort((a, b) => compareTimestamps(b.updatedAt, a.updatedAt) ||
215
- compareTimestamps(b.started_at, a.started_at));
343
+ const selected = [];
216
344
  for (const scan of scans) {
217
345
  signal?.throwIfAborted();
218
- if (related.has(scan.target_id ?? "") ||
219
- (await pathKey(scan.target_path)) === current)
220
- 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
+ });
221
357
  }
222
- if (gitMatchingUnavailable)
358
+ if (related.size === 0 && gitMatchingUnavailable)
223
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");
224
- 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}` : ""}`;
225
381
  }
226
- async function pathKey(path) {
227
- const canonical = await realpath(path).catch(() => resolve(path));
228
- return process.platform === "win32" ? canonical.toLowerCase() : canonical;
382
+ function compareOrderKeys(left, right) {
383
+ return left < right ? -1 : left > right ? 1 : 0;
229
384
  }
230
385
  // Match the workbench history's host/path identity across HTTPS and SSH origins.
231
386
  function repositoryOrigin(remote) {