@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
@@ -28,12 +28,10 @@ class ReportProjectionError(ValueError):
28
28
  def _text(value: Any, fallback: str) -> str:
29
29
  candidate = value if isinstance(value, str) and value.strip() else fallback
30
30
  normalized = " ".join(candidate.split())
31
- if not normalized:
32
- return ""
33
31
  if re.match(r"^(?:#{1,6}\s|[-*+]\s|>\s|```|\d+\.\s|\|)", normalized):
34
32
  normalized = f"Text: {normalized}"
35
33
  return "".join(
36
- part if index % 2 else re.sub(r"([\\`*\[\]<>])", r"\\\1", part)
34
+ part if index % 2 else re.sub(r"([\\`*_\[\]<>])", r"\\\1", part)
37
35
  for index, part in enumerate(re.split(r"((?<!`)`[^`\n]+`(?!`))", normalized))
38
36
  )
39
37
 
@@ -43,12 +41,7 @@ def _strings(value: Any) -> list[str]:
43
41
  value = [value]
44
42
  if not isinstance(value, list):
45
43
  return []
46
- normalized: list[str] = []
47
- for item in value:
48
- text = _text(item, "")
49
- if text:
50
- normalized.append(text)
51
- return normalized
44
+ return [text for item in value if (text := _text(item, ""))]
52
45
 
53
46
 
54
47
  def _cell(value: Any) -> str:
@@ -96,7 +89,7 @@ def _has_deep_child_metadata(finding: dict[str, Any]) -> bool:
96
89
  )
97
90
 
98
91
 
99
- def _uses_deep_presentation(coverage: dict[str, Any], findings: list[dict[str, Any]]) -> bool:
92
+ def uses_deep_presentation(coverage: dict[str, Any], findings: list[dict[str, Any]]) -> bool:
100
93
  if coverage.get("mode") == "deep_repository":
101
94
  return True
102
95
  if coverage.get("mode") != "scoped_path":
@@ -218,8 +211,8 @@ def _hardening_portfolio_path(scan: dict[str, Any]) -> str | None:
218
211
  return portfolio_path
219
212
 
220
213
 
221
- def _bullets(items: list[str], fallback: str) -> list[str]:
222
- return [f"- {item}" for item in (items or [fallback])]
214
+ def _bullet_section(heading: str, items: list[str]) -> list[str]:
215
+ return ["", heading, *(f"- {item}" for item in items)] if items else []
223
216
 
224
217
 
225
218
  def _code_evidence_catalog(finding: dict[str, Any]) -> dict[str, dict[str, Any]]:
@@ -284,8 +277,6 @@ def merged_root_cause(value: dict[str, Any]) -> tuple[str | None, Any]:
284
277
  details.append({"summary": detail})
285
278
  elif isinstance(detail, dict):
286
279
  details.append(detail)
287
- elif detail is not None:
288
- continue
289
280
  if not details:
290
281
  return keys[0], None
291
282
 
@@ -408,16 +399,16 @@ def _code_evidence_location(item: dict[str, Any]) -> str:
408
399
  return f"{path}:{start}" if end == start else f"{path}:{start}-{end}"
409
400
 
410
401
 
411
- def _code_fence(code: str) -> str:
402
+ def _code_fence(code: str, minimum: int = 3) -> str:
412
403
  longest_run = max((len(match.group(0)) for match in re.finditer(r"`+", code)), default=0)
413
- return "`" * max(3, longest_run + 1)
404
+ return "`" * max(minimum, longest_run + 1)
414
405
 
415
406
 
416
407
  def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
417
408
  lines: list[str] = []
418
409
  for index, item in enumerate(evidence):
419
410
  label = _text(item.get("label"), f"Code evidence {index + 1}")
420
- location = _text(_code_evidence_location(item), "")
411
+ location = " ".join(_code_evidence_location(item).split())
421
412
  explanation = _text(item.get("explanation"), "")
422
413
  language = item.get("language") if isinstance(item.get("language"), str) else ""
423
414
  language = language if re.fullmatch(r"[A-Za-z0-9_+.-]*", language) else ""
@@ -425,7 +416,9 @@ def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
425
416
  fence = _code_fence(code)
426
417
  heading = f"**{label}**"
427
418
  if location:
428
- heading += f" — `{location}`"
419
+ marker = _code_fence(location, minimum=1)
420
+ padding = " " if location.startswith("`") or location.endswith("`") else ""
421
+ heading += f" — {marker}{padding}{location}{padding}{marker}"
429
422
  lines.extend(["", heading])
430
423
  if explanation:
431
424
  lines.extend(["", explanation])
@@ -433,22 +426,9 @@ def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
433
426
  return lines
434
427
 
435
428
 
436
- def _severity_mix(findings: list[dict[str, Any]]) -> str:
437
- counts = Counter(finding["severity"]["level"] for finding in findings)
438
- return (
439
- ", ".join(f"{level}: {counts[level]}" for level in SEVERITY_ORDER if counts[level])
440
- or "none"
441
- )
442
-
443
-
444
- def _confidence_mix(findings: list[dict[str, Any]]) -> str:
445
- counts = Counter(finding["confidence"]["level"] for finding in findings)
446
- return (
447
- ", ".join(
448
- f"{level}: {counts[level]}" for level in ("high", "medium", "low") if counts[level]
449
- )
450
- or "none"
451
- )
429
+ def _level_mix(findings: list[dict[str, Any]], field: str, order: dict[str, int]) -> str:
430
+ counts = Counter(finding[field]["level"] for finding in findings)
431
+ return ", ".join(f"{level}: {counts[level]}" for level in order if counts[level]) or "none"
452
432
 
453
433
 
454
434
  def _locations(finding: dict[str, Any]) -> str:
@@ -500,6 +480,71 @@ def _surface_notes(surface: dict[str, Any]) -> str:
500
480
  return _cell(f"{notes} Evidence: {evidence}")
501
481
 
502
482
 
483
+ def _remediation_section(finding: dict[str, Any]) -> list[str]:
484
+ remediation = _text(finding.get("remediation"), "No canonical remediation was recorded.")
485
+ lines = ["", "#### Remediation", "", remediation]
486
+ seen = {remediation}
487
+ originals: list[tuple[str, dict[str, Any]]] = []
488
+ pending = [("finding", finding)]
489
+ seen_findings: set[int] = set()
490
+ while pending:
491
+ source_id, original = pending.pop()
492
+ if id(original) in seen_findings:
493
+ continue
494
+ seen_findings.add(id(original))
495
+ originals.append((source_id, original))
496
+ provenance = original.get("provenance")
497
+ if not isinstance(provenance, dict):
498
+ continue
499
+ previous = provenance.get("previousFindings")
500
+ if isinstance(previous, list):
501
+ pending.extend(
502
+ (source_id, item) for item in reversed(previous) if isinstance(item, dict)
503
+ )
504
+ sources = provenance.get("sourceFindings")
505
+ if isinstance(sources, list):
506
+ pending.extend(
507
+ (_text(source.get("id"), "finding"), source["finding"])
508
+ for source in reversed(sources)
509
+ if isinstance(source, dict) and isinstance(source.get("finding"), dict)
510
+ )
511
+ for source_id, original in originals[1:]:
512
+ text = _text(original.get("remediation"), "")
513
+ if text and text not in seen:
514
+ seen.add(text)
515
+ lines.extend(["", f"Source {source_id}: {text}"])
516
+ for field, label in (
517
+ ("remediationTests", "Tests"),
518
+ ("preventiveControls", "Preventive controls"),
519
+ ):
520
+ values = list(
521
+ dict.fromkeys(
522
+ value for _, original in originals for value in _strings(original.get(field))
523
+ )
524
+ )
525
+ lines.extend(_bullet_section(f"{label}:", values))
526
+ return lines
527
+
528
+
529
+ def _finding_header(number: int, finding: dict[str, Any]) -> list[str]:
530
+ cwes = ", ".join(finding["taxonomy"]["cwe"]) or "none"
531
+ title = _text(finding["title"], "Untitled finding")
532
+ return [
533
+ f'<a id="finding-{number}"></a>',
534
+ "",
535
+ f"### [{number}] {title}",
536
+ "",
537
+ "| Field | Value |",
538
+ "| --- | --- |",
539
+ f"| Severity | {_cell(finding['severity']['level'])} |",
540
+ f"| Confidence | {_cell(finding['confidence']['level'])} |",
541
+ f"| Confidence rationale | {_cell(finding['confidence']['rationale'])} |",
542
+ f"| Category | {_cell(finding['taxonomy']['category'])} |",
543
+ f"| CWE | {_cell(cwes)} |",
544
+ f"| Affected lines | {_cell(_locations(finding))} |",
545
+ ]
546
+
547
+
503
548
  def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
504
549
  validation = finding.get("validation") if isinstance(finding.get("validation"), dict) else {}
505
550
  _, raw_root_cause = merged_root_cause(finding)
@@ -562,10 +607,6 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
562
607
  if validation_outcomes
563
608
  else f"{finding['confidence']['rationale']} Validation details were not recorded separately.",
564
609
  )
565
- validation_evidence = _strings(validation.get("evidence"))
566
- validation_assertions = _strings(validation.get("assertions"))
567
- validation_counterevidence = _strings(validation.get("counterEvidence"))
568
- validation_limitations = _strings(validation.get("limitations"))
569
610
  root_cause_summary = _text(
570
611
  raw_root_cause if isinstance(raw_root_cause, str) else root_cause.get("summary"),
571
612
  "",
@@ -578,12 +619,9 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
578
619
  dataflow.get("summary"),
579
620
  f"The canonical finding records the affected path at {_locations(finding)}, but no expanded source-to-sink narrative was recorded.",
580
621
  )
581
- reachability_summary = _text(
582
- reachability.get("summary"),
583
- _text(
584
- attack_path.get("summary"),
585
- "Reachability was not recorded beyond the canonical finding summary and affected locations.",
586
- ),
622
+ reachability_summary = _text(reachability.get("summary"), "") or _text(
623
+ attack_path.get("summary"),
624
+ "Reachability was not recorded beyond the canonical finding summary and affected locations.",
587
625
  )
588
626
  severity_rationale = _text(
589
627
  severity.get("rationale"),
@@ -593,24 +631,8 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
593
631
  severity.get("changeConditions"),
594
632
  "Additional runtime or deployment evidence could raise or lower this severity.",
595
633
  )
596
- remediation_tests = _strings(finding.get("remediationTests"))
597
- preventive_controls = _strings(finding.get("preventiveControls"))
598
- attack_steps = _strings(attack_path.get("steps"))
599
- cwes = ", ".join(finding["taxonomy"]["cwe"]) or "none"
600
- title = _text(finding["title"], "Untitled finding")
601
634
  lines = [
602
- f'<a id="finding-{number}"></a>',
603
- "",
604
- f"### [{number}] {title}",
605
- "",
606
- "| Field | Value |",
607
- "| --- | --- |",
608
- f"| Severity | {_cell(severity['level'])} |",
609
- f"| Confidence | {_cell(finding['confidence']['level'])} |",
610
- f"| Confidence rationale | {_cell(finding['confidence']['rationale'])} |",
611
- f"| Category | {_cell(finding['taxonomy']['category'])} |",
612
- f"| CWE | {_cell(cwes)} |",
613
- f"| Affected lines | {_cell(_locations(finding))} |",
635
+ *_finding_header(number, finding),
614
636
  "",
615
637
  "#### Summary",
616
638
  "",
@@ -627,29 +649,19 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
627
649
  if validation_outcomes:
628
650
  lines.extend(["", *(f"- **{label}:** {value}" for label, value in validation_outcomes)])
629
651
  lines.extend(_code_evidence_lines(validation_code_evidence))
630
- if validation_assertions:
631
- lines.extend(["", "Assertions:", *_bullets(validation_assertions, "None recorded.")])
632
- if validation_evidence:
633
- lines.extend(["", "Evidence:", *_bullets(validation_evidence, "No evidence recorded.")])
634
- if validation_counterevidence:
635
- lines.extend(
636
- [
637
- "",
638
- "Counterevidence and remaining uncertainty:",
639
- *_bullets(validation_counterevidence, "None recorded."),
640
- ]
641
- )
642
- if validation_limitations:
643
- lines.extend(["", "Limitations:", *_bullets(validation_limitations, "None recorded.")])
652
+ for label, key in (
653
+ ("Assertions", "assertions"),
654
+ ("Evidence", "evidence"),
655
+ ("Counterevidence and remaining uncertainty", "counterEvidence"),
656
+ ("Limitations", "limitations"),
657
+ ):
658
+ lines.extend(_bullet_section(f"{label}:", _strings(validation.get(key))))
644
659
  lines.extend(["", "#### Dataflow", "", dataflow_summary])
645
- if attack_steps:
646
- lines.extend(["", "Attack steps:", *_bullets(attack_steps, "None recorded.")])
660
+ lines.extend(_bullet_section("Attack steps:", _strings(attack_path.get("steps"))))
647
661
  for label, key in (("Source", "source"), ("Sink", "sink"), ("Outcome", "outcome")):
648
662
  if dataflow.get(key):
649
663
  lines.extend(["", f"- **{label}:** {_text(dataflow[key], 'not recorded')}"])
650
- transformations = _strings(dataflow.get("transformations"))
651
- if transformations:
652
- lines.extend(["", "Transformations:", *_bullets(transformations, "None recorded.")])
664
+ lines.extend(_bullet_section("Transformations:", _strings(dataflow.get("transformations"))))
653
665
  lines.extend(_code_evidence_lines(dataflow_code_evidence))
654
666
  lines.extend(["", "#### Reachability", "", reachability_summary])
655
667
  for label, key in (
@@ -669,17 +681,14 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
669
681
  ]
670
682
  )
671
683
  )
672
- if preconditions:
673
- lines.extend(["", "Preconditions:", *_bullets(preconditions, "None recorded.")])
684
+ lines.extend(_bullet_section("Preconditions:", preconditions))
674
685
  for label, key in (
675
686
  ("Assumptions", "assumptions"),
676
687
  ("Existing controls", "controls"),
677
688
  ("Blind spots", "blindspots"),
678
689
  ("Limitations", "limitations"),
679
690
  ):
680
- values = _strings(attack_path.get(key))
681
- if values:
682
- lines.extend(["", f"{label}:", *_bullets(values, "None recorded.")])
691
+ lines.extend(_bullet_section(f"{label}:", _strings(attack_path.get(key))))
683
692
  lines.extend(_code_evidence_lines(reachability_code_evidence))
684
693
  lines.extend(
685
694
  [
@@ -713,41 +722,21 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
713
722
  lines.extend(
714
723
  ["", f"{label} assessment:", *(f"- **{name}:** {value}" for name, value in details)]
715
724
  )
716
- lines.extend(
717
- [
718
- "",
719
- "#### Remediation",
720
- "",
721
- _text(finding["remediation"], "No canonical remediation was recorded."),
722
- ]
723
- )
724
- if remediation_tests:
725
- lines.extend(["", "Tests:", *_bullets(remediation_tests, "No tests recorded.")])
726
- if preventive_controls:
727
- lines.extend(["", "Preventive controls:", *_bullets(preventive_controls, "None recorded.")])
725
+ lines.extend(_remediation_section(finding))
728
726
  return lines
729
727
 
730
728
 
731
729
  def _linked_finding_section(number: int, finding: dict[str, Any], report_path: str) -> list[str]:
732
- cwes = ", ".join(finding["taxonomy"]["cwe"]) or "none"
733
- title = _text(finding["title"], "Untitled finding")
734
730
  link = f"[detailed technical write-up]({report_path})"
735
- lines = [
736
- f'<a id="finding-{number}"></a>',
737
- "",
738
- f"### [{number}] {title}",
739
- "",
740
- "| Field | Value |",
741
- "| --- | --- |",
742
- f"| Severity | {_cell(finding['severity']['level'])} |",
743
- f"| Confidence | {_cell(finding['confidence']['level'])} |",
744
- f"| Confidence rationale | {_cell(finding['confidence']['rationale'])} |",
745
- f"| Category | {_cell(finding['taxonomy']['category'])} |",
746
- f"| CWE | {_cell(cwes)} |",
747
- f"| Affected lines | {_cell(_locations(finding))} |",
748
- ]
749
- for heading in ("Summary", "Validation", "Dataflow", "Reachability", "Severity", "Remediation"):
731
+ lines = _finding_header(number, finding)
732
+ for heading in ("Summary", "Validation", "Dataflow", "Reachability", "Severity"):
750
733
  lines.extend(["", f"#### {heading}", "", f"See the {link}."])
734
+ if any(
735
+ finding.get("provenance", {}).get(field) for field in ("sourceFindings", "previousFindings")
736
+ ):
737
+ lines.extend(_remediation_section(finding))
738
+ else:
739
+ lines.extend(["", "#### Remediation", "", f"See the {link}."])
751
740
  return lines
752
741
 
753
742
 
@@ -777,7 +766,7 @@ def build_report_markdown(
777
766
  "reportable findings have duplicate writeup reportPath values: "
778
767
  + ", ".join(duplicate_writeup_paths)
779
768
  )
780
- deep_presentation = _uses_deep_presentation(coverage, findings)
769
+ deep_presentation = uses_deep_presentation(coverage, findings)
781
770
  deep_finding_groups = _deep_finding_groups(findings, writeup_paths) if deep_presentation else []
782
771
  hardening_portfolio_path = _hardening_portfolio_path(scan)
783
772
  include_paths = _strings(coverage.get("includePaths", scope.get("includePaths", [])))
@@ -812,20 +801,19 @@ def build_report_markdown(
812
801
  f"Excluded {_text(exclusion.get('pattern'), 'unspecified')}: "
813
802
  f"{_text(exclusion.get('reason'), 'reason not recorded')}"
814
803
  )
815
- if limitations:
816
- lines.extend(["", "Limitations and exclusions:", *_bullets(limitations, "None recorded.")])
804
+ lines.extend(_bullet_section("Limitations and exclusions:", limitations))
817
805
  summary_count_lines = (
818
806
  [
819
807
  f"| Reportable DSS findings | {len(deep_finding_groups)} |",
820
808
  f"| Report instances | {len(findings)} |",
821
- f"| Report severity mix | {_severity_mix(findings)} |",
822
- f"| Report confidence mix | {_confidence_mix(findings)} |",
809
+ f"| Report severity mix | {_level_mix(findings, 'severity', SEVERITY_ORDER)} |",
810
+ f"| Report confidence mix | {_level_mix(findings, 'confidence', CONFIDENCE_ORDER)} |",
823
811
  ]
824
812
  if deep_presentation
825
813
  else [
826
814
  f"| Reportable findings | {len(findings)} |",
827
- f"| Severity mix | {_severity_mix(findings)} |",
828
- f"| Confidence mix | {_confidence_mix(findings)} |",
815
+ f"| Severity mix | {_level_mix(findings, 'severity', SEVERITY_ORDER)} |",
816
+ f"| Confidence mix | {_level_mix(findings, 'confidence', CONFIDENCE_ORDER)} |",
829
817
  ]
830
818
  )
831
819
  lines.extend(
@@ -837,7 +825,6 @@ def build_report_markdown(
837
825
  "| --- | --- |",
838
826
  f"| Scan outcome | {scan.get('status', 'completed')} |",
839
827
  *summary_count_lines,
840
- f"| Coverage | {coverage['completeness']} |",
841
828
  f"| Validation mode | {_cell(scope.get('validationMode', 'not recorded'))} |",
842
829
  "",
843
830
  "Canonical artifacts: `scan-manifest.json`, `findings.json`, and `coverage.json`. This report is a deterministic projection of those files.",
@@ -856,20 +843,16 @@ def build_report_markdown(
856
843
  "No explicit canonical threat-model summary was recorded.",
857
844
  )
858
845
  )
859
- for heading, key, fallback in (
860
- ("Assets", "assets", "No assets were recorded."),
861
- ("Trust Boundaries", "trustBoundaries", "No trust boundaries were recorded."),
862
- (
863
- "Attacker Capabilities",
864
- "attackerCapabilities",
865
- "No attacker capabilities were recorded.",
866
- ),
867
- ("Security Objectives", "securityObjectives", "No security objectives were recorded."),
868
- ("Assumptions", "assumptions", "No assumptions were recorded."),
846
+ for heading, key in (
847
+ ("Assets", "assets"),
848
+ ("Trust Boundaries", "trustBoundaries"),
849
+ ("Attacker Capabilities", "attackerCapabilities"),
850
+ ("Security Objectives", "securityObjectives"),
851
+ ("Assumptions", "assumptions"),
869
852
  ):
870
853
  values = _strings(threat_model.get(key))
871
854
  if values:
872
- lines.extend(["", f"### {heading}", "", *_bullets(values, fallback)])
855
+ lines.extend(["", f"### {heading}", "", *(f"- {value}" for value in values)])
873
856
  lines.extend(["", "## Findings", ""])
874
857
  if findings:
875
858
  if deep_presentation:
@@ -923,33 +906,6 @@ def build_report_markdown(
923
906
  else:
924
907
  lines.extend(["", *_finding_section(number, finding)])
925
908
  else:
926
- deferred = coverage.get("deferred", [])
927
- no_source_review = (
928
- coverage.get("completeness") == "partial"
929
- and isinstance(deferred, list)
930
- and any(
931
- isinstance(item, dict)
932
- and item.get("reason")
933
- == "The configured discovery time limit elapsed before any source review completed."
934
- for item in deferred
935
- )
936
- )
937
- budget_exhausted = (
938
- coverage.get("completeness") == "partial"
939
- and isinstance(deferred, list)
940
- and any(
941
- isinstance(item, dict)
942
- and isinstance(item.get("reason"), str)
943
- and (
944
- item["reason"]
945
- == "Validation was deferred because the scan reached its cost limit."
946
- or item["reason"].startswith(
947
- "Validation was deferred because the scan reached its cost limit: "
948
- )
949
- )
950
- for item in deferred
951
- )
952
- )
953
909
  stopped = manifest.get("scan", {}).get("status") in {
954
910
  "failed",
955
911
  "canceled",
@@ -963,18 +919,7 @@ def build_report_markdown(
963
919
  "No findings were retained before the scan stopped. "
964
920
  "The scan did not complete. No vulnerability conclusion can be drawn."
965
921
  if stopped
966
- else (
967
- "No source review completed before the configured time limit. "
968
- "No vulnerability conclusion can be drawn."
969
- if no_source_review
970
- else (
971
- "No findings were validated before the scan reached its cost limit. "
972
- "Review the deferred candidates in Open Questions And Follow Up."
973
- if budget_exhausted
974
- else "No reportable findings survived the canonical discovery, validation, "
975
- "and reportability gates."
976
- )
977
- )
922
+ else "No findings were reported."
978
923
  ),
979
924
  ]
980
925
  )
@@ -6,6 +6,7 @@ from __future__ import annotations
6
6
  import argparse
7
7
  import sqlite3
8
8
  from pathlib import Path
9
+ from urllib.parse import quote
9
10
 
10
11
 
11
12
  def main() -> None:
@@ -15,8 +16,12 @@ def main() -> None:
15
16
  args = parser.parse_args()
16
17
  source = args.source.expanduser().resolve(strict=True)
17
18
  destination = args.destination.expanduser().absolute()
19
+ # SQLite backup cannot make progress when both connections use the same file.
20
+ if destination.exists() and destination.samefile(source):
21
+ parser.error(f"Destination must not be the same file as source: {destination}")
18
22
  destination.parent.mkdir(parents=True, exist_ok=True)
19
- with sqlite3.connect(f"{source.as_uri()}?mode=ro", uri=True) as source_connection:
23
+ source_uri = f"file:{quote(str(source), safe='')}?mode=ro"
24
+ with sqlite3.connect(source_uri, uri=True) as source_connection:
20
25
  with sqlite3.connect(destination) as destination_connection:
21
26
  source_connection.backup(destination_connection)
22
27
  destination.chmod(0o600)
@@ -4,13 +4,16 @@
4
4
  from __future__ import annotations
5
5
 
6
6
  import argparse
7
- import importlib.util
8
7
  import json
9
8
  import sys
10
9
  from collections.abc import Callable
11
10
  from pathlib import Path
12
11
  from typing import Any
13
12
 
13
+ # Keep sibling helpers importable when Python starts in isolated mode.
14
+ sys.path.insert(0, str(Path(__file__).resolve().parent))
15
+ import report_projection as report
16
+
14
17
  _STRUCTURED_SECTIONS = (
15
18
  ("Assets", "assets"),
16
19
  ("Trust Boundaries", "trustBoundaries"),
@@ -113,12 +116,6 @@ def render_threat_model(model: dict[str, Any], provenance: dict[str, Any] | None
113
116
  body = threat_model_body(model)
114
117
  if _markdown_content(model) is None:
115
118
  body = "# Threat Model\n\n" + body
116
- script = Path(__file__).resolve().with_name("report_projection.py")
117
- spec = importlib.util.spec_from_file_location("codex_security_report_projection", script)
118
- if spec is None or spec.loader is None:
119
- raise ValueError(f"could not load report projection helper: {script}")
120
- report = importlib.util.module_from_spec(spec)
121
- spec.loader.exec_module(report)
122
119
  text = report._text
123
120
  provenance = provenance or {}
124
121
  footer = ["---", "", "## Saved Model Context", ""]
@@ -4,25 +4,14 @@
4
4
  from __future__ import annotations
5
5
 
6
6
  import argparse
7
- import importlib.util
8
7
  import json
9
8
  import sys
10
9
  from pathlib import Path
11
- from types import ModuleType
12
10
  from typing import Any
13
11
 
14
-
15
- def _load_finalizer() -> ModuleType:
16
- script = Path(__file__).resolve().with_name("finalize_scan_contract.py")
17
- spec = importlib.util.spec_from_file_location("codex_security_scan_contract", script)
18
- if spec is None or spec.loader is None:
19
- raise RuntimeError(f"could not load scan contract validator: {script}")
20
- module = importlib.util.module_from_spec(spec)
21
- spec.loader.exec_module(module)
22
- return module
23
-
24
-
25
- FINALIZER = _load_finalizer()
12
+ # Keep sibling helpers importable when Python starts in isolated mode.
13
+ sys.path.insert(0, str(Path(__file__).resolve().parent))
14
+ import finalize_scan_contract as FINALIZER
26
15
 
27
16
 
28
17
  def validate_contract(scan_dir: Path) -> dict[str, Any]:
@@ -39,26 +28,7 @@ def validate_contract(scan_dir: Path) -> dict[str, Any]:
39
28
  FINALIZER.validate_against_schema(manifest, schema_dir / "scan-manifest.schema.json")
40
29
 
41
30
  scan = FINALIZER._require_dict(manifest, "scan", "manifest")
42
- findings_ref = scan["findingsRef"]
43
- coverage_ref = scan["coverageRef"]
44
- findings, findings_bytes = FINALIZER._read_scan_local_json_bytes(
45
- scan_dir,
46
- findings_ref,
47
- findings_ref,
48
- )
49
- coverage, coverage_bytes = FINALIZER._read_scan_local_json_bytes(
50
- scan_dir,
51
- coverage_ref,
52
- coverage_ref,
53
- )
54
- FINALIZER._validate_existing_seal(
55
- scan_dir,
56
- scan,
57
- artifact_contents={
58
- findings_ref: findings_bytes,
59
- coverage_ref: coverage_bytes,
60
- },
61
- )
31
+ findings, coverage, _ = FINALIZER._read_sealed_artifacts(scan_dir, scan)
62
32
  findings_for_validation = FINALIZER._legacy_sealed_findings_for_validation(findings)
63
33
  FINALIZER._validate_findings(manifest, findings_for_validation)
64
34
  FINALIZER._validate_derived_finding_identities(manifest, findings)
@@ -4,24 +4,14 @@
4
4
  from __future__ import annotations
5
5
 
6
6
  import argparse
7
- import importlib.util
8
7
  import sys
9
8
  from pathlib import Path
10
- from types import ModuleType
11
9
  from typing import Any
12
10
 
11
+ # Keep sibling helpers importable when Python starts in isolated mode.
12
+ sys.path.insert(0, str(Path(__file__).resolve().parent))
13
+ import validate_scan_contract as SCAN_CONTRACT
13
14
 
14
- def _load_scan_contract_validator() -> ModuleType:
15
- script = Path(__file__).resolve().with_name("validate_scan_contract.py")
16
- spec = importlib.util.spec_from_file_location("codex_security_scan_validator", script)
17
- if spec is None or spec.loader is None:
18
- raise RuntimeError(f"could not load scan contract validator: {script}")
19
- module = importlib.util.module_from_spec(spec)
20
- spec.loader.exec_module(module)
21
- return module
22
-
23
-
24
- SCAN_CONTRACT = _load_scan_contract_validator()
25
15
  FINALIZER = SCAN_CONTRACT.FINALIZER
26
16
  validate_contract = SCAN_CONTRACT.validate_contract
27
17