@openai/codex-security 0.6.0 → 0.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (243) hide show
  1. package/README.md +68 -37
  2. package/_bundled_plugin/.mcp.json +1 -0
  3. package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
  4. package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
  5. package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +1 -1
  6. package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
  7. package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
  8. package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
  9. package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
  10. package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
  11. package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
  12. package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
  13. package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
  14. package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
  15. package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
  16. package/_bundled_plugin/references/access-advisory.md +11 -0
  17. package/_bundled_plugin/references/core-scan.md +30 -77
  18. package/_bundled_plugin/references/final-report.md +45 -189
  19. package/_bundled_plugin/references/scan-contract.md +2 -0
  20. package/_bundled_plugin/references/scan-prologue.md +1 -1
  21. package/_bundled_plugin/references/scan-runtime.md +1 -5
  22. package/_bundled_plugin/references/threat-model.md +33 -41
  23. package/_bundled_plugin/schemas/coverage.schema.json +12 -1
  24. package/_bundled_plugin/schemas/scan-manifest.schema.json +1 -0
  25. package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +38 -1
  26. package/_bundled_plugin/scripts/deep_scan_config.py +39 -39
  27. package/_bundled_plugin/scripts/deep_scan_workbench.py +145 -85
  28. package/_bundled_plugin/scripts/finalize_scan_contract.py +189 -57
  29. package/_bundled_plugin/scripts/report_projection.py +44 -15
  30. package/_bundled_plugin/scripts/threat_model_projection.py +4 -2
  31. package/_bundled_plugin/scripts/windows_scan_local_files.py +43 -14
  32. package/_bundled_plugin/scripts/workbench/retained_coverage.py +3218 -0
  33. package/_bundled_plugin/scripts/workbench/retained_records.py +627 -0
  34. package/_bundled_plugin/scripts/workbench/saved_coverage.py +644 -1
  35. package/_bundled_plugin/scripts/workbench/saved_outputs.py +72 -0
  36. package/_bundled_plugin/scripts/workbench/saved_sources.py +712 -0
  37. package/_bundled_plugin/scripts/workbench_cli.py +3 -0
  38. package/_bundled_plugin/scripts/workbench_coverage_receipts.py +479 -0
  39. package/_bundled_plugin/scripts/workbench_db.py +51 -22
  40. package/_bundled_plugin/scripts/workbench_feedback.py +0 -1
  41. package/_bundled_plugin/scripts/workbench_finding_workflows.py +51 -9
  42. package/_bundled_plugin/scripts/workbench_native_indexes.py +56 -44
  43. package/_bundled_plugin/scripts/workbench_saved_results.py +641 -2387
  44. package/_bundled_plugin/scripts/workbench_scan_history.py +72 -7
  45. package/_bundled_plugin/scripts/workbench_schema.py +1 -1
  46. package/_bundled_plugin/scripts/workbench_source_scopes.py +4 -1
  47. package/_bundled_plugin/scripts/workbench_target.py +142 -17
  48. package/_bundled_plugin/scripts/workbench_validation.py +9 -2
  49. package/_bundled_plugin/shared/workbench-history-repairs.json +21 -0
  50. package/_bundled_plugin/shared/workbench-migrations.json +28 -0
  51. package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +3 -14
  52. package/_bundled_plugin/skills/assess-patch-risk/references/windows-validation.md +14 -0
  53. package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +38 -103
  54. package/_bundled_plugin/skills/attack-path-analysis/references/attack-path-facts.md +11 -73
  55. package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +57 -116
  56. package/_bundled_plugin/skills/deep-security-scan/SKILL.md +28 -51
  57. package/_bundled_plugin/skills/define-security-policy/SKILL.md +9 -9
  58. package/_bundled_plugin/skills/finding-discovery/SKILL.md +26 -140
  59. package/_bundled_plugin/skills/fix-finding/SKILL.md +9 -28
  60. package/_bundled_plugin/skills/propose-security-hardening/SKILL.md +28 -218
  61. package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +29 -424
  62. package/_bundled_plugin/skills/publish-findings/SKILL.md +28 -24
  63. package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +64 -0
  64. package/_bundled_plugin/skills/security-diff-scan/SKILL.md +12 -12
  65. package/_bundled_plugin/skills/security-scan/SKILL.md +28 -16
  66. package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +11 -17
  67. package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +52 -69
  68. package/_bundled_plugin/skills/threat-model/SKILL.md +16 -9
  69. package/_bundled_plugin/skills/triage-finding/SKILL.md +5 -15
  70. package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -6
  71. package/_bundled_plugin/skills/validation/SKILL.md +42 -104
  72. package/_bundled_plugin/skills/validation/references/validation-guidance.md +21 -106
  73. package/_bundled_plugin/skills/verify-fix/SKILL.md +4 -2
  74. package/_bundled_plugin/skills/vulnerability-writeup/SKILL.md +21 -159
  75. package/_bundled_plugin/skills/vulnerability-writeup/references/report-format.md +18 -60
  76. package/dist/api.d.ts +5 -3
  77. package/dist/api.d.ts.map +1 -1
  78. package/dist/api.js +341 -37
  79. package/dist/api.js.map +1 -1
  80. package/dist/auth.d.ts.map +1 -1
  81. package/dist/auth.js +4 -1
  82. package/dist/auth.js.map +1 -1
  83. package/dist/cli.d.ts +2 -2
  84. package/dist/cli.d.ts.map +1 -1
  85. package/dist/cli.js +674 -419
  86. package/dist/cli.js.map +1 -1
  87. package/dist/component-scan.d.ts +8 -2
  88. package/dist/component-scan.d.ts.map +1 -1
  89. package/dist/component-scan.js +2 -0
  90. package/dist/component-scan.js.map +1 -1
  91. package/dist/contract.d.ts +2 -0
  92. package/dist/contract.d.ts.map +1 -1
  93. package/dist/contract.js +67 -33
  94. package/dist/contract.js.map +1 -1
  95. package/dist/cost.d.ts +18 -0
  96. package/dist/cost.d.ts.map +1 -1
  97. package/dist/cost.js +107 -12
  98. package/dist/cost.js.map +1 -1
  99. package/dist/coverage-presentation.d.ts +6 -0
  100. package/dist/coverage-presentation.d.ts.map +1 -0
  101. package/dist/coverage-presentation.js +34 -0
  102. package/dist/coverage-presentation.js.map +1 -0
  103. package/dist/custom-validation-prompt.js +3 -3
  104. package/dist/custom-validation-prompt.js.map +1 -1
  105. package/dist/custom-validation.d.ts.map +1 -1
  106. package/dist/custom-validation.js +30 -4
  107. package/dist/custom-validation.js.map +1 -1
  108. package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
  109. package/dist/deduplication/checkpointed-review.js +3 -1
  110. package/dist/deduplication/checkpointed-review.js.map +1 -1
  111. package/dist/deduplication/scan.d.ts.map +1 -1
  112. package/dist/deduplication/scan.js +7 -5
  113. package/dist/deduplication/scan.js.map +1 -1
  114. package/dist/endor-findings.d.ts +4 -3
  115. package/dist/endor-findings.d.ts.map +1 -1
  116. package/dist/endor-findings.js +16 -11
  117. package/dist/endor-findings.js.map +1 -1
  118. package/dist/external-findings-import.d.ts.map +1 -1
  119. package/dist/external-findings-import.js +13 -5
  120. package/dist/external-findings-import.js.map +1 -1
  121. package/dist/external-findings-local.d.ts.map +1 -1
  122. package/dist/external-findings-local.js +8 -1
  123. package/dist/external-findings-local.js.map +1 -1
  124. package/dist/external-findings-publish.d.ts +1 -1
  125. package/dist/external-findings-publish.d.ts.map +1 -1
  126. package/dist/external-findings-publish.js +11 -3
  127. package/dist/external-findings-publish.js.map +1 -1
  128. package/dist/external-findings-read.d.ts +11 -1
  129. package/dist/external-findings-read.d.ts.map +1 -1
  130. package/dist/external-findings-read.js +15 -6
  131. package/dist/external-findings-read.js.map +1 -1
  132. package/dist/external-import-contract.d.ts +3 -1
  133. package/dist/external-import-contract.d.ts.map +1 -1
  134. package/dist/external-import-contract.js +33 -25
  135. package/dist/external-import-contract.js.map +1 -1
  136. package/dist/external-imports-feature.d.ts +6 -0
  137. package/dist/external-imports-feature.d.ts.map +1 -0
  138. package/dist/external-imports-feature.js +51 -0
  139. package/dist/external-imports-feature.js.map +1 -0
  140. package/dist/finding-workflow.d.ts +22 -5
  141. package/dist/finding-workflow.d.ts.map +1 -1
  142. package/dist/finding-workflow.js +21 -9
  143. package/dist/finding-workflow.js.map +1 -1
  144. package/dist/github-advisories.d.ts.map +1 -1
  145. package/dist/github-advisories.js +3 -1
  146. package/dist/github-advisories.js.map +1 -1
  147. package/dist/github-findings.d.ts +4 -3
  148. package/dist/github-findings.d.ts.map +1 -1
  149. package/dist/github-findings.js +16 -14
  150. package/dist/github-findings.js.map +1 -1
  151. package/dist/hosted-remediation.d.ts.map +1 -1
  152. package/dist/hosted-remediation.js +19 -2
  153. package/dist/hosted-remediation.js.map +1 -1
  154. package/dist/hosted-scan.d.ts +1 -1
  155. package/dist/hosted-scan.d.ts.map +1 -1
  156. package/dist/hosted-scan.js +0 -5
  157. package/dist/hosted-scan.js.map +1 -1
  158. package/dist/import-scan.js +1 -1
  159. package/dist/import-scan.js.map +1 -1
  160. package/dist/index.d.ts +3 -3
  161. package/dist/index.d.ts.map +1 -1
  162. package/dist/index.js +1 -1
  163. package/dist/index.js.map +1 -1
  164. package/dist/knowledge-base.d.ts +1 -0
  165. package/dist/knowledge-base.d.ts.map +1 -1
  166. package/dist/knowledge-base.js +17 -8
  167. package/dist/knowledge-base.js.map +1 -1
  168. package/dist/models.d.ts +1 -0
  169. package/dist/models.d.ts.map +1 -1
  170. package/dist/models.js.map +1 -1
  171. package/dist/owner-evidence.d.ts +2 -0
  172. package/dist/owner-evidence.d.ts.map +1 -1
  173. package/dist/owner-evidence.js +2 -1
  174. package/dist/owner-evidence.js.map +1 -1
  175. package/dist/publish.d.ts +2 -0
  176. package/dist/publish.d.ts.map +1 -1
  177. package/dist/publish.js +1 -1
  178. package/dist/publish.js.map +1 -1
  179. package/dist/remediation.d.ts +1 -25
  180. package/dist/remediation.d.ts.map +1 -1
  181. package/dist/remediation.js +3 -24
  182. package/dist/remediation.js.map +1 -1
  183. package/dist/runtime.d.ts.map +1 -1
  184. package/dist/runtime.js +7 -7
  185. package/dist/runtime.js.map +1 -1
  186. package/dist/scan-dashboard.d.ts +5 -3
  187. package/dist/scan-dashboard.d.ts.map +1 -1
  188. package/dist/scan-dashboard.js +79 -26
  189. package/dist/scan-dashboard.js.map +1 -1
  190. package/dist/scan-history-renderer.d.ts.map +1 -1
  191. package/dist/scan-history-renderer.js +8 -2
  192. package/dist/scan-history-renderer.js.map +1 -1
  193. package/dist/scan-owner-suggestions.d.ts +1 -1
  194. package/dist/scan-owner-suggestions.d.ts.map +1 -1
  195. package/dist/scan-owner-suggestions.js +4 -4
  196. package/dist/scan-owner-suggestions.js.map +1 -1
  197. package/dist/scan-usage-display.d.ts +8 -0
  198. package/dist/scan-usage-display.d.ts.map +1 -0
  199. package/dist/scan-usage-display.js +46 -0
  200. package/dist/scan-usage-display.js.map +1 -0
  201. package/dist/scanner-import.d.ts +1 -1
  202. package/dist/scanner-import.d.ts.map +1 -1
  203. package/dist/scanner-import.js +7 -3
  204. package/dist/scanner-import.js.map +1 -1
  205. package/dist/security-policy.d.ts.map +1 -1
  206. package/dist/security-policy.js +1 -20
  207. package/dist/security-policy.js.map +1 -1
  208. package/dist/semgrep-findings.d.ts +4 -3
  209. package/dist/semgrep-findings.d.ts.map +1 -1
  210. package/dist/semgrep-findings.js +9 -9
  211. package/dist/semgrep-findings.js.map +1 -1
  212. package/dist/skill-authentication.d.ts +18 -0
  213. package/dist/skill-authentication.d.ts.map +1 -0
  214. package/dist/skill-authentication.js +82 -0
  215. package/dist/skill-authentication.js.map +1 -0
  216. package/dist/snyk-findings.d.ts +5 -4
  217. package/dist/snyk-findings.d.ts.map +1 -1
  218. package/dist/snyk-findings.js +18 -17
  219. package/dist/snyk-findings.js.map +1 -1
  220. package/dist/suggest-owners.d.ts +4 -1
  221. package/dist/suggest-owners.d.ts.map +1 -1
  222. package/dist/suggest-owners.js +53 -21
  223. package/dist/suggest-owners.js.map +1 -1
  224. package/dist/targets.d.ts.map +1 -1
  225. package/dist/targets.js +4 -1
  226. package/dist/targets.js.map +1 -1
  227. package/dist/wiz-csv.d.ts +2 -1
  228. package/dist/wiz-csv.d.ts.map +1 -1
  229. package/dist/wiz-csv.js +3 -3
  230. package/dist/wiz-csv.js.map +1 -1
  231. package/dist/wiz-findings.d.ts +2 -1
  232. package/dist/wiz-findings.d.ts.map +1 -1
  233. package/dist/wiz-findings.js +27 -23
  234. package/dist/wiz-findings.js.map +1 -1
  235. package/docs/classify-severity-records.md +3 -4
  236. package/docs/cli.md +155 -38
  237. package/docs/findings-service.md +119 -118
  238. package/docs/hosted-remediation.md +19 -17
  239. package/docs/hosted-scans.md +37 -11
  240. package/package.json +8 -8
  241. package/_bundled_plugin/scripts/generate_in_scope_files.py +0 -277
  242. package/_bundled_plugin/scripts/generate_rank_input.py +0 -350
  243. package/_bundled_plugin/scripts/rank_preview.py +0 -129
@@ -6,6 +6,7 @@ const ajv = new Ajv2020({
6
6
  validateFormats: false,
7
7
  useDefaults: true,
8
8
  });
9
+ const localSchema = JSON.parse(JSON.stringify(schema, (key, value) => key === "maxLength" || key === "maxItems" ? undefined : value));
9
10
  const STRING_BYTE_LIMITS = {
10
11
  description: 65536,
11
12
  snippet: 65536,
@@ -42,12 +43,12 @@ export function cloudRepositoryUrlKey(value) {
42
43
  // Cloud ImportModel applies these constraints to both requests and responses.
43
44
  // Its UTF-8 limits are not exported as JSON Schema character limits: even a
44
45
  // plain string field such as a receipt error message inherits the 512-byte bound.
45
- function validateModelStrings(input) {
46
+ function validateModelStrings(input, target) {
46
47
  if (input === null || typeof input !== "object")
47
48
  return;
48
49
  if (Array.isArray(input)) {
49
50
  for (const item of input)
50
- validateModelStrings(item);
51
+ validateModelStrings(item, target);
51
52
  return;
52
53
  }
53
54
  for (const [field, value] of Object.entries(input)) {
@@ -58,42 +59,44 @@ function validateModelStrings(input) {
58
59
  value.includes("\0"))
59
60
  throw new Error(`${field} must be nonempty and contain no NUL characters.`);
60
61
  const limit = STRING_BYTE_LIMITS[field] ?? 512;
61
- if (Buffer.byteLength(value) > limit)
62
+ if (target === "cloud" && Buffer.byteLength(value) > limit)
62
63
  throw new Error(`${field} exceeds its Cloud limit of ${limit} UTF-8 bytes.`);
63
64
  }
64
65
  else if (Array.isArray(value) &&
65
66
  value.every((item) => typeof item === "string")) {
66
- if (value.some((item) => Buffer.byteLength(item) > 512))
67
+ if (target === "cloud" &&
68
+ value.some((item) => Buffer.byteLength(item) > 512))
67
69
  throw new Error(`${field} entries exceed the Cloud limit of 512 UTF-8 bytes.`);
68
70
  }
69
71
  else
70
- validateModelStrings(value);
72
+ validateModelStrings(value, target);
71
73
  }
72
74
  }
73
- const modelSchemas = schema.$defs;
74
75
  const detailValidators = new Map();
75
76
  /** AJV does not apply defaults through nullable anyOf references. Validate the
76
77
  * present detail objects directly against their generated model definitions so
77
78
  * sparse normalized inputs match the backend's serialized evidence. */
78
- function materializeDetailDefaults(value, fieldSchema) {
79
+ function materializeDetailDefaults(value, fieldSchema, target) {
79
80
  if (value === null || typeof value !== "object" || Array.isArray(value))
80
81
  return;
81
82
  const reference = fieldSchema.$ref ?? fieldSchema.anyOf?.find((branch) => branch.$ref)?.$ref;
82
83
  if (!reference)
83
84
  return;
84
85
  const name = reference.split("/").at(-1);
85
- const definition = modelSchemas[name];
86
- let check = detailValidators.get(reference);
86
+ const modelSchema = target === "local" ? localSchema : schema;
87
+ const definition = modelSchema.$defs[name];
88
+ const key = `${target}:${reference}`;
89
+ let check = detailValidators.get(key);
87
90
  if (!check) {
88
- check = ajv.compile({ $defs: schema.$defs, $ref: reference });
89
- detailValidators.set(reference, check);
91
+ check = ajv.compile({ $defs: modelSchema.$defs, $ref: reference });
92
+ detailValidators.set(key, check);
90
93
  }
91
94
  if (!check(value))
92
95
  throw new Error(`${name}: ${ajv.errorsText(check.errors)}`);
93
96
  for (const [field, childSchema] of Object.entries(definition.properties ?? {}))
94
- materializeDetailDefaults(value[field], childSchema);
97
+ materializeDetailDefaults(value[field], childSchema, target);
95
98
  }
96
- function normalizeEvidenceDetails(value) {
99
+ function normalizeEvidenceDetails(value, target) {
97
100
  if (value !== null && typeof value === "object") {
98
101
  const fields = value;
99
102
  // Cloud omits these new optional fields when null. Preserve every legacy
@@ -113,41 +116,42 @@ function normalizeEvidenceDetails(value) {
113
116
  for (const field of ["repository", "advisory"])
114
117
  if (details[field] === null)
115
118
  delete details[field];
116
- materializeDetailDefaults(fields["details"], modelSchemas["ImportedFindingEvidence"].properties["details"]);
119
+ materializeDetailDefaults(fields["details"], schema.$defs.ImportedFindingEvidence.properties.details, target);
117
120
  }
118
121
  }
119
122
  }
120
- function validator(name) {
123
+ function validator(name, target = "cloud") {
121
124
  const check = ajv.compile({
122
- $defs: schema.$defs,
125
+ $defs: (target === "local" ? localSchema : schema).$defs,
123
126
  $ref: `#/$defs/${name}`,
124
127
  });
125
128
  return (input) => {
126
129
  if (name === "ImportedFindingEvidence")
127
- normalizeEvidenceDetails(input);
130
+ normalizeEvidenceDetails(input, target);
128
131
  else if (input && typeof input === "object") {
129
132
  if (name === "SourceReport" && "evidence" in input)
130
- normalizeEvidenceDetails(input.evidence);
133
+ normalizeEvidenceDetails(input.evidence, target);
131
134
  if (name === "FindingImportRequest" &&
132
135
  "items" in input &&
133
136
  Array.isArray(input.items))
134
137
  for (const item of input.items)
135
- normalizeEvidenceDetails(item?.evidence);
138
+ normalizeEvidenceDetails(item?.evidence, target);
136
139
  }
137
140
  if (!check(input))
138
141
  throw new Error(`${name}: ${ajv.errorsText(check.errors)}`);
139
- validateModelStrings(input);
142
+ validateModelStrings(input, target);
140
143
  return input;
141
144
  };
142
145
  }
143
146
  const evidence = validator("ImportedFindingEvidence");
147
+ const localEvidence = validator("ImportedFindingEvidence", "local");
144
148
  const request = validator("FindingImportRequest");
145
149
  export const validateImportReceipt = validator("FindingImportReceipt");
146
150
  export const validateRepositories = validator("ImportRepositoryPage");
147
151
  export const validateSourceReports = validator("SourceReportPage");
148
152
  export const validateSourceReport = validator("SourceReport");
149
- export function validateExternalEvidence(input) {
150
- const result = evidence(input);
153
+ export function validateExternalEvidence(input, target = "cloud") {
154
+ const result = (target === "local" ? localEvidence : evidence)(input);
151
155
  for (const location of result.locations ?? []) {
152
156
  const path = location.path.replaceAll("\\", "/");
153
157
  if (path.startsWith("/") ||
@@ -209,11 +213,14 @@ export function validateExternalEvidence(input) {
209
213
  !validHost)
210
214
  throw new Error("Evidence URLs must be HTTP(S) links without credentials.");
211
215
  }
216
+ // Local evidence still has to be serializable JSON, including acyclic source data.
217
+ if (target === "local")
218
+ JSON.stringify(result);
212
219
  let numericByteAdjustment = 0;
213
220
  const pending = [[result, 0]];
214
221
  while (pending.length > 0) {
215
222
  const [value, depth] = pending.pop();
216
- if (depth > 20)
223
+ if (target === "cloud" && depth > 20)
217
224
  throw new Error("Evidence exceeds the Cloud JSON depth limit of 20.");
218
225
  if (value !== null && typeof value === "object") {
219
226
  for (const child of Object.values(value))
@@ -232,8 +239,9 @@ export function validateExternalEvidence(input) {
232
239
  numericByteAdjustment += cloud.length - wire.length;
233
240
  }
234
241
  }
235
- if (Buffer.byteLength(JSON.stringify(result)) + numericByteAdjustment >
236
- 256 * 1024)
242
+ if (target === "cloud" &&
243
+ Buffer.byteLength(JSON.stringify(result)) + numericByteAdjustment >
244
+ 256 * 1024)
237
245
  throw new Error("Evidence exceeds the Cloud limit of 256 KiB.");
238
246
  return result;
239
247
  }
@@ -1 +1 @@
1
- {"version":3,"file":"external-import-contract.js","sourceRoot":"","sources":["../src/external-import-contract.ts"],"names":[],"mappings":"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","sourcesContent":["import { isIP } from \"node:net\";\nimport Ajv2020 from \"ajv/dist/2020.js\";\nimport schema from \"../schemas/external-findings.schema.json\" with { type: \"json\" };\nimport type {\n ExternalFindingEvidence,\n FindingImportRequest,\n FindingImportReceipt,\n ImportRepositoryPage,\n SourceReportPage,\n SourceReport,\n} from \"./external-import-models.js\";\n\nconst ajv = new Ajv2020({\n strict: false,\n validateFormats: false,\n useDefaults: true,\n});\nconst STRING_BYTE_LIMITS: Readonly<Record<string, number>> = {\n description: 65536,\n snippet: 65536,\n remediation_instructions: 65536,\n expected: 65536,\n actual: 65536,\n file_url: 2048,\n path: 2048,\n url: 2048,\n manifest_path: 2048,\n client_id: 128,\n next: 4096,\n};\n\n/** Compare repository URLs without changing the retained vendor evidence.\n * GitHub repository paths are case-insensitive; unknown VCS hosts stay strict.\n * Keep protocols and explicit ports distinct, matching the Cloud URL contract. */\nexport function repositoryUrlKey(value: string): string {\n const normalized = value.replace(/\\/$/u, \"\").replace(/\\.git$/u, \"\");\n const parts = /^(https?):\\/\\/([^/?#]+)((?:\\/[^?#]*)?)((?:[?#].*)?)$/iu.exec(\n normalized,\n );\n if (!parts) return normalized;\n const authority = parts[2]!.toLowerCase();\n const hostname = authority.replace(/:\\d+$/u, \"\");\n const path =\n hostname === \"github.com\" || hostname.endsWith(\".ghe.com\")\n ? parts[3]!.toLowerCase()\n : parts[3]!;\n return `${parts[1]!.toLowerCase()}://${authority}${path}${parts[4]!}`;\n}\n\n// Cloud's import catalog contains GitHub repositories, including custom Enterprise\n// hosts. Match its case-insensitive URL identity without merging schemes or ports.\nexport function cloudRepositoryUrlKey(value: string): string {\n return repositoryUrlKey(value).toLowerCase();\n}\n\n// Cloud ImportModel applies these constraints to both requests and responses.\n// Its UTF-8 limits are not exported as JSON Schema character limits: even a\n// plain string field such as a receipt error message inherits the 512-byte bound.\nfunction validateModelStrings(input: unknown): void {\n if (input === null || typeof input !== \"object\") return;\n if (Array.isArray(input)) {\n for (const item of input) validateModelStrings(item);\n return;\n }\n for (const [field, value] of Object.entries(input)) {\n if (field === \"source_data\") continue;\n if (typeof value === \"string\") {\n if (\n (!value.trim() && ![\"snippet\", \"expected\", \"actual\"].includes(field)) ||\n value.includes(\"\\0\")\n )\n throw new Error(\n `${field} must be nonempty and contain no NUL characters.`,\n );\n const limit = STRING_BYTE_LIMITS[field] ?? 512;\n if (Buffer.byteLength(value) > limit)\n throw new Error(\n `${field} exceeds its Cloud limit of ${limit} UTF-8 bytes.`,\n );\n } else if (\n Array.isArray(value) &&\n value.every((item) => typeof item === \"string\")\n ) {\n if (value.some((item) => Buffer.byteLength(item) > 512))\n throw new Error(\n `${field} entries exceed the Cloud limit of 512 UTF-8 bytes.`,\n );\n } else validateModelStrings(value);\n }\n}\n\ntype ModelSchema = {\n $ref?: string;\n anyOf?: ModelSchema[];\n properties?: Record<string, ModelSchema>;\n [key: string]: unknown;\n};\nconst modelSchemas: Record<string, ModelSchema> = schema.$defs;\nconst detailValidators = new Map<string, ReturnType<typeof ajv.compile>>();\n\n/** AJV does not apply defaults through nullable anyOf references. Validate the\n * present detail objects directly against their generated model definitions so\n * sparse normalized inputs match the backend's serialized evidence. */\nfunction materializeDetailDefaults(\n value: unknown,\n fieldSchema: ModelSchema,\n): void {\n if (value === null || typeof value !== \"object\" || Array.isArray(value))\n return;\n const reference =\n fieldSchema.$ref ?? fieldSchema.anyOf?.find((branch) => branch.$ref)?.$ref;\n if (!reference) return;\n const name = reference.split(\"/\").at(-1)!;\n const definition = modelSchemas[name]!;\n let check = detailValidators.get(reference);\n if (!check) {\n check = ajv.compile({ $defs: schema.$defs, $ref: reference });\n detailValidators.set(reference, check);\n }\n if (!check(value))\n throw new Error(`${name}: ${ajv.errorsText(check.errors)}`);\n for (const [field, childSchema] of Object.entries(\n definition.properties ?? {},\n ))\n materializeDetailDefaults(\n (value as Record<string, unknown>)[field],\n childSchema,\n );\n}\n\nfunction normalizeEvidenceDetails(value: unknown): void {\n if (value !== null && typeof value === \"object\") {\n const fields = value as Record<string, unknown>;\n // Cloud omits these new optional fields when null. Preserve every legacy\n // default so saved Wiz requests still replay the same evidence bytes.\n if (Array.isArray(fields[\"packages\"]))\n for (const value of fields[\"packages\"]) {\n if (\n value &&\n typeof value === \"object\" &&\n value[\"vulnerable_version_range\"] === null\n )\n delete value[\"vulnerable_version_range\"];\n }\n if (fields[\"details\"] === null) delete fields[\"details\"];\n else {\n const details = fields[\"details\"];\n if (details && typeof details === \"object\" && !Array.isArray(details))\n for (const field of [\"repository\", \"advisory\"])\n if ((details as Record<string, unknown>)[field] === null)\n delete (details as Record<string, unknown>)[field];\n materializeDetailDefaults(\n fields[\"details\"],\n modelSchemas[\"ImportedFindingEvidence\"]!.properties![\"details\"]!,\n );\n }\n }\n}\n\nfunction validator<T>(name: keyof typeof schema.$defs) {\n const check = ajv.compile<T>({\n $defs: schema.$defs,\n $ref: `#/$defs/${name}`,\n });\n return (input: unknown): T => {\n if (name === \"ImportedFindingEvidence\") normalizeEvidenceDetails(input);\n else if (input && typeof input === \"object\") {\n if (name === \"SourceReport\" && \"evidence\" in input)\n normalizeEvidenceDetails(input.evidence);\n if (\n name === \"FindingImportRequest\" &&\n \"items\" in input &&\n Array.isArray(input.items)\n )\n for (const item of input.items)\n normalizeEvidenceDetails(item?.evidence);\n }\n if (!check(input))\n throw new Error(`${name}: ${ajv.errorsText(check.errors)}`);\n validateModelStrings(input);\n return input;\n };\n}\n\nconst evidence = validator<ExternalFindingEvidence>(\"ImportedFindingEvidence\");\nconst request = validator<FindingImportRequest>(\"FindingImportRequest\");\nexport const validateImportReceipt = validator<FindingImportReceipt>(\n \"FindingImportReceipt\",\n);\nexport const validateRepositories = validator<ImportRepositoryPage>(\n \"ImportRepositoryPage\",\n);\nexport const validateSourceReports =\n validator<SourceReportPage>(\"SourceReportPage\");\nexport const validateSourceReport = validator<SourceReport>(\"SourceReport\");\n\nexport function validateExternalEvidence(\n input: unknown,\n): ExternalFindingEvidence {\n const result = evidence(input);\n for (const location of result.locations ?? []) {\n const path = location.path.replaceAll(\"\\\\\", \"/\");\n if (\n path.startsWith(\"/\") ||\n /^[A-Za-z]:/.test(path) ||\n path.split(\"/\").includes(\"..\")\n )\n throw new Error(\"Locations must use repository-relative paths.\");\n }\n const details = result.details;\n if (details) {\n if (details.kind === \"advisory\") {\n if (!details.advisory)\n throw new Error(\"Advisory evidence requires its source context.\");\n if (details.advisory.source === \"global\" && details.repository)\n throw new Error(\n \"Global advisory evidence cannot claim a source repository.\",\n );\n if (details.advisory.source === \"repository\" && !details.repository)\n throw new Error(\n \"Repository advisory evidence requires its source repository.\",\n );\n } else {\n if (!details.repository)\n throw new Error(\n \"Repository finding evidence requires its source repository.\",\n );\n if (details.advisory)\n throw new Error(\"Advisory source context requires advisory evidence.\");\n }\n }\n const endLine = result.details?.code?.end_line;\n if (endLine !== null && endLine !== undefined) {\n const firstLine = result.locations?.[0]?.line;\n if (firstLine === null || firstLine === undefined || endLine < firstLine)\n throw new Error(\n \"The code end line requires a first source location line and cannot precede it.\",\n );\n }\n const urls = [\n result.url,\n result.details?.repository?.url,\n result.details?.file_url,\n ];\n for (const value of urls) {\n if (value === null || value === undefined) continue;\n const url = value\n .replace(/[\\t\\r\\n]/gu, \"\")\n .replace(/^[\\u0000-\\u0020]+/u, \"\");\n const authority = /^https?:\\/\\/([^/?#]+)/iu.exec(url)?.[1];\n const normalizedAuthority = (authority ?? \"\")\n .replace(/[@:#?]/gu, \"\")\n .normalize(\"NFKC\");\n let validHost = true;\n if (authority?.includes(\"[\") || authority?.includes(\"]\")) {\n const hostname = /^\\[([^\\]]+)\\](?::[\\s\\S]*)?$/u.exec(authority)?.[1];\n const [address, scope, extraScope] = (hostname ?? \"\").split(\"%\");\n // Cloud accepts scoped IPv6 and IPvFuture hosts in brackets.\n validHost =\n hostname !== undefined &&\n (/^v[a-fA-F0-9]+\\.[\\s\\S]+$/u.test(hostname) ||\n (isIP(address!) === 6 && scope !== \"\" && extraScope === undefined));\n }\n if (\n !authority ||\n authority.includes(\"@\") ||\n /[/?#@:]/u.test(normalizedAuthority) ||\n !validHost\n )\n throw new Error(\n \"Evidence URLs must be HTTP(S) links without credentials.\",\n );\n }\n let numericByteAdjustment = 0;\n const pending: [unknown, number][] = [[result, 0]];\n while (pending.length > 0) {\n const [value, depth] = pending.pop()!;\n if (depth > 20)\n throw new Error(\"Evidence exceeds the Cloud JSON depth limit of 20.\");\n if (value !== null && typeof value === \"object\") {\n for (const child of Object.values(value))\n pending.push([child, depth + 1]);\n } else if (typeof value === \"number\") {\n if (!Number.isFinite(value))\n throw new Error(\"Evidence must contain finite JSON numbers.\");\n if (Number.isInteger(value) && !Number.isSafeInteger(value))\n throw new Error(\n \"Evidence integers must be within JavaScript's safe integer range; export larger values as strings to preserve them exactly.\",\n );\n const wire = JSON.stringify(value);\n // Cloud pads short exponents and formats small fractions scientifically.\n const cloud = (\n wire.includes(\".\") && Math.abs(value) < 1e-4\n ? value.toExponential()\n : wire\n ).replace(/e-(\\d)$/u, \"e-0$1\");\n numericByteAdjustment += cloud.length - wire.length;\n }\n }\n if (\n Buffer.byteLength(JSON.stringify(result)) + numericByteAdjustment >\n 256 * 1024\n )\n throw new Error(\"Evidence exceeds the Cloud limit of 256 KiB.\");\n return result;\n}\n\nexport function validateImportRequest(input: unknown): FindingImportRequest {\n const result = request(input);\n if (\n new Set(result.items.map((item) => item.client_id)).size !==\n result.items.length\n )\n throw new Error(\"Import contains duplicate client IDs.\");\n if (\n new Set(result.items.map((item) => item.source_finding_id)).size !==\n result.items.length\n )\n throw new Error(\"Import contains duplicate source finding identities.\");\n for (const item of result.items) validateExternalEvidence(item.evidence);\n if (Buffer.byteLength(JSON.stringify(result)) > 5 * 1024 * 1024)\n throw new Error(\"Import exceeds the Cloud limit of 5 MiB.\");\n return result;\n}\n"]}
1
+ {"version":3,"file":"external-import-contract.js","sourceRoot":"","sources":["../src/external-import-contract.ts"],"names":[],"mappings":"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","sourcesContent":["import { isIP } from \"node:net\";\nimport Ajv2020 from \"ajv/dist/2020.js\";\nimport schema from \"../schemas/external-findings.schema.json\" with { type: \"json\" };\nimport type {\n ExternalFindingEvidence,\n FindingImportRequest,\n FindingImportReceipt,\n ImportRepositoryPage,\n SourceReportPage,\n SourceReport,\n} from \"./external-import-models.js\";\n\nconst ajv = new Ajv2020({\n strict: false,\n validateFormats: false,\n useDefaults: true,\n});\n\n/** Local storage accepts complete evidence; Cloud publication has payload limits. */\nexport type ExternalImportTarget = \"local\" | \"cloud\";\n\nconst localSchema = JSON.parse(\n JSON.stringify(schema, (key, value: unknown) =>\n key === \"maxLength\" || key === \"maxItems\" ? undefined : value,\n ),\n) as typeof schema;\nconst STRING_BYTE_LIMITS: Readonly<Record<string, number>> = {\n description: 65536,\n snippet: 65536,\n remediation_instructions: 65536,\n expected: 65536,\n actual: 65536,\n file_url: 2048,\n path: 2048,\n url: 2048,\n manifest_path: 2048,\n client_id: 128,\n next: 4096,\n};\n\n/** Compare repository URLs without changing the retained vendor evidence.\n * GitHub repository paths are case-insensitive; unknown VCS hosts stay strict.\n * Keep protocols and explicit ports distinct, matching the Cloud URL contract. */\nexport function repositoryUrlKey(value: string): string {\n const normalized = value.replace(/\\/$/u, \"\").replace(/\\.git$/u, \"\");\n const parts = /^(https?):\\/\\/([^/?#]+)((?:\\/[^?#]*)?)((?:[?#].*)?)$/iu.exec(\n normalized,\n );\n if (!parts) return normalized;\n const authority = parts[2]!.toLowerCase();\n const hostname = authority.replace(/:\\d+$/u, \"\");\n const path =\n hostname === \"github.com\" || hostname.endsWith(\".ghe.com\")\n ? parts[3]!.toLowerCase()\n : parts[3]!;\n return `${parts[1]!.toLowerCase()}://${authority}${path}${parts[4]!}`;\n}\n\n// Cloud's import catalog contains GitHub repositories, including custom Enterprise\n// hosts. Match its case-insensitive URL identity without merging schemes or ports.\nexport function cloudRepositoryUrlKey(value: string): string {\n return repositoryUrlKey(value).toLowerCase();\n}\n\n// Cloud ImportModel applies these constraints to both requests and responses.\n// Its UTF-8 limits are not exported as JSON Schema character limits: even a\n// plain string field such as a receipt error message inherits the 512-byte bound.\nfunction validateModelStrings(\n input: unknown,\n target: ExternalImportTarget,\n): void {\n if (input === null || typeof input !== \"object\") return;\n if (Array.isArray(input)) {\n for (const item of input) validateModelStrings(item, target);\n return;\n }\n for (const [field, value] of Object.entries(input)) {\n if (field === \"source_data\") continue;\n if (typeof value === \"string\") {\n if (\n (!value.trim() && ![\"snippet\", \"expected\", \"actual\"].includes(field)) ||\n value.includes(\"\\0\")\n )\n throw new Error(\n `${field} must be nonempty and contain no NUL characters.`,\n );\n const limit = STRING_BYTE_LIMITS[field] ?? 512;\n if (target === \"cloud\" && Buffer.byteLength(value) > limit)\n throw new Error(\n `${field} exceeds its Cloud limit of ${limit} UTF-8 bytes.`,\n );\n } else if (\n Array.isArray(value) &&\n value.every((item) => typeof item === \"string\")\n ) {\n if (\n target === \"cloud\" &&\n value.some((item) => Buffer.byteLength(item) > 512)\n )\n throw new Error(\n `${field} entries exceed the Cloud limit of 512 UTF-8 bytes.`,\n );\n } else validateModelStrings(value, target);\n }\n}\n\ntype ModelSchema = {\n $ref?: string;\n anyOf?: ModelSchema[];\n properties?: Record<string, ModelSchema>;\n [key: string]: unknown;\n};\nconst detailValidators = new Map<string, ReturnType<typeof ajv.compile>>();\n\n/** AJV does not apply defaults through nullable anyOf references. Validate the\n * present detail objects directly against their generated model definitions so\n * sparse normalized inputs match the backend's serialized evidence. */\nfunction materializeDetailDefaults(\n value: unknown,\n fieldSchema: ModelSchema,\n target: ExternalImportTarget,\n): void {\n if (value === null || typeof value !== \"object\" || Array.isArray(value))\n return;\n const reference =\n fieldSchema.$ref ?? fieldSchema.anyOf?.find((branch) => branch.$ref)?.$ref;\n if (!reference) return;\n const name = reference.split(\"/\").at(-1)!;\n const modelSchema = target === \"local\" ? localSchema : schema;\n const definition: ModelSchema =\n modelSchema.$defs[name as keyof typeof schema.$defs]!;\n const key = `${target}:${reference}`;\n let check = detailValidators.get(key);\n if (!check) {\n check = ajv.compile({ $defs: modelSchema.$defs, $ref: reference });\n detailValidators.set(key, check);\n }\n if (!check(value))\n throw new Error(`${name}: ${ajv.errorsText(check.errors)}`);\n for (const [field, childSchema] of Object.entries(\n definition.properties ?? {},\n ))\n materializeDetailDefaults(\n (value as Record<string, unknown>)[field],\n childSchema,\n target,\n );\n}\n\nfunction normalizeEvidenceDetails(\n value: unknown,\n target: ExternalImportTarget,\n): void {\n if (value !== null && typeof value === \"object\") {\n const fields = value as Record<string, unknown>;\n // Cloud omits these new optional fields when null. Preserve every legacy\n // default so saved Wiz requests still replay the same evidence bytes.\n if (Array.isArray(fields[\"packages\"]))\n for (const value of fields[\"packages\"]) {\n if (\n value &&\n typeof value === \"object\" &&\n value[\"vulnerable_version_range\"] === null\n )\n delete value[\"vulnerable_version_range\"];\n }\n if (fields[\"details\"] === null) delete fields[\"details\"];\n else {\n const details = fields[\"details\"];\n if (details && typeof details === \"object\" && !Array.isArray(details))\n for (const field of [\"repository\", \"advisory\"])\n if ((details as Record<string, unknown>)[field] === null)\n delete (details as Record<string, unknown>)[field];\n materializeDetailDefaults(\n fields[\"details\"],\n schema.$defs.ImportedFindingEvidence.properties.details,\n target,\n );\n }\n }\n}\n\nfunction validator<T>(\n name: keyof typeof schema.$defs,\n target: ExternalImportTarget = \"cloud\",\n) {\n const check = ajv.compile<T>({\n $defs: (target === \"local\" ? localSchema : schema).$defs,\n $ref: `#/$defs/${name}`,\n });\n return (input: unknown): T => {\n if (name === \"ImportedFindingEvidence\")\n normalizeEvidenceDetails(input, target);\n else if (input && typeof input === \"object\") {\n if (name === \"SourceReport\" && \"evidence\" in input)\n normalizeEvidenceDetails(input.evidence, target);\n if (\n name === \"FindingImportRequest\" &&\n \"items\" in input &&\n Array.isArray(input.items)\n )\n for (const item of input.items)\n normalizeEvidenceDetails(item?.evidence, target);\n }\n if (!check(input))\n throw new Error(`${name}: ${ajv.errorsText(check.errors)}`);\n validateModelStrings(input, target);\n return input;\n };\n}\n\nconst evidence = validator<ExternalFindingEvidence>(\"ImportedFindingEvidence\");\nconst localEvidence = validator<ExternalFindingEvidence>(\n \"ImportedFindingEvidence\",\n \"local\",\n);\nconst request = validator<FindingImportRequest>(\"FindingImportRequest\");\nexport const validateImportReceipt = validator<FindingImportReceipt>(\n \"FindingImportReceipt\",\n);\nexport const validateRepositories = validator<ImportRepositoryPage>(\n \"ImportRepositoryPage\",\n);\nexport const validateSourceReports =\n validator<SourceReportPage>(\"SourceReportPage\");\nexport const validateSourceReport = validator<SourceReport>(\"SourceReport\");\n\nexport function validateExternalEvidence(\n input: unknown,\n target: ExternalImportTarget = \"cloud\",\n): ExternalFindingEvidence {\n const result = (target === \"local\" ? localEvidence : evidence)(input);\n for (const location of result.locations ?? []) {\n const path = location.path.replaceAll(\"\\\\\", \"/\");\n if (\n path.startsWith(\"/\") ||\n /^[A-Za-z]:/.test(path) ||\n path.split(\"/\").includes(\"..\")\n )\n throw new Error(\"Locations must use repository-relative paths.\");\n }\n const details = result.details;\n if (details) {\n if (details.kind === \"advisory\") {\n if (!details.advisory)\n throw new Error(\"Advisory evidence requires its source context.\");\n if (details.advisory.source === \"global\" && details.repository)\n throw new Error(\n \"Global advisory evidence cannot claim a source repository.\",\n );\n if (details.advisory.source === \"repository\" && !details.repository)\n throw new Error(\n \"Repository advisory evidence requires its source repository.\",\n );\n } else {\n if (!details.repository)\n throw new Error(\n \"Repository finding evidence requires its source repository.\",\n );\n if (details.advisory)\n throw new Error(\"Advisory source context requires advisory evidence.\");\n }\n }\n const endLine = result.details?.code?.end_line;\n if (endLine !== null && endLine !== undefined) {\n const firstLine = result.locations?.[0]?.line;\n if (firstLine === null || firstLine === undefined || endLine < firstLine)\n throw new Error(\n \"The code end line requires a first source location line and cannot precede it.\",\n );\n }\n const urls = [\n result.url,\n result.details?.repository?.url,\n result.details?.file_url,\n ];\n for (const value of urls) {\n if (value === null || value === undefined) continue;\n const url = value\n .replace(/[\\t\\r\\n]/gu, \"\")\n .replace(/^[\\u0000-\\u0020]+/u, \"\");\n const authority = /^https?:\\/\\/([^/?#]+)/iu.exec(url)?.[1];\n const normalizedAuthority = (authority ?? \"\")\n .replace(/[@:#?]/gu, \"\")\n .normalize(\"NFKC\");\n let validHost = true;\n if (authority?.includes(\"[\") || authority?.includes(\"]\")) {\n const hostname = /^\\[([^\\]]+)\\](?::[\\s\\S]*)?$/u.exec(authority)?.[1];\n const [address, scope, extraScope] = (hostname ?? \"\").split(\"%\");\n // Cloud accepts scoped IPv6 and IPvFuture hosts in brackets.\n validHost =\n hostname !== undefined &&\n (/^v[a-fA-F0-9]+\\.[\\s\\S]+$/u.test(hostname) ||\n (isIP(address!) === 6 && scope !== \"\" && extraScope === undefined));\n }\n if (\n !authority ||\n authority.includes(\"@\") ||\n /[/?#@:]/u.test(normalizedAuthority) ||\n !validHost\n )\n throw new Error(\n \"Evidence URLs must be HTTP(S) links without credentials.\",\n );\n }\n // Local evidence still has to be serializable JSON, including acyclic source data.\n if (target === \"local\") JSON.stringify(result);\n let numericByteAdjustment = 0;\n const pending: [unknown, number][] = [[result, 0]];\n while (pending.length > 0) {\n const [value, depth] = pending.pop()!;\n if (target === \"cloud\" && depth > 20)\n throw new Error(\"Evidence exceeds the Cloud JSON depth limit of 20.\");\n if (value !== null && typeof value === \"object\") {\n for (const child of Object.values(value))\n pending.push([child, depth + 1]);\n } else if (typeof value === \"number\") {\n if (!Number.isFinite(value))\n throw new Error(\"Evidence must contain finite JSON numbers.\");\n if (Number.isInteger(value) && !Number.isSafeInteger(value))\n throw new Error(\n \"Evidence integers must be within JavaScript's safe integer range; export larger values as strings to preserve them exactly.\",\n );\n const wire = JSON.stringify(value);\n // Cloud pads short exponents and formats small fractions scientifically.\n const cloud = (\n wire.includes(\".\") && Math.abs(value) < 1e-4\n ? value.toExponential()\n : wire\n ).replace(/e-(\\d)$/u, \"e-0$1\");\n numericByteAdjustment += cloud.length - wire.length;\n }\n }\n if (\n target === \"cloud\" &&\n Buffer.byteLength(JSON.stringify(result)) + numericByteAdjustment >\n 256 * 1024\n )\n throw new Error(\"Evidence exceeds the Cloud limit of 256 KiB.\");\n return result;\n}\n\nexport function validateImportRequest(input: unknown): FindingImportRequest {\n const result = request(input);\n if (\n new Set(result.items.map((item) => item.client_id)).size !==\n result.items.length\n )\n throw new Error(\"Import contains duplicate client IDs.\");\n if (\n new Set(result.items.map((item) => item.source_finding_id)).size !==\n result.items.length\n )\n throw new Error(\"Import contains duplicate source finding identities.\");\n for (const item of result.items) validateExternalEvidence(item.evidence);\n if (Buffer.byteLength(JSON.stringify(result)) > 5 * 1024 * 1024)\n throw new Error(\"Import exceeds the Cloud limit of 5 MiB.\");\n return result;\n}\n"]}
@@ -0,0 +1,6 @@
1
+ export declare const externalImportsDisabledMessage = "External findings imports are disabled. Set CODEX_SECURITY_ENABLE_EXTERNAL_IMPORTS=1 to enable them.";
2
+ export declare function externalImportsEnabled(environment?: NodeJS.ProcessEnv): boolean;
3
+ /** Preserve the selected flag while copying a caller's environment for a child. */
4
+ export declare function forwardExternalImportSetting<Value>(source: Record<string, Value | undefined>, child: Record<string, Value>): void;
5
+ export declare function requireExternalImports(environment?: NodeJS.ProcessEnv): void;
6
+ //# sourceMappingURL=external-imports-feature.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"external-imports-feature.d.ts","sourceRoot":"","sources":["../src/external-imports-feature.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,8BAA8B,yGAA0E,CAAC;AA6BtH,wBAAgB,sBAAsB,CACpC,WAAW,GAAE,MAAM,CAAC,UAAwB,GAC3C,OAAO,CAET;AAED,mFAAmF;AACnF,wBAAgB,4BAA4B,CAAC,KAAK,EAChD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,GAAG,SAAS,CAAC,EACzC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,GAC3B,IAAI,CAUN;AAED,wBAAgB,sBAAsB,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,IAAI,CAI5E"}
@@ -0,0 +1,51 @@
1
+ import { CodexSecurityError } from "./errors.js";
2
+ const flag = "CODEX_SECURITY_ENABLE_EXTERNAL_IMPORTS";
3
+ export const externalImportsDisabledMessage = `External findings imports are disabled. Set ${flag}=1 to enable them.`;
4
+ function externalImportSetting(environment) {
5
+ const exact = environment[flag];
6
+ if (process.platform !== "win32")
7
+ return { key: flag, value: exact };
8
+ // A scan can override a case-insensitive process.env with its own spelling.
9
+ function callerDeclares(key) {
10
+ for (let owner = environment; owner && owner !== process.env; owner = Object.getPrototypeOf(owner)) {
11
+ if (Object.hasOwn(owner, key))
12
+ return true;
13
+ }
14
+ return false;
15
+ }
16
+ if (exact !== undefined && callerDeclares(flag))
17
+ return { key: flag, value: exact };
18
+ // Node includes enumerable prototype keys and sorts competing spellings.
19
+ const keys = [];
20
+ for (const name in environment) {
21
+ if (name.toUpperCase() === flag)
22
+ keys.push(name);
23
+ }
24
+ keys.sort();
25
+ const key = keys.find(callerDeclares) ?? keys[0];
26
+ if (key !== undefined)
27
+ return { key, value: key === flag ? exact : environment[key] };
28
+ }
29
+ export function externalImportsEnabled(environment = process.env) {
30
+ return externalImportSetting(environment)?.value === "1";
31
+ }
32
+ /** Preserve the selected flag while copying a caller's environment for a child. */
33
+ export function forwardExternalImportSetting(source, child) {
34
+ const selected = externalImportSetting(source);
35
+ if (selected === undefined)
36
+ return;
37
+ if (process.platform === "win32") {
38
+ for (const name of Object.keys(child)) {
39
+ if (name !== selected.key && name.toUpperCase() === flag)
40
+ delete child[name];
41
+ }
42
+ }
43
+ if (selected.value !== undefined)
44
+ child[selected.key] = selected.value;
45
+ }
46
+ export function requireExternalImports(environment) {
47
+ if (!externalImportsEnabled(environment)) {
48
+ throw new CodexSecurityError(externalImportsDisabledMessage);
49
+ }
50
+ }
51
+ //# sourceMappingURL=external-imports-feature.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"external-imports-feature.js","sourceRoot":"","sources":["../src/external-imports-feature.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,IAAI,GAAG,wCAAwC,CAAC;AACtD,MAAM,CAAC,MAAM,8BAA8B,GAAG,+CAA+C,IAAI,oBAAoB,CAAC;AAEtH,SAAS,qBAAqB,CAAQ,WAAkC;IACtE,MAAM,KAAK,GAAG,WAAW,CAAC,IAAI,CAAC,CAAC;IAChC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACrE,4EAA4E;IAC5E,SAAS,cAAc,CAAC,GAAW;QACjC,KACE,IAAI,KAAK,GAAkB,WAAW,EACtC,KAAK,IAAI,KAAK,KAAK,OAAO,CAAC,GAAG,EAC9B,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,EACpC,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC;gBAAE,OAAO,IAAI,CAAC;QAC7C,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,KAAK,KAAK,SAAS,IAAI,cAAc,CAAC,IAAI,CAAC;QAC7C,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;IACrC,yEAAyE;IACzE,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI;YAAE,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACnD,CAAC;IACD,IAAI,CAAC,IAAI,EAAE,CAAC;IACZ,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC;IACjD,IAAI,GAAG,KAAK,SAAS;QACnB,OAAO,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,sBAAsB,CACpC,WAAW,GAAsB,OAAO,CAAC,GAAG;IAE5C,OAAO,qBAAqB,CAAC,WAAW,CAAC,EAAE,KAAK,KAAK,GAAG,CAAC;AAC3D,CAAC;AAED,mFAAmF;AACnF,MAAM,UAAU,4BAA4B,CAC1C,MAAyC,EACzC,KAA4B;IAE5B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,MAAM,CAAC,CAAC;IAC/C,IAAI,QAAQ,KAAK,SAAS;QAAE,OAAO;IACnC,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;YACtC,IAAI,IAAI,KAAK,QAAQ,CAAC,GAAG,IAAI,IAAI,CAAC,WAAW,EAAE,KAAK,IAAI;gBACtD,OAAO,KAAK,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,IAAI,QAAQ,CAAC,KAAK,KAAK,SAAS;QAAE,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC,KAAK,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,sBAAsB,CAAC,WAA+B;IACpE,IAAI,CAAC,sBAAsB,CAAC,WAAW,CAAC,EAAE,CAAC;QACzC,MAAM,IAAI,kBAAkB,CAAC,8BAA8B,CAAC,CAAC;IAC/D,CAAC;AACH,CAAC","sourcesContent":["import { CodexSecurityError } from \"./errors.js\";\n\nconst flag = \"CODEX_SECURITY_ENABLE_EXTERNAL_IMPORTS\";\nexport const externalImportsDisabledMessage = `External findings imports are disabled. Set ${flag}=1 to enable them.`;\n\nfunction externalImportSetting<Value>(environment: Record<string, Value>) {\n const exact = environment[flag];\n if (process.platform !== \"win32\") return { key: flag, value: exact };\n // A scan can override a case-insensitive process.env with its own spelling.\n function callerDeclares(key: string): boolean {\n for (\n let owner: object | null = environment;\n owner && owner !== process.env;\n owner = Object.getPrototypeOf(owner)\n ) {\n if (Object.hasOwn(owner, key)) return true;\n }\n return false;\n }\n if (exact !== undefined && callerDeclares(flag))\n return { key: flag, value: exact };\n // Node includes enumerable prototype keys and sorts competing spellings.\n const keys: string[] = [];\n for (const name in environment) {\n if (name.toUpperCase() === flag) keys.push(name);\n }\n keys.sort();\n const key = keys.find(callerDeclares) ?? keys[0];\n if (key !== undefined)\n return { key, value: key === flag ? exact : environment[key] };\n}\n\nexport function externalImportsEnabled(\n environment: NodeJS.ProcessEnv = process.env,\n): boolean {\n return externalImportSetting(environment)?.value === \"1\";\n}\n\n/** Preserve the selected flag while copying a caller's environment for a child. */\nexport function forwardExternalImportSetting<Value>(\n source: Record<string, Value | undefined>,\n child: Record<string, Value>,\n): void {\n const selected = externalImportSetting(source);\n if (selected === undefined) return;\n if (process.platform === \"win32\") {\n for (const name of Object.keys(child)) {\n if (name !== selected.key && name.toUpperCase() === flag)\n delete child[name];\n }\n }\n if (selected.value !== undefined) child[selected.key] = selected.value;\n}\n\nexport function requireExternalImports(environment?: NodeJS.ProcessEnv): void {\n if (!externalImportsEnabled(environment)) {\n throw new CodexSecurityError(externalImportsDisabledMessage);\n }\n}\n"]}
@@ -1,6 +1,6 @@
1
1
  import type { JsonObject } from "./config.js";
2
2
  import type { FindingSearchScope } from "./finding-retrieval.js";
3
- import { runWorkbench } from "./runtime.js";
3
+ import { runWorkbench, type WorkbenchCommandOptions } from "./runtime.js";
4
4
  export type WorkflowStage = "scan" | "publish" | "dedupe";
5
5
  export interface WorkflowBinding {
6
6
  repositoryPath?: string;
@@ -28,6 +28,12 @@ export interface DedupePendingWrite {
28
28
  gitDisabled?: boolean;
29
29
  };
30
30
  }
31
+ interface SourceSnapshotOptions {
32
+ optional?: boolean;
33
+ gitDisabled?: boolean;
34
+ privateStatePaths?: readonly string[];
35
+ evidence?: boolean;
36
+ }
31
37
  export declare function workflowDigest(value: unknown): string;
32
38
  export declare function workflowDestination(url: string): string;
33
39
  /** State lives in the workbench database, never in sealed scan artifacts. */
@@ -36,9 +42,12 @@ export declare class FindingWorkflow {
36
42
  private readonly environment;
37
43
  private readonly workbench;
38
44
  private readonly pythonPath?;
39
- private readonly protectedRoot?;
45
+ private readonly selection;
40
46
  private options?;
41
- constructor(id: string, environment?: NodeJS.ProcessEnv, workbench?: typeof runWorkbench, pythonPath?: string | undefined, protectedRoot?: string | undefined);
47
+ constructor(id: string, environment?: NodeJS.ProcessEnv, workbench?: typeof runWorkbench, pythonPath?: string | undefined, selection?: {
48
+ protectedRoot?: string;
49
+ workbenchOptions?: WorkbenchCommandOptions;
50
+ });
42
51
  protectArtifacts(scanDir: string): Promise<void>;
43
52
  get(): Promise<WorkflowState | null>;
44
53
  bind(binding: WorkflowBinding): Promise<WorkflowState>;
@@ -47,12 +56,20 @@ export declare class FindingWorkflow {
47
56
  fail(stage: WorkflowStage, error: unknown, result?: unknown): Promise<void>;
48
57
  run<T>(stage: WorkflowStage, operation: () => Promise<T>): Promise<T>;
49
58
  registeredScan(scanId: string): Promise<JsonObject>;
50
- sourceSnapshot(repository: string, gitDisabled?: boolean, privateStatePaths?: readonly string[]): Promise<JsonObject>;
59
+ sourceSnapshot(repository: string, options?: SourceSnapshotOptions & {
60
+ optional?: false;
61
+ }): Promise<JsonObject>;
62
+ sourceSnapshot(repository: string, options: SourceSnapshotOptions & {
63
+ optional: true;
64
+ }): Promise<JsonObject | null>;
51
65
  getReview(key: string): Promise<unknown>;
52
- saveReview(key: string, binding: object, result: unknown): Promise<void>;
66
+ saveReview(key: string, binding: object, result: unknown, options?: {
67
+ replace?: boolean;
68
+ }): Promise<void>;
53
69
  prepareDedupe(result: unknown, pendingWrite: DedupePendingWrite): Promise<void>;
54
70
  private command;
55
71
  private request;
56
72
  private call;
57
73
  }
74
+ export {};
58
75
  //# sourceMappingURL=finding-workflow.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"finding-workflow.d.ts","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"finding-workflow.d.ts","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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"}
@@ -21,16 +21,18 @@ export class FindingWorkflow {
21
21
  environment;
22
22
  workbench;
23
23
  pythonPath;
24
- protectedRoot;
24
+ selection;
25
25
  options;
26
- constructor(id, environment = process.env, workbench = runWorkbench, pythonPath, protectedRoot) {
26
+ constructor(id, environment = process.env, workbench = runWorkbench, pythonPath, selection = {}) {
27
27
  this.id = id;
28
28
  this.environment = environment;
29
29
  this.workbench = workbench;
30
30
  this.pythonPath = pythonPath;
31
- this.protectedRoot = protectedRoot;
31
+ this.selection = selection;
32
32
  if (!id.trim())
33
33
  throw new CodexSecurityError("workflowId must be a nonempty string.");
34
+ if (selection.workbenchOptions !== undefined)
35
+ this.options = Promise.resolve(selection.workbenchOptions);
34
36
  }
35
37
  async protectArtifacts(scanDir) {
36
38
  const path = relative(await canonicalizeModelSafePath(scanDir), await canonicalizeModelSafePath(codexSecurityStateDirectory(this.environment)));
@@ -77,19 +79,29 @@ export class FindingWorkflow {
77
79
  const context = await this.call(["get-scan", "--scan-id", scanId]);
78
80
  return context["scan"];
79
81
  }
80
- async sourceSnapshot(repository, gitDisabled = false, privateStatePaths = []) {
82
+ async sourceSnapshot(repository, options = {}) {
81
83
  return (await this.request({
82
84
  action: "source",
83
85
  repository,
84
- ...(gitDisabled ? { gitDisabled } : {}),
85
- ...(privateStatePaths.length ? { privateStatePaths } : {}),
86
+ ...(options.optional ? { optional: true } : {}),
87
+ ...(options.gitDisabled ? { gitDisabled: true } : {}),
88
+ ...(options.evidence ? { evidence: true } : {}),
89
+ ...(options.privateStatePaths?.length
90
+ ? { privateStatePaths: options.privateStatePaths }
91
+ : {}),
86
92
  }))["source"];
87
93
  }
88
94
  async getReview(key) {
89
95
  return (await this.request({ action: "get-review", key }))["review"];
90
96
  }
91
- async saveReview(key, binding, result) {
92
- await this.request({ action: "save-review", key, binding, result });
97
+ async saveReview(key, binding, result, options = {}) {
98
+ await this.request({
99
+ action: "save-review",
100
+ key,
101
+ binding,
102
+ result,
103
+ ...(options.replace ? { replace: true } : {}),
104
+ });
93
105
  }
94
106
  async prepareDedupe(result, pendingWrite) {
95
107
  await this.command({
@@ -112,7 +124,7 @@ export class FindingWorkflow {
112
124
  python: await resolvePluginPython({
113
125
  environment: this.environment,
114
126
  configuredPath: this.pythonPath,
115
- protectedRoot: this.protectedRoot,
127
+ protectedRoot: this.selection.protectedRoot,
116
128
  }),
117
129
  environment: workbenchEnvironment(this.environment),
118
130
  failureMessage: "Could not save or resume the findings workflow",
@@ -1 +1 @@
1
- {"version":3,"file":"finding-workflow.js","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { isAbsolute, relative, sep } from \"node:path\";\nimport type { JsonObject } from \"./config.js\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport { findingsBaseUrl } from \"./findings-client.js\";\nimport type { FindingSearchScope } from \"./finding-retrieval.js\";\nimport {\n bundledPluginRoot,\n canonicalizeModelSafePath,\n codexSecurityStateDirectory,\n workbenchEnvironment,\n resolvePluginPython,\n runWorkbench,\n type WorkbenchCommandOptions,\n} from \"./runtime.js\";\n\nexport type WorkflowStage = \"scan\" | \"publish\" | \"dedupe\";\nexport interface WorkflowBinding {\n repositoryPath?: string;\n scanRequestDigest?: string;\n scanId?: string;\n scanDir?: string;\n artifactDigest?: string;\n destination?: string;\n scope?: FindingSearchScope;\n}\nexport interface WorkflowState extends WorkflowBinding {\n id: string;\n stages: Record<\n WorkflowStage,\n {\n status: \"pending\" | \"running\" | \"failed\" | \"completed\";\n result?: unknown;\n error?: string;\n pendingWrite?: DedupePendingWrite;\n }\n >;\n}\n\nexport interface DedupePendingWrite {\n groups: string[][];\n local?: { inputDigest: string; source: JsonObject; gitDisabled?: boolean };\n}\n\nexport function workflowDigest(value: unknown): string {\n const json = JSON.stringify(value, (_key, item: unknown) =>\n item !== null && typeof item === \"object\" && !Array.isArray(item)\n ? Object.fromEntries(\n Object.entries(item).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)),\n )\n : item,\n );\n return createHash(\"sha256\").update(json).digest(\"hex\");\n}\n\nexport function workflowDestination(url: string): string {\n const destination = findingsBaseUrl(url);\n destination.username = \"\";\n destination.password = \"\";\n return destination.href;\n}\n\n/** State lives in the workbench database, never in sealed scan artifacts. */\nexport class FindingWorkflow {\n private options?: Promise<WorkbenchCommandOptions>;\n\n constructor(\n readonly id: string,\n private readonly environment: NodeJS.ProcessEnv = process.env,\n private readonly workbench: typeof runWorkbench = runWorkbench,\n private readonly pythonPath?: string,\n private readonly protectedRoot?: string,\n ) {\n if (!id.trim())\n throw new CodexSecurityError(\"workflowId must be a nonempty string.\");\n }\n\n async protectArtifacts(scanDir: string): Promise<void> {\n const path = relative(\n await canonicalizeModelSafePath(scanDir),\n await canonicalizeModelSafePath(\n codexSecurityStateDirectory(this.environment),\n ),\n );\n if (\n path === \"\" ||\n (!isAbsolute(path) && path !== \"..\" && !path.startsWith(`..${sep}`))\n ) {\n throw new CodexSecurityError(\n \"Workflow state must be outside the sealed scan artifacts.\",\n );\n }\n }\n\n async get(): Promise<WorkflowState | null> {\n return (await this.command({ action: \"get\" })) as WorkflowState | null;\n }\n\n async bind(binding: WorkflowBinding): Promise<WorkflowState> {\n return (await this.command({ action: \"bind\", binding }))!;\n }\n\n async begin(stage: WorkflowStage): Promise<WorkflowState> {\n return (await this.command({ action: \"begin\", stage }))!;\n }\n\n async complete(\n stage: WorkflowStage,\n result: unknown,\n ): Promise<WorkflowState> {\n return (await this.command({ action: \"complete\", stage, result }))!;\n }\n\n async fail(\n stage: WorkflowStage,\n error: unknown,\n result?: unknown,\n ): Promise<void> {\n await this.command({\n action: \"fail\",\n stage,\n error: errorMessage(error),\n ...(result === undefined ? {} : { result }),\n }).catch(() => undefined);\n }\n\n async run<T>(stage: WorkflowStage, operation: () => Promise<T>): Promise<T> {\n const state = await this.begin(stage);\n if (state.stages[stage].status === \"completed\")\n return state.stages[stage].result as T;\n try {\n const result = await operation();\n await this.complete(stage, result);\n return result;\n } catch (error) {\n await this.fail(stage, error);\n throw error;\n }\n }\n\n async registeredScan(scanId: string): Promise<JsonObject> {\n const context = await this.call([\"get-scan\", \"--scan-id\", scanId]);\n return context[\"scan\"] as JsonObject;\n }\n\n async sourceSnapshot(\n repository: string,\n gitDisabled = false,\n privateStatePaths: readonly string[] = [],\n ): Promise<JsonObject> {\n return (\n await this.request({\n action: \"source\",\n repository,\n ...(gitDisabled ? { gitDisabled } : {}),\n ...(privateStatePaths.length ? { privateStatePaths } : {}),\n })\n )[\"source\"] as JsonObject;\n }\n\n async getReview(key: string): Promise<unknown> {\n return (await this.request({ action: \"get-review\", key }))[\"review\"];\n }\n\n async saveReview(\n key: string,\n binding: object,\n result: unknown,\n ): Promise<void> {\n await this.request({ action: \"save-review\", key, binding, result });\n }\n\n async prepareDedupe(\n result: unknown,\n pendingWrite: DedupePendingWrite,\n ): Promise<void> {\n await this.command({\n action: \"prepare-dedupe\",\n stage: \"dedupe\",\n result,\n pendingWrite,\n });\n }\n\n private async command(payload: object): Promise<WorkflowState | null> {\n const result = await this.request(payload);\n return result[\"workflow\"] as unknown as WorkflowState | null;\n }\n\n private async request(payload: object): Promise<JsonObject> {\n return await this.call(\n [\"finding-workflow\"],\n JSON.stringify({ id: this.id, ...payload }),\n );\n }\n\n private async call(\n args: readonly string[],\n input?: string,\n ): Promise<JsonObject> {\n this.options ??= (async () => ({\n pluginRoot: await bundledPluginRoot(),\n python: await resolvePluginPython({\n environment: this.environment,\n configuredPath: this.pythonPath,\n protectedRoot: this.protectedRoot,\n }),\n environment: workbenchEnvironment(this.environment),\n failureMessage: \"Could not save or resume the findings workflow\",\n }))();\n return await this.workbench(await this.options, args, input);\n }\n}\n"]}
1
+ {"version":3,"file":"finding-workflow.js","sourceRoot":"","sources":["../src/finding-workflow.ts"],"names":[],"mappings":"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","sourcesContent":["import { createHash } from \"node:crypto\";\nimport { isAbsolute, relative, sep } from \"node:path\";\nimport type { JsonObject } from \"./config.js\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport { findingsBaseUrl } from \"./findings-client.js\";\nimport type { FindingSearchScope } from \"./finding-retrieval.js\";\nimport {\n bundledPluginRoot,\n canonicalizeModelSafePath,\n codexSecurityStateDirectory,\n workbenchEnvironment,\n resolvePluginPython,\n runWorkbench,\n type WorkbenchCommandOptions,\n} from \"./runtime.js\";\n\nexport type WorkflowStage = \"scan\" | \"publish\" | \"dedupe\";\nexport interface WorkflowBinding {\n repositoryPath?: string;\n scanRequestDigest?: string;\n scanId?: string;\n scanDir?: string;\n artifactDigest?: string;\n destination?: string;\n scope?: FindingSearchScope;\n}\nexport interface WorkflowState extends WorkflowBinding {\n id: string;\n stages: Record<\n WorkflowStage,\n {\n status: \"pending\" | \"running\" | \"failed\" | \"completed\";\n result?: unknown;\n error?: string;\n pendingWrite?: DedupePendingWrite;\n }\n >;\n}\n\nexport interface DedupePendingWrite {\n groups: string[][];\n local?: { inputDigest: string; source: JsonObject; gitDisabled?: boolean };\n}\n\ninterface SourceSnapshotOptions {\n optional?: boolean;\n gitDisabled?: boolean;\n privateStatePaths?: readonly string[];\n evidence?: boolean;\n}\n\nexport function workflowDigest(value: unknown): string {\n const json = JSON.stringify(value, (_key, item: unknown) =>\n item !== null && typeof item === \"object\" && !Array.isArray(item)\n ? Object.fromEntries(\n Object.entries(item).sort(([a], [b]) => (a < b ? -1 : a > b ? 1 : 0)),\n )\n : item,\n );\n return createHash(\"sha256\").update(json).digest(\"hex\");\n}\n\nexport function workflowDestination(url: string): string {\n const destination = findingsBaseUrl(url);\n destination.username = \"\";\n destination.password = \"\";\n return destination.href;\n}\n\n/** State lives in the workbench database, never in sealed scan artifacts. */\nexport class FindingWorkflow {\n private options?: Promise<WorkbenchCommandOptions>;\n\n constructor(\n readonly id: string,\n private readonly environment: NodeJS.ProcessEnv = process.env,\n private readonly workbench: typeof runWorkbench = runWorkbench,\n private readonly pythonPath?: string,\n private readonly selection: {\n protectedRoot?: string;\n workbenchOptions?: WorkbenchCommandOptions;\n } = {},\n ) {\n if (!id.trim())\n throw new CodexSecurityError(\"workflowId must be a nonempty string.\");\n if (selection.workbenchOptions !== undefined)\n this.options = Promise.resolve(selection.workbenchOptions);\n }\n\n async protectArtifacts(scanDir: string): Promise<void> {\n const path = relative(\n await canonicalizeModelSafePath(scanDir),\n await canonicalizeModelSafePath(\n codexSecurityStateDirectory(this.environment),\n ),\n );\n if (\n path === \"\" ||\n (!isAbsolute(path) && path !== \"..\" && !path.startsWith(`..${sep}`))\n ) {\n throw new CodexSecurityError(\n \"Workflow state must be outside the sealed scan artifacts.\",\n );\n }\n }\n\n async get(): Promise<WorkflowState | null> {\n return (await this.command({ action: \"get\" })) as WorkflowState | null;\n }\n\n async bind(binding: WorkflowBinding): Promise<WorkflowState> {\n return (await this.command({ action: \"bind\", binding }))!;\n }\n\n async begin(stage: WorkflowStage): Promise<WorkflowState> {\n return (await this.command({ action: \"begin\", stage }))!;\n }\n\n async complete(\n stage: WorkflowStage,\n result: unknown,\n ): Promise<WorkflowState> {\n return (await this.command({ action: \"complete\", stage, result }))!;\n }\n\n async fail(\n stage: WorkflowStage,\n error: unknown,\n result?: unknown,\n ): Promise<void> {\n await this.command({\n action: \"fail\",\n stage,\n error: errorMessage(error),\n ...(result === undefined ? {} : { result }),\n }).catch(() => undefined);\n }\n\n async run<T>(stage: WorkflowStage, operation: () => Promise<T>): Promise<T> {\n const state = await this.begin(stage);\n if (state.stages[stage].status === \"completed\")\n return state.stages[stage].result as T;\n try {\n const result = await operation();\n await this.complete(stage, result);\n return result;\n } catch (error) {\n await this.fail(stage, error);\n throw error;\n }\n }\n\n async registeredScan(scanId: string): Promise<JsonObject> {\n const context = await this.call([\"get-scan\", \"--scan-id\", scanId]);\n return context[\"scan\"] as JsonObject;\n }\n\n async sourceSnapshot(\n repository: string,\n options?: SourceSnapshotOptions & { optional?: false },\n ): Promise<JsonObject>;\n async sourceSnapshot(\n repository: string,\n options: SourceSnapshotOptions & { optional: true },\n ): Promise<JsonObject | null>;\n async sourceSnapshot(\n repository: string,\n options: SourceSnapshotOptions = {},\n ): Promise<JsonObject | null> {\n return (\n await this.request({\n action: \"source\",\n repository,\n ...(options.optional ? { optional: true } : {}),\n ...(options.gitDisabled ? { gitDisabled: true } : {}),\n ...(options.evidence ? { evidence: true } : {}),\n ...(options.privateStatePaths?.length\n ? { privateStatePaths: options.privateStatePaths }\n : {}),\n })\n )[\"source\"] as JsonObject | null;\n }\n\n async getReview(key: string): Promise<unknown> {\n return (await this.request({ action: \"get-review\", key }))[\"review\"];\n }\n\n async saveReview(\n key: string,\n binding: object,\n result: unknown,\n options: { replace?: boolean } = {},\n ): Promise<void> {\n await this.request({\n action: \"save-review\",\n key,\n binding,\n result,\n ...(options.replace ? { replace: true } : {}),\n });\n }\n\n async prepareDedupe(\n result: unknown,\n pendingWrite: DedupePendingWrite,\n ): Promise<void> {\n await this.command({\n action: \"prepare-dedupe\",\n stage: \"dedupe\",\n result,\n pendingWrite,\n });\n }\n\n private async command(payload: object): Promise<WorkflowState | null> {\n const result = await this.request(payload);\n return result[\"workflow\"] as unknown as WorkflowState | null;\n }\n\n private async request(payload: object): Promise<JsonObject> {\n return await this.call(\n [\"finding-workflow\"],\n JSON.stringify({ id: this.id, ...payload }),\n );\n }\n\n private async call(\n args: readonly string[],\n input?: string,\n ): Promise<JsonObject> {\n this.options ??= (async () => ({\n pluginRoot: await bundledPluginRoot(),\n python: await resolvePluginPython({\n environment: this.environment,\n configuredPath: this.pythonPath,\n protectedRoot: this.selection.protectedRoot,\n }),\n environment: workbenchEnvironment(this.environment),\n failureMessage: \"Could not save or resume the findings workflow\",\n }))();\n return await this.workbench(await this.options, args, input);\n }\n}\n"]}
@@ -1 +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"}
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;AAK7C,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,CAwInC;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"}
@@ -1,4 +1,5 @@
1
1
  import { CodexSecurityError, errorMessage } from "./errors.js";
2
+ import { requireExternalImports } from "./external-imports-feature.js";
2
3
  import { createAuthenticatedGitHub } from "./github.js";
3
4
  export const GITHUB_ADVISORY_STATES = [
4
5
  "published",
@@ -9,6 +10,8 @@ export const GITHUB_ADVISORY_STATES = [
9
10
  /** Read repository disclosures or explicitly selected public GHSA records. */
10
11
  export async function importGitHubAdvisories(options, dependencies = {}) {
11
12
  options.signal?.throwIfAborted();
13
+ const environment = dependencies.environment ?? process.env;
14
+ requireExternalImports(environment);
12
15
  const repository = options.repository.trim();
13
16
  const parts = /^([a-z0-9_.-]+)\/([a-z0-9_.-]+)$/iu.exec(repository);
14
17
  if (!parts || parts.slice(1).some((part) => /^\.{1,2}$/u.test(part)))
@@ -33,7 +36,6 @@ export async function importGitHubAdvisories(options, dependencies = {}) {
33
36
  throw new CodexSecurityError("Select explicit GHSA IDs for global advisories; database-wide import is not supported.");
34
37
  if (ids.length > 0 && state !== "published")
35
38
  throw new CodexSecurityError("--github-state only filters repository lists; omit it when selecting exact GHSA IDs.");
36
- const environment = dependencies.environment ?? process.env;
37
39
  const host = options.githubHost?.trim() ??
38
40
  (environment["GH_HOST"]?.trim() || "github.com");
39
41
  if (!host)