@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
@@ -4,6 +4,7 @@
4
4
  from __future__ import annotations
5
5
 
6
6
  import argparse
7
+ import json
7
8
  import re
8
9
  from collections import Counter
9
10
  from typing import Any
@@ -28,12 +29,10 @@ class ReportProjectionError(ValueError):
28
29
  def _text(value: Any, fallback: str) -> str:
29
30
  candidate = value if isinstance(value, str) and value.strip() else fallback
30
31
  normalized = " ".join(candidate.split())
31
- if not normalized:
32
- return ""
33
- if re.match(r"^(?:#{1,6}\s|[-*+]\s|>\s|```|\d+\.\s|\|)", normalized):
32
+ if re.match(r"^(?:#{1,6}\s|[-*+]\s|>\s|```|~~~|\d+[.)]\s|\|)", normalized):
34
33
  normalized = f"Text: {normalized}"
35
34
  return "".join(
36
- part if index % 2 else re.sub(r"([\\`*\[\]<>])", r"\\\1", part)
35
+ part if index % 2 else re.sub(r"([\\`*_\[\]<>])", r"\\\1", part)
37
36
  for index, part in enumerate(re.split(r"((?<!`)`[^`\n]+`(?!`))", normalized))
38
37
  )
39
38
 
@@ -43,12 +42,21 @@ def _strings(value: Any) -> list[str]:
43
42
  value = [value]
44
43
  if not isinstance(value, list):
45
44
  return []
46
- normalized: list[str] = []
47
- for item in value:
48
- text = _text(item, "")
49
- if text:
50
- normalized.append(text)
51
- return normalized
45
+ return [text for item in value if (text := _text(item, ""))]
46
+
47
+
48
+ def _path_label(value: str) -> str:
49
+ if "," in value or value != " ".join(value.split()) or any(ord(c) < 32 for c in value):
50
+ return json.dumps(value)
51
+ return value
52
+
53
+
54
+ def _path_text(value: str) -> str:
55
+ label = _path_label(value)
56
+ if label != value:
57
+ marker = _code_fence(label, minimum=1)
58
+ return f"{marker}{label}{marker}"
59
+ return re.sub(r"([\\`*_\[\]<>])", r"\\\1", value)
52
60
 
53
61
 
54
62
  def _cell(value: Any) -> str:
@@ -96,7 +104,7 @@ def _has_deep_child_metadata(finding: dict[str, Any]) -> bool:
96
104
  )
97
105
 
98
106
 
99
- def _uses_deep_presentation(coverage: dict[str, Any], findings: list[dict[str, Any]]) -> bool:
107
+ def uses_deep_presentation(coverage: dict[str, Any], findings: list[dict[str, Any]]) -> bool:
100
108
  if coverage.get("mode") == "deep_repository":
101
109
  return True
102
110
  if coverage.get("mode") != "scoped_path":
@@ -218,8 +226,8 @@ def _hardening_portfolio_path(scan: dict[str, Any]) -> str | None:
218
226
  return portfolio_path
219
227
 
220
228
 
221
- def _bullets(items: list[str], fallback: str) -> list[str]:
222
- return [f"- {item}" for item in (items or [fallback])]
229
+ def _bullet_section(heading: str, items: list[str]) -> list[str]:
230
+ return ["", heading, *(f"- {item}" for item in items)] if items else []
223
231
 
224
232
 
225
233
  def _code_evidence_catalog(finding: dict[str, Any]) -> dict[str, dict[str, Any]]:
@@ -284,8 +292,6 @@ def merged_root_cause(value: dict[str, Any]) -> tuple[str | None, Any]:
284
292
  details.append({"summary": detail})
285
293
  elif isinstance(detail, dict):
286
294
  details.append(detail)
287
- elif detail is not None:
288
- continue
289
295
  if not details:
290
296
  return keys[0], None
291
297
 
@@ -395,29 +401,32 @@ def _root_cause_code_evidence(
395
401
  def _code_evidence_location(item: dict[str, Any]) -> str:
396
402
  location = item.get("location")
397
403
  if isinstance(location, str):
398
- return location
404
+ return " ".join(location.split())
399
405
  if isinstance(location, dict):
400
406
  item = location
401
407
  path = item.get("path")
402
408
  start = item.get("startLine")
403
- end = item.get("endLine", start)
409
+ end = item.get("endLine")
404
410
  if not isinstance(path, str) or not path:
405
411
  return ""
406
- if not isinstance(start, int):
412
+ path = _path_label(path)
413
+ if not isinstance(start, int) or isinstance(start, bool) or start < 1:
407
414
  return path
408
- return f"{path}:{start}" if end == start else f"{path}:{start}-{end}"
415
+ if not isinstance(end, int) or isinstance(end, bool) or end <= start:
416
+ return f"{path}:{start}"
417
+ return f"{path}:{start}-{end}"
409
418
 
410
419
 
411
- def _code_fence(code: str) -> str:
420
+ def _code_fence(code: str, minimum: int = 3) -> str:
412
421
  longest_run = max((len(match.group(0)) for match in re.finditer(r"`+", code)), default=0)
413
- return "`" * max(3, longest_run + 1)
422
+ return "`" * max(minimum, longest_run + 1)
414
423
 
415
424
 
416
425
  def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
417
426
  lines: list[str] = []
418
427
  for index, item in enumerate(evidence):
419
428
  label = _text(item.get("label"), f"Code evidence {index + 1}")
420
- location = _text(_code_evidence_location(item), "")
429
+ location = _code_evidence_location(item)
421
430
  explanation = _text(item.get("explanation"), "")
422
431
  language = item.get("language") if isinstance(item.get("language"), str) else ""
423
432
  language = language if re.fullmatch(r"[A-Za-z0-9_+.-]*", language) else ""
@@ -425,7 +434,9 @@ def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
425
434
  fence = _code_fence(code)
426
435
  heading = f"**{label}**"
427
436
  if location:
428
- heading += f" — `{location}`"
437
+ marker = _code_fence(location, minimum=1)
438
+ padding = " " if location.startswith("`") or location.endswith("`") else ""
439
+ heading += f" — {marker}{padding}{location}{padding}{marker}"
429
440
  lines.extend(["", heading])
430
441
  if explanation:
431
442
  lines.extend(["", explanation])
@@ -433,22 +444,9 @@ def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
433
444
  return lines
434
445
 
435
446
 
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
- )
447
+ def _level_mix(findings: list[dict[str, Any]], field: str, order: dict[str, int]) -> str:
448
+ counts = Counter(finding[field]["level"] for finding in findings)
449
+ return ", ".join(f"{level}: {counts[level]}" for level in order if counts[level]) or "none"
452
450
 
453
451
 
454
452
  def _locations(finding: dict[str, Any]) -> str:
@@ -457,7 +455,7 @@ def _locations(finding: dict[str, Any]) -> str:
457
455
  start = location["startLine"]
458
456
  end = location.get("endLine", start)
459
457
  suffix = f":{start}" if end == start else f":{start}-{end}"
460
- rendered.append(f"{location['path']}{suffix}")
458
+ rendered.append(f"{_path_text(location['path'])}{suffix}")
461
459
  return ", ".join(rendered)
462
460
 
463
461
 
@@ -500,6 +498,71 @@ def _surface_notes(surface: dict[str, Any]) -> str:
500
498
  return _cell(f"{notes} Evidence: {evidence}")
501
499
 
502
500
 
501
+ def _remediation_section(finding: dict[str, Any]) -> list[str]:
502
+ remediation = _text(finding.get("remediation"), "No canonical remediation was recorded.")
503
+ lines = ["", "#### Remediation", "", remediation]
504
+ seen = {remediation}
505
+ originals: list[tuple[str, dict[str, Any]]] = []
506
+ pending = [("finding", finding)]
507
+ seen_findings: set[int] = set()
508
+ while pending:
509
+ source_id, original = pending.pop()
510
+ if id(original) in seen_findings:
511
+ continue
512
+ seen_findings.add(id(original))
513
+ originals.append((source_id, original))
514
+ provenance = original.get("provenance")
515
+ if not isinstance(provenance, dict):
516
+ continue
517
+ previous = provenance.get("previousFindings")
518
+ if isinstance(previous, list):
519
+ pending.extend(
520
+ (source_id, item) for item in reversed(previous) if isinstance(item, dict)
521
+ )
522
+ sources = provenance.get("sourceFindings")
523
+ if isinstance(sources, list):
524
+ pending.extend(
525
+ (_text(source.get("id"), "finding"), source["finding"])
526
+ for source in reversed(sources)
527
+ if isinstance(source, dict) and isinstance(source.get("finding"), dict)
528
+ )
529
+ for source_id, original in originals[1:]:
530
+ text = _text(original.get("remediation"), "")
531
+ if text and text not in seen:
532
+ seen.add(text)
533
+ lines.extend(["", f"Source {source_id}: {text}"])
534
+ for field, label in (
535
+ ("remediationTests", "Tests"),
536
+ ("preventiveControls", "Preventive controls"),
537
+ ):
538
+ values = list(
539
+ dict.fromkeys(
540
+ value for _, original in originals for value in _strings(original.get(field))
541
+ )
542
+ )
543
+ lines.extend(_bullet_section(f"{label}:", values))
544
+ return lines
545
+
546
+
547
+ def _finding_header(number: int, finding: dict[str, Any]) -> list[str]:
548
+ cwes = ", ".join(finding["taxonomy"]["cwe"]) or "none"
549
+ title = _text(finding["title"], "Untitled finding")
550
+ return [
551
+ f'<a id="finding-{number}"></a>',
552
+ "",
553
+ f"### [{number}] {title}",
554
+ "",
555
+ "| Field | Value |",
556
+ "| --- | --- |",
557
+ f"| Severity | {_cell(finding['severity']['level'])} |",
558
+ f"| Confidence | {_cell(finding['confidence']['level'])} |",
559
+ f"| Confidence rationale | {_cell(finding['confidence']['rationale'])} |",
560
+ f"| Category | {_cell(finding['taxonomy']['category'])} |",
561
+ f"| CWE | {_cell(cwes)} |",
562
+ "| Affected lines | " + _locations(finding).replace("|", "\\|") + " |",
563
+ ]
564
+
565
+
503
566
  def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
504
567
  validation = finding.get("validation") if isinstance(finding.get("validation"), dict) else {}
505
568
  _, raw_root_cause = merged_root_cause(finding)
@@ -562,10 +625,6 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
562
625
  if validation_outcomes
563
626
  else f"{finding['confidence']['rationale']} Validation details were not recorded separately.",
564
627
  )
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
628
  root_cause_summary = _text(
570
629
  raw_root_cause if isinstance(raw_root_cause, str) else root_cause.get("summary"),
571
630
  "",
@@ -574,16 +633,13 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
574
633
  validation_code_evidence = _section_code_evidence(finding, validation)
575
634
  dataflow_code_evidence = _section_code_evidence(finding, attack_path, *dataflow_sections)
576
635
  reachability_code_evidence = _section_code_evidence(finding, reachability)
577
- dataflow_summary = _text(
578
- dataflow.get("summary"),
579
- f"The canonical finding records the affected path at {_locations(finding)}, but no expanded source-to-sink narrative was recorded.",
636
+ dataflow_summary = _text(dataflow.get("summary"), "") or (
637
+ f"The canonical finding records the affected path at {_locations(finding)}, "
638
+ "but no expanded source-to-sink narrative was recorded."
580
639
  )
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
- ),
640
+ reachability_summary = _text(reachability.get("summary"), "") or _text(
641
+ attack_path.get("summary"),
642
+ "Reachability was not recorded beyond the canonical finding summary and affected locations.",
587
643
  )
588
644
  severity_rationale = _text(
589
645
  severity.get("rationale"),
@@ -593,24 +649,8 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
593
649
  severity.get("changeConditions"),
594
650
  "Additional runtime or deployment evidence could raise or lower this severity.",
595
651
  )
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
652
  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))} |",
653
+ *_finding_header(number, finding),
614
654
  "",
615
655
  "#### Summary",
616
656
  "",
@@ -627,29 +667,19 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
627
667
  if validation_outcomes:
628
668
  lines.extend(["", *(f"- **{label}:** {value}" for label, value in validation_outcomes)])
629
669
  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.")])
670
+ for label, key in (
671
+ ("Assertions", "assertions"),
672
+ ("Evidence", "evidence"),
673
+ ("Counterevidence and remaining uncertainty", "counterEvidence"),
674
+ ("Limitations", "limitations"),
675
+ ):
676
+ lines.extend(_bullet_section(f"{label}:", _strings(validation.get(key))))
644
677
  lines.extend(["", "#### Dataflow", "", dataflow_summary])
645
- if attack_steps:
646
- lines.extend(["", "Attack steps:", *_bullets(attack_steps, "None recorded.")])
678
+ lines.extend(_bullet_section("Attack steps:", _strings(attack_path.get("steps"))))
647
679
  for label, key in (("Source", "source"), ("Sink", "sink"), ("Outcome", "outcome")):
648
680
  if dataflow.get(key):
649
681
  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.")])
682
+ lines.extend(_bullet_section("Transformations:", _strings(dataflow.get("transformations"))))
653
683
  lines.extend(_code_evidence_lines(dataflow_code_evidence))
654
684
  lines.extend(["", "#### Reachability", "", reachability_summary])
655
685
  for label, key in (
@@ -669,17 +699,14 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
669
699
  ]
670
700
  )
671
701
  )
672
- if preconditions:
673
- lines.extend(["", "Preconditions:", *_bullets(preconditions, "None recorded.")])
702
+ lines.extend(_bullet_section("Preconditions:", preconditions))
674
703
  for label, key in (
675
704
  ("Assumptions", "assumptions"),
676
705
  ("Existing controls", "controls"),
677
706
  ("Blind spots", "blindspots"),
678
707
  ("Limitations", "limitations"),
679
708
  ):
680
- values = _strings(attack_path.get(key))
681
- if values:
682
- lines.extend(["", f"{label}:", *_bullets(values, "None recorded.")])
709
+ lines.extend(_bullet_section(f"{label}:", _strings(attack_path.get(key))))
683
710
  lines.extend(_code_evidence_lines(reachability_code_evidence))
684
711
  lines.extend(
685
712
  [
@@ -713,41 +740,21 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
713
740
  lines.extend(
714
741
  ["", f"{label} assessment:", *(f"- **{name}:** {value}" for name, value in details)]
715
742
  )
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.")])
743
+ lines.extend(_remediation_section(finding))
728
744
  return lines
729
745
 
730
746
 
731
747
  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
748
  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"):
749
+ lines = _finding_header(number, finding)
750
+ for heading in ("Summary", "Validation", "Dataflow", "Reachability", "Severity"):
750
751
  lines.extend(["", f"#### {heading}", "", f"See the {link}."])
752
+ if any(
753
+ finding.get("provenance", {}).get(field) for field in ("sourceFindings", "previousFindings")
754
+ ):
755
+ lines.extend(_remediation_section(finding))
756
+ else:
757
+ lines.extend(["", "#### Remediation", "", f"See the {link}."])
751
758
  return lines
752
759
 
753
760
 
@@ -777,11 +784,15 @@ def build_report_markdown(
777
784
  "reportable findings have duplicate writeup reportPath values: "
778
785
  + ", ".join(duplicate_writeup_paths)
779
786
  )
780
- deep_presentation = _uses_deep_presentation(coverage, findings)
787
+ deep_presentation = uses_deep_presentation(coverage, findings)
781
788
  deep_finding_groups = _deep_finding_groups(findings, writeup_paths) if deep_presentation else []
782
789
  hardening_portfolio_path = _hardening_portfolio_path(scan)
783
- include_paths = _strings(coverage.get("includePaths", scope.get("includePaths", [])))
784
- exclude_paths = _strings(coverage.get("excludePaths", scope.get("excludePaths", [])))
790
+ include_paths = [
791
+ _path_text(path) for path in coverage.get("includePaths", scope.get("includePaths", []))
792
+ ]
793
+ exclude_paths = [
794
+ _path_text(path) for path in coverage.get("excludePaths", scope.get("excludePaths", []))
795
+ ]
785
796
  limitations = _strings(scope.get("limitations"))
786
797
  explicit_exclusions = coverage.get("explicitExclusions", [])
787
798
  lines = [
@@ -812,20 +823,19 @@ def build_report_markdown(
812
823
  f"Excluded {_text(exclusion.get('pattern'), 'unspecified')}: "
813
824
  f"{_text(exclusion.get('reason'), 'reason not recorded')}"
814
825
  )
815
- if limitations:
816
- lines.extend(["", "Limitations and exclusions:", *_bullets(limitations, "None recorded.")])
826
+ lines.extend(_bullet_section("Limitations and exclusions:", limitations))
817
827
  summary_count_lines = (
818
828
  [
819
829
  f"| Reportable DSS findings | {len(deep_finding_groups)} |",
820
830
  f"| Report instances | {len(findings)} |",
821
- f"| Report severity mix | {_severity_mix(findings)} |",
822
- f"| Report confidence mix | {_confidence_mix(findings)} |",
831
+ f"| Report severity mix | {_level_mix(findings, 'severity', SEVERITY_ORDER)} |",
832
+ f"| Report confidence mix | {_level_mix(findings, 'confidence', CONFIDENCE_ORDER)} |",
823
833
  ]
824
834
  if deep_presentation
825
835
  else [
826
836
  f"| Reportable findings | {len(findings)} |",
827
- f"| Severity mix | {_severity_mix(findings)} |",
828
- f"| Confidence mix | {_confidence_mix(findings)} |",
837
+ f"| Severity mix | {_level_mix(findings, 'severity', SEVERITY_ORDER)} |",
838
+ f"| Confidence mix | {_level_mix(findings, 'confidence', CONFIDENCE_ORDER)} |",
829
839
  ]
830
840
  )
831
841
  lines.extend(
@@ -837,7 +847,6 @@ def build_report_markdown(
837
847
  "| --- | --- |",
838
848
  f"| Scan outcome | {scan.get('status', 'completed')} |",
839
849
  *summary_count_lines,
840
- f"| Coverage | {coverage['completeness']} |",
841
850
  f"| Validation mode | {_cell(scope.get('validationMode', 'not recorded'))} |",
842
851
  "",
843
852
  "Canonical artifacts: `scan-manifest.json`, `findings.json`, and `coverage.json`. This report is a deterministic projection of those files.",
@@ -856,20 +865,16 @@ def build_report_markdown(
856
865
  "No explicit canonical threat-model summary was recorded.",
857
866
  )
858
867
  )
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."),
868
+ for heading, key in (
869
+ ("Assets", "assets"),
870
+ ("Trust Boundaries", "trustBoundaries"),
871
+ ("Attacker Capabilities", "attackerCapabilities"),
872
+ ("Security Objectives", "securityObjectives"),
873
+ ("Assumptions", "assumptions"),
869
874
  ):
870
875
  values = _strings(threat_model.get(key))
871
876
  if values:
872
- lines.extend(["", f"### {heading}", "", *_bullets(values, fallback)])
877
+ lines.extend(["", f"### {heading}", "", *(f"- {value}" for value in values)])
873
878
  lines.extend(["", "## Findings", ""])
874
879
  if findings:
875
880
  if deep_presentation:
@@ -923,33 +928,6 @@ def build_report_markdown(
923
928
  else:
924
929
  lines.extend(["", *_finding_section(number, finding)])
925
930
  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
931
  stopped = manifest.get("scan", {}).get("status") in {
954
932
  "failed",
955
933
  "canceled",
@@ -963,18 +941,7 @@ def build_report_markdown(
963
941
  "No findings were retained before the scan stopped. "
964
942
  "The scan did not complete. No vulnerability conclusion can be drawn."
965
943
  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
- )
944
+ else "No findings were reported."
978
945
  ),
979
946
  ]
980
947
  )
@@ -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)