@openai/codex-security 0.1.25 → 0.1.27

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 (197) hide show
  1. package/README.md +616 -34
  2. package/_bundled_plugin/.app.json +0 -5
  3. package/_bundled_plugin/.codex-plugin/plugin.json +1 -1
  4. package/_bundled_plugin/.mcp.json +2 -0
  5. package/_bundled_plugin/mcp/helpers.mjs +24 -0
  6. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  7. package/_bundled_plugin/mcp/native/COPYRIGHT-library.html +5556 -0
  8. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +5989 -0
  9. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  10. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/licenses/Apache-2.0.txt +73 -0
  12. package/_bundled_plugin/mcp/native/licenses/BSD-2-Clause.txt +9 -0
  13. package/_bundled_plugin/mcp/native/licenses/MIT.txt +9 -0
  14. package/_bundled_plugin/mcp/native/licenses/Unicode-3.0.txt +39 -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/linux-x64-musl/unix.node +0 -0
  19. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  20. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  21. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  22. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  23. package/_bundled_plugin/references/config-preflight.md +4 -2
  24. package/_bundled_plugin/references/core-scan.md +1 -1
  25. package/_bundled_plugin/references/final-report.md +5 -3
  26. package/_bundled_plugin/references/scan-artifacts.md +5 -1
  27. package/_bundled_plugin/references/scan-contract.md +42 -38
  28. package/_bundled_plugin/references/security-guidance.md +7 -1
  29. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +27 -1
  30. package/_bundled_plugin/scripts/deep_scan_workbench.py +6 -1
  31. package/_bundled_plugin/scripts/finalize_scan_contract.py +2 -5
  32. package/_bundled_plugin/scripts/generate_in_scope_files.py +2 -2
  33. package/_bundled_plugin/scripts/generate_rank_input.py +8 -1
  34. package/_bundled_plugin/scripts/launch_codex_security_mcp +6 -0
  35. package/_bundled_plugin/scripts/launch_codex_security_mcp.cmd +43 -9
  36. package/_bundled_plugin/scripts/rank_preview.py +4 -1
  37. package/_bundled_plugin/scripts/report_projection.py +1 -1
  38. package/_bundled_plugin/scripts/workbench_cli.py +7 -0
  39. package/_bundled_plugin/scripts/workbench_db.py +44 -31
  40. package/_bundled_plugin/scripts/workbench_saved_results.py +41 -22
  41. package/_bundled_plugin/scripts/workbench_scan_history.py +117 -2
  42. package/_bundled_plugin/scripts/workbench_scan_usage.py +7 -6
  43. package/_bundled_plugin/scripts/workbench_schema.py +31 -0
  44. package/_bundled_plugin/scripts/workbench_severity.py +119 -0
  45. package/_bundled_plugin/scripts/workbench_validation.py +4 -0
  46. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +5 -3
  47. package/_bundled_plugin/skills/define-security-policy/SKILL.md +3 -3
  48. package/_bundled_plugin/skills/verify-fix/SKILL.md +5 -1
  49. package/dist/api.d.ts +7 -1
  50. package/dist/api.d.ts.map +1 -1
  51. package/dist/api.js +485 -65
  52. package/dist/api.js.map +1 -1
  53. package/dist/auth.js +10 -0
  54. package/dist/auth.js.map +1 -1
  55. package/dist/classify-scan-severity.d.ts +16 -0
  56. package/dist/classify-scan-severity.d.ts.map +1 -0
  57. package/dist/classify-scan-severity.js +96 -0
  58. package/dist/classify-scan-severity.js.map +1 -0
  59. package/dist/classify-severity.d.ts +38 -0
  60. package/dist/classify-severity.d.ts.map +1 -0
  61. package/dist/classify-severity.js +185 -0
  62. package/dist/classify-severity.js.map +1 -0
  63. package/dist/cli.d.ts +23 -4
  64. package/dist/cli.d.ts.map +1 -1
  65. package/dist/cli.js +1277 -357
  66. package/dist/cli.js.map +1 -1
  67. package/dist/cloud-publish.d.ts.map +1 -1
  68. package/dist/cloud-publish.js +2 -207
  69. package/dist/cloud-publish.js.map +1 -1
  70. package/dist/component-plan.d.ts.map +1 -1
  71. package/dist/component-plan.js +116 -32
  72. package/dist/component-plan.js.map +1 -1
  73. package/dist/config.d.ts +1 -0
  74. package/dist/config.d.ts.map +1 -1
  75. package/dist/config.js +17 -2
  76. package/dist/config.js.map +1 -1
  77. package/dist/contract.d.ts +5 -10
  78. package/dist/contract.d.ts.map +1 -1
  79. package/dist/contract.js.map +1 -1
  80. package/dist/cost-model.d.ts +16 -0
  81. package/dist/cost-model.d.ts.map +1 -1
  82. package/dist/cost-model.js +57 -3
  83. package/dist/cost-model.js.map +1 -1
  84. package/dist/cost.d.ts.map +1 -1
  85. package/dist/cost.js +38 -9
  86. package/dist/cost.js.map +1 -1
  87. package/dist/custom-validation-prompt.js +1 -1
  88. package/dist/custom-validation-prompt.js.map +1 -1
  89. package/dist/deduplication/codex-review.d.ts +6 -1
  90. package/dist/deduplication/codex-review.d.ts.map +1 -1
  91. package/dist/deduplication/codex-review.js +72 -17
  92. package/dist/deduplication/codex-review.js.map +1 -1
  93. package/dist/deduplication/deduplication-reviewer.js +1 -1
  94. package/dist/deduplication/deduplication-reviewer.js.map +1 -1
  95. package/dist/deduplication/deduplication.d.ts +2 -0
  96. package/dist/deduplication/deduplication.d.ts.map +1 -1
  97. package/dist/deduplication/deduplication.js +99 -26
  98. package/dist/deduplication/deduplication.js.map +1 -1
  99. package/dist/deduplication/retry.d.ts +3 -0
  100. package/dist/deduplication/retry.d.ts.map +1 -0
  101. package/dist/deduplication/retry.js +15 -0
  102. package/dist/deduplication/retry.js.map +1 -0
  103. package/dist/deduplication/scan.d.ts +2 -0
  104. package/dist/deduplication/scan.d.ts.map +1 -1
  105. package/dist/deduplication/scan.js +4 -2
  106. package/dist/deduplication/scan.js.map +1 -1
  107. package/dist/feedback.d.ts +20 -0
  108. package/dist/feedback.d.ts.map +1 -0
  109. package/dist/feedback.js +121 -0
  110. package/dist/feedback.js.map +1 -0
  111. package/dist/finding-catalogue.d.ts +11 -0
  112. package/dist/finding-catalogue.d.ts.map +1 -0
  113. package/dist/finding-catalogue.js +150 -0
  114. package/dist/finding-catalogue.js.map +1 -0
  115. package/dist/findings-client.d.ts +7 -1
  116. package/dist/findings-client.d.ts.map +1 -1
  117. package/dist/findings-client.js +55 -10
  118. package/dist/findings-client.js.map +1 -1
  119. package/dist/findings-import.d.ts +44 -0
  120. package/dist/findings-import.d.ts.map +1 -0
  121. package/dist/findings-import.js +302 -0
  122. package/dist/findings-import.js.map +1 -0
  123. package/dist/import-scan.d.ts +27 -0
  124. package/dist/import-scan.d.ts.map +1 -0
  125. package/dist/import-scan.js +236 -0
  126. package/dist/import-scan.js.map +1 -0
  127. package/dist/index.d.ts +8 -0
  128. package/dist/index.d.ts.map +1 -1
  129. package/dist/index.js +4 -0
  130. package/dist/index.js.map +1 -1
  131. package/dist/knowledge-base.d.ts +1 -1
  132. package/dist/knowledge-base.d.ts.map +1 -1
  133. package/dist/knowledge-base.js +2 -2
  134. package/dist/knowledge-base.js.map +1 -1
  135. package/dist/multiscan.d.ts +2 -0
  136. package/dist/multiscan.d.ts.map +1 -1
  137. package/dist/multiscan.js +144 -52
  138. package/dist/multiscan.js.map +1 -1
  139. package/dist/patch-tui.js +1 -1
  140. package/dist/patch-tui.js.map +1 -1
  141. package/dist/publication-events.d.ts.map +1 -1
  142. package/dist/publication-events.js +7 -2
  143. package/dist/publication-events.js.map +1 -1
  144. package/dist/publication-store.d.ts.map +1 -1
  145. package/dist/publication-store.js +9 -4
  146. package/dist/publication-store.js.map +1 -1
  147. package/dist/publication.d.ts +9 -0
  148. package/dist/publication.d.ts.map +1 -1
  149. package/dist/publication.js +45 -5
  150. package/dist/publication.js.map +1 -1
  151. package/dist/publish.d.ts +4 -2
  152. package/dist/publish.d.ts.map +1 -1
  153. package/dist/publish.js +2 -2
  154. package/dist/publish.js.map +1 -1
  155. package/dist/runtime.d.ts +5 -1
  156. package/dist/runtime.d.ts.map +1 -1
  157. package/dist/runtime.js +8 -2
  158. package/dist/runtime.js.map +1 -1
  159. package/dist/scan-comparison.d.ts +42 -37
  160. package/dist/scan-comparison.d.ts.map +1 -1
  161. package/dist/scan-comparison.js +535 -161
  162. package/dist/scan-comparison.js.map +1 -1
  163. package/dist/scan-dashboard.d.ts.map +1 -1
  164. package/dist/scan-dashboard.js +19 -6
  165. package/dist/scan-dashboard.js.map +1 -1
  166. package/dist/scan-history-renderer.d.ts.map +1 -1
  167. package/dist/scan-history-renderer.js +5 -0
  168. package/dist/scan-history-renderer.js.map +1 -1
  169. package/dist/scan-logs.d.ts +29 -0
  170. package/dist/scan-logs.d.ts.map +1 -1
  171. package/dist/scan-logs.js +36 -5
  172. package/dist/scan-logs.js.map +1 -1
  173. package/dist/security-policy-cli.d.ts +39 -0
  174. package/dist/security-policy-cli.d.ts.map +1 -0
  175. package/dist/security-policy-cli.js +193 -0
  176. package/dist/security-policy-cli.js.map +1 -0
  177. package/dist/security-policy.d.ts +80 -0
  178. package/dist/security-policy.d.ts.map +1 -0
  179. package/dist/security-policy.js +672 -0
  180. package/dist/security-policy.js.map +1 -0
  181. package/dist/severity-store.d.ts +2 -0
  182. package/dist/severity-store.d.ts.map +1 -0
  183. package/dist/severity-store.js +111 -0
  184. package/dist/severity-store.js.map +1 -0
  185. package/dist/targets.d.ts +8 -1
  186. package/dist/targets.d.ts.map +1 -1
  187. package/dist/targets.js +243 -14
  188. package/dist/targets.js.map +1 -1
  189. package/dist/thread-source.d.ts +1 -0
  190. package/dist/thread-source.d.ts.map +1 -1
  191. package/dist/thread-source.js +1 -0
  192. package/dist/thread-source.js.map +1 -1
  193. package/dist/version.d.ts +1 -1
  194. package/dist/version.js +1 -1
  195. package/dist/version.js.map +1 -1
  196. package/package.json +10 -6
  197. package/_bundled_plugin/scripts/resolve_security_md.py +0 -158
@@ -0,0 +1 @@
1
+ {"version":3,"file":"finding-catalogue.js","sourceRoot":"","sources":["../src/finding-catalogue.ts"],"names":[],"mappings":"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","sourcesContent":["export type ComparisonFinding = { occurrenceId: string } & Record<\n string,\n unknown\n>;\n\nexport interface CatalogueEntry {\n card: ComparisonFinding;\n occurrences: readonly ComparisonFinding[];\n}\n\nexport function groupFindings(\n findings: readonly ComparisonFinding[],\n knownFindingGroups: readonly (readonly string[])[] = [],\n occurrenceGroups: readonly (readonly string[])[] = [],\n): ComparisonFinding[][] {\n const parents = new Map<string, string>();\n const root = (value: string): string => {\n const path: string[] = [];\n let current = value;\n while (parents.has(current)) {\n path.push(current);\n current = parents.get(current)!;\n }\n for (const item of path) parents.set(item, current);\n return current;\n };\n const link = (first: string, second: string): void => {\n const previous = root(first);\n const current = root(second);\n if (previous !== current) parents.set(current, previous);\n };\n for (const [prefix, groups] of [\n [\"finding\", knownFindingGroups],\n [\"occurrence\", occurrenceGroups],\n ] as const) {\n for (const group of groups) {\n const identities =\n prefix === \"finding\"\n ? group.filter((identity) => identity.trim().length > 0)\n : group;\n const first = identities[0];\n if (first === undefined) continue;\n for (const value of identities.slice(1)) {\n link(`${prefix}:${first}`, `${prefix}:${value}`);\n }\n }\n }\n for (const finding of findings) {\n const findingId = finding[\"findingId\"];\n if (typeof findingId === \"string\" && findingId.trim().length > 0) {\n link(`finding:${findingId}`, `occurrence:${finding.occurrenceId}`);\n }\n }\n\n const groups = new Map<string, ComparisonFinding[]>();\n for (const finding of findings) {\n const key = root(`occurrence:${finding.occurrenceId}`);\n const group = groups.get(key);\n if (group === undefined) groups.set(key, [finding]);\n else group.push(finding);\n }\n\n return [...groups.values()];\n}\n\nexport function findingCatalogue(\n findings: readonly ComparisonFinding[],\n knownFindingGroups: readonly (readonly string[])[] = [],\n): Map<string, CatalogueEntry> {\n return new Map(\n groupFindings(findings, knownFindingGroups).map((occurrences) => {\n const latest = occurrences.at(-1)!;\n const card = compactFinding(latest);\n if (occurrences.length > 1) {\n const description = (finding: ComparisonFinding) => {\n const value: Record<string, unknown> = { ...compactFinding(finding) };\n delete value[\"occurrenceId\"];\n delete value[\"findingId\"];\n return value;\n };\n const current = description(latest);\n const seen = new Set<string>();\n const aliases = occurrences.slice(0, -1).flatMap((finding) => {\n const value = Object.fromEntries(\n Object.entries(description(finding)).filter(\n ([field, value]) =>\n JSON.stringify(value) !== JSON.stringify(current[field]),\n ),\n );\n if (Object.keys(value).length === 0) return [];\n const key = JSON.stringify(value);\n if (seen.has(key)) return [];\n seen.add(key);\n return [value];\n });\n card[\"occurrenceCount\"] = occurrences.length;\n if (aliases.length > 0) card[\"earlierDescriptions\"] = aliases;\n }\n const findingId = occurrences[0]![\"findingId\"];\n if (typeof findingId === \"string\" && findingId.trim().length > 0) {\n card[\"issueId\"] = findingId;\n }\n return [latest.occurrenceId, { card, occurrences }];\n }),\n );\n}\n\nexport function compactFinding(finding: ComparisonFinding): ComparisonFinding {\n const rootCause = finding[\"rootCause\"] ?? finding[\"root_cause\"];\n const attackPath = record(finding[\"attackPath\"]);\n const dataFlow =\n attackPath?.[\"dataFlow\"] ??\n attackPath?.[\"data_flow\"] ??\n attackPath?.[\"dataflow\"];\n const locations = Array.isArray(finding[\"locations\"])\n ? finding[\"locations\"].flatMap((value) => {\n const location = record(value);\n return location === undefined ? [] : [location];\n })\n : [];\n let controls = locations.filter(\n (location) => location[\"role\"] === \"root_control\",\n );\n if (controls.length === 0) {\n controls = locations.filter((location) =>\n [\"expected_control\", \"concrete_implementation\"].includes(\n String(location[\"role\"]),\n ),\n );\n }\n if (controls.length === 0) controls = locations.slice(0, 1);\n\n return {\n occurrenceId: finding.occurrenceId,\n ...present({\n findingId: finding[\"findingId\"],\n title: finding[\"title\"],\n identity: pick(finding[\"identity\"], [\"anchor\", \"instance\"]),\n ruleId: finding[\"ruleId\"],\n taxonomy: pick(finding[\"taxonomy\"], [\"category\", \"cwe\"]),\n rootCause:\n (typeof rootCause === \"string\"\n ? rootCause\n : record(rootCause)?.[\"summary\"]) ?? finding[\"summary\"],\n remediation: finding[\"remediation\"],\n locations: controls.map((location) =>\n pick(location, [\"path\", \"startLine\", \"endLine\", \"role\"]),\n ),\n attackPath: present({\n dataFlow: pick(dataFlow, [\"source\", \"sink\"]),\n reachability: pick(attackPath?.[\"reachability\"], [\n \"attacker\",\n \"entrypoint\",\n ]),\n }),\n affectedComponent: finding[\"affectedComponent\"],\n boundaryCrossed: finding[\"boundaryCrossed\"],\n }),\n };\n}\n\nfunction record(value: unknown): Record<string, unknown> | undefined {\n return value !== null && typeof value === \"object\" && !Array.isArray(value)\n ? (value as Record<string, unknown>)\n : undefined;\n}\n\nfunction pick(value: unknown, fields: readonly string[]): unknown {\n if (typeof value === \"string\") return value;\n const object = record(value);\n return object === undefined\n ? undefined\n : present(\n Object.fromEntries(fields.map((field) => [field, object[field]])),\n );\n}\n\nfunction present(value: Record<string, unknown>): Record<string, unknown> {\n return Object.fromEntries(\n Object.entries(value).filter(\n ([, item]) =>\n item !== undefined &&\n item !== null &&\n item !== \"\" &&\n (!Array.isArray(item) || item.length > 0) &&\n (record(item) === undefined || Object.keys(item as object).length > 0),\n ),\n );\n}\n"]}
@@ -1,3 +1,4 @@
1
+ import { waitForRetry } from "./deduplication/retry.js";
1
2
  import type { Finding } from "./models.js";
2
3
  import type { FindingNeighborhood, FindingSearchScope } from "./finding-retrieval.js";
3
4
  export type FindingsRequest = (url: URL, init: RequestInit) => Promise<Response>;
@@ -5,10 +6,15 @@ export declare class FindingsClient {
5
6
  private readonly url;
6
7
  private readonly signal?;
7
8
  private readonly request;
8
- constructor(url: string, signal?: AbortSignal | undefined, request?: FindingsRequest);
9
+ private readonly retries;
10
+ constructor(url: string, signal?: AbortSignal | undefined, request?: FindingsRequest, retries?: {
11
+ wait?: typeof waitForRetry;
12
+ random?: () => number;
13
+ });
9
14
  potentialDuplicates(findingId: string, scope: FindingSearchScope): Promise<FindingNeighborhood>;
10
15
  publish(findings: readonly Finding[], repositoryId: string): Promise<string[]>;
11
16
  storeDedupeGroups(groups: readonly string[][]): Promise<void>;
17
+ private retry;
12
18
  private endpoint;
13
19
  private post;
14
20
  }
@@ -1 +1 @@
1
- {"version":3,"file":"findings-client.d.ts","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAFP,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,YAAA,EACpB,OAAO,GAAE,eAAuB;IAG7C,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC;IAoBzB,OAAO,CACX,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBd,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAKnE,OAAO,CAAC,QAAQ;YAIF,IAAI;CAcnB"}
1
+ {"version":3,"file":"findings-client.d.ts","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"AACA,OAAO,EAAc,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EACV,mBAAmB,EACnB,kBAAkB,EACnB,MAAM,wBAAwB,CAAC;AAEhC,MAAM,MAAM,eAAe,GAAG,CAC5B,GAAG,EAAE,GAAG,EACR,IAAI,EAAE,WAAW,KACd,OAAO,CAAC,QAAQ,CAAC,CAAC;AAmBvB,qBAAa,cAAc;IAEvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO;gBAHP,GAAG,EAAE,MAAM,EACX,MAAM,CAAC,EAAE,WAAW,YAAA,EACpB,OAAO,GAAE,eAAuB,EAChC,OAAO,GAAE;QACxB,IAAI,CAAC,EAAE,OAAO,YAAY,CAAC;QAC3B,MAAM,CAAC,EAAE,MAAM,MAAM,CAAC;KAClB;IAGF,mBAAmB,CACvB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,kBAAkB,GACxB,OAAO,CAAC,mBAAmB,CAAC;IAyBzB,OAAO,CACX,QAAQ,EAAE,SAAS,OAAO,EAAE,EAC5B,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,MAAM,EAAE,CAAC;IAmBd,iBAAiB,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;YAKrD,KAAK;IAsBnB,OAAO,CAAC,QAAQ;YAIF,IAAI;CAiBnB"}
@@ -1,12 +1,30 @@
1
1
  import { CodexSecurityError } from "./errors.js";
2
+ import { retryDelay, waitForRetry } from "./deduplication/retry.js";
3
+ class FindingsHttpError extends CodexSecurityError {
4
+ status;
5
+ retryAfter;
6
+ constructor(message, status, retryAfter) {
7
+ super(message);
8
+ this.status = status;
9
+ this.retryAfter = retryAfter;
10
+ }
11
+ }
12
+ function isRetryable(error) {
13
+ if (error instanceof FindingsHttpError)
14
+ return [408, 429, 500, 502, 503, 504].includes(error.status);
15
+ // Fetch rejects network failures with TypeError; JSON truncation can produce SyntaxError.
16
+ return error instanceof TypeError || error instanceof SyntaxError;
17
+ }
2
18
  export class FindingsClient {
3
19
  url;
4
20
  signal;
5
21
  request;
6
- constructor(url, signal, request = fetch) {
22
+ retries;
23
+ constructor(url, signal, request = fetch, retries = {}) {
7
24
  this.url = url;
8
25
  this.signal = signal;
9
26
  this.request = request;
27
+ this.retries = retries;
10
28
  }
11
29
  async potentialDuplicates(findingId, scope) {
12
30
  const url = this.endpoint(`v1/finding/${encodeURIComponent(findingId)}/potential-duplicates`);
@@ -14,13 +32,16 @@ export class FindingsClient {
14
32
  url.searchParams.set("allRepositories", "true");
15
33
  else
16
34
  url.searchParams.set("repositoryId", scope.repositoryId);
17
- const response = await this.request(url, { signal: this.signal });
18
- if (!response.ok) {
19
- throw new CodexSecurityError(`Potential-duplicates lookup for ${findingId} failed (HTTP ${response.status}).${response.status === 404
20
- ? " Import the finding with its repositoryId through POST /v1/bulk/findings before deduplicating."
21
- : ""}`);
22
- }
23
- return (await response.json());
35
+ return await this.retry(async () => {
36
+ const response = await this.request(url, { signal: this.signal });
37
+ if (!response.ok) {
38
+ await response.body?.cancel().catch(() => undefined);
39
+ throw new FindingsHttpError(`Potential-duplicates lookup for ${findingId} failed (HTTP ${response.status}).${response.status === 404
40
+ ? " Import the finding with its repositoryId through POST /v1/bulk/findings before deduplicating."
41
+ : ""}`, response.status, response.headers.get("Retry-After"));
42
+ }
43
+ return (await response.json());
44
+ });
24
45
  }
25
46
  async publish(findings, repositoryId) {
26
47
  const receipt = await this.post("v1/bulk/findings", {
@@ -39,7 +60,30 @@ export class FindingsClient {
39
60
  async storeDedupeGroups(groups) {
40
61
  if (groups.length === 0)
41
62
  return;
42
- await this.post("v1/dedupe-groups", { groups });
63
+ await this.retry(() => this.post("v1/dedupe-groups", { groups }));
64
+ }
65
+ async retry(operation) {
66
+ for (let attempt = 1;; attempt++) {
67
+ this.signal?.throwIfAborted();
68
+ try {
69
+ return await operation();
70
+ }
71
+ catch (error) {
72
+ this.signal?.throwIfAborted();
73
+ if (attempt === 3 || !isRetryable(error))
74
+ throw error;
75
+ let delay = retryDelay(attempt, this.retries.random);
76
+ if (error instanceof FindingsHttpError && error.retryAfter !== null) {
77
+ const seconds = Number(error.retryAfter);
78
+ const serverDelay = Number.isFinite(seconds)
79
+ ? seconds * 1000
80
+ : Date.parse(error.retryAfter) - Date.now();
81
+ if (Number.isFinite(serverDelay))
82
+ delay = Math.max(delay, serverDelay);
83
+ }
84
+ await (this.retries.wait ?? waitForRetry)(delay, this.signal);
85
+ }
86
+ }
43
87
  }
44
88
  endpoint(path) {
45
89
  return new URL(path, this.url.endsWith("/") ? this.url : `${this.url}/`);
@@ -52,7 +96,8 @@ export class FindingsClient {
52
96
  signal: this.signal,
53
97
  });
54
98
  if (!response.ok) {
55
- throw new CodexSecurityError(`Findings API POST /${path} failed (HTTP ${response.status}).`);
99
+ await response.body?.cancel().catch(() => undefined);
100
+ throw new FindingsHttpError(`Findings API POST /${path} failed (HTTP ${response.status}).`, response.status, response.headers.get("Retry-After"));
56
101
  }
57
102
  return await response.json();
58
103
  }
@@ -1 +1 @@
1
- {"version":3,"file":"findings-client.js","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\nimport type { Finding } from \"./models.js\";\nimport type {\n FindingNeighborhood,\n FindingSearchScope,\n} from \"./finding-retrieval.js\";\n\nexport type FindingsRequest = (\n url: URL,\n init: RequestInit,\n) => Promise<Response>;\n\nexport class FindingsClient {\n constructor(\n private readonly url: string,\n private readonly signal?: AbortSignal,\n private readonly request: FindingsRequest = fetch,\n ) {}\n\n async potentialDuplicates(\n findingId: string,\n scope: FindingSearchScope,\n ): Promise<FindingNeighborhood> {\n const url = this.endpoint(\n `v1/finding/${encodeURIComponent(findingId)}/potential-duplicates`,\n );\n if (scope.allRepositories === true)\n url.searchParams.set(\"allRepositories\", \"true\");\n else url.searchParams.set(\"repositoryId\", scope.repositoryId);\n const response = await this.request(url, { signal: this.signal });\n if (!response.ok) {\n throw new CodexSecurityError(\n `Potential-duplicates lookup for ${findingId} failed (HTTP ${response.status}).${\n response.status === 404\n ? \" Import the finding with its repositoryId through POST /v1/bulk/findings before deduplicating.\"\n : \"\"\n }`,\n );\n }\n return (await response.json()) as FindingNeighborhood;\n }\n\n async publish(\n findings: readonly Finding[],\n repositoryId: string,\n ): Promise<string[]> {\n const receipt = await this.post(\"v1/bulk/findings\", {\n findings,\n repositoryId,\n });\n const expected = new Set(findings.map((finding) => finding.findingId));\n if (\n !Array.isArray(receipt) ||\n receipt.length !== findings.length ||\n new Set(receipt).size !== expected.size ||\n receipt.some((id) => !expected.has(id))\n ) {\n throw new CodexSecurityError(\n \"The findings API did not acknowledge all published finding IDs. Check the service before retrying.\",\n );\n }\n return receipt as string[];\n }\n\n async storeDedupeGroups(groups: readonly string[][]): Promise<void> {\n if (groups.length === 0) return;\n await this.post(\"v1/dedupe-groups\", { groups });\n }\n\n private endpoint(path: string): URL {\n return new URL(path, this.url.endsWith(\"/\") ? this.url : `${this.url}/`);\n }\n\n private async post(path: string, body: unknown): Promise<unknown> {\n const response = await this.request(this.endpoint(path), {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify(body),\n signal: this.signal,\n });\n if (!response.ok) {\n throw new CodexSecurityError(\n `Findings API POST /${path} failed (HTTP ${response.status}).`,\n );\n }\n return await response.json();\n }\n}\n"]}
1
+ {"version":3,"file":"findings-client.js","sourceRoot":"","sources":["../src/findings-client.ts"],"names":[],"mappings":"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","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\nimport { retryDelay, waitForRetry } from \"./deduplication/retry.js\";\nimport type { Finding } from \"./models.js\";\nimport type {\n FindingNeighborhood,\n FindingSearchScope,\n} from \"./finding-retrieval.js\";\n\nexport type FindingsRequest = (\n url: URL,\n init: RequestInit,\n) => Promise<Response>;\n\nclass FindingsHttpError extends CodexSecurityError {\n constructor(\n message: string,\n readonly status: number,\n readonly retryAfter: string | null,\n ) {\n super(message);\n }\n}\n\nfunction isRetryable(error: unknown): boolean {\n if (error instanceof FindingsHttpError)\n return [408, 429, 500, 502, 503, 504].includes(error.status);\n // Fetch rejects network failures with TypeError; JSON truncation can produce SyntaxError.\n return error instanceof TypeError || error instanceof SyntaxError;\n}\n\nexport class FindingsClient {\n constructor(\n private readonly url: string,\n private readonly signal?: AbortSignal,\n private readonly request: FindingsRequest = fetch,\n private readonly retries: {\n wait?: typeof waitForRetry;\n random?: () => number;\n } = {},\n ) {}\n\n async potentialDuplicates(\n findingId: string,\n scope: FindingSearchScope,\n ): Promise<FindingNeighborhood> {\n const url = this.endpoint(\n `v1/finding/${encodeURIComponent(findingId)}/potential-duplicates`,\n );\n if (scope.allRepositories === true)\n url.searchParams.set(\"allRepositories\", \"true\");\n else url.searchParams.set(\"repositoryId\", scope.repositoryId);\n return await this.retry(async () => {\n const response = await this.request(url, { signal: this.signal });\n if (!response.ok) {\n await response.body?.cancel().catch(() => undefined);\n throw new FindingsHttpError(\n `Potential-duplicates lookup for ${findingId} failed (HTTP ${response.status}).${\n response.status === 404\n ? \" Import the finding with its repositoryId through POST /v1/bulk/findings before deduplicating.\"\n : \"\"\n }`,\n response.status,\n response.headers.get(\"Retry-After\"),\n );\n }\n return (await response.json()) as FindingNeighborhood;\n });\n }\n\n async publish(\n findings: readonly Finding[],\n repositoryId: string,\n ): Promise<string[]> {\n const receipt = await this.post(\"v1/bulk/findings\", {\n findings,\n repositoryId,\n });\n const expected = new Set(findings.map((finding) => finding.findingId));\n if (\n !Array.isArray(receipt) ||\n receipt.length !== findings.length ||\n new Set(receipt).size !== expected.size ||\n receipt.some((id) => !expected.has(id))\n ) {\n throw new CodexSecurityError(\n \"The findings API did not acknowledge all published finding IDs. Check the service before retrying.\",\n );\n }\n return receipt as string[];\n }\n\n async storeDedupeGroups(groups: readonly string[][]): Promise<void> {\n if (groups.length === 0) return;\n await this.retry(() => this.post(\"v1/dedupe-groups\", { groups }));\n }\n\n private async retry<T>(operation: () => Promise<T>): Promise<T> {\n for (let attempt = 1; ; attempt++) {\n this.signal?.throwIfAborted();\n try {\n return await operation();\n } catch (error) {\n this.signal?.throwIfAborted();\n if (attempt === 3 || !isRetryable(error)) throw error;\n let delay = retryDelay(attempt, this.retries.random);\n if (error instanceof FindingsHttpError && error.retryAfter !== null) {\n const seconds = Number(error.retryAfter);\n const serverDelay = Number.isFinite(seconds)\n ? seconds * 1000\n : Date.parse(error.retryAfter) - Date.now();\n if (Number.isFinite(serverDelay))\n delay = Math.max(delay, serverDelay);\n }\n await (this.retries.wait ?? waitForRetry)(delay, this.signal);\n }\n }\n }\n\n private endpoint(path: string): URL {\n return new URL(path, this.url.endsWith(\"/\") ? this.url : `${this.url}/`);\n }\n\n private async post(path: string, body: unknown): Promise<unknown> {\n const response = await this.request(this.endpoint(path), {\n method: \"POST\",\n headers: { \"Content-Type\": \"application/json\" },\n body: JSON.stringify(body),\n signal: this.signal,\n });\n if (!response.ok) {\n await response.body?.cancel().catch(() => undefined);\n throw new FindingsHttpError(\n `Findings API POST /${path} failed (HTTP ${response.status}).`,\n response.status,\n response.headers.get(\"Retry-After\"),\n );\n }\n return await response.json();\n }\n}\n"]}
@@ -0,0 +1,44 @@
1
+ import { z } from "incur";
2
+ import type { Finding } from "./models.js";
3
+ export declare const CSV_TARGET_ID = "codex-security-csv-import";
4
+ export type FindingsImportFormat = "csv" | "json";
5
+ declare const csvFindingRowSchema: z.ZodObject<{
6
+ occurrence_id: z.ZodString;
7
+ finding_id: z.ZodString;
8
+ candidate_id: z.ZodPipe<z.ZodOptional<z.ZodString>, z.ZodTransform<string | undefined, string | undefined>>;
9
+ title: z.ZodString;
10
+ summary: z.ZodString;
11
+ severity: z.ZodEnum<{
12
+ critical: "critical";
13
+ high: "high";
14
+ medium: "medium";
15
+ low: "low";
16
+ informational: "informational";
17
+ }>;
18
+ confidence: z.ZodEnum<{
19
+ high: "high";
20
+ medium: "medium";
21
+ low: "low";
22
+ }>;
23
+ status: z.ZodEnum<{
24
+ open: "open";
25
+ closed: "closed";
26
+ }>;
27
+ close_reason: z.ZodPipe<z.ZodUnion<readonly [z.ZodLiteral<"">, z.ZodEnum<{
28
+ already_fixed: "already_fixed";
29
+ wont_fix: "wont_fix";
30
+ false_positive: "false_positive";
31
+ }>]>, z.ZodTransform<"already_fixed" | "wont_fix" | "false_positive" | undefined, "" | "already_fixed" | "wont_fix" | "false_positive">>;
32
+ note: z.ZodPipe<z.ZodString, z.ZodTransform<string | undefined, string>>;
33
+ remediation: z.ZodString;
34
+ path: z.ZodString;
35
+ start_line: z.ZodPipe<z.ZodString, z.ZodTransform<number, string>>;
36
+ end_line: z.ZodPipe<z.ZodString, z.ZodTransform<number | undefined, string>>;
37
+ }, z.core.$strip>;
38
+ type CsvFindingRow = z.infer<typeof csvFindingRowSchema>;
39
+ export declare function parseImportedFindings(source: string, format: FindingsImportFormat, pluginRoot: string): Promise<Finding[]>;
40
+ export declare function bindImportedFindings(findings: Finding[], format: FindingsImportFormat, scanId: string, targetId: string): Finding[];
41
+ export declare function parseFindingsCsv(source: string): CsvFindingRow[];
42
+ export declare function csvRowFinding(row: CsvFindingRow, scanId: string): Finding;
43
+ export {};
44
+ //# sourceMappingURL=findings-import.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"findings-import.d.ts","sourceRoot":"","sources":["../src/findings-import.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,OAAO,CAAC;AAG1B,OAAO,KAAK,EAAE,OAAO,EAAoB,MAAM,aAAa,CAAC;AAE7D,eAAO,MAAM,aAAa,8BAA8B,CAAC;AACzD,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,CAAC;AAGlD,QAAA,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAkFrB,CAAC;AACL,KAAK,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAOzD,wBAAsB,qBAAqB,CACzC,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,oBAAoB,EAC5B,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,OAAO,EAAE,CAAC,CA6DpB;AAED,wBAAgB,oBAAoB,CAClC,QAAQ,EAAE,OAAO,EAAE,EACnB,MAAM,EAAE,oBAAoB,EAC5B,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,GACf,OAAO,EAAE,CAuCX;AAED,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,EAAE,CA2DhE;AAMD,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAwDzE"}
@@ -0,0 +1,302 @@
1
+ import { createHash } from "node:crypto";
2
+ import { readFile } from "node:fs/promises";
3
+ import { isAbsolute, join, posix } from "node:path";
4
+ import Ajv2020 from "ajv/dist/2020.js";
5
+ import { z } from "incur";
6
+ import Papa from "papaparse";
7
+ import { CodexSecurityError } from "./errors.js";
8
+ export const CSV_TARGET_ID = "codex-security-csv-import";
9
+ const EXPORTED_CSV_ESCAPE = /^'(?:[\t\r\n]|\s*[=+\-@=+-@])/u;
10
+ const csvFindingRowSchema = z
11
+ .object({
12
+ occurrence_id: z.string().regex(/^occ_[a-f0-9]{24}$/u, {
13
+ error: "has an invalid occurrence_id",
14
+ }),
15
+ finding_id: z.string().regex(/^csf_[a-f0-9]{24}$/u, {
16
+ error: "has an invalid finding_id",
17
+ }),
18
+ candidate_id: z
19
+ .string()
20
+ .optional()
21
+ .transform((value) => value === undefined || value.trim() === "" ? undefined : value),
22
+ title: requiredCsvText("title"),
23
+ summary: requiredCsvText("summary"),
24
+ severity: z.enum(["critical", "high", "medium", "low", "informational"], {
25
+ error: "has an invalid severity",
26
+ }),
27
+ confidence: z.enum(["high", "medium", "low"], {
28
+ error: "has an invalid confidence",
29
+ }),
30
+ status: z.enum(["open", "closed"], {
31
+ error: "has an invalid status",
32
+ }),
33
+ close_reason: z
34
+ .union([
35
+ z.literal(""),
36
+ z.enum(["already_fixed", "wont_fix", "false_positive"]),
37
+ ], { error: "has an invalid close_reason" })
38
+ .transform((value) => (value === "" ? undefined : value)),
39
+ note: z
40
+ .string()
41
+ .transform((value) => (value.trim() === "" ? undefined : value)),
42
+ remediation: requiredCsvText("remediation"),
43
+ path: z.string().refine(safeFindingPath, {
44
+ error: "has an invalid path",
45
+ }),
46
+ start_line: z
47
+ .string()
48
+ .refine(validCsvLine, { error: "has an invalid start_line" })
49
+ .transform(Number),
50
+ end_line: z
51
+ .string()
52
+ .refine((value) => value === "" || validCsvLine(value), {
53
+ error: "has an invalid end_line",
54
+ })
55
+ .transform((value) => (value === "" ? undefined : Number(value))),
56
+ })
57
+ .superRefine((row, context) => {
58
+ if ((row.status === "open" && row.close_reason !== undefined) ||
59
+ (row.status === "closed" && row.close_reason === undefined)) {
60
+ context.addIssue({
61
+ code: "custom",
62
+ path: ["close_reason"],
63
+ message: "has an invalid close_reason",
64
+ });
65
+ }
66
+ if (row.status === "closed" &&
67
+ (row.close_reason === "false_positive" ||
68
+ row.close_reason === "wont_fix") &&
69
+ row.note === undefined) {
70
+ context.addIssue({
71
+ code: "custom",
72
+ path: ["note"],
73
+ message: "requires a note for its close_reason",
74
+ });
75
+ }
76
+ if (row.end_line !== undefined && row.end_line < row.start_line) {
77
+ context.addIssue({
78
+ code: "custom",
79
+ path: ["end_line"],
80
+ message: "has end_line before start_line",
81
+ });
82
+ }
83
+ });
84
+ const CSV_COLUMNS = Object.keys(csvFindingRowSchema.shape);
85
+ const REQUIRED_CSV_COLUMNS = CSV_COLUMNS.filter((column) => !csvFindingRowSchema.shape[column].isOptional());
86
+ export async function parseImportedFindings(source, format, pluginRoot) {
87
+ if (format === "csv") {
88
+ return parseFindingsCsv(source).map((row) => ({
89
+ ...csvRowFinding(row, "import"),
90
+ findingId: row.finding_id,
91
+ occurrenceId: row.occurrence_id,
92
+ }));
93
+ }
94
+ let payload;
95
+ try {
96
+ // Exported findings files often start with a UTF-8 byte order mark, which
97
+ // the CSV parser already skips.
98
+ payload = JSON.parse(source.replace(/^\uFEFF/u, ""));
99
+ }
100
+ catch (error) {
101
+ throw new CodexSecurityError("Findings JSON could not be parsed.", {
102
+ cause: error,
103
+ });
104
+ }
105
+ if (payload === null ||
106
+ typeof payload !== "object" ||
107
+ Array.isArray(payload)) {
108
+ throw new CodexSecurityError("Findings JSON must contain a findings document or an object with a findings array.");
109
+ }
110
+ const hasDocumentMetadata = ["documentType", "schemaVersion", "scanId"].some((key) => Object.hasOwn(payload, key));
111
+ const document = hasDocumentMetadata
112
+ ? payload
113
+ : {
114
+ documentType: "codex-security.findings",
115
+ schemaVersion: "1.0",
116
+ scanId: "import",
117
+ ...payload,
118
+ };
119
+ const schema = JSON.parse(await readFile(join(pluginRoot, "schemas", "findings.schema.json"), "utf8"));
120
+ const validate = new Ajv2020({ strict: false }).compile(schema);
121
+ if (!validate(document)) {
122
+ const error = validate.errors?.[0];
123
+ throw new CodexSecurityError(`Findings JSON does not match the Codex Security findings schema${error ? ` at ${error.instancePath || "/"}: ${error.message}` : ""}.`);
124
+ }
125
+ const occurrenceIds = new Set();
126
+ for (const [index, finding] of document.findings.entries()) {
127
+ if (occurrenceIds.has(finding.occurrenceId)) {
128
+ throw new CodexSecurityError(`Findings JSON finding ${index + 1} has a duplicate occurrenceId.`);
129
+ }
130
+ occurrenceIds.add(finding.occurrenceId);
131
+ }
132
+ return document.findings;
133
+ }
134
+ export function bindImportedFindings(findings, format, scanId, targetId) {
135
+ return findings.map((finding) => {
136
+ const ruleId = `import.${format}`;
137
+ const anchor = finding.occurrenceId;
138
+ const fingerprint = `codex-security/v1:sha256:${sha256(["codex-security/v1", targetId, ruleId, anchor, ""].join("\0"))}`;
139
+ // A source report path names another scan's artifact. Preserve it as
140
+ // provenance without treating the imported path as permission to read it.
141
+ const { writeup, ...content } = finding;
142
+ return {
143
+ ...content,
144
+ findingId: `csf_${sha256(fingerprint).slice(0, 24)}`,
145
+ occurrenceId: `occ_${sha256([scanId, fingerprint].join("\0")).slice(0, 24)}`,
146
+ ruleId,
147
+ identity: { anchor },
148
+ fingerprints: {
149
+ algorithm: "codex-security/v1",
150
+ primary: fingerprint,
151
+ },
152
+ provenance: { source: `${format}_import` },
153
+ extensions: {
154
+ ...finding.extensions,
155
+ import: {
156
+ format,
157
+ sourceFindingId: finding.findingId,
158
+ sourceOccurrenceId: finding.occurrenceId,
159
+ sourceRuleId: finding.ruleId,
160
+ sourceIdentity: finding.identity,
161
+ sourceFingerprints: finding.fingerprints,
162
+ sourceProvenance: finding.provenance,
163
+ ...(writeup === undefined ? {} : { sourceWriteup: writeup }),
164
+ ...(finding.extensions?.["import"] === undefined
165
+ ? {}
166
+ : { previousImport: finding.extensions["import"] }),
167
+ },
168
+ },
169
+ };
170
+ });
171
+ }
172
+ export function parseFindingsCsv(source) {
173
+ const { data: rows, errors, meta, } = Papa.parse(source, {
174
+ header: true,
175
+ delimiter: ",",
176
+ skipEmptyLines: "greedy",
177
+ transform: decodeExportedCsvCell,
178
+ });
179
+ const fieldMismatch = errors.find((error) => error.code === "TooFewFields" || error.code === "TooManyFields");
180
+ if (fieldMismatch?.row !== undefined) {
181
+ throw csvRowError(fieldMismatch.row + 2, "must match the header columns");
182
+ }
183
+ if (errors.length > 0) {
184
+ throw new CodexSecurityError(`Findings CSV could not be parsed: ${errors[0].message}`);
185
+ }
186
+ const headers = meta.fields;
187
+ const allowed = new Set(CSV_COLUMNS);
188
+ if (headers === undefined ||
189
+ !REQUIRED_CSV_COLUMNS.every((name) => headers.includes(name)) ||
190
+ headers.some((name) => !allowed.has(name)) ||
191
+ new Set(headers).size !== headers.length) {
192
+ throw new CodexSecurityError(`Findings CSV must use the Codex Security export columns: ${REQUIRED_CSV_COLUMNS.join(", ")} (candidate_id is optional).`);
193
+ }
194
+ if (rows.length === 0) {
195
+ throw new CodexSecurityError("Findings CSV must contain at least one finding.");
196
+ }
197
+ const findingIds = new Set();
198
+ const occurrenceIds = new Set();
199
+ return rows.map((record, index) => {
200
+ const rowNumber = index + 2;
201
+ const parsed = csvFindingRowSchema.safeParse(record);
202
+ if (!parsed.success) {
203
+ throw csvRowError(rowNumber, parsed.error.issues[0].message);
204
+ }
205
+ const row = parsed.data;
206
+ if (findingIds.has(row.finding_id)) {
207
+ throw csvRowError(rowNumber, "has a duplicate finding_id");
208
+ }
209
+ if (occurrenceIds.has(row.occurrence_id)) {
210
+ throw csvRowError(rowNumber, "has a duplicate occurrence_id");
211
+ }
212
+ findingIds.add(row.finding_id);
213
+ occurrenceIds.add(row.occurrence_id);
214
+ return row;
215
+ });
216
+ }
217
+ function decodeExportedCsvCell(value) {
218
+ return EXPORTED_CSV_ESCAPE.test(value) ? value.slice(1) : value;
219
+ }
220
+ export function csvRowFinding(row, scanId) {
221
+ const ruleId = "import.csv";
222
+ const anchor = row.finding_id;
223
+ const fingerprint = `codex-security/v1:sha256:${sha256(["codex-security/v1", CSV_TARGET_ID, ruleId, anchor, ""].join("\0"))}`;
224
+ const findingId = `csf_${sha256(fingerprint).slice(0, 24)}`;
225
+ const occurrenceId = `occ_${sha256([scanId, fingerprint].join("\0")).slice(0, 24)}`;
226
+ return {
227
+ findingId,
228
+ occurrenceId,
229
+ ruleId,
230
+ identity: { anchor },
231
+ fingerprints: {
232
+ algorithm: "codex-security/v1",
233
+ primary: fingerprint,
234
+ },
235
+ title: row.title,
236
+ summary: row.summary,
237
+ severity: { level: row.severity },
238
+ confidence: {
239
+ level: row.confidence,
240
+ rationale: "Imported from a Codex Security findings CSV.",
241
+ },
242
+ taxonomy: { category: "imported", cwe: [] },
243
+ locations: [
244
+ {
245
+ path: row.path,
246
+ startLine: row.start_line,
247
+ ...(row.end_line === undefined ? {} : { endLine: row.end_line }),
248
+ },
249
+ ],
250
+ remediation: row.remediation,
251
+ validation: {
252
+ method: "Source-reported CSV import metadata",
253
+ status: row.status,
254
+ summary: [
255
+ `Source finding ID: ${row.finding_id}`,
256
+ `Source occurrence ID: ${row.occurrence_id}`,
257
+ `Source status: ${row.status}`,
258
+ ...(row.close_reason === undefined
259
+ ? []
260
+ : [`Source close reason: ${row.close_reason}`]),
261
+ ...(row.note === undefined ? [] : [`Source note: ${row.note}`]),
262
+ ].join("\n"),
263
+ },
264
+ provenance: { source: "csv_import" },
265
+ extensions: {
266
+ ...(row.candidate_id === undefined
267
+ ? {}
268
+ : { candidateId: row.candidate_id }),
269
+ },
270
+ };
271
+ }
272
+ function requiredCsvText(column) {
273
+ return z.string().refine((value) => value.trim().length > 0, {
274
+ error: `requires ${column}`,
275
+ });
276
+ }
277
+ function validCsvLine(value) {
278
+ if (!/^[1-9]\d*$/u.test(value))
279
+ return false;
280
+ const line = Number(value);
281
+ return Number.isSafeInteger(line);
282
+ }
283
+ function safeFindingPath(value) {
284
+ if (value.trim().length === 0 ||
285
+ value === "." ||
286
+ isAbsolute(value) ||
287
+ /^[A-Za-z]:/u.test(value) ||
288
+ value.includes("\\") ||
289
+ /[\u0000-\u001F]/u.test(value) ||
290
+ value.split("/").includes("..")) {
291
+ return false;
292
+ }
293
+ const normalized = posix.normalize(value).replace(/\/+$/u, "");
294
+ return normalized !== "." && !normalized.startsWith("../");
295
+ }
296
+ function csvRowError(rowNumber, detail) {
297
+ return new CodexSecurityError(`Findings CSV row ${rowNumber} ${detail}.`);
298
+ }
299
+ function sha256(value) {
300
+ return createHash("sha256").update(value, "utf8").digest("hex");
301
+ }
302
+ //# sourceMappingURL=findings-import.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"findings-import.js","sourceRoot":"","sources":["../src/findings-import.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,WAAW,CAAC;AACpD,OAAO,OAAO,MAAM,kBAAkB,CAAC;AACvC,OAAO,EAAE,CAAC,EAAE,MAAM,OAAO,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAGjD,MAAM,CAAC,MAAM,aAAa,GAAG,2BAA2B,CAAC;AAGzD,MAAM,mBAAmB,GAAG,gCAAgC,CAAC;AAC7D,MAAM,mBAAmB,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE;QACrD,KAAK,EAAE,8BAA8B;KACtC,CAAC;IACF,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,EAAE;QAClD,KAAK,EAAE,2BAA2B;KACnC,CAAC;IACF,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CACnB,KAAK,KAAK,SAAS,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAC/D;IACH,KAAK,EAAE,eAAe,CAAC,OAAO,CAAC;IAC/B,OAAO,EAAE,eAAe,CAAC,SAAS,CAAC;IACnC,QAAQ,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,eAAe,CAAC,EAAE;QACvE,KAAK,EAAE,yBAAyB;KACjC,CAAC;IACF,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,EAAE;QAC5C,KAAK,EAAE,2BAA2B;KACnC,CAAC;IACF,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE;QACjC,KAAK,EAAE,uBAAuB;KAC/B,CAAC;IACF,YAAY,EAAE,CAAC;SACZ,KAAK,CACJ;QACE,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QACb,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,UAAU,EAAE,gBAAgB,CAAC,CAAC;KACxD,EACD,EAAE,KAAK,EAAE,6BAA6B,EAAE,CACzC;SACA,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC3D,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAClE,WAAW,EAAE,eAAe,CAAC,aAAa,CAAC;IAC3C,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,eAAe,EAAE;QACvC,KAAK,EAAE,qBAAqB;KAC7B,CAAC;IACF,UAAU,EAAE,CAAC;SACV,MAAM,EAAE;SACR,MAAM,CAAC,YAAY,EAAE,EAAE,KAAK,EAAE,2BAA2B,EAAE,CAAC;SAC5D,SAAS,CAAC,MAAM,CAAC;IACpB,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,KAAK,EAAE,IAAI,YAAY,CAAC,KAAK,CAAC,EAAE;QACtD,KAAK,EAAE,yBAAyB;KACjC,CAAC;SACD,SAAS,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;CACpE,CAAC;KACD,WAAW,CAAC,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;IAC5B,IACE,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC;QACzD,CAAC,GAAG,CAAC,MAAM,KAAK,QAAQ,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,CAAC,EAC3D,CAAC;QACD,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,cAAc,CAAC;YACtB,OAAO,EAAE,6BAA6B;SACvC,CAAC,CAAC;IACL,CAAC;IACD,IACE,GAAG,CAAC,MAAM,KAAK,QAAQ;QACvB,CAAC,GAAG,CAAC,YAAY,KAAK,gBAAgB;YACpC,GAAG,CAAC,YAAY,KAAK,UAAU,CAAC;QAClC,GAAG,CAAC,IAAI,KAAK,SAAS,EACtB,CAAC;QACD,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,MAAM,CAAC;YACd,OAAO,EAAE,sCAAsC;SAChD,CAAC,CAAC;IACL,CAAC;IACD,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS,IAAI,GAAG,CAAC,QAAQ,GAAG,GAAG,CAAC,UAAU,EAAE,CAAC;QAChE,OAAO,CAAC,QAAQ,CAAC;YACf,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,CAAC,UAAU,CAAC;YAClB,OAAO,EAAE,gCAAgC;SAC1C,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC,CAAC;AAGL,MAAM,WAAW,GAAG,MAAM,CAAC,IAAI,CAAC,mBAAmB,CAAC,KAAK,CAAgB,CAAC;AAC1E,MAAM,oBAAoB,GAAG,WAAW,CAAC,MAAM,CAC7C,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,mBAAmB,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,UAAU,EAAE,CAC5D,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,MAAc,EACd,MAA4B,EAC5B,UAAkB;IAElB,IAAI,MAAM,KAAK,KAAK,EAAE,CAAC;QACrB,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YAC5C,GAAG,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC;YAC/B,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,YAAY,EAAE,GAAG,CAAC,aAAa;SAChC,CAAC,CAAC,CAAC;IACN,CAAC;IAED,IAAI,OAAgB,CAAC;IACrB,IAAI,CAAC;QACH,0EAA0E;QAC1E,gCAAgC;QAChC,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,kBAAkB,CAAC,oCAAoC,EAAE;YACjE,KAAK,EAAE,KAAK;SACb,CAAC,CAAC;IACL,CAAC;IACD,IACE,OAAO,KAAK,IAAI;QAChB,OAAO,OAAO,KAAK,QAAQ;QAC3B,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EACtB,CAAC;QACD,MAAM,IAAI,kBAAkB,CAC1B,oFAAoF,CACrF,CAAC;IACJ,CAAC;IACD,MAAM,mBAAmB,GAAG,CAAC,cAAc,EAAE,eAAe,EAAE,QAAQ,CAAC,CAAC,IAAI,CAC1E,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,GAAG,CAAC,CACrC,CAAC;IACF,MAAM,QAAQ,GAAG,mBAAmB;QAClC,CAAC,CAAC,OAAO;QACT,CAAC,CAAC;YACE,YAAY,EAAE,yBAAyB;YACvC,aAAa,EAAE,KAAK;YACpB,MAAM,EAAE,QAAQ;YAChB,GAAG,OAAO;SACX,CAAC;IACN,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CACvB,MAAM,QAAQ,CAAC,IAAI,CAAC,UAAU,EAAE,SAAS,EAAE,sBAAsB,CAAC,EAAE,MAAM,CAAC,CAC5E,CAAC;IACF,MAAM,QAAQ,GAAG,IAAI,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC,OAAO,CACrD,MAAM,CACP,CAAC;IACF,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC;QACxB,MAAM,KAAK,GAAG,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,MAAM,IAAI,kBAAkB,CAC1B,kEAAkE,KAAK,CAAC,CAAC,CAAC,OAAO,KAAK,CAAC,YAAY,IAAI,GAAG,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,GAAG,CACvI,CAAC;IACJ,CAAC;IACD,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,KAAK,MAAM,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,QAAQ,CAAC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3D,IAAI,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,CAAC;YAC5C,MAAM,IAAI,kBAAkB,CAC1B,yBAAyB,KAAK,GAAG,CAAC,gCAAgC,CACnE,CAAC;QACJ,CAAC;QACD,aAAa,CAAC,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,QAAQ,CAAC,QAAQ,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,oBAAoB,CAClC,QAAmB,EACnB,MAA4B,EAC5B,MAAc,EACd,QAAgB;IAEhB,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,UAAU,MAAM,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;QACpC,MAAM,WAAW,GAAG,4BAA4B,MAAM,CACpD,CAAC,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAC/D,EAAE,CAAC;QACJ,qEAAqE;QACrE,0EAA0E;QAC1E,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,OAAO,CAAC;QACxC,OAAO;YACL,GAAG,OAAO;YACV,SAAS,EAAE,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;YACpD,YAAY,EAAE,OAAO,MAAM,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE;YAC5E,MAAM;YACN,QAAQ,EAAE,EAAE,MAAM,EAAE;YACpB,YAAY,EAAE;gBACZ,SAAS,EAAE,mBAAmB;gBAC9B,OAAO,EAAE,WAAW;aACrB;YACD,UAAU,EAAE,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,EAAE;YAC1C,UAAU,EAAE;gBACV,GAAG,OAAO,CAAC,UAAU;gBACrB,MAAM,EAAE;oBACN,MAAM;oBACN,eAAe,EAAE,OAAO,CAAC,SAAS;oBAClC,kBAAkB,EAAE,OAAO,CAAC,YAAY;oBACxC,YAAY,EAAE,OAAO,CAAC,MAAM;oBAC5B,cAAc,EAAE,OAAO,CAAC,QAAQ;oBAChC,kBAAkB,EAAE,OAAO,CAAC,YAAY;oBACxC,gBAAgB,EAAE,OAAO,CAAC,UAAU;oBACpC,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;oBAC5D,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,CAAC,QAAQ,CAAC,KAAK,SAAS;wBAC9C,CAAC,CAAC,EAAE;wBACJ,CAAC,CAAC,EAAE,cAAc,EAAE,OAAO,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;iBACtD;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAc;IAC7C,MAAM,EACJ,IAAI,EAAE,IAAI,EACV,MAAM,EACN,IAAI,GACL,GAAG,IAAI,CAAC,KAAK,CAAyB,MAAM,EAAE;QAC7C,MAAM,EAAE,IAAI;QACZ,SAAS,EAAE,GAAG;QACd,cAAc,EAAE,QAAQ;QACxB,SAAS,EAAE,qBAAqB;KACjC,CAAC,CAAC;IACH,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAC/B,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,cAAc,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,CAC3E,CAAC;IACF,IAAI,aAAa,EAAE,GAAG,KAAK,SAAS,EAAE,CAAC;QACrC,MAAM,WAAW,CAAC,aAAa,CAAC,GAAG,GAAG,CAAC,EAAE,+BAA+B,CAAC,CAAC;IAC5E,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,kBAAkB,CAC1B,qCAAqC,MAAM,CAAC,CAAC,CAAE,CAAC,OAAO,EAAE,CAC1D,CAAC;IACJ,CAAC;IACD,MAAM,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;IAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,CAAS,WAAW,CAAC,CAAC;IAC7C,IACE,OAAO,KAAK,SAAS;QACrB,CAAC,oBAAoB,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC1C,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,MAAM,EACxC,CAAC;QACD,MAAM,IAAI,kBAAkB,CAC1B,4DAA4D,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,8BAA8B,CAC1H,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,kBAAkB,CAC1B,iDAAiD,CAClD,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IACxC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,EAAE;QAChC,MAAM,SAAS,GAAG,KAAK,GAAG,CAAC,CAAC;QAC5B,MAAM,MAAM,GAAG,mBAAmB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;QACrD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACpB,MAAM,WAAW,CAAC,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC,OAAO,CAAC,CAAC;QAChE,CAAC;QACD,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC;QACxB,IAAI,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACnC,MAAM,WAAW,CAAC,SAAS,EAAE,4BAA4B,CAAC,CAAC;QAC7D,CAAC;QACD,IAAI,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE,CAAC;YACzC,MAAM,WAAW,CAAC,SAAS,EAAE,+BAA+B,CAAC,CAAC;QAChE,CAAC;QACD,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;QAC/B,aAAa,CAAC,GAAG,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACrC,OAAO,GAAG,CAAC;IACb,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAa;IAC1C,OAAO,mBAAmB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;AAClE,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAkB,EAAE,MAAc;IAC9D,MAAM,MAAM,GAAG,YAAY,CAAC;IAC5B,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC;IAC9B,MAAM,WAAW,GAAG,4BAA4B,MAAM,CACpD,CAAC,mBAAmB,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CACpE,EAAE,CAAC;IACJ,MAAM,SAAS,GAAG,OAAO,MAAM,CAAC,WAAW,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;IAC5D,MAAM,YAAY,GAAG,OAAO,MAAM,CAAC,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CACxE,CAAC,EACD,EAAE,CACH,EAAE,CAAC;IACJ,OAAO;QACL,SAAS;QACT,YAAY;QACZ,MAAM;QACN,QAAQ,EAAE,EAAE,MAAM,EAAE;QACpB,YAAY,EAAE;YACZ,SAAS,EAAE,mBAAmB;YAC9B,OAAO,EAAE,WAAW;SACrB;QACD,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,QAAQ,EAAE,EAAE,KAAK,EAAE,GAAG,CAAC,QAAQ,EAAE;QACjC,UAAU,EAAE;YACV,KAAK,EAAE,GAAG,CAAC,UAAU;YACrB,SAAS,EAAE,8CAA8C;SAC1D;QACD,QAAQ,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,EAAE;QAC3C,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,GAAG,CAAC,IAAI;gBACd,SAAS,EAAE,GAAG,CAAC,UAAU;gBACzB,GAAG,CAAC,GAAG,CAAC,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,QAAQ,EAAE,CAAC;aACjE;SACF;QACD,WAAW,EAAE,GAAG,CAAC,WAAW;QAC5B,UAAU,EAAE;YACV,MAAM,EAAE,qCAAqC;YAC7C,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE;gBACP,sBAAsB,GAAG,CAAC,UAAU,EAAE;gBACtC,yBAAyB,GAAG,CAAC,aAAa,EAAE;gBAC5C,kBAAkB,GAAG,CAAC,MAAM,EAAE;gBAC9B,GAAG,CAAC,GAAG,CAAC,YAAY,KAAK,SAAS;oBAChC,CAAC,CAAC,EAAE;oBACJ,CAAC,CAAC,CAAC,wBAAwB,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC;gBACjD,GAAG,CAAC,GAAG,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;aAChE,CAAC,IAAI,CAAC,IAAI,CAAC;SACb;QACD,UAAU,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE;QACpC,UAAU,EAAE;YACV,GAAG,CAAC,GAAG,CAAC,YAAY,KAAK,SAAS;gBAChC,CAAC,CAAC,EAAE;gBACJ,CAAC,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC;SACvC;KACF,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE;QAC3D,KAAK,EAAE,YAAY,MAAM,EAAE;KAC5B,CAAC,CAAC;AACL,CAAC;AAED,SAAS,YAAY,CAAC,KAAa;IACjC,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,IACE,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC;QACzB,KAAK,KAAK,GAAG;QACb,UAAU,CAAC,KAAK,CAAC;QACjB,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC;QACzB,KAAK,CAAC,QAAQ,CAAC,IAAI,CAAC;QACpB,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC;QAC9B,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAC/B,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC;IAC/D,OAAO,UAAU,KAAK,GAAG,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,SAAS,WAAW,CAAC,SAAiB,EAAE,MAAc;IACpD,OAAO,IAAI,kBAAkB,CAAC,oBAAoB,SAAS,IAAI,MAAM,GAAG,CAAC,CAAC;AAC5E,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { readFile } from \"node:fs/promises\";\nimport { isAbsolute, join, posix } from \"node:path\";\nimport Ajv2020 from \"ajv/dist/2020.js\";\nimport { z } from \"incur\";\nimport Papa from \"papaparse\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport type { Finding, FindingsDocument } from \"./models.js\";\n\nexport const CSV_TARGET_ID = \"codex-security-csv-import\";\nexport type FindingsImportFormat = \"csv\" | \"json\";\n\nconst EXPORTED_CSV_ESCAPE = /^'(?:[\\t\\r\\n]|\\s*[=+\\-@=+-@])/u;\nconst csvFindingRowSchema = z\n .object({\n occurrence_id: z.string().regex(/^occ_[a-f0-9]{24}$/u, {\n error: \"has an invalid occurrence_id\",\n }),\n finding_id: z.string().regex(/^csf_[a-f0-9]{24}$/u, {\n error: \"has an invalid finding_id\",\n }),\n candidate_id: z\n .string()\n .optional()\n .transform((value) =>\n value === undefined || value.trim() === \"\" ? undefined : value,\n ),\n title: requiredCsvText(\"title\"),\n summary: requiredCsvText(\"summary\"),\n severity: z.enum([\"critical\", \"high\", \"medium\", \"low\", \"informational\"], {\n error: \"has an invalid severity\",\n }),\n confidence: z.enum([\"high\", \"medium\", \"low\"], {\n error: \"has an invalid confidence\",\n }),\n status: z.enum([\"open\", \"closed\"], {\n error: \"has an invalid status\",\n }),\n close_reason: z\n .union(\n [\n z.literal(\"\"),\n z.enum([\"already_fixed\", \"wont_fix\", \"false_positive\"]),\n ],\n { error: \"has an invalid close_reason\" },\n )\n .transform((value) => (value === \"\" ? undefined : value)),\n note: z\n .string()\n .transform((value) => (value.trim() === \"\" ? undefined : value)),\n remediation: requiredCsvText(\"remediation\"),\n path: z.string().refine(safeFindingPath, {\n error: \"has an invalid path\",\n }),\n start_line: z\n .string()\n .refine(validCsvLine, { error: \"has an invalid start_line\" })\n .transform(Number),\n end_line: z\n .string()\n .refine((value) => value === \"\" || validCsvLine(value), {\n error: \"has an invalid end_line\",\n })\n .transform((value) => (value === \"\" ? undefined : Number(value))),\n })\n .superRefine((row, context) => {\n if (\n (row.status === \"open\" && row.close_reason !== undefined) ||\n (row.status === \"closed\" && row.close_reason === undefined)\n ) {\n context.addIssue({\n code: \"custom\",\n path: [\"close_reason\"],\n message: \"has an invalid close_reason\",\n });\n }\n if (\n row.status === \"closed\" &&\n (row.close_reason === \"false_positive\" ||\n row.close_reason === \"wont_fix\") &&\n row.note === undefined\n ) {\n context.addIssue({\n code: \"custom\",\n path: [\"note\"],\n message: \"requires a note for its close_reason\",\n });\n }\n if (row.end_line !== undefined && row.end_line < row.start_line) {\n context.addIssue({\n code: \"custom\",\n path: [\"end_line\"],\n message: \"has end_line before start_line\",\n });\n }\n });\ntype CsvFindingRow = z.infer<typeof csvFindingRowSchema>;\ntype CsvColumn = keyof typeof csvFindingRowSchema.shape;\nconst CSV_COLUMNS = Object.keys(csvFindingRowSchema.shape) as CsvColumn[];\nconst REQUIRED_CSV_COLUMNS = CSV_COLUMNS.filter(\n (column) => !csvFindingRowSchema.shape[column].isOptional(),\n);\n\nexport async function parseImportedFindings(\n source: string,\n format: FindingsImportFormat,\n pluginRoot: string,\n): Promise<Finding[]> {\n if (format === \"csv\") {\n return parseFindingsCsv(source).map((row) => ({\n ...csvRowFinding(row, \"import\"),\n findingId: row.finding_id,\n occurrenceId: row.occurrence_id,\n }));\n }\n\n let payload: unknown;\n try {\n // Exported findings files often start with a UTF-8 byte order mark, which\n // the CSV parser already skips.\n payload = JSON.parse(source.replace(/^\\uFEFF/u, \"\"));\n } catch (error) {\n throw new CodexSecurityError(\"Findings JSON could not be parsed.\", {\n cause: error,\n });\n }\n if (\n payload === null ||\n typeof payload !== \"object\" ||\n Array.isArray(payload)\n ) {\n throw new CodexSecurityError(\n \"Findings JSON must contain a findings document or an object with a findings array.\",\n );\n }\n const hasDocumentMetadata = [\"documentType\", \"schemaVersion\", \"scanId\"].some(\n (key) => Object.hasOwn(payload, key),\n );\n const document = hasDocumentMetadata\n ? payload\n : {\n documentType: \"codex-security.findings\",\n schemaVersion: \"1.0\",\n scanId: \"import\",\n ...payload,\n };\n const schema = JSON.parse(\n await readFile(join(pluginRoot, \"schemas\", \"findings.schema.json\"), \"utf8\"),\n );\n const validate = new Ajv2020({ strict: false }).compile<FindingsDocument>(\n schema,\n );\n if (!validate(document)) {\n const error = validate.errors?.[0];\n throw new CodexSecurityError(\n `Findings JSON does not match the Codex Security findings schema${error ? ` at ${error.instancePath || \"/\"}: ${error.message}` : \"\"}.`,\n );\n }\n const occurrenceIds = new Set<string>();\n for (const [index, finding] of document.findings.entries()) {\n if (occurrenceIds.has(finding.occurrenceId)) {\n throw new CodexSecurityError(\n `Findings JSON finding ${index + 1} has a duplicate occurrenceId.`,\n );\n }\n occurrenceIds.add(finding.occurrenceId);\n }\n return document.findings;\n}\n\nexport function bindImportedFindings(\n findings: Finding[],\n format: FindingsImportFormat,\n scanId: string,\n targetId: string,\n): Finding[] {\n return findings.map((finding) => {\n const ruleId = `import.${format}`;\n const anchor = finding.occurrenceId;\n const fingerprint = `codex-security/v1:sha256:${sha256(\n [\"codex-security/v1\", targetId, ruleId, anchor, \"\"].join(\"\\0\"),\n )}`;\n // A source report path names another scan's artifact. Preserve it as\n // provenance without treating the imported path as permission to read it.\n const { writeup, ...content } = finding;\n return {\n ...content,\n findingId: `csf_${sha256(fingerprint).slice(0, 24)}`,\n occurrenceId: `occ_${sha256([scanId, fingerprint].join(\"\\0\")).slice(0, 24)}`,\n ruleId,\n identity: { anchor },\n fingerprints: {\n algorithm: \"codex-security/v1\",\n primary: fingerprint,\n },\n provenance: { source: `${format}_import` },\n extensions: {\n ...finding.extensions,\n import: {\n format,\n sourceFindingId: finding.findingId,\n sourceOccurrenceId: finding.occurrenceId,\n sourceRuleId: finding.ruleId,\n sourceIdentity: finding.identity,\n sourceFingerprints: finding.fingerprints,\n sourceProvenance: finding.provenance,\n ...(writeup === undefined ? {} : { sourceWriteup: writeup }),\n ...(finding.extensions?.[\"import\"] === undefined\n ? {}\n : { previousImport: finding.extensions[\"import\"] }),\n },\n },\n };\n });\n}\n\nexport function parseFindingsCsv(source: string): CsvFindingRow[] {\n const {\n data: rows,\n errors,\n meta,\n } = Papa.parse<Record<string, string>>(source, {\n header: true,\n delimiter: \",\",\n skipEmptyLines: \"greedy\",\n transform: decodeExportedCsvCell,\n });\n const fieldMismatch = errors.find(\n (error) => error.code === \"TooFewFields\" || error.code === \"TooManyFields\",\n );\n if (fieldMismatch?.row !== undefined) {\n throw csvRowError(fieldMismatch.row + 2, \"must match the header columns\");\n }\n if (errors.length > 0) {\n throw new CodexSecurityError(\n `Findings CSV could not be parsed: ${errors[0]!.message}`,\n );\n }\n const headers = meta.fields;\n const allowed = new Set<string>(CSV_COLUMNS);\n if (\n headers === undefined ||\n !REQUIRED_CSV_COLUMNS.every((name) => headers.includes(name)) ||\n headers.some((name) => !allowed.has(name)) ||\n new Set(headers).size !== headers.length\n ) {\n throw new CodexSecurityError(\n `Findings CSV must use the Codex Security export columns: ${REQUIRED_CSV_COLUMNS.join(\", \")} (candidate_id is optional).`,\n );\n }\n if (rows.length === 0) {\n throw new CodexSecurityError(\n \"Findings CSV must contain at least one finding.\",\n );\n }\n\n const findingIds = new Set<string>();\n const occurrenceIds = new Set<string>();\n return rows.map((record, index) => {\n const rowNumber = index + 2;\n const parsed = csvFindingRowSchema.safeParse(record);\n if (!parsed.success) {\n throw csvRowError(rowNumber, parsed.error.issues[0]!.message);\n }\n const row = parsed.data;\n if (findingIds.has(row.finding_id)) {\n throw csvRowError(rowNumber, \"has a duplicate finding_id\");\n }\n if (occurrenceIds.has(row.occurrence_id)) {\n throw csvRowError(rowNumber, \"has a duplicate occurrence_id\");\n }\n findingIds.add(row.finding_id);\n occurrenceIds.add(row.occurrence_id);\n return row;\n });\n}\n\nfunction decodeExportedCsvCell(value: string): string {\n return EXPORTED_CSV_ESCAPE.test(value) ? value.slice(1) : value;\n}\n\nexport function csvRowFinding(row: CsvFindingRow, scanId: string): Finding {\n const ruleId = \"import.csv\";\n const anchor = row.finding_id;\n const fingerprint = `codex-security/v1:sha256:${sha256(\n [\"codex-security/v1\", CSV_TARGET_ID, ruleId, anchor, \"\"].join(\"\\0\"),\n )}`;\n const findingId = `csf_${sha256(fingerprint).slice(0, 24)}`;\n const occurrenceId = `occ_${sha256([scanId, fingerprint].join(\"\\0\")).slice(\n 0,\n 24,\n )}`;\n return {\n findingId,\n occurrenceId,\n ruleId,\n identity: { anchor },\n fingerprints: {\n algorithm: \"codex-security/v1\",\n primary: fingerprint,\n },\n title: row.title,\n summary: row.summary,\n severity: { level: row.severity },\n confidence: {\n level: row.confidence,\n rationale: \"Imported from a Codex Security findings CSV.\",\n },\n taxonomy: { category: \"imported\", cwe: [] },\n locations: [\n {\n path: row.path,\n startLine: row.start_line,\n ...(row.end_line === undefined ? {} : { endLine: row.end_line }),\n },\n ],\n remediation: row.remediation,\n validation: {\n method: \"Source-reported CSV import metadata\",\n status: row.status,\n summary: [\n `Source finding ID: ${row.finding_id}`,\n `Source occurrence ID: ${row.occurrence_id}`,\n `Source status: ${row.status}`,\n ...(row.close_reason === undefined\n ? []\n : [`Source close reason: ${row.close_reason}`]),\n ...(row.note === undefined ? [] : [`Source note: ${row.note}`]),\n ].join(\"\\n\"),\n },\n provenance: { source: \"csv_import\" },\n extensions: {\n ...(row.candidate_id === undefined\n ? {}\n : { candidateId: row.candidate_id }),\n },\n };\n}\n\nfunction requiredCsvText(column: string) {\n return z.string().refine((value) => value.trim().length > 0, {\n error: `requires ${column}`,\n });\n}\n\nfunction validCsvLine(value: string): boolean {\n if (!/^[1-9]\\d*$/u.test(value)) return false;\n const line = Number(value);\n return Number.isSafeInteger(line);\n}\n\nfunction safeFindingPath(value: string): boolean {\n if (\n value.trim().length === 0 ||\n value === \".\" ||\n isAbsolute(value) ||\n /^[A-Za-z]:/u.test(value) ||\n value.includes(\"\\\\\") ||\n /[\\u0000-\\u001F]/u.test(value) ||\n value.split(\"/\").includes(\"..\")\n ) {\n return false;\n }\n const normalized = posix.normalize(value).replace(/\\/+$/u, \"\");\n return normalized !== \".\" && !normalized.startsWith(\"../\");\n}\n\nfunction csvRowError(rowNumber: number, detail: string): CodexSecurityError {\n return new CodexSecurityError(`Findings CSV row ${rowNumber} ${detail}.`);\n}\n\nfunction sha256(value: string): string {\n return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n"]}
@@ -0,0 +1,27 @@
1
+ import type { CodexSecurityConfig } from "./config.js";
2
+ import { ScanResult } from "./result.js";
3
+ import { resolvePluginPython, runWorkbench, type ProcessEnvironment } from "./runtime.js";
4
+ export interface ImportScanOptions {
5
+ sourcePath: string;
6
+ format: "csv" | "json";
7
+ config?: CodexSecurityConfig;
8
+ outputDir?: string;
9
+ archiveExisting?: boolean;
10
+ dryRun?: boolean;
11
+ parentScanId?: string;
12
+ signal?: AbortSignal;
13
+ }
14
+ export interface ImportScanPreview {
15
+ dryRun: true;
16
+ inputPath: string;
17
+ format: "csv" | "json";
18
+ findingCount: number;
19
+ }
20
+ export interface ImportScanDependencies {
21
+ environment?: ProcessEnvironment;
22
+ runWorkbench?: typeof runWorkbench;
23
+ resolvePluginPython?: typeof resolvePluginPython;
24
+ }
25
+ /** Save supplied findings through the normal scan completion and indexing flow. */
26
+ export declare function importScan(options: ImportScanOptions, dependencies?: ImportScanDependencies): Promise<ScanResult | ImportScanPreview>;
27
+ //# sourceMappingURL=import-scan.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"import-scan.d.ts","sourceRoot":"","sources":["../src/import-scan.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAWvD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAWL,mBAAmB,EACnB,YAAY,EAEZ,KAAK,kBAAkB,EAExB,MAAM,cAAc,CAAC;AAEtB,MAAM,WAAW,iBAAiB;IAChC,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,MAAM,CAAC,EAAE,mBAAmB,CAAC;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,IAAI,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,KAAK,GAAG,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,YAAY,CAAC,EAAE,OAAO,YAAY,CAAC;IACnC,mBAAmB,CAAC,EAAE,OAAO,mBAAmB,CAAC;CAClD;AAmDD,mFAAmF;AACnF,wBAAsB,UAAU,CAC9B,OAAO,EAAE,iBAAiB,EAC1B,YAAY,GAAE,sBAA2B,GACxC,OAAO,CAAC,UAAU,GAAG,iBAAiB,CAAC,CA0OzC"}