@openai/codex-security 0.2.0 → 0.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (463) hide show
  1. package/README.md +437 -2692
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
  4. package/_bundled_plugin/.mcp.json +2 -0
  5. package/_bundled_plugin/examples/completed-scan/coverage.json +0 -1
  6. package/_bundled_plugin/examples/completed-scan/report.md +28 -26
  7. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +1 -1
  8. package/_bundled_plugin/mcp/helpers.mjs +1 -0
  9. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  10. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +6 -213
  11. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  12. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  13. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-x64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +563 -0
  20. package/_bundled_plugin/mcp/server.mjs +1 -0
  21. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  22. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  23. package/_bundled_plugin/preflight/capability-profiles.toml +0 -13
  24. package/_bundled_plugin/references/artifact-storage.md +2 -2
  25. package/_bundled_plugin/references/config-preflight.md +0 -4
  26. package/_bundled_plugin/references/core-scan.md +21 -9
  27. package/_bundled_plugin/references/final-report.md +10 -12
  28. package/_bundled_plugin/references/finding-detail-fields.md +90 -80
  29. package/_bundled_plugin/references/sarif-adapter.md +1 -1
  30. package/_bundled_plugin/references/scan-artifacts.md +1 -2
  31. package/_bundled_plugin/references/scan-contract.md +9 -4
  32. package/_bundled_plugin/references/scan-prologue.md +12 -0
  33. package/_bundled_plugin/references/security-guidance.md +2 -2
  34. package/_bundled_plugin/references/standalone-validation.md +11 -0
  35. package/_bundled_plugin/references/threat-model.md +1 -1
  36. package/_bundled_plugin/schemas/coverage.schema.json +1 -47
  37. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +2 -24
  38. package/_bundled_plugin/schemas/definitions/discovery-candidate.schema.json +49 -25
  39. package/_bundled_plugin/schemas/findings.schema.json +71 -192
  40. package/_bundled_plugin/schemas/scan-manifest.schema.json +18 -45
  41. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  42. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  43. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  44. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  45. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  46. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
  47. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  48. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  49. package/_bundled_plugin/scripts/config_preflight.py +26 -62
  50. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  51. package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
  52. package/_bundled_plugin/scripts/finalize_scan_contract.py +315 -232
  53. package/_bundled_plugin/scripts/finding_preview.py +39 -9
  54. package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
  55. package/_bundled_plugin/scripts/generate_rank_input.py +99 -829
  56. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  58. package/_bundled_plugin/scripts/rank_preview.py +42 -918
  59. package/_bundled_plugin/scripts/report_projection.py +117 -172
  60. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  61. package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
  62. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  63. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  64. package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
  65. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  66. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  67. package/_bundled_plugin/scripts/workbench/storage.py +10 -6
  68. package/_bundled_plugin/scripts/workbench_cli.py +94 -179
  69. package/_bundled_plugin/scripts/workbench_db.py +427 -463
  70. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  71. package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
  72. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  73. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  74. package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
  75. package/_bundled_plugin/scripts/workbench_progress.py +14 -58
  76. package/_bundled_plugin/scripts/workbench_publication.py +33 -57
  77. package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
  78. package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
  79. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  80. package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
  81. package/_bundled_plugin/scripts/workbench_scan_usage.py +23 -34
  82. package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
  83. package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
  84. package/_bundled_plugin/scripts/workbench_target.py +430 -142
  85. package/_bundled_plugin/scripts/workbench_validation.py +16 -27
  86. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  87. package/_bundled_plugin/shared/workbench-migrations.json +397 -0
  88. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  89. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  90. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  91. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  92. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
  93. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  94. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  95. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  96. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  97. package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
  98. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  99. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  100. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +1 -1
  101. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
  102. package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
  103. package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
  104. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  105. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  106. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  107. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  108. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  109. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  110. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  111. package/bin/codex-security.mjs +9 -2
  112. package/dist/api.d.ts +60 -10
  113. package/dist/api.d.ts.map +1 -1
  114. package/dist/api.js +803 -380
  115. package/dist/api.js.map +1 -1
  116. package/dist/artifact-export.d.ts +1 -1
  117. package/dist/artifact-export.d.ts.map +1 -1
  118. package/dist/artifact-export.js +28 -13
  119. package/dist/artifact-export.js.map +1 -1
  120. package/dist/auth.d.ts +2 -6
  121. package/dist/auth.d.ts.map +1 -1
  122. package/dist/auth.js +19 -9
  123. package/dist/auth.js.map +1 -1
  124. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  125. package/dist/bulk-scan-discovery.js +1 -0
  126. package/dist/bulk-scan-discovery.js.map +1 -1
  127. package/dist/classify-severity.d.ts +26 -9
  128. package/dist/classify-severity.d.ts.map +1 -1
  129. package/dist/classify-severity.js +13 -30
  130. package/dist/classify-severity.js.map +1 -1
  131. package/dist/cli-help.d.ts.map +1 -1
  132. package/dist/cli-help.js +17 -13
  133. package/dist/cli-help.js.map +1 -1
  134. package/dist/cli-signals.d.ts +8 -0
  135. package/dist/cli-signals.d.ts.map +1 -0
  136. package/dist/cli-signals.js +28 -0
  137. package/dist/cli-signals.js.map +1 -0
  138. package/dist/cli.d.ts +4 -3
  139. package/dist/cli.d.ts.map +1 -1
  140. package/dist/cli.js +1087 -900
  141. package/dist/cli.js.map +1 -1
  142. package/dist/cloud-publish.d.ts.map +1 -1
  143. package/dist/cloud-publish.js +10 -9
  144. package/dist/cloud-publish.js.map +1 -1
  145. package/dist/codeowners.d.ts +19 -0
  146. package/dist/codeowners.d.ts.map +1 -0
  147. package/dist/codeowners.js +138 -0
  148. package/dist/codeowners.js.map +1 -0
  149. package/dist/codex-sdk-environment.d.ts +1 -0
  150. package/dist/codex-sdk-environment.d.ts.map +1 -1
  151. package/dist/codex-sdk-environment.js +40 -2
  152. package/dist/codex-sdk-environment.js.map +1 -1
  153. package/dist/component-plan.d.ts +2 -5
  154. package/dist/component-plan.d.ts.map +1 -1
  155. package/dist/component-plan.js +38 -30
  156. package/dist/component-plan.js.map +1 -1
  157. package/dist/component-scan.d.ts +6 -5
  158. package/dist/component-scan.d.ts.map +1 -1
  159. package/dist/component-scan.js +23 -35
  160. package/dist/component-scan.js.map +1 -1
  161. package/dist/config.d.ts.map +1 -1
  162. package/dist/config.js +64 -74
  163. package/dist/config.js.map +1 -1
  164. package/dist/contract.d.ts +15 -3
  165. package/dist/contract.d.ts.map +1 -1
  166. package/dist/contract.js +87 -252
  167. package/dist/contract.js.map +1 -1
  168. package/dist/cost-model.d.ts +13 -6
  169. package/dist/cost-model.d.ts.map +1 -1
  170. package/dist/cost-model.js +14 -4
  171. package/dist/cost-model.js.map +1 -1
  172. package/dist/cost.d.ts +10 -2
  173. package/dist/cost.d.ts.map +1 -1
  174. package/dist/cost.js +102 -104
  175. package/dist/cost.js.map +1 -1
  176. package/dist/custom-validation-prompt.d.ts.map +1 -1
  177. package/dist/custom-validation-prompt.js +6 -5
  178. package/dist/custom-validation-prompt.js.map +1 -1
  179. package/dist/custom-validation.d.ts +1 -2
  180. package/dist/custom-validation.d.ts.map +1 -1
  181. package/dist/custom-validation.js +9 -3
  182. package/dist/custom-validation.js.map +1 -1
  183. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  184. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  185. package/dist/deduplication/checkpointed-review.js +23 -9
  186. package/dist/deduplication/checkpointed-review.js.map +1 -1
  187. package/dist/deduplication/codex-review.d.ts +7 -1
  188. package/dist/deduplication/codex-review.d.ts.map +1 -1
  189. package/dist/deduplication/codex-review.js +126 -17
  190. package/dist/deduplication/codex-review.js.map +1 -1
  191. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  192. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  193. package/dist/deduplication/deduplication-prompts.js +18 -4
  194. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  195. package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
  196. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  197. package/dist/deduplication/deduplication-reviewer.js +57 -47
  198. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  199. package/dist/deduplication/deduplication.d.ts.map +1 -1
  200. package/dist/deduplication/deduplication.js +19 -51
  201. package/dist/deduplication/deduplication.js.map +1 -1
  202. package/dist/deduplication/diagnostics.d.ts +17 -0
  203. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  204. package/dist/deduplication/diagnostics.js +5 -0
  205. package/dist/deduplication/diagnostics.js.map +1 -0
  206. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  207. package/dist/deduplication/finding-schema.js +7 -1
  208. package/dist/deduplication/finding-schema.js.map +1 -1
  209. package/dist/deduplication/local.d.ts +31 -0
  210. package/dist/deduplication/local.d.ts.map +1 -0
  211. package/dist/deduplication/local.js +166 -0
  212. package/dist/deduplication/local.js.map +1 -0
  213. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  214. package/dist/deduplication/records-protocol.js +11 -24
  215. package/dist/deduplication/records-protocol.js.map +1 -1
  216. package/dist/deduplication/records.d.ts +186 -11
  217. package/dist/deduplication/records.d.ts.map +1 -1
  218. package/dist/deduplication/records.js +10 -18
  219. package/dist/deduplication/records.js.map +1 -1
  220. package/dist/deduplication/scan.d.ts +9 -3
  221. package/dist/deduplication/scan.d.ts.map +1 -1
  222. package/dist/deduplication/scan.js +158 -39
  223. package/dist/deduplication/scan.js.map +1 -1
  224. package/dist/deep-config.d.ts +2 -1
  225. package/dist/deep-config.d.ts.map +1 -1
  226. package/dist/deep-config.js +4 -4
  227. package/dist/deep-config.js.map +1 -1
  228. package/dist/deep-progress.d.ts +2 -0
  229. package/dist/deep-progress.d.ts.map +1 -1
  230. package/dist/deep-progress.js +13 -10
  231. package/dist/deep-progress.js.map +1 -1
  232. package/dist/deep-scan.d.ts +20 -0
  233. package/dist/deep-scan.d.ts.map +1 -0
  234. package/dist/deep-scan.js +113 -0
  235. package/dist/deep-scan.js.map +1 -0
  236. package/dist/errors.d.ts +2 -0
  237. package/dist/errors.d.ts.map +1 -1
  238. package/dist/errors.js +2 -0
  239. package/dist/errors.js.map +1 -1
  240. package/dist/feedback.d.ts.map +1 -1
  241. package/dist/feedback.js +53 -21
  242. package/dist/feedback.js.map +1 -1
  243. package/dist/finding-catalogue.d.ts.map +1 -1
  244. package/dist/finding-catalogue.js +4 -8
  245. package/dist/finding-catalogue.js.map +1 -1
  246. package/dist/finding-normalization.d.ts +5 -0
  247. package/dist/finding-normalization.d.ts.map +1 -0
  248. package/dist/finding-normalization.js +120 -0
  249. package/dist/finding-normalization.js.map +1 -0
  250. package/dist/finding-retrieval.d.ts +9 -0
  251. package/dist/finding-retrieval.d.ts.map +1 -1
  252. package/dist/finding-retrieval.js.map +1 -1
  253. package/dist/finding-workflow.d.ts +13 -8
  254. package/dist/finding-workflow.d.ts.map +1 -1
  255. package/dist/finding-workflow.js +14 -6
  256. package/dist/finding-workflow.js.map +1 -1
  257. package/dist/findings-client.d.ts +2 -1
  258. package/dist/findings-client.d.ts.map +1 -1
  259. package/dist/findings-client.js +36 -9
  260. package/dist/findings-client.js.map +1 -1
  261. package/dist/findings-errors.d.ts +16 -0
  262. package/dist/findings-errors.d.ts.map +1 -0
  263. package/dist/findings-errors.js +24 -0
  264. package/dist/findings-errors.js.map +1 -0
  265. package/dist/findings-import.d.ts +1 -1
  266. package/dist/findings-import.d.ts.map +1 -1
  267. package/dist/findings-import.js +12 -30
  268. package/dist/findings-import.js.map +1 -1
  269. package/dist/github.d.ts.map +1 -1
  270. package/dist/github.js +7 -1
  271. package/dist/github.js.map +1 -1
  272. package/dist/import-scan.d.ts.map +1 -1
  273. package/dist/import-scan.js +48 -38
  274. package/dist/import-scan.js.map +1 -1
  275. package/dist/index.d.ts +8 -4
  276. package/dist/index.d.ts.map +1 -1
  277. package/dist/index.js +1 -1
  278. package/dist/index.js.map +1 -1
  279. package/dist/knowledge-base.d.ts +7 -1
  280. package/dist/knowledge-base.d.ts.map +1 -1
  281. package/dist/knowledge-base.js +114 -46
  282. package/dist/knowledge-base.js.map +1 -1
  283. package/dist/linear.d.ts.map +1 -1
  284. package/dist/linear.js +2 -7
  285. package/dist/linear.js.map +1 -1
  286. package/dist/mock-scan.d.ts.map +1 -1
  287. package/dist/mock-scan.js +0 -1
  288. package/dist/mock-scan.js.map +1 -1
  289. package/dist/models.d.ts +0 -2
  290. package/dist/models.d.ts.map +1 -1
  291. package/dist/models.js.map +1 -1
  292. package/dist/multiscan.d.ts +9 -3
  293. package/dist/multiscan.d.ts.map +1 -1
  294. package/dist/multiscan.js +193 -126
  295. package/dist/multiscan.js.map +1 -1
  296. package/dist/owner-evidence.d.ts +10 -2
  297. package/dist/owner-evidence.d.ts.map +1 -1
  298. package/dist/owner-evidence.js +67 -8
  299. package/dist/owner-evidence.js.map +1 -1
  300. package/dist/patch-tui.d.ts.map +1 -1
  301. package/dist/patch-tui.js +3 -2
  302. package/dist/patch-tui.js.map +1 -1
  303. package/dist/project-config.js +3 -3
  304. package/dist/project-config.js.map +1 -1
  305. package/dist/provider-profile.d.ts +21 -0
  306. package/dist/provider-profile.d.ts.map +1 -0
  307. package/dist/provider-profile.js +133 -0
  308. package/dist/provider-profile.js.map +1 -0
  309. package/dist/publication-events.d.ts +6 -8
  310. package/dist/publication-events.d.ts.map +1 -1
  311. package/dist/publication-events.js +25 -50
  312. package/dist/publication-events.js.map +1 -1
  313. package/dist/publication-store.d.ts.map +1 -1
  314. package/dist/publication-store.js +40 -64
  315. package/dist/publication-store.js.map +1 -1
  316. package/dist/publication.d.ts +1 -2
  317. package/dist/publication.d.ts.map +1 -1
  318. package/dist/publication.js +2 -8
  319. package/dist/publication.js.map +1 -1
  320. package/dist/publish.d.ts +1 -5
  321. package/dist/publish.d.ts.map +1 -1
  322. package/dist/publish.js +109 -160
  323. package/dist/publish.js.map +1 -1
  324. package/dist/request-metadata.d.ts +9 -0
  325. package/dist/request-metadata.d.ts.map +1 -0
  326. package/dist/request-metadata.js +13 -0
  327. package/dist/request-metadata.js.map +1 -0
  328. package/dist/runtime.d.ts +15 -4
  329. package/dist/runtime.d.ts.map +1 -1
  330. package/dist/runtime.js +430 -138
  331. package/dist/runtime.js.map +1 -1
  332. package/dist/saved-scan-bootstrap.d.ts +14 -0
  333. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  334. package/dist/saved-scan-bootstrap.js +261 -0
  335. package/dist/saved-scan-bootstrap.js.map +1 -0
  336. package/dist/saved-scan.d.ts +1 -1
  337. package/dist/saved-scan.d.ts.map +1 -1
  338. package/dist/saved-scan.js +6 -12
  339. package/dist/saved-scan.js.map +1 -1
  340. package/dist/scan-activity.js +11 -8
  341. package/dist/scan-activity.js.map +1 -1
  342. package/dist/scan-comparison.d.ts +28 -15
  343. package/dist/scan-comparison.d.ts.map +1 -1
  344. package/dist/scan-comparison.js +276 -281
  345. package/dist/scan-comparison.js.map +1 -1
  346. package/dist/scan-dashboard.d.ts +3 -0
  347. package/dist/scan-dashboard.d.ts.map +1 -1
  348. package/dist/scan-dashboard.js +345 -77
  349. package/dist/scan-dashboard.js.map +1 -1
  350. package/dist/scan-history-renderer.d.ts.map +1 -1
  351. package/dist/scan-history-renderer.js +54 -13
  352. package/dist/scan-history-renderer.js.map +1 -1
  353. package/dist/scan-inputs.d.ts +6 -0
  354. package/dist/scan-inputs.d.ts.map +1 -0
  355. package/dist/scan-inputs.js +71 -0
  356. package/dist/scan-inputs.js.map +1 -0
  357. package/dist/scan-logs.d.ts +2 -3
  358. package/dist/scan-logs.d.ts.map +1 -1
  359. package/dist/scan-logs.js +12 -6
  360. package/dist/scan-logs.js.map +1 -1
  361. package/dist/scan-sessions.d.ts +4 -0
  362. package/dist/scan-sessions.d.ts.map +1 -1
  363. package/dist/scan-sessions.js +17 -0
  364. package/dist/scan-sessions.js.map +1 -1
  365. package/dist/scan-skill-paths.d.ts +8 -0
  366. package/dist/scan-skill-paths.d.ts.map +1 -0
  367. package/dist/scan-skill-paths.js +47 -0
  368. package/dist/scan-skill-paths.js.map +1 -0
  369. package/dist/security-policy-cli.d.ts.map +1 -1
  370. package/dist/security-policy-cli.js +7 -27
  371. package/dist/security-policy-cli.js.map +1 -1
  372. package/dist/security-policy.d.ts +9 -5
  373. package/dist/security-policy.d.ts.map +1 -1
  374. package/dist/security-policy.js +33 -14
  375. package/dist/security-policy.js.map +1 -1
  376. package/dist/server/api.d.ts +0 -1
  377. package/dist/server/api.d.ts.map +1 -1
  378. package/dist/server/api.js +0 -1
  379. package/dist/server/api.js.map +1 -1
  380. package/dist/server/embeddings.d.ts +3 -1
  381. package/dist/server/embeddings.d.ts.map +1 -1
  382. package/dist/server/embeddings.js +10 -3
  383. package/dist/server/embeddings.js.map +1 -1
  384. package/dist/server/errors.d.ts +5 -2
  385. package/dist/server/errors.d.ts.map +1 -1
  386. package/dist/server/errors.js +7 -0
  387. package/dist/server/errors.js.map +1 -1
  388. package/dist/server/sqlite-store.d.ts +0 -2
  389. package/dist/server/sqlite-store.d.ts.map +1 -1
  390. package/dist/server/sqlite-store.js +54 -44
  391. package/dist/server/sqlite-store.js.map +1 -1
  392. package/dist/server/storage.d.ts +0 -2
  393. package/dist/server/storage.d.ts.map +1 -1
  394. package/dist/server/storage.js.map +1 -1
  395. package/dist/severity-store.js +19 -24
  396. package/dist/severity-store.js.map +1 -1
  397. package/dist/standalone-validation-prompt.d.ts +2 -0
  398. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  399. package/dist/standalone-validation-prompt.js +10 -0
  400. package/dist/standalone-validation-prompt.js.map +1 -0
  401. package/dist/suggest-owners.d.ts +4 -2
  402. package/dist/suggest-owners.d.ts.map +1 -1
  403. package/dist/suggest-owners.js +11 -5
  404. package/dist/suggest-owners.js.map +1 -1
  405. package/dist/targets.d.ts +11 -0
  406. package/dist/targets.d.ts.map +1 -1
  407. package/dist/targets.js +106 -47
  408. package/dist/targets.js.map +1 -1
  409. package/dist/trusted-executable.d.ts +2 -2
  410. package/dist/trusted-executable.d.ts.map +1 -1
  411. package/dist/trusted-executable.js +8 -6
  412. package/dist/trusted-executable.js.map +1 -1
  413. package/dist/value.js +7 -0
  414. package/dist/value.js.map +1 -1
  415. package/dist/version.js.map +1 -1
  416. package/dist/workbench-arguments.d.ts +3 -0
  417. package/dist/workbench-arguments.d.ts.map +1 -0
  418. package/dist/workbench-arguments.js +15 -0
  419. package/dist/workbench-arguments.js.map +1 -0
  420. package/dist/worker-progress.d.ts +1 -0
  421. package/dist/worker-progress.d.ts.map +1 -1
  422. package/dist/worker-progress.js +27 -12
  423. package/dist/worker-progress.js.map +1 -1
  424. package/docs/cli.md +1778 -0
  425. package/docs/findings-service.md +402 -0
  426. package/package.json +18 -19
  427. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  428. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  429. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  430. package/_bundled_plugin/scripts/workbench_severity.py +0 -122
  431. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  432. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  433. package/dist/server/dashboard/app.css +0 -2
  434. package/dist/server/dashboard/app.js +0 -66
  435. package/dist/server/dashboard/index.html +0 -18
  436. package/dist/server/dashboard-types.d.ts +0 -48
  437. package/dist/server/dashboard-types.d.ts.map +0 -1
  438. package/dist/server/dashboard-types.js +0 -2
  439. package/dist/server/dashboard-types.js.map +0 -1
  440. package/dist/server/dashboard.d.ts +0 -6
  441. package/dist/server/dashboard.d.ts.map +0 -1
  442. package/dist/server/dashboard.js +0 -59
  443. package/dist/server/dashboard.js.map +0 -1
  444. package/dist/server/index.d.ts +0 -2
  445. package/dist/server/index.d.ts.map +0 -1
  446. package/dist/server/index.js +0 -6
  447. package/dist/server/index.js.map +0 -1
  448. package/dist/server/routes.d.ts +0 -7
  449. package/dist/server/routes.d.ts.map +0 -1
  450. package/dist/server/routes.js +0 -98
  451. package/dist/server/routes.js.map +0 -1
  452. package/dist/server/serve.d.ts +0 -2
  453. package/dist/server/serve.d.ts.map +0 -1
  454. package/dist/server/serve.js +0 -28
  455. package/dist/server/serve.js.map +0 -1
  456. package/dist/server/server.d.ts +0 -10
  457. package/dist/server/server.d.ts.map +0 -1
  458. package/dist/server/server.js +0 -16
  459. package/dist/server/server.js.map +0 -1
  460. package/dist/server/validation.d.ts +0 -17
  461. package/dist/server/validation.d.ts.map +0 -1
  462. package/dist/server/validation.js +0 -53
  463. package/dist/server/validation.js.map +0 -1
package/dist/multiscan.js CHANGED
@@ -1,3 +1,4 @@
1
+ import { notify } from "./value.js";
1
2
  import { execFile as execFileCallback } from "node:child_process";
2
3
  import { randomUUID } from "node:crypto";
3
4
  import { realpathSync } from "node:fs";
@@ -8,9 +9,10 @@ import { promisify } from "node:util";
8
9
  import Papa from "papaparse";
9
10
  import { readThreatModelPath } from "./artifact-export.js";
10
11
  import { OutputDirectoryNotEmptyError, errorMessage, ScanCostLimitExceededError, } from "./errors.js";
12
+ import { readKnowledgeBaseSnapshot, } from "./knowledge-base.js";
11
13
  import { resolveScanPrompts } from "./prompt-files.js";
12
14
  import { requireSecureOutputAncestry, validateOutputDir } from "./runtime.js";
13
- import { DiffTarget } from "./targets.js";
15
+ import { DiffTarget, UNSUPPORTED_GIT_ENVIRONMENT, } from "./targets.js";
14
16
  import { meetsSeverity, } from "./scan-settings.js";
15
17
  import { workflowDigest } from "./finding-workflow.js";
16
18
  import { resolveTrustedExecutable } from "./trusted-executable.js";
@@ -96,18 +98,39 @@ async function runCampaign(options, tasks, output) {
96
98
  const ledger = join(output, "results.jsonl");
97
99
  await ensureOutputDirectory(join(output, "checkouts"));
98
100
  await ensureOutputDirectory(join(output, "artifacts"));
99
- await ensureManifest(join(output, "manifest.json"), tasks, options);
101
+ const knowledgeByMode = {};
102
+ const sharedKnowledge = options.knowledgeBasePaths?.length
103
+ ? readKnowledgeBaseSnapshot(options.knowledgeBasePaths, options.signal)
104
+ : undefined;
105
+ for (const mode of new Set(tasks.map((task) => task.mode))) {
106
+ try {
107
+ const paths = options.scanOptionsByMode?.[mode]?.knowledgeBasePaths;
108
+ const snapshot = await (sharedKnowledge ??
109
+ (paths?.length
110
+ ? readKnowledgeBaseSnapshot(paths, options.signal)
111
+ : undefined));
112
+ if (snapshot !== undefined)
113
+ knowledgeByMode[mode] = { snapshot };
114
+ }
115
+ catch (error) {
116
+ options.signal?.throwIfAborted();
117
+ knowledgeByMode[mode] = { failure: { error } };
118
+ }
119
+ }
120
+ await ensureManifest(join(output, "manifest.json"), tasks, options, knowledgeByMode);
100
121
  const receipts = await readReceipts(ledger, options.recoverScan !== undefined);
101
122
  const pending = [];
102
123
  let completed = 0;
103
- let incomplete = 0;
104
124
  let policyFailed = false;
125
+ const warnings = [];
105
126
  const hasPolicy = Object.values(options.scanOptionsByMode ?? {}).some((settings) => settings.failureSeverity !== undefined);
106
127
  let untouched = 0;
107
128
  for (const task of tasks) {
108
- const receipt = receipts.get(task.id.toLowerCase());
109
- if (receipt === undefined) {
110
- if (options.recoverScan !== undefined) {
129
+ const history = receipts.get(task.id.toLowerCase());
130
+ const receipt = history?.scan;
131
+ if (receipt === undefined ||
132
+ knowledgeByMode[task.mode]?.failure !== undefined) {
133
+ if (history === undefined && options.recoverScan !== undefined) {
111
134
  const attempts = await readdir(join(output, "artifacts", task.id)).catch((error) => {
112
135
  if (error.code !== "ENOENT")
113
136
  throw error;
@@ -127,78 +150,83 @@ async function runCampaign(options, tasks, output) {
127
150
  if ((receipt.outputDir === artifactOutput ||
128
151
  receipt.outputDir === selectedArtifactOutput) &&
129
152
  (await hasArtifacts(artifactOutput))) {
130
- if (receipt.status === "completed") {
131
- policyFailed ||= receipt.policyFailed === true;
132
- completed += 1;
133
- continue;
153
+ if (receipt.status !== "failed" && receipt.warnings?.length) {
154
+ warnings.push({ repository: task.id, warnings: receipt.warnings });
155
+ for (const warning of receipt.warnings) {
156
+ notifyProgress(options, {
157
+ repository: task.id,
158
+ status: "completed",
159
+ attempt: receipt.attempt,
160
+ warning,
161
+ });
162
+ }
134
163
  }
135
- const coverage = receipt.status === "completed_with_incomplete_coverage"
136
- ? (receipt.coverage ?? "unknown")
137
- : await legacyIncompleteCoverage({
164
+ if (receipt.status === "completed" ||
165
+ (await legacyCompletedReceipt({
138
166
  ...receipt,
139
167
  outputDir: artifactOutput,
140
- });
141
- if (coverage !== undefined) {
168
+ }))) {
142
169
  policyFailed ||= receipt.policyFailed === true;
143
- incomplete += 1;
144
- notifyProgress(options, {
145
- repository: task.id,
146
- status: "completed_with_incomplete_coverage",
147
- attempt: receipt.attempt,
148
- warning: receipt.warning ??
149
- `Scan coverage is ${coverage}; results may be incomplete.`,
150
- });
170
+ completed += 1;
151
171
  continue;
152
172
  }
153
173
  }
154
174
  pending.push(task);
155
175
  }
156
- const skipped = completed + incomplete + untouched;
157
- if (pending.length === 0) {
158
- return {
159
- total: tasks.length,
160
- completed,
161
- incomplete,
162
- failed: 0,
163
- skipped,
164
- resultsPath: ledger,
165
- ...(hasPolicy ? { policyFailed } : {}),
166
- };
167
- }
168
- let next = 0;
176
+ const skipped = completed + untouched;
169
177
  let failed = 0;
178
+ const summarize = () => ({
179
+ total: tasks.length,
180
+ completed,
181
+ failed,
182
+ skipped,
183
+ resultsPath: ledger,
184
+ ...(warnings.length === 0 ? {} : { warnings }),
185
+ ...(hasPolicy ? { policyFailed } : {}),
186
+ });
187
+ if (pending.length === 0)
188
+ return summarize();
189
+ let next = 0;
170
190
  const worker = async (security) => {
171
191
  for (;;) {
172
192
  options.signal?.throwIfAborted();
173
193
  const task = pending[next++];
174
194
  if (task === undefined)
175
195
  return;
176
- let attempt = receipts.get(task.id.toLowerCase())?.attempt ?? 0;
196
+ const knowledge = knowledgeByMode[task.mode];
197
+ const history = receipts.get(task.id.toLowerCase());
198
+ let maxAttempt = history?.maxAttempt ?? 0;
199
+ let recoveryAttempt = history?.scan?.attempt ?? 0;
177
200
  const artifactRoot = join(output, "artifacts", task.id);
178
201
  if (options.recoverScan !== undefined) {
179
202
  await ensureOutputDirectory(artifactRoot);
180
203
  for (const name of await readdir(artifactRoot)) {
181
- const prior = Number(/^attempt-([1-9][0-9]*)$/u.exec(name)?.[1]);
182
- if (Number.isSafeInteger(prior))
183
- attempt = Math.max(attempt, prior);
204
+ const match = /^attempt-([1-9][0-9]*)$/u.exec(name);
205
+ if (match && Number.isSafeInteger(Number(match[1]))) {
206
+ maxAttempt = Math.max(maxAttempt, Number(match[1]));
207
+ recoveryAttempt = Math.max(recoveryAttempt, Number(match[1]));
208
+ }
184
209
  }
185
210
  }
186
211
  for (let retry = 0; retry < options.maxAttempts; retry += 1) {
187
212
  options.signal?.throwIfAborted();
213
+ let attempt = maxAttempt;
188
214
  if (options.recoverScan === undefined)
189
- attempt += 1;
215
+ attempt = ++maxAttempt;
216
+ else if (retry === 0)
217
+ attempt = recoveryAttempt;
190
218
  let scanDir = join(artifactRoot, `attempt-${attempt}`);
191
219
  let checkout;
192
220
  let protectedRoot = join(output, "checkouts", task.id);
193
221
  let attemptedResume = false;
194
222
  let failure;
195
- let warning;
223
+ const runWarnings = [];
196
224
  let attemptPolicyFailed;
197
- let coverage;
198
225
  let cost = null;
199
226
  let threatModelPath;
200
227
  let exhaustedBudget = false;
201
228
  let requiresRecovery = false;
229
+ let knowledgeBaseFailure = false;
202
230
  try {
203
231
  await ensureOutputDirectory(artifactRoot);
204
232
  let result;
@@ -220,20 +248,33 @@ async function runCampaign(options, tasks, output) {
220
248
  attempt,
221
249
  status: "started",
222
250
  });
223
- result = await options.recoverScan(scanDir, options);
251
+ if (knowledge?.failure !== undefined) {
252
+ knowledgeBaseFailure = true;
253
+ throw knowledge.failure.error;
254
+ }
255
+ result = await options.recoverScan(scanDir, {
256
+ ...options,
257
+ knowledgeBaseSnapshot: knowledge?.snapshot,
258
+ });
224
259
  attemptedResume = result !== undefined;
225
260
  }
226
261
  }
227
262
  const scanSettings = options.scanOptionsByMode?.[task.mode];
228
263
  if (result === undefined) {
229
264
  if (options.recoverScan !== undefined)
230
- attempt += 1;
265
+ attempt = ++maxAttempt;
231
266
  scanDir = join(artifactRoot, `attempt-${attempt}`);
232
267
  notifyProgress(options, {
233
268
  repository: task.id,
234
269
  attempt,
235
270
  status: "started",
236
271
  });
272
+ if (options.recoverScan === undefined)
273
+ await validateOutputDir(scanDir);
274
+ if (knowledge?.failure !== undefined) {
275
+ knowledgeBaseFailure = true;
276
+ throw knowledge.failure.error;
277
+ }
237
278
  if (options.recoverScan !== undefined) {
238
279
  const checkoutRoot = await ensureOutputDirectory(join(output, "recovery-checkouts"));
239
280
  const taskRoot = await ensureOutputDirectory(join(checkoutRoot, task.id));
@@ -243,7 +284,6 @@ async function runCampaign(options, tasks, output) {
243
284
  await mkdir(checkout, { mode: 0o700 });
244
285
  }
245
286
  else {
246
- await validateOutputDir(scanDir);
247
287
  checkout = join(output, "checkouts", task.id);
248
288
  await rm(checkout, { recursive: true, force: true });
249
289
  await mkdir(checkout, { mode: 0o700 });
@@ -264,6 +304,7 @@ async function runCampaign(options, tasks, output) {
264
304
  .join("\n\n");
265
305
  result = await security.run(checkout, {
266
306
  ...scanSettings,
307
+ knowledgeBaseSnapshot: knowledge?.snapshot,
267
308
  ...(task.scope === undefined ? {} : { target: [task.scope] }),
268
309
  ...(options.knowledgeBasePaths?.length
269
310
  ? { knowledgeBasePaths: options.knowledgeBasePaths }
@@ -280,12 +321,15 @@ async function runCampaign(options, tasks, output) {
280
321
  ...(options.maxCostUsd === undefined
281
322
  ? {}
282
323
  : { maxCostUsd: options.maxCostUsd }),
283
- onWarning: (warning) => notifyProgress(options, {
284
- repository: task.id,
285
- attempt,
286
- status: "started",
287
- warning,
288
- }),
324
+ onWarning: (warning) => {
325
+ runWarnings.push(warning);
326
+ notifyProgress(options, {
327
+ repository: task.id,
328
+ attempt,
329
+ status: "started",
330
+ warning,
331
+ });
332
+ },
289
333
  ...(options.signal === undefined
290
334
  ? {}
291
335
  : { signal: options.signal }),
@@ -297,13 +341,8 @@ async function runCampaign(options, tasks, output) {
297
341
  if (failureSeverity !== undefined) {
298
342
  attemptPolicyFailed = result.findings.findings.some((finding) => meetsSeverity(finding, failureSeverity));
299
343
  }
300
- coverage = result.coverage.completeness;
301
- if (coverage !== "complete") {
302
- if (!(await hasArtifacts(scanDir))) {
303
- throw new Error("Multiscan scan output is missing required artifacts.");
304
- }
305
- warning = `Scan coverage is ${coverage}; results may be incomplete.`;
306
- }
344
+ if (result.manifest.scan.status !== "completed")
345
+ throw new Error(`Multiscan scan ${result.manifest.scan.status}.`);
307
346
  }
308
347
  catch (error) {
309
348
  if (options.signal?.aborted === true)
@@ -322,11 +361,7 @@ async function runCampaign(options, tasks, output) {
322
361
  await rm(checkout, { recursive: true, force: true });
323
362
  }
324
363
  }
325
- const status = failure !== undefined
326
- ? "failed"
327
- : warning === undefined
328
- ? "completed"
329
- : "completed_with_incomplete_coverage";
364
+ const status = failure !== undefined ? "failed" : "completed";
330
365
  if (threatModelPath === undefined)
331
366
  threatModelPath = await readThreatModelPath(scanDir, {
332
367
  pythonPath: options.config.pythonPath,
@@ -339,13 +374,11 @@ async function runCampaign(options, tasks, output) {
339
374
  attempt,
340
375
  outputDir: scanDir,
341
376
  ...(threatModelPath === null ? {} : { threatModelPath }),
342
- ...(coverage === undefined ? {} : { coverage }),
343
377
  ...(cost === null ? {} : { cost }),
344
378
  ...(failure === undefined ? {} : { error: failure }),
345
- ...(warning === undefined ? {} : { warning }),
346
- ...(attemptPolicyFailed === undefined
347
- ? {}
348
- : { policyFailed: attemptPolicyFailed }),
379
+ ...(knowledgeBaseFailure ? { knowledgeBaseFailure: true } : {}),
380
+ ...(runWarnings.length === 0 ? {} : { warnings: runWarnings }),
381
+ policyFailed: attemptPolicyFailed,
349
382
  })}\n`);
350
383
  if (options.recoverScan !== undefined &&
351
384
  failure === undefined &&
@@ -357,14 +390,13 @@ async function runCampaign(options, tasks, output) {
357
390
  attempt,
358
391
  status,
359
392
  ...(failure === undefined ? {} : { error: failure }),
360
- ...(warning === undefined ? {} : { warning }),
361
393
  });
362
394
  if (failure === undefined) {
363
395
  policyFailed ||= attemptPolicyFailed === true;
364
- if (warning === undefined)
365
- completed += 1;
366
- else
367
- incomplete += 1;
396
+ if (runWarnings.length > 0) {
397
+ warnings.push({ repository: task.id, warnings: runWarnings });
398
+ }
399
+ completed += 1;
368
400
  break;
369
401
  }
370
402
  if (exhaustedBudget || attemptedResume || requiresRecovery) {
@@ -388,21 +420,10 @@ async function runCampaign(options, tasks, output) {
388
420
  const rejection = results.find((result) => result.status === "rejected");
389
421
  if (rejection?.status === "rejected")
390
422
  throw rejection.reason;
391
- return {
392
- total: tasks.length,
393
- completed,
394
- incomplete,
395
- failed,
396
- skipped,
397
- resultsPath: ledger,
398
- ...(hasPolicy ? { policyFailed } : {}),
399
- };
423
+ return summarize();
400
424
  }
401
425
  function notifyProgress(options, event) {
402
- try {
403
- void Promise.resolve(options.onProgress?.(event)).catch(() => { });
404
- }
405
- catch { }
426
+ notify(() => options.onProgress?.(event));
406
427
  }
407
428
  async function ensureOutputDirectory(path) {
408
429
  const metadata = await lstat(path, { bigint: true }).catch(undefinedIfMissingFile);
@@ -620,39 +641,82 @@ async function recoverLock(output, path, expectedOwner) {
620
641
  await rm(recoveryPath, { force: true });
621
642
  }
622
643
  }
623
- async function ensureManifest(path, tasks, options) {
624
- const expected = `${JSON.stringify({
625
- version: 1,
644
+ async function ensureManifest(path, tasks, options, knowledgeByMode) {
645
+ const knowledgeDigests = Object.fromEntries(Object.entries(knowledgeByMode).map(([mode, knowledge]) => [
646
+ mode,
647
+ knowledge.snapshot === undefined
648
+ ? null
649
+ : workflowDigest(knowledge.snapshot.documents),
650
+ ]));
651
+ const manifest = {
652
+ version: 2,
626
653
  tasks,
627
- ...(options.scanPrompt === undefined
628
- ? {}
629
- : { scanPrompt: options.scanPrompt }),
630
- ...(options.validationPrompt === undefined
631
- ? {}
632
- : { validationPrompt: options.validationPrompt }),
633
- ...(options.postScanPrompt === undefined
634
- ? {}
635
- : { postScanPrompt: options.postScanPrompt }),
636
- ...(options.maxCostUsd === undefined
637
- ? {}
638
- : { maxCostUsd: options.maxCostUsd }),
639
- ...(options.scanOptionsByMode === undefined
654
+ scanPrompt: options.scanPrompt,
655
+ validationPrompt: options.validationPrompt,
656
+ postScanPrompt: options.postScanPrompt,
657
+ maxCostUsd: options.maxCostUsd,
658
+ // Failed modes cannot start scans; bind their inputs only after repair.
659
+ ...(Object.keys(knowledgeDigests).length > 0
660
+ ? { knowledgeBaseDigests: knowledgeDigests }
661
+ : {}),
662
+ ...(options.scanOptionsByMode === undefined &&
663
+ Object.keys(options.config.codexOverrides ?? {}).length === 0 &&
664
+ options.config.pluginPath === undefined &&
665
+ options.config.pythonPath === undefined
640
666
  ? {}
641
667
  : {
642
668
  configurationDigest: workflowDigest({
643
669
  scanOptions: options.scanOptionsByMode,
644
670
  codex: options.config.codexOverrides,
671
+ pluginPath: options.config.pluginPath,
672
+ pythonPath: options.config.pythonPath,
645
673
  }),
646
674
  }),
647
- }, null, 2)}\n`;
675
+ };
676
+ const expected = `${JSON.stringify(manifest, null, 2)}\n`;
648
677
  try {
649
678
  await writeFile(path, expected, { flag: "wx", mode: 0o600 });
650
679
  }
651
680
  catch (error) {
652
681
  if (error.code !== "EEXIST")
653
682
  throw error;
654
- if ((await readFile(path, "utf8")) !== expected) {
683
+ const existing = await readFile(path, "utf8");
684
+ if (existing === expected)
685
+ return;
686
+ const { knowledgeBaseDigests: savedDigests = {}, ...savedInputs } = JSON.parse(existing);
687
+ const { knowledgeBaseDigests: _, ...expectedInputs } = manifest;
688
+ const mismatch = () => {
655
689
  throw new Error("Multiscan manifest does not match existing output directory.");
690
+ };
691
+ if (JSON.stringify(savedInputs) !== JSON.stringify(expectedInputs))
692
+ mismatch();
693
+ const boundDigests = { ...savedDigests };
694
+ for (const mode of Object.keys({
695
+ ...savedDigests,
696
+ ...knowledgeDigests,
697
+ })) {
698
+ const saved = savedDigests[mode];
699
+ const current = knowledgeDigests[mode];
700
+ if (saved === undefined ||
701
+ current === undefined ||
702
+ (saved !== null && current !== null && saved !== current)) {
703
+ mismatch();
704
+ }
705
+ boundDigests[mode] = saved ?? current;
706
+ }
707
+ // Preserve bound modes when their inputs are temporarily unavailable.
708
+ if (Object.keys(boundDigests).length > 0)
709
+ manifest.knowledgeBaseDigests = boundDigests;
710
+ const bound = `${JSON.stringify(manifest, null, 2)}\n`;
711
+ if (bound !== existing) {
712
+ const temporary = `${path}.${randomUUID()}.tmp`;
713
+ try {
714
+ await writeFile(temporary, bound, { flag: "wx", mode: 0o600 });
715
+ await rename(temporary, path);
716
+ }
717
+ finally {
718
+ await rm(temporary, { force: true });
719
+ }
656
720
  }
657
721
  }
658
722
  }
@@ -677,10 +741,21 @@ async function readReceipts(path, preserveInterrupted = false) {
677
741
  }
678
742
  await truncate(path, Buffer.byteLength(contents) - Buffer.byteLength(partial));
679
743
  }
680
- return new Map(lines.filter(Boolean).map((line) => {
681
- const receipt = JSON.parse(line);
682
- return [receipt.id.toLowerCase(), receipt];
683
- }));
744
+ const receipts = new Map();
745
+ for (const line of lines.filter(Boolean)) {
746
+ const saved = JSON.parse(line);
747
+ if (saved.status === "completed_with_incomplete_coverage")
748
+ saved.status = "completed";
749
+ const receipt = saved;
750
+ const id = receipt.id.toLowerCase();
751
+ const previous = receipts.get(id);
752
+ receipts.set(id, {
753
+ maxAttempt: Math.max(previous?.maxAttempt ?? 0, receipt.attempt),
754
+ // Extraction failures never start or modify a scan; keep its last receipt.
755
+ scan: receipt.knowledgeBaseFailure ? previous?.scan : receipt,
756
+ });
757
+ }
758
+ return receipts;
684
759
  }
685
760
  async function hasArtifacts(path) {
686
761
  try {
@@ -696,20 +771,17 @@ async function hasArtifacts(path) {
696
771
  return false;
697
772
  }
698
773
  }
699
- async function legacyIncompleteCoverage(receipt) {
774
+ async function legacyCompletedReceipt(receipt) {
700
775
  if (receipt.status !== "failed" ||
701
776
  receipt.error !== "Multiscan repository coverage is incomplete.") {
702
- return undefined;
777
+ return false;
703
778
  }
704
779
  try {
705
- const coverage = JSON.parse(await readFile(join(receipt.outputDir, "coverage.json"), "utf8"));
706
- return coverage.completeness === "partial" ||
707
- coverage.completeness === "unknown"
708
- ? coverage.completeness
709
- : undefined;
780
+ const manifest = JSON.parse(await readFile(join(receipt.outputDir, "scan-manifest.json"), "utf8"));
781
+ return manifest.scan?.status === "completed";
710
782
  }
711
783
  catch {
712
- return undefined;
784
+ return false;
713
785
  }
714
786
  }
715
787
  function parseInventory(source, directory, defaultMode) {
@@ -765,7 +837,7 @@ function parseInventory(source, directory, defaultMode) {
765
837
  id,
766
838
  repository: normalizeRepository(get("repository"), directory),
767
839
  revision,
768
- mode,
840
+ mode: mode,
769
841
  ...(scope ? { scope } : {}),
770
842
  ...(prompt ? { prompt } : {}),
771
843
  };
@@ -808,19 +880,14 @@ function normalizeRepository(repository, directory) {
808
880
  }
809
881
  async function checkoutRevision(task, path, signal, githubHost) {
810
882
  const environment = { ...process.env };
811
- const repositoryVariables = new Set([
812
- "GIT_DIR",
813
- "GIT_WORK_TREE",
814
- "GIT_INDEX_FILE",
815
- "GIT_OBJECT_DIRECTORY",
816
- "GIT_ALTERNATE_OBJECT_DIRECTORIES",
817
- ]);
818
883
  for (const name of Object.keys(environment)) {
819
- if (repositoryVariables.has(name.toUpperCase()))
884
+ if (UNSUPPORTED_GIT_ENVIRONMENT.has(name.toUpperCase()))
820
885
  delete environment[name];
821
886
  }
822
887
  environment["GIT_TERMINAL_PROMPT"] = "0";
823
888
  environment["GIT_LFS_SKIP_SMUDGE"] = "1";
889
+ environment["GIT_DEFAULT_HASH"] =
890
+ task.revision.length === 64 ? "sha256" : "sha1";
824
891
  const command = await resolveTrustedExecutable("git", environment, resolve(process.cwd()));
825
892
  if (command === null) {
826
893
  throw new Error("Git is not available on a trusted PATH.");