@openai/codex-security 0.5.1 → 0.7.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +151 -36
- package/_bundled_plugin/.mcp.json +1 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/helpers.mjs.br.part-001 +0 -0
- package/_bundled_plugin/mcp/native/THIRD_PARTY_NOTICES.txt +1 -1
- package/_bundled_plugin/mcp/native/darwin-arm64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/darwin-x64/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-arm64-musl/unix.node +0 -0
- package/_bundled_plugin/mcp/native/linux-x64-gnu/unix.node +0 -0
- package/_bundled_plugin/mcp/native/win32-arm64/windows.node +0 -0
- package/_bundled_plugin/mcp/native/win32-x64/windows.node +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-000 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-001 +0 -0
- package/_bundled_plugin/mcp/server.mjs.br.part-002 +0 -0
- package/_bundled_plugin/references/access-advisory.md +11 -0
- package/_bundled_plugin/references/core-scan.md +30 -77
- package/_bundled_plugin/references/final-report.md +45 -189
- package/_bundled_plugin/references/scan-contract.md +2 -0
- package/_bundled_plugin/references/scan-prologue.md +1 -1
- package/_bundled_plugin/references/scan-runtime.md +1 -5
- package/_bundled_plugin/references/threat-model.md +33 -41
- package/_bundled_plugin/schemas/coverage.schema.json +12 -1
- package/_bundled_plugin/schemas/scan-manifest.schema.json +1 -0
- package/_bundled_plugin/schemas/tools/deep-reducer.schema.json +38 -1
- package/_bundled_plugin/scripts/deep_scan_config.py +39 -39
- package/_bundled_plugin/scripts/deep_scan_workbench.py +145 -85
- package/_bundled_plugin/scripts/finalize_scan_contract.py +189 -57
- package/_bundled_plugin/scripts/report_projection.py +44 -15
- package/_bundled_plugin/scripts/threat_model_projection.py +4 -2
- package/_bundled_plugin/scripts/windows_scan_local_files.py +43 -14
- package/_bundled_plugin/scripts/workbench/retained_coverage.py +3218 -0
- package/_bundled_plugin/scripts/workbench/retained_records.py +627 -0
- package/_bundled_plugin/scripts/workbench/saved_coverage.py +644 -1
- package/_bundled_plugin/scripts/workbench/saved_outputs.py +72 -0
- package/_bundled_plugin/scripts/workbench/saved_sources.py +712 -0
- package/_bundled_plugin/scripts/workbench_cli.py +3 -0
- package/_bundled_plugin/scripts/workbench_coverage_receipts.py +479 -0
- package/_bundled_plugin/scripts/workbench_db.py +51 -22
- package/_bundled_plugin/scripts/workbench_feedback.py +0 -1
- package/_bundled_plugin/scripts/workbench_finding_workflows.py +53 -9
- package/_bundled_plugin/scripts/workbench_native_indexes.py +56 -44
- package/_bundled_plugin/scripts/workbench_saved_results.py +641 -2387
- package/_bundled_plugin/scripts/workbench_scan_history.py +72 -7
- package/_bundled_plugin/scripts/workbench_schema.py +1 -1
- package/_bundled_plugin/scripts/workbench_source_scopes.py +4 -1
- package/_bundled_plugin/scripts/workbench_target.py +142 -17
- package/_bundled_plugin/scripts/workbench_validation.py +9 -2
- package/_bundled_plugin/shared/workbench-history-repairs.json +21 -0
- package/_bundled_plugin/shared/workbench-migrations.json +44 -0
- package/_bundled_plugin/skills/assess-patch-risk/SKILL.md +3 -14
- package/_bundled_plugin/skills/assess-patch-risk/references/windows-validation.md +14 -0
- package/_bundled_plugin/skills/attack-path-analysis/SKILL.md +38 -103
- package/_bundled_plugin/skills/attack-path-analysis/references/attack-path-facts.md +11 -73
- package/_bundled_plugin/skills/attack-path-analysis/references/severity-policy.md +57 -116
- package/_bundled_plugin/skills/deep-security-scan/SKILL.md +28 -51
- package/_bundled_plugin/skills/define-security-policy/SKILL.md +9 -9
- package/_bundled_plugin/skills/finding-discovery/SKILL.md +26 -140
- package/_bundled_plugin/skills/fix-finding/SKILL.md +19 -30
- package/_bundled_plugin/skills/propose-security-hardening/SKILL.md +28 -218
- package/_bundled_plugin/skills/propose-security-hardening/references/proposal-format.md +29 -424
- package/_bundled_plugin/skills/publish-findings/SKILL.md +134 -0
- package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +6 -0
- package/_bundled_plugin/skills/publish-findings/references/wiz-import.md +64 -0
- package/_bundled_plugin/skills/security-diff-scan/SKILL.md +12 -12
- package/_bundled_plugin/skills/security-scan/SKILL.md +28 -16
- package/_bundled_plugin/skills/security-scan/references/desktop-scan.md +11 -17
- package/_bundled_plugin/skills/security-scan/references/scan-artifacts-and-ledger.md +52 -69
- package/_bundled_plugin/skills/threat-model/SKILL.md +16 -9
- package/_bundled_plugin/skills/triage-finding/SKILL.md +5 -15
- package/_bundled_plugin/skills/triage-finding/references/ticket-intake.md +6 -6
- package/_bundled_plugin/skills/validation/SKILL.md +42 -104
- package/_bundled_plugin/skills/validation/references/validation-guidance.md +21 -106
- package/_bundled_plugin/skills/verify-fix/SKILL.md +8 -4
- package/_bundled_plugin/skills/vulnerability-writeup/SKILL.md +21 -159
- package/_bundled_plugin/skills/vulnerability-writeup/references/report-format.md +18 -60
- package/dist/api.d.ts +8 -3
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +414 -72
- package/dist/api.js.map +1 -1
- package/dist/auth.d.ts.map +1 -1
- package/dist/auth.js +4 -1
- package/dist/auth.js.map +1 -1
- package/dist/classify-severity-records.d.ts +5 -2
- package/dist/classify-severity-records.d.ts.map +1 -1
- package/dist/classify-severity-records.js +40 -34
- package/dist/classify-severity-records.js.map +1 -1
- package/dist/classify-severity.d.ts +5 -1
- package/dist/classify-severity.d.ts.map +1 -1
- package/dist/classify-severity.js +20 -30
- package/dist/classify-severity.js.map +1 -1
- package/dist/cli-help.d.ts.map +1 -1
- package/dist/cli-help.js +1 -0
- package/dist/cli-help.js.map +1 -1
- package/dist/cli.d.ts +9 -2
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +802 -149
- package/dist/cli.js.map +1 -1
- package/dist/cloud-endpoint.d.ts +6 -0
- package/dist/cloud-endpoint.d.ts.map +1 -0
- package/dist/cloud-endpoint.js +51 -0
- package/dist/cloud-endpoint.js.map +1 -0
- package/dist/cloud-publish.d.ts.map +1 -1
- package/dist/cloud-publish.js +7 -5
- package/dist/cloud-publish.js.map +1 -1
- package/dist/component-scan.d.ts +8 -2
- package/dist/component-scan.d.ts.map +1 -1
- package/dist/component-scan.js +2 -0
- package/dist/component-scan.js.map +1 -1
- package/dist/contract.d.ts +2 -0
- package/dist/contract.d.ts.map +1 -1
- package/dist/contract.js +67 -33
- package/dist/contract.js.map +1 -1
- package/dist/cost.d.ts +18 -0
- package/dist/cost.d.ts.map +1 -1
- package/dist/cost.js +107 -12
- package/dist/cost.js.map +1 -1
- package/dist/coverage-presentation.d.ts +6 -0
- package/dist/coverage-presentation.d.ts.map +1 -0
- package/dist/coverage-presentation.js +34 -0
- package/dist/coverage-presentation.js.map +1 -0
- package/dist/custom-validation-prompt.js +3 -3
- package/dist/custom-validation-prompt.js.map +1 -1
- package/dist/custom-validation.d.ts.map +1 -1
- package/dist/custom-validation.js +30 -4
- package/dist/custom-validation.js.map +1 -1
- package/dist/deduplication/checkpointed-review.d.ts.map +1 -1
- package/dist/deduplication/checkpointed-review.js +3 -1
- package/dist/deduplication/checkpointed-review.js.map +1 -1
- package/dist/deduplication/scan.d.ts.map +1 -1
- package/dist/deduplication/scan.js +7 -5
- package/dist/deduplication/scan.js.map +1 -1
- package/dist/default-severity-rubric.d.ts +3 -0
- package/dist/default-severity-rubric.d.ts.map +1 -0
- package/dist/default-severity-rubric.js +67 -0
- package/dist/default-severity-rubric.js.map +1 -0
- package/dist/endor-findings.d.ts +8 -0
- package/dist/endor-findings.d.ts.map +1 -0
- package/dist/endor-findings.js +238 -0
- package/dist/endor-findings.js.map +1 -0
- package/dist/external-findings-import.d.ts +5 -0
- package/dist/external-findings-import.d.ts.map +1 -0
- package/dist/external-findings-import.js +46 -0
- package/dist/external-findings-import.js.map +1 -0
- package/dist/external-findings-local.d.ts +63 -0
- package/dist/external-findings-local.d.ts.map +1 -0
- package/dist/external-findings-local.js +344 -0
- package/dist/external-findings-local.js.map +1 -0
- package/dist/external-findings-publish.d.ts +73 -0
- package/dist/external-findings-publish.d.ts.map +1 -0
- package/dist/external-findings-publish.js +721 -0
- package/dist/external-findings-publish.js.map +1 -0
- package/dist/external-findings-read.d.ts +16 -0
- package/dist/external-findings-read.d.ts.map +1 -0
- package/dist/external-findings-read.js +97 -0
- package/dist/external-findings-read.js.map +1 -0
- package/dist/external-findings.d.ts +21 -0
- package/dist/external-findings.d.ts.map +1 -0
- package/dist/external-findings.js +2 -0
- package/dist/external-findings.js.map +1 -0
- package/dist/external-import-contract.d.ts +15 -0
- package/dist/external-import-contract.d.ts.map +1 -0
- package/dist/external-import-contract.js +262 -0
- package/dist/external-import-contract.js.map +1 -0
- package/dist/external-import-models.d.ts +362 -0
- package/dist/external-import-models.d.ts.map +1 -0
- package/dist/external-import-models.js +3 -0
- package/dist/external-import-models.js.map +1 -0
- package/dist/external-imports-feature.d.ts +6 -0
- package/dist/external-imports-feature.d.ts.map +1 -0
- package/dist/external-imports-feature.js +51 -0
- package/dist/external-imports-feature.js.map +1 -0
- package/dist/finding-workflow.d.ts +23 -6
- package/dist/finding-workflow.d.ts.map +1 -1
- package/dist/finding-workflow.js +23 -10
- package/dist/finding-workflow.js.map +1 -1
- package/dist/github-advisories.d.ts +386 -0
- package/dist/github-advisories.d.ts.map +1 -0
- package/dist/github-advisories.js +133 -0
- package/dist/github-advisories.js.map +1 -0
- package/dist/github-findings.d.ts +11 -0
- package/dist/github-findings.d.ts.map +1 -0
- package/dist/github-findings.js +258 -0
- package/dist/github-findings.js.map +1 -0
- package/dist/hosted-remediation-protocol.d.ts +2 -1
- package/dist/hosted-remediation-protocol.d.ts.map +1 -1
- package/dist/hosted-remediation-protocol.js +17 -11
- package/dist/hosted-remediation-protocol.js.map +1 -1
- package/dist/hosted-remediation.d.ts +4 -0
- package/dist/hosted-remediation.d.ts.map +1 -1
- package/dist/hosted-remediation.js +22 -3
- package/dist/hosted-remediation.js.map +1 -1
- package/dist/hosted-scan.d.ts +16 -0
- package/dist/hosted-scan.d.ts.map +1 -1
- package/dist/hosted-scan.js +9 -2
- package/dist/hosted-scan.js.map +1 -1
- package/dist/import-scan.js +1 -1
- package/dist/import-scan.js.map +1 -1
- package/dist/index.d.ts +16 -3
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +9 -1
- package/dist/index.js.map +1 -1
- package/dist/knowledge-base.d.ts +1 -0
- package/dist/knowledge-base.d.ts.map +1 -1
- package/dist/knowledge-base.js +17 -8
- package/dist/knowledge-base.js.map +1 -1
- package/dist/models.d.ts +1 -0
- package/dist/models.d.ts.map +1 -1
- package/dist/models.js.map +1 -1
- package/dist/owner-evidence.d.ts +2 -0
- package/dist/owner-evidence.d.ts.map +1 -1
- package/dist/owner-evidence.js +2 -1
- package/dist/owner-evidence.js.map +1 -1
- package/dist/project-config-schema.d.ts +2 -0
- package/dist/project-config-schema.d.ts.map +1 -1
- package/dist/project-config-schema.js +1 -0
- package/dist/project-config-schema.js.map +1 -1
- package/dist/project-config.d.ts +1 -0
- package/dist/project-config.d.ts.map +1 -1
- package/dist/project-config.js +2 -0
- package/dist/project-config.js.map +1 -1
- package/dist/publish.d.ts +2 -0
- package/dist/publish.d.ts.map +1 -1
- package/dist/publish.js +1 -1
- package/dist/publish.js.map +1 -1
- package/dist/remediation.d.ts +7 -25
- package/dist/remediation.d.ts.map +1 -1
- package/dist/remediation.js +18 -28
- package/dist/remediation.js.map +1 -1
- package/dist/result.d.ts +4 -0
- package/dist/result.d.ts.map +1 -1
- package/dist/result.js +10 -0
- package/dist/result.js.map +1 -1
- package/dist/runtime.d.ts +1 -0
- package/dist/runtime.d.ts.map +1 -1
- package/dist/runtime.js +10 -8
- package/dist/runtime.js.map +1 -1
- package/dist/scan-dashboard.d.ts +5 -3
- package/dist/scan-dashboard.d.ts.map +1 -1
- package/dist/scan-dashboard.js +79 -26
- package/dist/scan-dashboard.js.map +1 -1
- package/dist/scan-history-renderer.d.ts.map +1 -1
- package/dist/scan-history-renderer.js +8 -2
- package/dist/scan-history-renderer.js.map +1 -1
- package/dist/scan-owner-suggestions.d.ts +8 -0
- package/dist/scan-owner-suggestions.d.ts.map +1 -0
- package/dist/scan-owner-suggestions.js +33 -0
- package/dist/scan-owner-suggestions.js.map +1 -0
- package/dist/scan-settings.d.ts +1 -0
- package/dist/scan-settings.d.ts.map +1 -1
- package/dist/scan-settings.js +4 -0
- package/dist/scan-settings.js.map +1 -1
- package/dist/scan-usage-display.d.ts +8 -0
- package/dist/scan-usage-display.d.ts.map +1 -0
- package/dist/scan-usage-display.js +46 -0
- package/dist/scan-usage-display.js.map +1 -0
- package/dist/scanner-import.d.ts +20 -0
- package/dist/scanner-import.d.ts.map +1 -0
- package/dist/scanner-import.js +208 -0
- package/dist/scanner-import.js.map +1 -0
- package/dist/security-policy-diff.d.ts +2 -0
- package/dist/security-policy-diff.d.ts.map +1 -0
- package/dist/security-policy-diff.js +197 -0
- package/dist/security-policy-diff.js.map +1 -0
- package/dist/security-policy.d.ts +7 -3
- package/dist/security-policy.d.ts.map +1 -1
- package/dist/security-policy.js +11 -76
- package/dist/security-policy.js.map +1 -1
- package/dist/semgrep-findings.d.ts +10 -0
- package/dist/semgrep-findings.d.ts.map +1 -0
- package/dist/semgrep-findings.js +293 -0
- package/dist/semgrep-findings.js.map +1 -0
- package/dist/severity-review.d.ts +3 -0
- package/dist/severity-review.d.ts.map +1 -1
- package/dist/severity-review.js +19 -0
- package/dist/severity-review.js.map +1 -1
- package/dist/severity-store.js +7 -2
- package/dist/severity-store.js.map +1 -1
- package/dist/skill-authentication.d.ts +18 -0
- package/dist/skill-authentication.d.ts.map +1 -0
- package/dist/skill-authentication.js +82 -0
- package/dist/skill-authentication.js.map +1 -0
- package/dist/snyk-findings.d.ts +10 -0
- package/dist/snyk-findings.d.ts.map +1 -0
- package/dist/snyk-findings.js +350 -0
- package/dist/snyk-findings.js.map +1 -0
- package/dist/suggest-owners.d.ts +4 -1
- package/dist/suggest-owners.d.ts.map +1 -1
- package/dist/suggest-owners.js +53 -21
- package/dist/suggest-owners.js.map +1 -1
- package/dist/targets.d.ts +2 -2
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +16 -3
- package/dist/targets.js.map +1 -1
- package/dist/wiz-csv.d.ts +9 -0
- package/dist/wiz-csv.d.ts.map +1 -0
- package/dist/wiz-csv.js +116 -0
- package/dist/wiz-csv.js.map +1 -0
- package/dist/wiz-findings.d.ts +5 -0
- package/dist/wiz-findings.d.ts.map +1 -0
- package/dist/wiz-findings.js +464 -0
- package/dist/wiz-findings.js.map +1 -0
- package/docs/classify-severity-records.md +30 -13
- package/docs/cli.md +835 -47
- package/docs/findings-service.md +119 -118
- package/docs/hosted-remediation.md +43 -24
- package/docs/hosted-scans.md +38 -0
- package/package.json +11 -9
- package/schemas/external-findings.schema.json +1421 -0
- package/schemas/project-config.schema.json +4 -0
- package/_bundled_plugin/scripts/generate_in_scope_files.py +0 -277
- package/_bundled_plugin/scripts/generate_rank_input.py +0 -350
- package/_bundled_plugin/scripts/rank_preview.py +0 -129
|
@@ -0,0 +1,208 @@
|
|
|
1
|
+
import { hash } from "node:crypto";
|
|
2
|
+
import { readFile } from "node:fs/promises";
|
|
3
|
+
import { promisify } from "node:util";
|
|
4
|
+
import { gunzip } from "node:zlib";
|
|
5
|
+
import { CodexSecurityError, errorMessage } from "./errors.js";
|
|
6
|
+
import { isRecord } from "./record.js";
|
|
7
|
+
export function record(value, label) {
|
|
8
|
+
if (!value || typeof value !== "object" || Array.isArray(value))
|
|
9
|
+
throw new Error(`${label} must be an object.`);
|
|
10
|
+
return value;
|
|
11
|
+
}
|
|
12
|
+
export function array(value, label) {
|
|
13
|
+
if (!Array.isArray(value))
|
|
14
|
+
throw new Error(`${label} must be an array.`);
|
|
15
|
+
return value;
|
|
16
|
+
}
|
|
17
|
+
export function text(value) {
|
|
18
|
+
return typeof value === "string" && value.trim() ? value : null;
|
|
19
|
+
}
|
|
20
|
+
export function requiredText(value, label) {
|
|
21
|
+
const result = text(value);
|
|
22
|
+
if (!result)
|
|
23
|
+
throw new Error(`${label} must be nonempty text.`);
|
|
24
|
+
return result;
|
|
25
|
+
}
|
|
26
|
+
export function strings(value) {
|
|
27
|
+
return Array.isArray(value)
|
|
28
|
+
? value.filter((v) => text(v) !== null)
|
|
29
|
+
: [];
|
|
30
|
+
}
|
|
31
|
+
/** Paths that cannot be attributed to a repository stay in original evidence. */
|
|
32
|
+
export function relativePath(value) {
|
|
33
|
+
const path = text(value)?.replaceAll("\\", "/");
|
|
34
|
+
return path &&
|
|
35
|
+
!path.startsWith("/") &&
|
|
36
|
+
!path.includes("\0") &&
|
|
37
|
+
!/^[A-Za-z]:/.test(path) &&
|
|
38
|
+
!path.split("/").includes("..")
|
|
39
|
+
? path
|
|
40
|
+
: null;
|
|
41
|
+
}
|
|
42
|
+
export function stableId(prefix, fields) {
|
|
43
|
+
return `${prefix}:${hash("sha256", JSON.stringify(fields))}`;
|
|
44
|
+
}
|
|
45
|
+
/** Detect gzip from the report bytes and preserve identities with strict UTF-8. */
|
|
46
|
+
export async function readScannerText(path) {
|
|
47
|
+
let bytes = await readFile(path);
|
|
48
|
+
if (bytes[0] === 0x1f && bytes[1] === 0x8b)
|
|
49
|
+
bytes = await promisify(gunzip)(bytes);
|
|
50
|
+
return new TextDecoder("utf-8", { fatal: true }).decode(bytes);
|
|
51
|
+
}
|
|
52
|
+
export function parseJsonOrJsonl(contents) {
|
|
53
|
+
try {
|
|
54
|
+
return JSON.parse(contents);
|
|
55
|
+
}
|
|
56
|
+
catch {
|
|
57
|
+
return contents
|
|
58
|
+
.split(/\r?\n/u)
|
|
59
|
+
.filter((line) => line.trim())
|
|
60
|
+
.map((line) => JSON.parse(line));
|
|
61
|
+
}
|
|
62
|
+
}
|
|
63
|
+
export async function readScannerJson(path) {
|
|
64
|
+
let bytes = await readFile(path);
|
|
65
|
+
if (bytes[0] === 0x1f && bytes[1] === 0x8b)
|
|
66
|
+
bytes = await promisify(gunzip)(bytes);
|
|
67
|
+
let decoded;
|
|
68
|
+
try {
|
|
69
|
+
decoded = new TextDecoder("utf-8", { fatal: true }).decode(bytes);
|
|
70
|
+
}
|
|
71
|
+
catch (error) {
|
|
72
|
+
throw new CodexSecurityError(`Scanner report is not valid UTF-8. ${errorMessage(error)}`, { cause: error });
|
|
73
|
+
}
|
|
74
|
+
try {
|
|
75
|
+
return JSON.parse(decoded.replace(/^\uFEFF/u, ""));
|
|
76
|
+
}
|
|
77
|
+
catch (error) {
|
|
78
|
+
throw new CodexSecurityError(`Scanner JSON could not be parsed. ${errorMessage(error)}`, { cause: error });
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
/** Empty reference containers and property-bag metadata do not externalize data. */
|
|
82
|
+
export function hasSarifExternalPropertyReferences(value) {
|
|
83
|
+
if (value == null)
|
|
84
|
+
return false;
|
|
85
|
+
return Object.entries(record(value, "SARIF external property references")).some(([key, references]) => key !== "properties" &&
|
|
86
|
+
(!Array.isArray(references) || references.length > 0));
|
|
87
|
+
}
|
|
88
|
+
const sarifArtifactLocationFields = new Set([
|
|
89
|
+
"artifactLocation",
|
|
90
|
+
"analysisTarget",
|
|
91
|
+
"executableLocation",
|
|
92
|
+
"workingDirectory",
|
|
93
|
+
"stdin",
|
|
94
|
+
"stdout",
|
|
95
|
+
"stderr",
|
|
96
|
+
"stdoutStderr",
|
|
97
|
+
"mappedTo",
|
|
98
|
+
"displayBase",
|
|
99
|
+
]);
|
|
100
|
+
/** Keep original artifact indexes; omit only inventory unrelated to this finding. */
|
|
101
|
+
export function sarifRunContextForResult(runContext, ...selectedEvidence) {
|
|
102
|
+
const { artifacts, ...context } = runContext;
|
|
103
|
+
if (!Array.isArray(artifacts) || artifacts.length === 0)
|
|
104
|
+
return runContext;
|
|
105
|
+
const locations = [];
|
|
106
|
+
let hasArtifactLink = false;
|
|
107
|
+
function visit(value) {
|
|
108
|
+
if (typeof value === "string") {
|
|
109
|
+
// SARIF message links can refer to an artifact without an artifactLocation.
|
|
110
|
+
if (/sarif:/iu.test(value))
|
|
111
|
+
hasArtifactLink = true;
|
|
112
|
+
}
|
|
113
|
+
else if (Array.isArray(value))
|
|
114
|
+
value.forEach(visit);
|
|
115
|
+
else if (isRecord(value))
|
|
116
|
+
for (const [key, child] of Object.entries(value)) {
|
|
117
|
+
if (key === "properties")
|
|
118
|
+
continue;
|
|
119
|
+
if (sarifArtifactLocationFields.has(key) && isRecord(child))
|
|
120
|
+
locations.push(child);
|
|
121
|
+
if (["locations", "responseFiles", "analysisToolLogFiles"].includes(key) &&
|
|
122
|
+
Array.isArray(child))
|
|
123
|
+
locations.push(...child.filter(isRecord));
|
|
124
|
+
if (key === "originalUriBaseIds" && isRecord(child))
|
|
125
|
+
locations.push(...Object.values(child).filter(isRecord));
|
|
126
|
+
visit(child);
|
|
127
|
+
}
|
|
128
|
+
}
|
|
129
|
+
visit([context, ...selectedEvidence]);
|
|
130
|
+
if (hasArtifactLink)
|
|
131
|
+
return runContext;
|
|
132
|
+
const unresolvedUri = /[%:\\]|(?:^|\/)\.\.?(?:\/|$)/u;
|
|
133
|
+
for (const location of locations) {
|
|
134
|
+
if (typeof location["index"] === "number" && location["index"] >= 0)
|
|
135
|
+
return runContext;
|
|
136
|
+
if (typeof location["uri"] !== "string")
|
|
137
|
+
continue;
|
|
138
|
+
for (const artifact of artifacts) {
|
|
139
|
+
if (!isRecord(artifact) || !isRecord(artifact["location"]))
|
|
140
|
+
continue;
|
|
141
|
+
const candidate = artifact["location"];
|
|
142
|
+
// Keep URI spellings that need resolution; evidence is never rewritten.
|
|
143
|
+
if (location["uriBaseId"] !== candidate["uriBaseId"] ||
|
|
144
|
+
unresolvedUri.test(location["uri"]) ||
|
|
145
|
+
(typeof candidate["uri"] === "string" &&
|
|
146
|
+
unresolvedUri.test(candidate["uri"])) ||
|
|
147
|
+
location["uri"] === candidate["uri"])
|
|
148
|
+
return runContext;
|
|
149
|
+
}
|
|
150
|
+
}
|
|
151
|
+
return context;
|
|
152
|
+
}
|
|
153
|
+
/** Exclude every colliding record: choosing the first could overwrite another occurrence. */
|
|
154
|
+
export function normalizeRecords(records, normalize, identify, target = "cloud") {
|
|
155
|
+
const result = {
|
|
156
|
+
read: records.length,
|
|
157
|
+
findings: [],
|
|
158
|
+
excluded: [],
|
|
159
|
+
};
|
|
160
|
+
const identified = [];
|
|
161
|
+
const counts = new Map();
|
|
162
|
+
for (const [index, value] of records.entries()) {
|
|
163
|
+
try {
|
|
164
|
+
const id = identify(value);
|
|
165
|
+
if (!id.trim() ||
|
|
166
|
+
id.includes("\0") ||
|
|
167
|
+
(target === "cloud" && Buffer.byteLength(id) > 512))
|
|
168
|
+
throw new Error(target === "cloud"
|
|
169
|
+
? "Source finding ID must contain 1–512 UTF-8 bytes and no NUL characters."
|
|
170
|
+
: "Source finding ID must be nonempty and contain no NUL characters.");
|
|
171
|
+
identified.push({ position: index + 1, value, id });
|
|
172
|
+
counts.set(id, (counts.get(id) ?? 0) + 1);
|
|
173
|
+
}
|
|
174
|
+
catch (error) {
|
|
175
|
+
result.excluded.push({
|
|
176
|
+
position: index + 1,
|
|
177
|
+
source_finding_id: null,
|
|
178
|
+
reason: errorMessage(error),
|
|
179
|
+
});
|
|
180
|
+
}
|
|
181
|
+
}
|
|
182
|
+
for (const { position, value, id } of identified) {
|
|
183
|
+
if (counts.get(id) > 1) {
|
|
184
|
+
result.excluded.push({
|
|
185
|
+
position,
|
|
186
|
+
source_finding_id: id,
|
|
187
|
+
reason: "Ambiguous duplicate source identity; select one complete finding or separate source projects.",
|
|
188
|
+
});
|
|
189
|
+
continue;
|
|
190
|
+
}
|
|
191
|
+
try {
|
|
192
|
+
const finding = normalize(value, id);
|
|
193
|
+
if (finding.source_finding_id !== id)
|
|
194
|
+
throw new Error("Finding identity changed during normalization.");
|
|
195
|
+
result.findings.push(finding);
|
|
196
|
+
}
|
|
197
|
+
catch (error) {
|
|
198
|
+
result.excluded.push({
|
|
199
|
+
position,
|
|
200
|
+
source_finding_id: id,
|
|
201
|
+
reason: errorMessage(error),
|
|
202
|
+
});
|
|
203
|
+
}
|
|
204
|
+
}
|
|
205
|
+
result.excluded.sort((a, b) => a.position - b.position);
|
|
206
|
+
return result;
|
|
207
|
+
}
|
|
208
|
+
//# sourceMappingURL=scanner-import.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"scanner-import.js","sourceRoot":"","sources":["../src/scanner-import.ts"],"names":[],"mappings":"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","sourcesContent":["import { hash } from \"node:crypto\";\nimport { readFile } from \"node:fs/promises\";\nimport { promisify } from \"node:util\";\nimport { gunzip } from \"node:zlib\";\nimport { CodexSecurityError, errorMessage } from \"./errors.js\";\nimport type { ExternalFinding, ExternalFindings } from \"./external-findings.js\";\nimport { isRecord } from \"./record.js\";\n\nexport function record(value: unknown, label: string): Record<string, unknown> {\n if (!value || typeof value !== \"object\" || Array.isArray(value))\n throw new Error(`${label} must be an object.`);\n return value as Record<string, unknown>;\n}\n\nexport function array(value: unknown, label: string): unknown[] {\n if (!Array.isArray(value)) throw new Error(`${label} must be an array.`);\n return value;\n}\n\nexport function text(value: unknown): string | null {\n return typeof value === \"string\" && value.trim() ? value : null;\n}\n\nexport function requiredText(value: unknown, label: string): string {\n const result = text(value);\n if (!result) throw new Error(`${label} must be nonempty text.`);\n return result;\n}\n\nexport function strings(value: unknown): string[] {\n return Array.isArray(value)\n ? value.filter((v): v is string => text(v) !== null)\n : [];\n}\n\n/** Paths that cannot be attributed to a repository stay in original evidence. */\nexport function relativePath(value: unknown): string | null {\n const path = text(value)?.replaceAll(\"\\\\\", \"/\");\n return path &&\n !path.startsWith(\"/\") &&\n !path.includes(\"\\0\") &&\n !/^[A-Za-z]:/.test(path) &&\n !path.split(\"/\").includes(\"..\")\n ? path\n : null;\n}\n\nexport function stableId(prefix: string, fields: unknown[]): string {\n return `${prefix}:${hash(\"sha256\", JSON.stringify(fields))}`;\n}\n\n/** Detect gzip from the report bytes and preserve identities with strict UTF-8. */\nexport async function readScannerText(path: string): Promise<string> {\n let bytes = await readFile(path);\n if (bytes[0] === 0x1f && bytes[1] === 0x8b)\n bytes = await promisify(gunzip)(bytes);\n return new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes);\n}\n\nexport function parseJsonOrJsonl(contents: string): unknown {\n try {\n return JSON.parse(contents);\n } catch {\n return contents\n .split(/\\r?\\n/u)\n .filter((line) => line.trim())\n .map((line) => JSON.parse(line));\n }\n}\n\nexport async function readScannerJson(path: string): Promise<unknown> {\n let bytes = await readFile(path);\n if (bytes[0] === 0x1f && bytes[1] === 0x8b)\n bytes = await promisify(gunzip)(bytes);\n let decoded: string;\n try {\n decoded = new TextDecoder(\"utf-8\", { fatal: true }).decode(bytes);\n } catch (error) {\n throw new CodexSecurityError(\n `Scanner report is not valid UTF-8. ${errorMessage(error)}`,\n { cause: error },\n );\n }\n try {\n return JSON.parse(decoded.replace(/^\\uFEFF/u, \"\"));\n } catch (error) {\n throw new CodexSecurityError(\n `Scanner JSON could not be parsed. ${errorMessage(error)}`,\n { cause: error },\n );\n }\n}\n\n/** Empty reference containers and property-bag metadata do not externalize data. */\nexport function hasSarifExternalPropertyReferences(value: unknown): boolean {\n if (value == null) return false;\n return Object.entries(\n record(value, \"SARIF external property references\"),\n ).some(\n ([key, references]) =>\n key !== \"properties\" &&\n (!Array.isArray(references) || references.length > 0),\n );\n}\n\nconst sarifArtifactLocationFields = new Set([\n \"artifactLocation\",\n \"analysisTarget\",\n \"executableLocation\",\n \"workingDirectory\",\n \"stdin\",\n \"stdout\",\n \"stderr\",\n \"stdoutStderr\",\n \"mappedTo\",\n \"displayBase\",\n]);\n\n/** Keep original artifact indexes; omit only inventory unrelated to this finding. */\nexport function sarifRunContextForResult(\n runContext: Record<string, unknown>,\n ...selectedEvidence: unknown[]\n): Record<string, unknown> {\n const { artifacts, ...context } = runContext;\n if (!Array.isArray(artifacts) || artifacts.length === 0) return runContext;\n const locations: Record<string, unknown>[] = [];\n let hasArtifactLink = false;\n function visit(value: unknown): void {\n if (typeof value === \"string\") {\n // SARIF message links can refer to an artifact without an artifactLocation.\n if (/sarif:/iu.test(value)) hasArtifactLink = true;\n } else if (Array.isArray(value)) value.forEach(visit);\n else if (isRecord(value))\n for (const [key, child] of Object.entries(value)) {\n if (key === \"properties\") continue;\n if (sarifArtifactLocationFields.has(key) && isRecord(child))\n locations.push(child);\n if (\n [\"locations\", \"responseFiles\", \"analysisToolLogFiles\"].includes(\n key,\n ) &&\n Array.isArray(child)\n )\n locations.push(...child.filter(isRecord));\n if (key === \"originalUriBaseIds\" && isRecord(child))\n locations.push(...Object.values(child).filter(isRecord));\n visit(child);\n }\n }\n visit([context, ...selectedEvidence]);\n if (hasArtifactLink) return runContext;\n const unresolvedUri = /[%:\\\\]|(?:^|\\/)\\.\\.?(?:\\/|$)/u;\n for (const location of locations) {\n if (typeof location[\"index\"] === \"number\" && location[\"index\"] >= 0)\n return runContext;\n if (typeof location[\"uri\"] !== \"string\") continue;\n for (const artifact of artifacts) {\n if (!isRecord(artifact) || !isRecord(artifact[\"location\"])) continue;\n const candidate = artifact[\"location\"];\n // Keep URI spellings that need resolution; evidence is never rewritten.\n if (\n location[\"uriBaseId\"] !== candidate[\"uriBaseId\"] ||\n unresolvedUri.test(location[\"uri\"]) ||\n (typeof candidate[\"uri\"] === \"string\" &&\n unresolvedUri.test(candidate[\"uri\"])) ||\n location[\"uri\"] === candidate[\"uri\"]\n )\n return runContext;\n }\n }\n return context;\n}\n\n/** Exclude every colliding record: choosing the first could overwrite another occurrence. */\nexport function normalizeRecords<T>(\n records: T[],\n normalize: (record: T, id: string) => ExternalFinding,\n identify: (record: T) => string,\n target: \"local\" | \"cloud\" = \"cloud\",\n): ExternalFindings {\n const result: ExternalFindings = {\n read: records.length,\n findings: [],\n excluded: [],\n };\n const identified: { position: number; value: T; id: string }[] = [];\n const counts = new Map<string, number>();\n for (const [index, value] of records.entries()) {\n try {\n const id = identify(value);\n if (\n !id.trim() ||\n id.includes(\"\\0\") ||\n (target === \"cloud\" && Buffer.byteLength(id) > 512)\n )\n throw new Error(\n target === \"cloud\"\n ? \"Source finding ID must contain 1–512 UTF-8 bytes and no NUL characters.\"\n : \"Source finding ID must be nonempty and contain no NUL characters.\",\n );\n identified.push({ position: index + 1, value, id });\n counts.set(id, (counts.get(id) ?? 0) + 1);\n } catch (error) {\n result.excluded.push({\n position: index + 1,\n source_finding_id: null,\n reason: errorMessage(error),\n });\n }\n }\n for (const { position, value, id } of identified) {\n if (counts.get(id)! > 1) {\n result.excluded.push({\n position,\n source_finding_id: id,\n reason:\n \"Ambiguous duplicate source identity; select one complete finding or separate source projects.\",\n });\n continue;\n }\n try {\n const finding = normalize(value, id);\n if (finding.source_finding_id !== id)\n throw new Error(\"Finding identity changed during normalization.\");\n result.findings.push(finding);\n } catch (error) {\n result.excluded.push({\n position,\n source_finding_id: id,\n reason: errorMessage(error),\n });\n }\n }\n result.excluded.sort((a, b) => a.position - b.position);\n return result;\n}\n"]}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"security-policy-diff.d.ts","sourceRoot":"","sources":["../src/security-policy-diff.ts"],"names":[],"mappings":"AAoMA,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,MAAM,EACb,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,WAAW,GACnB,OAAO,CAAC,MAAM,CAAC,CAWjB"}
|
|
@@ -0,0 +1,197 @@
|
|
|
1
|
+
import { setImmediate } from "node:timers/promises";
|
|
2
|
+
function* lines(text) {
|
|
3
|
+
const result = [];
|
|
4
|
+
let start = 0;
|
|
5
|
+
for (let end = 0; end < text.length; end++) {
|
|
6
|
+
if (text.charCodeAt(end) === 10) {
|
|
7
|
+
result.push(text.slice(start, end + 1));
|
|
8
|
+
start = end + 1;
|
|
9
|
+
}
|
|
10
|
+
yield;
|
|
11
|
+
}
|
|
12
|
+
if (start < text.length)
|
|
13
|
+
result.push(text.slice(start));
|
|
14
|
+
return result;
|
|
15
|
+
}
|
|
16
|
+
// Match Python's SequenceMatcher(None, a, b), including its default autojunk
|
|
17
|
+
// heuristic. A different longest-common-subsequence algorithm changes the diff.
|
|
18
|
+
function* matchingBlocks(a, b) {
|
|
19
|
+
const positions = new Map();
|
|
20
|
+
for (let j = 0; j < b.length; j++) {
|
|
21
|
+
const line = b[j];
|
|
22
|
+
const indices = positions.get(line);
|
|
23
|
+
if (indices)
|
|
24
|
+
indices.push(j);
|
|
25
|
+
else
|
|
26
|
+
positions.set(line, [j]);
|
|
27
|
+
yield;
|
|
28
|
+
}
|
|
29
|
+
if (b.length >= 200) {
|
|
30
|
+
const threshold = Math.floor(b.length / 100) + 1;
|
|
31
|
+
for (const [line, indices] of positions) {
|
|
32
|
+
if (indices.length > threshold)
|
|
33
|
+
positions.delete(line);
|
|
34
|
+
yield;
|
|
35
|
+
}
|
|
36
|
+
}
|
|
37
|
+
const pending = [[0, a.length, 0, b.length]];
|
|
38
|
+
const matches = [];
|
|
39
|
+
while (pending.length) {
|
|
40
|
+
const range = pending.pop();
|
|
41
|
+
if (range.length === 3) {
|
|
42
|
+
const previous = matches.at(-1);
|
|
43
|
+
if (previous &&
|
|
44
|
+
previous[0] + previous[2] === range[0] &&
|
|
45
|
+
previous[1] + previous[2] === range[1]) {
|
|
46
|
+
previous[2] += range[2];
|
|
47
|
+
}
|
|
48
|
+
else {
|
|
49
|
+
matches.push(range);
|
|
50
|
+
}
|
|
51
|
+
yield;
|
|
52
|
+
continue;
|
|
53
|
+
}
|
|
54
|
+
const [alo, ahi, blo, bhi] = range;
|
|
55
|
+
let bestA = alo;
|
|
56
|
+
let bestB = blo;
|
|
57
|
+
let size = 0;
|
|
58
|
+
let lengths = new Map();
|
|
59
|
+
for (let i = alo; i < ahi; i++) {
|
|
60
|
+
const next = new Map();
|
|
61
|
+
for (const j of positions.get(a[i]) ?? []) {
|
|
62
|
+
yield;
|
|
63
|
+
if (j < blo)
|
|
64
|
+
continue;
|
|
65
|
+
if (j >= bhi)
|
|
66
|
+
break;
|
|
67
|
+
const length = (lengths.get(j - 1) ?? 0) + 1;
|
|
68
|
+
next.set(j, length);
|
|
69
|
+
if (length > size) {
|
|
70
|
+
bestA = i - length + 1;
|
|
71
|
+
bestB = j - length + 1;
|
|
72
|
+
size = length;
|
|
73
|
+
}
|
|
74
|
+
}
|
|
75
|
+
lengths = next;
|
|
76
|
+
yield;
|
|
77
|
+
}
|
|
78
|
+
// Popular lines may extend a match, even though they cannot anchor one.
|
|
79
|
+
while (bestA > alo && bestB > blo && a[bestA - 1] === b[bestB - 1]) {
|
|
80
|
+
bestA--;
|
|
81
|
+
bestB--;
|
|
82
|
+
size++;
|
|
83
|
+
yield;
|
|
84
|
+
}
|
|
85
|
+
while (bestA + size < ahi &&
|
|
86
|
+
bestB + size < bhi &&
|
|
87
|
+
a[bestA + size] === b[bestB + size]) {
|
|
88
|
+
size++;
|
|
89
|
+
yield;
|
|
90
|
+
}
|
|
91
|
+
if (size) {
|
|
92
|
+
// Visit matches in order, avoiding a blocking sort of the result.
|
|
93
|
+
if (bestA + size < ahi && bestB + size < bhi) {
|
|
94
|
+
pending.push([bestA + size, ahi, bestB + size, bhi]);
|
|
95
|
+
}
|
|
96
|
+
pending.push([bestA, bestB, size]);
|
|
97
|
+
if (alo < bestA && blo < bestB) {
|
|
98
|
+
pending.push([alo, bestA, blo, bestB]);
|
|
99
|
+
}
|
|
100
|
+
}
|
|
101
|
+
yield;
|
|
102
|
+
}
|
|
103
|
+
matches.push([a.length, b.length, 0]);
|
|
104
|
+
return matches;
|
|
105
|
+
}
|
|
106
|
+
function formatRange(start, end) {
|
|
107
|
+
const length = end - start;
|
|
108
|
+
return length === 1
|
|
109
|
+
? String(start + 1)
|
|
110
|
+
: `${length ? start + 1 : start},${length}`;
|
|
111
|
+
}
|
|
112
|
+
function* unifiedDiff(before, after, fromfile, tofile) {
|
|
113
|
+
const a = yield* lines(before);
|
|
114
|
+
const b = yield* lines(after);
|
|
115
|
+
const matches = yield* matchingBlocks(a, b);
|
|
116
|
+
const codes = [];
|
|
117
|
+
let i = 0;
|
|
118
|
+
let j = 0;
|
|
119
|
+
for (const [ai, bj, size] of matches) {
|
|
120
|
+
if (i < ai || j < bj)
|
|
121
|
+
codes.push([false, i, ai, j, bj]);
|
|
122
|
+
i = ai + size;
|
|
123
|
+
j = bj + size;
|
|
124
|
+
if (size)
|
|
125
|
+
codes.push([true, ai, i, bj, j]);
|
|
126
|
+
yield;
|
|
127
|
+
}
|
|
128
|
+
const first = codes[0];
|
|
129
|
+
const last = codes.at(-1);
|
|
130
|
+
if (first?.[0]) {
|
|
131
|
+
first[1] = Math.max(first[1], first[2] - 3);
|
|
132
|
+
first[3] = Math.max(first[3], first[4] - 3);
|
|
133
|
+
}
|
|
134
|
+
if (last?.[0]) {
|
|
135
|
+
last[2] = Math.min(last[2], last[1] + 3);
|
|
136
|
+
last[4] = Math.min(last[4], last[3] + 3);
|
|
137
|
+
}
|
|
138
|
+
const output = [];
|
|
139
|
+
function* emit(group) {
|
|
140
|
+
if (!group.length || (group.length === 1 && group[0][0]))
|
|
141
|
+
return;
|
|
142
|
+
if (!output.length)
|
|
143
|
+
output.push(`--- ${fromfile}\n+++ ${tofile}\n`);
|
|
144
|
+
const first = group[0];
|
|
145
|
+
const last = group.at(-1);
|
|
146
|
+
output.push(`@@ -${formatRange(first[1], last[2])} +${formatRange(first[3], last[4])} @@\n`);
|
|
147
|
+
for (const [equal, aStart, aEnd, bStart, bEnd] of group) {
|
|
148
|
+
for (let index = aStart; index < aEnd; index++) {
|
|
149
|
+
const line = a[index];
|
|
150
|
+
output.push((equal ? " " : "-") + line);
|
|
151
|
+
if (!line.endsWith("\n")) {
|
|
152
|
+
output.push("\n\\n");
|
|
153
|
+
}
|
|
154
|
+
yield;
|
|
155
|
+
}
|
|
156
|
+
if (!equal) {
|
|
157
|
+
for (let index = bStart; index < bEnd; index++) {
|
|
158
|
+
const line = b[index];
|
|
159
|
+
output.push("+" + line);
|
|
160
|
+
if (!line.endsWith("\n")) {
|
|
161
|
+
output.push("\n\\n");
|
|
162
|
+
}
|
|
163
|
+
yield;
|
|
164
|
+
}
|
|
165
|
+
}
|
|
166
|
+
yield;
|
|
167
|
+
}
|
|
168
|
+
}
|
|
169
|
+
let group = [];
|
|
170
|
+
for (const [equal, aStart, aEnd, bStart, bEnd] of codes) {
|
|
171
|
+
if (equal && aEnd - aStart > 6) {
|
|
172
|
+
group.push([true, aStart, aStart + 3, bStart, bStart + 3]);
|
|
173
|
+
yield* emit(group);
|
|
174
|
+
group = [[true, aEnd - 3, aEnd, bEnd - 3, bEnd]];
|
|
175
|
+
}
|
|
176
|
+
else {
|
|
177
|
+
group.push([equal, aStart, aEnd, bStart, bEnd]);
|
|
178
|
+
}
|
|
179
|
+
yield;
|
|
180
|
+
}
|
|
181
|
+
yield* emit(group);
|
|
182
|
+
return output.join("");
|
|
183
|
+
}
|
|
184
|
+
export async function securityPolicyUnifiedDiff(before, after, fromfile, tofile, signal) {
|
|
185
|
+
const work = unifiedDiff(before, after, fromfile, tofile);
|
|
186
|
+
for (;;) {
|
|
187
|
+
signal?.throwIfAborted();
|
|
188
|
+
// Bound synchronous work, including the quadratic inner matching loop.
|
|
189
|
+
for (let operation = 0; operation < 4096; operation++) {
|
|
190
|
+
const result = work.next();
|
|
191
|
+
if (result.done)
|
|
192
|
+
return result.value;
|
|
193
|
+
}
|
|
194
|
+
await setImmediate();
|
|
195
|
+
}
|
|
196
|
+
}
|
|
197
|
+
//# sourceMappingURL=security-policy-diff.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"security-policy-diff.js","sourceRoot":"","sources":["../src/security-policy-diff.ts"],"names":[],"mappings":"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","sourcesContent":["import { setImmediate } from \"node:timers/promises\";\n\ntype Match = [a: number, b: number, size: number];\ntype Range = [aStart: number, aEnd: number, bStart: number, bEnd: number];\ntype Opcode = [equal: boolean, ...Range];\ntype Work<T> = Generator<void, T>;\n\nfunction* lines(text: string): Work<string[]> {\n const result: string[] = [];\n let start = 0;\n for (let end = 0; end < text.length; end++) {\n if (text.charCodeAt(end) === 10) {\n result.push(text.slice(start, end + 1));\n start = end + 1;\n }\n yield;\n }\n if (start < text.length) result.push(text.slice(start));\n return result;\n}\n\n// Match Python's SequenceMatcher(None, a, b), including its default autojunk\n// heuristic. A different longest-common-subsequence algorithm changes the diff.\nfunction* matchingBlocks(a: string[], b: string[]): Work<Match[]> {\n const positions = new Map<string, number[]>();\n for (let j = 0; j < b.length; j++) {\n const line = b[j]!;\n const indices = positions.get(line);\n if (indices) indices.push(j);\n else positions.set(line, [j]);\n yield;\n }\n if (b.length >= 200) {\n const threshold = Math.floor(b.length / 100) + 1;\n for (const [line, indices] of positions) {\n if (indices.length > threshold) positions.delete(line);\n yield;\n }\n }\n\n const pending: (Range | Match)[] = [[0, a.length, 0, b.length]];\n const matches: Match[] = [];\n while (pending.length) {\n const range = pending.pop()!;\n if (range.length === 3) {\n const previous = matches.at(-1);\n if (\n previous &&\n previous[0] + previous[2] === range[0] &&\n previous[1] + previous[2] === range[1]\n ) {\n previous[2] += range[2];\n } else {\n matches.push(range);\n }\n yield;\n continue;\n }\n\n const [alo, ahi, blo, bhi] = range;\n let bestA = alo;\n let bestB = blo;\n let size = 0;\n let lengths = new Map<number, number>();\n for (let i = alo; i < ahi; i++) {\n const next = new Map<number, number>();\n for (const j of positions.get(a[i]!) ?? []) {\n yield;\n if (j < blo) continue;\n if (j >= bhi) break;\n const length = (lengths.get(j - 1) ?? 0) + 1;\n next.set(j, length);\n if (length > size) {\n bestA = i - length + 1;\n bestB = j - length + 1;\n size = length;\n }\n }\n lengths = next;\n yield;\n }\n // Popular lines may extend a match, even though they cannot anchor one.\n while (bestA > alo && bestB > blo && a[bestA - 1] === b[bestB - 1]) {\n bestA--;\n bestB--;\n size++;\n yield;\n }\n while (\n bestA + size < ahi &&\n bestB + size < bhi &&\n a[bestA + size] === b[bestB + size]\n ) {\n size++;\n yield;\n }\n if (size) {\n // Visit matches in order, avoiding a blocking sort of the result.\n if (bestA + size < ahi && bestB + size < bhi) {\n pending.push([bestA + size, ahi, bestB + size, bhi]);\n }\n pending.push([bestA, bestB, size]);\n if (alo < bestA && blo < bestB) {\n pending.push([alo, bestA, blo, bestB]);\n }\n }\n yield;\n }\n matches.push([a.length, b.length, 0]);\n return matches;\n}\n\nfunction formatRange(start: number, end: number): string {\n const length = end - start;\n return length === 1\n ? String(start + 1)\n : `${length ? start + 1 : start},${length}`;\n}\n\nfunction* unifiedDiff(\n before: string,\n after: string,\n fromfile: string,\n tofile: string,\n): Work<string> {\n const a = yield* lines(before);\n const b = yield* lines(after);\n const matches = yield* matchingBlocks(a, b);\n const codes: Opcode[] = [];\n let i = 0;\n let j = 0;\n for (const [ai, bj, size] of matches) {\n if (i < ai || j < bj) codes.push([false, i, ai, j, bj]);\n i = ai + size;\n j = bj + size;\n if (size) codes.push([true, ai, i, bj, j]);\n yield;\n }\n const first = codes[0];\n const last = codes.at(-1);\n if (first?.[0]) {\n first[1] = Math.max(first[1], first[2] - 3);\n first[3] = Math.max(first[3], first[4] - 3);\n }\n if (last?.[0]) {\n last[2] = Math.min(last[2], last[1] + 3);\n last[4] = Math.min(last[4], last[3] + 3);\n }\n\n const output: string[] = [];\n function* emit(group: Opcode[]): Work<void> {\n if (!group.length || (group.length === 1 && group[0]![0])) return;\n if (!output.length) output.push(`--- ${fromfile}\\n+++ ${tofile}\\n`);\n const first = group[0]!;\n const last = group.at(-1)!;\n output.push(\n `@@ -${formatRange(first[1], last[2])} +${formatRange(first[3], last[4])} @@\\n`,\n );\n for (const [equal, aStart, aEnd, bStart, bEnd] of group) {\n for (let index = aStart; index < aEnd; index++) {\n const line = a[index]!;\n output.push((equal ? \" \" : \"-\") + line);\n if (!line.endsWith(\"\\n\")) {\n output.push(\"\\n\\\\\n\");\n }\n yield;\n }\n if (!equal) {\n for (let index = bStart; index < bEnd; index++) {\n const line = b[index]!;\n output.push(\"+\" + line);\n if (!line.endsWith(\"\\n\")) {\n output.push(\"\\n\\\\\n\");\n }\n yield;\n }\n }\n yield;\n }\n }\n\n let group: Opcode[] = [];\n for (const [equal, aStart, aEnd, bStart, bEnd] of codes) {\n if (equal && aEnd - aStart > 6) {\n group.push([true, aStart, aStart + 3, bStart, bStart + 3]);\n yield* emit(group);\n group = [[true, aEnd - 3, aEnd, bEnd - 3, bEnd]];\n } else {\n group.push([equal, aStart, aEnd, bStart, bEnd]);\n }\n yield;\n }\n yield* emit(group);\n return output.join(\"\");\n}\n\nexport async function securityPolicyUnifiedDiff(\n before: string,\n after: string,\n fromfile: string,\n tofile: string,\n signal?: AbortSignal,\n): Promise<string> {\n const work = unifiedDiff(before, after, fromfile, tofile);\n for (;;) {\n signal?.throwIfAborted();\n // Bound synchronous work, including the quadratic inner matching loop.\n for (let operation = 0; operation < 4096; operation++) {\n const result = work.next();\n if (result.done) return result.value;\n }\n await setImmediate();\n }\n}\n"]}
|
|
@@ -3,7 +3,7 @@ import type { ScanAuthentication, ScanOptions } from "./api.js";
|
|
|
3
3
|
import type { ScanModelConfiguration } from "./config.js";
|
|
4
4
|
import type { ScanCost } from "./cost.js";
|
|
5
5
|
import type { ThreatModel } from "./models.js";
|
|
6
|
-
import {
|
|
6
|
+
import type { ProcessEnvironment } from "./runtime.js";
|
|
7
7
|
export type SecurityPolicyStage = "architecture" | "threat_model" | "policy";
|
|
8
8
|
export interface SecurityPolicyOptions extends Pick<ScanOptions, "auth" | "knowledgeBasePaths" | "outputDir" | "maxCostUsd" | "signal" | "onAuthentication" | "onOutputDirReady" | "onCost" | "onWarning" | "onObserverError"> {
|
|
9
9
|
path?: string;
|
|
@@ -80,8 +80,12 @@ export declare function runSecurityPolicyStages(options: {
|
|
|
80
80
|
run(stage: SecurityPolicyStage, prompt: string): Promise<SecurityPolicyStageResult>;
|
|
81
81
|
cost(): Readonly<ScanCost> | null;
|
|
82
82
|
}): Promise<SecurityPolicyDraft>;
|
|
83
|
-
/**
|
|
84
|
-
* Use CodexSecurity.previewPolicy() for terminal output.
|
|
83
|
+
/**
|
|
84
|
+
* Raw unified diff computed in Node. Use CodexSecurity.previewPolicy() for terminal output.
|
|
85
|
+
* @param python Deprecated interpreter selection. Strings and resolver results no longer
|
|
86
|
+
* select an executable. An explicit resolver is still awaited when there is a change,
|
|
87
|
+
* and its errors propagate.
|
|
88
|
+
*/
|
|
85
89
|
export declare function securityPolicyDiff(draft: SecurityPolicyDraft, python?: string | (() => Promise<string>), signal?: AbortSignal): Promise<string>;
|
|
86
90
|
export declare function formatSecurityPolicyText(value: string, multiline?: boolean): string;
|
|
87
91
|
export {};
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"security-policy.d.ts","sourceRoot":"","sources":["../src/security-policy.ts"],"names":[],"mappings":"AA0BA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAEhE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG/C,OAAO,
|
|
1
|
+
{"version":3,"file":"security-policy.d.ts","sourceRoot":"","sources":["../src/security-policy.ts"],"names":[],"mappings":"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"}
|
package/dist/security-policy.js
CHANGED
|
@@ -10,7 +10,7 @@ import { z } from "zod";
|
|
|
10
10
|
import { jsonForPrompt } from "./codex-prompt.js";
|
|
11
11
|
import { writeThreatModel } from "./artifact-export.js";
|
|
12
12
|
import { CodexSecurityError, InvalidTargetError } from "./errors.js";
|
|
13
|
-
import {
|
|
13
|
+
import { securityPolicyUnifiedDiff } from "./security-policy-diff.js";
|
|
14
14
|
import { nullIfMissingFile, nullIfMissingPath, abortable, enclosingGitWorktreeRoot, enclosingGitWorktreeRoots, gitMetadataDirectories, gitObjectDirectories, isGitMetadataDirectory, normalizeRepository, normalizeTarget, relativePathIsOutside, } from "./targets.js";
|
|
15
15
|
const securityPolicyRepositoryBindings = new WeakMap();
|
|
16
16
|
export async function requireSecurityPolicyRepositoryBinding(target, signal) {
|
|
@@ -51,8 +51,6 @@ export function parseSecurityPolicyStageResult(value) {
|
|
|
51
51
|
const execFileAsync = promisify(execFile);
|
|
52
52
|
const MANIFEST_NAME = "policy-draft.json";
|
|
53
53
|
const ORIGINAL_NAME = "previous-SECURITY.md";
|
|
54
|
-
// This is the input contract enforced by the resolve-security-md helper.
|
|
55
|
-
const MAX_SECURITY_MD_BYTES = 1024 * 1024;
|
|
56
54
|
// The define-security-policy skill asks at most three questions at once.
|
|
57
55
|
const OWNER_QUESTION_BATCH_SIZE = 3;
|
|
58
56
|
async function writePolicyArtifact(path, content, signal) {
|
|
@@ -110,17 +108,7 @@ async function readPolicyFile(path, options = {}) {
|
|
|
110
108
|
if (!options.allowHardLinks && metadata.nlink > 1) {
|
|
111
109
|
throw new CodexSecurityError(`Security policy must not be a hard-linked file: ${path}. Copy it to a separate file.`);
|
|
112
110
|
}
|
|
113
|
-
|
|
114
|
-
const bytes = Buffer.allocUnsafe(MAX_SECURITY_MD_BYTES + 1);
|
|
115
|
-
let length = 0;
|
|
116
|
-
while (length < bytes.length) {
|
|
117
|
-
const { bytesRead } = await file.read(bytes, length, bytes.length - length, null);
|
|
118
|
-
if (bytesRead === 0)
|
|
119
|
-
break;
|
|
120
|
-
length += bytesRead;
|
|
121
|
-
}
|
|
122
|
-
validatePolicySize(length);
|
|
123
|
-
return decodePolicyText(bytes.subarray(0, length), path);
|
|
111
|
+
return decodePolicyText(await file.readFile(), path);
|
|
124
112
|
}
|
|
125
113
|
finally {
|
|
126
114
|
await file.close();
|
|
@@ -596,70 +584,24 @@ export async function runSecurityPolicyStages(options) {
|
|
|
596
584
|
cost: options.cost(),
|
|
597
585
|
};
|
|
598
586
|
}
|
|
599
|
-
/**
|
|
600
|
-
* Use CodexSecurity.previewPolicy() for terminal output.
|
|
587
|
+
/**
|
|
588
|
+
* Raw unified diff computed in Node. Use CodexSecurity.previewPolicy() for terminal output.
|
|
589
|
+
* @param python Deprecated interpreter selection. Strings and resolver results no longer
|
|
590
|
+
* select an executable. An explicit resolver is still awaited when there is a change,
|
|
591
|
+
* and its errors propagate.
|
|
592
|
+
*/
|
|
601
593
|
export async function securityPolicyDiff(draft, python, signal) {
|
|
602
594
|
draft = { ...draft };
|
|
603
595
|
const target = await resolveDraftTarget(draft, signal);
|
|
604
596
|
await requireUnchangedSecurityPolicy(target, draft, signal);
|
|
605
597
|
if (draft.previousContent === draft.content)
|
|
606
598
|
return "";
|
|
607
|
-
|
|
608
|
-
|
|
609
|
-
(await resolvePluginPython({
|
|
610
|
-
protectedRoot: (await enclosingGitWorktreeRoots(draft.repository, signal)).at(-1) ??
|
|
611
|
-
draft.repository,
|
|
612
|
-
signal,
|
|
613
|
-
}));
|
|
599
|
+
if (typeof python === "function")
|
|
600
|
+
await python();
|
|
614
601
|
const label = relative(draft.repository, draft.targetPath)
|
|
615
602
|
.split(sep)
|
|
616
603
|
.join("/");
|
|
617
|
-
const
|
|
618
|
-
"import difflib, json, sys",
|
|
619
|
-
"before, after, fromfile, tofile = json.loads(sys.stdin.buffer.read().decode('utf-8'))",
|
|
620
|
-
"def lines(text):",
|
|
621
|
-
" parts = text.split('\\n')",
|
|
622
|
-
" return [part + '\\n' for part in parts[:-1]] + ([parts[-1]] if parts[-1] else [])",
|
|
623
|
-
"for line in difflib.unified_diff(lines(before), lines(after), fromfile=fromfile, tofile=tofile):",
|
|
624
|
-
" sys.stdout.buffer.write(line.encode('utf-8'))",
|
|
625
|
-
" if not line.endswith('\\n'): sys.stdout.buffer.write(b'\\n\\\\\n')",
|
|
626
|
-
].join("\n");
|
|
627
|
-
const diff = await new Promise((resolve, reject) => {
|
|
628
|
-
let inputError;
|
|
629
|
-
const child = execFile(interpreter, ["-I", "-c", script], {
|
|
630
|
-
encoding: "utf8",
|
|
631
|
-
maxBuffer: Infinity,
|
|
632
|
-
signal,
|
|
633
|
-
}, (error, stdout) => {
|
|
634
|
-
const failure = error ?? inputError;
|
|
635
|
-
if (failure === undefined)
|
|
636
|
-
resolve(stdout);
|
|
637
|
-
else
|
|
638
|
-
reject(failure);
|
|
639
|
-
});
|
|
640
|
-
const releaseFailedInput = () => {
|
|
641
|
-
if (inputError === undefined)
|
|
642
|
-
return;
|
|
643
|
-
if (child.exitCode === null && child.signalCode === null) {
|
|
644
|
-
if (child.pid !== undefined)
|
|
645
|
-
reject(inputError);
|
|
646
|
-
return;
|
|
647
|
-
}
|
|
648
|
-
child.stdout.destroy();
|
|
649
|
-
child.stderr.destroy();
|
|
650
|
-
};
|
|
651
|
-
child.once("exit", releaseFailedInput);
|
|
652
|
-
child.stdin.on("error", (error) => {
|
|
653
|
-
inputError = error;
|
|
654
|
-
releaseFailedInput();
|
|
655
|
-
});
|
|
656
|
-
child.stdin.end(JSON.stringify([
|
|
657
|
-
draft.previousContent ?? "",
|
|
658
|
-
draft.content,
|
|
659
|
-
draft.previousContent === null ? "/dev/null" : diffLabel(`a/${label}`),
|
|
660
|
-
diffLabel(`b/${label}`),
|
|
661
|
-
]));
|
|
662
|
-
});
|
|
604
|
+
const diff = await securityPolicyUnifiedDiff(draft.previousContent ?? "", draft.content, draft.previousContent === null ? "/dev/null" : diffLabel(`a/${label}`), diffLabel(`b/${label}`), signal);
|
|
663
605
|
await requireUnchangedSecurityPolicy(await resolveDraftTarget(draft, signal), draft, signal);
|
|
664
606
|
return diff;
|
|
665
607
|
}
|
|
@@ -681,13 +623,6 @@ function validatePolicyContent(content, stage) {
|
|
|
681
623
|
if (!content.isWellFormed()) {
|
|
682
624
|
throw new CodexSecurityError(`The ${stage === "policy" ? "security policy" : stage.replace("_", " ")} must contain valid Unicode text.`);
|
|
683
625
|
}
|
|
684
|
-
if (stage === "policy")
|
|
685
|
-
validatePolicySize(Buffer.byteLength(content, "utf8"));
|
|
686
|
-
}
|
|
687
|
-
function validatePolicySize(size) {
|
|
688
|
-
if (size > MAX_SECURITY_MD_BYTES) {
|
|
689
|
-
throw new CodexSecurityError("SECURITY.md exceeds the policy resolver's 1 MiB limit.");
|
|
690
|
-
}
|
|
691
626
|
}
|
|
692
627
|
function decodePolicyText(bytes, path) {
|
|
693
628
|
try {
|