@openai/codex-security 0.2.0 → 0.4.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 (484) hide show
  1. package/README.md +437 -2692
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +4 -0
  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 +556 -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 +11 -13
  28. package/_bundled_plugin/references/finding-detail-fields.md +90 -80
  29. package/_bundled_plugin/references/sarif-adapter.md +1 -1
  30. package/_bundled_plugin/references/scan-artifacts.md +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 +43 -170
  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 +159 -567
  40. package/_bundled_plugin/schemas/patch-risk-assessment.schema.json +106 -119
  41. package/_bundled_plugin/schemas/scan-manifest.schema.json +78 -220
  42. package/_bundled_plugin/schemas/tools/candidate-attack-paths.schema.json +91 -83
  43. package/_bundled_plugin/schemas/tools/candidate-validations.schema.json +35 -64
  44. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +5 -2
  45. package/_bundled_plugin/schemas/tools/discovery-candidates.schema.json +6 -55
  46. package/_bundled_plugin/schemas/tools/review-items.schema.json +2 -38
  47. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +169 -294
  48. package/_bundled_plugin/scripts/codex_profile.mjs +239 -0
  49. package/_bundled_plugin/scripts/codex_session.mjs +53 -0
  50. package/_bundled_plugin/scripts/config_preflight.py +26 -62
  51. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  52. package/_bundled_plugin/scripts/deep_scan_workbench.py +129 -150
  53. package/_bundled_plugin/scripts/finalize_scan_contract.py +321 -237
  54. package/_bundled_plugin/scripts/finding_preview.py +39 -9
  55. package/_bundled_plugin/scripts/generate_in_scope_files.py +27 -77
  56. package/_bundled_plugin/scripts/generate_rank_input.py +115 -926
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -10
  58. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  59. package/_bundled_plugin/scripts/rank_preview.py +42 -918
  60. package/_bundled_plugin/scripts/report_projection.py +150 -183
  61. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  62. package/_bundled_plugin/scripts/threat_model_projection.py +4 -7
  63. package/_bundled_plugin/scripts/validate_scan_contract.py +4 -34
  64. package/_bundled_plugin/scripts/validate_tracking_source.py +3 -13
  65. package/_bundled_plugin/scripts/windows_scan_local_files.py +48 -3
  66. package/_bundled_plugin/scripts/workbench/handoff.py +25 -50
  67. package/_bundled_plugin/scripts/workbench/runtime_toml.py +22 -0
  68. package/_bundled_plugin/scripts/workbench/storage.py +10 -6
  69. package/_bundled_plugin/scripts/workbench_cli.py +102 -184
  70. package/_bundled_plugin/scripts/workbench_db.py +463 -464
  71. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  72. package/_bundled_plugin/scripts/workbench_finding_index.py +19 -1
  73. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  74. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  75. package/_bundled_plugin/scripts/workbench_native_indexes.py +27 -14
  76. package/_bundled_plugin/scripts/workbench_progress.py +14 -58
  77. package/_bundled_plugin/scripts/workbench_publication.py +234 -289
  78. package/_bundled_plugin/scripts/workbench_remediation.py +12 -0
  79. package/_bundled_plugin/scripts/workbench_saved_results.py +172 -49
  80. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  81. package/_bundled_plugin/scripts/workbench_scan_start.py +105 -41
  82. package/_bundled_plugin/scripts/workbench_scan_usage.py +194 -42
  83. package/_bundled_plugin/scripts/workbench_schema.py +37 -1151
  84. package/_bundled_plugin/scripts/workbench_source_excerpt.py +11 -1
  85. package/_bundled_plugin/scripts/workbench_target.py +430 -142
  86. package/_bundled_plugin/scripts/workbench_validation.py +31 -28
  87. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  88. package/_bundled_plugin/shared/workbench-migrations.json +414 -0
  89. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  90. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  91. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  92. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  93. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +3 -3
  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-scan/SKILL.md +22 -7
  98. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  99. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +15 -1
  100. package/_bundled_plugin/skills/threat-model/SKILL.md +1 -1
  101. package/_bundled_plugin/skills/track-findings/SKILL.md +48 -176
  102. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  103. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  104. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  105. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  106. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  107. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  108. package/bin/codex-security.mjs +9 -2
  109. package/dist/api.d.ts +63 -10
  110. package/dist/api.d.ts.map +1 -1
  111. package/dist/api.js +1015 -383
  112. package/dist/api.js.map +1 -1
  113. package/dist/artifact-export.d.ts +1 -1
  114. package/dist/artifact-export.d.ts.map +1 -1
  115. package/dist/artifact-export.js +28 -13
  116. package/dist/artifact-export.js.map +1 -1
  117. package/dist/auth.d.ts +2 -6
  118. package/dist/auth.d.ts.map +1 -1
  119. package/dist/auth.js +19 -9
  120. package/dist/auth.js.map +1 -1
  121. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  122. package/dist/bulk-scan-discovery.js +1 -0
  123. package/dist/bulk-scan-discovery.js.map +1 -1
  124. package/dist/classify-severity.d.ts +26 -9
  125. package/dist/classify-severity.d.ts.map +1 -1
  126. package/dist/classify-severity.js +13 -30
  127. package/dist/classify-severity.js.map +1 -1
  128. package/dist/cli-help.d.ts.map +1 -1
  129. package/dist/cli-help.js +17 -13
  130. package/dist/cli-help.js.map +1 -1
  131. package/dist/cli-signals.d.ts +8 -0
  132. package/dist/cli-signals.d.ts.map +1 -0
  133. package/dist/cli-signals.js +28 -0
  134. package/dist/cli-signals.js.map +1 -0
  135. package/dist/cli.d.ts +4 -3
  136. package/dist/cli.d.ts.map +1 -1
  137. package/dist/cli.js +1102 -905
  138. package/dist/cli.js.map +1 -1
  139. package/dist/cloud-publish.d.ts.map +1 -1
  140. package/dist/cloud-publish.js +10 -9
  141. package/dist/cloud-publish.js.map +1 -1
  142. package/dist/codeowners.d.ts +19 -0
  143. package/dist/codeowners.d.ts.map +1 -0
  144. package/dist/codeowners.js +138 -0
  145. package/dist/codeowners.js.map +1 -0
  146. package/dist/codex-sdk-environment.d.ts +1 -0
  147. package/dist/codex-sdk-environment.d.ts.map +1 -1
  148. package/dist/codex-sdk-environment.js +40 -2
  149. package/dist/codex-sdk-environment.js.map +1 -1
  150. package/dist/component-plan.d.ts +2 -5
  151. package/dist/component-plan.d.ts.map +1 -1
  152. package/dist/component-plan.js +39 -31
  153. package/dist/component-plan.js.map +1 -1
  154. package/dist/component-scan.d.ts +6 -5
  155. package/dist/component-scan.d.ts.map +1 -1
  156. package/dist/component-scan.js +25 -36
  157. package/dist/component-scan.js.map +1 -1
  158. package/dist/config.d.ts.map +1 -1
  159. package/dist/config.js +64 -74
  160. package/dist/config.js.map +1 -1
  161. package/dist/contract.d.ts +16 -3
  162. package/dist/contract.d.ts.map +1 -1
  163. package/dist/contract.js +91 -255
  164. package/dist/contract.js.map +1 -1
  165. package/dist/cost-model.d.ts +13 -6
  166. package/dist/cost-model.d.ts.map +1 -1
  167. package/dist/cost-model.js +14 -4
  168. package/dist/cost-model.js.map +1 -1
  169. package/dist/cost.d.ts +10 -2
  170. package/dist/cost.d.ts.map +1 -1
  171. package/dist/cost.js +102 -104
  172. package/dist/cost.js.map +1 -1
  173. package/dist/custom-validation-prompt.d.ts.map +1 -1
  174. package/dist/custom-validation-prompt.js +6 -5
  175. package/dist/custom-validation-prompt.js.map +1 -1
  176. package/dist/custom-validation.d.ts +1 -2
  177. package/dist/custom-validation.d.ts.map +1 -1
  178. package/dist/custom-validation.js +9 -3
  179. package/dist/custom-validation.js.map +1 -1
  180. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  181. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  182. package/dist/deduplication/checkpointed-review.js +23 -9
  183. package/dist/deduplication/checkpointed-review.js.map +1 -1
  184. package/dist/deduplication/codex-review.d.ts +8 -6
  185. package/dist/deduplication/codex-review.d.ts.map +1 -1
  186. package/dist/deduplication/codex-review.js +128 -19
  187. package/dist/deduplication/codex-review.js.map +1 -1
  188. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  189. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  190. package/dist/deduplication/deduplication-prompts.js +18 -4
  191. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  192. package/dist/deduplication/deduplication-reviewer.d.ts +27 -5
  193. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  194. package/dist/deduplication/deduplication-reviewer.js +58 -48
  195. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  196. package/dist/deduplication/deduplication.d.ts.map +1 -1
  197. package/dist/deduplication/deduplication.js +19 -51
  198. package/dist/deduplication/deduplication.js.map +1 -1
  199. package/dist/deduplication/diagnostics.d.ts +17 -0
  200. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  201. package/dist/deduplication/diagnostics.js +5 -0
  202. package/dist/deduplication/diagnostics.js.map +1 -0
  203. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  204. package/dist/deduplication/finding-schema.js +7 -1
  205. package/dist/deduplication/finding-schema.js.map +1 -1
  206. package/dist/deduplication/local.d.ts +31 -0
  207. package/dist/deduplication/local.d.ts.map +1 -0
  208. package/dist/deduplication/local.js +166 -0
  209. package/dist/deduplication/local.js.map +1 -0
  210. package/dist/deduplication/records-protocol.d.ts +3 -8
  211. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  212. package/dist/deduplication/records-protocol.js +11 -184
  213. package/dist/deduplication/records-protocol.js.map +1 -1
  214. package/dist/deduplication/records.d.ts +186 -11
  215. package/dist/deduplication/records.d.ts.map +1 -1
  216. package/dist/deduplication/records.js +10 -18
  217. package/dist/deduplication/records.js.map +1 -1
  218. package/dist/deduplication/scan.d.ts +9 -3
  219. package/dist/deduplication/scan.d.ts.map +1 -1
  220. package/dist/deduplication/scan.js +158 -39
  221. package/dist/deduplication/scan.js.map +1 -1
  222. package/dist/deep-config.d.ts +2 -1
  223. package/dist/deep-config.d.ts.map +1 -1
  224. package/dist/deep-config.js +4 -4
  225. package/dist/deep-config.js.map +1 -1
  226. package/dist/deep-progress.d.ts +17 -1
  227. package/dist/deep-progress.d.ts.map +1 -1
  228. package/dist/deep-progress.js +19 -17
  229. package/dist/deep-progress.js.map +1 -1
  230. package/dist/deep-scan.d.ts +20 -0
  231. package/dist/deep-scan.d.ts.map +1 -0
  232. package/dist/deep-scan.js +113 -0
  233. package/dist/deep-scan.js.map +1 -0
  234. package/dist/errors.d.ts +2 -0
  235. package/dist/errors.d.ts.map +1 -1
  236. package/dist/errors.js +2 -0
  237. package/dist/errors.js.map +1 -1
  238. package/dist/executable-path.d.ts +2 -0
  239. package/dist/executable-path.d.ts.map +1 -0
  240. package/dist/executable-path.js +12 -0
  241. package/dist/executable-path.js.map +1 -0
  242. package/dist/feedback.d.ts +1 -4
  243. package/dist/feedback.d.ts.map +1 -1
  244. package/dist/feedback.js +54 -22
  245. package/dist/feedback.js.map +1 -1
  246. package/dist/finding-catalogue.d.ts.map +1 -1
  247. package/dist/finding-catalogue.js +4 -8
  248. package/dist/finding-catalogue.js.map +1 -1
  249. package/dist/finding-normalization.d.ts +5 -0
  250. package/dist/finding-normalization.d.ts.map +1 -0
  251. package/dist/finding-normalization.js +120 -0
  252. package/dist/finding-normalization.js.map +1 -0
  253. package/dist/finding-retrieval.d.ts +9 -0
  254. package/dist/finding-retrieval.d.ts.map +1 -1
  255. package/dist/finding-retrieval.js.map +1 -1
  256. package/dist/finding-workflow.d.ts +13 -8
  257. package/dist/finding-workflow.d.ts.map +1 -1
  258. package/dist/finding-workflow.js +14 -6
  259. package/dist/finding-workflow.js.map +1 -1
  260. package/dist/findings-client.d.ts +2 -1
  261. package/dist/findings-client.d.ts.map +1 -1
  262. package/dist/findings-client.js +36 -9
  263. package/dist/findings-client.js.map +1 -1
  264. package/dist/findings-errors.d.ts +16 -0
  265. package/dist/findings-errors.d.ts.map +1 -0
  266. package/dist/findings-errors.js +24 -0
  267. package/dist/findings-errors.js.map +1 -0
  268. package/dist/findings-import.d.ts +1 -1
  269. package/dist/findings-import.d.ts.map +1 -1
  270. package/dist/findings-import.js +12 -30
  271. package/dist/findings-import.js.map +1 -1
  272. package/dist/github.d.ts.map +1 -1
  273. package/dist/github.js +7 -1
  274. package/dist/github.js.map +1 -1
  275. package/dist/host-protocol.d.ts +19 -0
  276. package/dist/host-protocol.d.ts.map +1 -0
  277. package/dist/host-protocol.js +270 -0
  278. package/dist/host-protocol.js.map +1 -0
  279. package/dist/hosted-scan-protocol.d.ts +4 -0
  280. package/dist/hosted-scan-protocol.d.ts.map +1 -0
  281. package/dist/hosted-scan-protocol.js +25 -0
  282. package/dist/hosted-scan-protocol.js.map +1 -0
  283. package/dist/hosted-scan.d.ts +117 -0
  284. package/dist/hosted-scan.d.ts.map +1 -0
  285. package/dist/hosted-scan.js +260 -0
  286. package/dist/hosted-scan.js.map +1 -0
  287. package/dist/import-scan.d.ts.map +1 -1
  288. package/dist/import-scan.js +48 -38
  289. package/dist/import-scan.js.map +1 -1
  290. package/dist/index.d.ts +11 -4
  291. package/dist/index.d.ts.map +1 -1
  292. package/dist/index.js +2 -1
  293. package/dist/index.js.map +1 -1
  294. package/dist/knowledge-base.d.ts +7 -1
  295. package/dist/knowledge-base.d.ts.map +1 -1
  296. package/dist/knowledge-base.js +114 -46
  297. package/dist/knowledge-base.js.map +1 -1
  298. package/dist/linear.d.ts.map +1 -1
  299. package/dist/linear.js +2 -7
  300. package/dist/linear.js.map +1 -1
  301. package/dist/mock-scan.d.ts.map +1 -1
  302. package/dist/mock-scan.js +0 -1
  303. package/dist/mock-scan.js.map +1 -1
  304. package/dist/models.d.ts +0 -2
  305. package/dist/models.d.ts.map +1 -1
  306. package/dist/models.js.map +1 -1
  307. package/dist/multiscan.d.ts +9 -3
  308. package/dist/multiscan.d.ts.map +1 -1
  309. package/dist/multiscan.js +240 -135
  310. package/dist/multiscan.js.map +1 -1
  311. package/dist/owner-evidence.d.ts +10 -2
  312. package/dist/owner-evidence.d.ts.map +1 -1
  313. package/dist/owner-evidence.js +67 -8
  314. package/dist/owner-evidence.js.map +1 -1
  315. package/dist/patch-tui.d.ts.map +1 -1
  316. package/dist/patch-tui.js +3 -2
  317. package/dist/patch-tui.js.map +1 -1
  318. package/dist/project-config.js +3 -3
  319. package/dist/project-config.js.map +1 -1
  320. package/dist/provider-profile.d.ts +21 -0
  321. package/dist/provider-profile.d.ts.map +1 -0
  322. package/dist/provider-profile.js +133 -0
  323. package/dist/provider-profile.js.map +1 -0
  324. package/dist/publication-events.d.ts +6 -8
  325. package/dist/publication-events.d.ts.map +1 -1
  326. package/dist/publication-events.js +25 -50
  327. package/dist/publication-events.js.map +1 -1
  328. package/dist/publication-store.d.ts.map +1 -1
  329. package/dist/publication-store.js +95 -109
  330. package/dist/publication-store.js.map +1 -1
  331. package/dist/publication.d.ts +1 -4
  332. package/dist/publication.d.ts.map +1 -1
  333. package/dist/publication.js +2 -13
  334. package/dist/publication.js.map +1 -1
  335. package/dist/publish.d.ts +1 -5
  336. package/dist/publish.d.ts.map +1 -1
  337. package/dist/publish.js +109 -160
  338. package/dist/publish.js.map +1 -1
  339. package/dist/request-metadata.d.ts +9 -0
  340. package/dist/request-metadata.d.ts.map +1 -0
  341. package/dist/request-metadata.js +13 -0
  342. package/dist/request-metadata.js.map +1 -0
  343. package/dist/runtime.d.ts +20 -6
  344. package/dist/runtime.d.ts.map +1 -1
  345. package/dist/runtime.js +407 -148
  346. package/dist/runtime.js.map +1 -1
  347. package/dist/saved-scan-bootstrap.d.ts +14 -0
  348. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  349. package/dist/saved-scan-bootstrap.js +261 -0
  350. package/dist/saved-scan-bootstrap.js.map +1 -0
  351. package/dist/saved-scan.d.ts +1 -1
  352. package/dist/saved-scan.d.ts.map +1 -1
  353. package/dist/saved-scan.js +6 -12
  354. package/dist/saved-scan.js.map +1 -1
  355. package/dist/scan-activity.js +11 -8
  356. package/dist/scan-activity.js.map +1 -1
  357. package/dist/scan-comparison.d.ts +28 -15
  358. package/dist/scan-comparison.d.ts.map +1 -1
  359. package/dist/scan-comparison.js +276 -281
  360. package/dist/scan-comparison.js.map +1 -1
  361. package/dist/scan-dashboard.d.ts +3 -0
  362. package/dist/scan-dashboard.d.ts.map +1 -1
  363. package/dist/scan-dashboard.js +345 -77
  364. package/dist/scan-dashboard.js.map +1 -1
  365. package/dist/scan-executor.d.ts +104 -0
  366. package/dist/scan-executor.d.ts.map +1 -0
  367. package/dist/scan-executor.js +62 -0
  368. package/dist/scan-executor.js.map +1 -0
  369. package/dist/scan-history-renderer.d.ts.map +1 -1
  370. package/dist/scan-history-renderer.js +54 -13
  371. package/dist/scan-history-renderer.js.map +1 -1
  372. package/dist/scan-inputs.d.ts +6 -0
  373. package/dist/scan-inputs.d.ts.map +1 -0
  374. package/dist/scan-inputs.js +71 -0
  375. package/dist/scan-inputs.js.map +1 -0
  376. package/dist/scan-logs.d.ts +2 -3
  377. package/dist/scan-logs.d.ts.map +1 -1
  378. package/dist/scan-logs.js +12 -6
  379. package/dist/scan-logs.js.map +1 -1
  380. package/dist/scan-sessions.d.ts +4 -0
  381. package/dist/scan-sessions.d.ts.map +1 -1
  382. package/dist/scan-sessions.js +17 -0
  383. package/dist/scan-sessions.js.map +1 -1
  384. package/dist/scan-skill-paths.d.ts +8 -0
  385. package/dist/scan-skill-paths.d.ts.map +1 -0
  386. package/dist/scan-skill-paths.js +47 -0
  387. package/dist/scan-skill-paths.js.map +1 -0
  388. package/dist/security-policy-cli.d.ts.map +1 -1
  389. package/dist/security-policy-cli.js +7 -27
  390. package/dist/security-policy-cli.js.map +1 -1
  391. package/dist/security-policy.d.ts +9 -5
  392. package/dist/security-policy.d.ts.map +1 -1
  393. package/dist/security-policy.js +33 -14
  394. package/dist/security-policy.js.map +1 -1
  395. package/dist/server/api.d.ts +0 -1
  396. package/dist/server/api.d.ts.map +1 -1
  397. package/dist/server/api.js +0 -1
  398. package/dist/server/api.js.map +1 -1
  399. package/dist/server/embeddings.d.ts +3 -1
  400. package/dist/server/embeddings.d.ts.map +1 -1
  401. package/dist/server/embeddings.js +10 -3
  402. package/dist/server/embeddings.js.map +1 -1
  403. package/dist/server/errors.d.ts +5 -2
  404. package/dist/server/errors.d.ts.map +1 -1
  405. package/dist/server/errors.js +7 -0
  406. package/dist/server/errors.js.map +1 -1
  407. package/dist/server/sqlite-store.d.ts +0 -2
  408. package/dist/server/sqlite-store.d.ts.map +1 -1
  409. package/dist/server/sqlite-store.js +54 -44
  410. package/dist/server/sqlite-store.js.map +1 -1
  411. package/dist/server/storage.d.ts +0 -2
  412. package/dist/server/storage.d.ts.map +1 -1
  413. package/dist/server/storage.js.map +1 -1
  414. package/dist/severity-store.js +19 -24
  415. package/dist/severity-store.js.map +1 -1
  416. package/dist/standalone-validation-prompt.d.ts +2 -0
  417. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  418. package/dist/standalone-validation-prompt.js +10 -0
  419. package/dist/standalone-validation-prompt.js.map +1 -0
  420. package/dist/suggest-owners.d.ts +4 -2
  421. package/dist/suggest-owners.d.ts.map +1 -1
  422. package/dist/suggest-owners.js +11 -5
  423. package/dist/suggest-owners.js.map +1 -1
  424. package/dist/targets.d.ts +11 -0
  425. package/dist/targets.d.ts.map +1 -1
  426. package/dist/targets.js +123 -72
  427. package/dist/targets.js.map +1 -1
  428. package/dist/trusted-executable.d.ts +2 -2
  429. package/dist/trusted-executable.d.ts.map +1 -1
  430. package/dist/trusted-executable.js +8 -6
  431. package/dist/trusted-executable.js.map +1 -1
  432. package/dist/value.js +7 -0
  433. package/dist/value.js.map +1 -1
  434. package/dist/version.js.map +1 -1
  435. package/dist/workbench-arguments.d.ts +3 -0
  436. package/dist/workbench-arguments.d.ts.map +1 -0
  437. package/dist/workbench-arguments.js +15 -0
  438. package/dist/workbench-arguments.js.map +1 -0
  439. package/dist/worker-progress.d.ts +44 -11
  440. package/dist/worker-progress.d.ts.map +1 -1
  441. package/dist/worker-progress.js +48 -49
  442. package/dist/worker-progress.js.map +1 -1
  443. package/docs/cli.md +1788 -0
  444. package/docs/findings-service.md +402 -0
  445. package/docs/hosted-scans.md +242 -0
  446. package/package.json +23 -22
  447. package/schemas/hosted-scan-v2.fixture.json +145 -0
  448. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  449. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  450. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  451. package/_bundled_plugin/scripts/workbench_severity.py +0 -122
  452. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  453. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  454. package/dist/server/dashboard/app.css +0 -2
  455. package/dist/server/dashboard/app.js +0 -66
  456. package/dist/server/dashboard/index.html +0 -18
  457. package/dist/server/dashboard-types.d.ts +0 -48
  458. package/dist/server/dashboard-types.d.ts.map +0 -1
  459. package/dist/server/dashboard-types.js +0 -2
  460. package/dist/server/dashboard-types.js.map +0 -1
  461. package/dist/server/dashboard.d.ts +0 -6
  462. package/dist/server/dashboard.d.ts.map +0 -1
  463. package/dist/server/dashboard.js +0 -59
  464. package/dist/server/dashboard.js.map +0 -1
  465. package/dist/server/index.d.ts +0 -2
  466. package/dist/server/index.d.ts.map +0 -1
  467. package/dist/server/index.js +0 -6
  468. package/dist/server/index.js.map +0 -1
  469. package/dist/server/routes.d.ts +0 -7
  470. package/dist/server/routes.d.ts.map +0 -1
  471. package/dist/server/routes.js +0 -98
  472. package/dist/server/routes.js.map +0 -1
  473. package/dist/server/serve.d.ts +0 -2
  474. package/dist/server/serve.d.ts.map +0 -1
  475. package/dist/server/serve.js +0 -28
  476. package/dist/server/serve.js.map +0 -1
  477. package/dist/server/server.d.ts +0 -10
  478. package/dist/server/server.d.ts.map +0 -1
  479. package/dist/server/server.js +0 -16
  480. package/dist/server/server.js.map +0 -1
  481. package/dist/server/validation.d.ts +0 -17
  482. package/dist/server/validation.d.ts.map +0 -1
  483. package/dist/server/validation.js +0 -53
  484. package/dist/server/validation.js.map +0 -1
@@ -9,17 +9,25 @@ import re
9
9
  import sqlite3
10
10
  import sys
11
11
  import uuid
12
- from pathlib import Path, PurePosixPath
12
+ from datetime import datetime
13
+ from pathlib import Path
13
14
  from typing import Any
14
15
 
15
16
  # Some plugin hosts launch Python with safe-path isolation enabled.
16
17
  sys.path.insert(0, str(Path(__file__).resolve().parent))
17
18
  import finalize_scan_contract as finalizer
18
- from workbench_scan_usage import _reject_nonstandard_json_number as reject_nonstandard_json_number
19
+ from workbench_scan_usage import TOKEN_FIELDS
20
+ from workbench_scan_usage import (
21
+ _reject_nonstandard_json_number as reject_nonstandard_json_number,
22
+ )
19
23
 
20
24
  reject_non_finite_json = finalizer._reject_non_finite_json
21
25
 
22
26
 
27
+ def timestamp_key(value: str) -> datetime:
28
+ return finalizer.parse_timestamp(value)
29
+
30
+
23
31
  def require_uuid(value: str, label: str) -> str:
24
32
  try:
25
33
  return str(uuid.UUID(value))
@@ -40,12 +48,7 @@ def sqlite_busy(error: sqlite3.OperationalError) -> bool:
40
48
  return "locked" in str(error).lower() or "busy" in str(error).lower()
41
49
 
42
50
 
43
- def path_within_scope(path: str, scope: str) -> bool:
44
- candidate = PurePosixPath(path)
45
- requested = PurePosixPath(scope)
46
- if candidate.is_absolute() or ".." in candidate.parts:
47
- return False
48
- return candidate.is_relative_to(requested)
51
+ path_within_scope = finalizer.path_within_scope
49
52
 
50
53
 
51
54
  def require_close_note(close_reason: str | None, note: str | None) -> None:
@@ -60,14 +63,7 @@ def user_context_argument(args: argparse.Namespace) -> str | None:
60
63
  return optional_text(value)
61
64
 
62
65
 
63
- SCAN_USAGE_TOKEN_KEYS = (
64
- "inputTokens",
65
- "cachedInputTokens",
66
- "cacheWriteInputTokens",
67
- "outputTokens",
68
- "reasoningOutputTokens",
69
- "totalTokens",
70
- )
66
+ SCAN_USAGE_TOKEN_KEYS = tuple(TOKEN_FIELDS.values())
71
67
 
72
68
 
73
69
  def _valid_legacy_scan_cost(cost: object) -> bool:
@@ -84,15 +80,6 @@ def _valid_legacy_scan_cost(cost: object) -> bool:
84
80
  )
85
81
 
86
82
 
87
- def _valid_scan_token_counts(usage: object) -> bool:
88
- return (
89
- isinstance(usage, dict)
90
- and set(usage) == set(SCAN_USAGE_TOKEN_KEYS)
91
- and all(type(usage.get(key)) is int and usage[key] >= 0 for key in SCAN_USAGE_TOKEN_KEYS)
92
- and usage["cachedInputTokens"] + usage["cacheWriteInputTokens"] <= usage["inputTokens"]
93
- )
94
-
95
-
96
83
  def _valid_measured_scan_usage(usage: object) -> bool:
97
84
  if not isinstance(usage, dict):
98
85
  return False
@@ -105,6 +92,19 @@ def _valid_measured_scan_usage(usage: object) -> bool:
105
92
  or thread_count < 0
106
93
  ):
107
94
  return False
95
+ completion = usage.get("completion")
96
+ if "completion" in usage and (
97
+ not isinstance(completion, dict)
98
+ or set(completion) != {"threadId", "turnId", "finalized"}
99
+ or not isinstance(completion["threadId"], str)
100
+ or not completion["threadId"]
101
+ or not isinstance(completion["turnId"], str)
102
+ or not completion["turnId"]
103
+ or type(completion["finalized"]) is not bool
104
+ or not completion["finalized"]
105
+ and coverage == "complete"
106
+ ):
107
+ return False
108
108
  warnings = usage.get("warnings", [])
109
109
  if (
110
110
  not isinstance(warnings, list)
@@ -118,7 +118,7 @@ def _valid_measured_scan_usage(usage: object) -> bool:
118
118
  return False
119
119
  if coverage == "unavailable":
120
120
  return thread_count == 0 and set(usage).issubset(
121
- {"coverage", "source", "threadCount", "warnings"}
121
+ {"coverage", "source", "threadCount", "warnings", "completion"}
122
122
  )
123
123
 
124
124
  allowed_keys = {
@@ -127,12 +127,15 @@ def _valid_measured_scan_usage(usage: object) -> bool:
127
127
  "threadCount",
128
128
  "missingThreadCount",
129
129
  "warnings",
130
+ "completion",
130
131
  *SCAN_USAGE_TOKEN_KEYS,
131
132
  }
132
133
  if thread_count == 0 or not set(usage).issubset(allowed_keys):
133
134
  return False
134
- counts = {key: usage.get(key) for key in SCAN_USAGE_TOKEN_KEYS}
135
- if not _valid_scan_token_counts(counts):
135
+ if (
136
+ not all(type(usage.get(key)) is int and usage[key] >= 0 for key in SCAN_USAGE_TOKEN_KEYS)
137
+ or usage["cachedInputTokens"] + usage["cacheWriteInputTokens"] > usage["inputTokens"]
138
+ ):
136
139
  return False
137
140
  missing = usage.get("missingThreadCount", 0)
138
141
  if type(missing) is not int or missing < 0:
@@ -0,0 +1,218 @@
1
+ [
2
+ [
3
+ "-- mirror and early-moves: relocate numbers before checking profiles.",
4
+ "WITH",
5
+ "-- Keep the common :history binding even though these moves do not inspect it.",
6
+ "input AS (SELECT :history AS history),",
7
+ "mirror_names(version, name, destination) AS (",
8
+ " VALUES",
9
+ " (29, 'freeze stopped scan source digests', 31),",
10
+ " (30, 'separate deep scan publication failures', 32)",
11
+ "),",
12
+ "mirror AS (",
13
+ " SELECT EXISTS (",
14
+ " SELECT 1 FROM schema_migrations JOIN mirror_names USING (version, name)",
15
+ " ) AS present,",
16
+ " (SELECT COUNT(*) FROM schema_migrations WHERE version BETWEEN 29 AND 32) = 2",
17
+ " AND (SELECT COUNT(*) FROM schema_migrations",
18
+ " JOIN mirror_names USING (version, name)) = 2 AS valid",
19
+ "),",
20
+ "moves(position, version, destination, name) AS (",
21
+ " VALUES",
22
+ " (0, 33, 40, 'index finding identity and comparison history'),",
23
+ " (1, 25, 26, 'persist scan completion warnings'),",
24
+ " (2, 12, 20, 'phase-specific scan progress')",
25
+ ")",
26
+ "SELECT 0 AS position, 'error' AS operation,",
27
+ " 'The Codex Security database has an unsupported mirror migration history.' AS value",
28
+ " FROM mirror WHERE present AND NOT valid",
29
+ "UNION ALL",
30
+ "SELECT 32 - version, 'sql',",
31
+ " 'UPDATE schema_migrations SET version = ' || destination ||",
32
+ " ' WHERE version = ' || version || ' AND name = ' || quote(name)",
33
+ " FROM mirror_names, mirror WHERE present",
34
+ "UNION ALL",
35
+ "-- early-moves",
36
+ "SELECT 10 + position, 'sql', 'UPDATE schema_migrations SET version = ' || destination ||",
37
+ " ' WHERE version = ' || version || ' AND name = ' || quote(name)",
38
+ " FROM moves JOIN schema_migrations USING (version, name)",
39
+ "ORDER BY position;"
40
+ ],
41
+ [
42
+ "-- profiles: preserve legacy columns before the later repairs.",
43
+ "WITH",
44
+ "history AS (",
45
+ " SELECT json_extract(value, '$.version') AS version,",
46
+ " json_extract(value, '$.name') AS name",
47
+ " FROM json_each(:history)",
48
+ "),",
49
+ "profile_columns AS (",
50
+ " SELECT 'scans' AS table_name, name FROM pragma_table_info('scans')",
51
+ " UNION ALL",
52
+ " SELECT 'workspaces', name FROM pragma_table_info('workspaces')",
53
+ "),",
54
+ "profile_state AS (",
55
+ " SELECT",
56
+ " EXISTS (",
57
+ " SELECT 1 FROM schema_migrations",
58
+ " WHERE (version = 11 AND name = 'scan execution profiles')",
59
+ " OR (version = 12 AND name IN (",
60
+ " 'scan execution profiles', 'dynamic scan execution profiles'",
61
+ " ))",
62
+ " ) AS legacy_history,",
63
+ " EXISTS (",
64
+ " SELECT 1 FROM profile_columns",
65
+ " WHERE name = 'execution_model'",
66
+ " OR (table_name = 'workspaces' AND name = 'reasoning_effort')",
67
+ " ) AS legacy_columns,",
68
+ " (SELECT COUNT(*) FROM profile_columns",
69
+ " WHERE name IN ('execution_model', 'reasoning_effort')) = 4",
70
+ " AND NOT EXISTS (",
71
+ " SELECT 1 FROM profile_columns",
72
+ " WHERE name IN ('legacy_execution_model', 'legacy_reasoning_effort')",
73
+ " ) AS valid_columns,",
74
+ " NOT EXISTS (",
75
+ " SELECT 1 FROM schema_migrations",
76
+ " WHERE (version = 11 AND name NOT IN (",
77
+ " 'deep scan orchestration state', 'scan execution profiles'",
78
+ " )) OR (version = 12 AND name NOT IN (",
79
+ " 'scan continuation threads', 'scan execution profiles',",
80
+ " 'dynamic scan execution profiles'",
81
+ " )) OR (version = 25 AND name NOT IN (",
82
+ " 'dynamic scan execution profiles',",
83
+ " (SELECT name FROM history WHERE version = 25)",
84
+ " ))",
85
+ " ) AS valid_history",
86
+ ")",
87
+ "SELECT 0 AS position, 'sql' AS operation,",
88
+ " 'UPDATE schema_migrations SET name = ' ||",
89
+ " quote((SELECT name FROM history WHERE version = 25)) || ' WHERE version = 25' AS value",
90
+ " WHERE EXISTS (SELECT 1 FROM schema_migrations",
91
+ " WHERE version = 25 AND name = 'dynamic scan execution profiles')",
92
+ "UNION ALL",
93
+ "SELECT 1, 'error',",
94
+ " 'The Codex Security database has an unsupported execution-profile migration history.'",
95
+ " FROM profile_state",
96
+ " WHERE (legacy_history OR legacy_columns) AND (",
97
+ " NOT valid_history OR (legacy_columns AND NOT valid_columns)",
98
+ " OR (legacy_history AND NOT legacy_columns)",
99
+ " )",
100
+ "UNION ALL",
101
+ "-- Keep historical values and constraints for recovery while moving",
102
+ "-- them out of the namespace used by independent scan settings.",
103
+ "SELECT 2 + CASE table_name WHEN 'workspaces' THEN 0 ELSE 2 END",
104
+ " + CASE name WHEN 'execution_model' THEN 0 ELSE 1 END,",
105
+ " 'sql', 'ALTER TABLE ' || table_name || ' RENAME COLUMN ' || name ||",
106
+ " ' TO legacy_' || name",
107
+ " FROM profile_columns, profile_state",
108
+ " WHERE (legacy_history OR legacy_columns)",
109
+ " AND name IN ('execution_model', 'reasoning_effort')",
110
+ "UNION ALL",
111
+ "SELECT 6, 'additive', 25 FROM profile_state",
112
+ " WHERE legacy_history OR legacy_columns",
113
+ "UNION ALL",
114
+ "SELECT 7, 'sql',",
115
+ " 'UPDATE scans SET model = COALESCE(model, legacy_execution_model),",
116
+ " reasoning_effort = COALESCE(reasoning_effort, legacy_reasoning_effort)'",
117
+ " FROM profile_state WHERE legacy_history OR legacy_columns",
118
+ "UNION ALL",
119
+ "SELECT 8, 'sql',",
120
+ " 'DELETE FROM schema_migrations WHERE (version = 11 AND name = ''scan execution profiles'')",
121
+ " OR (version = 12 AND name IN (''scan execution profiles'', ''dynamic scan execution profiles''))'",
122
+ " FROM profile_state WHERE legacy_history OR legacy_columns",
123
+ "UNION ALL",
124
+ "SELECT 9, 'timestamp',",
125
+ " 'INSERT INTO schema_migrations (version, name, applied_at) VALUES (25, ' ||",
126
+ " quote((SELECT name FROM history WHERE version = 25)) || ', ?)'",
127
+ " FROM profile_state WHERE (legacy_history OR legacy_columns)",
128
+ " AND NOT EXISTS (SELECT 1 FROM schema_migrations WHERE version = 25)",
129
+ "ORDER BY position;"
130
+ ],
131
+ [
132
+ "-- late-moves, shadowed, and legacy: independent remaining histories.",
133
+ "WITH",
134
+ "history AS (",
135
+ " SELECT json_extract(value, '$.version') AS version,",
136
+ " json_extract(value, '$.name') AS name,",
137
+ " json_extract(value, '$.statements') AS statements",
138
+ " FROM json_each(:history)",
139
+ "),",
140
+ "shadow_names(version, name) AS (",
141
+ " VALUES",
142
+ " (18, 'scan target summaries'),",
143
+ " (19, 'structured scan guidance context'),",
144
+ " (19, 'idempotent scan lifecycle requests'),",
145
+ " (20, 'retain superseded scan lifecycle requests'),",
146
+ " (20, 'threat model publication receipts'),",
147
+ " (21, 'scan progress projection and activity'),",
148
+ " (21, 'deep coordinator manifest receipts'),",
149
+ " (22, 'dynamic scan execution profiles')",
150
+ "),",
151
+ "shadowed AS (",
152
+ " SELECT history.* FROM schema_migrations",
153
+ " JOIN shadow_names USING (version, name) JOIN history USING (version)",
154
+ "),",
155
+ "legacy_names(version, name) AS (",
156
+ " VALUES",
157
+ " (2, 'finding management schema'),",
158
+ " (3, 'scan handoff delivery claims'),",
159
+ " (4, 'finding remediation action claims'),",
160
+ " (5, 'scan target snapshot digests')",
161
+ "),",
162
+ "legacy AS (",
163
+ " SELECT EXISTS (",
164
+ " SELECT 1 FROM schema_migrations",
165
+ " WHERE version = 2 AND name = 'finding management schema'",
166
+ " ) AS present,",
167
+ " NOT EXISTS (",
168
+ " SELECT 1 FROM schema_migrations AS recorded",
169
+ " LEFT JOIN legacy_names USING (version, name)",
170
+ " WHERE recorded.version BETWEEN 2 AND 5 AND legacy_names.name IS NULL",
171
+ " ) AS valid",
172
+ ")",
173
+ "SELECT 0 AS position, 'sql' AS operation,",
174
+ " 'UPDATE schema_migrations SET version = 21 WHERE version = 13 AND name = ''current scan preflight state''' AS value",
175
+ "WHERE EXISTS (SELECT 1 FROM schema_migrations",
176
+ " WHERE version = 13 AND name = 'current scan preflight state')",
177
+ "UNION ALL",
178
+ "-- shadowed",
179
+ "SELECT version * 10 + statements.key, 'sql',",
180
+ " CASE version WHEN 19 THEN replace(statements.value,",
181
+ " 'CREATE TABLE ', 'CREATE TABLE IF NOT EXISTS ')",
182
+ " ELSE statements.value END",
183
+ " FROM shadowed, json_each(shadowed.statements) AS statements",
184
+ " WHERE version IN (18, 19)",
185
+ "UNION ALL",
186
+ "SELECT version * 10, 'additive', version",
187
+ " FROM shadowed WHERE version IN (20, 21, 22)",
188
+ "UNION ALL",
189
+ "SELECT version * 10 + 9, 'sql',",
190
+ " 'UPDATE schema_migrations SET name = ' || quote(name) ||",
191
+ " ' WHERE version = ' || version",
192
+ " FROM shadowed",
193
+ "UNION ALL",
194
+ "-- legacy",
195
+ "SELECT 300, 'error',",
196
+ " 'The Codex Security database has an unsupported pre-release migration history.'",
197
+ " FROM legacy WHERE present AND NOT valid",
198
+ "UNION ALL",
199
+ "SELECT 301, 'sql', 'DELETE FROM schema_migrations WHERE version = 5'",
200
+ " FROM legacy WHERE present",
201
+ "UNION ALL",
202
+ "SELECT 306 - version, 'sql',",
203
+ " 'UPDATE schema_migrations SET version = ' || (version + 1) ||",
204
+ " ' WHERE version = ' || version || ' AND name = ' || quote(name)",
205
+ " FROM legacy_names, legacy WHERE present AND version < 5",
206
+ "UNION ALL",
207
+ "SELECT 305, 'additive', 2 FROM legacy WHERE present",
208
+ "UNION ALL",
209
+ "SELECT 306, 'column', 'ALTER TABLE scans ADD COLUMN target_snapshot_digest TEXT;'",
210
+ " FROM legacy WHERE present",
211
+ "UNION ALL",
212
+ "SELECT 307, 'timestamp',",
213
+ " 'INSERT INTO schema_migrations (version, name, applied_at) VALUES (2, ' ||",
214
+ " quote((SELECT name FROM history WHERE version = 2)) || ', ?)'",
215
+ " FROM legacy WHERE present",
216
+ "ORDER BY position;"
217
+ ]
218
+ ]