@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
package/dist/contract.js CHANGED
@@ -19,6 +19,8 @@ const DOCUMENTS = {
19
19
  const PRODUCER_NAME = "codex-security-plugin";
20
20
  export class ContractSchemaError extends ContractValidationError {
21
21
  }
22
+ export const SEALED_DEFERRED_PATH_RULE = "invalidSealedDeferredPath";
23
+ export const DEFERRED_PATH_LOCATION = /^\/deferred\/(\d+)\/paths\/(\d+)$/u;
22
24
  export async function loadContract(scanDirectory, options) {
23
25
  return (await loadContractWithScanDirectory(scanDirectory, options)).contract;
24
26
  }
@@ -28,11 +30,17 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
28
30
  const scanDir = scanRoot.path;
29
31
  const documentDigests = new Map();
30
32
  const payloads = {};
31
- for (const filename of Object.keys(DOCUMENTS)) {
33
+ payloads["scan-manifest.json"] = await readScanJson(scanDir, "scan-manifest.json", documentDigests, options.signal, scanRoot);
34
+ const rawManifest = payloads["scan-manifest.json"];
35
+ const documents = validators.filter(({ filename }) => filename !== "coverage.json" ||
36
+ rawManifest.scan?.coverageRef !== undefined);
37
+ for (const { filename } of documents) {
38
+ if (filename === "scan-manifest.json")
39
+ continue;
32
40
  payloads[filename] = await readScanJson(scanDir, filename, documentDigests, options.signal, scanRoot);
33
41
  }
34
42
  throwIfAborted(options.signal);
35
- for (const { filename, schemaName, validate } of validators) {
43
+ for (const { filename, schemaName, validate } of documents) {
36
44
  let payload;
37
45
  let valid;
38
46
  try {
@@ -62,28 +70,36 @@ export async function loadContractWithScanDirectory(scanDirectory, options) {
62
70
  const manifest = payloads["scan-manifest.json"];
63
71
  const findings = payloads["findings.json"];
64
72
  const coverage = payloads["coverage.json"];
73
+ const mode = coverage?.mode ?? manifest.scan.mode;
74
+ const review = coverage
75
+ ? {
76
+ excludedPaths: coverage.explicitExclusions.map((item) => item.pattern),
77
+ }
78
+ : manifest.scan.review;
65
79
  if (options.expectedScanId !== undefined &&
66
80
  manifest.scan.id !== options.expectedScanId) {
67
81
  throw new ContractValidationError(`Scan artifacts do not match selected scan ${options.expectedScanId}.`);
68
82
  }
69
83
  if (findings.scanId !== manifest.scan.id ||
70
- coverage.scanId !== manifest.scan.id) {
84
+ (coverage !== undefined && coverage.scanId !== manifest.scan.id)) {
71
85
  throw new ContractValidationError("Canonical contract scan IDs do not match.");
72
86
  }
73
- if (!sameArray(coverage.includePaths, manifest.scan.scope.includePaths)) {
87
+ if (coverage !== undefined &&
88
+ !sameArray(coverage.includePaths, manifest.scan.scope.includePaths)) {
74
89
  throw new ContractValidationError("Coverage include paths do not match the manifest scope.");
75
90
  }
76
- if (!sameArray(coverage.excludePaths, manifest.scan.scope.excludePaths)) {
91
+ if (coverage !== undefined &&
92
+ !sameArray(coverage.excludePaths, manifest.scan.scope.excludePaths)) {
77
93
  throw new ContractValidationError("Coverage exclude paths do not match the manifest scope.");
78
94
  }
79
95
  validateCanonicalContract(manifest, findings, coverage);
80
96
  await validateSeal(scanDir, manifest, findings, coverage, documentDigests, options.signal, scanRoot);
81
97
  if (options.expectation !== undefined) {
82
- validateExpectation(manifest, coverage, options.expectation, options.workbenchValidated === true);
98
+ validateExpectation(manifest, mode, options.expectation, options.workbenchValidated === true);
83
99
  }
84
100
  await verifyScanRoot(scanRoot, options.signal);
85
101
  return {
86
- contract: { manifest, findings, coverage },
102
+ contract: { manifest, findings, review, mode },
87
103
  scanDirectory: scanRoot.path,
88
104
  };
89
105
  }
@@ -105,10 +121,37 @@ export function hasRequiredFindingText(value) {
105
121
  return !/^[\p{White_Space}\u001c-\u001f]*$/u.test(value);
106
122
  }
107
123
  function validateCanonicalContract(manifest, findings, coverage) {
124
+ const requireText = (values) => {
125
+ for (const [context, value] of Object.entries(values)) {
126
+ if (value !== undefined && !hasRequiredFindingText(value))
127
+ throw new ContractValidationError(`${context}: expected a non-empty string.`);
128
+ }
129
+ };
130
+ requireText({
131
+ "manifest.scan.id": manifest.scan.id,
132
+ "scan.target.targetId": manifest.scan.target.targetId,
133
+ "scan.target.displayName": manifest.scan.target.displayName,
134
+ "scan.target.revision": manifest.scan.target.kind === "git_revision"
135
+ ? manifest.scan.target.revision
136
+ : undefined,
137
+ "scan.target.snapshotDigest": manifest.scan.target.kind !== "git_revision"
138
+ ? manifest.scan.target.snapshotDigest
139
+ : undefined,
140
+ "manifest.scan.producer.name": manifest.scan.producer.name,
141
+ "manifest.scan.producer.version": manifest.scan.producer.version,
142
+ "coverage.inventoryStrategy": coverage?.inventoryStrategy,
143
+ });
144
+ for (const [index, surface] of (coverage?.surfaces ?? []).entries())
145
+ requireText({
146
+ [`coverage.surfaces[${index}].id`]: surface.id,
147
+ [`coverage.surfaces[${index}].label`]: surface.label,
148
+ });
108
149
  const remote = manifest.scan.target.remote;
109
150
  if (remote !== undefined) {
110
151
  const authority = /^[A-Za-z][A-Za-z0-9+.-]*:\/\/([^/?#]+)/.exec(remote)?.[1];
111
- if (remote.includes("\\") || authority === undefined) {
152
+ if (remote.includes("\\") ||
153
+ /[\u0000-\u001f\u007f-\u009f\u2028\u2029]/u.test(remote) ||
154
+ authority === undefined) {
112
155
  throw new ContractValidationError("scan.target.remote: expected a sanitized canonical absolute URL.");
113
156
  }
114
157
  if (authority.includes("@")) {
@@ -141,7 +184,7 @@ function validateCanonicalContract(manifest, findings, coverage) {
141
184
  }
142
185
  }
143
186
  }
144
- for (const [index, deferred] of coverage.deferred.entries()) {
187
+ for (const [index, deferred] of (coverage?.deferred ?? []).entries()) {
145
188
  for (const [pathIndex, path] of (deferred.paths ?? []).entries()) {
146
189
  const context = `coverage.deferred[${index}].paths[${pathIndex}]`;
147
190
  try {
@@ -152,28 +195,23 @@ function validateCanonicalContract(manifest, findings, coverage) {
152
195
  }
153
196
  }
154
197
  }
155
- const findingIds = new Set();
198
+ const occurrenceIds = new Set();
156
199
  for (const [findingIndex, finding] of findings.findings.entries()) {
157
200
  const context = `findings.findings[${findingIndex}]`;
158
- if (findingIds.has(finding.findingId)) {
159
- throw new ContractValidationError(`${context}: duplicate finding id.`);
160
- }
161
- findingIds.add(finding.findingId);
162
- for (const [field, value] of [
163
- ["title", finding.title],
164
- ["summary", finding.summary],
165
- ["remediation", finding.remediation],
166
- ["confidence.rationale", finding.confidence.rationale],
167
- ["taxonomy.category", finding.taxonomy.category],
168
- ["provenance.source", finding.provenance.source],
169
- ...(finding.severity.score === undefined
170
- ? []
171
- : [["severity.scoringSystem", finding.severity.scoringSystem]]),
172
- ]) {
173
- if (!hasRequiredFindingText(value ?? "")) {
174
- throw new ContractValidationError(`${context}.${field}: expected a non-empty string.`);
175
- }
176
- }
201
+ requireText({
202
+ [`${context}.title`]: finding.title,
203
+ [`${context}.summary`]: finding.summary,
204
+ [`${context}.remediation`]: finding.remediation,
205
+ [`${context}.confidence.rationale`]: finding.confidence.rationale,
206
+ [`${context}.severity.scoringSystem`]: finding.severity.score === undefined
207
+ ? undefined
208
+ : (finding.severity.scoringSystem ?? ""),
209
+ [`${context}.taxonomy.category`]: finding.taxonomy.category,
210
+ [`${context}.provenance.source`]: finding.provenance.source,
211
+ });
212
+ if (occurrenceIds.has(finding.occurrenceId))
213
+ throw new ContractValidationError(`${context}: duplicate finding occurrence identity; use identity.instance to split siblings.`);
214
+ occurrenceIds.add(finding.occurrenceId);
177
215
  for (const [locationIndex, location] of finding.locations.entries()) {
178
216
  const locationContext = `${context}.locations[${locationIndex}]`;
179
217
  try {
@@ -238,7 +276,7 @@ async function requireCheckedScanFile(scanDirectory, relativePath, context, sign
238
276
  throwIfAborted(signal);
239
277
  for (const part of parts.slice(0, -1)) {
240
278
  current = join(current, part);
241
- const metadata = await lstat(current);
279
+ const metadata = await lstat(current, { bigint: true });
242
280
  throwIfAborted(signal);
243
281
  if (!metadata.isDirectory()) {
244
282
  throw new Error("unsafe parent");
@@ -246,7 +284,7 @@ async function requireCheckedScanFile(scanDirectory, relativePath, context, sign
246
284
  parents.push({ path: current, metadata });
247
285
  }
248
286
  const path = join(scanDir, ...parts);
249
- const metadata = await lstat(path);
287
+ const metadata = await lstat(path, { bigint: true });
250
288
  throwIfAborted(signal);
251
289
  if (!metadata.isFile()) {
252
290
  throw new ContractValidationError(`${context}: expected a regular non-symlink file.`);
@@ -304,7 +342,7 @@ async function validateSeal(scanDir, manifest, findings, coverage, documentDiges
304
342
  throw new ContractValidationError(`${context} is missing from sealed artifacts: ${reference}`);
305
343
  }
306
344
  };
307
- for (const surface of coverage.surfaces) {
345
+ for (const surface of coverage?.surfaces ?? []) {
308
346
  for (const receipt of surface.receiptRefs) {
309
347
  requireSealedReference(receipt, "Coverage receipt");
310
348
  }
@@ -327,7 +365,7 @@ async function validateSeal(scanDir, manifest, findings, coverage, documentDiges
327
365
  await file.close();
328
366
  }
329
367
  }
330
- function validateExpectation(manifest, coverage, expectation, workbenchValidated = false) {
368
+ function validateExpectation(manifest, mode, expectation, workbenchValidated = false) {
331
369
  const scan = manifest.scan;
332
370
  if (scan.producer.name !== PRODUCER_NAME) {
333
371
  throw new ContractValidationError(`Manifest producer must be ${PRODUCER_NAME}, got ${scan.producer.name}.`);
@@ -336,8 +374,8 @@ function validateExpectation(manifest, coverage, expectation, workbenchValidated
336
374
  throw new ContractValidationError("Manifest producer version does not match the installed Codex Security plugin.");
337
375
  }
338
376
  const expectedMode = expectedCoverageMode(expectation.target, expectation.mode);
339
- if (coverage.mode !== expectedMode) {
340
- throw new ContractValidationError(`Coverage mode must be ${expectedMode}, got ${coverage.mode}.`);
377
+ if (mode !== expectedMode) {
378
+ throw new ContractValidationError(`Coverage mode must be ${expectedMode}, got ${mode}.`);
341
379
  }
342
380
  const requested = expectation.target;
343
381
  if (!workbenchValidated) {
@@ -386,13 +424,13 @@ async function requireScanRoot(scanDirectory, signal) {
386
424
  throwIfAborted(signal);
387
425
  const absolute = resolve(scanDirectory);
388
426
  try {
389
- const metadata = await lstat(absolute);
427
+ const metadata = await lstat(absolute, { bigint: true });
390
428
  throwIfAborted(signal);
391
429
  const canonical = await realpath(absolute);
392
430
  throwIfAborted(signal);
393
- const current = await lstat(absolute);
431
+ const current = await lstat(absolute, { bigint: true });
394
432
  throwIfAborted(signal);
395
- const returned = await lstat(canonical);
433
+ const returned = await lstat(canonical, { bigint: true });
396
434
  throwIfAborted(signal);
397
435
  if (!metadata.isDirectory() ||
398
436
  !current.isDirectory() ||
@@ -404,7 +442,7 @@ async function requireScanRoot(scanDirectory, signal) {
404
442
  throw new Error("not a directory");
405
443
  }
406
444
  try {
407
- requirePrivateOutputDirectory(returned, canonical);
445
+ requirePrivateOutputDirectory({ mode: Number(returned.mode), uid: Number(returned.uid) }, canonical);
408
446
  await requireSecureOutputAncestry(canonical);
409
447
  }
410
448
  catch (error) {
@@ -423,14 +461,14 @@ async function requireScanRoot(scanDirectory, signal) {
423
461
  }
424
462
  async function verifyScanRoot(root, signal) {
425
463
  try {
426
- const current = await lstat(root.path);
464
+ const current = await lstat(root.path, { bigint: true });
427
465
  throwIfAborted(signal);
428
466
  if (!current.isDirectory() ||
429
467
  current.dev !== root.metadata.dev ||
430
468
  current.ino !== root.metadata.ino) {
431
469
  throw new Error("scan directory changed while reading");
432
470
  }
433
- requirePrivateOutputDirectory(current, root.path);
471
+ requirePrivateOutputDirectory({ mode: Number(current.mode), uid: Number(current.uid) }, root.path);
434
472
  await requireSecureOutputAncestry(root.path);
435
473
  }
436
474
  catch (error) {
@@ -562,7 +600,7 @@ async function loadContractValidators(pluginRoot, signal) {
562
600
  // The plugin schemas are the immutable v0 contract. They are valid Draft
563
601
  // 2020-12 but intentionally omit redundant local `type` keywords that Ajv's
564
602
  // optional strict-schema linter requires.
565
- const ajv = new Ajv2020({ allErrors: false, strict: false });
603
+ const ajv = new Ajv2020({ allErrors: false, strict: false, verbose: true });
566
604
  ajv.addFormat("date-time", {
567
605
  type: "string",
568
606
  validate: validRfc3339DateTime,
@@ -612,7 +650,7 @@ async function openCheckedScanFile(scanDir, relativePath, context, signal, expec
612
650
  let file;
613
651
  try {
614
652
  file = await open(checked.path, constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK);
615
- const opened = await file.stat();
653
+ const opened = await file.stat({ bigint: true });
616
654
  throwIfAborted(signal);
617
655
  if (!opened.isFile() ||
618
656
  opened.ino !== checked.metadata.ino ||
@@ -620,7 +658,7 @@ async function openCheckedScanFile(scanDir, relativePath, context, signal, expec
620
658
  throw new ContractValidationError(`${context}: expected the checked regular file.`);
621
659
  }
622
660
  for (const parent of checked.parents) {
623
- const current = await lstat(parent.path);
661
+ const current = await lstat(parent.path, { bigint: true });
624
662
  throwIfAborted(signal);
625
663
  if (!current.isDirectory() ||
626
664
  current.dev !== parent.metadata.dev ||
@@ -628,7 +666,7 @@ async function openCheckedScanFile(scanDir, relativePath, context, signal, expec
628
666
  throw new ContractValidationError(`${context}: checked parent changed before opening the file.`);
629
667
  }
630
668
  }
631
- const current = await lstat(checked.path);
669
+ const current = await lstat(checked.path, { bigint: true });
632
670
  throwIfAborted(signal);
633
671
  if (!current.isFile() ||
634
672
  current.dev !== checked.metadata.dev ||
@@ -683,6 +721,16 @@ function validRfc3339DateTime(value) {
683
721
  }
684
722
  function schemaError(filename, errors) {
685
723
  const first = errors[0];
724
+ if (filename === "coverage.json" &&
725
+ first?.keyword === "oneOf" &&
726
+ Array.isArray(first.schema) &&
727
+ first.schema.some((rule, index) => isRecord(rule) &&
728
+ rule["$comment"] === SEALED_DEFERRED_PATH_RULE &&
729
+ first.params["passingSchemas"]?.includes(index))) {
730
+ const match = DEFERRED_PATH_LOCATION.exec(first.instancePath);
731
+ if (match)
732
+ return new ContractValidationError(`coverage.deferred[${match[1]}].paths[${match[2]}]: expected a safe repository-relative POSIX path.`);
733
+ }
686
734
  const location = first?.instancePath
687
735
  ? JSON.stringify(first.instancePath)
688
736
  : "<root>";
@@ -1 +1 @@
1
- {"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"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","sourcesContent":["import { isDeepStrictEqual as sameArray } from \"node:util\";\nimport { createHash, hash } from \"node:crypto\";\nimport { normalizePersistedFindingDetails } from \"./finding-normalization.js\";\nimport { constants, type BigIntStats, type Stats } from \"node:fs\";\nimport {\n lstat,\n open,\n readFile,\n realpath,\n type FileHandle,\n} from \"node:fs/promises\";\nimport { isAbsolute, join, posix, resolve } from \"node:path\";\nimport Ajv2020, { type ErrorObject } from \"ajv/dist/2020.js\";\nimport { regexes } from \"zod\";\nimport {\n ContractValidationError,\n abortReason,\n errorMessage,\n} from \"./errors.js\";\nimport { isRecord } from \"./record.js\";\nimport type {\n CoverageDocument,\n Finding,\n FindingsDocument,\n ScanManifest,\n} from \"./models.js\";\nimport {\n requirePrivateOutputDirectory,\n requireSecureOutputAncestry,\n} from \"./runtime.js\";\nimport type { NormalizedTarget, ScanMode } from \"./targets.js\";\nimport { isWithin as isContained } from \"./trusted-executable.js\";\nimport { isWindowsUnsafePathComponent } from \"./windows-path.js\";\n\nconst DOCUMENTS = {\n \"scan-manifest.json\": \"scan-manifest.schema.json\",\n \"findings.json\": \"findings.schema.json\",\n \"coverage.json\": \"coverage.schema.json\",\n} as const;\nconst PRODUCER_NAME = \"codex-security-plugin\";\ninterface CheckedScanFile {\n path: string;\n metadata: Stats;\n parents: Array<{ path: string; metadata: Stats }>;\n}\n\ninterface ScanRoot {\n path: string;\n metadata: Stats;\n}\n\nexport interface ScanExpectation {\n repository: string;\n repositoryRevision: string | null;\n target: NormalizedTarget;\n mode: ScanMode;\n pluginVersion: string;\n}\n\nexport interface LoadedContract {\n manifest: ScanManifest;\n findings: FindingsDocument;\n coverage: CoverageDocument;\n}\n\nexport class ContractSchemaError extends ContractValidationError {}\n\ntype LoadContractOptions = {\n pluginRoot: string;\n expectedScanId?: string;\n expectation?: ScanExpectation;\n workbenchValidated?: boolean;\n signal?: AbortSignal;\n};\n\nexport async function loadContract(\n scanDirectory: string,\n options: LoadContractOptions,\n): Promise<LoadedContract> {\n return (await loadContractWithScanDirectory(scanDirectory, options)).contract;\n}\n\nexport async function loadContractWithScanDirectory(\n scanDirectory: string,\n options: LoadContractOptions,\n): Promise<{ contract: LoadedContract; scanDirectory: string }> {\n const validators = await loadContractValidators(\n options.pluginRoot,\n options.signal,\n );\n const scanRoot = await requireScanRoot(scanDirectory, options.signal);\n const scanDir = scanRoot.path;\n const documentDigests = new Map<string, string>();\n const payloads: Record<string, unknown> = {};\n for (const filename of Object.keys(DOCUMENTS)) {\n payloads[filename] = await readScanJson(\n scanDir,\n filename as keyof typeof DOCUMENTS,\n documentDigests,\n options.signal,\n scanRoot,\n );\n }\n throwIfAborted(options.signal);\n\n for (const { filename, schemaName, validate } of validators) {\n let payload: unknown;\n let valid: boolean;\n try {\n payload = payloads[filename];\n const validatePayload = (payload: unknown) => {\n const result = validate(payload);\n if (typeof result !== \"boolean\") {\n throw new Error(\"asynchronous JSON Schema validation is unsupported\");\n }\n return result;\n };\n valid = validatePayload(payload);\n if (!valid && filename === \"findings.json\") {\n payload = normalizePersistedFindings(payload);\n valid = validatePayload(payload);\n }\n } catch {\n throw new ContractSchemaError(`${schemaName}: invalid JSON Schema.`);\n }\n if (!valid) {\n throw schemaError(filename, validate.errors ?? []);\n }\n payloads[filename] = payload;\n throwIfAborted(options.signal);\n }\n const manifest = payloads[\"scan-manifest.json\"] as ScanManifest;\n const findings = payloads[\"findings.json\"] as FindingsDocument;\n const coverage = payloads[\"coverage.json\"] as CoverageDocument;\n if (\n options.expectedScanId !== undefined &&\n manifest.scan.id !== options.expectedScanId\n ) {\n throw new ContractValidationError(\n `Scan artifacts do not match selected scan ${options.expectedScanId}.`,\n );\n }\n if (\n findings.scanId !== manifest.scan.id ||\n coverage.scanId !== manifest.scan.id\n ) {\n throw new ContractValidationError(\n \"Canonical contract scan IDs do not match.\",\n );\n }\n if (!sameArray(coverage.includePaths, manifest.scan.scope.includePaths)) {\n throw new ContractValidationError(\n \"Coverage include paths do not match the manifest scope.\",\n );\n }\n if (!sameArray(coverage.excludePaths, manifest.scan.scope.excludePaths)) {\n throw new ContractValidationError(\n \"Coverage exclude paths do not match the manifest scope.\",\n );\n }\n\n validateCanonicalContract(manifest, findings, coverage);\n\n await validateSeal(\n scanDir,\n manifest,\n findings,\n coverage,\n documentDigests,\n options.signal,\n scanRoot,\n );\n if (options.expectation !== undefined) {\n validateExpectation(\n manifest,\n coverage,\n options.expectation,\n options.workbenchValidated === true,\n );\n }\n await verifyScanRoot(scanRoot, options.signal);\n return {\n contract: { manifest, findings, coverage },\n scanDirectory: scanRoot.path,\n };\n}\n\n/** Normalize optional legacy details on a copy, without changing saved artifacts. */\nfunction normalizePersistedFindings(payload: unknown): unknown {\n const compatible = structuredClone(payload);\n if (!isRecord(compatible) || !Array.isArray(compatible[\"findings\"])) {\n return compatible;\n }\n for (const finding of compatible[\"findings\"]) {\n if (!isRecord(finding)) continue;\n normalizePersistedFindingDetails(finding);\n }\n return compatible;\n}\n\n/** Match the producer's Python str.strip without changing saved text. */\nexport function hasRequiredFindingText(value: string): boolean {\n return !/^[\\p{White_Space}\\u001c-\\u001f]*$/u.test(value);\n}\n\nfunction validateCanonicalContract(\n manifest: ScanManifest,\n findings: FindingsDocument,\n coverage: CoverageDocument,\n): void {\n const remote = manifest.scan.target.remote;\n if (remote !== undefined) {\n const authority = /^[A-Za-z][A-Za-z0-9+.-]*:\\/\\/([^/?#]+)/.exec(\n remote,\n )?.[1];\n if (remote.includes(\"\\\\\") || authority === undefined) {\n throw new ContractValidationError(\n \"scan.target.remote: expected a sanitized canonical absolute URL.\",\n );\n }\n if (authority.includes(\"@\")) {\n throw new ContractValidationError(\n \"scan.target.remote: remote URL must not contain credentials, query, or fragment.\",\n );\n }\n let parsed: URL;\n try {\n parsed = new URL(remote);\n } catch (error) {\n throw new ContractValidationError(\n \"scan.target.remote: expected a sanitized canonical absolute URL.\",\n { cause: error },\n );\n }\n if (parsed.protocol.length === 0 || parsed.host.length === 0) {\n throw new ContractValidationError(\n \"scan.target.remote: expected a sanitized canonical absolute URL.\",\n );\n }\n if (\n parsed.username.length > 0 ||\n parsed.password.length > 0 ||\n parsed.search.length > 0 ||\n parsed.hash.length > 0\n ) {\n throw new ContractValidationError(\n \"scan.target.remote: remote URL must not contain credentials, query, or fragment.\",\n );\n }\n }\n\n for (const field of [\"includePaths\", \"excludePaths\"] as const) {\n for (const [index, value] of manifest.scan.scope[field].entries()) {\n try {\n safeScopePath(value);\n } catch (error) {\n throw new ContractValidationError(\n `manifest.scan.scope.${field}[${index}]: expected a safe repository-relative POSIX path.`,\n { cause: error },\n );\n }\n }\n }\n\n for (const [index, deferred] of coverage.deferred.entries()) {\n for (const [pathIndex, path] of (deferred.paths ?? []).entries()) {\n const context = `coverage.deferred[${index}].paths[${pathIndex}]`;\n try {\n safeRelativePath(path, context, true);\n } catch (error) {\n throw new ContractValidationError(\n `${context}: expected a safe repository-relative POSIX path.`,\n { cause: error },\n );\n }\n }\n }\n\n const findingIds = new Set<string>();\n for (const [findingIndex, finding] of findings.findings.entries()) {\n const context = `findings.findings[${findingIndex}]`;\n if (findingIds.has(finding.findingId)) {\n throw new ContractValidationError(`${context}: duplicate finding id.`);\n }\n findingIds.add(finding.findingId);\n for (const [field, value] of [\n [\"title\", finding.title],\n [\"summary\", finding.summary],\n [\"remediation\", finding.remediation],\n [\"confidence.rationale\", finding.confidence.rationale],\n [\"taxonomy.category\", finding.taxonomy.category],\n [\"provenance.source\", finding.provenance.source],\n ...(finding.severity.score === undefined\n ? []\n : [[\"severity.scoringSystem\", finding.severity.scoringSystem]]),\n ]) {\n if (!hasRequiredFindingText(value ?? \"\")) {\n throw new ContractValidationError(\n `${context}.${field}: expected a non-empty string.`,\n );\n }\n }\n for (const [locationIndex, location] of finding.locations.entries()) {\n const locationContext = `${context}.locations[${locationIndex}]`;\n try {\n safeRelativePath(location.path, `${locationContext}.path`);\n } catch (error) {\n throw new ContractValidationError(\n `${locationContext}.path: expected a safe repository-relative POSIX path.`,\n { cause: error },\n );\n }\n if ((location.endLine ?? location.startLine) < location.startLine) {\n throw new ContractValidationError(\n `${locationContext}.endLine: expected an integer >= startLine.`,\n );\n }\n }\n for (const [evidenceIndex, evidence] of (\n finding.codeEvidence ?? []\n ).entries()) {\n const evidenceContext = `${context}.codeEvidence[${evidenceIndex}].path`;\n try {\n safeRelativePath(evidence.path, evidenceContext);\n } catch (error) {\n throw new ContractValidationError(\n `${evidenceContext}: expected a safe repository-relative POSIX path.`,\n { cause: error },\n );\n }\n }\n\n const { findingId, occurrenceId, fingerprints } = deriveFindingIdentity(\n manifest.scan.id,\n manifest.scan.target.targetId,\n finding.ruleId,\n finding.identity,\n );\n if (finding.findingId !== findingId) {\n throw new ContractValidationError(\n `${context}.findingId: does not match derived fingerprint identity.`,\n );\n }\n if (finding.occurrenceId !== occurrenceId) {\n throw new ContractValidationError(\n `${context}.occurrenceId: does not match scan occurrence identity.`,\n );\n }\n if (finding.fingerprints.primary !== fingerprints.primary) {\n throw new ContractValidationError(\n `${context}.fingerprints: does not match derived fingerprint.`,\n );\n }\n }\n}\n\nexport async function requireScanFile(\n scanDirectory: string,\n relativePath: string,\n context: string,\n signal?: AbortSignal,\n): Promise<string> {\n return (\n await requireCheckedScanFile(scanDirectory, relativePath, context, signal)\n ).path;\n}\n\nexport async function readScanFile(\n scanDirectory: string,\n relativePath: string,\n context: string,\n signal?: AbortSignal,\n): Promise<Buffer> {\n const file = await openCheckedScanFile(\n scanDirectory,\n relativePath,\n context,\n signal,\n );\n try {\n return await file.readFile({ signal });\n } finally {\n await file.close();\n }\n}\n\nasync function requireCheckedScanFile(\n scanDirectory: string,\n relativePath: string,\n context: string,\n signal?: AbortSignal,\n expectedRoot?: ScanRoot,\n): Promise<CheckedScanFile> {\n const checkedRoot = await requireScanRoot(scanDirectory, signal);\n const scanDir = checkedRoot.path;\n throwIfAborted(signal);\n const safePath = portableRelativePath(relativePath, context);\n const parts = safePath.split(\"/\");\n let current = scanDir;\n try {\n const rootMetadata = checkedRoot.metadata;\n if (\n expectedRoot !== undefined &&\n (scanDir !== expectedRoot.path ||\n rootMetadata.dev !== expectedRoot.metadata.dev ||\n rootMetadata.ino !== expectedRoot.metadata.ino)\n ) {\n throw new Error(\"scan directory changed while reading\");\n }\n const parents = [{ path: scanDir, metadata: rootMetadata }];\n throwIfAborted(signal);\n for (const part of parts.slice(0, -1)) {\n current = join(current, part);\n const metadata = await lstat(current);\n throwIfAborted(signal);\n if (!metadata.isDirectory()) {\n throw new Error(\"unsafe parent\");\n }\n parents.push({ path: current, metadata });\n }\n const path = join(scanDir, ...parts);\n const metadata = await lstat(path);\n throwIfAborted(signal);\n if (!metadata.isFile()) {\n throw new ContractValidationError(\n `${context}: expected a regular non-symlink file.`,\n );\n }\n const canonical = await realpath(path);\n throwIfAborted(signal);\n if (!isContained(scanDir, canonical)) {\n throw new Error(\"outside scan directory\");\n }\n return { path, metadata, parents };\n } catch (error) {\n throwIfAborted(signal);\n if (error instanceof ContractValidationError) {\n throw error;\n }\n throw new ContractValidationError(\n `${context}: expected a file inside the scan directory.`,\n {\n cause: error,\n },\n );\n }\n}\n\nasync function validateSeal(\n scanDir: string,\n manifest: ScanManifest,\n findings: FindingsDocument,\n coverage: CoverageDocument,\n documentDigests: ReadonlyMap<string, string>,\n signal?: AbortSignal,\n expectedRoot?: ScanRoot,\n): Promise<void> {\n const scan = manifest.scan;\n if (scan.sealedAt !== scan.completedAt) {\n throw new ContractValidationError(\n \"Manifest sealedAt must match completedAt.\",\n );\n }\n\n const artifactPaths = new Set<string>();\n const artifactCollisionKeys = new Set<string>();\n for (const [index, artifact] of scan.artifacts.entries()) {\n throwIfAborted(signal);\n const context = `manifest.scan.artifacts[${index}]`;\n const normalized = portableRelativePath(artifact.path, `${context}.path`);\n const collisionKey = normalized.toLowerCase();\n if (artifactCollisionKeys.has(collisionKey)) {\n throw new ContractValidationError(\n `${context}.path: duplicate artifact path.`,\n );\n }\n artifactPaths.add(normalized);\n artifactCollisionKeys.add(collisionKey);\n const digest =\n documentDigests.get(normalized) ??\n (await sha256ScanFile(\n scanDir,\n normalized,\n context,\n signal,\n expectedRoot,\n ));\n if (digest !== artifact.sha256) {\n throw new ContractValidationError(\n `${context}: sealed artifact changed or is missing.`,\n );\n }\n }\n\n const requireSealedReference = (reference: unknown, context: string) => {\n throwIfAborted(signal);\n if (typeof reference !== \"string\") {\n throw new ContractValidationError(`${context}: expected a string.`);\n }\n const normalized = portableRelativePath(reference, context.toLowerCase());\n if (!normalized.startsWith(\"artifacts/\")) {\n throw new ContractValidationError(\n `${context} must be under artifacts/: ${reference}`,\n );\n }\n if (!artifactPaths.has(normalized)) {\n throw new ContractValidationError(\n `${context} is missing from sealed artifacts: ${reference}`,\n );\n }\n };\n for (const surface of coverage.surfaces) {\n for (const receipt of surface.receiptRefs) {\n requireSealedReference(receipt, \"Coverage receipt\");\n }\n }\n const extensions = scan[\"extensions\"];\n const imported = isRecord(extensions) ? extensions[\"import\"] : undefined;\n if (isRecord(imported) && \"sourceRef\" in imported) {\n requireSealedReference(imported[\"sourceRef\"], \"Import source\");\n }\n\n for (const [index, finding] of findings.findings.entries()) {\n const writeup = finding.writeup;\n if (writeup === undefined) continue;\n const file = await openCheckedScanFile(\n scanDir,\n writeup.reportPath,\n `findings[${index}].writeup.reportPath`,\n signal,\n expectedRoot,\n );\n await file.close();\n }\n const hardening = manifest.scan.hardening;\n if (hardening !== undefined) {\n const file = await openCheckedScanFile(\n scanDir,\n hardening.portfolioPath,\n \"manifest.scan.hardening.portfolioPath\",\n signal,\n expectedRoot,\n );\n await file.close();\n }\n}\n\nfunction validateExpectation(\n manifest: ScanManifest,\n coverage: CoverageDocument,\n expectation: ScanExpectation,\n workbenchValidated = false,\n): void {\n const scan = manifest.scan;\n if (scan.producer.name !== PRODUCER_NAME) {\n throw new ContractValidationError(\n `Manifest producer must be ${PRODUCER_NAME}, got ${scan.producer.name}.`,\n );\n }\n if (scan.producer.version !== expectation.pluginVersion) {\n throw new ContractValidationError(\n \"Manifest producer version does not match the installed Codex Security plugin.\",\n );\n }\n\n const expectedMode = expectedCoverageMode(\n expectation.target,\n expectation.mode,\n );\n if (coverage.mode !== expectedMode) {\n throw new ContractValidationError(\n `Coverage mode must be ${expectedMode}, got ${coverage.mode}.`,\n );\n }\n\n const requested = expectation.target;\n if (!workbenchValidated) {\n const target = scan.target;\n if (requested.kind === \"refs\" || requested.kind === \"working_tree\") {\n if (target.kind !== \"git_diff\") {\n throw new ContractValidationError(\n \"Diff scan manifest target must be git_diff.\",\n );\n }\n if (target.baseRevision !== requested.base) {\n throw new ContractValidationError(\n \"Diff scan base revision does not match the request.\",\n );\n }\n if (target.headRevision !== requested.head) {\n throw new ContractValidationError(\n \"Diff scan head revision does not match the request.\",\n );\n }\n } else if (target.kind === \"git_diff\") {\n throw new ContractValidationError(\n \"Repository scan manifest target must not be git_diff.\",\n );\n } else if (\n target.kind !== \"directory_snapshot\" &&\n expectation.repositoryRevision !== null &&\n target.revision !== expectation.repositoryRevision\n ) {\n throw new ContractValidationError(\n \"Scan target revision does not match the repository.\",\n );\n }\n }\n\n if (requested.kind === \"paths\") {\n const actualPaths = scan.scope.includePaths.map(safeScopePath);\n const actual = new Set(actualPaths);\n if (actualPaths.length === actual.size) {\n const expected = new Set(requested.paths);\n if (actual.size === expected.size && actual.isSubsetOf(expected)) return;\n }\n throw new ContractValidationError(\n \"Manifest include paths do not match the requested path target.\",\n );\n }\n}\n\nfunction expectedCoverageMode(\n target: NormalizedTarget,\n mode: ScanMode,\n): CoverageDocument[\"mode\"] {\n if (target.kind === \"paths\") return \"scoped_path\";\n if (target.kind === \"refs\") return \"branch_diff\";\n if (target.kind === \"working_tree\") return \"working_tree\";\n return mode === \"deep\" ? \"deep_repository\" : \"repository\";\n}\n\nasync function requireScanRoot(\n scanDirectory: string,\n signal?: AbortSignal,\n): Promise<ScanRoot> {\n throwIfAborted(signal);\n const absolute = resolve(scanDirectory);\n try {\n const metadata = await lstat(absolute);\n throwIfAborted(signal);\n const canonical = await realpath(absolute);\n throwIfAborted(signal);\n const current = await lstat(absolute);\n throwIfAborted(signal);\n const returned = await lstat(canonical);\n throwIfAborted(signal);\n if (\n !metadata.isDirectory() ||\n !current.isDirectory() ||\n metadata.dev !== current.dev ||\n metadata.ino !== current.ino ||\n !returned.isDirectory() ||\n metadata.dev !== returned.dev ||\n metadata.ino !== returned.ino\n ) {\n throw new Error(\"not a directory\");\n }\n try {\n requirePrivateOutputDirectory(returned, canonical);\n await requireSecureOutputAncestry(canonical);\n } catch (error) {\n throw new ContractValidationError(\n error instanceof Error\n ? error.message\n : \"Scan directory must remain private to the current user.\",\n { cause: error },\n );\n }\n return { path: canonical, metadata: returned };\n } catch (error) {\n throwIfAborted(signal);\n if (error instanceof ContractValidationError) throw error;\n throw new ContractValidationError(\n \"Scan directory must be an existing non-symlink directory.\",\n { cause: error },\n );\n }\n}\n\nasync function verifyScanRoot(\n root: ScanRoot,\n signal?: AbortSignal,\n): Promise<void> {\n try {\n const current = await lstat(root.path);\n throwIfAborted(signal);\n if (\n !current.isDirectory() ||\n current.dev !== root.metadata.dev ||\n current.ino !== root.metadata.ino\n ) {\n throw new Error(\"scan directory changed while reading\");\n }\n requirePrivateOutputDirectory(current, root.path);\n await requireSecureOutputAncestry(root.path);\n } catch (error) {\n throwIfAborted(signal);\n throw new ContractValidationError(\n \"Scan directory changed while reading the canonical contract.\",\n { cause: error },\n );\n }\n}\n\nfunction safeRelativePath(\n value: string,\n context: string,\n allowDot = false,\n): string {\n const parts = value.split(\"/\");\n if (\n value.length === 0 ||\n Buffer.from(value, \"utf8\").toString(\"utf8\") !== value ||\n (!allowDot && value === \".\") ||\n value.startsWith(\"/\") ||\n /^[A-Za-z]:/.test(value) ||\n parts.includes(\"..\") ||\n value.includes(\"\\\\\") ||\n /[\\u0000-\\u001f]/u.test(value)\n ) {\n throw new ContractValidationError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n }\n const normalized = posix.normalize(value).replace(/\\/+$/, \"\");\n if (\n (!allowDot && normalized === \".\") ||\n normalized.startsWith(\"../\") ||\n isAbsolute(normalized)\n ) {\n throw new ContractValidationError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n }\n return normalized;\n}\n\nfunction portableRelativePath(value: string, context: string): string {\n const normalized = safeRelativePath(value, context);\n if (\n value.trim().length === 0 ||\n value.split(\"/\").some(isWindowsUnsafePathComponent)\n ) {\n throw new ContractValidationError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n }\n return normalized;\n}\n\nexport function safeScopePath(value: string): string {\n return value === \".\"\n ? value\n : safeRelativePath(value, \"manifest scope include path\");\n}\n\nasync function readScanJson(\n scanDir: string,\n relativePath: keyof typeof DOCUMENTS,\n documentDigests: Map<string, string>,\n signal?: AbortSignal,\n expectedRoot?: ScanRoot,\n): Promise<Record<string, unknown>> {\n const file = await openCheckedScanFile(\n scanDir,\n relativePath,\n relativePath,\n signal,\n expectedRoot,\n );\n try {\n const bytes = await file.readFile({ signal });\n documentDigests.set(relativePath, hash(\"sha256\", bytes));\n return parseJson(join(scanDir, relativePath), bytes);\n } catch (error) {\n throwIfAborted(signal);\n if (error instanceof ContractValidationError) throw error;\n throw new ContractValidationError(\n `${join(scanDir, relativePath)}: unreadable JSON document.`,\n { cause: error },\n );\n } finally {\n await file.close();\n }\n}\n\nasync function readJson(\n path: string,\n signal?: AbortSignal,\n): Promise<Record<string, unknown>> {\n try {\n return parseJson(path, await readFile(path, { signal }));\n } catch (error) {\n throwIfAborted(signal);\n if (error instanceof ContractValidationError) throw error;\n if (nodeErrorCode(error) === \"ENOENT\") {\n throw new ContractValidationError(\n `Missing required contract document: ${path}`,\n );\n }\n throw new ContractValidationError(`${path}: unreadable JSON document.`, {\n cause: error,\n });\n }\n}\n\nfunction parseJson(path: string, bytes: Uint8Array): Record<string, unknown> {\n let text: string;\n try {\n text = new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes);\n } catch (error) {\n throw new ContractValidationError(`${path}: unreadable JSON document.`, {\n cause: error,\n });\n }\n let payload: unknown;\n try {\n payload = JSON.parse(text);\n } catch (error) {\n throw new ContractValidationError(\n `${path}: invalid JSON: ${String(error)}`,\n { cause: error },\n );\n }\n if (!isRecord(payload)) {\n throw new ContractValidationError(`${path}: expected a JSON object.`);\n }\n validateParsedJson(payload, path);\n return payload;\n}\n\nfunction validateParsedJson(value: unknown, context: string): void {\n if (typeof value === \"number\") {\n if (!Number.isFinite(value)) {\n throw new ContractValidationError(\n `${context}: non-finite JSON numbers are not supported.`,\n );\n }\n if (Number.isInteger(value) && !Number.isSafeInteger(value)) {\n throw new ContractValidationError(\n `${context}: unsafe integer-valued JSON numbers are not supported.`,\n );\n }\n return;\n }\n if (typeof value === \"string\") {\n if (!value.isWellFormed()) {\n throw new ContractValidationError(\n `${context}: expected well-formed Unicode JSON strings.`,\n );\n }\n return;\n }\n if (Array.isArray(value)) {\n for (const [index, item] of value.entries()) {\n validateParsedJson(item, `${context}[${index}]`);\n }\n return;\n }\n if (isRecord(value)) {\n for (const [key, item] of Object.entries(value)) {\n if (!key.isWellFormed()) {\n throw new ContractValidationError(\n `${context}: expected well-formed Unicode JSON keys.`,\n );\n }\n validateParsedJson(item, `${context}[${JSON.stringify(key)}]`);\n }\n }\n}\n\nasync function loadContractValidators(\n pluginRoot: string,\n signal?: AbortSignal,\n) {\n // The plugin schemas are the immutable v0 contract. They are valid Draft\n // 2020-12 but intentionally omit redundant local `type` keywords that Ajv's\n // optional strict-schema linter requires.\n const ajv = new Ajv2020({ allErrors: false, strict: false });\n ajv.addFormat(\"date-time\", {\n type: \"string\",\n validate: validRfc3339DateTime,\n });\n const validators = [];\n for (const [filename, schemaName] of Object.entries(DOCUMENTS)) {\n const schema = await readJson(\n join(pluginRoot, \"schemas\", schemaName),\n signal,\n ).catch((error: unknown) => {\n throwIfAborted(signal);\n throw new ContractSchemaError(errorMessage(error), { cause: error });\n });\n try {\n const validate = ajv.compile(schema);\n if (\"$async\" in validate && validate.$async === true) {\n throw new Error(\"asynchronous JSON Schema validation is unsupported\");\n }\n validators.push({ filename, schemaName, validate });\n } catch {\n throw new ContractSchemaError(`${schemaName}: invalid JSON Schema.`);\n }\n throwIfAborted(signal);\n }\n return validators;\n}\n\nasync function sha256ScanFile(\n scanDir: string,\n relativePath: string,\n context: string,\n signal?: AbortSignal,\n expectedRoot?: ScanRoot,\n): Promise<string> {\n const file = await openCheckedScanFile(\n scanDir,\n relativePath,\n context,\n signal,\n expectedRoot,\n );\n try {\n throwIfAborted(signal);\n const digest = createHash(\"sha256\");\n const buffer = Buffer.alloc(64 * 1024);\n while (true) {\n throwIfAborted(signal);\n const { bytesRead } = await file.read(buffer, 0, buffer.length, null);\n if (bytesRead === 0) break;\n digest.update(buffer.subarray(0, bytesRead));\n }\n throwIfAborted(signal);\n return digest.digest(\"hex\");\n } finally {\n await file.close();\n }\n}\n\nasync function openCheckedScanFile(\n scanDir: string,\n relativePath: string,\n context: string,\n signal?: AbortSignal,\n expectedRoot?: ScanRoot,\n): Promise<FileHandle> {\n const checked = await requireCheckedScanFile(\n scanDir,\n relativePath,\n context,\n signal,\n expectedRoot,\n );\n let file: FileHandle | undefined;\n try {\n file = await open(\n checked.path,\n constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK,\n );\n const opened = await file.stat();\n throwIfAborted(signal);\n if (\n !opened.isFile() ||\n opened.ino !== checked.metadata.ino ||\n !(await sameCheckedFileDevice(file, checked, opened))\n ) {\n throw new ContractValidationError(\n `${context}: expected the checked regular file.`,\n );\n }\n for (const parent of checked.parents) {\n const current = await lstat(parent.path);\n throwIfAborted(signal);\n if (\n !current.isDirectory() ||\n current.dev !== parent.metadata.dev ||\n current.ino !== parent.metadata.ino\n ) {\n throw new ContractValidationError(\n `${context}: checked parent changed before opening the file.`,\n );\n }\n }\n const current = await lstat(checked.path);\n throwIfAborted(signal);\n if (\n !current.isFile() ||\n current.dev !== checked.metadata.dev ||\n current.ino !== checked.metadata.ino\n ) {\n throw new ContractValidationError(\n `${context}: checked file changed before reading.`,\n );\n }\n return file;\n } catch (error) {\n await file?.close();\n throwIfAborted(signal);\n if (error instanceof ContractValidationError) throw error;\n throw new ContractValidationError(\n `${context}: unable to open the checked regular file.`,\n { cause: error },\n );\n }\n}\n\nexport async function sameCheckedFileDevice(\n file: FileHandle,\n checked: { path: string; metadata: Pick<Stats | BigIntStats, \"dev\" | \"ino\"> },\n opened: Pick<Stats | BigIntStats, \"dev\" | \"ino\">,\n platform: NodeJS.Platform = process.platform,\n openReference: (path: string, flags: number) => Promise<FileHandle> = open,\n): Promise<boolean> {\n if (opened.ino !== checked.metadata.ino) return false;\n if (opened.dev === checked.metadata.dev) return true;\n if (platform !== \"win32\") return false;\n\n const [openedIdentity, checkedIdentity] = await Promise.all([\n file.stat({ bigint: true }),\n lstat(checked.path, { bigint: true }),\n ]);\n if (\n !openedIdentity.isFile() ||\n !checkedIdentity.isFile() ||\n openedIdentity.ino !== checkedIdentity.ino\n ) {\n return false;\n }\n\n const reference = await openReference(\n checked.path,\n constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK,\n );\n try {\n const referenceIdentity = await reference.stat({ bigint: true });\n return (\n referenceIdentity.isFile() &&\n openedIdentity.dev === referenceIdentity.dev &&\n openedIdentity.ino === referenceIdentity.ino\n );\n } finally {\n await reference.close();\n }\n}\n\nfunction throwIfAborted(signal?: AbortSignal): void {\n if (!signal?.aborted) return;\n throw abortReason(signal);\n}\n\nconst RFC3339_DATE_TIME = new RegExp(\n regexes.datetime({ offset: true }).source,\n \"i\",\n);\n\nfunction validRfc3339DateTime(value: string): boolean {\n return !value.startsWith(\"0000\") && RFC3339_DATE_TIME.test(value);\n}\n\nfunction schemaError(\n filename: string,\n errors: readonly ErrorObject[],\n): ContractValidationError {\n const first = errors[0];\n const location = first?.instancePath\n ? JSON.stringify(first.instancePath)\n : \"<root>\";\n const keyword = first?.keyword ?? \"unknown\";\n const count = errors.length;\n return new ContractValidationError(\n `${filename}:${location}: schema validation failed (${keyword}${keyword === \"format\" && first?.params[\"format\"] === \"date-time\" ? \"; date-time\" : \"\"}; ${count} ${count === 1 ? \"error\" : \"errors\"})${first?.message ? `: ${first.message}` : \"\"}.`,\n );\n}\n\nfunction nodeErrorCode(error: unknown): string | undefined {\n return typeof error === \"object\" && error !== null && \"code\" in error\n ? String(error.code)\n : undefined;\n}\n\n/** @internal */\nexport function sha256Text(value: string): string {\n return hash(\"sha256\", value);\n}\n\nexport function deriveFindingIdentity(\n scanId: string,\n targetId: string,\n ruleId: string,\n identity: Finding[\"identity\"],\n) {\n const fingerprint = `codex-security/v1:sha256:${sha256Text(\n [\n \"codex-security/v1\",\n targetId,\n ruleId,\n identity.anchor,\n identity.instance ?? \"\",\n ].join(\"\\0\"),\n )}`;\n return {\n findingId: `csf_${sha256Text(fingerprint).slice(0, 24)}`,\n occurrenceId: `occ_${sha256Text([scanId, fingerprint].join(\"\\0\")).slice(0, 24)}`,\n ruleId,\n identity,\n fingerprints: {\n algorithm: \"codex-security/v1\" as const,\n primary: fingerprint,\n },\n };\n}\n"]}
1
+ {"version":3,"file":"contract.js","sourceRoot":"","sources":["../src/contract.ts"],"names":[],"mappings":"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","sourcesContent":["import { isDeepStrictEqual as sameArray } from \"node:util\";\nimport { createHash, hash } from \"node:crypto\";\nimport { normalizePersistedFindingDetails } from \"./finding-normalization.js\";\nimport { constants, type BigIntStats, type Stats } from \"node:fs\";\nimport {\n lstat,\n open,\n readFile,\n realpath,\n type FileHandle,\n} from \"node:fs/promises\";\nimport { isAbsolute, join, posix, resolve } from \"node:path\";\nimport Ajv2020, { type ErrorObject } from \"ajv/dist/2020.js\";\nimport { regexes } from \"zod\";\nimport {\n ContractValidationError,\n abortReason,\n errorMessage,\n} from \"./errors.js\";\nimport { isRecord } from \"./record.js\";\nimport type {\n CoverageDocument,\n Finding,\n FindingsDocument,\n ScanManifest,\n} from \"./models.js\";\nimport {\n requirePrivateOutputDirectory,\n requireSecureOutputAncestry,\n} from \"./runtime.js\";\nimport type { NormalizedTarget, ScanMode } from \"./targets.js\";\nimport { isWithin as isContained } from \"./trusted-executable.js\";\nimport { isWindowsUnsafePathComponent } from \"./windows-path.js\";\n\nconst DOCUMENTS = {\n \"scan-manifest.json\": \"scan-manifest.schema.json\",\n \"findings.json\": \"findings.schema.json\",\n \"coverage.json\": \"coverage.schema.json\",\n} as const;\nconst PRODUCER_NAME = \"codex-security-plugin\";\ninterface CheckedScanFile {\n path: string;\n metadata: BigIntStats;\n parents: Array<{ path: string; metadata: BigIntStats }>;\n}\n\ninterface ScanRoot {\n path: string;\n metadata: BigIntStats;\n}\n\nexport interface ScanExpectation {\n repository: string;\n repositoryRevision: string | null;\n target: NormalizedTarget;\n mode: ScanMode;\n pluginVersion: string;\n}\n\nexport interface LoadedContract {\n mode: NonNullable<ScanManifest[\"scan\"][\"mode\"]>;\n manifest: ScanManifest;\n findings: FindingsDocument;\n review: NonNullable<ScanManifest[\"scan\"][\"review\"]>;\n}\n\nexport class ContractSchemaError extends ContractValidationError {}\n\nexport const SEALED_DEFERRED_PATH_RULE = \"invalidSealedDeferredPath\";\nexport const DEFERRED_PATH_LOCATION = /^\\/deferred\\/(\\d+)\\/paths\\/(\\d+)$/u;\n\ntype LoadContractOptions = {\n pluginRoot: string;\n expectedScanId?: string;\n expectation?: ScanExpectation;\n workbenchValidated?: boolean;\n signal?: AbortSignal;\n};\n\nexport async function loadContract(\n scanDirectory: string,\n options: LoadContractOptions,\n): Promise<LoadedContract> {\n return (await loadContractWithScanDirectory(scanDirectory, options)).contract;\n}\n\nexport async function loadContractWithScanDirectory(\n scanDirectory: string,\n options: LoadContractOptions,\n): Promise<{ contract: LoadedContract; scanDirectory: string }> {\n const validators = await loadContractValidators(\n options.pluginRoot,\n options.signal,\n );\n const scanRoot = await requireScanRoot(scanDirectory, options.signal);\n const scanDir = scanRoot.path;\n const documentDigests = new Map<string, string>();\n const payloads: Record<string, unknown> = {};\n payloads[\"scan-manifest.json\"] = await readScanJson(\n scanDir,\n \"scan-manifest.json\",\n documentDigests,\n options.signal,\n scanRoot,\n );\n const rawManifest = payloads[\"scan-manifest.json\"] as ScanManifest;\n const documents = validators.filter(\n ({ filename }) =>\n filename !== \"coverage.json\" ||\n rawManifest.scan?.coverageRef !== undefined,\n );\n for (const { filename } of documents) {\n if (filename === \"scan-manifest.json\") continue;\n payloads[filename] = await readScanJson(\n scanDir,\n filename as keyof typeof DOCUMENTS,\n documentDigests,\n options.signal,\n scanRoot,\n );\n }\n throwIfAborted(options.signal);\n\n for (const { filename, schemaName, validate } of documents) {\n let payload: unknown;\n let valid: boolean;\n try {\n payload = payloads[filename];\n const validatePayload = (payload: unknown) => {\n const result = validate(payload);\n if (typeof result !== \"boolean\") {\n throw new Error(\"asynchronous JSON Schema validation is unsupported\");\n }\n return result;\n };\n valid = validatePayload(payload);\n if (!valid && filename === \"findings.json\") {\n payload = normalizePersistedFindings(payload);\n valid = validatePayload(payload);\n }\n } catch {\n throw new ContractSchemaError(`${schemaName}: invalid JSON Schema.`);\n }\n if (!valid) {\n throw schemaError(filename, validate.errors ?? []);\n }\n payloads[filename] = payload;\n throwIfAborted(options.signal);\n }\n const manifest = payloads[\"scan-manifest.json\"] as ScanManifest;\n const findings = payloads[\"findings.json\"] as FindingsDocument;\n const coverage = payloads[\"coverage.json\"] as CoverageDocument | undefined;\n const mode = coverage?.mode ?? manifest.scan.mode!;\n const review = coverage\n ? {\n excludedPaths: coverage.explicitExclusions.map((item) => item.pattern),\n }\n : manifest.scan.review!;\n if (\n options.expectedScanId !== undefined &&\n manifest.scan.id !== options.expectedScanId\n ) {\n throw new ContractValidationError(\n `Scan artifacts do not match selected scan ${options.expectedScanId}.`,\n );\n }\n if (\n findings.scanId !== manifest.scan.id ||\n (coverage !== undefined && coverage.scanId !== manifest.scan.id)\n ) {\n throw new ContractValidationError(\n \"Canonical contract scan IDs do not match.\",\n );\n }\n if (\n coverage !== undefined &&\n !sameArray(coverage.includePaths, manifest.scan.scope.includePaths)\n ) {\n throw new ContractValidationError(\n \"Coverage include paths do not match the manifest scope.\",\n );\n }\n if (\n coverage !== undefined &&\n !sameArray(coverage.excludePaths, manifest.scan.scope.excludePaths)\n ) {\n throw new ContractValidationError(\n \"Coverage exclude paths do not match the manifest scope.\",\n );\n }\n\n validateCanonicalContract(manifest, findings, coverage);\n\n await validateSeal(\n scanDir,\n manifest,\n findings,\n coverage,\n documentDigests,\n options.signal,\n scanRoot,\n );\n if (options.expectation !== undefined) {\n validateExpectation(\n manifest,\n mode,\n options.expectation,\n options.workbenchValidated === true,\n );\n }\n await verifyScanRoot(scanRoot, options.signal);\n return {\n contract: { manifest, findings, review, mode },\n scanDirectory: scanRoot.path,\n };\n}\n\n/** Normalize optional legacy details on a copy, without changing saved artifacts. */\nfunction normalizePersistedFindings(payload: unknown): unknown {\n const compatible = structuredClone(payload);\n if (!isRecord(compatible) || !Array.isArray(compatible[\"findings\"])) {\n return compatible;\n }\n for (const finding of compatible[\"findings\"]) {\n if (!isRecord(finding)) continue;\n normalizePersistedFindingDetails(finding);\n }\n return compatible;\n}\n\n/** Match the producer's Python str.strip without changing saved text. */\nexport function hasRequiredFindingText(value: string): boolean {\n return !/^[\\p{White_Space}\\u001c-\\u001f]*$/u.test(value);\n}\n\nfunction validateCanonicalContract(\n manifest: ScanManifest,\n findings: FindingsDocument,\n coverage: CoverageDocument | undefined,\n): void {\n const requireText = (values: Record<string, string | undefined>) => {\n for (const [context, value] of Object.entries(values)) {\n if (value !== undefined && !hasRequiredFindingText(value))\n throw new ContractValidationError(\n `${context}: expected a non-empty string.`,\n );\n }\n };\n requireText({\n \"manifest.scan.id\": manifest.scan.id,\n \"scan.target.targetId\": manifest.scan.target.targetId,\n \"scan.target.displayName\": manifest.scan.target.displayName,\n \"scan.target.revision\":\n manifest.scan.target.kind === \"git_revision\"\n ? manifest.scan.target.revision\n : undefined,\n \"scan.target.snapshotDigest\":\n manifest.scan.target.kind !== \"git_revision\"\n ? manifest.scan.target.snapshotDigest\n : undefined,\n \"manifest.scan.producer.name\": manifest.scan.producer.name,\n \"manifest.scan.producer.version\": manifest.scan.producer.version,\n \"coverage.inventoryStrategy\": coverage?.inventoryStrategy,\n });\n for (const [index, surface] of (coverage?.surfaces ?? []).entries())\n requireText({\n [`coverage.surfaces[${index}].id`]: surface.id,\n [`coverage.surfaces[${index}].label`]: surface.label,\n });\n const remote = manifest.scan.target.remote;\n if (remote !== undefined) {\n const authority = /^[A-Za-z][A-Za-z0-9+.-]*:\\/\\/([^/?#]+)/.exec(\n remote,\n )?.[1];\n if (\n remote.includes(\"\\\\\") ||\n /[\\u0000-\\u001f\\u007f-\\u009f\\u2028\\u2029]/u.test(remote) ||\n authority === undefined\n ) {\n throw new ContractValidationError(\n \"scan.target.remote: expected a sanitized canonical absolute URL.\",\n );\n }\n if (authority.includes(\"@\")) {\n throw new ContractValidationError(\n \"scan.target.remote: remote URL must not contain credentials, query, or fragment.\",\n );\n }\n let parsed: URL;\n try {\n parsed = new URL(remote);\n } catch (error) {\n throw new ContractValidationError(\n \"scan.target.remote: expected a sanitized canonical absolute URL.\",\n { cause: error },\n );\n }\n if (parsed.protocol.length === 0 || parsed.host.length === 0) {\n throw new ContractValidationError(\n \"scan.target.remote: expected a sanitized canonical absolute URL.\",\n );\n }\n if (\n parsed.username.length > 0 ||\n parsed.password.length > 0 ||\n parsed.search.length > 0 ||\n parsed.hash.length > 0\n ) {\n throw new ContractValidationError(\n \"scan.target.remote: remote URL must not contain credentials, query, or fragment.\",\n );\n }\n }\n\n for (const field of [\"includePaths\", \"excludePaths\"] as const) {\n for (const [index, value] of manifest.scan.scope[field].entries()) {\n try {\n safeScopePath(value);\n } catch (error) {\n throw new ContractValidationError(\n `manifest.scan.scope.${field}[${index}]: expected a safe repository-relative POSIX path.`,\n { cause: error },\n );\n }\n }\n }\n\n for (const [index, deferred] of (coverage?.deferred ?? []).entries()) {\n for (const [pathIndex, path] of (deferred.paths ?? []).entries()) {\n const context = `coverage.deferred[${index}].paths[${pathIndex}]`;\n try {\n safeRelativePath(path, context, true);\n } catch (error) {\n throw new ContractValidationError(\n `${context}: expected a safe repository-relative POSIX path.`,\n { cause: error },\n );\n }\n }\n }\n\n const occurrenceIds = new Set<string>();\n for (const [findingIndex, finding] of findings.findings.entries()) {\n const context = `findings.findings[${findingIndex}]`;\n requireText({\n [`${context}.title`]: finding.title,\n [`${context}.summary`]: finding.summary,\n [`${context}.remediation`]: finding.remediation,\n [`${context}.confidence.rationale`]: finding.confidence.rationale,\n [`${context}.severity.scoringSystem`]:\n finding.severity.score === undefined\n ? undefined\n : (finding.severity.scoringSystem ?? \"\"),\n [`${context}.taxonomy.category`]: finding.taxonomy.category,\n [`${context}.provenance.source`]: finding.provenance.source,\n });\n if (occurrenceIds.has(finding.occurrenceId))\n throw new ContractValidationError(\n `${context}: duplicate finding occurrence identity; use identity.instance to split siblings.`,\n );\n occurrenceIds.add(finding.occurrenceId);\n for (const [locationIndex, location] of finding.locations.entries()) {\n const locationContext = `${context}.locations[${locationIndex}]`;\n try {\n safeRelativePath(location.path, `${locationContext}.path`);\n } catch (error) {\n throw new ContractValidationError(\n `${locationContext}.path: expected a safe repository-relative POSIX path.`,\n { cause: error },\n );\n }\n if ((location.endLine ?? location.startLine) < location.startLine) {\n throw new ContractValidationError(\n `${locationContext}.endLine: expected an integer >= startLine.`,\n );\n }\n }\n for (const [evidenceIndex, evidence] of (\n finding.codeEvidence ?? []\n ).entries()) {\n const evidenceContext = `${context}.codeEvidence[${evidenceIndex}].path`;\n try {\n safeRelativePath(evidence.path, evidenceContext);\n } catch (error) {\n throw new ContractValidationError(\n `${evidenceContext}: expected a safe repository-relative POSIX path.`,\n { cause: error },\n );\n }\n }\n\n const { findingId, occurrenceId, fingerprints } = deriveFindingIdentity(\n manifest.scan.id,\n manifest.scan.target.targetId,\n finding.ruleId,\n finding.identity,\n );\n if (finding.findingId !== findingId) {\n throw new ContractValidationError(\n `${context}.findingId: does not match derived fingerprint identity.`,\n );\n }\n if (finding.occurrenceId !== occurrenceId) {\n throw new ContractValidationError(\n `${context}.occurrenceId: does not match scan occurrence identity.`,\n );\n }\n if (finding.fingerprints.primary !== fingerprints.primary) {\n throw new ContractValidationError(\n `${context}.fingerprints: does not match derived fingerprint.`,\n );\n }\n }\n}\n\nexport async function requireScanFile(\n scanDirectory: string,\n relativePath: string,\n context: string,\n signal?: AbortSignal,\n): Promise<string> {\n return (\n await requireCheckedScanFile(scanDirectory, relativePath, context, signal)\n ).path;\n}\n\nexport async function readScanFile(\n scanDirectory: string,\n relativePath: string,\n context: string,\n signal?: AbortSignal,\n): Promise<Buffer> {\n const file = await openCheckedScanFile(\n scanDirectory,\n relativePath,\n context,\n signal,\n );\n try {\n return await file.readFile({ signal });\n } finally {\n await file.close();\n }\n}\n\nasync function requireCheckedScanFile(\n scanDirectory: string,\n relativePath: string,\n context: string,\n signal?: AbortSignal,\n expectedRoot?: ScanRoot,\n): Promise<CheckedScanFile> {\n const checkedRoot = await requireScanRoot(scanDirectory, signal);\n const scanDir = checkedRoot.path;\n throwIfAborted(signal);\n const safePath = portableRelativePath(relativePath, context);\n const parts = safePath.split(\"/\");\n let current = scanDir;\n try {\n const rootMetadata = checkedRoot.metadata;\n if (\n expectedRoot !== undefined &&\n (scanDir !== expectedRoot.path ||\n rootMetadata.dev !== expectedRoot.metadata.dev ||\n rootMetadata.ino !== expectedRoot.metadata.ino)\n ) {\n throw new Error(\"scan directory changed while reading\");\n }\n const parents = [{ path: scanDir, metadata: rootMetadata }];\n throwIfAborted(signal);\n for (const part of parts.slice(0, -1)) {\n current = join(current, part);\n const metadata = await lstat(current, { bigint: true });\n throwIfAborted(signal);\n if (!metadata.isDirectory()) {\n throw new Error(\"unsafe parent\");\n }\n parents.push({ path: current, metadata });\n }\n const path = join(scanDir, ...parts);\n const metadata = await lstat(path, { bigint: true });\n throwIfAborted(signal);\n if (!metadata.isFile()) {\n throw new ContractValidationError(\n `${context}: expected a regular non-symlink file.`,\n );\n }\n const canonical = await realpath(path);\n throwIfAborted(signal);\n if (!isContained(scanDir, canonical)) {\n throw new Error(\"outside scan directory\");\n }\n return { path, metadata, parents };\n } catch (error) {\n throwIfAborted(signal);\n if (error instanceof ContractValidationError) {\n throw error;\n }\n throw new ContractValidationError(\n `${context}: expected a file inside the scan directory.`,\n {\n cause: error,\n },\n );\n }\n}\n\nasync function validateSeal(\n scanDir: string,\n manifest: ScanManifest,\n findings: FindingsDocument,\n coverage: CoverageDocument | undefined,\n documentDigests: ReadonlyMap<string, string>,\n signal?: AbortSignal,\n expectedRoot?: ScanRoot,\n): Promise<void> {\n const scan = manifest.scan;\n if (scan.sealedAt !== scan.completedAt) {\n throw new ContractValidationError(\n \"Manifest sealedAt must match completedAt.\",\n );\n }\n\n const artifactPaths = new Set<string>();\n const artifactCollisionKeys = new Set<string>();\n for (const [index, artifact] of scan.artifacts.entries()) {\n throwIfAborted(signal);\n const context = `manifest.scan.artifacts[${index}]`;\n const normalized = portableRelativePath(artifact.path, `${context}.path`);\n const collisionKey = normalized.toLowerCase();\n if (artifactCollisionKeys.has(collisionKey)) {\n throw new ContractValidationError(\n `${context}.path: duplicate artifact path.`,\n );\n }\n artifactPaths.add(normalized);\n artifactCollisionKeys.add(collisionKey);\n const digest =\n documentDigests.get(normalized) ??\n (await sha256ScanFile(\n scanDir,\n normalized,\n context,\n signal,\n expectedRoot,\n ));\n if (digest !== artifact.sha256) {\n throw new ContractValidationError(\n `${context}: sealed artifact changed or is missing.`,\n );\n }\n }\n\n const requireSealedReference = (reference: unknown, context: string) => {\n throwIfAborted(signal);\n if (typeof reference !== \"string\") {\n throw new ContractValidationError(`${context}: expected a string.`);\n }\n const normalized = portableRelativePath(reference, context.toLowerCase());\n if (!normalized.startsWith(\"artifacts/\")) {\n throw new ContractValidationError(\n `${context} must be under artifacts/: ${reference}`,\n );\n }\n if (!artifactPaths.has(normalized)) {\n throw new ContractValidationError(\n `${context} is missing from sealed artifacts: ${reference}`,\n );\n }\n };\n for (const surface of coverage?.surfaces ?? []) {\n for (const receipt of surface.receiptRefs) {\n requireSealedReference(receipt, \"Coverage receipt\");\n }\n }\n const extensions = scan[\"extensions\"];\n const imported = isRecord(extensions) ? extensions[\"import\"] : undefined;\n if (isRecord(imported) && \"sourceRef\" in imported) {\n requireSealedReference(imported[\"sourceRef\"], \"Import source\");\n }\n\n for (const [index, finding] of findings.findings.entries()) {\n const writeup = finding.writeup;\n if (writeup === undefined) continue;\n const file = await openCheckedScanFile(\n scanDir,\n writeup.reportPath,\n `findings[${index}].writeup.reportPath`,\n signal,\n expectedRoot,\n );\n await file.close();\n }\n const hardening = manifest.scan.hardening;\n if (hardening !== undefined) {\n const file = await openCheckedScanFile(\n scanDir,\n hardening.portfolioPath,\n \"manifest.scan.hardening.portfolioPath\",\n signal,\n expectedRoot,\n );\n await file.close();\n }\n}\n\nfunction validateExpectation(\n manifest: ScanManifest,\n mode: LoadedContract[\"mode\"],\n expectation: ScanExpectation,\n workbenchValidated = false,\n): void {\n const scan = manifest.scan;\n if (scan.producer.name !== PRODUCER_NAME) {\n throw new ContractValidationError(\n `Manifest producer must be ${PRODUCER_NAME}, got ${scan.producer.name}.`,\n );\n }\n if (scan.producer.version !== expectation.pluginVersion) {\n throw new ContractValidationError(\n \"Manifest producer version does not match the installed Codex Security plugin.\",\n );\n }\n\n const expectedMode = expectedCoverageMode(\n expectation.target,\n expectation.mode,\n );\n if (mode !== expectedMode) {\n throw new ContractValidationError(\n `Coverage mode must be ${expectedMode}, got ${mode}.`,\n );\n }\n\n const requested = expectation.target;\n if (!workbenchValidated) {\n const target = scan.target;\n if (requested.kind === \"refs\" || requested.kind === \"working_tree\") {\n if (target.kind !== \"git_diff\") {\n throw new ContractValidationError(\n \"Diff scan manifest target must be git_diff.\",\n );\n }\n if (target.baseRevision !== requested.base) {\n throw new ContractValidationError(\n \"Diff scan base revision does not match the request.\",\n );\n }\n if (target.headRevision !== requested.head) {\n throw new ContractValidationError(\n \"Diff scan head revision does not match the request.\",\n );\n }\n } else if (target.kind === \"git_diff\") {\n throw new ContractValidationError(\n \"Repository scan manifest target must not be git_diff.\",\n );\n } else if (\n target.kind !== \"directory_snapshot\" &&\n expectation.repositoryRevision !== null &&\n target.revision !== expectation.repositoryRevision\n ) {\n throw new ContractValidationError(\n \"Scan target revision does not match the repository.\",\n );\n }\n }\n\n if (requested.kind === \"paths\") {\n const actualPaths = scan.scope.includePaths.map(safeScopePath);\n const actual = new Set(actualPaths);\n if (actualPaths.length === actual.size) {\n const expected = new Set(requested.paths);\n if (actual.size === expected.size && actual.isSubsetOf(expected)) return;\n }\n throw new ContractValidationError(\n \"Manifest include paths do not match the requested path target.\",\n );\n }\n}\n\nfunction expectedCoverageMode(\n target: NormalizedTarget,\n mode: ScanMode,\n): CoverageDocument[\"mode\"] {\n if (target.kind === \"paths\") return \"scoped_path\";\n if (target.kind === \"refs\") return \"branch_diff\";\n if (target.kind === \"working_tree\") return \"working_tree\";\n return mode === \"deep\" ? \"deep_repository\" : \"repository\";\n}\n\nasync function requireScanRoot(\n scanDirectory: string,\n signal?: AbortSignal,\n): Promise<ScanRoot> {\n throwIfAborted(signal);\n const absolute = resolve(scanDirectory);\n try {\n const metadata = await lstat(absolute, { bigint: true });\n throwIfAborted(signal);\n const canonical = await realpath(absolute);\n throwIfAborted(signal);\n const current = await lstat(absolute, { bigint: true });\n throwIfAborted(signal);\n const returned = await lstat(canonical, { bigint: true });\n throwIfAborted(signal);\n if (\n !metadata.isDirectory() ||\n !current.isDirectory() ||\n metadata.dev !== current.dev ||\n metadata.ino !== current.ino ||\n !returned.isDirectory() ||\n metadata.dev !== returned.dev ||\n metadata.ino !== returned.ino\n ) {\n throw new Error(\"not a directory\");\n }\n try {\n requirePrivateOutputDirectory(\n { mode: Number(returned.mode), uid: Number(returned.uid) },\n canonical,\n );\n await requireSecureOutputAncestry(canonical);\n } catch (error) {\n throw new ContractValidationError(\n error instanceof Error\n ? error.message\n : \"Scan directory must remain private to the current user.\",\n { cause: error },\n );\n }\n return { path: canonical, metadata: returned };\n } catch (error) {\n throwIfAborted(signal);\n if (error instanceof ContractValidationError) throw error;\n throw new ContractValidationError(\n \"Scan directory must be an existing non-symlink directory.\",\n { cause: error },\n );\n }\n}\n\nasync function verifyScanRoot(\n root: ScanRoot,\n signal?: AbortSignal,\n): Promise<void> {\n try {\n const current = await lstat(root.path, { bigint: true });\n throwIfAborted(signal);\n if (\n !current.isDirectory() ||\n current.dev !== root.metadata.dev ||\n current.ino !== root.metadata.ino\n ) {\n throw new Error(\"scan directory changed while reading\");\n }\n requirePrivateOutputDirectory(\n { mode: Number(current.mode), uid: Number(current.uid) },\n root.path,\n );\n await requireSecureOutputAncestry(root.path);\n } catch (error) {\n throwIfAborted(signal);\n throw new ContractValidationError(\n \"Scan directory changed while reading the canonical contract.\",\n { cause: error },\n );\n }\n}\n\nfunction safeRelativePath(\n value: string,\n context: string,\n allowDot = false,\n): string {\n const parts = value.split(\"/\");\n if (\n value.length === 0 ||\n Buffer.from(value, \"utf8\").toString(\"utf8\") !== value ||\n (!allowDot && value === \".\") ||\n value.startsWith(\"/\") ||\n /^[A-Za-z]:/.test(value) ||\n parts.includes(\"..\") ||\n value.includes(\"\\\\\") ||\n /[\\u0000-\\u001f]/u.test(value)\n ) {\n throw new ContractValidationError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n }\n const normalized = posix.normalize(value).replace(/\\/+$/, \"\");\n if (\n (!allowDot && normalized === \".\") ||\n normalized.startsWith(\"../\") ||\n isAbsolute(normalized)\n ) {\n throw new ContractValidationError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n }\n return normalized;\n}\n\nfunction portableRelativePath(value: string, context: string): string {\n const normalized = safeRelativePath(value, context);\n if (\n value.trim().length === 0 ||\n value.split(\"/\").some(isWindowsUnsafePathComponent)\n ) {\n throw new ContractValidationError(\n `${context}: expected a safe scan-relative POSIX path.`,\n );\n }\n return normalized;\n}\n\nexport function safeScopePath(value: string): string {\n return value === \".\"\n ? value\n : safeRelativePath(value, \"manifest scope include path\");\n}\n\nasync function readScanJson(\n scanDir: string,\n relativePath: keyof typeof DOCUMENTS,\n documentDigests: Map<string, string>,\n signal?: AbortSignal,\n expectedRoot?: ScanRoot,\n): Promise<Record<string, unknown>> {\n const file = await openCheckedScanFile(\n scanDir,\n relativePath,\n relativePath,\n signal,\n expectedRoot,\n );\n try {\n const bytes = await file.readFile({ signal });\n documentDigests.set(relativePath, hash(\"sha256\", bytes));\n return parseJson(join(scanDir, relativePath), bytes);\n } catch (error) {\n throwIfAborted(signal);\n if (error instanceof ContractValidationError) throw error;\n throw new ContractValidationError(\n `${join(scanDir, relativePath)}: unreadable JSON document.`,\n { cause: error },\n );\n } finally {\n await file.close();\n }\n}\n\nasync function readJson(\n path: string,\n signal?: AbortSignal,\n): Promise<Record<string, unknown>> {\n try {\n return parseJson(path, await readFile(path, { signal }));\n } catch (error) {\n throwIfAborted(signal);\n if (error instanceof ContractValidationError) throw error;\n if (nodeErrorCode(error) === \"ENOENT\") {\n throw new ContractValidationError(\n `Missing required contract document: ${path}`,\n );\n }\n throw new ContractValidationError(`${path}: unreadable JSON document.`, {\n cause: error,\n });\n }\n}\n\nfunction parseJson(path: string, bytes: Uint8Array): Record<string, unknown> {\n let text: string;\n try {\n text = new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes);\n } catch (error) {\n throw new ContractValidationError(`${path}: unreadable JSON document.`, {\n cause: error,\n });\n }\n let payload: unknown;\n try {\n payload = JSON.parse(text);\n } catch (error) {\n throw new ContractValidationError(\n `${path}: invalid JSON: ${String(error)}`,\n { cause: error },\n );\n }\n if (!isRecord(payload)) {\n throw new ContractValidationError(`${path}: expected a JSON object.`);\n }\n validateParsedJson(payload, path);\n return payload;\n}\n\nfunction validateParsedJson(value: unknown, context: string): void {\n if (typeof value === \"number\") {\n if (!Number.isFinite(value)) {\n throw new ContractValidationError(\n `${context}: non-finite JSON numbers are not supported.`,\n );\n }\n if (Number.isInteger(value) && !Number.isSafeInteger(value)) {\n throw new ContractValidationError(\n `${context}: unsafe integer-valued JSON numbers are not supported.`,\n );\n }\n return;\n }\n if (typeof value === \"string\") {\n if (!value.isWellFormed()) {\n throw new ContractValidationError(\n `${context}: expected well-formed Unicode JSON strings.`,\n );\n }\n return;\n }\n if (Array.isArray(value)) {\n for (const [index, item] of value.entries()) {\n validateParsedJson(item, `${context}[${index}]`);\n }\n return;\n }\n if (isRecord(value)) {\n for (const [key, item] of Object.entries(value)) {\n if (!key.isWellFormed()) {\n throw new ContractValidationError(\n `${context}: expected well-formed Unicode JSON keys.`,\n );\n }\n validateParsedJson(item, `${context}[${JSON.stringify(key)}]`);\n }\n }\n}\n\nasync function loadContractValidators(\n pluginRoot: string,\n signal?: AbortSignal,\n) {\n // The plugin schemas are the immutable v0 contract. They are valid Draft\n // 2020-12 but intentionally omit redundant local `type` keywords that Ajv's\n // optional strict-schema linter requires.\n const ajv = new Ajv2020({ allErrors: false, strict: false, verbose: true });\n ajv.addFormat(\"date-time\", {\n type: \"string\",\n validate: validRfc3339DateTime,\n });\n const validators = [];\n for (const [filename, schemaName] of Object.entries(DOCUMENTS)) {\n const schema = await readJson(\n join(pluginRoot, \"schemas\", schemaName),\n signal,\n ).catch((error: unknown) => {\n throwIfAborted(signal);\n throw new ContractSchemaError(errorMessage(error), { cause: error });\n });\n try {\n const validate = ajv.compile(schema);\n if (\"$async\" in validate && validate.$async === true) {\n throw new Error(\"asynchronous JSON Schema validation is unsupported\");\n }\n validators.push({ filename, schemaName, validate });\n } catch {\n throw new ContractSchemaError(`${schemaName}: invalid JSON Schema.`);\n }\n throwIfAborted(signal);\n }\n return validators;\n}\n\nasync function sha256ScanFile(\n scanDir: string,\n relativePath: string,\n context: string,\n signal?: AbortSignal,\n expectedRoot?: ScanRoot,\n): Promise<string> {\n const file = await openCheckedScanFile(\n scanDir,\n relativePath,\n context,\n signal,\n expectedRoot,\n );\n try {\n throwIfAborted(signal);\n const digest = createHash(\"sha256\");\n const buffer = Buffer.alloc(64 * 1024);\n while (true) {\n throwIfAborted(signal);\n const { bytesRead } = await file.read(buffer, 0, buffer.length, null);\n if (bytesRead === 0) break;\n digest.update(buffer.subarray(0, bytesRead));\n }\n throwIfAborted(signal);\n return digest.digest(\"hex\");\n } finally {\n await file.close();\n }\n}\n\nasync function openCheckedScanFile(\n scanDir: string,\n relativePath: string,\n context: string,\n signal?: AbortSignal,\n expectedRoot?: ScanRoot,\n): Promise<FileHandle> {\n const checked = await requireCheckedScanFile(\n scanDir,\n relativePath,\n context,\n signal,\n expectedRoot,\n );\n let file: FileHandle | undefined;\n try {\n file = await open(\n checked.path,\n constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK,\n );\n const opened = await file.stat({ bigint: true });\n throwIfAborted(signal);\n if (\n !opened.isFile() ||\n opened.ino !== checked.metadata.ino ||\n !(await sameCheckedFileDevice(file, checked, opened))\n ) {\n throw new ContractValidationError(\n `${context}: expected the checked regular file.`,\n );\n }\n for (const parent of checked.parents) {\n const current = await lstat(parent.path, { bigint: true });\n throwIfAborted(signal);\n if (\n !current.isDirectory() ||\n current.dev !== parent.metadata.dev ||\n current.ino !== parent.metadata.ino\n ) {\n throw new ContractValidationError(\n `${context}: checked parent changed before opening the file.`,\n );\n }\n }\n const current = await lstat(checked.path, { bigint: true });\n throwIfAborted(signal);\n if (\n !current.isFile() ||\n current.dev !== checked.metadata.dev ||\n current.ino !== checked.metadata.ino\n ) {\n throw new ContractValidationError(\n `${context}: checked file changed before reading.`,\n );\n }\n return file;\n } catch (error) {\n await file?.close();\n throwIfAborted(signal);\n if (error instanceof ContractValidationError) throw error;\n throw new ContractValidationError(\n `${context}: unable to open the checked regular file.`,\n { cause: error },\n );\n }\n}\n\nexport async function sameCheckedFileDevice(\n file: FileHandle,\n checked: { path: string; metadata: Pick<Stats | BigIntStats, \"dev\" | \"ino\"> },\n opened: Pick<Stats | BigIntStats, \"dev\" | \"ino\">,\n platform: NodeJS.Platform = process.platform,\n openReference: (path: string, flags: number) => Promise<FileHandle> = open,\n): Promise<boolean> {\n if (opened.ino !== checked.metadata.ino) return false;\n if (opened.dev === checked.metadata.dev) return true;\n if (platform !== \"win32\") return false;\n\n const [openedIdentity, checkedIdentity] = await Promise.all([\n file.stat({ bigint: true }),\n lstat(checked.path, { bigint: true }),\n ]);\n if (\n !openedIdentity.isFile() ||\n !checkedIdentity.isFile() ||\n openedIdentity.ino !== checkedIdentity.ino\n ) {\n return false;\n }\n\n const reference = await openReference(\n checked.path,\n constants.O_RDONLY | constants.O_NOFOLLOW | constants.O_NONBLOCK,\n );\n try {\n const referenceIdentity = await reference.stat({ bigint: true });\n return (\n referenceIdentity.isFile() &&\n openedIdentity.dev === referenceIdentity.dev &&\n openedIdentity.ino === referenceIdentity.ino\n );\n } finally {\n await reference.close();\n }\n}\n\nfunction throwIfAborted(signal?: AbortSignal): void {\n if (!signal?.aborted) return;\n throw abortReason(signal);\n}\n\nconst RFC3339_DATE_TIME = new RegExp(\n regexes.datetime({ offset: true }).source,\n \"i\",\n);\n\nfunction validRfc3339DateTime(value: string): boolean {\n return !value.startsWith(\"0000\") && RFC3339_DATE_TIME.test(value);\n}\n\nfunction schemaError(\n filename: string,\n errors: readonly ErrorObject[],\n): ContractValidationError {\n const first = errors[0];\n if (\n filename === \"coverage.json\" &&\n first?.keyword === \"oneOf\" &&\n Array.isArray(first.schema) &&\n first.schema.some(\n (rule, index) =>\n isRecord(rule) &&\n rule[\"$comment\"] === SEALED_DEFERRED_PATH_RULE &&\n first.params[\"passingSchemas\"]?.includes(index),\n )\n ) {\n const match = DEFERRED_PATH_LOCATION.exec(first.instancePath);\n if (match)\n return new ContractValidationError(\n `coverage.deferred[${match[1]}].paths[${match[2]}]: expected a safe repository-relative POSIX path.`,\n );\n }\n const location = first?.instancePath\n ? JSON.stringify(first.instancePath)\n : \"<root>\";\n const keyword = first?.keyword ?? \"unknown\";\n const count = errors.length;\n return new ContractValidationError(\n `${filename}:${location}: schema validation failed (${keyword}${keyword === \"format\" && first?.params[\"format\"] === \"date-time\" ? \"; date-time\" : \"\"}; ${count} ${count === 1 ? \"error\" : \"errors\"})${first?.message ? `: ${first.message}` : \"\"}.`,\n );\n}\n\nfunction nodeErrorCode(error: unknown): string | undefined {\n return typeof error === \"object\" && error !== null && \"code\" in error\n ? String(error.code)\n : undefined;\n}\n\n/** @internal */\nexport function sha256Text(value: string): string {\n return hash(\"sha256\", value);\n}\n\nexport function deriveFindingIdentity(\n scanId: string,\n targetId: string,\n ruleId: string,\n identity: Finding[\"identity\"],\n) {\n const fingerprint = `codex-security/v1:sha256:${sha256Text(\n [\n \"codex-security/v1\",\n targetId,\n ruleId,\n identity.anchor,\n identity.instance ?? \"\",\n ].join(\"\\0\"),\n )}`;\n return {\n findingId: `csf_${sha256Text(fingerprint).slice(0, 24)}`,\n occurrenceId: `occ_${sha256Text([scanId, fingerprint].join(\"\\0\")).slice(0, 24)}`,\n ruleId,\n identity,\n fingerprints: {\n algorithm: \"codex-security/v1\" as const,\n primary: fingerprint,\n },\n };\n}\n"]}