@openai/codex-security 0.6.0 → 0.8.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 (308) hide show
  1. package/README.md +76 -39
  2. package/_bundled_plugin/.mcp.json +1 -0
  3. package/_bundled_plugin/examples/completed-scan/findings.json +34 -34
  4. package/_bundled_plugin/examples/completed-scan/report.md +22 -31
  5. package/_bundled_plugin/examples/completed-scan/scan-manifest.json +27 -29
  6. package/_bundled_plugin/examples/{completed-scan → legacy-completed-scan}/coverage.json +1 -0
  7. package/_bundled_plugin/examples/legacy-completed-scan/findings.json +57 -0
  8. package/_bundled_plugin/examples/legacy-completed-scan/report.md +98 -0
  9. package/_bundled_plugin/examples/legacy-completed-scan/scan-manifest.json +43 -0
  10. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  11. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  12. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +1 -1
  13. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  14. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  15. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  16. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  17. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  18. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  19. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  20. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  21. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  22. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  23. package/_bundled_plugin/references/access-advisory.md +11 -0
  24. package/_bundled_plugin/references/core-scan.md +30 -77
  25. package/_bundled_plugin/references/final-report.md +50 -184
  26. package/_bundled_plugin/references/scan-artifacts.md +5 -5
  27. package/_bundled_plugin/references/scan-contract.md +12 -12
  28. package/_bundled_plugin/references/scan-prologue.md +1 -1
  29. package/_bundled_plugin/references/scan-runtime.md +1 -5
  30. package/_bundled_plugin/references/threat-model.md +33 -41
  31. package/_bundled_plugin/schemas/coverage.schema.json +12 -1
  32. package/_bundled_plugin/schemas/scan-manifest.schema.json +37 -11
  33. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +38 -1
  34. package/_bundled_plugin/schemas/tools/scan-draft.schema.json +5 -5
  35. package/_bundled_plugin/scripts/deep_scan_config.py +39 -39
  36. package/_bundled_plugin/scripts/deep_scan_workbench.py +146 -86
  37. package/_bundled_plugin/scripts/finalize_scan_contract.py +249 -76
  38. package/_bundled_plugin/scripts/report_projection.py +49 -17
  39. package/_bundled_plugin/scripts/review_state.py +68 -0
  40. package/_bundled_plugin/scripts/threat_model_projection.py +4 -2
  41. package/_bundled_plugin/scripts/validate_scan_contract.py +1 -2
  42. package/_bundled_plugin/scripts/windows_scan_local_files.py +43 -14
  43. package/_bundled_plugin/scripts/workbench/retained_coverage.py +3230 -0
  44. package/_bundled_plugin/scripts/workbench/retained_records.py +627 -0
  45. package/_bundled_plugin/scripts/workbench/saved_coverage.py +651 -8
  46. package/_bundled_plugin/scripts/workbench/saved_outputs.py +72 -0
  47. package/_bundled_plugin/scripts/workbench/saved_sources.py +730 -0
  48. package/_bundled_plugin/scripts/workbench_cli.py +3 -0
  49. package/_bundled_plugin/scripts/workbench_constants.py +0 -1
  50. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +479 -0
  51. package/_bundled_plugin/scripts/workbench_db.py +55 -171
  52. package/_bundled_plugin/scripts/workbench_feedback.py +0 -1
  53. package/_bundled_plugin/scripts/workbench_finding_workflows.py +51 -9
  54. package/_bundled_plugin/scripts/workbench_native_indexes.py +56 -44
  55. package/_bundled_plugin/scripts/workbench_saved_results.py +808 -2389
  56. package/_bundled_plugin/scripts/workbench_scan_history.py +77 -7
  57. package/_bundled_plugin/scripts/workbench_schema.py +1 -1
  58. package/_bundled_plugin/scripts/workbench_source_scopes.py +4 -1
  59. package/_bundled_plugin/scripts/workbench_target.py +142 -17
  60. package/_bundled_plugin/scripts/workbench_validation.py +9 -2
  61. package/_bundled_plugin/shared/workbench-history-repairs.json +21 -0
  62. package/_bundled_plugin/shared/workbench-migrations.json +28 -0
  63. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +3 -14
  64. package/_bundled_plugin/skills/assess-patch-risk/references/windows-validation.md +14 -0
  65. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +38 -103
  66. package/_bundled_plugin/skills/attack-path-analysis/references/attack-path-facts.md +11 -73
  67. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +57 -116
  68. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +28 -51
  69. package/_bundled_plugin/skills/define-security-policy/SKILL.md +9 -9
  70. package/_bundled_plugin/skills/finding-discovery/SKILL.md +26 -140
  71. package/_bundled_plugin/skills/fix-finding/SKILL.md +9 -28
  72. package/_bundled_plugin/skills/propose-security-hardening/SKILL.md +28 -218
  73. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +29 -424
  74. package/_bundled_plugin/skills/publish-findings/SKILL.md +32 -24
  75. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +64 -0
  76. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +12 -12
  77. package/_bundled_plugin/skills/security-scan/SKILL.md +29 -17
  78. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +11 -17
  79. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +52 -69
  80. package/_bundled_plugin/skills/threat-model/SKILL.md +16 -9
  81. package/_bundled_plugin/skills/track-findings/SKILL.md +1 -1
  82. package/_bundled_plugin/skills/triage-finding/SKILL.md +5 -15
  83. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -6
  84. package/_bundled_plugin/skills/validation/SKILL.md +42 -104
  85. package/_bundled_plugin/skills/validation/references/validation-guidance.md +21 -106
  86. package/_bundled_plugin/skills/verify-fix/SKILL.md +4 -2
  87. package/_bundled_plugin/skills/vulnerability-writeup/SKILL.md +21 -159
  88. package/_bundled_plugin/skills/vulnerability-writeup/references/report-format.md +18 -60
  89. package/dist/api.d.ts +5 -3
  90. package/dist/api.d.ts.map +1 -1
  91. package/dist/api.js +359 -53
  92. package/dist/api.js.map +1 -1
  93. package/dist/auth.d.ts.map +1 -1
  94. package/dist/auth.js +4 -1
  95. package/dist/auth.js.map +1 -1
  96. package/dist/cli.d.ts +2 -2
  97. package/dist/cli.d.ts.map +1 -1
  98. package/dist/cli.js +696 -430
  99. package/dist/cli.js.map +1 -1
  100. package/dist/cloud-publish.d.ts.map +1 -1
  101. package/dist/cloud-publish.js +2 -23
  102. package/dist/cloud-publish.js.map +1 -1
  103. package/dist/component-scan.d.ts +8 -2
  104. package/dist/component-scan.d.ts.map +1 -1
  105. package/dist/component-scan.js +2 -0
  106. package/dist/component-scan.js.map +1 -1
  107. package/dist/contract.d.ts +5 -2
  108. package/dist/contract.d.ts.map +1 -1
  109. package/dist/contract.js +93 -45
  110. package/dist/contract.js.map +1 -1
  111. package/dist/cost.d.ts +18 -0
  112. package/dist/cost.d.ts.map +1 -1
  113. package/dist/cost.js +107 -12
  114. package/dist/cost.js.map +1 -1
  115. package/dist/coverage-presentation.d.ts +6 -0
  116. package/dist/coverage-presentation.d.ts.map +1 -0
  117. package/dist/coverage-presentation.js +34 -0
  118. package/dist/coverage-presentation.js.map +1 -0
  119. package/dist/custom-publish.js +2 -2
  120. package/dist/custom-publish.js.map +1 -1
  121. package/dist/custom-validation-prompt.js +5 -5
  122. package/dist/custom-validation-prompt.js.map +1 -1
  123. package/dist/custom-validation.d.ts.map +1 -1
  124. package/dist/custom-validation.js +47 -19
  125. package/dist/custom-validation.js.map +1 -1
  126. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  127. package/dist/deduplication/checkpointed-review.js +3 -1
  128. package/dist/deduplication/checkpointed-review.js.map +1 -1
  129. package/dist/deduplication/codex-review.d.ts.map +1 -1
  130. package/dist/deduplication/codex-review.js +2 -2
  131. package/dist/deduplication/codex-review.js.map +1 -1
  132. package/dist/deduplication/deduplication-prompts.d.ts +1 -0
  133. package/dist/deduplication/deduplication-prompts.d.ts.map +1 -1
  134. package/dist/deduplication/deduplication-prompts.js +3 -0
  135. package/dist/deduplication/deduplication-prompts.js.map +1 -1
  136. package/dist/deduplication/records-protocol.d.ts.map +1 -1
  137. package/dist/deduplication/records-protocol.js +21 -1
  138. package/dist/deduplication/records-protocol.js.map +1 -1
  139. package/dist/deduplication/scan.d.ts.map +1 -1
  140. package/dist/deduplication/scan.js +9 -7
  141. package/dist/deduplication/scan.js.map +1 -1
  142. package/dist/endor-findings.d.ts +4 -3
  143. package/dist/endor-findings.d.ts.map +1 -1
  144. package/dist/endor-findings.js +16 -11
  145. package/dist/endor-findings.js.map +1 -1
  146. package/dist/external-findings-import.d.ts.map +1 -1
  147. package/dist/external-findings-import.js +13 -5
  148. package/dist/external-findings-import.js.map +1 -1
  149. package/dist/external-findings-local.d.ts +1 -0
  150. package/dist/external-findings-local.d.ts.map +1 -1
  151. package/dist/external-findings-local.js +14 -3
  152. package/dist/external-findings-local.js.map +1 -1
  153. package/dist/external-findings-publish.d.ts +2 -1
  154. package/dist/external-findings-publish.d.ts.map +1 -1
  155. package/dist/external-findings-publish.js +64 -28
  156. package/dist/external-findings-publish.js.map +1 -1
  157. package/dist/external-findings-read.d.ts +12 -1
  158. package/dist/external-findings-read.d.ts.map +1 -1
  159. package/dist/external-findings-read.js +25 -6
  160. package/dist/external-findings-read.js.map +1 -1
  161. package/dist/external-findings.d.ts +2 -0
  162. package/dist/external-findings.d.ts.map +1 -1
  163. package/dist/external-findings.js.map +1 -1
  164. package/dist/external-import-contract.d.ts +7 -1
  165. package/dist/external-import-contract.d.ts.map +1 -1
  166. package/dist/external-import-contract.js +63 -31
  167. package/dist/external-import-contract.js.map +1 -1
  168. package/dist/external-imports-feature.d.ts +6 -0
  169. package/dist/external-imports-feature.d.ts.map +1 -0
  170. package/dist/external-imports-feature.js +51 -0
  171. package/dist/external-imports-feature.js.map +1 -0
  172. package/dist/finding-workflow.d.ts +24 -5
  173. package/dist/finding-workflow.d.ts.map +1 -1
  174. package/dist/finding-workflow.js +24 -9
  175. package/dist/finding-workflow.js.map +1 -1
  176. package/dist/github-advisories.d.ts.map +1 -1
  177. package/dist/github-advisories.js +3 -1
  178. package/dist/github-advisories.js.map +1 -1
  179. package/dist/github-findings.d.ts +4 -3
  180. package/dist/github-findings.d.ts.map +1 -1
  181. package/dist/github-findings.js +16 -14
  182. package/dist/github-findings.js.map +1 -1
  183. package/dist/host-protocol.d.ts +1 -1
  184. package/dist/host-protocol.d.ts.map +1 -1
  185. package/dist/host-protocol.js +2 -2
  186. package/dist/host-protocol.js.map +1 -1
  187. package/dist/hosted-remediation.d.ts.map +1 -1
  188. package/dist/hosted-remediation.js +19 -2
  189. package/dist/hosted-remediation.js.map +1 -1
  190. package/dist/hosted-scan.d.ts +1 -1
  191. package/dist/hosted-scan.d.ts.map +1 -1
  192. package/dist/hosted-scan.js +0 -6
  193. package/dist/hosted-scan.js.map +1 -1
  194. package/dist/import-scan.js +17 -17
  195. package/dist/import-scan.js.map +1 -1
  196. package/dist/index.d.ts +4 -3
  197. package/dist/index.d.ts.map +1 -1
  198. package/dist/index.js +2 -1
  199. package/dist/index.js.map +1 -1
  200. package/dist/knowledge-base.d.ts +1 -0
  201. package/dist/knowledge-base.d.ts.map +1 -1
  202. package/dist/knowledge-base.js +20 -8
  203. package/dist/knowledge-base.js.map +1 -1
  204. package/dist/mock-scan.d.ts +1 -2
  205. package/dist/mock-scan.d.ts.map +1 -1
  206. package/dist/mock-scan.js +12 -17
  207. package/dist/mock-scan.js.map +1 -1
  208. package/dist/models.d.ts +10 -1
  209. package/dist/models.d.ts.map +1 -1
  210. package/dist/models.js.map +1 -1
  211. package/dist/multiscan.d.ts.map +1 -1
  212. package/dist/multiscan.js +1 -6
  213. package/dist/multiscan.js.map +1 -1
  214. package/dist/native-json-findings.d.ts +30 -0
  215. package/dist/native-json-findings.d.ts.map +1 -0
  216. package/dist/native-json-findings.js +114 -0
  217. package/dist/native-json-findings.js.map +1 -0
  218. package/dist/opengrep-findings.d.ts +10 -0
  219. package/dist/opengrep-findings.d.ts.map +1 -0
  220. package/dist/opengrep-findings.js +198 -0
  221. package/dist/opengrep-findings.js.map +1 -0
  222. package/dist/owner-evidence.d.ts +2 -0
  223. package/dist/owner-evidence.d.ts.map +1 -1
  224. package/dist/owner-evidence.js +2 -1
  225. package/dist/owner-evidence.js.map +1 -1
  226. package/dist/patch-tui.d.ts.map +1 -1
  227. package/dist/patch-tui.js +2 -0
  228. package/dist/patch-tui.js.map +1 -1
  229. package/dist/publication.js +1 -2
  230. package/dist/publication.js.map +1 -1
  231. package/dist/publish.d.ts +2 -0
  232. package/dist/publish.d.ts.map +1 -1
  233. package/dist/publish.js +1 -1
  234. package/dist/publish.js.map +1 -1
  235. package/dist/record.d.ts +1 -0
  236. package/dist/record.d.ts.map +1 -1
  237. package/dist/record.js +10 -0
  238. package/dist/record.js.map +1 -1
  239. package/dist/remediation.d.ts +1 -25
  240. package/dist/remediation.d.ts.map +1 -1
  241. package/dist/remediation.js +3 -24
  242. package/dist/remediation.js.map +1 -1
  243. package/dist/result.d.ts +5 -3
  244. package/dist/result.d.ts.map +1 -1
  245. package/dist/result.js +9 -6
  246. package/dist/result.js.map +1 -1
  247. package/dist/runtime.d.ts.map +1 -1
  248. package/dist/runtime.js +7 -7
  249. package/dist/runtime.js.map +1 -1
  250. package/dist/scan-dashboard.d.ts +5 -3
  251. package/dist/scan-dashboard.d.ts.map +1 -1
  252. package/dist/scan-dashboard.js +79 -26
  253. package/dist/scan-dashboard.js.map +1 -1
  254. package/dist/scan-history-renderer.d.ts.map +1 -1
  255. package/dist/scan-history-renderer.js +9 -3
  256. package/dist/scan-history-renderer.js.map +1 -1
  257. package/dist/scan-owner-suggestions.d.ts +1 -1
  258. package/dist/scan-owner-suggestions.d.ts.map +1 -1
  259. package/dist/scan-owner-suggestions.js +4 -4
  260. package/dist/scan-owner-suggestions.js.map +1 -1
  261. package/dist/scan-usage-display.d.ts +8 -0
  262. package/dist/scan-usage-display.d.ts.map +1 -0
  263. package/dist/scan-usage-display.js +46 -0
  264. package/dist/scan-usage-display.js.map +1 -0
  265. package/dist/scanner-import.d.ts +1 -1
  266. package/dist/scanner-import.d.ts.map +1 -1
  267. package/dist/scanner-import.js +7 -3
  268. package/dist/scanner-import.js.map +1 -1
  269. package/dist/security-policy.d.ts.map +1 -1
  270. package/dist/security-policy.js +17 -22
  271. package/dist/security-policy.js.map +1 -1
  272. package/dist/semgrep-findings.d.ts +4 -3
  273. package/dist/semgrep-findings.d.ts.map +1 -1
  274. package/dist/semgrep-findings.js +22 -89
  275. package/dist/semgrep-findings.js.map +1 -1
  276. package/dist/skill-authentication.d.ts +18 -0
  277. package/dist/skill-authentication.d.ts.map +1 -0
  278. package/dist/skill-authentication.js +82 -0
  279. package/dist/skill-authentication.js.map +1 -0
  280. package/dist/snyk-findings.d.ts +5 -4
  281. package/dist/snyk-findings.d.ts.map +1 -1
  282. package/dist/snyk-findings.js +18 -17
  283. package/dist/snyk-findings.js.map +1 -1
  284. package/dist/suggest-owners.d.ts +4 -1
  285. package/dist/suggest-owners.d.ts.map +1 -1
  286. package/dist/suggest-owners.js +53 -21
  287. package/dist/suggest-owners.js.map +1 -1
  288. package/dist/targets.d.ts.map +1 -1
  289. package/dist/targets.js +4 -1
  290. package/dist/targets.js.map +1 -1
  291. package/dist/wiz-csv.d.ts +2 -1
  292. package/dist/wiz-csv.d.ts.map +1 -1
  293. package/dist/wiz-csv.js +3 -3
  294. package/dist/wiz-csv.js.map +1 -1
  295. package/dist/wiz-findings.d.ts +2 -1
  296. package/dist/wiz-findings.d.ts.map +1 -1
  297. package/dist/wiz-findings.js +27 -23
  298. package/dist/wiz-findings.js.map +1 -1
  299. package/docs/classify-severity-records.md +3 -4
  300. package/docs/cli.md +171 -41
  301. package/docs/dedupe-records.md +15 -1
  302. package/docs/findings-service.md +119 -118
  303. package/docs/hosted-remediation.md +19 -17
  304. package/docs/hosted-scans.md +37 -11
  305. package/package.json +9 -9
  306. package/_bundled_plugin/scripts/generate_in_scope_files.py +0 -277
  307. package/_bundled_plugin/scripts/generate_rank_input.py +0 -350
  308. package/_bundled_plugin/scripts/rank_preview.py +0 -129
@@ -5,113 +5,48 @@ description: Use when Codex is already in the attack-path-analysis phase of a se
5
5
 
6
6
  # Security Attack Path Analysis
7
7
 
8
- Before choosing paths or saving retained output, read `../../references/artifact-storage.md` and follow its storage policy.
8
+ Determine whether each supplied finding has a supported attacker path, what impact it has, and whether it is reportable. Before creating or retaining files, read `../../references/artifact-storage.md`.
9
9
 
10
- ## Objective
10
+ ## Establish the attack path
11
11
 
12
- Turn validated or still-plausible findings into explicit attacker stories, structured attack-path analysis facts, severity calibration, and a final reportability decision grounded in the threat model.
12
+ For a scan phase, use its per-scan threat model and candidate set from `../../references/scan-artifacts.md`. Preserve supplied input paths. If a required scan artifact is unavailable, report the missing input.
13
13
 
14
- ## Artifact Resolution
14
+ For standalone analysis, use the supplied finding, repository, threat model or security policy, and context. A per-scan artifact is not required. State material assumptions and ask for missing context only when it prevents a meaningful assessment.
15
15
 
16
- The path references in this skill are the default locations for this phase.
17
- If the user explicitly provides a different path for a required input or output, use the user-provided path instead of the corresponding default path referenced in this skill.
18
- If a required input is still missing, stop and ask the user for it before continuing.
19
- Use the shared scan artifact path conventions in `../../references/scan-artifacts.md`.
16
+ 1. Establish the in-scope attacker, affected product surface, entry point, controlled input, security boundary, and sensitive operation. Trace the path from repository evidence.
17
+ 2. Identify relevant controls and the strongest counterevidence. Explain what they establish, which prerequisites remain, and whether the exact claimed boundary is crossed.
18
+ 3. Assess impact and likelihood from those facts, then apply [references/severity-policy.md](references/severity-policy.md). Keep facts, severity calibration, and the final policy decision distinguishable in the result.
19
+ 4. Return an explicit decision for every eligible candidate, including ignored or deferred candidates. Do not replace a supported instance with a neighboring finding or lose its root-control location.
20
+
21
+ Use repository evidence and explicitly supplied context. Access the network only when the user has expressly authorized it; an offline scan never accesses the network. Do not invent unsupported attack chains. Missing deployment or public-ingress evidence can limit confidence without defeating an otherwise supported finding.
22
+
23
+ ## Scan integration
20
24
 
21
25
  Standard scans and Deep Scan workers assess attack paths within their ordinary Standard scan workflow; neither invokes this separate phase skill.
22
26
 
23
- ### Compact Workbench-Backed Diff Mode
24
-
25
- When a workbench-backed `$security-diff-scan` has a `scanId`, load the per-scan threat model and read the validated candidates with `list_codex_security_candidates({ scanId, cursor?, limit? })`. Analyze every `reportable` or `deferred` candidate, preserve every discovery and validation field and the original candidate order, and submit all decisions together with one `record_candidate_attack_paths({ scanId, attackPaths: [{ candidateId, attackPath }] })` call. Submit `attackPaths: []` when no candidate enters this phase. The existing tool atomically updates the stored candidates; do not create per-finding reports, receipts, or manual candidate ledgers in this compact diff mode. Keep attack-path facts, counterevidence, severity calibration, and policy adjustment as separate reasoning steps. Other scan and standalone workflows retain their existing artifact behavior.
26
-
27
- ## Workflow
28
-
29
- 1. Load the per-scan threat model path from `../../references/scan-artifacts.md` as the repo-specific threat-model source of truth. Start from this along with the potential findings. Both inputs are required for this workflow.
30
- - For repository-wide and scoped-path scans, include validation closure rows marked `reportable` or `survives: yes` even if they were not assigned polished candidate numbers during discovery.
31
- 2. Determine whether the affected code is in scope for the repository threat model and whether it belongs to a product surface or production workflow.
32
- 3. Build a factual attack path using repository evidence only:
33
- - service mapping
34
- - exposure and entry points
35
- - identity, privilege, and trust boundaries
36
- - secrets handling and sensitive-data flow
37
- - reachability
38
- - existing controls and mitigations
39
- 4. Before finalizing scope or reportability-driving facts, identify the strongest repository counterevidence against the key scoping fields and explain why it is or is not dispositive.
40
- 5. Calibrate impact and likelihood from the repository evidence.
41
- 6. Apply a separate final policy-adjustment pass mechanically using those facts and the calibrated severity.
42
- 7. Record final policy decision `ignore` explicitly; in compact diff mode, retain its candidate record for coverage, and otherwise drop it from the surviving finding set.
43
- 8. For a durable diff scan, submit the nested decision for every eligible candidate in the single compact tool call. Otherwise, save that finding's visible attack-path report and append one attack-path receipt per candidate id at the default paths from `../../references/scan-artifacts.md`. The receipt must record the candidate id, attack-path reportability decision, attack-path facts or exact proof gap, and attack-path artifact/report reference for that candidate finding.
44
-
45
- ## Scope and Attack Path Checklist
46
-
47
- Use this checklist before finalizing the attack-path facts or policy decision:
48
-
49
- - Determine whether the finding is actually a real security vulnerability rather than a correctness bug or false positive.
50
- - Determine whether the affected code belongs to a product surface or production workflow.
51
- - Map the relevant service, component, or workflow context from repository evidence.
52
- - Establish exposure and entry points from repository evidence such as listeners, ingress, load balancers, service ports, manifests, routing, or network policy.
53
- - Establish identities, privileges, and trust boundaries that matter for the path.
54
- - Establish whether sensitive data, secrets references, or privileged control paths are involved.
55
- - Determine whether a realistic attacker can actually reach and use the issue from an in-scope attack surface.
56
- - Identify the strongest repository counterevidence against the scoping and reportability-driving fields before finalizing them.
57
- - Lower confidence or keep fields unknown when repository evidence is incomplete; do not automatically suppress a finding solely because deployment evidence is missing.
58
-
59
- ## Counterevidence Checklist
60
-
61
- For the most interpretive fields, explicitly ask what repository evidence suggests the opposite and why it does or does not defeat the finding:
62
-
63
- - In-Scope Status According to the Threat Model
64
- - Vector
65
- - Auth Scope
66
- - Exposure
67
- - Cross-Boundary Behavior
68
- - Preconditions
69
- - Impact Surface
70
-
71
- Look specifically for repository evidence that the path is:
72
-
73
- - out of scope
74
- - internal-only
75
- - admin-only
76
- - not cross-boundary
77
- - not attacker-reachable
78
- - not meaningfully reportable
79
-
80
- ## Severity and Policy Checklist
81
-
82
- Apply severity and policy calibration using `references/severity-policy.md`.
83
-
84
- ## Output Contract
85
-
86
- In compact diff mode, every candidate with validation disposition `reportable` or `deferred` must receive exactly one nested attack-path decision. The recorded decisions are the complete phase output; do not also create narrative reports or receipts. Otherwise, use the following report contract.
87
-
88
- For each surviving finding include:
89
-
90
- - title
91
- - candidate id, instance key, and ledger row id when provided
92
- - affected lines from validation, preserving labeled entrypoint/wrapper, root_control, sink, and concrete_implementation locations
93
- - attack path steps
94
- - rendered attack-path facts
95
- - counterevidence summary and challenges
96
- - severity calibration
97
- - final policy decision
98
- - enough reasoning that a later reader can understand why the finding survived or was suppressed
99
-
100
- Render attack-path facts using `references/attack-path-facts.md`.
101
-
102
- ## Hard Rules
103
-
104
- - Use repository evidence and explicitly supplied context. Access the network only when the user has expressly authorized that access; an offline scan never accesses the network.
105
- - Do not invent attack chains that the code does not support.
106
- - Do not leave candidate coverage implicit. In compact diff mode, record a nested attack-path decision for every eligible candidate, even when the final policy decision is `ignore` or `deferred`. Otherwise, every candidate that reaches attack-path analysis must leave an attack-path receipt in its candidate-ledger path from `../../references/scan-artifacts.md`.
107
- - Do not drop exact affected locations while converting validated findings into attack paths. Repository-wide seeded/root-control rows that survive validation must keep their root-control file:line even when a wrapper, route, or transport is easier to explain.
108
- - Do not skip a reportable validation row because a neighboring same-family finding has a cleaner story. Either produce attack-path facts for that exact row or make an explicit final policy decision with repository counterevidence.
109
- - Missing public-ingress evidence is not by itself dispositive counterevidence.
110
- - Keep attack-path analysis, severity calibration, and final policy suppression as separate sub-stages.
111
- - Use the final policy-adjustment matrix mechanically rather than re-arguing severity from scratch after the facts are set.
112
- - Outside compact diff mode, save a final visible report for each candidate finding using that finding's attack-path analysis report path from `../../references/scan-artifacts.md`.
113
-
114
- -- Considerations for attack path --
115
-
116
- - A bug matters if evidence shows an attacker could exploit it.
117
- - The attack surface should generally be one that is plausibly exposed to end users / external actors (or another actor explicitly in scope in the threat model).
27
+ ### Compact Workbench Diff
28
+
29
+ When a workbench-backed `$security-diff-scan` has a `scanId`:
30
+
31
+ - Load the per-scan threat model and all validated candidates with `list_codex_security_candidates({ scanId, cursor?, limit? })`.
32
+ - Analyze every `reportable` or `deferred` validation candidate. Preserve candidate identity and existing discovery and validation fields.
33
+ - Submit every decision together with `record_candidate_attack_paths({ scanId, attackPaths: [{ candidateId, attackPath }] })`. Submit `attackPaths: []` when no candidate enters this phase. The tool preserves the stored candidate order.
34
+ - These nested decisions are the complete phase output. Do not create duplicate reports, receipts, or manual ledgers.
35
+
36
+ ### Other phase-based scans
37
+
38
+ Use the active workflow's report and receipt paths in `../../references/scan-artifacts.md`. Every candidate entering this phase must have an explicit decision and a receipt with its ID, facts or exact proof gap, and report reference. Record ignored candidates before excluding them from the surviving finding set.
39
+
40
+ For repository-wide or scoped-path scans, include validation closure rows marked `reportable` or `survives: yes`, even if discovery did not assign a polished finding number. Preserve affected entrypoint/wrapper, root-control, sink, and concrete-implementation locations supplied by validation.
41
+
42
+ ## Output
43
+
44
+ For standalone analysis, follow the caller's format or return a concise assessment per finding. Scan phases use their output contract above. Include:
45
+
46
+ - title and supplied candidate, instance, and ledger identities;
47
+ - precise affected locations and attacker-to-impact steps;
48
+ - relevant facts from [references/attack-path-facts.md](references/attack-path-facts.md);
49
+ - controls, counterevidence, prerequisites, and material proof gaps;
50
+ - impact, likelihood, calibrated severity, and final policy decision with their reasons.
51
+
52
+ Retain enough evidence to explain both surviving and suppressed findings. Apply the severity policy to the established facts rather than reopening discovery or substituting a different attack story.
@@ -1,76 +1,14 @@
1
- # Attack Path Facts Guidance
1
+ # Attack Path Facts
2
2
 
3
- Use this guidance during attack-path analysis before severity calibration.
3
+ Use these fields to explain the path and the reportability decision. Record unknowns explicitly when they matter. Follow the calling workflow's schema; in narrative output, use concise bullets or paragraphs rather than repeating the same evidence under several headings.
4
4
 
5
- ## Attack Path Facts
5
+ - **Scope and context:** the affected component, applicable threat-model boundary, whether the impact is self-only or crosses a meaningful boundary, and the evidence.
6
+ - **Attack path:** attacker-controlled input, numbered attacker steps, sensitive operation, and the evidence connecting them.
7
+ - **Exposure and vector:** public, internal, or admin-only access; `remote`, `local_network`, `localhost`, `none`, or `unknown`; relevant routing or deployment evidence when available.
8
+ - **Identity and preconditions:** effective privileges, required attacker position or capabilities, plausibility of those prerequisites, and assumptions.
9
+ - **Impact:** vulnerability category, affected runtime/data/identity/build/network surface, target reach, and any involved secret type or reference chain.
10
+ - **Controls and counterevidence:** effective mitigations, the strongest evidence against the claimed path or scope, and why it does or does not defeat the finding.
11
+ - **Uncertainty:** confidence, missing facts, and conditions that would change the assessment.
12
+ - **Decision:** impact and likelihood reasoning, calibrated severity, and final policy decision.
6
13
 
7
- The attack-path facts should be gathered in structured form during analysis, but the final report should render them as markdown under a section such as `### Attack Path Facts` or a similarly clear heading.
8
-
9
- That rendered facts section should explicitly cover:
10
-
11
- - Assumptions
12
- - Context:
13
- - whether the impact is self-only or crosses a meaningful boundary
14
- - the repository evidence for that conclusion
15
- - In-Scope Status According to the Threat Model:
16
- - whether the component is in scope
17
- - the reasoning
18
- - Exposure:
19
- - whether the surface is public
20
- - ports, ingress, and load-balancer type when repository evidence exists
21
- - the evidence
22
- - Identity:
23
- - service account or managed identity if present
24
- - effective privileges
25
- - Cross-Boundary Behavior:
26
- - whether a boundary crossing is actually verified
27
- - the evidence chain
28
- - Vector:
29
- - `remote`, `local_network`, `localhost`, `none`, or `unknown`
30
- - the evidence
31
- - Preconditions:
32
- - what the attacker needs
33
- - whether those preconditions are plausible, unlikely, unachievable, or unknown
34
- - the evidence
35
- - Attacker Input Control:
36
- - whether attacker control is yes, plausible, no, or unknown
37
- - the evidence
38
- - Category
39
- - Mitigations Already Present
40
- - Auth Scope:
41
- - whether the path is public, internal-only, admin-only, or unknown
42
- - the evidence
43
- - Impact Surface:
44
- - build, runtime, data, identity, network, or other
45
- - the evidence
46
- - Target Reach:
47
- - single service, base image, fleet, or unknown
48
- - the evidence
49
- - Secrets References:
50
- - the secret type and reference chain when present
51
- - Counterevidence:
52
- - the strongest conflicting repository evidence for the reportability-driving facts
53
- - why that evidence is or is not dispositive
54
- - Blindspots
55
- - Controls
56
- - Confidence
57
-
58
- Prefer turning those facts into readable bullets or short labeled paragraphs instead of exposing a raw schema dump. The final report should make the scoping and reportability facts easy to inspect, including:
59
-
60
- - whether the finding is in scope according to the threat model
61
- - whether the surface is public, internal, admin-only, localhost-only, or unknown
62
- - what attacker-controlled input exists
63
- - what preconditions the attacker needs and whether they are achievable
64
- - whether a real trust boundary is crossed
65
- - what identities, privileges, or secrets are involved
66
- - what mitigations and controls already exist
67
- - what the strongest repository counterevidence is
68
- - what blindspots or residual uncertainty remain
69
-
70
- Also make sure the rendered report carries forward:
71
-
72
- - the factual attack path as numbered attacker steps
73
- - the reachability and scoping logic
74
- - the strongest conflicting repository evidence
75
- - the final policy decision after suppression
76
- - the reasoning behind impact and likelihood
14
+ Keep attack-path facts distinct from severity and suppression decisions. Preserve precise source locations and identifiers supplied by validation.
@@ -1,121 +1,62 @@
1
1
  # Severity and Policy Guidance
2
2
 
3
- Use this guidance after attack-path facts, reachability, and counterevidence are established.
4
-
5
- -- Considerations for severity / criticality re-rating --
6
-
7
- - For `high` and above, the impact must be materially security-relevant (for example: account takeover, auth bypass, meaningful privilege escalation, significant sensitive data exposure/exfiltration, credible RCE, or similarly severe compromise), not simply a bug or strange behavior
8
- - For a finding to remain `high` or `critical`, the exploitation path and impact should be clear enough that a professional security reviewer would not need a long speculative argument to justify it.
9
- - Do **not** treat ordinary code bugs as high/critical security issues just because they are bugs or because the scanner labeled them that way.
10
- - Do **not** keep `critical` based on contrived, highly speculative, or edge-case-only exploit stories unless the threat model explicitly supports those conditions. Critical DEMANDS attention implying an immediate likely threat.
11
- - Do **not** keep `high`/`critical` for strange configurations or odd codebase behaviors unless there is clear evidence that an in-scope attacker can realistically exploit them for major impact.
12
- - Do **not** rely on unusual operator mistakes, internal-only access, or non-attacker-reachable code paths to justify severe external impact unless the repository threat model says those actors/paths are in scope.
13
- - If the issue is a real bug but not actually a security vulnerability, classify it as `ignore` (or, if you have to, `low`) for criticality purposes.
14
- - If it is actually provable that there is no bug at all (the description is entirely wrong or made up and you actually got that real proof that it is so), then label it as `ignore` for criticality to mark a false-positive.
15
-
16
- Non-exhaustive examples of vulnerabilities that often support `critical` when evidenced in code and context:
17
-
18
- - Credible RCE or arbitrary code execution (command injection, LFI exec, trivial memory corruption exploits, etc.). Requires actual proof that attacker input causes this from an in-scope attack surface.
19
- - Real XSS with meaningful proven impact (for example session/token theft, account compromise, privileged action execution, etc)
20
- - Account takeover or strong authentication bypass, especially if it is 0-click
21
- - Missing authorization checks / authorization bypass / tenant-boundary break (trivial IDOR, easy to swap out org or use ids with no authz, etc)
22
- - Severe sensitive data leak (LFI, path traversal, bad scoping of file downloads, access to data without authorization, trivial side-channels) with realistic attacker access (proof the attacker can read secrets, PII, signing keys, credential stores, private keys, classified or highly confidential information (model weights etc))
23
- - Trivial memory corruption exploits with known exploit patterns which require little effort to exploit
24
- - SQL or other Database or query injection with clear proof of path from attacker input from in-scope attack surface and impact of the injection (leaks sensitive data, inserts dangerous records)
25
- - Sandbox, container, VM, browser, or interpreter escape that breaks an intended isolation boundary
26
- - Server-side template injection when it leads to RCE or leaking of secrets, with actual proof that the templating library can be exploited to do this (RCE escape or secrets/credentials in scope) and that this can be reached from an in-scope attack surface
27
- - Arbitrary file write in executable, startup, config, or firmware paths with a realistic path to persistence or code execution. Requires proof that an attacker can actually trigger this from in-scope attack surface.
28
- - Logic flaws that allow irreversible or broad compromise of integrity at scale, such as unauthenticated deletion of other users' data, cross-tenant tampering with sensitive records, or unauthorized modification of security-critical configuration, when the impact is clearly demonstrated and severe enough to be compromise-equivalent; when there is actual proof that this logic can be exercised from in-scope attack-surface.
29
- - etc, other bugs not listed which follow this level of critical severity and impact; with actual proof that these bugs are reachable from in-scope attack-surface.
30
-
31
- Non-exhaustive examples of vulnerabilities that often support `high` when evidenced in code and context:
32
-
33
- - Server Side Request Forgery where there is actual proof that (1) an attacker can control the url being requested (bypassing protections around that) from in-scope attack-surface and (2) there are likely other local/lan/cloud services which can be reached to show actual impact. Be careful with reporting webhooks unless there is clear proof that it is dangerous, but do not treat a product-intended webhook/download/callback feature or optional operator allow/deny list as suppression evidence when attacker-controlled destinations can still reach internal, metadata, file-backed, redirect, or side-effecting targets.
34
- - Exploitable memory corruption with clear, major impact or ease of exploitation
35
- - Arbitrary file read that exposes less-sensitive user data or source code (if you have actual proof it reveals env secrets, then it is critical)
36
- - Arbitrary file write in executable, startup, config, or firmware paths with a realistic path to persistence or code execution
37
- - CSRF when it enables important state-changing actions such as credential changes, permission changes, payment / billing changes, or security-setting changes with realistic victim interaction. Evaluate actual browser request behavior, credential attachment, cookie policy, preflight requirements, server parsing, and effective anti-CSRF controls; an HTTP method or JSON content type alone is not a categorical defense.
38
- - Hardcoded or default credentials that are valid, reachable, and provide meaningful access warranting `high`, even when that access is not broad or privileged enough for `critical`.
39
- - Cryptographic failures that allow signature forgery, token forgery, trusted artifact forgery, secure-channel bypass, or decryption of highly sensitive data in a way that directly enables compromise, with actual proof that these attacks are practical and can be carried out from an in-scope attack surface.
40
- - Supply-chain or update-channel compromise that allows malicious code or malicious trusted artifacts to be delivered to users, servers, agents, or endpoints, including signing bypass or package source substitution with real impact. This should focus on actual supply-chain risk and risk around CI actions, not just "does npm report outdated packages"
41
- - Authorization bypass, IDOR, or privilege escalation that exposes or modifies meaningful sensitive data or privileged functionality, but is narrower in scope, limited to a smaller set of objects, limited to same-tenant boundaries, or otherwise less catastrophic than the critical cases above.
42
- - XXE with clear proof that an attacker can control the XML document through in-scope attack-surface and that the XML engine is vulnerable to XXE
43
- - etc, other bugs not listed which follow this level of high severity and impact; with actual proof that these bugs are reachable from in-scope attack-surface.
44
- - Dangerous upload / file handling issues that enable stored active content, trusted-origin script execution, or meaningful content-type confusion with real security impact; with actual proof that both the upload and access are reachable through in-scope attack-surface.
45
- - Deserialization, SSTI, plugin abuse, macro / template abuse, or interpreter abuse where dangerous primitives are clearly reachable and impactful, but code execution or compromise is not fully proven to the standard needed for critical.
46
-
47
- Strong factors that often push a plausible `high` up to `critical`:
48
-
49
- - Unauthenticated or near-unauthenticated reachability from the internet or other broad in-scope surfaces.
50
- - 0-click or extremely low-friction exploitation.
51
- - Cross-tenant / cross-boundary impact rather than same-user or same-tenant impact.
52
- - Direct compromise of signing, identity, control-plane, or cloud credentials.
53
- - Realistic persistence, mass exploitation, wormability, or compromise of many victims at once.
54
- - Clear proof of code execution, full account takeover, or crown-jewel secret access rather than only a plausible path.
55
-
56
- Examples that usually should not remain `high`/`critical` without very strong proof of it leading to the class of vulnerabilities above:
57
-
58
- - Generic correctness/reliability bugs
59
- - Strange edge cases with unclear attacker value
60
- - Low-impact information leaks
61
- - Internal-only defects without attacker reachability
62
- - The report shows a bug class in isolation, but not a realistic exploit path.
63
- - The issue requires the attacker to already have privileged, admin, root, console, shell, or code-execution access.
64
- - "Could maybe matter if chained with many assumptions" arguments
65
- - Self-XSS without a victim or meaningful boundary crossing, or XSS whose actual origin, browser reachability, and impact do not justify `high`/`critical`. An `alert` proof demonstrates JavaScript execution and is not evidence against reflected XSS.
66
- - SQLi or other injection claims with no demonstrated attacker control, no shown sink reachability, or only speculative impact.
67
- - CSRF on low-impact actions, cosmetic actions, logout, preferences, or actions requiring unrealistic victim behavior.
68
- - Open redirect, clickjacking, user enumeration, rate-limit weakness, banner leakage, version disclosure, directory listing, stack traces, internal hostnames, or basic error-message leakage, unless they are shown as part of a serious exploit chain.
69
- - Memory corruption that is theoretical, non-triggerable from in-scope input, or not plausibly exploitable in the target environment.
70
- - Missing headers, cookie flags, CSP weaknesses, TLS observations, or crypto hygiene issues without a concrete exploit path and meaningful demonstrated impact.
71
- - Reports that effectively say "this could be dangerous if combined with something else" but do not show the something else.
72
- - Denial of service that is transient, single-user, self-targeting, easy to mitigate, requires disproportionate attacker resources, or does not create severe and realistic business / safety impact.
73
- - Authz findings that require already having the same privilege as the victim, or only expose trivial metadata.
74
- - Bugs that already require admin/root/shell access unless the privilege-escalation delta itself is the issue being reported.
75
- - Arbitrary file read limited to public files, low-sensitivity files, or source fragments with no realistic security consequence.
76
-
77
- High/Critical acceptance checklist (all should be true, unless the threat model strongly justifies an exception):
78
-
79
- - In-scope component
80
- - Realistic attacker
81
- - Reasonable in-scope attack surface
82
- - Credible exploitation path (not simply speculation)
83
- - Major security impact
84
- - Would likely be accepted as `high`/`critical` (not informational/low) in serious audit or bug bounty triage by a major auditing firm who puts their reputation on the line.
85
-
86
- ## Severity and Policy Checklist
87
-
88
- Apply severity adjustment only after scope, reachability, and counterevidence are established. Do not reopen discovery here.
89
-
90
- Start from the candidate's original severity hypothesis, then adjust it using the repository-evidenced facts from this phase.
91
-
92
- Severity adjustment guidance:
93
-
94
- - Keep `critical` only when the attack path, reachability, and impact are all clear enough that the finding would demand immediate attention.
95
- - Keep `high` only when there is a realistic in-scope attacker path and major security impact without a long speculative chain.
96
- - Downgrade when the path is real but constrained to narrower objects, same-tenant impact, internal-only surfaces, or other materially limiting conditions.
97
- - Reduce severity when the path is localhost-only, self-only, highly constrained, dependent on unrealistic preconditions, or already requires privileged access unless the privilege-escalation delta is the issue.
98
- - Dangerous sink, scary bug class, or sensitive code area alone is not enough to preserve high severity.
99
- - If the issue is a real bug but not meaningfully reportable as a security problem in context, set the final policy decision to `ignore`.
100
- - Do not discard an otherwise reportable finding solely because its impact or likelihood is `low`; downgrade its severity instead.
101
-
102
- Final policy-adjustment guidance:
103
-
104
- - Apply hard suppression first:
105
- - self-only impact -> `ignore`
106
- - unachievable or highly unrealistic preconditions -> `ignore`
107
- - privileged-only, operator-only, developer-only, physical-access-only, or protected-write-path preconditions -> `ignore`, unless the privilege-escalation delta itself is the issue
108
- - Then weight likelihood using the established network scope:
109
- - `remote` usually supports high likelihood when the attacker position is realistic and in scope
110
- - `local_network` usually supports medium likelihood unless the evidence is stronger or weaker
111
- - `localhost` usually supports low likelihood unless a lower-privileged attacker can realistically reach that listener
112
- - `none` does not increase likelihood based on exposure
113
- - Then decide reportability using the existing facts:
114
- - if repository evidence does not establish a realistic lower-privileged in-scope attacker path, set `ignore`
115
-
116
- Do not suppress solely because the surface is private or internal when repository evidence still shows a meaningful authorization, trust-boundary, identity, or security-control regression in a real product or production-service workflow. In those cases, internal exposure should usually reduce likelihood or confidence rather than force `ignore`.
117
-
118
- Use missing deployment or ingress evidence to lower confidence or keep fields unknown when appropriate; do not automatically defeat an otherwise well-evidenced finding on that basis alone.
3
+ Apply this policy after establishing the attack path, scope, and counterevidence. Start from the candidate's severity hypothesis and adjust it using repository-supported impact, likelihood, prerequisites, and mitigations. Do not reopen discovery during calibration.
4
+
5
+ ## Severity criteria
6
+
7
+ Reserve `critical` for a realistic in-scope path to severe compromise that requires immediate attention. Use `high` for a realistic attacker path with major security impact. A bug class, dangerous sink, unusual configuration, or scanner label alone does not establish either level.
8
+
9
+ Evidence that can support `critical` includes:
10
+
11
+ - arbitrary code execution or readily exploitable memory corruption;
12
+ - account takeover, strong authentication bypass, or XSS that enables account compromise or privileged actions;
13
+ - broad authorization or tenant-boundary failure;
14
+ - access to highly sensitive data, signing keys, private keys, credential stores, or similarly valuable secrets;
15
+ - query injection that exposes sensitive data or creates dangerous records;
16
+ - sandbox, container, VM, browser, or interpreter escape;
17
+ - server-side template execution that enables code execution or secret access;
18
+ - arbitrary file writes with a realistic path to persistence or execution;
19
+ - irreversible or broad integrity compromise, such as cross-tenant deletion or unauthorized changes to security-critical configuration.
20
+
21
+ These examples require evidence of attacker control, an in-scope reachable path, and the claimed impact. Unauthenticated reachability, low-friction exploitation, cross-tenant effects, identity or signing compromise, persistence, and mass exploitation can support raising an otherwise plausible `high` to `critical`.
22
+
23
+ Evidence that can support `high` includes:
24
+
25
+ - SSRF with attacker-controlled destinations and meaningful internal, metadata, file-backed, or side-effecting access;
26
+ - exploitable memory corruption with major impact;
27
+ - unauthorized reads of meaningful user data or source code, with highly sensitive secret exposure considered for `critical`;
28
+ - file writes with a realistic execution or persistence path;
29
+ - CSRF that enables sensitive state changes with realistic victim interaction;
30
+ - valid, reachable hardcoded or default credentials granting meaningful access;
31
+ - practical cryptographic failures enabling forgery, secure-channel bypass, or sensitive-data decryption;
32
+ - update or supply-chain compromise delivering malicious code or trusted artifacts;
33
+ - authorization or privilege failures with meaningful but narrower object or same-tenant impact;
34
+ - exploitable XXE;
35
+ - uploads enabling stored active content, trusted-origin script execution, or consequential content-type confusion;
36
+ - reachable deserialization, template, plugin, macro, or interpreter primitives with demonstrated impact but without the proof needed for `critical`.
37
+
38
+ For SSRF, a documented outbound-request feature or optional operator filter does not defeat a demonstrated destination-control bypass. For CSRF, evaluate browser credential attachment, cookie policy, preflight, request parsing, and effective controls; method or JSON content type alone is not a categorical defense. For XSS, distinguish self-only effects from victim impact; an `alert` reproduction proves script execution but does not alone establish the severity.
39
+
40
+ Constrained, same-tenant, internal, localhost, self-only, or already-privileged paths generally reduce severity unless the threat model or privilege gained supports greater impact. Ordinary correctness bugs, low-impact information leaks, speculative injection or memory-corruption claims, security-header or crypto-hygiene observations, and transient or self-targeting denial of service do not warrant `high` or `critical` without a demonstrated severe consequence. Evaluate the actual privilege delta and boundary crossing.
41
+
42
+ ## Reportability
43
+
44
+ - Set `ignore` for a disproved finding or a bug without a meaningful security impact.
45
+ - Do not discard a real, reportable finding solely because its impact or likelihood is low; use the corresponding lower severity.
46
+ - Apply hard suppression to self-only impact or unachievable/highly unrealistic prerequisites.
47
+ - Privileged-only, operator-only, developer-only, physical-access-only, or protected-write-path prerequisites imply `ignore` unless a privilege-escalation delta is the issue.
48
+ - If repository evidence does not establish a realistic lower-privileged in-scope attacker path, set `ignore`.
49
+
50
+ Private or internal exposure alone does not suppress a supported authorization, identity, trust-boundary, or security-control failure in a real product or production workflow. Missing deployment or ingress evidence can lower confidence or leave facts unknown without defeating an otherwise supported finding.
51
+
52
+ Weight likelihood using the established attacker position and exposure:
53
+
54
+ - `remote` usually supports high likelihood when the attacker position is realistic and in scope;
55
+ - `local_network` usually supports medium likelihood unless the evidence supports a different level;
56
+ - `localhost` usually supports low likelihood unless a lower-privileged attacker can realistically reach the listener;
57
+ - `none` does not increase likelihood based on exposure.
58
+
59
+ ## Calibration matrix
119
60
 
120
61
  Severity calibration and final policy-adjustment matrix:
121
62