@openai/codex-security 0.5.0 → 0.6.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 (299) hide show
  1. package/README.md +93 -2
  2. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  3. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  4. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  5. package/_bundled_plugin/mcp/permission-profile-preflight.mjs +60 -9
  6. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  7. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  8. package/_bundled_plugin/schemas/definitions/artifact-common.schema.json +1 -1
  9. package/_bundled_plugin/scripts/finalize_scan_contract.py +12 -1
  10. package/_bundled_plugin/scripts/generate_in_scope_files.py +6 -6
  11. package/_bundled_plugin/scripts/generate_rank_input.py +12 -6
  12. package/_bundled_plugin/scripts/report_projection.py +2 -1
  13. package/_bundled_plugin/scripts/threat_model_projection.py +1 -3
  14. package/_bundled_plugin/scripts/workbench/saved_coverage.py +234 -0
  15. package/_bundled_plugin/scripts/workbench_cli.py +5 -7
  16. package/_bundled_plugin/scripts/workbench_db.py +12 -6
  17. package/_bundled_plugin/scripts/workbench_finding_workflows.py +2 -0
  18. package/_bundled_plugin/scripts/workbench_native_indexes.py +10 -7
  19. package/_bundled_plugin/scripts/workbench_publication.py +4 -3
  20. package/_bundled_plugin/scripts/workbench_remediation.py +5 -1
  21. package/_bundled_plugin/scripts/workbench_saved_results.py +542 -148
  22. package/_bundled_plugin/scripts/workbench_scan_history.py +79 -78
  23. package/_bundled_plugin/scripts/workbench_scan_usage.py +61 -13
  24. package/_bundled_plugin/scripts/workbench_target.py +21 -7
  25. package/_bundled_plugin/scripts/workbench_validation.py +21 -18
  26. package/_bundled_plugin/shared/workbench-migrations.json +26 -0
  27. package/_bundled_plugin/skills/fix-finding/SKILL.md +16 -8
  28. package/_bundled_plugin/skills/publish-findings/SKILL.md +130 -0
  29. package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +6 -0
  30. package/_bundled_plugin/skills/verify-fix/SKILL.md +4 -2
  31. package/dist/api.d.ts +4 -1
  32. package/dist/api.d.ts.map +1 -1
  33. package/dist/api.js +233 -91
  34. package/dist/api.js.map +1 -1
  35. package/dist/classify-scan-severity.d.ts.map +1 -1
  36. package/dist/classify-scan-severity.js +16 -18
  37. package/dist/classify-scan-severity.js.map +1 -1
  38. package/dist/classify-severity-records.d.ts +5 -2
  39. package/dist/classify-severity-records.d.ts.map +1 -1
  40. package/dist/classify-severity-records.js +40 -34
  41. package/dist/classify-severity-records.js.map +1 -1
  42. package/dist/classify-severity.d.ts +5 -1
  43. package/dist/classify-severity.d.ts.map +1 -1
  44. package/dist/classify-severity.js +20 -30
  45. package/dist/classify-severity.js.map +1 -1
  46. package/dist/cli-daybreak.d.ts +5 -0
  47. package/dist/cli-daybreak.d.ts.map +1 -0
  48. package/dist/cli-daybreak.js +89 -0
  49. package/dist/cli-daybreak.js.map +1 -0
  50. package/dist/cli-help.d.ts.map +1 -1
  51. package/dist/cli-help.js +1 -0
  52. package/dist/cli-help.js.map +1 -1
  53. package/dist/cli.d.ts +12 -1
  54. package/dist/cli.d.ts.map +1 -1
  55. package/dist/cli.js +1224 -596
  56. package/dist/cli.js.map +1 -1
  57. package/dist/cloud-endpoint.d.ts +6 -0
  58. package/dist/cloud-endpoint.d.ts.map +1 -0
  59. package/dist/cloud-endpoint.js +51 -0
  60. package/dist/cloud-endpoint.js.map +1 -0
  61. package/dist/cloud-publish.d.ts.map +1 -1
  62. package/dist/cloud-publish.js +7 -5
  63. package/dist/cloud-publish.js.map +1 -1
  64. package/dist/codeowners.js +2 -2
  65. package/dist/codeowners.js.map +1 -1
  66. package/dist/component-plan.d.ts.map +1 -1
  67. package/dist/component-plan.js +3 -2
  68. package/dist/component-plan.js.map +1 -1
  69. package/dist/component-scan.js +2 -2
  70. package/dist/component-scan.js.map +1 -1
  71. package/dist/config.d.ts.map +1 -1
  72. package/dist/config.js +5 -1
  73. package/dist/config.js.map +1 -1
  74. package/dist/cost.d.ts +2 -1
  75. package/dist/cost.d.ts.map +1 -1
  76. package/dist/cost.js +17 -8
  77. package/dist/cost.js.map +1 -1
  78. package/dist/custom-validation.d.ts.map +1 -1
  79. package/dist/custom-validation.js +2 -5
  80. package/dist/custom-validation.js.map +1 -1
  81. package/dist/deduplication/codex-review.d.ts.map +1 -1
  82. package/dist/deduplication/codex-review.js +8 -6
  83. package/dist/deduplication/codex-review.js.map +1 -1
  84. package/dist/deduplication/local.d.ts.map +1 -1
  85. package/dist/deduplication/local.js +5 -2
  86. package/dist/deduplication/local.js.map +1 -1
  87. package/dist/deduplication/retry.d.ts.map +1 -1
  88. package/dist/deduplication/retry.js +5 -0
  89. package/dist/deduplication/retry.js.map +1 -1
  90. package/dist/deduplication/scan.js +5 -1
  91. package/dist/deduplication/scan.js.map +1 -1
  92. package/dist/deep-scan.d.ts +6 -0
  93. package/dist/deep-scan.d.ts.map +1 -1
  94. package/dist/deep-scan.js +8 -6
  95. package/dist/deep-scan.js.map +1 -1
  96. package/dist/default-severity-rubric.d.ts +3 -0
  97. package/dist/default-severity-rubric.d.ts.map +1 -0
  98. package/dist/default-severity-rubric.js +67 -0
  99. package/dist/default-severity-rubric.js.map +1 -0
  100. package/dist/endor-findings.d.ts +7 -0
  101. package/dist/endor-findings.d.ts.map +1 -0
  102. package/dist/endor-findings.js +233 -0
  103. package/dist/endor-findings.js.map +1 -0
  104. package/dist/external-findings-import.d.ts +5 -0
  105. package/dist/external-findings-import.d.ts.map +1 -0
  106. package/dist/external-findings-import.js +38 -0
  107. package/dist/external-findings-import.js.map +1 -0
  108. package/dist/external-findings-local.d.ts +63 -0
  109. package/dist/external-findings-local.d.ts.map +1 -0
  110. package/dist/external-findings-local.js +337 -0
  111. package/dist/external-findings-local.js.map +1 -0
  112. package/dist/external-findings-publish.d.ts +73 -0
  113. package/dist/external-findings-publish.d.ts.map +1 -0
  114. package/dist/external-findings-publish.js +713 -0
  115. package/dist/external-findings-publish.js.map +1 -0
  116. package/dist/external-findings-read.d.ts +6 -0
  117. package/dist/external-findings-read.d.ts.map +1 -0
  118. package/dist/external-findings-read.js +88 -0
  119. package/dist/external-findings-read.js.map +1 -0
  120. package/dist/external-findings.d.ts +21 -0
  121. package/dist/external-findings.d.ts.map +1 -0
  122. package/dist/external-findings.js +2 -0
  123. package/dist/external-findings.js.map +1 -0
  124. package/dist/external-import-contract.d.ts +13 -0
  125. package/dist/external-import-contract.d.ts.map +1 -0
  126. package/dist/external-import-contract.js +254 -0
  127. package/dist/external-import-contract.js.map +1 -0
  128. package/dist/external-import-models.d.ts +362 -0
  129. package/dist/external-import-models.d.ts.map +1 -0
  130. package/dist/external-import-models.js +3 -0
  131. package/dist/external-import-models.js.map +1 -0
  132. package/dist/finding-workflow.d.ts +1 -1
  133. package/dist/finding-workflow.d.ts.map +1 -1
  134. package/dist/finding-workflow.js +2 -1
  135. package/dist/finding-workflow.js.map +1 -1
  136. package/dist/findings-import.d.ts.map +1 -1
  137. package/dist/findings-import.js +23 -3
  138. package/dist/findings-import.js.map +1 -1
  139. package/dist/github-advisories.d.ts +386 -0
  140. package/dist/github-advisories.d.ts.map +1 -0
  141. package/dist/github-advisories.js +131 -0
  142. package/dist/github-advisories.js.map +1 -0
  143. package/dist/github-findings.d.ts +10 -0
  144. package/dist/github-findings.d.ts.map +1 -0
  145. package/dist/github-findings.js +256 -0
  146. package/dist/github-findings.js.map +1 -0
  147. package/dist/host-protocol.d.ts +1 -0
  148. package/dist/host-protocol.d.ts.map +1 -1
  149. package/dist/host-protocol.js +1 -1
  150. package/dist/host-protocol.js.map +1 -1
  151. package/dist/hosted-remediation-protocol.d.ts +6 -0
  152. package/dist/hosted-remediation-protocol.d.ts.map +1 -0
  153. package/dist/hosted-remediation-protocol.js +32 -0
  154. package/dist/hosted-remediation-protocol.js.map +1 -0
  155. package/dist/hosted-remediation.d.ts +93 -0
  156. package/dist/hosted-remediation.d.ts.map +1 -0
  157. package/dist/hosted-remediation.js +124 -0
  158. package/dist/hosted-remediation.js.map +1 -0
  159. package/dist/hosted-scan.d.ts +16 -0
  160. package/dist/hosted-scan.d.ts.map +1 -1
  161. package/dist/hosted-scan.js +14 -2
  162. package/dist/hosted-scan.js.map +1 -1
  163. package/dist/import-scan.d.ts +1 -0
  164. package/dist/import-scan.d.ts.map +1 -1
  165. package/dist/import-scan.js +5 -1
  166. package/dist/import-scan.js.map +1 -1
  167. package/dist/index.d.ts +18 -1
  168. package/dist/index.d.ts.map +1 -1
  169. package/dist/index.js +10 -0
  170. package/dist/index.js.map +1 -1
  171. package/dist/multiscan.d.ts.map +1 -1
  172. package/dist/multiscan.js +3 -1
  173. package/dist/multiscan.js.map +1 -1
  174. package/dist/project-config-schema.d.ts +2 -0
  175. package/dist/project-config-schema.d.ts.map +1 -1
  176. package/dist/project-config-schema.js +1 -0
  177. package/dist/project-config-schema.js.map +1 -1
  178. package/dist/project-config.d.ts +1 -0
  179. package/dist/project-config.d.ts.map +1 -1
  180. package/dist/project-config.js +15 -9
  181. package/dist/project-config.js.map +1 -1
  182. package/dist/publish.d.ts +2 -0
  183. package/dist/publish.d.ts.map +1 -1
  184. package/dist/publish.js +9 -0
  185. package/dist/publish.js.map +1 -1
  186. package/dist/remediation.d.ts +69 -0
  187. package/dist/remediation.d.ts.map +1 -0
  188. package/dist/remediation.js +121 -0
  189. package/dist/remediation.js.map +1 -0
  190. package/dist/request-metadata.d.ts +17 -7
  191. package/dist/request-metadata.d.ts.map +1 -1
  192. package/dist/request-metadata.js +43 -8
  193. package/dist/request-metadata.js.map +1 -1
  194. package/dist/result.d.ts +4 -0
  195. package/dist/result.d.ts.map +1 -1
  196. package/dist/result.js +10 -0
  197. package/dist/result.js.map +1 -1
  198. package/dist/runtime.d.ts +1 -0
  199. package/dist/runtime.d.ts.map +1 -1
  200. package/dist/runtime.js +24 -15
  201. package/dist/runtime.js.map +1 -1
  202. package/dist/saved-scan-bootstrap.d.ts +1 -0
  203. package/dist/saved-scan-bootstrap.d.ts.map +1 -1
  204. package/dist/saved-scan-bootstrap.js +16 -4
  205. package/dist/saved-scan-bootstrap.js.map +1 -1
  206. package/dist/scan-activity.js +8 -8
  207. package/dist/scan-activity.js.map +1 -1
  208. package/dist/scan-comparison.d.ts.map +1 -1
  209. package/dist/scan-comparison.js +15 -9
  210. package/dist/scan-comparison.js.map +1 -1
  211. package/dist/scan-dashboard.d.ts.map +1 -1
  212. package/dist/scan-dashboard.js +12 -6
  213. package/dist/scan-dashboard.js.map +1 -1
  214. package/dist/scan-executor.d.ts +5 -1
  215. package/dist/scan-executor.d.ts.map +1 -1
  216. package/dist/scan-executor.js +9 -8
  217. package/dist/scan-executor.js.map +1 -1
  218. package/dist/scan-owner-suggestions.d.ts +8 -0
  219. package/dist/scan-owner-suggestions.d.ts.map +1 -0
  220. package/dist/scan-owner-suggestions.js +33 -0
  221. package/dist/scan-owner-suggestions.js.map +1 -0
  222. package/dist/{deep-progress.d.ts → scan-progress.d.ts} +15 -7
  223. package/dist/scan-progress.d.ts.map +1 -0
  224. package/dist/scan-progress.js +138 -0
  225. package/dist/scan-progress.js.map +1 -0
  226. package/dist/scan-settings.d.ts +1 -0
  227. package/dist/scan-settings.d.ts.map +1 -1
  228. package/dist/scan-settings.js +4 -0
  229. package/dist/scan-settings.js.map +1 -1
  230. package/dist/scanner-import.d.ts +20 -0
  231. package/dist/scanner-import.d.ts.map +1 -0
  232. package/dist/scanner-import.js +204 -0
  233. package/dist/scanner-import.js.map +1 -0
  234. package/dist/security-policy-diff.d.ts +2 -0
  235. package/dist/security-policy-diff.d.ts.map +1 -0
  236. package/dist/security-policy-diff.js +197 -0
  237. package/dist/security-policy-diff.js.map +1 -0
  238. package/dist/security-policy.d.ts +7 -3
  239. package/dist/security-policy.d.ts.map +1 -1
  240. package/dist/security-policy.js +11 -57
  241. package/dist/security-policy.js.map +1 -1
  242. package/dist/semgrep-findings.d.ts +9 -0
  243. package/dist/semgrep-findings.d.ts.map +1 -0
  244. package/dist/semgrep-findings.js +293 -0
  245. package/dist/semgrep-findings.js.map +1 -0
  246. package/dist/server/embeddings.d.ts.map +1 -1
  247. package/dist/server/embeddings.js +4 -0
  248. package/dist/server/embeddings.js.map +1 -1
  249. package/dist/server/sqlite-store.d.ts.map +1 -1
  250. package/dist/server/sqlite-store.js +14 -2
  251. package/dist/server/sqlite-store.js.map +1 -1
  252. package/dist/severity-review.d.ts +3 -0
  253. package/dist/severity-review.d.ts.map +1 -1
  254. package/dist/severity-review.js +19 -0
  255. package/dist/severity-review.js.map +1 -1
  256. package/dist/severity-store.js +11 -3
  257. package/dist/severity-store.js.map +1 -1
  258. package/dist/snyk-findings.d.ts +9 -0
  259. package/dist/snyk-findings.d.ts.map +1 -0
  260. package/dist/snyk-findings.js +349 -0
  261. package/dist/snyk-findings.js.map +1 -0
  262. package/dist/targets.d.ts +2 -2
  263. package/dist/targets.d.ts.map +1 -1
  264. package/dist/targets.js +12 -2
  265. package/dist/targets.js.map +1 -1
  266. package/dist/timestamps.d.ts +3 -0
  267. package/dist/timestamps.d.ts.map +1 -0
  268. package/dist/timestamps.js +14 -0
  269. package/dist/timestamps.js.map +1 -0
  270. package/dist/version.d.ts +1 -1
  271. package/dist/version.d.ts.map +1 -1
  272. package/dist/version.js +13 -2
  273. package/dist/version.js.map +1 -1
  274. package/dist/wiz-csv.d.ts +8 -0
  275. package/dist/wiz-csv.d.ts.map +1 -0
  276. package/dist/wiz-csv.js +116 -0
  277. package/dist/wiz-csv.js.map +1 -0
  278. package/dist/wiz-findings.d.ts +4 -0
  279. package/dist/wiz-findings.d.ts.map +1 -0
  280. package/dist/wiz-findings.js +460 -0
  281. package/dist/wiz-findings.js.map +1 -0
  282. package/dist/workbench-arguments.d.ts.map +1 -1
  283. package/dist/workbench-arguments.js +9 -3
  284. package/dist/workbench-arguments.js.map +1 -1
  285. package/dist/worker-progress.d.ts +11 -1
  286. package/dist/worker-progress.d.ts.map +1 -1
  287. package/dist/worker-progress.js +11 -1
  288. package/dist/worker-progress.js.map +1 -1
  289. package/docs/classify-severity-records.md +28 -10
  290. package/docs/cli.md +788 -46
  291. package/docs/findings-service.md +7 -2
  292. package/docs/hosted-remediation.md +134 -0
  293. package/docs/hosted-scans.md +20 -3
  294. package/package.json +9 -6
  295. package/schemas/external-findings.schema.json +1421 -0
  296. package/schemas/project-config.schema.json +4 -0
  297. package/dist/deep-progress.d.ts.map +0 -1
  298. package/dist/deep-progress.js +0 -92
  299. package/dist/deep-progress.js.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"findings-import.js","sourceRoot":"","sources":["../src/findings-import.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRecord } from \"./record.js\";\nimport {\n deriveFindingIdentity,\n hasRequiredFindingText,\n sha256Text as sha256,\n} from \"./contract.js\";\nimport { readFile } from \"node:fs/promises\";\nimport { isAbsolute, join, posix } from \"node:path\";\nimport Ajv2020 from \"ajv/dist/2020.js\";\nimport { z } from \"zod\";\nimport Papa from \"papaparse\";\nimport { CodexSecurityError, errorMessage } 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\n// Match the Python exporter's str.lstrip(), including its extra C0 separators.\nconst EXPORTED_CSV_ESCAPE =\n /^'(?:['\\t\\r\\n]|[\\p{White_Space}\\u001c-\\u001f]*[=+\\-@=+-@])/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(csvRowFinding);\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(\n `Findings JSON could not be parsed. ${errorMessage(error)}`,\n { cause: error },\n );\n }\n if (!isRecord(payload)) {\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 // 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 ...deriveFindingIdentity(scanId, targetId, `import.${format}`, {\n anchor: finding.occurrenceId,\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\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 (occurrenceIds.has(row.occurrence_id)) {\n throw csvRowError(rowNumber, \"has a duplicate occurrence_id\");\n }\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): Finding {\n const ruleId = \"import.csv\";\n const anchor = row.occurrence_id;\n const fingerprint = `codex-security/v1:sha256:${sha256(\n [\"codex-security/v1\", CSV_TARGET_ID, ruleId, anchor, \"\"].join(\"\\0\"),\n )}`;\n return {\n findingId: row.finding_id,\n occurrenceId: row.occurrence_id,\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(hasRequiredFindingText, {\n error: `requires ${column}`,\n });\n}\n\nfunction validCsvLine(value: string): boolean {\n if (!/^[1-9]\\d*$/u.test(value)) return false;\n return Number.isSafeInteger(Number(value));\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"]}
1
+ {"version":3,"file":"findings-import.js","sourceRoot":"","sources":["../src/findings-import.ts"],"names":[],"mappings":"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","sourcesContent":["import { isRecord } from \"./record.js\";\nimport {\n deriveFindingIdentity,\n hasRequiredFindingText,\n sha256Text as sha256,\n} from \"./contract.js\";\nimport { readFile } from \"node:fs/promises\";\nimport { isAbsolute, join, posix } from \"node:path\";\nimport Ajv2020 from \"ajv/dist/2020.js\";\nimport { z } from \"zod\";\nimport Papa from \"papaparse\";\nimport { CodexSecurityError, errorMessage } 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\n// Match the Python exporter's str.lstrip(), including its extra C0 separators.\nconst EXPORTED_CSV_ESCAPE =\n /^'(?:['\\t\\r\\n]|[\\p{White_Space}\\u001c-\\u001f]*[=+\\-@=+-@])/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 ||\n (value.trim() === \"\" && !value.includes(\"\\uFEFF\"))\n ? undefined\n : 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) =>\n value.trim() === \"\" && !value.includes(\"\\uFEFF\") ? undefined : value,\n ),\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(csvRowFinding);\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(\n `Findings JSON could not be parsed. ${errorMessage(error)}`,\n { cause: error },\n );\n }\n if (!isRecord(payload)) {\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 // 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 ...deriveFindingIdentity(scanId, targetId, `import.${format}`, {\n anchor: finding.occurrenceId,\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\nfunction exportedCsvNewline(source: string): \"\\r\\n\" | \"\\r\" | \"\\n\" | undefined {\n const start = source.startsWith(\"\\uFEFF\") ? 1 : 0;\n for (const columns of [CSV_COLUMNS, REQUIRED_CSV_COLUMNS]) {\n const header = columns.join(\",\");\n if (!source.startsWith(header, start)) continue;\n const end = start + header.length;\n for (const newline of [\"\\r\\n\", \"\\r\", \"\\n\"] as const) {\n // Require the exporter's first cell: skipped empty records can make\n // other mixed-ending CSV valid under Papa's existing auto-detection.\n if (source.startsWith(`${newline}occ_`, end)) return newline;\n }\n }\n return undefined;\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 newline: exportedCsvNewline(source),\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\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 (occurrenceIds.has(row.occurrence_id)) {\n throw csvRowError(rowNumber, \"has a duplicate occurrence_id\");\n }\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): Finding {\n const ruleId = \"import.csv\";\n const anchor = row.occurrence_id;\n const fingerprint = `codex-security/v1:sha256:${sha256(\n [\"codex-security/v1\", CSV_TARGET_ID, ruleId, anchor, \"\"].join(\"\\0\"),\n )}`;\n return {\n findingId: row.finding_id,\n occurrenceId: row.occurrence_id,\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(hasRequiredFindingText, {\n error: `requires ${column}`,\n });\n}\n\nfunction validCsvLine(value: string): boolean {\n if (!/^[1-9]\\d*$/u.test(value)) return false;\n return Number.isSafeInteger(Number(value));\n}\n\nfunction safeFindingPath(value: string): boolean {\n if (\n value.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"]}
@@ -0,0 +1,386 @@
1
+ import type { Octokit } from "@octokit/core";
2
+ export declare const GITHUB_ADVISORY_STATES: readonly ["published", "draft", "triage", "closed"];
3
+ export interface GitHubAdvisoryImportOptions {
4
+ /** Source repository, or the selected target for explicit global advisory IDs. */
5
+ repository: string;
6
+ /** Exact GHSA IDs. Required for the global advisory API. */
7
+ advisoryIds?: readonly string[];
8
+ /** Repository advisories by default; global never enumerates the database. */
9
+ source?: "repository" | "global";
10
+ /** Repository list state (default: published). Exact IDs ignore state. */
11
+ state?: (typeof GITHUB_ADVISORY_STATES)[number];
12
+ /** Defaults to GH_HOST or github.com. */
13
+ githubHost?: string;
14
+ /** Omit to use the authenticated GitHub CLI. */
15
+ githubToken?: string;
16
+ signal?: AbortSignal;
17
+ }
18
+ type RepositoryAdvisory = Awaited<ReturnType<typeof fetchRepositoryAdvisory>>;
19
+ type GlobalAdvisory = Awaited<ReturnType<typeof fetchGlobalAdvisory>>;
20
+ export interface ImportedGitHubAdvisory {
21
+ source: "github-security-advisory";
22
+ selection: "repository" | "global";
23
+ repository: string;
24
+ githubHost: string;
25
+ ghsaId: string;
26
+ url: string;
27
+ /** Upstream disclosure, not proof that the selected repository is affected. */
28
+ advisory: RepositoryAdvisory | GlobalAdvisory;
29
+ }
30
+ interface GitHubAdvisoryImportDependencies {
31
+ environment?: NodeJS.ProcessEnv;
32
+ currentDirectory?: string;
33
+ createGitHub?: (host: string, signal?: AbortSignal) => Promise<Octokit>;
34
+ }
35
+ /** Read repository disclosures or explicitly selected public GHSA records. */
36
+ export declare function importGitHubAdvisories(options: GitHubAdvisoryImportOptions, dependencies?: GitHubAdvisoryImportDependencies): Promise<ImportedGitHubAdvisory[]>;
37
+ declare function fetchRepositoryAdvisory(github: Octokit, owner: string, repo: string, id: string, signal?: AbortSignal): Promise<{
38
+ ghsa_id: string;
39
+ cve_id: string | null;
40
+ url: string;
41
+ html_url: string;
42
+ summary: string;
43
+ description: string | null;
44
+ severity: "critical" | "high" | "medium" | "low" | null;
45
+ author: {
46
+ name?: string | null;
47
+ email?: string | null;
48
+ login: string;
49
+ id: number | bigint;
50
+ node_id: string;
51
+ avatar_url: string;
52
+ gravatar_id: string | null;
53
+ url: string;
54
+ html_url: string;
55
+ followers_url: string;
56
+ following_url: string;
57
+ gists_url: string;
58
+ starred_url: string;
59
+ subscriptions_url: string;
60
+ organizations_url: string;
61
+ repos_url: string;
62
+ events_url: string;
63
+ received_events_url: string;
64
+ type: string;
65
+ site_admin: boolean;
66
+ starred_at?: string;
67
+ user_view_type?: string;
68
+ } | null;
69
+ publisher: {
70
+ name?: string | null;
71
+ email?: string | null;
72
+ login: string;
73
+ id: number | bigint;
74
+ node_id: string;
75
+ avatar_url: string;
76
+ gravatar_id: string | null;
77
+ url: string;
78
+ html_url: string;
79
+ followers_url: string;
80
+ following_url: string;
81
+ gists_url: string;
82
+ starred_url: string;
83
+ subscriptions_url: string;
84
+ organizations_url: string;
85
+ repos_url: string;
86
+ events_url: string;
87
+ received_events_url: string;
88
+ type: string;
89
+ site_admin: boolean;
90
+ starred_at?: string;
91
+ user_view_type?: string;
92
+ } | null;
93
+ identifiers: readonly {
94
+ type: "CVE" | "GHSA";
95
+ value: string;
96
+ }[];
97
+ state: "published" | "closed" | "withdrawn" | "draft" | "triage";
98
+ created_at: string | null;
99
+ updated_at: string | null;
100
+ published_at: string | null;
101
+ closed_at: string | null;
102
+ withdrawn_at: string | null;
103
+ submission: {
104
+ readonly accepted: boolean;
105
+ } | null;
106
+ vulnerabilities: {
107
+ package: {
108
+ ecosystem: "actions" | "composer" | "erlang" | "go" | "maven" | "npm" | "nuget" | "other" | "pip" | "pub" | "rubygems" | "rust" | "swift";
109
+ name: string | null;
110
+ } | null;
111
+ vulnerable_version_range: string | null;
112
+ patched_versions: string | null;
113
+ vulnerable_functions: string[] | null;
114
+ }[] | null;
115
+ cvss: {
116
+ vector_string: string | null;
117
+ score: number | null;
118
+ } | null;
119
+ cvss_severities?: {
120
+ cvss_v3?: {
121
+ vector_string: string | null;
122
+ score: number | null;
123
+ } | null;
124
+ cvss_v4?: {
125
+ vector_string: string | null;
126
+ score: number | null;
127
+ } | null;
128
+ } | null;
129
+ cwes: readonly {
130
+ cwe_id: string;
131
+ name: string;
132
+ }[] | null;
133
+ cwe_ids: string[] | null;
134
+ credits: {
135
+ login?: string;
136
+ type?: "analyst" | "coordinator" | "finder" | "other" | "remediation_developer" | "remediation_reviewer" | "remediation_verifier" | "reporter" | "sponsor" | "tool";
137
+ }[] | null;
138
+ credits_detailed: readonly {
139
+ user: {
140
+ name?: string | null;
141
+ email?: string | null;
142
+ login: string;
143
+ id: number | bigint;
144
+ node_id: string;
145
+ avatar_url: string;
146
+ gravatar_id: string | null;
147
+ url: string;
148
+ html_url: string;
149
+ followers_url: string;
150
+ following_url: string;
151
+ gists_url: string;
152
+ starred_url: string;
153
+ subscriptions_url: string;
154
+ organizations_url: string;
155
+ repos_url: string;
156
+ events_url: string;
157
+ received_events_url: string;
158
+ type: string;
159
+ site_admin: boolean;
160
+ starred_at?: string;
161
+ user_view_type?: string;
162
+ };
163
+ type: "analyst" | "coordinator" | "finder" | "other" | "remediation_developer" | "remediation_reviewer" | "remediation_verifier" | "reporter" | "sponsor" | "tool";
164
+ state: "accepted" | "declined" | "pending";
165
+ }[] | null;
166
+ collaborating_users: {
167
+ name?: string | null;
168
+ email?: string | null;
169
+ login: string;
170
+ id: number | bigint;
171
+ node_id: string;
172
+ avatar_url: string;
173
+ gravatar_id: string | null;
174
+ url: string;
175
+ html_url: string;
176
+ followers_url: string;
177
+ following_url: string;
178
+ gists_url: string;
179
+ starred_url: string;
180
+ subscriptions_url: string;
181
+ organizations_url: string;
182
+ repos_url: string;
183
+ events_url: string;
184
+ received_events_url: string;
185
+ type: string;
186
+ site_admin: boolean;
187
+ starred_at?: string;
188
+ user_view_type?: string;
189
+ }[] | null;
190
+ collaborating_teams: {
191
+ id: number;
192
+ node_id: string;
193
+ name: string;
194
+ slug: string;
195
+ description: string | null;
196
+ privacy?: string;
197
+ notification_setting?: string;
198
+ permission: string;
199
+ permissions?: {
200
+ pull: boolean;
201
+ triage: boolean;
202
+ push: boolean;
203
+ maintain: boolean;
204
+ admin: boolean;
205
+ };
206
+ url: string;
207
+ html_url: string;
208
+ members_url: string;
209
+ repositories_url: string;
210
+ type: "enterprise" | "organization";
211
+ access_source?: "direct" | "organization" | "enterprise";
212
+ organization_id?: number;
213
+ enterprise_id?: number;
214
+ parent: {
215
+ id: number;
216
+ node_id: string;
217
+ url: string;
218
+ members_url: string;
219
+ name: string;
220
+ description: string | null;
221
+ permission: string;
222
+ privacy?: string;
223
+ notification_setting?: string;
224
+ html_url: string;
225
+ repositories_url: string;
226
+ slug: string;
227
+ ldap_dn?: string;
228
+ type: "enterprise" | "organization";
229
+ organization_id?: number;
230
+ enterprise_id?: number;
231
+ } | null;
232
+ }[] | null;
233
+ private_fork: {
234
+ id: number | bigint;
235
+ node_id: string;
236
+ name: string;
237
+ full_name: string;
238
+ owner: {
239
+ name?: string | null;
240
+ email?: string | null;
241
+ login: string;
242
+ id: number | bigint;
243
+ node_id: string;
244
+ avatar_url: string;
245
+ gravatar_id: string | null;
246
+ url: string;
247
+ html_url: string;
248
+ followers_url: string;
249
+ following_url: string;
250
+ gists_url: string;
251
+ starred_url: string;
252
+ subscriptions_url: string;
253
+ organizations_url: string;
254
+ repos_url: string;
255
+ events_url: string;
256
+ received_events_url: string;
257
+ type: string;
258
+ site_admin: boolean;
259
+ starred_at?: string;
260
+ user_view_type?: string;
261
+ };
262
+ private: boolean;
263
+ html_url: string;
264
+ description: string | null;
265
+ fork: boolean;
266
+ url: string;
267
+ archive_url: string;
268
+ assignees_url: string;
269
+ blobs_url: string;
270
+ branches_url: string;
271
+ collaborators_url: string;
272
+ comments_url: string;
273
+ commits_url: string;
274
+ compare_url: string;
275
+ contents_url: string;
276
+ contributors_url: string;
277
+ deployments_url: string;
278
+ downloads_url: string;
279
+ events_url: string;
280
+ forks_url: string;
281
+ git_commits_url: string;
282
+ git_refs_url: string;
283
+ git_tags_url: string;
284
+ issue_comment_url: string;
285
+ issue_events_url: string;
286
+ issues_url: string;
287
+ keys_url: string;
288
+ labels_url: string;
289
+ languages_url: string;
290
+ merges_url: string;
291
+ milestones_url: string;
292
+ notifications_url: string;
293
+ pulls_url: string;
294
+ releases_url: string;
295
+ stargazers_url: string;
296
+ statuses_url: string;
297
+ subscribers_url: string;
298
+ subscription_url: string;
299
+ tags_url: string;
300
+ teams_url: string;
301
+ trees_url: string;
302
+ hooks_url: string;
303
+ } | null;
304
+ }>;
305
+ declare function fetchGlobalAdvisory(github: Octokit, id: string, signal?: AbortSignal): Promise<{
306
+ ghsa_id: string;
307
+ cve_id: string | null;
308
+ url: string;
309
+ html_url: string;
310
+ repository_advisory_url: string | null;
311
+ summary: string;
312
+ description: string | null;
313
+ type: "reviewed" | "unreviewed" | "malware";
314
+ severity: "critical" | "high" | "medium" | "low" | "unknown";
315
+ source_code_location: string | null;
316
+ identifiers: readonly {
317
+ type: "CVE" | "GHSA";
318
+ value: string;
319
+ }[] | null;
320
+ references: string[] | null;
321
+ published_at: string;
322
+ updated_at: string;
323
+ github_reviewed_at: string | null;
324
+ nvd_published_at: string | null;
325
+ withdrawn_at: string | null;
326
+ vulnerabilities: {
327
+ package: {
328
+ ecosystem: "actions" | "composer" | "erlang" | "go" | "maven" | "npm" | "nuget" | "other" | "pip" | "pub" | "rubygems" | "rust" | "swift";
329
+ name: string | null;
330
+ } | null;
331
+ vulnerable_version_range: string | null;
332
+ first_patched_version: string | null;
333
+ vulnerable_functions: readonly string[] | null;
334
+ }[] | null;
335
+ cvss: {
336
+ vector_string: string | null;
337
+ score: number | null;
338
+ } | null;
339
+ cvss_severities?: {
340
+ cvss_v3?: {
341
+ vector_string: string | null;
342
+ score: number | null;
343
+ } | null;
344
+ cvss_v4?: {
345
+ vector_string: string | null;
346
+ score: number | null;
347
+ } | null;
348
+ } | null;
349
+ epss?: {
350
+ readonly percentage?: number;
351
+ readonly percentile?: number;
352
+ } | null;
353
+ cwes: {
354
+ cwe_id: string;
355
+ name: string;
356
+ }[] | null;
357
+ credits: readonly {
358
+ user: {
359
+ name?: string | null;
360
+ email?: string | null;
361
+ login: string;
362
+ id: number | bigint;
363
+ node_id: string;
364
+ avatar_url: string;
365
+ gravatar_id: string | null;
366
+ url: string;
367
+ html_url: string;
368
+ followers_url: string;
369
+ following_url: string;
370
+ gists_url: string;
371
+ starred_url: string;
372
+ subscriptions_url: string;
373
+ organizations_url: string;
374
+ repos_url: string;
375
+ events_url: string;
376
+ received_events_url: string;
377
+ type: string;
378
+ site_admin: boolean;
379
+ starred_at?: string;
380
+ user_view_type?: string;
381
+ };
382
+ type: "analyst" | "coordinator" | "finder" | "other" | "remediation_developer" | "remediation_reviewer" | "remediation_verifier" | "reporter" | "sponsor" | "tool";
383
+ }[] | null;
384
+ }>;
385
+ export {};
386
+ //# sourceMappingURL=github-advisories.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"github-advisories.d.ts","sourceRoot":"","sources":["../src/github-advisories.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAI7C,eAAO,MAAM,sBAAsB,YACjC,WAAW,EACX,OAAO,EACP,QAAQ,EACR,QAAQ,CACA,CAAC;AAEX,MAAM,WAAW,2BAA2B;IAC1C,kFAAkF;IAClF,UAAU,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,WAAW,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAChC,8EAA8E;IAC9E,MAAM,CAAC,EAAE,YAAY,GAAG,QAAQ,CAAC;IACjC,0EAA0E;IAC1E,KAAK,CAAC,EAAE,CAAC,OAAO,sBAAsB,CAAC,CAAC,MAAM,CAAC,CAAC;IAChD,yCAAyC;IACzC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,KAAK,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC;AAC9E,KAAK,cAAc,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC;AAEtE,MAAM,WAAW,sBAAsB;IACrC,MAAM,EAAE,0BAA0B,CAAC;IACnC,SAAS,EAAE,YAAY,GAAG,QAAQ,CAAC;IACnC,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,+EAA+E;IAC/E,QAAQ,EAAE,kBAAkB,GAAG,cAAc,CAAC;CAC/C;AAED,UAAU,gCAAgC;IACxC,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzE;AAED,8EAA8E;AAC9E,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,2BAA2B,EACpC,YAAY,GAAE,gCAAqC,GAClD,OAAO,CAAC,sBAAsB,EAAE,CAAC,CAuInC;AAED,iBAAe,uBAAuB,CACpC,MAAM,EAAE,OAAO,EACf,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAYrB;AAED,iBAAe,mBAAmB,CAChC,MAAM,EAAE,OAAO,EACf,EAAE,EAAE,MAAM,EACV,MAAM,CAAC,EAAE,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAOrB"}
@@ -0,0 +1,131 @@
1
+ import { CodexSecurityError, errorMessage } from "./errors.js";
2
+ import { createAuthenticatedGitHub } from "./github.js";
3
+ export const GITHUB_ADVISORY_STATES = [
4
+ "published",
5
+ "draft",
6
+ "triage",
7
+ "closed",
8
+ ];
9
+ /** Read repository disclosures or explicitly selected public GHSA records. */
10
+ export async function importGitHubAdvisories(options, dependencies = {}) {
11
+ options.signal?.throwIfAborted();
12
+ const repository = options.repository.trim();
13
+ const parts = /^([a-z0-9_.-]+)\/([a-z0-9_.-]+)$/iu.exec(repository);
14
+ if (!parts || parts.slice(1).some((part) => /^\.{1,2}$/u.test(part)))
15
+ throw new CodexSecurityError("GitHub repository must be OWNER/REPO.");
16
+ const owner = parts[1];
17
+ const repo = parts[2];
18
+ const ids = [
19
+ ...new Set((options.advisoryIds ?? []).map((id) => id
20
+ .trim()
21
+ .toLowerCase()
22
+ .replace(/^ghsa-/u, "GHSA-"))),
23
+ ];
24
+ if (ids.some((id) => !/^GHSA-[a-z0-9]{4}-[a-z0-9]{4}-[a-z0-9]{4}$/u.test(id)))
25
+ throw new CodexSecurityError("GitHub advisory IDs must use GHSA-xxxx-xxxx-xxxx form.");
26
+ const source = options.source ?? "repository";
27
+ const state = options.state ?? "published";
28
+ if (source !== "repository" && source !== "global")
29
+ throw new CodexSecurityError("GitHub advisory source must be repository or global.");
30
+ if (!GITHUB_ADVISORY_STATES.includes(state))
31
+ throw new CodexSecurityError("GitHub advisory state is invalid.");
32
+ if (source === "global" && ids.length === 0)
33
+ throw new CodexSecurityError("Select explicit GHSA IDs for global advisories; database-wide import is not supported.");
34
+ if (ids.length > 0 && state !== "published")
35
+ throw new CodexSecurityError("--github-state only filters repository lists; omit it when selecting exact GHSA IDs.");
36
+ const environment = dependencies.environment ?? process.env;
37
+ const host = options.githubHost?.trim() ??
38
+ (environment["GH_HOST"]?.trim() || "github.com");
39
+ if (!host)
40
+ throw new CodexSecurityError("GitHub host must not be empty.");
41
+ try {
42
+ const github = dependencies.createGitHub
43
+ ? await dependencies.createGitHub(host, options.signal)
44
+ : await createAuthenticatedGitHub(host, {
45
+ token: options.githubToken,
46
+ environment,
47
+ currentDirectory: dependencies.currentDirectory,
48
+ signal: options.signal,
49
+ });
50
+ const advisories = [];
51
+ if (ids.length > 0) {
52
+ for (const id of ids) {
53
+ options.signal?.throwIfAborted();
54
+ advisories.push(source === "global"
55
+ ? await fetchGlobalAdvisory(github, id, options.signal)
56
+ : await fetchRepositoryAdvisory(github, owner, repo, id, options.signal));
57
+ }
58
+ }
59
+ else {
60
+ let after;
61
+ const cursors = new Set();
62
+ do {
63
+ options.signal?.throwIfAborted();
64
+ const response = await github.request("GET /repos/{owner}/{repo}/security-advisories", {
65
+ owner,
66
+ repo,
67
+ state,
68
+ per_page: 100,
69
+ after,
70
+ request: { signal: options.signal, redirect: "error" },
71
+ });
72
+ advisories.push(...response.data);
73
+ const next = response.headers.link
74
+ ?.split(",")
75
+ .find((link) => /;\s*rel="next"/u.test(link));
76
+ const nextUrl = next?.match(/<([^>]+)>/u)?.[1];
77
+ // Keep requests on the authenticated route; only carry over the cursor.
78
+ after = nextUrl
79
+ ? (new URL(nextUrl).searchParams.get("after") ?? undefined)
80
+ : undefined;
81
+ if (next && (!after || cursors.has(after)))
82
+ throw new CodexSecurityError("GitHub returned invalid advisory pagination.");
83
+ if (after)
84
+ cursors.add(after);
85
+ } while (after !== undefined);
86
+ }
87
+ return advisories.map((advisory) => ({
88
+ source: "github-security-advisory",
89
+ selection: source,
90
+ repository,
91
+ githubHost: host,
92
+ ghsaId: advisory.ghsa_id,
93
+ url: advisory.html_url,
94
+ advisory,
95
+ }));
96
+ }
97
+ catch (error) {
98
+ options.signal?.throwIfAborted();
99
+ if (error instanceof CodexSecurityError)
100
+ throw error;
101
+ const status = typeof error === "object" && error !== null && "status" in error
102
+ ? error.status
103
+ : undefined;
104
+ if (status === 401)
105
+ throw new CodexSecurityError("GitHub authentication failed.");
106
+ if (status === 403)
107
+ throw new CodexSecurityError("GitHub denied security advisory access. Check repository advisory permissions and API rate limits.");
108
+ if (status === 404)
109
+ throw new CodexSecurityError("GitHub repository or security advisory was not found or is not accessible.");
110
+ if (status === 429)
111
+ throw new CodexSecurityError("GitHub request was rate limited. Wait and retry.");
112
+ throw new CodexSecurityError(`GitHub security advisory request failed${typeof status === "number" ? ` (HTTP ${status})` : ""}: ${errorMessage(error)}`);
113
+ }
114
+ }
115
+ async function fetchRepositoryAdvisory(github, owner, repo, id, signal) {
116
+ const response = await github.request("GET /repos/{owner}/{repo}/security-advisories/{ghsa_id}", {
117
+ owner,
118
+ repo,
119
+ ghsa_id: id,
120
+ request: { signal, redirect: "error" },
121
+ });
122
+ return response.data;
123
+ }
124
+ async function fetchGlobalAdvisory(github, id, signal) {
125
+ const response = await github.request("GET /advisories/{ghsa_id}", {
126
+ ghsa_id: id,
127
+ request: { signal, redirect: "error" },
128
+ });
129
+ return response.data;
130
+ }
131
+ //# sourceMappingURL=github-advisories.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"github-advisories.js","sourceRoot":"","sources":["../src/github-advisories.ts"],"names":[],"mappings":"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","sourcesContent":["import type { Octokit } from \"@octokit/core\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport { createAuthenticatedGitHub } from \"./github.js\";\n\nexport const GITHUB_ADVISORY_STATES = [\n \"published\",\n \"draft\",\n \"triage\",\n \"closed\",\n] as const;\n\nexport interface GitHubAdvisoryImportOptions {\n /** Source repository, or the selected target for explicit global advisory IDs. */\n repository: string;\n /** Exact GHSA IDs. Required for the global advisory API. */\n advisoryIds?: readonly string[];\n /** Repository advisories by default; global never enumerates the database. */\n source?: \"repository\" | \"global\";\n /** Repository list state (default: published). Exact IDs ignore state. */\n state?: (typeof GITHUB_ADVISORY_STATES)[number];\n /** Defaults to GH_HOST or github.com. */\n githubHost?: string;\n /** Omit to use the authenticated GitHub CLI. */\n githubToken?: string;\n signal?: AbortSignal;\n}\n\ntype RepositoryAdvisory = Awaited<ReturnType<typeof fetchRepositoryAdvisory>>;\ntype GlobalAdvisory = Awaited<ReturnType<typeof fetchGlobalAdvisory>>;\n\nexport interface ImportedGitHubAdvisory {\n source: \"github-security-advisory\";\n selection: \"repository\" | \"global\";\n repository: string;\n githubHost: string;\n ghsaId: string;\n url: string;\n /** Upstream disclosure, not proof that the selected repository is affected. */\n advisory: RepositoryAdvisory | GlobalAdvisory;\n}\n\ninterface GitHubAdvisoryImportDependencies {\n environment?: NodeJS.ProcessEnv;\n currentDirectory?: string;\n createGitHub?: (host: string, signal?: AbortSignal) => Promise<Octokit>;\n}\n\n/** Read repository disclosures or explicitly selected public GHSA records. */\nexport async function importGitHubAdvisories(\n options: GitHubAdvisoryImportOptions,\n dependencies: GitHubAdvisoryImportDependencies = {},\n): Promise<ImportedGitHubAdvisory[]> {\n options.signal?.throwIfAborted();\n const repository = options.repository.trim();\n const parts = /^([a-z0-9_.-]+)\\/([a-z0-9_.-]+)$/iu.exec(repository);\n if (!parts || parts.slice(1).some((part) => /^\\.{1,2}$/u.test(part)))\n throw new CodexSecurityError(\"GitHub repository must be OWNER/REPO.\");\n const owner = parts[1]!;\n const repo = parts[2]!;\n const ids = [\n ...new Set(\n (options.advisoryIds ?? []).map((id) =>\n id\n .trim()\n .toLowerCase()\n .replace(/^ghsa-/u, \"GHSA-\"),\n ),\n ),\n ];\n if (ids.some((id) => !/^GHSA-[a-z0-9]{4}-[a-z0-9]{4}-[a-z0-9]{4}$/u.test(id)))\n throw new CodexSecurityError(\n \"GitHub advisory IDs must use GHSA-xxxx-xxxx-xxxx form.\",\n );\n const source = options.source ?? \"repository\";\n const state = options.state ?? \"published\";\n if (source !== \"repository\" && source !== \"global\")\n throw new CodexSecurityError(\n \"GitHub advisory source must be repository or global.\",\n );\n if (!GITHUB_ADVISORY_STATES.includes(state))\n throw new CodexSecurityError(\"GitHub advisory state is invalid.\");\n if (source === \"global\" && ids.length === 0)\n throw new CodexSecurityError(\n \"Select explicit GHSA IDs for global advisories; database-wide import is not supported.\",\n );\n if (ids.length > 0 && state !== \"published\")\n throw new CodexSecurityError(\n \"--github-state only filters repository lists; omit it when selecting exact GHSA IDs.\",\n );\n const environment = dependencies.environment ?? process.env;\n const host =\n options.githubHost?.trim() ??\n (environment[\"GH_HOST\"]?.trim() || \"github.com\");\n if (!host) throw new CodexSecurityError(\"GitHub host must not be empty.\");\n\n try {\n const github = dependencies.createGitHub\n ? await dependencies.createGitHub(host, options.signal)\n : await createAuthenticatedGitHub(host, {\n token: options.githubToken,\n environment,\n currentDirectory: dependencies.currentDirectory,\n signal: options.signal,\n });\n const advisories: (RepositoryAdvisory | GlobalAdvisory)[] = [];\n if (ids.length > 0) {\n for (const id of ids) {\n options.signal?.throwIfAborted();\n advisories.push(\n source === \"global\"\n ? await fetchGlobalAdvisory(github, id, options.signal)\n : await fetchRepositoryAdvisory(\n github,\n owner,\n repo,\n id,\n options.signal,\n ),\n );\n }\n } else {\n let after: string | undefined;\n const cursors = new Set<string>();\n do {\n options.signal?.throwIfAborted();\n const response = await github.request(\n \"GET /repos/{owner}/{repo}/security-advisories\",\n {\n owner,\n repo,\n state,\n per_page: 100,\n after,\n request: { signal: options.signal, redirect: \"error\" },\n },\n );\n advisories.push(...response.data);\n const next = response.headers.link\n ?.split(\",\")\n .find((link) => /;\\s*rel=\"next\"/u.test(link));\n const nextUrl = next?.match(/<([^>]+)>/u)?.[1];\n // Keep requests on the authenticated route; only carry over the cursor.\n after = nextUrl\n ? (new URL(nextUrl).searchParams.get(\"after\") ?? undefined)\n : undefined;\n if (next && (!after || cursors.has(after)))\n throw new CodexSecurityError(\n \"GitHub returned invalid advisory pagination.\",\n );\n if (after) cursors.add(after);\n } while (after !== undefined);\n }\n return advisories.map((advisory) => ({\n source: \"github-security-advisory\",\n selection: source,\n repository,\n githubHost: host,\n ghsaId: advisory.ghsa_id,\n url: advisory.html_url,\n advisory,\n }));\n } catch (error) {\n options.signal?.throwIfAborted();\n if (error instanceof CodexSecurityError) throw error;\n const status =\n typeof error === \"object\" && error !== null && \"status\" in error\n ? error.status\n : undefined;\n if (status === 401)\n throw new CodexSecurityError(\"GitHub authentication failed.\");\n if (status === 403)\n throw new CodexSecurityError(\n \"GitHub denied security advisory access. Check repository advisory permissions and API rate limits.\",\n );\n if (status === 404)\n throw new CodexSecurityError(\n \"GitHub repository or security advisory was not found or is not accessible.\",\n );\n if (status === 429)\n throw new CodexSecurityError(\n \"GitHub request was rate limited. Wait and retry.\",\n );\n throw new CodexSecurityError(\n `GitHub security advisory request failed${typeof status === \"number\" ? ` (HTTP ${status})` : \"\"}: ${errorMessage(error)}`,\n );\n }\n}\n\nasync function fetchRepositoryAdvisory(\n github: Octokit,\n owner: string,\n repo: string,\n id: string,\n signal?: AbortSignal,\n) {\n const response = await github.request(\n \"GET /repos/{owner}/{repo}/security-advisories/{ghsa_id}\",\n {\n owner,\n repo,\n ghsa_id: id,\n request: { signal, redirect: \"error\" },\n },\n );\n return response.data;\n}\n\nasync function fetchGlobalAdvisory(\n github: Octokit,\n id: string,\n signal?: AbortSignal,\n) {\n const response = await github.request(\"GET /advisories/{ghsa_id}\", {\n ghsa_id: id,\n request: { signal, redirect: \"error\" },\n });\n return response.data;\n}\n"]}