@openai/codex-security 0.5.1 → 0.7.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 (313) hide show
  1. package/README.md +151 -36
  2. package/_bundled_plugin/.mcp.json +1 -0
  3. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  4. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  5. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +1 -1
  6. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  7. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  8. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  9. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  10. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  12. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  13. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  14. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  15. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  16. package/_bundled_plugin/references/access-advisory.md +11 -0
  17. package/_bundled_plugin/references/core-scan.md +30 -77
  18. package/_bundled_plugin/references/final-report.md +45 -189
  19. package/_bundled_plugin/references/scan-contract.md +2 -0
  20. package/_bundled_plugin/references/scan-prologue.md +1 -1
  21. package/_bundled_plugin/references/scan-runtime.md +1 -5
  22. package/_bundled_plugin/references/threat-model.md +33 -41
  23. package/_bundled_plugin/schemas/coverage.schema.json +12 -1
  24. package/_bundled_plugin/schemas/scan-manifest.schema.json +1 -0
  25. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +38 -1
  26. package/_bundled_plugin/scripts/deep_scan_config.py +39 -39
  27. package/_bundled_plugin/scripts/deep_scan_workbench.py +145 -85
  28. package/_bundled_plugin/scripts/finalize_scan_contract.py +189 -57
  29. package/_bundled_plugin/scripts/report_projection.py +44 -15
  30. package/_bundled_plugin/scripts/threat_model_projection.py +4 -2
  31. package/_bundled_plugin/scripts/windows_scan_local_files.py +43 -14
  32. package/_bundled_plugin/scripts/workbench/retained_coverage.py +3218 -0
  33. package/_bundled_plugin/scripts/workbench/retained_records.py +627 -0
  34. package/_bundled_plugin/scripts/workbench/saved_coverage.py +644 -1
  35. package/_bundled_plugin/scripts/workbench/saved_outputs.py +72 -0
  36. package/_bundled_plugin/scripts/workbench/saved_sources.py +712 -0
  37. package/_bundled_plugin/scripts/workbench_cli.py +3 -0
  38. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +479 -0
  39. package/_bundled_plugin/scripts/workbench_db.py +51 -22
  40. package/_bundled_plugin/scripts/workbench_feedback.py +0 -1
  41. package/_bundled_plugin/scripts/workbench_finding_workflows.py +53 -9
  42. package/_bundled_plugin/scripts/workbench_native_indexes.py +56 -44
  43. package/_bundled_plugin/scripts/workbench_saved_results.py +641 -2387
  44. package/_bundled_plugin/scripts/workbench_scan_history.py +72 -7
  45. package/_bundled_plugin/scripts/workbench_schema.py +1 -1
  46. package/_bundled_plugin/scripts/workbench_source_scopes.py +4 -1
  47. package/_bundled_plugin/scripts/workbench_target.py +142 -17
  48. package/_bundled_plugin/scripts/workbench_validation.py +9 -2
  49. package/_bundled_plugin/shared/workbench-history-repairs.json +21 -0
  50. package/_bundled_plugin/shared/workbench-migrations.json +44 -0
  51. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +3 -14
  52. package/_bundled_plugin/skills/assess-patch-risk/references/windows-validation.md +14 -0
  53. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +38 -103
  54. package/_bundled_plugin/skills/attack-path-analysis/references/attack-path-facts.md +11 -73
  55. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +57 -116
  56. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +28 -51
  57. package/_bundled_plugin/skills/define-security-policy/SKILL.md +9 -9
  58. package/_bundled_plugin/skills/finding-discovery/SKILL.md +26 -140
  59. package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -30
  60. package/_bundled_plugin/skills/propose-security-hardening/SKILL.md +28 -218
  61. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +29 -424
  62. package/_bundled_plugin/skills/publish-findings/SKILL.md +134 -0
  63. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +6 -0
  64. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +64 -0
  65. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +12 -12
  66. package/_bundled_plugin/skills/security-scan/SKILL.md +28 -16
  67. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +11 -17
  68. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +52 -69
  69. package/_bundled_plugin/skills/threat-model/SKILL.md +16 -9
  70. package/_bundled_plugin/skills/triage-finding/SKILL.md +5 -15
  71. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -6
  72. package/_bundled_plugin/skills/validation/SKILL.md +42 -104
  73. package/_bundled_plugin/skills/validation/references/validation-guidance.md +21 -106
  74. package/_bundled_plugin/skills/verify-fix/SKILL.md +8 -4
  75. package/_bundled_plugin/skills/vulnerability-writeup/SKILL.md +21 -159
  76. package/_bundled_plugin/skills/vulnerability-writeup/references/report-format.md +18 -60
  77. package/dist/api.d.ts +8 -3
  78. package/dist/api.d.ts.map +1 -1
  79. package/dist/api.js +414 -72
  80. package/dist/api.js.map +1 -1
  81. package/dist/auth.d.ts.map +1 -1
  82. package/dist/auth.js +4 -1
  83. package/dist/auth.js.map +1 -1
  84. package/dist/classify-severity-records.d.ts +5 -2
  85. package/dist/classify-severity-records.d.ts.map +1 -1
  86. package/dist/classify-severity-records.js +40 -34
  87. package/dist/classify-severity-records.js.map +1 -1
  88. package/dist/classify-severity.d.ts +5 -1
  89. package/dist/classify-severity.d.ts.map +1 -1
  90. package/dist/classify-severity.js +20 -30
  91. package/dist/classify-severity.js.map +1 -1
  92. package/dist/cli-help.d.ts.map +1 -1
  93. package/dist/cli-help.js +1 -0
  94. package/dist/cli-help.js.map +1 -1
  95. package/dist/cli.d.ts +9 -2
  96. package/dist/cli.d.ts.map +1 -1
  97. package/dist/cli.js +802 -149
  98. package/dist/cli.js.map +1 -1
  99. package/dist/cloud-endpoint.d.ts +6 -0
  100. package/dist/cloud-endpoint.d.ts.map +1 -0
  101. package/dist/cloud-endpoint.js +51 -0
  102. package/dist/cloud-endpoint.js.map +1 -0
  103. package/dist/cloud-publish.d.ts.map +1 -1
  104. package/dist/cloud-publish.js +7 -5
  105. package/dist/cloud-publish.js.map +1 -1
  106. package/dist/component-scan.d.ts +8 -2
  107. package/dist/component-scan.d.ts.map +1 -1
  108. package/dist/component-scan.js +2 -0
  109. package/dist/component-scan.js.map +1 -1
  110. package/dist/contract.d.ts +2 -0
  111. package/dist/contract.d.ts.map +1 -1
  112. package/dist/contract.js +67 -33
  113. package/dist/contract.js.map +1 -1
  114. package/dist/cost.d.ts +18 -0
  115. package/dist/cost.d.ts.map +1 -1
  116. package/dist/cost.js +107 -12
  117. package/dist/cost.js.map +1 -1
  118. package/dist/coverage-presentation.d.ts +6 -0
  119. package/dist/coverage-presentation.d.ts.map +1 -0
  120. package/dist/coverage-presentation.js +34 -0
  121. package/dist/coverage-presentation.js.map +1 -0
  122. package/dist/custom-validation-prompt.js +3 -3
  123. package/dist/custom-validation-prompt.js.map +1 -1
  124. package/dist/custom-validation.d.ts.map +1 -1
  125. package/dist/custom-validation.js +30 -4
  126. package/dist/custom-validation.js.map +1 -1
  127. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  128. package/dist/deduplication/checkpointed-review.js +3 -1
  129. package/dist/deduplication/checkpointed-review.js.map +1 -1
  130. package/dist/deduplication/scan.d.ts.map +1 -1
  131. package/dist/deduplication/scan.js +7 -5
  132. package/dist/deduplication/scan.js.map +1 -1
  133. package/dist/default-severity-rubric.d.ts +3 -0
  134. package/dist/default-severity-rubric.d.ts.map +1 -0
  135. package/dist/default-severity-rubric.js +67 -0
  136. package/dist/default-severity-rubric.js.map +1 -0
  137. package/dist/endor-findings.d.ts +8 -0
  138. package/dist/endor-findings.d.ts.map +1 -0
  139. package/dist/endor-findings.js +238 -0
  140. package/dist/endor-findings.js.map +1 -0
  141. package/dist/external-findings-import.d.ts +5 -0
  142. package/dist/external-findings-import.d.ts.map +1 -0
  143. package/dist/external-findings-import.js +46 -0
  144. package/dist/external-findings-import.js.map +1 -0
  145. package/dist/external-findings-local.d.ts +63 -0
  146. package/dist/external-findings-local.d.ts.map +1 -0
  147. package/dist/external-findings-local.js +344 -0
  148. package/dist/external-findings-local.js.map +1 -0
  149. package/dist/external-findings-publish.d.ts +73 -0
  150. package/dist/external-findings-publish.d.ts.map +1 -0
  151. package/dist/external-findings-publish.js +721 -0
  152. package/dist/external-findings-publish.js.map +1 -0
  153. package/dist/external-findings-read.d.ts +16 -0
  154. package/dist/external-findings-read.d.ts.map +1 -0
  155. package/dist/external-findings-read.js +97 -0
  156. package/dist/external-findings-read.js.map +1 -0
  157. package/dist/external-findings.d.ts +21 -0
  158. package/dist/external-findings.d.ts.map +1 -0
  159. package/dist/external-findings.js +2 -0
  160. package/dist/external-findings.js.map +1 -0
  161. package/dist/external-import-contract.d.ts +15 -0
  162. package/dist/external-import-contract.d.ts.map +1 -0
  163. package/dist/external-import-contract.js +262 -0
  164. package/dist/external-import-contract.js.map +1 -0
  165. package/dist/external-import-models.d.ts +362 -0
  166. package/dist/external-import-models.d.ts.map +1 -0
  167. package/dist/external-import-models.js +3 -0
  168. package/dist/external-import-models.js.map +1 -0
  169. package/dist/external-imports-feature.d.ts +6 -0
  170. package/dist/external-imports-feature.d.ts.map +1 -0
  171. package/dist/external-imports-feature.js +51 -0
  172. package/dist/external-imports-feature.js.map +1 -0
  173. package/dist/finding-workflow.d.ts +23 -6
  174. package/dist/finding-workflow.d.ts.map +1 -1
  175. package/dist/finding-workflow.js +23 -10
  176. package/dist/finding-workflow.js.map +1 -1
  177. package/dist/github-advisories.d.ts +386 -0
  178. package/dist/github-advisories.d.ts.map +1 -0
  179. package/dist/github-advisories.js +133 -0
  180. package/dist/github-advisories.js.map +1 -0
  181. package/dist/github-findings.d.ts +11 -0
  182. package/dist/github-findings.d.ts.map +1 -0
  183. package/dist/github-findings.js +258 -0
  184. package/dist/github-findings.js.map +1 -0
  185. package/dist/hosted-remediation-protocol.d.ts +2 -1
  186. package/dist/hosted-remediation-protocol.d.ts.map +1 -1
  187. package/dist/hosted-remediation-protocol.js +17 -11
  188. package/dist/hosted-remediation-protocol.js.map +1 -1
  189. package/dist/hosted-remediation.d.ts +4 -0
  190. package/dist/hosted-remediation.d.ts.map +1 -1
  191. package/dist/hosted-remediation.js +22 -3
  192. package/dist/hosted-remediation.js.map +1 -1
  193. package/dist/hosted-scan.d.ts +16 -0
  194. package/dist/hosted-scan.d.ts.map +1 -1
  195. package/dist/hosted-scan.js +9 -2
  196. package/dist/hosted-scan.js.map +1 -1
  197. package/dist/import-scan.js +1 -1
  198. package/dist/import-scan.js.map +1 -1
  199. package/dist/index.d.ts +16 -3
  200. package/dist/index.d.ts.map +1 -1
  201. package/dist/index.js +9 -1
  202. package/dist/index.js.map +1 -1
  203. package/dist/knowledge-base.d.ts +1 -0
  204. package/dist/knowledge-base.d.ts.map +1 -1
  205. package/dist/knowledge-base.js +17 -8
  206. package/dist/knowledge-base.js.map +1 -1
  207. package/dist/models.d.ts +1 -0
  208. package/dist/models.d.ts.map +1 -1
  209. package/dist/models.js.map +1 -1
  210. package/dist/owner-evidence.d.ts +2 -0
  211. package/dist/owner-evidence.d.ts.map +1 -1
  212. package/dist/owner-evidence.js +2 -1
  213. package/dist/owner-evidence.js.map +1 -1
  214. package/dist/project-config-schema.d.ts +2 -0
  215. package/dist/project-config-schema.d.ts.map +1 -1
  216. package/dist/project-config-schema.js +1 -0
  217. package/dist/project-config-schema.js.map +1 -1
  218. package/dist/project-config.d.ts +1 -0
  219. package/dist/project-config.d.ts.map +1 -1
  220. package/dist/project-config.js +2 -0
  221. package/dist/project-config.js.map +1 -1
  222. package/dist/publish.d.ts +2 -0
  223. package/dist/publish.d.ts.map +1 -1
  224. package/dist/publish.js +1 -1
  225. package/dist/publish.js.map +1 -1
  226. package/dist/remediation.d.ts +7 -25
  227. package/dist/remediation.d.ts.map +1 -1
  228. package/dist/remediation.js +18 -28
  229. package/dist/remediation.js.map +1 -1
  230. package/dist/result.d.ts +4 -0
  231. package/dist/result.d.ts.map +1 -1
  232. package/dist/result.js +10 -0
  233. package/dist/result.js.map +1 -1
  234. package/dist/runtime.d.ts +1 -0
  235. package/dist/runtime.d.ts.map +1 -1
  236. package/dist/runtime.js +10 -8
  237. package/dist/runtime.js.map +1 -1
  238. package/dist/scan-dashboard.d.ts +5 -3
  239. package/dist/scan-dashboard.d.ts.map +1 -1
  240. package/dist/scan-dashboard.js +79 -26
  241. package/dist/scan-dashboard.js.map +1 -1
  242. package/dist/scan-history-renderer.d.ts.map +1 -1
  243. package/dist/scan-history-renderer.js +8 -2
  244. package/dist/scan-history-renderer.js.map +1 -1
  245. package/dist/scan-owner-suggestions.d.ts +8 -0
  246. package/dist/scan-owner-suggestions.d.ts.map +1 -0
  247. package/dist/scan-owner-suggestions.js +33 -0
  248. package/dist/scan-owner-suggestions.js.map +1 -0
  249. package/dist/scan-settings.d.ts +1 -0
  250. package/dist/scan-settings.d.ts.map +1 -1
  251. package/dist/scan-settings.js +4 -0
  252. package/dist/scan-settings.js.map +1 -1
  253. package/dist/scan-usage-display.d.ts +8 -0
  254. package/dist/scan-usage-display.d.ts.map +1 -0
  255. package/dist/scan-usage-display.js +46 -0
  256. package/dist/scan-usage-display.js.map +1 -0
  257. package/dist/scanner-import.d.ts +20 -0
  258. package/dist/scanner-import.d.ts.map +1 -0
  259. package/dist/scanner-import.js +208 -0
  260. package/dist/scanner-import.js.map +1 -0
  261. package/dist/security-policy-diff.d.ts +2 -0
  262. package/dist/security-policy-diff.d.ts.map +1 -0
  263. package/dist/security-policy-diff.js +197 -0
  264. package/dist/security-policy-diff.js.map +1 -0
  265. package/dist/security-policy.d.ts +7 -3
  266. package/dist/security-policy.d.ts.map +1 -1
  267. package/dist/security-policy.js +11 -76
  268. package/dist/security-policy.js.map +1 -1
  269. package/dist/semgrep-findings.d.ts +10 -0
  270. package/dist/semgrep-findings.d.ts.map +1 -0
  271. package/dist/semgrep-findings.js +293 -0
  272. package/dist/semgrep-findings.js.map +1 -0
  273. package/dist/severity-review.d.ts +3 -0
  274. package/dist/severity-review.d.ts.map +1 -1
  275. package/dist/severity-review.js +19 -0
  276. package/dist/severity-review.js.map +1 -1
  277. package/dist/severity-store.js +7 -2
  278. package/dist/severity-store.js.map +1 -1
  279. package/dist/skill-authentication.d.ts +18 -0
  280. package/dist/skill-authentication.d.ts.map +1 -0
  281. package/dist/skill-authentication.js +82 -0
  282. package/dist/skill-authentication.js.map +1 -0
  283. package/dist/snyk-findings.d.ts +10 -0
  284. package/dist/snyk-findings.d.ts.map +1 -0
  285. package/dist/snyk-findings.js +350 -0
  286. package/dist/snyk-findings.js.map +1 -0
  287. package/dist/suggest-owners.d.ts +4 -1
  288. package/dist/suggest-owners.d.ts.map +1 -1
  289. package/dist/suggest-owners.js +53 -21
  290. package/dist/suggest-owners.js.map +1 -1
  291. package/dist/targets.d.ts +2 -2
  292. package/dist/targets.d.ts.map +1 -1
  293. package/dist/targets.js +16 -3
  294. package/dist/targets.js.map +1 -1
  295. package/dist/wiz-csv.d.ts +9 -0
  296. package/dist/wiz-csv.d.ts.map +1 -0
  297. package/dist/wiz-csv.js +116 -0
  298. package/dist/wiz-csv.js.map +1 -0
  299. package/dist/wiz-findings.d.ts +5 -0
  300. package/dist/wiz-findings.d.ts.map +1 -0
  301. package/dist/wiz-findings.js +464 -0
  302. package/dist/wiz-findings.js.map +1 -0
  303. package/docs/classify-severity-records.md +30 -13
  304. package/docs/cli.md +835 -47
  305. package/docs/findings-service.md +119 -118
  306. package/docs/hosted-remediation.md +43 -24
  307. package/docs/hosted-scans.md +38 -0
  308. package/package.json +11 -9
  309. package/schemas/external-findings.schema.json +1421 -0
  310. package/schemas/project-config.schema.json +4 -0
  311. package/_bundled_plugin/scripts/generate_in_scope_files.py +0 -277
  312. package/_bundled_plugin/scripts/generate_rank_input.py +0 -350
  313. package/_bundled_plugin/scripts/rank_preview.py +0 -129
@@ -0,0 +1,208 @@
1
+ import { hash } from "node:crypto";
2
+ import { readFile } from "node:fs/promises";
3
+ import { promisify } from "node:util";
4
+ import { gunzip } from "node:zlib";
5
+ import { CodexSecurityError, errorMessage } from "./errors.js";
6
+ import { isRecord } from "./record.js";
7
+ export function record(value, label) {
8
+ if (!value || typeof value !== "object" || Array.isArray(value))
9
+ throw new Error(`${label} must be an object.`);
10
+ return value;
11
+ }
12
+ export function array(value, label) {
13
+ if (!Array.isArray(value))
14
+ throw new Error(`${label} must be an array.`);
15
+ return value;
16
+ }
17
+ export function text(value) {
18
+ return typeof value === "string" && value.trim() ? value : null;
19
+ }
20
+ export function requiredText(value, label) {
21
+ const result = text(value);
22
+ if (!result)
23
+ throw new Error(`${label} must be nonempty text.`);
24
+ return result;
25
+ }
26
+ export function strings(value) {
27
+ return Array.isArray(value)
28
+ ? value.filter((v) => text(v) !== null)
29
+ : [];
30
+ }
31
+ /** Paths that cannot be attributed to a repository stay in original evidence. */
32
+ export function relativePath(value) {
33
+ const path = text(value)?.replaceAll("\\", "/");
34
+ return path &&
35
+ !path.startsWith("/") &&
36
+ !path.includes("\0") &&
37
+ !/^[A-Za-z]:/.test(path) &&
38
+ !path.split("/").includes("..")
39
+ ? path
40
+ : null;
41
+ }
42
+ export function stableId(prefix, fields) {
43
+ return `${prefix}:${hash("sha256", JSON.stringify(fields))}`;
44
+ }
45
+ /** Detect gzip from the report bytes and preserve identities with strict UTF-8. */
46
+ export async function readScannerText(path) {
47
+ let bytes = await readFile(path);
48
+ if (bytes[0] === 0x1f && bytes[1] === 0x8b)
49
+ bytes = await promisify(gunzip)(bytes);
50
+ return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
51
+ }
52
+ export function parseJsonOrJsonl(contents) {
53
+ try {
54
+ return JSON.parse(contents);
55
+ }
56
+ catch {
57
+ return contents
58
+ .split(/\r?\n/u)
59
+ .filter((line) => line.trim())
60
+ .map((line) => JSON.parse(line));
61
+ }
62
+ }
63
+ export async function readScannerJson(path) {
64
+ let bytes = await readFile(path);
65
+ if (bytes[0] === 0x1f && bytes[1] === 0x8b)
66
+ bytes = await promisify(gunzip)(bytes);
67
+ let decoded;
68
+ try {
69
+ decoded = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
70
+ }
71
+ catch (error) {
72
+ throw new CodexSecurityError(`Scanner report is not valid UTF-8. ${errorMessage(error)}`, { cause: error });
73
+ }
74
+ try {
75
+ return JSON.parse(decoded.replace(/^\uFEFF/u, ""));
76
+ }
77
+ catch (error) {
78
+ throw new CodexSecurityError(`Scanner JSON could not be parsed. ${errorMessage(error)}`, { cause: error });
79
+ }
80
+ }
81
+ /** Empty reference containers and property-bag metadata do not externalize data. */
82
+ export function hasSarifExternalPropertyReferences(value) {
83
+ if (value == null)
84
+ return false;
85
+ return Object.entries(record(value, "SARIF external property references")).some(([key, references]) => key !== "properties" &&
86
+ (!Array.isArray(references) || references.length > 0));
87
+ }
88
+ const sarifArtifactLocationFields = new Set([
89
+ "artifactLocation",
90
+ "analysisTarget",
91
+ "executableLocation",
92
+ "workingDirectory",
93
+ "stdin",
94
+ "stdout",
95
+ "stderr",
96
+ "stdoutStderr",
97
+ "mappedTo",
98
+ "displayBase",
99
+ ]);
100
+ /** Keep original artifact indexes; omit only inventory unrelated to this finding. */
101
+ export function sarifRunContextForResult(runContext, ...selectedEvidence) {
102
+ const { artifacts, ...context } = runContext;
103
+ if (!Array.isArray(artifacts) || artifacts.length === 0)
104
+ return runContext;
105
+ const locations = [];
106
+ let hasArtifactLink = false;
107
+ function visit(value) {
108
+ if (typeof value === "string") {
109
+ // SARIF message links can refer to an artifact without an artifactLocation.
110
+ if (/sarif:/iu.test(value))
111
+ hasArtifactLink = true;
112
+ }
113
+ else if (Array.isArray(value))
114
+ value.forEach(visit);
115
+ else if (isRecord(value))
116
+ for (const [key, child] of Object.entries(value)) {
117
+ if (key === "properties")
118
+ continue;
119
+ if (sarifArtifactLocationFields.has(key) && isRecord(child))
120
+ locations.push(child);
121
+ if (["locations", "responseFiles", "analysisToolLogFiles"].includes(key) &&
122
+ Array.isArray(child))
123
+ locations.push(...child.filter(isRecord));
124
+ if (key === "originalUriBaseIds" && isRecord(child))
125
+ locations.push(...Object.values(child).filter(isRecord));
126
+ visit(child);
127
+ }
128
+ }
129
+ visit([context, ...selectedEvidence]);
130
+ if (hasArtifactLink)
131
+ return runContext;
132
+ const unresolvedUri = /[%:\\]|(?:^|\/)\.\.?(?:\/|$)/u;
133
+ for (const location of locations) {
134
+ if (typeof location["index"] === "number" && location["index"] >= 0)
135
+ return runContext;
136
+ if (typeof location["uri"] !== "string")
137
+ continue;
138
+ for (const artifact of artifacts) {
139
+ if (!isRecord(artifact) || !isRecord(artifact["location"]))
140
+ continue;
141
+ const candidate = artifact["location"];
142
+ // Keep URI spellings that need resolution; evidence is never rewritten.
143
+ if (location["uriBaseId"] !== candidate["uriBaseId"] ||
144
+ unresolvedUri.test(location["uri"]) ||
145
+ (typeof candidate["uri"] === "string" &&
146
+ unresolvedUri.test(candidate["uri"])) ||
147
+ location["uri"] === candidate["uri"])
148
+ return runContext;
149
+ }
150
+ }
151
+ return context;
152
+ }
153
+ /** Exclude every colliding record: choosing the first could overwrite another occurrence. */
154
+ export function normalizeRecords(records, normalize, identify, target = "cloud") {
155
+ const result = {
156
+ read: records.length,
157
+ findings: [],
158
+ excluded: [],
159
+ };
160
+ const identified = [];
161
+ const counts = new Map();
162
+ for (const [index, value] of records.entries()) {
163
+ try {
164
+ const id = identify(value);
165
+ if (!id.trim() ||
166
+ id.includes("\0") ||
167
+ (target === "cloud" && Buffer.byteLength(id) > 512))
168
+ throw new Error(target === "cloud"
169
+ ? "Source finding ID must contain 1–512 UTF-8 bytes and no NUL characters."
170
+ : "Source finding ID must be nonempty and contain no NUL characters.");
171
+ identified.push({ position: index + 1, value, id });
172
+ counts.set(id, (counts.get(id) ?? 0) + 1);
173
+ }
174
+ catch (error) {
175
+ result.excluded.push({
176
+ position: index + 1,
177
+ source_finding_id: null,
178
+ reason: errorMessage(error),
179
+ });
180
+ }
181
+ }
182
+ for (const { position, value, id } of identified) {
183
+ if (counts.get(id) > 1) {
184
+ result.excluded.push({
185
+ position,
186
+ source_finding_id: id,
187
+ reason: "Ambiguous duplicate source identity; select one complete finding or separate source projects.",
188
+ });
189
+ continue;
190
+ }
191
+ try {
192
+ const finding = normalize(value, id);
193
+ if (finding.source_finding_id !== id)
194
+ throw new Error("Finding identity changed during normalization.");
195
+ result.findings.push(finding);
196
+ }
197
+ catch (error) {
198
+ result.excluded.push({
199
+ position,
200
+ source_finding_id: id,
201
+ reason: errorMessage(error),
202
+ });
203
+ }
204
+ }
205
+ result.excluded.sort((a, b) => a.position - b.position);
206
+ return result;
207
+ }
208
+ //# sourceMappingURL=scanner-import.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"scanner-import.js","sourceRoot":"","sources":["../src/scanner-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACnC,OAAO,EAAE,kBAAkB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,UAAU,MAAM,CAAC,KAAc,EAAE,KAAa;IAClD,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAC7D,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,qBAAqB,CAAC,CAAC;IACjD,OAAO,KAAgC,CAAC;AAC1C,CAAC;AAED,MAAM,UAAU,KAAK,CAAC,KAAc,EAAE,KAAa;IACjD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,oBAAoB,CAAC,CAAC;IACzE,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,IAAI,CAAC,KAAc;IACjC,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAc,EAAE,KAAa;IACxD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAC3B,IAAI,CAAC,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,GAAG,KAAK,yBAAyB,CAAC,CAAC;IAChE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,KAAc;IACpC,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACzB,CAAC,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC;QACpD,CAAC,CAAC,EAAE,CAAC;AACT,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAChD,OAAO,IAAI;QACT,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC;QACrB,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpB,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC;QACxB,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC;QAC/B,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC;AACX,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,MAAc,EAAE,MAAiB;IACxD,OAAO,GAAG,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED,mFAAmF;AACnF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,IAAI,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACxC,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;IACzC,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,QAAQ;aACZ,KAAK,CAAC,QAAQ,CAAC;aACf,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;aAC7B,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;IACrC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAY;IAChD,IAAI,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI;QACxC,KAAK,GAAG,MAAM,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,CAAC;IACzC,IAAI,OAAe,CAAC;IACpB,IAAI,CAAC;QACH,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACpE,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAC1B,sCAAsC,YAAY,CAAC,KAAK,CAAC,EAAE,EAC3D,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;IACD,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAC1B,qCAAqC,YAAY,CAAC,KAAK,CAAC,EAAE,EAC1D,EAAE,KAAK,EAAE,KAAK,EAAE,CACjB,CAAC;IACJ,CAAC;AACH,CAAC;AAED,oFAAoF;AACpF,MAAM,UAAU,kCAAkC,CAAC,KAAc;IAC/D,IAAI,KAAK,IAAI,IAAI;QAAE,OAAO,KAAK,CAAC;IAChC,OAAO,MAAM,CAAC,OAAO,CACnB,MAAM,CAAC,KAAK,EAAE,oCAAoC,CAAC,CACpD,CAAC,IAAI,CACJ,CAAC,CAAC,GAAG,EAAE,UAAU,CAAC,EAAE,EAAE,CACpB,GAAG,KAAK,YAAY;QACpB,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CACxD,CAAC;AACJ,CAAC;AAED,MAAM,2BAA2B,GAAG,IAAI,GAAG,CAAC;IAC1C,kBAAkB;IAClB,gBAAgB;IAChB,oBAAoB;IACpB,kBAAkB;IAClB,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,cAAc;IACd,UAAU;IACV,aAAa;CACd,CAAC,CAAC;AAEH,qFAAqF;AACrF,MAAM,UAAU,wBAAwB,CACtC,UAAmC,EACnC,GAAG,gBAA2B;IAE9B,MAAM,EAAE,SAAS,EAAE,GAAG,OAAO,EAAE,GAAG,UAAU,CAAC;IAC7C,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAC3E,MAAM,SAAS,GAA8B,EAAE,CAAC;IAChD,IAAI,eAAe,GAAG,KAAK,CAAC;IAC5B,SAAS,KAAK,CAAC,KAAc;QAC3B,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9B,4EAA4E;YAC5E,IAAI,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC;gBAAE,eAAe,GAAG,IAAI,CAAC;QACrD,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;YAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;aACjD,IAAI,QAAQ,CAAC,KAAK,CAAC;YACtB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;gBACjD,IAAI,GAAG,KAAK,YAAY;oBAAE,SAAS;gBACnC,IAAI,2BAA2B,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC,KAAK,CAAC;oBACzD,SAAS,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;gBACxB,IACE,CAAC,WAAW,EAAE,eAAe,EAAE,sBAAsB,CAAC,CAAC,QAAQ,CAC7D,GAAG,CACJ;oBACD,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;oBAEpB,SAAS,CAAC,IAAI,CAAC,GAAG,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC5C,IAAI,GAAG,KAAK,oBAAoB,IAAI,QAAQ,CAAC,KAAK,CAAC;oBACjD,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAC3D,KAAK,CAAC,KAAK,CAAC,CAAC;YACf,CAAC;IACL,CAAC;IACD,KAAK,CAAC,CAAC,OAAO,EAAE,GAAG,gBAAgB,CAAC,CAAC,CAAC;IACtC,IAAI,eAAe;QAAE,OAAO,UAAU,CAAC;IACvC,MAAM,aAAa,GAAG,+BAA+B,CAAC;IACtD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,OAAO,QAAQ,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC;YACjE,OAAO,UAAU,CAAC;QACpB,IAAI,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,QAAQ;YAAE,SAAS;QAClD,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;gBAAE,SAAS;YACrE,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC;YACvC,wEAAwE;YACxE,IACE,QAAQ,CAAC,WAAW,CAAC,KAAK,SAAS,CAAC,WAAW,CAAC;gBAChD,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;gBACnC,CAAC,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,QAAQ;oBACnC,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;gBACvC,QAAQ,CAAC,KAAK,CAAC,KAAK,SAAS,CAAC,KAAK,CAAC;gBAEpC,OAAO,UAAU,CAAC;QACtB,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,6FAA6F;AAC7F,MAAM,UAAU,gBAAgB,CAC9B,OAAY,EACZ,SAAqD,EACrD,QAA+B,EAC/B,MAAM,GAAsB,OAAO;IAEnC,MAAM,MAAM,GAAqB;QAC/B,IAAI,EAAE,OAAO,CAAC,MAAM;QACpB,QAAQ,EAAE,EAAE;QACZ,QAAQ,EAAE,EAAE;KACb,CAAC;IACF,MAAM,UAAU,GAAiD,EAAE,CAAC;IACpE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC;QAC/C,IAAI,CAAC;YACH,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;YAC3B,IACE,CAAC,EAAE,CAAC,IAAI,EAAE;gBACV,EAAE,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACjB,CAAC,MAAM,KAAK,OAAO,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC;gBAEnD,MAAM,IAAI,KAAK,CACb,MAAM,KAAK,OAAO;oBAChB,CAAC,CAAC,yEAAyE;oBAC3E,CAAC,CAAC,mEAAmE,CACxE,CAAC;YACJ,UAAU,CAAC,IAAI,CAAC,EAAE,QAAQ,EAAE,KAAK,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC,CAAC;YACpD,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAC5C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACnB,QAAQ,EAAE,KAAK,GAAG,CAAC;gBACnB,iBAAiB,EAAE,IAAI;gBACvB,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC;aAC5B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,KAAK,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,UAAU,EAAE,CAAC;QACjD,IAAI,MAAM,CAAC,GAAG,CAAC,EAAE,CAAE,GAAG,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACnB,QAAQ;gBACR,iBAAiB,EAAE,EAAE;gBACrB,MAAM,EACJ,+FAA+F;aAClG,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,CAAC;YACH,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;YACrC,IAAI,OAAO,CAAC,iBAAiB,KAAK,EAAE;gBAClC,MAAM,IAAI,KAAK,CAAC,gDAAgD,CAAC,CAAC;YACpE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAChC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC;gBACnB,QAAQ;gBACR,iBAAiB,EAAE,EAAE;gBACrB,MAAM,EAAE,YAAY,CAAC,KAAK,CAAC;aAC5B,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,GAAG,CAAC,CAAC,QAAQ,CAAC,CAAC;IACxD,OAAO,MAAM,CAAC;AAChB,CAAC","sourcesContent":["import { hash } from \"node:crypto\";\nimport { readFile } from \"node:fs/promises\";\nimport { promisify } from \"node:util\";\nimport { gunzip } from \"node:zlib\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport type { ExternalFinding, ExternalFindings } from \"./external-findings.js\";\nimport { isRecord } from \"./record.js\";\n\nexport function record(value: unknown, label: string): Record<string, unknown> {\n if (!value || typeof value !== \"object\" || Array.isArray(value))\n throw new Error(`${label} must be an object.`);\n return value as Record<string, unknown>;\n}\n\nexport function array(value: unknown, label: string): unknown[] {\n if (!Array.isArray(value)) throw new Error(`${label} must be an array.`);\n return value;\n}\n\nexport function text(value: unknown): string | null {\n return typeof value === \"string\" && value.trim() ? value : null;\n}\n\nexport function requiredText(value: unknown, label: string): string {\n const result = text(value);\n if (!result) throw new Error(`${label} must be nonempty text.`);\n return result;\n}\n\nexport function strings(value: unknown): string[] {\n return Array.isArray(value)\n ? value.filter((v): v is string => text(v) !== null)\n : [];\n}\n\n/** Paths that cannot be attributed to a repository stay in original evidence. */\nexport function relativePath(value: unknown): string | null {\n const path = text(value)?.replaceAll(\"\\\\\", \"/\");\n return path &&\n !path.startsWith(\"/\") &&\n !path.includes(\"\\0\") &&\n !/^[A-Za-z]:/.test(path) &&\n !path.split(\"/\").includes(\"..\")\n ? path\n : null;\n}\n\nexport function stableId(prefix: string, fields: unknown[]): string {\n return `${prefix}:${hash(\"sha256\", JSON.stringify(fields))}`;\n}\n\n/** Detect gzip from the report bytes and preserve identities with strict UTF-8. */\nexport async function readScannerText(path: string): Promise<string> {\n let bytes = await readFile(path);\n if (bytes[0] === 0x1f && bytes[1] === 0x8b)\n bytes = await promisify(gunzip)(bytes);\n return new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes);\n}\n\nexport function parseJsonOrJsonl(contents: string): unknown {\n try {\n return JSON.parse(contents);\n } catch {\n return contents\n .split(/\\r?\\n/u)\n .filter((line) => line.trim())\n .map((line) => JSON.parse(line));\n }\n}\n\nexport async function readScannerJson(path: string): Promise<unknown> {\n let bytes = await readFile(path);\n if (bytes[0] === 0x1f && bytes[1] === 0x8b)\n bytes = await promisify(gunzip)(bytes);\n let decoded: string;\n try {\n decoded = new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes);\n } catch (error) {\n throw new CodexSecurityError(\n `Scanner report is not valid UTF-8. ${errorMessage(error)}`,\n { cause: error },\n );\n }\n try {\n return JSON.parse(decoded.replace(/^\\uFEFF/u, \"\"));\n } catch (error) {\n throw new CodexSecurityError(\n `Scanner JSON could not be parsed. ${errorMessage(error)}`,\n { cause: error },\n );\n }\n}\n\n/** Empty reference containers and property-bag metadata do not externalize data. */\nexport function hasSarifExternalPropertyReferences(value: unknown): boolean {\n if (value == null) return false;\n return Object.entries(\n record(value, \"SARIF external property references\"),\n ).some(\n ([key, references]) =>\n key !== \"properties\" &&\n (!Array.isArray(references) || references.length > 0),\n );\n}\n\nconst sarifArtifactLocationFields = new Set([\n \"artifactLocation\",\n \"analysisTarget\",\n \"executableLocation\",\n \"workingDirectory\",\n \"stdin\",\n \"stdout\",\n \"stderr\",\n \"stdoutStderr\",\n \"mappedTo\",\n \"displayBase\",\n]);\n\n/** Keep original artifact indexes; omit only inventory unrelated to this finding. */\nexport function sarifRunContextForResult(\n runContext: Record<string, unknown>,\n ...selectedEvidence: unknown[]\n): Record<string, unknown> {\n const { artifacts, ...context } = runContext;\n if (!Array.isArray(artifacts) || artifacts.length === 0) return runContext;\n const locations: Record<string, unknown>[] = [];\n let hasArtifactLink = false;\n function visit(value: unknown): void {\n if (typeof value === \"string\") {\n // SARIF message links can refer to an artifact without an artifactLocation.\n if (/sarif:/iu.test(value)) hasArtifactLink = true;\n } else if (Array.isArray(value)) value.forEach(visit);\n else if (isRecord(value))\n for (const [key, child] of Object.entries(value)) {\n if (key === \"properties\") continue;\n if (sarifArtifactLocationFields.has(key) && isRecord(child))\n locations.push(child);\n if (\n [\"locations\", \"responseFiles\", \"analysisToolLogFiles\"].includes(\n key,\n ) &&\n Array.isArray(child)\n )\n locations.push(...child.filter(isRecord));\n if (key === \"originalUriBaseIds\" && isRecord(child))\n locations.push(...Object.values(child).filter(isRecord));\n visit(child);\n }\n }\n visit([context, ...selectedEvidence]);\n if (hasArtifactLink) return runContext;\n const unresolvedUri = /[%:\\\\]|(?:^|\\/)\\.\\.?(?:\\/|$)/u;\n for (const location of locations) {\n if (typeof location[\"index\"] === \"number\" && location[\"index\"] >= 0)\n return runContext;\n if (typeof location[\"uri\"] !== \"string\") continue;\n for (const artifact of artifacts) {\n if (!isRecord(artifact) || !isRecord(artifact[\"location\"])) continue;\n const candidate = artifact[\"location\"];\n // Keep URI spellings that need resolution; evidence is never rewritten.\n if (\n location[\"uriBaseId\"] !== candidate[\"uriBaseId\"] ||\n unresolvedUri.test(location[\"uri\"]) ||\n (typeof candidate[\"uri\"] === \"string\" &&\n unresolvedUri.test(candidate[\"uri\"])) ||\n location[\"uri\"] === candidate[\"uri\"]\n )\n return runContext;\n }\n }\n return context;\n}\n\n/** Exclude every colliding record: choosing the first could overwrite another occurrence. */\nexport function normalizeRecords<T>(\n records: T[],\n normalize: (record: T, id: string) => ExternalFinding,\n identify: (record: T) => string,\n target: \"local\" | \"cloud\" = \"cloud\",\n): ExternalFindings {\n const result: ExternalFindings = {\n read: records.length,\n findings: [],\n excluded: [],\n };\n const identified: { position: number; value: T; id: string }[] = [];\n const counts = new Map<string, number>();\n for (const [index, value] of records.entries()) {\n try {\n const id = identify(value);\n if (\n !id.trim() ||\n id.includes(\"\\0\") ||\n (target === \"cloud\" && Buffer.byteLength(id) > 512)\n )\n throw new Error(\n target === \"cloud\"\n ? \"Source finding ID must contain 1–512 UTF-8 bytes and no NUL characters.\"\n : \"Source finding ID must be nonempty and contain no NUL characters.\",\n );\n identified.push({ position: index + 1, value, id });\n counts.set(id, (counts.get(id) ?? 0) + 1);\n } catch (error) {\n result.excluded.push({\n position: index + 1,\n source_finding_id: null,\n reason: errorMessage(error),\n });\n }\n }\n for (const { position, value, id } of identified) {\n if (counts.get(id)! > 1) {\n result.excluded.push({\n position,\n source_finding_id: id,\n reason:\n \"Ambiguous duplicate source identity; select one complete finding or separate source projects.\",\n });\n continue;\n }\n try {\n const finding = normalize(value, id);\n if (finding.source_finding_id !== id)\n throw new Error(\"Finding identity changed during normalization.\");\n result.findings.push(finding);\n } catch (error) {\n result.excluded.push({\n position,\n source_finding_id: id,\n reason: errorMessage(error),\n });\n }\n }\n result.excluded.sort((a, b) => a.position - b.position);\n return result;\n}\n"]}
@@ -0,0 +1,2 @@
1
+ export declare function securityPolicyUnifiedDiff(before: string, after: string, fromfile: string, tofile: string, signal?: AbortSignal): Promise<string>;
2
+ //# sourceMappingURL=security-policy-diff.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"security-policy-diff.d.ts","sourceRoot":"","sources":["../src/security-policy-diff.ts"],"names":[],"mappings":"AAoMA,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAWjB"}
@@ -0,0 +1,197 @@
1
+ import { setImmediate } from "node:timers/promises";
2
+ function* lines(text) {
3
+ const result = [];
4
+ let start = 0;
5
+ for (let end = 0; end < text.length; end++) {
6
+ if (text.charCodeAt(end) === 10) {
7
+ result.push(text.slice(start, end + 1));
8
+ start = end + 1;
9
+ }
10
+ yield;
11
+ }
12
+ if (start < text.length)
13
+ result.push(text.slice(start));
14
+ return result;
15
+ }
16
+ // Match Python's SequenceMatcher(None, a, b), including its default autojunk
17
+ // heuristic. A different longest-common-subsequence algorithm changes the diff.
18
+ function* matchingBlocks(a, b) {
19
+ const positions = new Map();
20
+ for (let j = 0; j < b.length; j++) {
21
+ const line = b[j];
22
+ const indices = positions.get(line);
23
+ if (indices)
24
+ indices.push(j);
25
+ else
26
+ positions.set(line, [j]);
27
+ yield;
28
+ }
29
+ if (b.length >= 200) {
30
+ const threshold = Math.floor(b.length / 100) + 1;
31
+ for (const [line, indices] of positions) {
32
+ if (indices.length > threshold)
33
+ positions.delete(line);
34
+ yield;
35
+ }
36
+ }
37
+ const pending = [[0, a.length, 0, b.length]];
38
+ const matches = [];
39
+ while (pending.length) {
40
+ const range = pending.pop();
41
+ if (range.length === 3) {
42
+ const previous = matches.at(-1);
43
+ if (previous &&
44
+ previous[0] + previous[2] === range[0] &&
45
+ previous[1] + previous[2] === range[1]) {
46
+ previous[2] += range[2];
47
+ }
48
+ else {
49
+ matches.push(range);
50
+ }
51
+ yield;
52
+ continue;
53
+ }
54
+ const [alo, ahi, blo, bhi] = range;
55
+ let bestA = alo;
56
+ let bestB = blo;
57
+ let size = 0;
58
+ let lengths = new Map();
59
+ for (let i = alo; i < ahi; i++) {
60
+ const next = new Map();
61
+ for (const j of positions.get(a[i]) ?? []) {
62
+ yield;
63
+ if (j < blo)
64
+ continue;
65
+ if (j >= bhi)
66
+ break;
67
+ const length = (lengths.get(j - 1) ?? 0) + 1;
68
+ next.set(j, length);
69
+ if (length > size) {
70
+ bestA = i - length + 1;
71
+ bestB = j - length + 1;
72
+ size = length;
73
+ }
74
+ }
75
+ lengths = next;
76
+ yield;
77
+ }
78
+ // Popular lines may extend a match, even though they cannot anchor one.
79
+ while (bestA > alo && bestB > blo && a[bestA - 1] === b[bestB - 1]) {
80
+ bestA--;
81
+ bestB--;
82
+ size++;
83
+ yield;
84
+ }
85
+ while (bestA + size < ahi &&
86
+ bestB + size < bhi &&
87
+ a[bestA + size] === b[bestB + size]) {
88
+ size++;
89
+ yield;
90
+ }
91
+ if (size) {
92
+ // Visit matches in order, avoiding a blocking sort of the result.
93
+ if (bestA + size < ahi && bestB + size < bhi) {
94
+ pending.push([bestA + size, ahi, bestB + size, bhi]);
95
+ }
96
+ pending.push([bestA, bestB, size]);
97
+ if (alo < bestA && blo < bestB) {
98
+ pending.push([alo, bestA, blo, bestB]);
99
+ }
100
+ }
101
+ yield;
102
+ }
103
+ matches.push([a.length, b.length, 0]);
104
+ return matches;
105
+ }
106
+ function formatRange(start, end) {
107
+ const length = end - start;
108
+ return length === 1
109
+ ? String(start + 1)
110
+ : `${length ? start + 1 : start},${length}`;
111
+ }
112
+ function* unifiedDiff(before, after, fromfile, tofile) {
113
+ const a = yield* lines(before);
114
+ const b = yield* lines(after);
115
+ const matches = yield* matchingBlocks(a, b);
116
+ const codes = [];
117
+ let i = 0;
118
+ let j = 0;
119
+ for (const [ai, bj, size] of matches) {
120
+ if (i < ai || j < bj)
121
+ codes.push([false, i, ai, j, bj]);
122
+ i = ai + size;
123
+ j = bj + size;
124
+ if (size)
125
+ codes.push([true, ai, i, bj, j]);
126
+ yield;
127
+ }
128
+ const first = codes[0];
129
+ const last = codes.at(-1);
130
+ if (first?.[0]) {
131
+ first[1] = Math.max(first[1], first[2] - 3);
132
+ first[3] = Math.max(first[3], first[4] - 3);
133
+ }
134
+ if (last?.[0]) {
135
+ last[2] = Math.min(last[2], last[1] + 3);
136
+ last[4] = Math.min(last[4], last[3] + 3);
137
+ }
138
+ const output = [];
139
+ function* emit(group) {
140
+ if (!group.length || (group.length === 1 && group[0][0]))
141
+ return;
142
+ if (!output.length)
143
+ output.push(`--- ${fromfile}\n+++ ${tofile}\n`);
144
+ const first = group[0];
145
+ const last = group.at(-1);
146
+ output.push(`@@ -${formatRange(first[1], last[2])} +${formatRange(first[3], last[4])} @@\n`);
147
+ for (const [equal, aStart, aEnd, bStart, bEnd] of group) {
148
+ for (let index = aStart; index < aEnd; index++) {
149
+ const line = a[index];
150
+ output.push((equal ? " " : "-") + line);
151
+ if (!line.endsWith("\n")) {
152
+ output.push("\n\\n");
153
+ }
154
+ yield;
155
+ }
156
+ if (!equal) {
157
+ for (let index = bStart; index < bEnd; index++) {
158
+ const line = b[index];
159
+ output.push("+" + line);
160
+ if (!line.endsWith("\n")) {
161
+ output.push("\n\\n");
162
+ }
163
+ yield;
164
+ }
165
+ }
166
+ yield;
167
+ }
168
+ }
169
+ let group = [];
170
+ for (const [equal, aStart, aEnd, bStart, bEnd] of codes) {
171
+ if (equal && aEnd - aStart > 6) {
172
+ group.push([true, aStart, aStart + 3, bStart, bStart + 3]);
173
+ yield* emit(group);
174
+ group = [[true, aEnd - 3, aEnd, bEnd - 3, bEnd]];
175
+ }
176
+ else {
177
+ group.push([equal, aStart, aEnd, bStart, bEnd]);
178
+ }
179
+ yield;
180
+ }
181
+ yield* emit(group);
182
+ return output.join("");
183
+ }
184
+ export async function securityPolicyUnifiedDiff(before, after, fromfile, tofile, signal) {
185
+ const work = unifiedDiff(before, after, fromfile, tofile);
186
+ for (;;) {
187
+ signal?.throwIfAborted();
188
+ // Bound synchronous work, including the quadratic inner matching loop.
189
+ for (let operation = 0; operation < 4096; operation++) {
190
+ const result = work.next();
191
+ if (result.done)
192
+ return result.value;
193
+ }
194
+ await setImmediate();
195
+ }
196
+ }
197
+ //# sourceMappingURL=security-policy-diff.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"security-policy-diff.js","sourceRoot":"","sources":["../src/security-policy-diff.ts"],"names":[],"mappings":"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","sourcesContent":["import { setImmediate } from \"node:timers/promises\";\n\ntype Match = [a: number, b: number, size: number];\ntype Range = [aStart: number, aEnd: number, bStart: number, bEnd: number];\ntype Opcode = [equal: boolean, ...Range];\ntype Work<T> = Generator<void, T>;\n\nfunction* lines(text: string): Work<string[]> {\n const result: string[] = [];\n let start = 0;\n for (let end = 0; end < text.length; end++) {\n if (text.charCodeAt(end) === 10) {\n result.push(text.slice(start, end + 1));\n start = end + 1;\n }\n yield;\n }\n if (start < text.length) result.push(text.slice(start));\n return result;\n}\n\n// Match Python's SequenceMatcher(None, a, b), including its default autojunk\n// heuristic. A different longest-common-subsequence algorithm changes the diff.\nfunction* matchingBlocks(a: string[], b: string[]): Work<Match[]> {\n const positions = new Map<string, number[]>();\n for (let j = 0; j < b.length; j++) {\n const line = b[j]!;\n const indices = positions.get(line);\n if (indices) indices.push(j);\n else positions.set(line, [j]);\n yield;\n }\n if (b.length >= 200) {\n const threshold = Math.floor(b.length / 100) + 1;\n for (const [line, indices] of positions) {\n if (indices.length > threshold) positions.delete(line);\n yield;\n }\n }\n\n const pending: (Range | Match)[] = [[0, a.length, 0, b.length]];\n const matches: Match[] = [];\n while (pending.length) {\n const range = pending.pop()!;\n if (range.length === 3) {\n const previous = matches.at(-1);\n if (\n previous &&\n previous[0] + previous[2] === range[0] &&\n previous[1] + previous[2] === range[1]\n ) {\n previous[2] += range[2];\n } else {\n matches.push(range);\n }\n yield;\n continue;\n }\n\n const [alo, ahi, blo, bhi] = range;\n let bestA = alo;\n let bestB = blo;\n let size = 0;\n let lengths = new Map<number, number>();\n for (let i = alo; i < ahi; i++) {\n const next = new Map<number, number>();\n for (const j of positions.get(a[i]!) ?? []) {\n yield;\n if (j < blo) continue;\n if (j >= bhi) break;\n const length = (lengths.get(j - 1) ?? 0) + 1;\n next.set(j, length);\n if (length > size) {\n bestA = i - length + 1;\n bestB = j - length + 1;\n size = length;\n }\n }\n lengths = next;\n yield;\n }\n // Popular lines may extend a match, even though they cannot anchor one.\n while (bestA > alo && bestB > blo && a[bestA - 1] === b[bestB - 1]) {\n bestA--;\n bestB--;\n size++;\n yield;\n }\n while (\n bestA + size < ahi &&\n bestB + size < bhi &&\n a[bestA + size] === b[bestB + size]\n ) {\n size++;\n yield;\n }\n if (size) {\n // Visit matches in order, avoiding a blocking sort of the result.\n if (bestA + size < ahi && bestB + size < bhi) {\n pending.push([bestA + size, ahi, bestB + size, bhi]);\n }\n pending.push([bestA, bestB, size]);\n if (alo < bestA && blo < bestB) {\n pending.push([alo, bestA, blo, bestB]);\n }\n }\n yield;\n }\n matches.push([a.length, b.length, 0]);\n return matches;\n}\n\nfunction formatRange(start: number, end: number): string {\n const length = end - start;\n return length === 1\n ? String(start + 1)\n : `${length ? start + 1 : start},${length}`;\n}\n\nfunction* unifiedDiff(\n before: string,\n after: string,\n fromfile: string,\n tofile: string,\n): Work<string> {\n const a = yield* lines(before);\n const b = yield* lines(after);\n const matches = yield* matchingBlocks(a, b);\n const codes: Opcode[] = [];\n let i = 0;\n let j = 0;\n for (const [ai, bj, size] of matches) {\n if (i < ai || j < bj) codes.push([false, i, ai, j, bj]);\n i = ai + size;\n j = bj + size;\n if (size) codes.push([true, ai, i, bj, j]);\n yield;\n }\n const first = codes[0];\n const last = codes.at(-1);\n if (first?.[0]) {\n first[1] = Math.max(first[1], first[2] - 3);\n first[3] = Math.max(first[3], first[4] - 3);\n }\n if (last?.[0]) {\n last[2] = Math.min(last[2], last[1] + 3);\n last[4] = Math.min(last[4], last[3] + 3);\n }\n\n const output: string[] = [];\n function* emit(group: Opcode[]): Work<void> {\n if (!group.length || (group.length === 1 && group[0]![0])) return;\n if (!output.length) output.push(`--- ${fromfile}\\n+++ ${tofile}\\n`);\n const first = group[0]!;\n const last = group.at(-1)!;\n output.push(\n `@@ -${formatRange(first[1], last[2])} +${formatRange(first[3], last[4])} @@\\n`,\n );\n for (const [equal, aStart, aEnd, bStart, bEnd] of group) {\n for (let index = aStart; index < aEnd; index++) {\n const line = a[index]!;\n output.push((equal ? \" \" : \"-\") + line);\n if (!line.endsWith(\"\\n\")) {\n output.push(\"\\n\\\\\n\");\n }\n yield;\n }\n if (!equal) {\n for (let index = bStart; index < bEnd; index++) {\n const line = b[index]!;\n output.push(\"+\" + line);\n if (!line.endsWith(\"\\n\")) {\n output.push(\"\\n\\\\\n\");\n }\n yield;\n }\n }\n yield;\n }\n }\n\n let group: Opcode[] = [];\n for (const [equal, aStart, aEnd, bStart, bEnd] of codes) {\n if (equal && aEnd - aStart > 6) {\n group.push([true, aStart, aStart + 3, bStart, bStart + 3]);\n yield* emit(group);\n group = [[true, aEnd - 3, aEnd, bEnd - 3, bEnd]];\n } else {\n group.push([equal, aStart, aEnd, bStart, bEnd]);\n }\n yield;\n }\n yield* emit(group);\n return output.join(\"\");\n}\n\nexport async function securityPolicyUnifiedDiff(\n before: string,\n after: string,\n fromfile: string,\n tofile: string,\n signal?: AbortSignal,\n): Promise<string> {\n const work = unifiedDiff(before, after, fromfile, tofile);\n for (;;) {\n signal?.throwIfAborted();\n // Bound synchronous work, including the quadratic inner matching loop.\n for (let operation = 0; operation < 4096; operation++) {\n const result = work.next();\n if (result.done) return result.value;\n }\n await setImmediate();\n }\n}\n"]}
@@ -3,7 +3,7 @@ import type { ScanAuthentication, ScanOptions } from "./api.js";
3
3
  import type { ScanModelConfiguration } from "./config.js";
4
4
  import type { ScanCost } from "./cost.js";
5
5
  import type { ThreatModel } from "./models.js";
6
- import { type ProcessEnvironment } from "./runtime.js";
6
+ import type { ProcessEnvironment } from "./runtime.js";
7
7
  export type SecurityPolicyStage = "architecture" | "threat_model" | "policy";
8
8
  export interface SecurityPolicyOptions extends Pick<ScanOptions, "auth" | "knowledgeBasePaths" | "outputDir" | "maxCostUsd" | "signal" | "onAuthentication" | "onOutputDirReady" | "onCost" | "onWarning" | "onObserverError"> {
9
9
  path?: string;
@@ -80,8 +80,12 @@ export declare function runSecurityPolicyStages(options: {
80
80
  run(stage: SecurityPolicyStage, prompt: string): Promise<SecurityPolicyStageResult>;
81
81
  cost(): Readonly<ScanCost> | null;
82
82
  }): Promise<SecurityPolicyDraft>;
83
- /** Raw unified diff. A Python resolver is called only when there is a change.
84
- * Use CodexSecurity.previewPolicy() for terminal output. */
83
+ /**
84
+ * Raw unified diff computed in Node. Use CodexSecurity.previewPolicy() for terminal output.
85
+ * @param python Deprecated interpreter selection. Strings and resolver results no longer
86
+ * select an executable. An explicit resolver is still awaited when there is a change,
87
+ * and its errors propagate.
88
+ */
85
89
  export declare function securityPolicyDiff(draft: SecurityPolicyDraft, python?: string | (() => Promise<string>), signal?: AbortSignal): Promise<string>;
86
90
  export declare function formatSecurityPolicyText(value: string, multiline?: boolean): string;
87
91
  export {};
@@ -1 +1 @@
1
- {"version":3,"file":"security-policy.d.ts","sourceRoot":"","sources":["../src/security-policy.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"security-policy.d.ts","sourceRoot":"","sources":["../src/security-policy.ts"],"names":[],"mappings":"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"}
@@ -10,7 +10,7 @@ import { z } from "zod";
10
10
  import { jsonForPrompt } from "./codex-prompt.js";
11
11
  import { writeThreatModel } from "./artifact-export.js";
12
12
  import { CodexSecurityError, InvalidTargetError } from "./errors.js";
13
- import { resolvePluginPython } from "./runtime.js";
13
+ import { securityPolicyUnifiedDiff } from "./security-policy-diff.js";
14
14
  import { nullIfMissingFile, nullIfMissingPath, abortable, enclosingGitWorktreeRoot, enclosingGitWorktreeRoots, gitMetadataDirectories, gitObjectDirectories, isGitMetadataDirectory, normalizeRepository, normalizeTarget, relativePathIsOutside, } from "./targets.js";
15
15
  const securityPolicyRepositoryBindings = new WeakMap();
16
16
  export async function requireSecurityPolicyRepositoryBinding(target, signal) {
@@ -51,8 +51,6 @@ export function parseSecurityPolicyStageResult(value) {
51
51
  const execFileAsync = promisify(execFile);
52
52
  const MANIFEST_NAME = "policy-draft.json";
53
53
  const ORIGINAL_NAME = "previous-SECURITY.md";
54
- // This is the input contract enforced by the resolve-security-md helper.
55
- const MAX_SECURITY_MD_BYTES = 1024 * 1024;
56
54
  // The define-security-policy skill asks at most three questions at once.
57
55
  const OWNER_QUESTION_BATCH_SIZE = 3;
58
56
  async function writePolicyArtifact(path, content, signal) {
@@ -110,17 +108,7 @@ async function readPolicyFile(path, options = {}) {
110
108
  if (!options.allowHardLinks && metadata.nlink > 1) {
111
109
  throw new CodexSecurityError(`Security policy must not be a hard-linked file: ${path}. Copy it to a separate file.`);
112
110
  }
113
- validatePolicySize(metadata.size);
114
- const bytes = Buffer.allocUnsafe(MAX_SECURITY_MD_BYTES + 1);
115
- let length = 0;
116
- while (length < bytes.length) {
117
- const { bytesRead } = await file.read(bytes, length, bytes.length - length, null);
118
- if (bytesRead === 0)
119
- break;
120
- length += bytesRead;
121
- }
122
- validatePolicySize(length);
123
- return decodePolicyText(bytes.subarray(0, length), path);
111
+ return decodePolicyText(await file.readFile(), path);
124
112
  }
125
113
  finally {
126
114
  await file.close();
@@ -596,70 +584,24 @@ export async function runSecurityPolicyStages(options) {
596
584
  cost: options.cost(),
597
585
  };
598
586
  }
599
- /** Raw unified diff. A Python resolver is called only when there is a change.
600
- * Use CodexSecurity.previewPolicy() for terminal output. */
587
+ /**
588
+ * Raw unified diff computed in Node. Use CodexSecurity.previewPolicy() for terminal output.
589
+ * @param python Deprecated interpreter selection. Strings and resolver results no longer
590
+ * select an executable. An explicit resolver is still awaited when there is a change,
591
+ * and its errors propagate.
592
+ */
601
593
  export async function securityPolicyDiff(draft, python, signal) {
602
594
  draft = { ...draft };
603
595
  const target = await resolveDraftTarget(draft, signal);
604
596
  await requireUnchangedSecurityPolicy(target, draft, signal);
605
597
  if (draft.previousContent === draft.content)
606
598
  return "";
607
- const selectedPython = typeof python === "function" ? await python() : python;
608
- const interpreter = selectedPython ??
609
- (await resolvePluginPython({
610
- protectedRoot: (await enclosingGitWorktreeRoots(draft.repository, signal)).at(-1) ??
611
- draft.repository,
612
- signal,
613
- }));
599
+ if (typeof python === "function")
600
+ await python();
614
601
  const label = relative(draft.repository, draft.targetPath)
615
602
  .split(sep)
616
603
  .join("/");
617
- const script = [
618
- "import difflib, json, sys",
619
- "before, after, fromfile, tofile = json.loads(sys.stdin.buffer.read().decode('utf-8'))",
620
- "def lines(text):",
621
- " parts = text.split('\\n')",
622
- " return [part + '\\n' for part in parts[:-1]] + ([parts[-1]] if parts[-1] else [])",
623
- "for line in difflib.unified_diff(lines(before), lines(after), fromfile=fromfile, tofile=tofile):",
624
- " sys.stdout.buffer.write(line.encode('utf-8'))",
625
- " if not line.endswith('\\n'): sys.stdout.buffer.write(b'\\n\\\\\n')",
626
- ].join("\n");
627
- const diff = await new Promise((resolve, reject) => {
628
- let inputError;
629
- const child = execFile(interpreter, ["-I", "-c", script], {
630
- encoding: "utf8",
631
- maxBuffer: Infinity,
632
- signal,
633
- }, (error, stdout) => {
634
- const failure = error ?? inputError;
635
- if (failure === undefined)
636
- resolve(stdout);
637
- else
638
- reject(failure);
639
- });
640
- const releaseFailedInput = () => {
641
- if (inputError === undefined)
642
- return;
643
- if (child.exitCode === null && child.signalCode === null) {
644
- if (child.pid !== undefined)
645
- reject(inputError);
646
- return;
647
- }
648
- child.stdout.destroy();
649
- child.stderr.destroy();
650
- };
651
- child.once("exit", releaseFailedInput);
652
- child.stdin.on("error", (error) => {
653
- inputError = error;
654
- releaseFailedInput();
655
- });
656
- child.stdin.end(JSON.stringify([
657
- draft.previousContent ?? "",
658
- draft.content,
659
- draft.previousContent === null ? "/dev/null" : diffLabel(`a/${label}`),
660
- diffLabel(`b/${label}`),
661
- ]));
662
- });
604
+ const diff = await securityPolicyUnifiedDiff(draft.previousContent ?? "", draft.content, draft.previousContent === null ? "/dev/null" : diffLabel(`a/${label}`), diffLabel(`b/${label}`), signal);
663
605
  await requireUnchangedSecurityPolicy(await resolveDraftTarget(draft, signal), draft, signal);
664
606
  return diff;
665
607
  }
@@ -681,13 +623,6 @@ function validatePolicyContent(content, stage) {
681
623
  if (!content.isWellFormed()) {
682
624
  throw new CodexSecurityError(`The ${stage === "policy" ? "security policy" : stage.replace("_", " ")} must contain valid Unicode text.`);
683
625
  }
684
- if (stage === "policy")
685
- validatePolicySize(Buffer.byteLength(content, "utf8"));
686
- }
687
- function validatePolicySize(size) {
688
- if (size > MAX_SECURITY_MD_BYTES) {
689
- throw new CodexSecurityError("SECURITY.md exceeds the policy resolver's 1 MiB limit.");
690
- }
691
626
  }
692
627
  function decodePolicyText(bytes, path) {
693
628
  try {