@openai/codex-security 0.1.31 → 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 (514) hide show
  1. package/README.md +442 -2434
  2. package/_bundled_plugin/.app.json +5 -1
  3. package/_bundled_plugin/.codex-plugin/plugin.json +9 -5
  4. package/_bundled_plugin/.mcp.json +3 -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 +7 -214
  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 +5 -5
  25. package/_bundled_plugin/references/config-preflight.md +1 -5
  26. package/_bundled_plugin/references/core-scan.md +34 -10
  27. package/_bundled_plugin/references/final-report.md +13 -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 +3 -4
  31. package/_bundled_plugin/references/scan-contract.md +11 -6
  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 +2 -2
  36. package/_bundled_plugin/schemas/coverage.schema.json +23 -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 +83 -95
  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 +245 -356
  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 +29 -69
  50. package/_bundled_plugin/scripts/deep_scan_config.py +9 -11
  51. package/_bundled_plugin/scripts/deep_scan_workbench.py +208 -363
  52. package/_bundled_plugin/scripts/filesystem_identity.py +1 -5
  53. package/_bundled_plugin/scripts/finalize_scan_contract.py +733 -375
  54. package/_bundled_plugin/scripts/finding_preview.py +81 -91
  55. package/_bundled_plugin/scripts/generate_in_scope_files.py +48 -102
  56. package/_bundled_plugin/scripts/generate_rank_input.py +117 -888
  57. package/_bundled_plugin/scripts/launch_codex_security_mcp +35 -6
  58. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +5 -5
  59. package/_bundled_plugin/scripts/rank_preview.py +43 -902
  60. package/_bundled_plugin/scripts/report_projection.py +143 -219
  61. package/_bundled_plugin/scripts/snapshot_sqlite.py +6 -1
  62. package/_bundled_plugin/scripts/threat_model_projection.py +161 -0
  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 +59 -9
  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 +21 -6
  69. package/_bundled_plugin/scripts/workbench_cli.py +99 -190
  70. package/_bundled_plugin/scripts/workbench_constants.py +6 -14
  71. package/_bundled_plugin/scripts/workbench_db.py +524 -672
  72. package/_bundled_plugin/scripts/workbench_feedback.py +6 -3
  73. package/_bundled_plugin/scripts/workbench_finding_index.py +20 -7
  74. package/_bundled_plugin/scripts/workbench_finding_workflows.py +18 -4
  75. package/_bundled_plugin/scripts/workbench_local_dedupe.py +136 -0
  76. package/_bundled_plugin/scripts/workbench_native_indexes.py +28 -18
  77. package/_bundled_plugin/scripts/workbench_progress.py +26 -92
  78. package/_bundled_plugin/scripts/workbench_publication.py +77 -116
  79. package/_bundled_plugin/scripts/workbench_remediation.py +14 -20
  80. package/_bundled_plugin/scripts/workbench_saved_results.py +1402 -263
  81. package/_bundled_plugin/scripts/workbench_scan_history.py +57 -57
  82. package/_bundled_plugin/scripts/workbench_scan_start.py +109 -52
  83. package/_bundled_plugin/scripts/workbench_scan_usage.py +30 -49
  84. package/_bundled_plugin/scripts/workbench_schema.py +71 -1370
  85. package/_bundled_plugin/scripts/workbench_source_excerpt.py +16 -7
  86. package/_bundled_plugin/scripts/workbench_target.py +526 -150
  87. package/_bundled_plugin/scripts/workbench_target_state.py +1 -5
  88. package/_bundled_plugin/scripts/workbench_validation.py +19 -44
  89. package/_bundled_plugin/shared/workbench-history-repairs.json +218 -0
  90. package/_bundled_plugin/shared/workbench-migrations.json +397 -0
  91. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +15 -4
  92. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +1 -0
  93. package/_bundled_plugin/skills/cloud-findings/SKILL.md +54 -0
  94. package/_bundled_plugin/skills/cloud-findings/agents/openai.yaml +4 -0
  95. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +6 -6
  96. package/_bundled_plugin/skills/deep-security-scan/agents/openai.yaml +1 -1
  97. package/_bundled_plugin/skills/finding-discovery/SKILL.md +3 -3
  98. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +50 -20
  99. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +8 -14
  100. package/_bundled_plugin/skills/security-diff-scan/agents/openai.yaml +1 -1
  101. package/_bundled_plugin/skills/security-scan/SKILL.md +22 -7
  102. package/_bundled_plugin/skills/security-scan/agents/openai.yaml +1 -1
  103. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +2 -2
  104. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +13 -1
  105. package/_bundled_plugin/skills/threat-model/SKILL.md +2 -2
  106. package/_bundled_plugin/skills/track-findings/SKILL.md +46 -178
  107. package/_bundled_plugin/skills/track-findings/agents/openai.yaml +1 -1
  108. package/_bundled_plugin/skills/track-findings/references/github-security-advisories.md +16 -24
  109. package/_bundled_plugin/skills/track-findings/references/jira.md +15 -61
  110. package/_bundled_plugin/skills/triage-finding/SKILL.md +50 -289
  111. package/_bundled_plugin/skills/triage-finding/agents/openai.yaml +2 -2
  112. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +23 -43
  113. package/_bundled_plugin/skills/triage-finding/references/triage-result-contract.md +7 -1
  114. package/bin/codex-security.mjs +9 -2
  115. package/dist/api.d.ts +63 -15
  116. package/dist/api.d.ts.map +1 -1
  117. package/dist/api.js +970 -553
  118. package/dist/api.js.map +1 -1
  119. package/dist/artifact-export.d.ts +70 -0
  120. package/dist/artifact-export.d.ts.map +1 -0
  121. package/dist/artifact-export.js +292 -0
  122. package/dist/artifact-export.js.map +1 -0
  123. package/dist/auth.d.ts +2 -6
  124. package/dist/auth.d.ts.map +1 -1
  125. package/dist/auth.js +27 -12
  126. package/dist/auth.js.map +1 -1
  127. package/dist/bulk-scan-discovery.d.ts +1 -0
  128. package/dist/bulk-scan-discovery.d.ts.map +1 -1
  129. package/dist/bulk-scan-discovery.js +9 -9
  130. package/dist/bulk-scan-discovery.js.map +1 -1
  131. package/dist/classify-scan-severity.d.ts.map +1 -1
  132. package/dist/classify-scan-severity.js +2 -5
  133. package/dist/classify-scan-severity.js.map +1 -1
  134. package/dist/classify-severity.d.ts +28 -17
  135. package/dist/classify-severity.d.ts.map +1 -1
  136. package/dist/classify-severity.js +16 -35
  137. package/dist/classify-severity.js.map +1 -1
  138. package/dist/cli-help.d.ts +3 -0
  139. package/dist/cli-help.d.ts.map +1 -0
  140. package/dist/cli-help.js +285 -0
  141. package/dist/cli-help.js.map +1 -0
  142. package/dist/cli-signals.d.ts +8 -0
  143. package/dist/cli-signals.d.ts.map +1 -0
  144. package/dist/cli-signals.js +28 -0
  145. package/dist/cli-signals.js.map +1 -0
  146. package/dist/cli.d.ts +22 -24
  147. package/dist/cli.d.ts.map +1 -1
  148. package/dist/cli.js +1660 -1556
  149. package/dist/cli.js.map +1 -1
  150. package/dist/cloud-publish.d.ts.map +1 -1
  151. package/dist/cloud-publish.js +11 -17
  152. package/dist/cloud-publish.js.map +1 -1
  153. package/dist/codeowners.d.ts +19 -0
  154. package/dist/codeowners.d.ts.map +1 -0
  155. package/dist/codeowners.js +138 -0
  156. package/dist/codeowners.js.map +1 -0
  157. package/dist/codex-prompt.d.ts.map +1 -1
  158. package/dist/codex-prompt.js +1 -2
  159. package/dist/codex-prompt.js.map +1 -1
  160. package/dist/codex-sdk-environment.d.ts +3 -0
  161. package/dist/codex-sdk-environment.d.ts.map +1 -0
  162. package/dist/codex-sdk-environment.js +68 -0
  163. package/dist/codex-sdk-environment.js.map +1 -0
  164. package/dist/component-plan.d.ts +2 -5
  165. package/dist/component-plan.d.ts.map +1 -1
  166. package/dist/component-plan.js +38 -34
  167. package/dist/component-plan.js.map +1 -1
  168. package/dist/component-scan.d.ts +7 -5
  169. package/dist/component-scan.d.ts.map +1 -1
  170. package/dist/component-scan.js +54 -44
  171. package/dist/component-scan.js.map +1 -1
  172. package/dist/config.d.ts.map +1 -1
  173. package/dist/config.js +93 -104
  174. package/dist/config.js.map +1 -1
  175. package/dist/contract.d.ts +15 -2
  176. package/dist/contract.d.ts.map +1 -1
  177. package/dist/contract.js +124 -348
  178. package/dist/contract.js.map +1 -1
  179. package/dist/cost-model.d.ts +13 -6
  180. package/dist/cost-model.d.ts.map +1 -1
  181. package/dist/cost-model.js +75 -34
  182. package/dist/cost-model.js.map +1 -1
  183. package/dist/cost.d.ts +10 -2
  184. package/dist/cost.d.ts.map +1 -1
  185. package/dist/cost.js +116 -134
  186. package/dist/cost.js.map +1 -1
  187. package/dist/custom-validation-prompt.d.ts.map +1 -1
  188. package/dist/custom-validation-prompt.js +7 -6
  189. package/dist/custom-validation-prompt.js.map +1 -1
  190. package/dist/custom-validation.d.ts +1 -2
  191. package/dist/custom-validation.d.ts.map +1 -1
  192. package/dist/custom-validation.js +23 -16
  193. package/dist/custom-validation.js.map +1 -1
  194. package/dist/deduplication/checkpointed-review.d.ts +4 -2
  195. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  196. package/dist/deduplication/checkpointed-review.js +33 -20
  197. package/dist/deduplication/checkpointed-review.js.map +1 -1
  198. package/dist/deduplication/codex-review.d.ts +9 -1
  199. package/dist/deduplication/codex-review.d.ts.map +1 -1
  200. package/dist/deduplication/codex-review.js +129 -20
  201. package/dist/deduplication/codex-review.js.map +1 -1
  202. package/dist/deduplication/deduplication-prompts.d.ts +5 -2
  203. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  204. package/dist/deduplication/deduplication-prompts.js +18 -4
  205. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  206. package/dist/deduplication/deduplication-reviewer.d.ts +26 -4
  207. package/dist/deduplication/deduplication-reviewer.d.ts.map +1 -1
  208. package/dist/deduplication/deduplication-reviewer.js +59 -47
  209. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  210. package/dist/deduplication/deduplication.d.ts.map +1 -1
  211. package/dist/deduplication/deduplication.js +59 -113
  212. package/dist/deduplication/deduplication.js.map +1 -1
  213. package/dist/deduplication/diagnostics.d.ts +17 -0
  214. package/dist/deduplication/diagnostics.d.ts.map +1 -0
  215. package/dist/deduplication/diagnostics.js +5 -0
  216. package/dist/deduplication/diagnostics.js.map +1 -0
  217. package/dist/deduplication/finding-schema.d.ts.map +1 -1
  218. package/dist/deduplication/finding-schema.js +7 -1
  219. package/dist/deduplication/finding-schema.js.map +1 -1
  220. package/dist/deduplication/local.d.ts +31 -0
  221. package/dist/deduplication/local.d.ts.map +1 -0
  222. package/dist/deduplication/local.js +166 -0
  223. package/dist/deduplication/local.js.map +1 -0
  224. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  225. package/dist/deduplication/records-protocol.js +12 -28
  226. package/dist/deduplication/records-protocol.js.map +1 -1
  227. package/dist/deduplication/records.d.ts +188 -12
  228. package/dist/deduplication/records.d.ts.map +1 -1
  229. package/dist/deduplication/records.js +34 -24
  230. package/dist/deduplication/records.js.map +1 -1
  231. package/dist/deduplication/review.d.ts +7 -0
  232. package/dist/deduplication/review.d.ts.map +1 -1
  233. package/dist/deduplication/review.js.map +1 -1
  234. package/dist/deduplication/scan.d.ts +9 -3
  235. package/dist/deduplication/scan.d.ts.map +1 -1
  236. package/dist/deduplication/scan.js +159 -44
  237. package/dist/deduplication/scan.js.map +1 -1
  238. package/dist/deep-config.d.ts +2 -1
  239. package/dist/deep-config.d.ts.map +1 -1
  240. package/dist/deep-config.js +7 -23
  241. package/dist/deep-config.js.map +1 -1
  242. package/dist/deep-progress.d.ts +2 -1
  243. package/dist/deep-progress.d.ts.map +1 -1
  244. package/dist/deep-progress.js +32 -47
  245. package/dist/deep-progress.js.map +1 -1
  246. package/dist/deep-scan.d.ts +20 -0
  247. package/dist/deep-scan.d.ts.map +1 -0
  248. package/dist/deep-scan.js +113 -0
  249. package/dist/deep-scan.js.map +1 -0
  250. package/dist/errors.d.ts +5 -2
  251. package/dist/errors.d.ts.map +1 -1
  252. package/dist/errors.js +7 -7
  253. package/dist/errors.js.map +1 -1
  254. package/dist/feedback.d.ts.map +1 -1
  255. package/dist/feedback.js +53 -21
  256. package/dist/feedback.js.map +1 -1
  257. package/dist/finding-catalogue.d.ts.map +1 -1
  258. package/dist/finding-catalogue.js +26 -30
  259. package/dist/finding-catalogue.js.map +1 -1
  260. package/dist/finding-normalization.d.ts +5 -0
  261. package/dist/finding-normalization.d.ts.map +1 -0
  262. package/dist/finding-normalization.js +120 -0
  263. package/dist/finding-normalization.js.map +1 -0
  264. package/dist/finding-retrieval.d.ts +9 -0
  265. package/dist/finding-retrieval.d.ts.map +1 -1
  266. package/dist/finding-retrieval.js.map +1 -1
  267. package/dist/finding-workflow.d.ts +13 -8
  268. package/dist/finding-workflow.d.ts.map +1 -1
  269. package/dist/finding-workflow.js +18 -13
  270. package/dist/finding-workflow.js.map +1 -1
  271. package/dist/findings-client.d.ts +2 -1
  272. package/dist/findings-client.d.ts.map +1 -1
  273. package/dist/findings-client.js +36 -9
  274. package/dist/findings-client.js.map +1 -1
  275. package/dist/findings-errors.d.ts +16 -0
  276. package/dist/findings-errors.d.ts.map +1 -0
  277. package/dist/findings-errors.js +24 -0
  278. package/dist/findings-errors.js.map +1 -0
  279. package/dist/findings-import.d.ts +1 -1
  280. package/dist/findings-import.d.ts.map +1 -1
  281. package/dist/findings-import.js +16 -44
  282. package/dist/findings-import.js.map +1 -1
  283. package/dist/github.d.ts.map +1 -1
  284. package/dist/github.js +9 -4
  285. package/dist/github.js.map +1 -1
  286. package/dist/import-scan.d.ts.map +1 -1
  287. package/dist/import-scan.js +49 -39
  288. package/dist/import-scan.js.map +1 -1
  289. package/dist/index.d.ts +11 -5
  290. package/dist/index.d.ts.map +1 -1
  291. package/dist/index.js +2 -1
  292. package/dist/index.js.map +1 -1
  293. package/dist/knowledge-base.d.ts +7 -1
  294. package/dist/knowledge-base.d.ts.map +1 -1
  295. package/dist/knowledge-base.js +115 -47
  296. package/dist/knowledge-base.js.map +1 -1
  297. package/dist/linear.d.ts.map +1 -1
  298. package/dist/linear.js +4 -10
  299. package/dist/linear.js.map +1 -1
  300. package/dist/mock-scan.d.ts.map +1 -1
  301. package/dist/mock-scan.js +0 -1
  302. package/dist/mock-scan.js.map +1 -1
  303. package/dist/models.d.ts +24 -2
  304. package/dist/models.d.ts.map +1 -1
  305. package/dist/models.js.map +1 -1
  306. package/dist/multiscan.d.ts +9 -3
  307. package/dist/multiscan.d.ts.map +1 -1
  308. package/dist/multiscan.js +225 -153
  309. package/dist/multiscan.js.map +1 -1
  310. package/dist/owner-evidence.d.ts +10 -2
  311. package/dist/owner-evidence.d.ts.map +1 -1
  312. package/dist/owner-evidence.js +69 -14
  313. package/dist/owner-evidence.js.map +1 -1
  314. package/dist/patch-tui.d.ts.map +1 -1
  315. package/dist/patch-tui.js +5 -6
  316. package/dist/patch-tui.js.map +1 -1
  317. package/dist/project-config-schema.d.ts +10 -0
  318. package/dist/project-config-schema.d.ts.map +1 -1
  319. package/dist/project-config-schema.js +1 -0
  320. package/dist/project-config-schema.js.map +1 -1
  321. package/dist/project-config.d.ts +1 -0
  322. package/dist/project-config.d.ts.map +1 -1
  323. package/dist/project-config.js +5 -3
  324. package/dist/project-config.js.map +1 -1
  325. package/dist/prompt-files.d.ts +0 -1
  326. package/dist/prompt-files.d.ts.map +1 -1
  327. package/dist/prompt-files.js +2 -4
  328. package/dist/prompt-files.js.map +1 -1
  329. package/dist/provider-profile.d.ts +21 -0
  330. package/dist/provider-profile.d.ts.map +1 -0
  331. package/dist/provider-profile.js +133 -0
  332. package/dist/provider-profile.js.map +1 -0
  333. package/dist/publication-events.d.ts +6 -8
  334. package/dist/publication-events.d.ts.map +1 -1
  335. package/dist/publication-events.js +40 -79
  336. package/dist/publication-events.js.map +1 -1
  337. package/dist/publication-store.d.ts.map +1 -1
  338. package/dist/publication-store.js +48 -76
  339. package/dist/publication-store.js.map +1 -1
  340. package/dist/publication.d.ts +1 -2
  341. package/dist/publication.d.ts.map +1 -1
  342. package/dist/publication.js +7 -16
  343. package/dist/publication.js.map +1 -1
  344. package/dist/publish.d.ts +1 -5
  345. package/dist/publish.d.ts.map +1 -1
  346. package/dist/publish.js +138 -199
  347. package/dist/publish.js.map +1 -1
  348. package/dist/record.d.ts +2 -0
  349. package/dist/record.d.ts.map +1 -0
  350. package/dist/record.js +4 -0
  351. package/dist/record.js.map +1 -0
  352. package/dist/request-metadata.d.ts +9 -0
  353. package/dist/request-metadata.d.ts.map +1 -0
  354. package/dist/request-metadata.js +13 -0
  355. package/dist/request-metadata.js.map +1 -0
  356. package/dist/result.d.ts +4 -1
  357. package/dist/result.d.ts.map +1 -1
  358. package/dist/result.js +7 -0
  359. package/dist/result.js.map +1 -1
  360. package/dist/runtime.d.ts +25 -17
  361. package/dist/runtime.d.ts.map +1 -1
  362. package/dist/runtime.js +619 -255
  363. package/dist/runtime.js.map +1 -1
  364. package/dist/saved-scan-bootstrap.d.ts +14 -0
  365. package/dist/saved-scan-bootstrap.d.ts.map +1 -0
  366. package/dist/saved-scan-bootstrap.js +261 -0
  367. package/dist/saved-scan-bootstrap.js.map +1 -0
  368. package/dist/saved-scan.d.ts +1 -1
  369. package/dist/saved-scan.d.ts.map +1 -1
  370. package/dist/saved-scan.js +16 -32
  371. package/dist/saved-scan.js.map +1 -1
  372. package/dist/scan-activity.d.ts.map +1 -1
  373. package/dist/scan-activity.js +19 -30
  374. package/dist/scan-activity.js.map +1 -1
  375. package/dist/scan-comparison.d.ts +31 -18
  376. package/dist/scan-comparison.d.ts.map +1 -1
  377. package/dist/scan-comparison.js +307 -347
  378. package/dist/scan-comparison.js.map +1 -1
  379. package/dist/scan-dashboard.d.ts +3 -1
  380. package/dist/scan-dashboard.d.ts.map +1 -1
  381. package/dist/scan-dashboard.js +351 -92
  382. package/dist/scan-dashboard.js.map +1 -1
  383. package/dist/scan-history-renderer.d.ts.map +1 -1
  384. package/dist/scan-history-renderer.js +55 -15
  385. package/dist/scan-history-renderer.js.map +1 -1
  386. package/dist/scan-inputs.d.ts +6 -0
  387. package/dist/scan-inputs.d.ts.map +1 -0
  388. package/dist/scan-inputs.js +71 -0
  389. package/dist/scan-inputs.js.map +1 -0
  390. package/dist/scan-logs.d.ts +2 -3
  391. package/dist/scan-logs.d.ts.map +1 -1
  392. package/dist/scan-logs.js +14 -12
  393. package/dist/scan-logs.js.map +1 -1
  394. package/dist/scan-sessions.d.ts +4 -0
  395. package/dist/scan-sessions.d.ts.map +1 -1
  396. package/dist/scan-sessions.js +18 -3
  397. package/dist/scan-sessions.js.map +1 -1
  398. package/dist/scan-settings.d.ts +5 -0
  399. package/dist/scan-settings.d.ts.map +1 -1
  400. package/dist/scan-settings.js +4 -0
  401. package/dist/scan-settings.js.map +1 -1
  402. package/dist/scan-skill-paths.d.ts +8 -0
  403. package/dist/scan-skill-paths.d.ts.map +1 -0
  404. package/dist/scan-skill-paths.js +47 -0
  405. package/dist/scan-skill-paths.js.map +1 -0
  406. package/dist/security-policy-cli.d.ts.map +1 -1
  407. package/dist/security-policy-cli.js +15 -33
  408. package/dist/security-policy-cli.js.map +1 -1
  409. package/dist/security-policy.d.ts +17 -9
  410. package/dist/security-policy.d.ts.map +1 -1
  411. package/dist/security-policy.js +131 -98
  412. package/dist/security-policy.js.map +1 -1
  413. package/dist/server/api.d.ts +0 -1
  414. package/dist/server/api.d.ts.map +1 -1
  415. package/dist/server/api.js +0 -1
  416. package/dist/server/api.js.map +1 -1
  417. package/dist/server/embeddings.d.ts +3 -1
  418. package/dist/server/embeddings.d.ts.map +1 -1
  419. package/dist/server/embeddings.js +11 -3
  420. package/dist/server/embeddings.js.map +1 -1
  421. package/dist/server/errors.d.ts +5 -2
  422. package/dist/server/errors.d.ts.map +1 -1
  423. package/dist/server/errors.js +7 -0
  424. package/dist/server/errors.js.map +1 -1
  425. package/dist/server/sqlite-store.d.ts +0 -2
  426. package/dist/server/sqlite-store.d.ts.map +1 -1
  427. package/dist/server/sqlite-store.js +55 -55
  428. package/dist/server/sqlite-store.js.map +1 -1
  429. package/dist/server/storage.d.ts +0 -2
  430. package/dist/server/storage.d.ts.map +1 -1
  431. package/dist/server/storage.js.map +1 -1
  432. package/dist/severity-store.js +20 -32
  433. package/dist/severity-store.js.map +1 -1
  434. package/dist/standalone-validation-prompt.d.ts +2 -0
  435. package/dist/standalone-validation-prompt.d.ts.map +1 -0
  436. package/dist/standalone-validation-prompt.js +10 -0
  437. package/dist/standalone-validation-prompt.js.map +1 -0
  438. package/dist/suggest-owners.d.ts +6 -5
  439. package/dist/suggest-owners.d.ts.map +1 -1
  440. package/dist/suggest-owners.js +15 -10
  441. package/dist/suggest-owners.js.map +1 -1
  442. package/dist/targets.d.ts +12 -0
  443. package/dist/targets.d.ts.map +1 -1
  444. package/dist/targets.js +124 -62
  445. package/dist/targets.js.map +1 -1
  446. package/dist/trusted-executable.d.ts +6 -1
  447. package/dist/trusted-executable.d.ts.map +1 -1
  448. package/dist/trusted-executable.js +28 -9
  449. package/dist/trusted-executable.js.map +1 -1
  450. package/dist/value.d.ts +2 -0
  451. package/dist/value.d.ts.map +1 -0
  452. package/dist/value.js +27 -0
  453. package/dist/value.js.map +1 -0
  454. package/dist/version.d.ts.map +1 -1
  455. package/dist/version.js +3 -6
  456. package/dist/version.js.map +1 -1
  457. package/dist/windows-path.d.ts.map +1 -1
  458. package/dist/windows-path.js +1 -2
  459. package/dist/windows-path.js.map +1 -1
  460. package/dist/workbench-arguments.d.ts +3 -0
  461. package/dist/workbench-arguments.d.ts.map +1 -0
  462. package/dist/workbench-arguments.js +15 -0
  463. package/dist/workbench-arguments.js.map +1 -0
  464. package/dist/worker-progress.d.ts +2 -0
  465. package/dist/worker-progress.d.ts.map +1 -1
  466. package/dist/worker-progress.js +40 -46
  467. package/dist/worker-progress.js.map +1 -1
  468. package/docs/cli.md +1778 -0
  469. package/docs/dedupe-records.md +24 -0
  470. package/docs/findings-service.md +402 -0
  471. package/package.json +23 -23
  472. package/schemas/project-config.schema.json +5 -0
  473. package/_bundled_plugin/schemas/tools/worker-threat-model.schema.json +0 -18
  474. package/_bundled_plugin/scripts/normalize_candidates.py +0 -338
  475. package/_bundled_plugin/scripts/workbench_dashboard.py +0 -159
  476. package/_bundled_plugin/scripts/workbench_findings.py +0 -221
  477. package/_bundled_plugin/scripts/workbench_severity.py +0 -119
  478. package/_bundled_plugin/skills/assess-patch-risk/scripts/validate_patch_risk_assessment.py +0 -163
  479. package/dist/server/dashboard/THIRD_PARTY_NOTICES.txt +0 -276
  480. package/dist/server/dashboard/app.css +0 -2
  481. package/dist/server/dashboard/app.js +0 -66
  482. package/dist/server/dashboard/index.html +0 -18
  483. package/dist/server/dashboard-types.d.ts +0 -48
  484. package/dist/server/dashboard-types.d.ts.map +0 -1
  485. package/dist/server/dashboard-types.js +0 -2
  486. package/dist/server/dashboard-types.js.map +0 -1
  487. package/dist/server/dashboard.d.ts +0 -6
  488. package/dist/server/dashboard.d.ts.map +0 -1
  489. package/dist/server/dashboard.js +0 -59
  490. package/dist/server/dashboard.js.map +0 -1
  491. package/dist/server/findings-service.d.ts +0 -20
  492. package/dist/server/findings-service.d.ts.map +0 -1
  493. package/dist/server/findings-service.js +0 -31
  494. package/dist/server/findings-service.js.map +0 -1
  495. package/dist/server/index.d.ts +0 -2
  496. package/dist/server/index.d.ts.map +0 -1
  497. package/dist/server/index.js +0 -6
  498. package/dist/server/index.js.map +0 -1
  499. package/dist/server/routes.d.ts +0 -6
  500. package/dist/server/routes.d.ts.map +0 -1
  501. package/dist/server/routes.js +0 -86
  502. package/dist/server/routes.js.map +0 -1
  503. package/dist/server/serve.d.ts +0 -2
  504. package/dist/server/serve.d.ts.map +0 -1
  505. package/dist/server/serve.js +0 -28
  506. package/dist/server/serve.js.map +0 -1
  507. package/dist/server/server.d.ts +0 -10
  508. package/dist/server/server.d.ts.map +0 -1
  509. package/dist/server/server.js +0 -17
  510. package/dist/server/server.js.map +0 -1
  511. package/dist/server/validation.d.ts +0 -17
  512. package/dist/server/validation.d.ts.map +0 -1
  513. package/dist/server/validation.js +0 -53
  514. package/dist/server/validation.js.map +0 -1
@@ -28,22 +28,12 @@ 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
- rendered: list[str] = []
36
- cursor = 0
37
- for match in re.finditer(r"(?<!`)`([^`\n]+)`(?!`)", normalized):
38
- rendered.append(_escape_markdown_text(normalized[cursor : match.start()]))
39
- rendered.append(f"`{match.group(1)}`")
40
- cursor = match.end()
41
- rendered.append(_escape_markdown_text(normalized[cursor:]))
42
- return "".join(rendered)
43
-
44
-
45
- def _escape_markdown_text(value: str) -> str:
46
- return re.sub(r"([\\`*\[\]<>])", r"\\\1", value)
33
+ return "".join(
34
+ part if index % 2 else re.sub(r"([\\`*_\[\]<>])", r"\\\1", part)
35
+ for index, part in enumerate(re.split(r"((?<!`)`[^`\n]+`(?!`))", normalized))
36
+ )
47
37
 
48
38
 
49
39
  def _strings(value: Any) -> list[str]:
@@ -51,22 +41,13 @@ def _strings(value: Any) -> list[str]:
51
41
  value = [value]
52
42
  if not isinstance(value, list):
53
43
  return []
54
- normalized: list[str] = []
55
- for item in value:
56
- text = _text(item, "")
57
- if text:
58
- normalized.append(text)
59
- return normalized
44
+ return [text for item in value if (text := _text(item, ""))]
60
45
 
61
46
 
62
47
  def _cell(value: Any) -> str:
63
48
  return _text(value, "none").replace("|", "\\|").replace("\n", "<br>")
64
49
 
65
50
 
66
- def _link_label(value: Any, fallback: str) -> str:
67
- return _cell(value) or _cell(fallback)
68
-
69
-
70
51
  def _deep_report_id(finding: dict[str, Any]) -> str:
71
52
  extensions = finding.get("extensions")
72
53
  if isinstance(extensions, dict):
@@ -108,7 +89,7 @@ def _has_deep_child_metadata(finding: dict[str, Any]) -> bool:
108
89
  )
109
90
 
110
91
 
111
- 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:
112
93
  if coverage.get("mode") == "deep_repository":
113
94
  return True
114
95
  if coverage.get("mode") != "scoped_path":
@@ -141,10 +122,6 @@ def _deep_title_parts(finding: dict[str, Any]) -> tuple[str, str | None]:
141
122
  return normalized, None
142
123
 
143
124
 
144
- def _deep_finding_title(finding: dict[str, Any]) -> str:
145
- return _deep_title_parts(finding)[0]
146
-
147
-
148
125
  def _deep_finding_groups(
149
126
  findings: list[dict[str, Any]], writeup_paths: list[str | None]
150
127
  ) -> list[list[tuple[int, dict[str, Any], str | None]]]:
@@ -155,12 +132,9 @@ def _deep_finding_groups(
155
132
 
156
133
 
157
134
  def _deep_group_titles(group: list[tuple[int, dict[str, Any], str | None]]) -> str:
158
- titles: list[str] = []
159
- for _, finding, _ in group:
160
- title = _cell(_deep_finding_title(finding))
161
- if title not in titles:
162
- titles.append(title)
163
- return "<br>".join(titles)
135
+ return "<br>".join(
136
+ dict.fromkeys(_cell(_deep_title_parts(finding)[0]) for _, finding, _ in group)
137
+ )
164
138
 
165
139
 
166
140
  def _deep_group_levels(
@@ -197,7 +171,7 @@ def _deep_group_report_labels(
197
171
  def _deep_group_report_links(group: list[tuple[int, dict[str, Any], str | None]]) -> str:
198
172
  labels = _deep_group_report_labels(group)
199
173
  return "<br>".join(
200
- f"[{_link_label(label, 'Unidentified report')}](#finding-{number})"
174
+ f"[{_cell(label)}](#finding-{number})"
201
175
  for label, (number, _, _) in zip(labels, group, strict=True)
202
176
  )
203
177
 
@@ -206,7 +180,7 @@ def _deep_group_writeup_links(group: list[tuple[int, dict[str, Any], str | None]
206
180
  labels = _deep_group_report_labels(group)
207
181
  links: list[str] = []
208
182
  for label, (_, _, report_path) in zip(labels, group, strict=True):
209
- report_id = _link_label(label, "Unidentified report")
183
+ report_id = _cell(label)
210
184
  links.append(
211
185
  f"[Open {report_id}]({report_path})" if report_path else f"{report_id}: inline below"
212
186
  )
@@ -237,8 +211,8 @@ def _hardening_portfolio_path(scan: dict[str, Any]) -> str | None:
237
211
  return portfolio_path
238
212
 
239
213
 
240
- def _bullets(items: list[str], fallback: str) -> list[str]:
241
- 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 []
242
216
 
243
217
 
244
218
  def _code_evidence_catalog(finding: dict[str, Any]) -> dict[str, dict[str, Any]]:
@@ -282,15 +256,11 @@ def _section_code_evidence(
282
256
  and isinstance(item.get("code"), str)
283
257
  and item["code"].strip()
284
258
  )
285
- unique: list[dict[str, Any]] = []
286
- seen: set[tuple[str, str]] = set()
259
+ unique: dict[tuple[str, str], dict[str, Any]] = {}
287
260
  for item in resolved:
288
261
  key = (str(item.get("id", "")), item["code"])
289
- if key in seen:
290
- continue
291
- seen.add(key)
292
- unique.append(item)
293
- return unique
262
+ unique.setdefault(key, item)
263
+ return list(unique.values())
294
264
 
295
265
 
296
266
  def merged_root_cause(value: dict[str, Any]) -> tuple[str | None, Any]:
@@ -307,8 +277,6 @@ def merged_root_cause(value: dict[str, Any]) -> tuple[str | None, Any]:
307
277
  details.append({"summary": detail})
308
278
  elif isinstance(detail, dict):
309
279
  details.append(detail)
310
- elif detail is not None:
311
- continue
312
280
  if not details:
313
281
  return keys[0], None
314
282
 
@@ -431,16 +399,16 @@ def _code_evidence_location(item: dict[str, Any]) -> str:
431
399
  return f"{path}:{start}" if end == start else f"{path}:{start}-{end}"
432
400
 
433
401
 
434
- def _code_fence(code: str) -> str:
402
+ def _code_fence(code: str, minimum: int = 3) -> str:
435
403
  longest_run = max((len(match.group(0)) for match in re.finditer(r"`+", code)), default=0)
436
- return "`" * max(3, longest_run + 1)
404
+ return "`" * max(minimum, longest_run + 1)
437
405
 
438
406
 
439
407
  def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
440
408
  lines: list[str] = []
441
409
  for index, item in enumerate(evidence):
442
410
  label = _text(item.get("label"), f"Code evidence {index + 1}")
443
- location = _text(_code_evidence_location(item), "")
411
+ location = " ".join(_code_evidence_location(item).split())
444
412
  explanation = _text(item.get("explanation"), "")
445
413
  language = item.get("language") if isinstance(item.get("language"), str) else ""
446
414
  language = language if re.fullmatch(r"[A-Za-z0-9_+.-]*", language) else ""
@@ -448,7 +416,9 @@ def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
448
416
  fence = _code_fence(code)
449
417
  heading = f"**{label}**"
450
418
  if location:
451
- 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}"
452
422
  lines.extend(["", heading])
453
423
  if explanation:
454
424
  lines.extend(["", explanation])
@@ -456,22 +426,9 @@ def _code_evidence_lines(evidence: list[dict[str, Any]]) -> list[str]:
456
426
  return lines
457
427
 
458
428
 
459
- def _severity_mix(findings: list[dict[str, Any]]) -> str:
460
- counts = Counter(finding["severity"]["level"] for finding in findings)
461
- return (
462
- ", ".join(f"{level}: {counts[level]}" for level in SEVERITY_ORDER if counts[level])
463
- or "none"
464
- )
465
-
466
-
467
- def _confidence_mix(findings: list[dict[str, Any]]) -> str:
468
- counts = Counter(finding["confidence"]["level"] for finding in findings)
469
- return (
470
- ", ".join(
471
- f"{level}: {counts[level]}" for level in ("high", "medium", "low") if counts[level]
472
- )
473
- or "none"
474
- )
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"
475
432
 
476
433
 
477
434
  def _locations(finding: dict[str, Any]) -> str:
@@ -523,6 +480,71 @@ def _surface_notes(surface: dict[str, Any]) -> str:
523
480
  return _cell(f"{notes} Evidence: {evidence}")
524
481
 
525
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
+
526
548
  def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
527
549
  validation = finding.get("validation") if isinstance(finding.get("validation"), dict) else {}
528
550
  _, raw_root_cause = merged_root_cause(finding)
@@ -585,10 +607,6 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
585
607
  if validation_outcomes
586
608
  else f"{finding['confidence']['rationale']} Validation details were not recorded separately.",
587
609
  )
588
- validation_evidence = _strings(validation.get("evidence"))
589
- validation_assertions = _strings(validation.get("assertions"))
590
- validation_counterevidence = _strings(validation.get("counterEvidence"))
591
- validation_limitations = _strings(validation.get("limitations"))
592
610
  root_cause_summary = _text(
593
611
  raw_root_cause if isinstance(raw_root_cause, str) else root_cause.get("summary"),
594
612
  "",
@@ -601,12 +619,9 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
601
619
  dataflow.get("summary"),
602
620
  f"The canonical finding records the affected path at {_locations(finding)}, but no expanded source-to-sink narrative was recorded.",
603
621
  )
604
- reachability_summary = _text(
605
- reachability.get("summary"),
606
- _text(
607
- attack_path.get("summary"),
608
- "Reachability was not recorded beyond the canonical finding summary and affected locations.",
609
- ),
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.",
610
625
  )
611
626
  severity_rationale = _text(
612
627
  severity.get("rationale"),
@@ -616,24 +631,8 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
616
631
  severity.get("changeConditions"),
617
632
  "Additional runtime or deployment evidence could raise or lower this severity.",
618
633
  )
619
- remediation_tests = _strings(finding.get("remediationTests"))
620
- preventive_controls = _strings(finding.get("preventiveControls"))
621
- attack_steps = _strings(attack_path.get("steps"))
622
- cwes = ", ".join(finding["taxonomy"]["cwe"]) or "none"
623
- title = _text(finding["title"], "Untitled finding")
624
634
  lines = [
625
- f'<a id="finding-{number}"></a>',
626
- "",
627
- f"### [{number}] {title}",
628
- "",
629
- "| Field | Value |",
630
- "| --- | --- |",
631
- f"| Severity | {_cell(severity['level'])} |",
632
- f"| Confidence | {_cell(finding['confidence']['level'])} |",
633
- f"| Confidence rationale | {_cell(finding['confidence']['rationale'])} |",
634
- f"| Category | {_cell(finding['taxonomy']['category'])} |",
635
- f"| CWE | {_cell(cwes)} |",
636
- f"| Affected lines | {_cell(_locations(finding))} |",
635
+ *_finding_header(number, finding),
637
636
  "",
638
637
  "#### Summary",
639
638
  "",
@@ -650,29 +649,19 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
650
649
  if validation_outcomes:
651
650
  lines.extend(["", *(f"- **{label}:** {value}" for label, value in validation_outcomes)])
652
651
  lines.extend(_code_evidence_lines(validation_code_evidence))
653
- if validation_assertions:
654
- lines.extend(["", "Assertions:", *_bullets(validation_assertions, "None recorded.")])
655
- if validation_evidence:
656
- lines.extend(["", "Evidence:", *_bullets(validation_evidence, "No evidence recorded.")])
657
- if validation_counterevidence:
658
- lines.extend(
659
- [
660
- "",
661
- "Counterevidence and remaining uncertainty:",
662
- *_bullets(validation_counterevidence, "None recorded."),
663
- ]
664
- )
665
- if validation_limitations:
666
- 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))))
667
659
  lines.extend(["", "#### Dataflow", "", dataflow_summary])
668
- if attack_steps:
669
- lines.extend(["", "Attack steps:", *_bullets(attack_steps, "None recorded.")])
660
+ lines.extend(_bullet_section("Attack steps:", _strings(attack_path.get("steps"))))
670
661
  for label, key in (("Source", "source"), ("Sink", "sink"), ("Outcome", "outcome")):
671
662
  if dataflow.get(key):
672
663
  lines.extend(["", f"- **{label}:** {_text(dataflow[key], 'not recorded')}"])
673
- transformations = _strings(dataflow.get("transformations"))
674
- if transformations:
675
- lines.extend(["", "Transformations:", *_bullets(transformations, "None recorded.")])
664
+ lines.extend(_bullet_section("Transformations:", _strings(dataflow.get("transformations"))))
676
665
  lines.extend(_code_evidence_lines(dataflow_code_evidence))
677
666
  lines.extend(["", "#### Reachability", "", reachability_summary])
678
667
  for label, key in (
@@ -692,17 +681,14 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
692
681
  ]
693
682
  )
694
683
  )
695
- if preconditions:
696
- lines.extend(["", "Preconditions:", *_bullets(preconditions, "None recorded.")])
684
+ lines.extend(_bullet_section("Preconditions:", preconditions))
697
685
  for label, key in (
698
686
  ("Assumptions", "assumptions"),
699
687
  ("Existing controls", "controls"),
700
688
  ("Blind spots", "blindspots"),
701
689
  ("Limitations", "limitations"),
702
690
  ):
703
- values = _strings(attack_path.get(key))
704
- if values:
705
- lines.extend(["", f"{label}:", *_bullets(values, "None recorded.")])
691
+ lines.extend(_bullet_section(f"{label}:", _strings(attack_path.get(key))))
706
692
  lines.extend(_code_evidence_lines(reachability_code_evidence))
707
693
  lines.extend(
708
694
  [
@@ -736,41 +722,21 @@ def _finding_section(number: int, finding: dict[str, Any]) -> list[str]:
736
722
  lines.extend(
737
723
  ["", f"{label} assessment:", *(f"- **{name}:** {value}" for name, value in details)]
738
724
  )
739
- lines.extend(
740
- [
741
- "",
742
- "#### Remediation",
743
- "",
744
- _text(finding["remediation"], "No canonical remediation was recorded."),
745
- ]
746
- )
747
- if remediation_tests:
748
- lines.extend(["", "Tests:", *_bullets(remediation_tests, "No tests recorded.")])
749
- if preventive_controls:
750
- lines.extend(["", "Preventive controls:", *_bullets(preventive_controls, "None recorded.")])
725
+ lines.extend(_remediation_section(finding))
751
726
  return lines
752
727
 
753
728
 
754
729
  def _linked_finding_section(number: int, finding: dict[str, Any], report_path: str) -> list[str]:
755
- cwes = ", ".join(finding["taxonomy"]["cwe"]) or "none"
756
- title = _text(finding["title"], "Untitled finding")
757
730
  link = f"[detailed technical write-up]({report_path})"
758
- lines = [
759
- f'<a id="finding-{number}"></a>',
760
- "",
761
- f"### [{number}] {title}",
762
- "",
763
- "| Field | Value |",
764
- "| --- | --- |",
765
- f"| Severity | {_cell(finding['severity']['level'])} |",
766
- f"| Confidence | {_cell(finding['confidence']['level'])} |",
767
- f"| Confidence rationale | {_cell(finding['confidence']['rationale'])} |",
768
- f"| Category | {_cell(finding['taxonomy']['category'])} |",
769
- f"| CWE | {_cell(cwes)} |",
770
- f"| Affected lines | {_cell(_locations(finding))} |",
771
- ]
772
- for heading in ("Summary", "Validation", "Dataflow", "Reachability", "Severity", "Remediation"):
731
+ lines = _finding_header(number, finding)
732
+ for heading in ("Summary", "Validation", "Dataflow", "Reachability", "Severity"):
773
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}."])
774
740
  return lines
775
741
 
776
742
 
@@ -800,7 +766,7 @@ def build_report_markdown(
800
766
  "reportable findings have duplicate writeup reportPath values: "
801
767
  + ", ".join(duplicate_writeup_paths)
802
768
  )
803
- deep_presentation = _uses_deep_presentation(coverage, findings)
769
+ deep_presentation = uses_deep_presentation(coverage, findings)
804
770
  deep_finding_groups = _deep_finding_groups(findings, writeup_paths) if deep_presentation else []
805
771
  hardening_portfolio_path = _hardening_portfolio_path(scan)
806
772
  include_paths = _strings(coverage.get("includePaths", scope.get("includePaths", [])))
@@ -835,20 +801,19 @@ def build_report_markdown(
835
801
  f"Excluded {_text(exclusion.get('pattern'), 'unspecified')}: "
836
802
  f"{_text(exclusion.get('reason'), 'reason not recorded')}"
837
803
  )
838
- if limitations:
839
- lines.extend(["", "Limitations and exclusions:", *_bullets(limitations, "None recorded.")])
804
+ lines.extend(_bullet_section("Limitations and exclusions:", limitations))
840
805
  summary_count_lines = (
841
806
  [
842
807
  f"| Reportable DSS findings | {len(deep_finding_groups)} |",
843
808
  f"| Report instances | {len(findings)} |",
844
- f"| Report severity mix | {_severity_mix(findings)} |",
845
- 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)} |",
846
811
  ]
847
812
  if deep_presentation
848
813
  else [
849
814
  f"| Reportable findings | {len(findings)} |",
850
- f"| Severity mix | {_severity_mix(findings)} |",
851
- 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)} |",
852
817
  ]
853
818
  )
854
819
  lines.extend(
@@ -860,33 +825,34 @@ def build_report_markdown(
860
825
  "| --- | --- |",
861
826
  f"| Scan outcome | {scan.get('status', 'completed')} |",
862
827
  *summary_count_lines,
863
- f"| Coverage | {coverage['completeness']} |",
864
828
  f"| Validation mode | {_cell(scope.get('validationMode', 'not recorded'))} |",
865
829
  "",
866
830
  "Canonical artifacts: `scan-manifest.json`, `findings.json`, and `coverage.json`. This report is a deterministic projection of those files.",
867
831
  "",
868
832
  "## Threat Model",
869
833
  "",
834
+ ]
835
+ )
836
+ content = threat_model.get("content")
837
+ if threat_model.get("format") == "markdown" and isinstance(content, str) and content.strip():
838
+ lines.append(content)
839
+ else:
840
+ lines.append(
870
841
  _text(
871
842
  threat_model.get("summary"),
872
843
  "No explicit canonical threat-model summary was recorded.",
873
- ),
874
- ]
875
- )
876
- for heading, key, fallback in (
877
- ("Assets", "assets", "No assets were recorded."),
878
- ("Trust Boundaries", "trustBoundaries", "No trust boundaries were recorded."),
879
- (
880
- "Attacker Capabilities",
881
- "attackerCapabilities",
882
- "No attacker capabilities were recorded.",
883
- ),
884
- ("Security Objectives", "securityObjectives", "No security objectives were recorded."),
885
- ("Assumptions", "assumptions", "No assumptions were recorded."),
886
- ):
887
- values = _strings(threat_model.get(key))
888
- if values:
889
- lines.extend(["", f"### {heading}", "", *_bullets(values, fallback)])
844
+ )
845
+ )
846
+ for heading, key in (
847
+ ("Assets", "assets"),
848
+ ("Trust Boundaries", "trustBoundaries"),
849
+ ("Attacker Capabilities", "attackerCapabilities"),
850
+ ("Security Objectives", "securityObjectives"),
851
+ ("Assumptions", "assumptions"),
852
+ ):
853
+ values = _strings(threat_model.get(key))
854
+ if values:
855
+ lines.extend(["", f"### {heading}", "", *(f"- {value}" for value in values)])
890
856
  lines.extend(["", "## Findings", ""])
891
857
  if findings:
892
858
  if deep_presentation:
@@ -913,7 +879,7 @@ def build_report_markdown(
913
879
  for number, (finding, report_path) in enumerate(
914
880
  zip(findings, writeup_paths, strict=True), 1
915
881
  ):
916
- title = _link_label(finding["title"], "Untitled finding")
882
+ title = _cell(finding["title"])
917
883
  finding_link = f"[{title}](#finding-{number})"
918
884
  writeup_link = f"[Open report]({report_path})" if report_path else "inline below"
919
885
  lines.append(
@@ -940,33 +906,6 @@ def build_report_markdown(
940
906
  else:
941
907
  lines.extend(["", *_finding_section(number, finding)])
942
908
  else:
943
- deferred = coverage.get("deferred", [])
944
- no_source_review = (
945
- coverage.get("completeness") == "partial"
946
- and isinstance(deferred, list)
947
- and any(
948
- isinstance(item, dict)
949
- and item.get("reason")
950
- == "The configured discovery time limit elapsed before any source review completed."
951
- for item in deferred
952
- )
953
- )
954
- budget_exhausted = (
955
- coverage.get("completeness") == "partial"
956
- and isinstance(deferred, list)
957
- and any(
958
- isinstance(item, dict)
959
- and isinstance(item.get("reason"), str)
960
- and (
961
- item["reason"]
962
- == "Validation was deferred because the scan reached its cost limit."
963
- or item["reason"].startswith(
964
- "Validation was deferred because the scan reached its cost limit: "
965
- )
966
- )
967
- for item in deferred
968
- )
969
- )
970
909
  stopped = manifest.get("scan", {}).get("status") in {
971
910
  "failed",
972
911
  "canceled",
@@ -980,18 +919,7 @@ def build_report_markdown(
980
919
  "No findings were retained before the scan stopped. "
981
920
  "The scan did not complete. No vulnerability conclusion can be drawn."
982
921
  if stopped
983
- else (
984
- "No source review completed before the configured time limit. "
985
- "No vulnerability conclusion can be drawn."
986
- if no_source_review
987
- else (
988
- "No findings were validated before the scan reached its cost limit. "
989
- "Review the deferred candidates in Open Questions And Follow Up."
990
- if budget_exhausted
991
- else "No reportable findings survived the canonical discovery, validation, "
992
- "and reportability gates."
993
- )
994
- )
922
+ else "No findings were reported."
995
923
  ),
996
924
  ]
997
925
  )
@@ -1078,11 +1006,7 @@ def generate_report_markdown(
1078
1006
  return build_report_markdown(manifest, findings, coverage).encode("utf-8")
1079
1007
 
1080
1008
 
1081
- def main() -> int:
1009
+ if __name__ == "__main__":
1082
1010
  parser = argparse.ArgumentParser(description=__doc__)
1083
1011
  parser.parse_args()
1084
- return 0
1085
-
1086
-
1087
- if __name__ == "__main__":
1088
- raise SystemExit(main())
1012
+ raise SystemExit(0)
@@ -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)