@openai/codex-security 0.5.1 → 0.6.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +86 -2
- package/_bundled_plugin/mcp/helpers.mjs.br.part-000 +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/scripts/workbench_finding_workflows.py +2 -0
- package/_bundled_plugin/shared/workbench-migrations.json +16 -0
- package/_bundled_plugin/skills/fix-finding/SKILL.md +16 -8
- package/_bundled_plugin/skills/publish-findings/SKILL.md +130 -0
- package/_bundled_plugin/skills/publish-findings/agents/openai.yaml +6 -0
- package/_bundled_plugin/skills/verify-fix/SKILL.md +4 -2
- package/dist/api.d.ts +3 -0
- package/dist/api.d.ts.map +1 -1
- package/dist/api.js +76 -38
- package/dist/api.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 +7 -0
- package/dist/cli.d.ts.map +1 -1
- package/dist/cli.js +412 -14
- 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/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 +7 -0
- package/dist/endor-findings.d.ts.map +1 -0
- package/dist/endor-findings.js +233 -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 +38 -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 +337 -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 +713 -0
- package/dist/external-findings-publish.js.map +1 -0
- package/dist/external-findings-read.d.ts +6 -0
- package/dist/external-findings-read.d.ts.map +1 -0
- package/dist/external-findings-read.js +88 -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 +13 -0
- package/dist/external-import-contract.d.ts.map +1 -0
- package/dist/external-import-contract.js +254 -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/finding-workflow.d.ts +1 -1
- package/dist/finding-workflow.d.ts.map +1 -1
- package/dist/finding-workflow.js +2 -1
- 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 +131 -0
- package/dist/github-advisories.js.map +1 -0
- package/dist/github-findings.d.ts +10 -0
- package/dist/github-findings.d.ts.map +1 -0
- package/dist/github-findings.js +256 -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 +3 -1
- 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 +14 -2
- package/dist/hosted-scan.js.map +1 -1
- package/dist/index.d.ts +13 -0
- package/dist/index.d.ts.map +1 -1
- package/dist/index.js +8 -0
- package/dist/index.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/remediation.d.ts +6 -0
- package/dist/remediation.d.ts.map +1 -1
- package/dist/remediation.js +16 -5
- 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 +3 -1
- package/dist/runtime.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/scanner-import.d.ts +20 -0
- package/dist/scanner-import.d.ts.map +1 -0
- package/dist/scanner-import.js +204 -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 +10 -56
- package/dist/security-policy.js.map +1 -1
- package/dist/semgrep-findings.d.ts +9 -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/snyk-findings.d.ts +9 -0
- package/dist/snyk-findings.d.ts.map +1 -0
- package/dist/snyk-findings.js +349 -0
- package/dist/snyk-findings.js.map +1 -0
- package/dist/targets.d.ts +2 -2
- package/dist/targets.d.ts.map +1 -1
- package/dist/targets.js +12 -2
- package/dist/targets.js.map +1 -1
- package/dist/wiz-csv.d.ts +8 -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 +4 -0
- package/dist/wiz-findings.d.ts.map +1 -0
- package/dist/wiz-findings.js +460 -0
- package/dist/wiz-findings.js.map +1 -0
- package/docs/classify-severity-records.md +28 -10
- package/docs/cli.md +702 -31
- package/docs/hosted-remediation.md +24 -7
- package/docs/hosted-scans.md +12 -0
- package/package.json +6 -4
- package/schemas/external-findings.schema.json +1421 -0
- package/schemas/project-config.schema.json +4 -0
|
@@ -3,11 +3,11 @@ import { type SeverityDecision } from "./severity-review.js";
|
|
|
3
3
|
/** Versioned input for repository-free classification of canonical records. */
|
|
4
4
|
export declare const classifySeverityRecordsInputSchema: z.ZodObject<{
|
|
5
5
|
version: z.ZodLiteral<1>;
|
|
6
|
-
rubric: z.ZodObject<{
|
|
6
|
+
rubric: z.ZodOptional<z.ZodObject<{
|
|
7
7
|
revision: z.ZodNumber;
|
|
8
8
|
markdown: z.ZodString;
|
|
9
9
|
sha256: z.ZodString;
|
|
10
|
-
}, z.core.$strict
|
|
10
|
+
}, z.core.$strict>>;
|
|
11
11
|
model: z.ZodString;
|
|
12
12
|
effort: z.ZodEnum<{
|
|
13
13
|
high: "high";
|
|
@@ -36,6 +36,8 @@ export interface SeverityClassificationReviewRequest {
|
|
|
36
36
|
schema: unknown;
|
|
37
37
|
}
|
|
38
38
|
export interface ClassifySeverityRecordsOptions {
|
|
39
|
+
/** Independent reviews per record: integer 1–10, default 3. */
|
|
40
|
+
classificationRuns?: number;
|
|
39
41
|
reviewRunner: {
|
|
40
42
|
run(request: SeverityClassificationReviewRequest, options?: {
|
|
41
43
|
signal?: AbortSignal;
|
|
@@ -49,6 +51,7 @@ export type CanonicalSeverityAssessment = Omit<SeverityDecision, "findingId"> &
|
|
|
49
51
|
inputSha256: string;
|
|
50
52
|
};
|
|
51
53
|
interface RecordsResultBinding {
|
|
54
|
+
classificationRuns: number;
|
|
52
55
|
version: 1;
|
|
53
56
|
rubric: {
|
|
54
57
|
revision: number;
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify-severity-records.d.ts","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"classify-severity-records.d.ts","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAML,KAAK,gBAAgB,EACtB,MAAM,sBAAsB,CAAC;AAwB9B,+EAA+E;AAC/E,eAAO,MAAM,kCAAkC;;;;;;;;;;;;;;;;;;;;;;;kBAgCpC,CAAC;AAEZ,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAChD,OAAO,kCAAkC,CAC1C,CAAC;AAEF,MAAM,WAAW,mCAAmC;IAClD,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,yBAAyB,CAAC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,4BAA4B,CAAC,QAAQ,CAAC,CAAC;IAC/C,mBAAmB,EAAE,MAAM,CAAC;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC7C,+DAA+D;IAC/D,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE;QACZ,GAAG,CACD,OAAO,EAAE,mCAAmC,EAC5C,OAAO,CAAC,EAAE;YAAE,MAAM,CAAC,EAAE,WAAW,CAAA;SAAE,GACjC,OAAO,CAAC,OAAO,CAAC,CAAC;KACrB,CAAC;IACF,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,2BAA2B,GAAG,IAAI,CAC5C,gBAAgB,EAChB,WAAW,CACZ,GAAG;IACF,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,UAAU,oBAAoB;IAC5B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,CAAC;IACX,MAAM,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAC9C;AAED,MAAM,MAAM,6BAA6B,GAAG,oBAAoB,GAC9D,CACI;IAAE,MAAM,EAAE,WAAW,CAAC;IAAC,WAAW,EAAE,2BAA2B,EAAE,CAAA;CAAE,GACnE;IACE,MAAM,EAAE,YAAY,CAAC;IACrB,WAAW,EAAE,EAAE,CAAC;IAChB,KAAK,EAAE;QACL,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,eAAe,GAAG,oBAAoB,CAAC;QAC7C,OAAO,EAAE,MAAM,CAAC;KACjB,CAAC;CACH,CACJ,CAAC;AAMJ;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,KAAK,EAAE,4BAA4B,EACnC,OAAO,EAAE,8BAA8B,GACtC,OAAO,CAAC,6BAA6B,CAAC,CAuFxC"}
|
|
@@ -1,8 +1,9 @@
|
|
|
1
1
|
import { SCAN_SEVERITIES } from "./scan-settings.js";
|
|
2
|
+
import { defaultSeverityRubric } from "./default-severity-rubric.js";
|
|
2
3
|
import { createHash, randomUUID } from "node:crypto";
|
|
3
4
|
import { z } from "zod";
|
|
4
5
|
import { abortable } from "./targets.js";
|
|
5
|
-
import { parseSeverityDecision, severityDecisionSchema, severityReviewInstructions, } from "./severity-review.js";
|
|
6
|
+
import { parseSeverityDecision, reviewSeverity, classificationRunsSchema, severityDecisionSchema, severityReviewInstructions, } from "./severity-review.js";
|
|
6
7
|
const text = z
|
|
7
8
|
.string()
|
|
8
9
|
.refine((value) => value.trim().length > 0, "Must not be blank.");
|
|
@@ -34,7 +35,8 @@ export const classifySeverityRecordsInputSchema = z
|
|
|
34
35
|
markdown: text,
|
|
35
36
|
sha256: digest,
|
|
36
37
|
})
|
|
37
|
-
.strict()
|
|
38
|
+
.strict()
|
|
39
|
+
.optional(),
|
|
38
40
|
model: text,
|
|
39
41
|
effort: z.enum([
|
|
40
42
|
"minimal",
|
|
@@ -64,8 +66,16 @@ function sha256(value) {
|
|
|
64
66
|
*/
|
|
65
67
|
export async function classifySeverityRecords(input, options) {
|
|
66
68
|
options.signal?.throwIfAborted();
|
|
69
|
+
const classificationRuns = classificationRunsSchema
|
|
70
|
+
.default(3)
|
|
71
|
+
.parse(options.classificationRuns);
|
|
67
72
|
const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));
|
|
68
|
-
|
|
73
|
+
const rubric = data.rubric ?? {
|
|
74
|
+
revision: 1,
|
|
75
|
+
markdown: defaultSeverityRubric,
|
|
76
|
+
sha256: sha256(defaultSeverityRubric),
|
|
77
|
+
};
|
|
78
|
+
if (sha256(rubric.markdown) !== rubric.sha256)
|
|
69
79
|
throw new Error("Rubric SHA-256 does not match its exact UTF-8 Markdown.");
|
|
70
80
|
const ids = new Set();
|
|
71
81
|
for (const record of data.records) {
|
|
@@ -79,43 +89,34 @@ export async function classifySeverityRecords(input, options) {
|
|
|
79
89
|
throw new Error("The report findingId must equal its canonical record ID.");
|
|
80
90
|
}
|
|
81
91
|
const binding = {
|
|
92
|
+
classificationRuns,
|
|
82
93
|
version: 1,
|
|
83
|
-
rubric: { revision:
|
|
94
|
+
rubric: { revision: rubric.revision, sha256: rubric.sha256 },
|
|
84
95
|
};
|
|
85
96
|
const assessments = [];
|
|
86
97
|
for (const record of data.records) {
|
|
87
98
|
options.signal?.throwIfAborted();
|
|
88
|
-
let
|
|
99
|
+
let code = "review_failed";
|
|
89
100
|
try {
|
|
90
|
-
|
|
101
|
+
const { findingId: _findingId, ...decision } = await reviewSeverity(async () => {
|
|
102
|
+
code = "review_failed";
|
|
103
|
+
const response = await abortable(() => {
|
|
104
|
+
options.signal?.throwIfAborted();
|
|
105
|
+
return options.reviewRunner.run({
|
|
106
|
+
requestId: randomUUID(),
|
|
107
|
+
stage: "severity-classification",
|
|
108
|
+
model: data.model,
|
|
109
|
+
effort: data.effort,
|
|
110
|
+
trustedInstructions: severityReviewInstructions,
|
|
111
|
+
prompt: `{"rubric":${JSON.stringify([rubric.markdown])},"knowledgeBase":null,"finding":${record.findingJson}}`,
|
|
112
|
+
schema: z.toJSONSchema(severityDecisionSchema),
|
|
113
|
+
}, { signal: options.signal });
|
|
114
|
+
}, options.signal);
|
|
91
115
|
options.signal?.throwIfAborted();
|
|
92
|
-
|
|
93
|
-
|
|
94
|
-
|
|
95
|
-
model: data.model,
|
|
96
|
-
effort: data.effort,
|
|
97
|
-
trustedInstructions: severityReviewInstructions,
|
|
98
|
-
prompt: `{"rubric":${JSON.stringify([data.rubric.markdown])},"knowledgeBase":null,"finding":${record.findingJson}}`,
|
|
99
|
-
schema: z.toJSONSchema(severityDecisionSchema),
|
|
100
|
-
}, { signal: options.signal });
|
|
101
|
-
}, options.signal);
|
|
102
|
-
}
|
|
103
|
-
catch (error) {
|
|
116
|
+
code = "invalid_assessment";
|
|
117
|
+
return parseSeverityDecision(response, record.id);
|
|
118
|
+
}, classificationRuns);
|
|
104
119
|
options.signal?.throwIfAborted();
|
|
105
|
-
return {
|
|
106
|
-
...binding,
|
|
107
|
-
status: "unresolved",
|
|
108
|
-
assessments: [],
|
|
109
|
-
error: {
|
|
110
|
-
recordId: record.id,
|
|
111
|
-
code: "review_failed",
|
|
112
|
-
message: error instanceof Error ? error.message : "Host review failed.",
|
|
113
|
-
},
|
|
114
|
-
};
|
|
115
|
-
}
|
|
116
|
-
options.signal?.throwIfAborted();
|
|
117
|
-
try {
|
|
118
|
-
const { findingId: _findingId, ...decision } = parseSeverityDecision(response, record.id);
|
|
119
120
|
assessments.push({
|
|
120
121
|
...decision,
|
|
121
122
|
id: record.id,
|
|
@@ -124,14 +125,19 @@ export async function classifySeverityRecords(input, options) {
|
|
|
124
125
|
});
|
|
125
126
|
}
|
|
126
127
|
catch (error) {
|
|
128
|
+
options.signal?.throwIfAborted();
|
|
127
129
|
return {
|
|
128
130
|
...binding,
|
|
129
131
|
status: "unresolved",
|
|
130
132
|
assessments: [],
|
|
131
133
|
error: {
|
|
132
134
|
recordId: record.id,
|
|
133
|
-
code
|
|
134
|
-
message: error instanceof Error
|
|
135
|
+
code,
|
|
136
|
+
message: error instanceof Error
|
|
137
|
+
? error.message
|
|
138
|
+
: code === "review_failed"
|
|
139
|
+
? "Host review failed."
|
|
140
|
+
: "Invalid assessment.",
|
|
135
141
|
},
|
|
136
142
|
};
|
|
137
143
|
}
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify-severity-records.js","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"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","sourcesContent":["import { SCAN_SEVERITIES } from \"./scan-settings.js\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { z } from \"zod\";\nimport { abortable } from \"./targets.js\";\nimport {\n parseSeverityDecision,\n severityDecisionSchema,\n severityReviewInstructions,\n type SeverityDecision,\n} from \"./severity-review.js\";\n\nconst text = z\n .string()\n .refine((value) => value.trim().length > 0, \"Must not be blank.\");\nconst digest = z.string().regex(/^[a-f0-9]{64}$/u);\nconst revision = z.number().int().nonnegative();\nconst reportSchema = z\n .object({\n findingId: text,\n title: text,\n summary: text,\n occurrenceId: text.optional(),\n severity: z\n .object({\n level: z.enum(SCAN_SEVERITIES),\n rationale: z.string().optional(),\n changeConditions: z.string().optional(),\n })\n .passthrough()\n .optional(),\n })\n .passthrough();\n\n/** Versioned input for repository-free classification of canonical records. */\nexport const classifySeverityRecordsInputSchema = z\n .object({\n version: z.literal(1),\n rubric: z\n .object({\n revision: revision.positive(),\n markdown: text,\n sha256: digest,\n })\n .strict(),\n model: text,\n effort: z.enum([\n \"minimal\",\n \"low\",\n \"medium\",\n \"high\",\n \"xhigh\",\n \"max\",\n \"ultra\",\n ]),\n records: z.array(\n z\n .object({\n id: text,\n revision,\n findingJson: text,\n inputSha256: digest,\n })\n .strict(),\n ),\n })\n .strict();\n\nexport type ClassifySeverityRecordsInput = z.infer<\n typeof classifySeverityRecordsInputSchema\n>;\n\nexport interface SeverityClassificationReviewRequest {\n requestId: string;\n stage: \"severity-classification\";\n model: string;\n effort: ClassifySeverityRecordsInput[\"effort\"];\n trustedInstructions: string;\n prompt: string;\n schema: unknown;\n}\n\nexport interface ClassifySeverityRecordsOptions {\n reviewRunner: {\n run(\n request: SeverityClassificationReviewRequest,\n options?: { signal?: AbortSignal },\n ): Promise<unknown>;\n };\n signal?: AbortSignal;\n}\n\nexport type CanonicalSeverityAssessment = Omit<\n SeverityDecision,\n \"findingId\"\n> & {\n id: string;\n revision: number;\n inputSha256: string;\n};\n\ninterface RecordsResultBinding {\n version: 1;\n rubric: { revision: number; sha256: string };\n}\n\nexport type ClassifySeverityRecordsResult = RecordsResultBinding &\n (\n | { status: \"completed\"; assessments: CanonicalSeverityAssessment[] }\n | {\n status: \"unresolved\";\n assessments: [];\n error: {\n recordId: string;\n code: \"review_failed\" | \"invalid_assessment\";\n message: string;\n };\n }\n );\n\nfunction sha256(value: string): string {\n return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\n/**\n * Classify immutable host-provided reports. No filesystem, auth, local model,\n * repository access, retries, or persistence. The host owns those lifecycles.\n */\nexport async function classifySeverityRecords(\n input: ClassifySeverityRecordsInput,\n options: ClassifySeverityRecordsOptions,\n): Promise<ClassifySeverityRecordsResult> {\n options.signal?.throwIfAborted();\n const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));\n if (sha256(data.rubric.markdown) !== data.rubric.sha256)\n throw new Error(\"Rubric SHA-256 does not match its exact UTF-8 Markdown.\");\n const ids = new Set<string>();\n for (const record of data.records) {\n if (ids.has(record.id))\n throw new Error(\"Canonical record IDs must be unique.\");\n ids.add(record.id);\n if (sha256(record.findingJson) !== record.inputSha256)\n throw new Error(\"Finding SHA-256 does not match its exact UTF-8 JSON.\");\n const report = reportSchema.parse(JSON.parse(record.findingJson));\n if (report.findingId !== record.id)\n throw new Error(\n \"The report findingId must equal its canonical record ID.\",\n );\n }\n const binding: RecordsResultBinding = {\n version: 1,\n rubric: { revision: data.rubric.revision, sha256: data.rubric.sha256 },\n };\n const assessments: CanonicalSeverityAssessment[] = [];\n for (const record of data.records) {\n options.signal?.throwIfAborted();\n let response: unknown;\n try {\n response = await abortable(() => {\n options.signal?.throwIfAborted();\n return options.reviewRunner.run(\n {\n requestId: randomUUID(),\n stage: \"severity-classification\",\n model: data.model,\n effort: data.effort,\n trustedInstructions: severityReviewInstructions,\n prompt: `{\"rubric\":${JSON.stringify([data.rubric.markdown])},\"knowledgeBase\":null,\"finding\":${record.findingJson}}`,\n schema: z.toJSONSchema(severityDecisionSchema),\n },\n { signal: options.signal },\n );\n }, options.signal);\n } catch (error) {\n options.signal?.throwIfAborted();\n return {\n ...binding,\n status: \"unresolved\",\n assessments: [],\n error: {\n recordId: record.id,\n code: \"review_failed\",\n message:\n error instanceof Error ? error.message : \"Host review failed.\",\n },\n };\n }\n options.signal?.throwIfAborted();\n try {\n const { findingId: _findingId, ...decision } = parseSeverityDecision(\n response,\n record.id,\n );\n assessments.push({\n ...decision,\n id: record.id,\n revision: record.revision,\n inputSha256: record.inputSha256,\n });\n } catch (error) {\n return {\n ...binding,\n status: \"unresolved\",\n assessments: [],\n error: {\n recordId: record.id,\n code: \"invalid_assessment\",\n message:\n error instanceof Error ? error.message : \"Invalid assessment.\",\n },\n };\n }\n }\n return { ...binding, status: \"completed\", assessments };\n}\n"]}
|
|
1
|
+
{"version":3,"file":"classify-severity-records.js","sourceRoot":"","sources":["../src/classify-severity-records.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EACL,qBAAqB,EACrB,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,0BAA0B,GAE3B,MAAM,sBAAsB,CAAC;AAE9B,MAAM,IAAI,GAAG,CAAC;KACX,MAAM,EAAE;KACR,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,oBAAoB,CAAC,CAAC;AACpE,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,iBAAiB,CAAC,CAAC;AACnD,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC;AAChD,MAAM,YAAY,GAAG,CAAC;KACnB,MAAM,CAAC;IACN,SAAS,EAAE,IAAI;IACf,KAAK,EAAE,IAAI;IACX,OAAO,EAAE,IAAI;IACb,YAAY,EAAE,IAAI,CAAC,QAAQ,EAAE;IAC7B,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;QAC9B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAChC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KACxC,CAAC;SACD,WAAW,EAAE;SACb,QAAQ,EAAE;CACd,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,+EAA+E;AAC/E,MAAM,CAAC,MAAM,kCAAkC,GAAG,CAAC;KAChD,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrB,MAAM,EAAE,CAAC;SACN,MAAM,CAAC;QACN,QAAQ,EAAE,QAAQ,CAAC,QAAQ,EAAE;QAC7B,QAAQ,EAAE,IAAI;QACd,MAAM,EAAE,MAAM;KACf,CAAC;SACD,MAAM,EAAE;SACR,QAAQ,EAAE;IACb,KAAK,EAAE,IAAI;IACX,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC;QACb,SAAS;QACT,KAAK;QACL,QAAQ;QACR,MAAM;QACN,OAAO;QACP,KAAK;QACL,OAAO;KACR,CAAC;IACF,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC;SACE,MAAM,CAAC;QACN,EAAE,EAAE,IAAI;QACR,QAAQ;QACR,WAAW,EAAE,IAAI;QACjB,WAAW,EAAE,MAAM;KACpB,CAAC;SACD,MAAM,EAAE,CACZ;CACF,CAAC;KACD,MAAM,EAAE,CAAC;AAyDZ,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAClE,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,KAAmC,EACnC,OAAuC;IAEvC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;IACjC,MAAM,kBAAkB,GAAG,wBAAwB;SAChD,OAAO,CAAC,CAAC,CAAC;SACV,KAAK,CAAC,OAAO,CAAC,kBAAkB,CAAC,CAAC;IACrC,MAAM,IAAI,GAAG,kCAAkC,CAAC,KAAK,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,IAAI;QAC5B,QAAQ,EAAE,CAAC;QACX,QAAQ,EAAE,qBAAqB;QAC/B,MAAM,EAAE,MAAM,CAAC,qBAAqB,CAAC;KACtC,CAAC;IACF,IAAI,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC,MAAM;QAC3C,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,MAAM,GAAG,GAAG,IAAI,GAAG,EAAU,CAAC;IAC9B,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;YACpB,MAAM,IAAI,KAAK,CAAC,sCAAsC,CAAC,CAAC;QAC1D,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;QACnB,IAAI,MAAM,CAAC,MAAM,CAAC,WAAW,CAAC,KAAK,MAAM,CAAC,WAAW;YACnD,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,MAAM,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,SAAS,KAAK,MAAM,CAAC,EAAE;YAChC,MAAM,IAAI,KAAK,CACb,0DAA0D,CAC3D,CAAC;IACN,CAAC;IACD,MAAM,OAAO,GAAyB;QACpC,kBAAkB;QAClB,OAAO,EAAE,CAAC;QACV,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;KAC7D,CAAC;IACF,MAAM,WAAW,GAAkC,EAAE,CAAC;IACtD,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;QACjC,IAAI,IAAI,GAA2C,eAAe,CAAC;QACnE,IAAI,CAAC;YACH,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,QAAQ,EAAE,GAAG,MAAM,cAAc,CACjE,KAAK,IAAI,EAAE;gBACT,IAAI,GAAG,eAAe,CAAC;gBACvB,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,GAAG,EAAE;oBACpC,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;oBACjC,OAAO,OAAO,CAAC,YAAY,CAAC,GAAG,CAC7B;wBACE,SAAS,EAAE,UAAU,EAAE;wBACvB,KAAK,EAAE,yBAAyB;wBAChC,KAAK,EAAE,IAAI,CAAC,KAAK;wBACjB,MAAM,EAAE,IAAI,CAAC,MAAM;wBACnB,mBAAmB,EAAE,0BAA0B;wBAC/C,MAAM,EAAE,aAAa,IAAI,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,mCAAmC,MAAM,CAAC,WAAW,GAAG;wBAC9G,MAAM,EAAE,CAAC,CAAC,YAAY,CAAC,sBAAsB,CAAC;qBAC/C,EACD,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAC3B,CAAC;gBACJ,CAAC,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBACnB,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;gBACjC,IAAI,GAAG,oBAAoB,CAAC;gBAC5B,OAAO,qBAAqB,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;YACpD,CAAC,EACD,kBAAkB,CACnB,CAAC;YACF,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,WAAW,CAAC,IAAI,CAAC;gBACf,GAAG,QAAQ;gBACX,EAAE,EAAE,MAAM,CAAC,EAAE;gBACb,QAAQ,EAAE,MAAM,CAAC,QAAQ;gBACzB,WAAW,EAAE,MAAM,CAAC,WAAW;aAChC,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,MAAM,EAAE,cAAc,EAAE,CAAC;YACjC,OAAO;gBACL,GAAG,OAAO;gBACV,MAAM,EAAE,YAAY;gBACpB,WAAW,EAAE,EAAE;gBACf,KAAK,EAAE;oBACL,QAAQ,EAAE,MAAM,CAAC,EAAE;oBACnB,IAAI;oBACJ,OAAO,EACL,KAAK,YAAY,KAAK;wBACpB,CAAC,CAAC,KAAK,CAAC,OAAO;wBACf,CAAC,CAAC,IAAI,KAAK,eAAe;4BACxB,CAAC,CAAC,qBAAqB;4BACvB,CAAC,CAAC,qBAAqB;iBAC9B;aACF,CAAC;QACJ,CAAC;IACH,CAAC;IACD,OAAO,EAAE,GAAG,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC;AAC1D,CAAC","sourcesContent":["import { SCAN_SEVERITIES } from \"./scan-settings.js\";\nimport { defaultSeverityRubric } from \"./default-severity-rubric.js\";\nimport { createHash, randomUUID } from \"node:crypto\";\nimport { z } from \"zod\";\nimport { abortable } from \"./targets.js\";\nimport {\n parseSeverityDecision,\n reviewSeverity,\n classificationRunsSchema,\n severityDecisionSchema,\n severityReviewInstructions,\n type SeverityDecision,\n} from \"./severity-review.js\";\n\nconst text = z\n .string()\n .refine((value) => value.trim().length > 0, \"Must not be blank.\");\nconst digest = z.string().regex(/^[a-f0-9]{64}$/u);\nconst revision = z.number().int().nonnegative();\nconst reportSchema = z\n .object({\n findingId: text,\n title: text,\n summary: text,\n occurrenceId: text.optional(),\n severity: z\n .object({\n level: z.enum(SCAN_SEVERITIES),\n rationale: z.string().optional(),\n changeConditions: z.string().optional(),\n })\n .passthrough()\n .optional(),\n })\n .passthrough();\n\n/** Versioned input for repository-free classification of canonical records. */\nexport const classifySeverityRecordsInputSchema = z\n .object({\n version: z.literal(1),\n rubric: z\n .object({\n revision: revision.positive(),\n markdown: text,\n sha256: digest,\n })\n .strict()\n .optional(),\n model: text,\n effort: z.enum([\n \"minimal\",\n \"low\",\n \"medium\",\n \"high\",\n \"xhigh\",\n \"max\",\n \"ultra\",\n ]),\n records: z.array(\n z\n .object({\n id: text,\n revision,\n findingJson: text,\n inputSha256: digest,\n })\n .strict(),\n ),\n })\n .strict();\n\nexport type ClassifySeverityRecordsInput = z.infer<\n typeof classifySeverityRecordsInputSchema\n>;\n\nexport interface SeverityClassificationReviewRequest {\n requestId: string;\n stage: \"severity-classification\";\n model: string;\n effort: ClassifySeverityRecordsInput[\"effort\"];\n trustedInstructions: string;\n prompt: string;\n schema: unknown;\n}\n\nexport interface ClassifySeverityRecordsOptions {\n /** Independent reviews per record: integer 1–10, default 3. */\n classificationRuns?: number;\n reviewRunner: {\n run(\n request: SeverityClassificationReviewRequest,\n options?: { signal?: AbortSignal },\n ): Promise<unknown>;\n };\n signal?: AbortSignal;\n}\n\nexport type CanonicalSeverityAssessment = Omit<\n SeverityDecision,\n \"findingId\"\n> & {\n id: string;\n revision: number;\n inputSha256: string;\n};\n\ninterface RecordsResultBinding {\n classificationRuns: number;\n version: 1;\n rubric: { revision: number; sha256: string };\n}\n\nexport type ClassifySeverityRecordsResult = RecordsResultBinding &\n (\n | { status: \"completed\"; assessments: CanonicalSeverityAssessment[] }\n | {\n status: \"unresolved\";\n assessments: [];\n error: {\n recordId: string;\n code: \"review_failed\" | \"invalid_assessment\";\n message: string;\n };\n }\n );\n\nfunction sha256(value: string): string {\n return createHash(\"sha256\").update(value, \"utf8\").digest(\"hex\");\n}\n\n/**\n * Classify immutable host-provided reports. No filesystem, auth, local model,\n * repository access, retries, or persistence. The host owns those lifecycles.\n */\nexport async function classifySeverityRecords(\n input: ClassifySeverityRecordsInput,\n options: ClassifySeverityRecordsOptions,\n): Promise<ClassifySeverityRecordsResult> {\n options.signal?.throwIfAborted();\n const classificationRuns = classificationRunsSchema\n .default(3)\n .parse(options.classificationRuns);\n const data = classifySeverityRecordsInputSchema.parse(structuredClone(input));\n const rubric = data.rubric ?? {\n revision: 1,\n markdown: defaultSeverityRubric,\n sha256: sha256(defaultSeverityRubric),\n };\n if (sha256(rubric.markdown) !== rubric.sha256)\n throw new Error(\"Rubric SHA-256 does not match its exact UTF-8 Markdown.\");\n const ids = new Set<string>();\n for (const record of data.records) {\n if (ids.has(record.id))\n throw new Error(\"Canonical record IDs must be unique.\");\n ids.add(record.id);\n if (sha256(record.findingJson) !== record.inputSha256)\n throw new Error(\"Finding SHA-256 does not match its exact UTF-8 JSON.\");\n const report = reportSchema.parse(JSON.parse(record.findingJson));\n if (report.findingId !== record.id)\n throw new Error(\n \"The report findingId must equal its canonical record ID.\",\n );\n }\n const binding: RecordsResultBinding = {\n classificationRuns,\n version: 1,\n rubric: { revision: rubric.revision, sha256: rubric.sha256 },\n };\n const assessments: CanonicalSeverityAssessment[] = [];\n for (const record of data.records) {\n options.signal?.throwIfAborted();\n let code: \"review_failed\" | \"invalid_assessment\" = \"review_failed\";\n try {\n const { findingId: _findingId, ...decision } = await reviewSeverity(\n async () => {\n code = \"review_failed\";\n const response = await abortable(() => {\n options.signal?.throwIfAborted();\n return options.reviewRunner.run(\n {\n requestId: randomUUID(),\n stage: \"severity-classification\",\n model: data.model,\n effort: data.effort,\n trustedInstructions: severityReviewInstructions,\n prompt: `{\"rubric\":${JSON.stringify([rubric.markdown])},\"knowledgeBase\":null,\"finding\":${record.findingJson}}`,\n schema: z.toJSONSchema(severityDecisionSchema),\n },\n { signal: options.signal },\n );\n }, options.signal);\n options.signal?.throwIfAborted();\n code = \"invalid_assessment\";\n return parseSeverityDecision(response, record.id);\n },\n classificationRuns,\n );\n options.signal?.throwIfAborted();\n assessments.push({\n ...decision,\n id: record.id,\n revision: record.revision,\n inputSha256: record.inputSha256,\n });\n } catch (error) {\n options.signal?.throwIfAborted();\n return {\n ...binding,\n status: \"unresolved\",\n assessments: [],\n error: {\n recordId: record.id,\n code,\n message:\n error instanceof Error\n ? error.message\n : code === \"review_failed\"\n ? \"Host review failed.\"\n : \"Invalid assessment.\",\n },\n };\n }\n }\n return { ...binding, status: \"completed\", assessments };\n}\n"]}
|
|
@@ -5,8 +5,10 @@ import { severityDecisionSchema as decisionSchema } from "./severity-review.js";
|
|
|
5
5
|
/** Full reports and explicitly supplied context from any finding source. */
|
|
6
6
|
export type SeverityClassificationFinding = Pick<Finding, "findingId" | "title" | "summary"> & Partial<Pick<Finding, "occurrenceId" | "severity">> & Record<string, unknown>;
|
|
7
7
|
export interface ClassifySeverityOptions extends Pick<ReadOnlyCodexOptions, "config" | "environment" | "model" | "reasoningEffort" | "signal" | "workingDirectory"> {
|
|
8
|
-
/** Classification policy. Omit to
|
|
8
|
+
/** Classification policy override. Omit to use the built-in severity rubric. */
|
|
9
9
|
rubricPath?: string;
|
|
10
|
+
/** Independent reviews per finding: integer 1–10, default 3. */
|
|
11
|
+
classificationRuns?: number;
|
|
10
12
|
/** Supporting evidence, separate from classification policy. */
|
|
11
13
|
knowledgeBasePaths?: readonly string[];
|
|
12
14
|
}
|
|
@@ -18,6 +20,8 @@ export interface SeverityAssessment extends z.infer<typeof decisionSchema> {
|
|
|
18
20
|
export interface SeverityClassification {
|
|
19
21
|
schemaVersion: 1;
|
|
20
22
|
assessedAt: string;
|
|
23
|
+
/** Absent on legacy results whose review count was not recorded. */
|
|
24
|
+
classificationRuns?: number;
|
|
21
25
|
rubricSha256: string | null;
|
|
22
26
|
knowledgeBaseSha256: string | null;
|
|
23
27
|
assessments: SeverityAssessment[];
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify-severity.d.ts","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,IAAI,cAAc,
|
|
1
|
+
{"version":3,"file":"classify-severity.d.ts","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAIxB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAEL,KAAK,oBAAoB,EAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACL,sBAAsB,IAAI,cAAc,EAKzC,MAAM,sBAAsB,CAAC;AAG9B,4EAA4E;AAC5E,MAAM,MAAM,6BAA6B,GAAG,IAAI,CAC9C,OAAO,EACP,WAAW,GAAG,OAAO,GAAG,SAAS,CAClC,GACC,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,GAAG,UAAU,CAAC,CAAC,GACnD,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAE1B,MAAM,WAAW,uBAAwB,SAAQ,IAAI,CACnD,oBAAoB,EAClB,QAAQ,GACR,aAAa,GACb,OAAO,GACP,iBAAiB,GACjB,QAAQ,GACR,kBAAkB,CACrB;IACC,gFAAgF;IAChF,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,gEAAgE;IAChE,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAGxC;AAED,MAAM,WAAW,kBAAmB,SAAQ,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC;IACxE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,CAAC;IACpB,MAAM,EAAE,mBAAmB,GAAG,QAAQ,CAAC;CACxC;AAED,MAAM,WAAW,sBAAsB;IACrC,aAAa,EAAE,CAAC,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,oEAAoE;IACpE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,WAAW,EAAE,kBAAkB,EAAE,CAAC;CACnC;AAiCD,yFAAyF;AACzF,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,SAAS,6BAA6B,EAAE,EAClD,OAAO,GAAE,uBAA4B,GACpC,OAAO,CAAC,sBAAsB,CAAC,CAEjC"}
|
|
@@ -1,13 +1,12 @@
|
|
|
1
|
-
import {
|
|
1
|
+
import { defaultSeverityRubric } from "./default-severity-rubric.js";
|
|
2
2
|
import { findingEntry } from "./value.js";
|
|
3
3
|
import { z } from "zod";
|
|
4
4
|
import { CodexSecurityError } from "./errors.js";
|
|
5
5
|
import { workflowDigest } from "./finding-workflow.js";
|
|
6
6
|
import { readKnowledgeBaseDocuments } from "./knowledge-base.js";
|
|
7
7
|
import { runReadOnlyCodex, } from "./scan-comparison.js";
|
|
8
|
-
import { severityDecisionSchema as decisionSchema, severityReviewInstructions, parseSeverityDecision, } from "./severity-review.js";
|
|
8
|
+
import { severityDecisionSchema as decisionSchema, severityReviewInstructions, parseSeverityDecision, reviewSeverity, classificationRunsSchema, } from "./severity-review.js";
|
|
9
9
|
import { CODEX_SECURITY_THREAD_SOURCES } from "./thread-source.js";
|
|
10
|
-
const levelSchema = z.enum(SCAN_SEVERITIES);
|
|
11
10
|
const textSchema = z
|
|
12
11
|
.string()
|
|
13
12
|
.min(1)
|
|
@@ -17,6 +16,7 @@ const digestSchema = z.string().regex(/^[a-f0-9]{64}$/u);
|
|
|
17
16
|
export const severityClassificationSchema = z.strictObject({
|
|
18
17
|
schemaVersion: z.literal(1),
|
|
19
18
|
assessedAt: z.string().datetime(),
|
|
19
|
+
classificationRuns: classificationRunsSchema.optional(),
|
|
20
20
|
rubricSha256: digestSchema.nullable(),
|
|
21
21
|
knowledgeBaseSha256: digestSchema.nullable(),
|
|
22
22
|
assessments: z.array(decisionSchema.extend({
|
|
@@ -32,6 +32,9 @@ export async function classifySeverity(findings, options = {}) {
|
|
|
32
32
|
/** @internal */
|
|
33
33
|
export async function classifySeverityInternal(findings, options = {}, surface = "sdk", checkpoint) {
|
|
34
34
|
options.signal?.throwIfAborted();
|
|
35
|
+
const classificationRuns = classificationRunsSchema
|
|
36
|
+
.default(3)
|
|
37
|
+
.parse(options.classificationRuns);
|
|
35
38
|
const ids = new Set();
|
|
36
39
|
for (const finding of findings) {
|
|
37
40
|
if (!finding.findingId?.trim() || ids.has(finding.findingId)) {
|
|
@@ -40,15 +43,16 @@ export async function classifySeverityInternal(findings, options = {}, surface =
|
|
|
40
43
|
ids.add(finding.findingId);
|
|
41
44
|
}
|
|
42
45
|
const rubric = options.rubricPath === undefined
|
|
43
|
-
?
|
|
46
|
+
? [defaultSeverityRubric]
|
|
44
47
|
: await readDocuments([options.rubricPath], options.signal);
|
|
45
48
|
const knowledge = options.knowledgeBasePaths?.length
|
|
46
49
|
? await readDocuments(options.knowledgeBasePaths, options.signal)
|
|
47
50
|
: null;
|
|
48
51
|
const result = {
|
|
49
52
|
schemaVersion: 1,
|
|
53
|
+
classificationRuns,
|
|
50
54
|
assessedAt: new Date().toISOString(),
|
|
51
|
-
rubricSha256:
|
|
55
|
+
rubricSha256: workflowDigest(rubric),
|
|
52
56
|
knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),
|
|
53
57
|
assessments: [],
|
|
54
58
|
};
|
|
@@ -64,45 +68,31 @@ export async function classifySeverityInternal(findings, options = {}, surface =
|
|
|
64
68
|
result.assessments.push(previous);
|
|
65
69
|
continue;
|
|
66
70
|
}
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
findingId: finding.findingId,
|
|
75
|
-
decision: "assessed",
|
|
76
|
-
level: parsed.data,
|
|
77
|
-
rubricLabel: null,
|
|
78
|
-
rationale: finding.severity?.rationale?.trim() ||
|
|
79
|
-
"Inherited the finding's existing severity.",
|
|
80
|
-
confidence: null,
|
|
81
|
-
reviewTrigger: finding.severity?.changeConditions?.trim() || null,
|
|
82
|
-
};
|
|
83
|
-
}
|
|
84
|
-
else {
|
|
85
|
-
const response = await runReadOnlyCodex([
|
|
86
|
-
severityReviewInstructions,
|
|
87
|
-
JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),
|
|
88
|
-
].join("\n\n"), z.toJSONSchema(decisionSchema), options, {
|
|
71
|
+
const prompt = [
|
|
72
|
+
severityReviewInstructions,
|
|
73
|
+
JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),
|
|
74
|
+
].join("\n\n");
|
|
75
|
+
const decision = await reviewSeverity(async () => {
|
|
76
|
+
options.signal?.throwIfAborted();
|
|
77
|
+
const response = await runReadOnlyCodex(prompt, z.toJSONSchema(decisionSchema), options, {
|
|
89
78
|
surface,
|
|
90
79
|
command: "classify-severity",
|
|
91
80
|
threadSource: CODEX_SECURITY_THREAD_SOURCES.severityClassification,
|
|
92
81
|
});
|
|
93
82
|
options.signal?.throwIfAborted();
|
|
94
83
|
try {
|
|
95
|
-
|
|
84
|
+
return parseSeverityDecision(JSON.parse(response), finding.findingId);
|
|
96
85
|
}
|
|
97
86
|
catch (error) {
|
|
98
87
|
throw new CodexSecurityError("Severity classification returned an invalid assessment.", { cause: error });
|
|
99
88
|
}
|
|
100
|
-
}
|
|
89
|
+
}, classificationRuns);
|
|
90
|
+
options.signal?.throwIfAborted();
|
|
101
91
|
const assessment = {
|
|
102
92
|
...decision,
|
|
103
93
|
occurrenceId: finding.occurrenceId ?? null,
|
|
104
94
|
inputSha256,
|
|
105
|
-
source:
|
|
95
|
+
source: "rubric",
|
|
106
96
|
};
|
|
107
97
|
await checkpoint?.save(finding, assessment, result);
|
|
108
98
|
result.assessments.push(assessment);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"classify-severity.js","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"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","sourcesContent":["import { SCAN_SEVERITIES } from \"./scan-settings.js\";\nimport { findingEntry } from \"./value.js\";\nimport { z } from \"zod\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport { workflowDigest } from \"./finding-workflow.js\";\nimport { readKnowledgeBaseDocuments } from \"./knowledge-base.js\";\nimport type { Finding } from \"./models.js\";\nimport {\n runReadOnlyCodex,\n type ReadOnlyCodexOptions,\n} from \"./scan-comparison.js\";\nimport {\n severityDecisionSchema as decisionSchema,\n severityReviewInstructions,\n parseSeverityDecision,\n} from \"./severity-review.js\";\nimport { CODEX_SECURITY_THREAD_SOURCES } from \"./thread-source.js\";\n\n/** Full reports and explicitly supplied context from any finding source. */\nexport type SeverityClassificationFinding = Pick<\n Finding,\n \"findingId\" | \"title\" | \"summary\"\n> &\n Partial<Pick<Finding, \"occurrenceId\" | \"severity\">> &\n Record<string, unknown>;\n\nexport interface ClassifySeverityOptions extends Pick<\n ReadOnlyCodexOptions,\n | \"config\"\n | \"environment\"\n | \"model\"\n | \"reasoningEffort\"\n | \"signal\"\n | \"workingDirectory\"\n> {\n /** Classification policy. Omit to inherit existing severity without a model call. */\n rubricPath?: string;\n /** Supporting evidence, separate from classification policy. */\n knowledgeBasePaths?: readonly string[];\n /** @internal Test client for the shared read-only runtime. */\n codex?: ReadOnlyCodexOptions[\"codex\"];\n}\n\nexport interface SeverityAssessment extends z.infer<typeof decisionSchema> {\n occurrenceId: string | null;\n inputSha256: string;\n source: \"existing-severity\" | \"rubric\";\n}\n\nexport interface SeverityClassification {\n schemaVersion: 1;\n assessedAt: string;\n rubricSha256: string | null;\n knowledgeBaseSha256: string | null;\n assessments: SeverityAssessment[];\n}\n\n/** @internal Per-finding persistence used by saved-scan classification. */\nexport interface SeverityClassificationCheckpoint {\n load(result: SeverityClassification): Promise<SeverityAssessment[]>;\n save(\n finding: SeverityClassificationFinding,\n assessment: SeverityAssessment,\n result: SeverityClassification,\n ): Promise<void>;\n}\n\nconst levelSchema = z.enum(SCAN_SEVERITIES);\nconst textSchema = z\n .string()\n .min(1)\n .refine((value) => value.trim().length > 0);\nconst digestSchema = z.string().regex(/^[a-f0-9]{64}$/u);\n/** @internal */\nexport const severityClassificationSchema = z.strictObject({\n schemaVersion: z.literal(1),\n assessedAt: z.string().datetime(),\n rubricSha256: digestSchema.nullable(),\n knowledgeBaseSha256: digestSchema.nullable(),\n assessments: z.array(\n decisionSchema.extend({\n occurrenceId: textSchema.nullable(),\n inputSha256: digestSchema,\n source: z.enum([\"existing-severity\", \"rubric\"]),\n }),\n ),\n}) satisfies z.ZodType<SeverityClassification>;\n\n/** Classify each supplied report independently, without scanning or writing findings. */\nexport async function classifySeverity(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n): Promise<SeverityClassification> {\n return classifySeverityInternal(findings, options);\n}\n\n/** @internal */\nexport async function classifySeverityInternal(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n surface: \"sdk\" | \"cli\" = \"sdk\",\n checkpoint?: SeverityClassificationCheckpoint,\n): Promise<SeverityClassification> {\n options.signal?.throwIfAborted();\n const ids = new Set<string>();\n for (const finding of findings) {\n if (!finding.findingId?.trim() || ids.has(finding.findingId)) {\n throw new CodexSecurityError(\n \"Severity classification requires unique finding IDs.\",\n );\n }\n ids.add(finding.findingId);\n }\n const rubric =\n options.rubricPath === undefined\n ? null\n : await readDocuments([options.rubricPath], options.signal);\n const knowledge = options.knowledgeBasePaths?.length\n ? await readDocuments(options.knowledgeBasePaths, options.signal)\n : null;\n const result: SeverityClassification = {\n schemaVersion: 1,\n assessedAt: new Date().toISOString(),\n rubricSha256: rubric === null ? null : workflowDigest(rubric),\n knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),\n assessments: [],\n };\n const cached = new Map((await checkpoint?.load(result))?.map(findingEntry));\n for (const finding of findings) {\n options.signal?.throwIfAborted();\n const inputSha256 = workflowDigest(finding);\n const previous = cached.get(finding.findingId);\n if (previous?.inputSha256 === inputSha256) {\n validateSeverityClassification({ ...result, assessments: [previous] }, [\n finding,\n ]);\n result.assessments.push(previous);\n continue;\n }\n let decision: z.infer<typeof decisionSchema>;\n if (rubric === null) {\n const parsed = levelSchema.safeParse(finding.severity?.level);\n if (!parsed.success) {\n throw new CodexSecurityError(\n `Finding ${finding.findingId} has no existing severity; supply a rubric.`,\n );\n }\n decision = {\n findingId: finding.findingId,\n decision: \"assessed\",\n level: parsed.data,\n rubricLabel: null,\n rationale:\n finding.severity?.rationale?.trim() ||\n \"Inherited the finding's existing severity.\",\n confidence: null,\n reviewTrigger: finding.severity?.changeConditions?.trim() || null,\n };\n } else {\n const response = await runReadOnlyCodex(\n [\n severityReviewInstructions,\n JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),\n ].join(\"\\n\\n\"),\n z.toJSONSchema(decisionSchema),\n options,\n {\n surface,\n command: \"classify-severity\",\n threadSource: CODEX_SECURITY_THREAD_SOURCES.severityClassification,\n },\n );\n options.signal?.throwIfAborted();\n try {\n decision = parseSeverityDecision(\n JSON.parse(response),\n finding.findingId,\n );\n } catch (error) {\n throw new CodexSecurityError(\n \"Severity classification returned an invalid assessment.\",\n { cause: error },\n );\n }\n }\n const assessment: SeverityAssessment = {\n ...decision,\n occurrenceId: finding.occurrenceId ?? null,\n inputSha256,\n source: rubric === null ? \"existing-severity\" : \"rubric\",\n };\n await checkpoint?.save(finding, assessment, result);\n result.assessments.push(assessment);\n }\n options.signal?.throwIfAborted();\n return result;\n}\n\nasync function readDocuments(\n paths: readonly string[],\n signal?: AbortSignal,\n): Promise<string[]> {\n const contents = await readKnowledgeBaseDocuments(paths, signal);\n if (contents.every((text) => !text.trim())) {\n throw new CodexSecurityError(\"Classification documents must not be empty.\");\n }\n return contents;\n}\n\n/** @internal Check parsed assessments against the actual finding evidence. */\nexport function validateSeverityClassification(\n result: SeverityClassification,\n findings: readonly SeverityClassificationFinding[],\n): SeverityClassification {\n const byId = new Map(findings.map(findingEntry));\n for (const assessment of result.assessments) {\n const finding = byId.get(assessment.findingId);\n if (\n !finding ||\n assessment.occurrenceId !== (finding.occurrenceId ?? null) ||\n assessment.inputSha256 !== workflowDigest(finding) ||\n (assessment.source === \"rubric\") !== (result.rubricSha256 !== null) ||\n (assessment.decision === \"assessed\"\n ? assessment.level === null\n : assessment.level !== null) ||\n (assessment.source === \"rubric\" &&\n (assessment.decision === \"assessed\"\n ? assessment.rubricLabel === null\n : assessment.rubricLabel !== null)) ||\n (assessment.source === \"existing-severity\" &&\n (assessment.decision !== \"assessed\" ||\n assessment.level !== finding.severity?.level))\n ) {\n throw new CodexSecurityError(\n \"Severity assessment does not match the supplied findings. Classify the findings again.\",\n );\n }\n byId.delete(assessment.findingId);\n }\n return result;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"classify-severity.js","sourceRoot":"","sources":["../src/classify-severity.ts"],"names":[],"mappings":"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","sourcesContent":["import { defaultSeverityRubric } from \"./default-severity-rubric.js\";\nimport { findingEntry } from \"./value.js\";\nimport { z } from \"zod\";\nimport { CodexSecurityError } from \"./errors.js\";\nimport { workflowDigest } from \"./finding-workflow.js\";\nimport { readKnowledgeBaseDocuments } from \"./knowledge-base.js\";\nimport type { Finding } from \"./models.js\";\nimport {\n runReadOnlyCodex,\n type ReadOnlyCodexOptions,\n} from \"./scan-comparison.js\";\nimport {\n severityDecisionSchema as decisionSchema,\n severityReviewInstructions,\n parseSeverityDecision,\n reviewSeverity,\n classificationRunsSchema,\n} from \"./severity-review.js\";\nimport { CODEX_SECURITY_THREAD_SOURCES } from \"./thread-source.js\";\n\n/** Full reports and explicitly supplied context from any finding source. */\nexport type SeverityClassificationFinding = Pick<\n Finding,\n \"findingId\" | \"title\" | \"summary\"\n> &\n Partial<Pick<Finding, \"occurrenceId\" | \"severity\">> &\n Record<string, unknown>;\n\nexport interface ClassifySeverityOptions extends Pick<\n ReadOnlyCodexOptions,\n | \"config\"\n | \"environment\"\n | \"model\"\n | \"reasoningEffort\"\n | \"signal\"\n | \"workingDirectory\"\n> {\n /** Classification policy override. Omit to use the built-in severity rubric. */\n rubricPath?: string;\n /** Independent reviews per finding: integer 1–10, default 3. */\n classificationRuns?: number;\n /** Supporting evidence, separate from classification policy. */\n knowledgeBasePaths?: readonly string[];\n /** @internal Test client for the shared read-only runtime. */\n codex?: ReadOnlyCodexOptions[\"codex\"];\n}\n\nexport interface SeverityAssessment extends z.infer<typeof decisionSchema> {\n occurrenceId: string | null;\n inputSha256: string;\n source: \"existing-severity\" | \"rubric\";\n}\n\nexport interface SeverityClassification {\n schemaVersion: 1;\n assessedAt: string;\n /** Absent on legacy results whose review count was not recorded. */\n classificationRuns?: number;\n rubricSha256: string | null;\n knowledgeBaseSha256: string | null;\n assessments: SeverityAssessment[];\n}\n\n/** @internal Per-finding persistence used by saved-scan classification. */\nexport interface SeverityClassificationCheckpoint {\n load(result: SeverityClassification): Promise<SeverityAssessment[]>;\n save(\n finding: SeverityClassificationFinding,\n assessment: SeverityAssessment,\n result: SeverityClassification,\n ): Promise<void>;\n}\n\nconst textSchema = z\n .string()\n .min(1)\n .refine((value) => value.trim().length > 0);\nconst digestSchema = z.string().regex(/^[a-f0-9]{64}$/u);\n/** @internal */\nexport const severityClassificationSchema = z.strictObject({\n schemaVersion: z.literal(1),\n assessedAt: z.string().datetime(),\n classificationRuns: classificationRunsSchema.optional(),\n rubricSha256: digestSchema.nullable(),\n knowledgeBaseSha256: digestSchema.nullable(),\n assessments: z.array(\n decisionSchema.extend({\n occurrenceId: textSchema.nullable(),\n inputSha256: digestSchema,\n source: z.enum([\"existing-severity\", \"rubric\"]),\n }),\n ),\n}) satisfies z.ZodType<SeverityClassification>;\n\n/** Classify each supplied report independently, without scanning or writing findings. */\nexport async function classifySeverity(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n): Promise<SeverityClassification> {\n return classifySeverityInternal(findings, options);\n}\n\n/** @internal */\nexport async function classifySeverityInternal(\n findings: readonly SeverityClassificationFinding[],\n options: ClassifySeverityOptions = {},\n surface: \"sdk\" | \"cli\" = \"sdk\",\n checkpoint?: SeverityClassificationCheckpoint,\n): Promise<SeverityClassification> {\n options.signal?.throwIfAborted();\n const classificationRuns = classificationRunsSchema\n .default(3)\n .parse(options.classificationRuns);\n const ids = new Set<string>();\n for (const finding of findings) {\n if (!finding.findingId?.trim() || ids.has(finding.findingId)) {\n throw new CodexSecurityError(\n \"Severity classification requires unique finding IDs.\",\n );\n }\n ids.add(finding.findingId);\n }\n const rubric =\n options.rubricPath === undefined\n ? [defaultSeverityRubric]\n : await readDocuments([options.rubricPath], options.signal);\n const knowledge = options.knowledgeBasePaths?.length\n ? await readDocuments(options.knowledgeBasePaths, options.signal)\n : null;\n const result: SeverityClassification = {\n schemaVersion: 1,\n classificationRuns,\n assessedAt: new Date().toISOString(),\n rubricSha256: workflowDigest(rubric),\n knowledgeBaseSha256: knowledge === null ? null : workflowDigest(knowledge),\n assessments: [],\n };\n const cached = new Map((await checkpoint?.load(result))?.map(findingEntry));\n for (const finding of findings) {\n options.signal?.throwIfAborted();\n const inputSha256 = workflowDigest(finding);\n const previous = cached.get(finding.findingId);\n if (previous?.inputSha256 === inputSha256) {\n validateSeverityClassification({ ...result, assessments: [previous] }, [\n finding,\n ]);\n result.assessments.push(previous);\n continue;\n }\n const prompt = [\n severityReviewInstructions,\n JSON.stringify({ rubric, knowledgeBase: knowledge, finding }),\n ].join(\"\\n\\n\");\n const decision = await reviewSeverity(async () => {\n options.signal?.throwIfAborted();\n const response = await runReadOnlyCodex(\n prompt,\n z.toJSONSchema(decisionSchema),\n options,\n {\n surface,\n command: \"classify-severity\",\n threadSource: CODEX_SECURITY_THREAD_SOURCES.severityClassification,\n },\n );\n options.signal?.throwIfAborted();\n try {\n return parseSeverityDecision(JSON.parse(response), finding.findingId);\n } catch (error) {\n throw new CodexSecurityError(\n \"Severity classification returned an invalid assessment.\",\n { cause: error },\n );\n }\n }, classificationRuns);\n options.signal?.throwIfAborted();\n const assessment: SeverityAssessment = {\n ...decision,\n occurrenceId: finding.occurrenceId ?? null,\n inputSha256,\n source: \"rubric\",\n };\n await checkpoint?.save(finding, assessment, result);\n result.assessments.push(assessment);\n }\n options.signal?.throwIfAborted();\n return result;\n}\n\nasync function readDocuments(\n paths: readonly string[],\n signal?: AbortSignal,\n): Promise<string[]> {\n const contents = await readKnowledgeBaseDocuments(paths, signal);\n if (contents.every((text) => !text.trim())) {\n throw new CodexSecurityError(\"Classification documents must not be empty.\");\n }\n return contents;\n}\n\n/** @internal Check parsed assessments against the actual finding evidence. */\nexport function validateSeverityClassification(\n result: SeverityClassification,\n findings: readonly SeverityClassificationFinding[],\n): SeverityClassification {\n const byId = new Map(findings.map(findingEntry));\n for (const assessment of result.assessments) {\n const finding = byId.get(assessment.findingId);\n if (\n !finding ||\n assessment.occurrenceId !== (finding.occurrenceId ?? null) ||\n assessment.inputSha256 !== workflowDigest(finding) ||\n (assessment.source === \"rubric\") !== (result.rubricSha256 !== null) ||\n (assessment.decision === \"assessed\"\n ? assessment.level === null\n : assessment.level !== null) ||\n (assessment.source === \"rubric\" &&\n (assessment.decision === \"assessed\"\n ? assessment.rubricLabel === null\n : assessment.rubricLabel !== null)) ||\n (assessment.source === \"existing-severity\" &&\n (assessment.decision !== \"assessed\" ||\n assessment.level !== finding.severity?.level))\n ) {\n throw new CodexSecurityError(\n \"Severity assessment does not match the supplied findings. Classify the findings again.\",\n );\n }\n byId.delete(assessment.findingId);\n }\n return result;\n}\n"]}
|
package/dist/cli-help.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"
|
|
1
|
+
{"version":3,"file":"cli-help.d.ts","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"AA+OA,qFAAqF;AACrF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,SAAK,GAAG,MAAM,CA4HhE"}
|
package/dist/cli-help.js
CHANGED
package/dist/cli-help.js.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEEP_SCAN_SETTINGS, DeepScanSettingsSchema } from \"./scan-settings.js\";\n\ntype Row = { label: string; description: string };\ntype Group = readonly [title: string, names: readonly string[]];\n\nconst COMMAND_GROUPS: readonly Group[] = [\n [\"Scan and fix\", [\"scan\", \"policy\", \"validate\", \"patch\", \"verify-fix\"]],\n [\n \"Review and share\",\n [\n \"scans\",\n \"findings\",\n \"classify-severity\",\n \"dedupe\",\n \"suggest-owners\",\n \"export\",\n \"import\",\n \"publish\",\n ],\n ],\n [\"Automate\", [\"bulk-scan\", \"scan-components\", \"install-hook\"]],\n [\"Setup and support\", [\"login\", \"logout\", \"init\", \"info\", \"feedback\"]],\n];\n\nconst SCAN_GROUPS: readonly Group[] = [\n [\"Scope\", [\"path\", \"diff\", \"head\", \"working-tree\", \"base\"]],\n [\"Configuration\", [\"config\", \"mode\", \"knowledge-base\", \"dry-run\"]],\n [\"Model and authentication\", [\"auth\", \"model\", \"effort\", \"provider\"]],\n [\n \"Deep Scan\",\n DEEP_SCAN_SETTINGS.flatMap(([, , , flag]) =>\n flag === null ? [] : [flag.slice(2)],\n ),\n ],\n [\n \"Results, progress, and limits\",\n [\n \"output-dir\",\n \"archive-existing\",\n \"max-cost\",\n \"max-time\",\n \"show-cost\",\n \"fail-on-severity\",\n \"headless\",\n \"verbose\",\n ],\n ],\n [\"Patch after scanning\", [\"patch\", \"patch-severity\", \"create-pr\"]],\n];\n\nconst PUBLISH_GROUPS: readonly Group[] = [\n [\"Input\", [\"scan\", \"scan-dir\", \"csv\", \"finding-id\", \"workflow-id\"]],\n [\"Destination\", [\"to\", \"findings-url\"]],\n [\n \"Linear\",\n [\n \"linear-team\",\n \"linear-project\",\n \"linear-assignee\",\n \"linear-api-key\",\n \"project\",\n ],\n ],\n [\"Publishing\", [\"dry-run\", \"skip-existing\"]],\n];\n\nconst VALUE_LABELS: Record<string, string> = {\n context: \"text\",\n \"context-file\": \"file\",\n \"output-schema\": \"file\",\n config: \"file\",\n path: \"path\",\n \"knowledge-base\": \"path\",\n \"scan-prompt-file\": \"file\",\n \"validation-prompt-file\": \"file\",\n \"post-scan-prompt-file\": \"file\",\n diff: \"ref\",\n head: \"ref\",\n base: \"ref\",\n model: \"model\",\n \"output-dir\": \"path\",\n \"scan-dir\": \"path\",\n \"plugin-path\": \"path\",\n \"source-root\": \"path\",\n python: \"path\",\n codex: \"key=value\",\n \"max-cost\": \"usd\",\n \"max-time\": \"minutes\",\n \"max-time-hours\": \"hours\",\n \"fail-on-severity\": \"level\",\n \"patch-severity\": \"level\",\n severity: \"level\",\n scan: \"scan-id\",\n \"finding-id\": \"id\",\n \"findings-url\": \"url\",\n output: \"file\",\n csv: \"file\",\n json: \"file\",\n rubric: \"file\",\n \"export-format\": \"format\",\n \"filter-output\": \"keys\",\n \"token-limit\": \"count\",\n \"token-offset\": \"count\",\n to: \"destination\",\n};\n\nconst OUTPUT_GROUPS: readonly Group[] = [\n [\"Help and updates\", [\"help\", \"version\", \"update\"]],\n [\"Output\", [\"format\", \"json\", \"filter-output\", \"full-output\"]],\n];\n\nfunction rowName(row: Row): string {\n return row.label.match(/--([\\w-]+)/u)?.[1] ?? row.label;\n}\n\nfunction parseRows(lines: string[]): Row[] {\n return lines.map((line) => {\n const match = line.trim().match(/^(.*?)\\s{2,}(.*)$/u);\n return { label: match?.[1] ?? line.trim(), description: match?.[2] ?? \"\" };\n });\n}\n\nfunction wrap(text: string, width: number, prefix = \"\", next = prefix): string {\n const lines: string[] = [];\n let line = prefix;\n let indent = prefix.length;\n for (const word of text.split(/\\s+/u)) {\n if (line.length > indent && line.length + 1 + word.length > width) {\n lines.push(line);\n line = next;\n indent = next.length;\n }\n line += `${line.length > indent ? \" \" : \"\"}${word}`;\n }\n lines.push(line);\n return lines.join(\"\\n\");\n}\n\nfunction renderRows(title: string, rows: Row[], width: number): string {\n // Keep long option names from moving every description across the terminal.\n const column = Math.min(\n 30,\n Math.floor(width / 2),\n Math.max(...rows.map((row) => row.label.length)) + 4,\n );\n return [\n `${title}:`,\n ...rows.map(({ label, description }) => {\n if (!description) return ` ${label}`;\n if (label.length + 4 > column) {\n return ` ${label}\\n${wrap(description, width, \" \")}`;\n }\n return wrap(\n description,\n width,\n ` ${label}${\" \".repeat(column - label.length - 2)}`,\n \" \".repeat(column),\n );\n }),\n ].join(\"\\n\");\n}\n\nfunction groupedRows(\n rows: Row[],\n groups: readonly Group[],\n remainingTitle: string,\n width: number,\n): string[] {\n const remaining = new Map(rows.map((row) => [rowName(row), row]));\n const sections: string[] = [];\n for (const [title, names] of groups) {\n const selected = names.flatMap((name) => {\n const row = remaining.get(name);\n remaining.delete(name);\n return row === undefined ? [] : [row];\n });\n if (selected.length) sections.push(renderRows(title, selected, width));\n }\n if (remaining.size) {\n sections.push(renderRows(remainingTitle, [...remaining.values()], width));\n }\n return sections;\n}\n\nfunction optionRow(row: Row, command: string): Row {\n const name = rowName(row);\n let { label, description } = row;\n label = label.replace(/<([^>]+)>/u, (_, type: string) => {\n const choices = type.split(\"|\");\n if (choices.length > 1) {\n description += `${description.endsWith(\".\") ? \"\" : \".\"} Choices: ${choices.join(\", \")}.`;\n }\n return `<${VALUE_LABELS[name] ?? (type === \"number\" ? \"count\" : name)}>`;\n });\n label = label.replace(/^--([\\w-]+), (-\\w)/u, \"$2, --$1\");\n if (command === \"scan\" && !/default:/iu.test(description)) {\n const setting = DEEP_SCAN_SETTINGS.find(\n ([, , , flag]) => flag === `--${name}`,\n );\n if (setting) {\n const value =\n DeepScanSettingsSchema.shape[setting[0]].meta()?.[\"default\"];\n if (value !== undefined) description += ` (default: ${value})`;\n }\n }\n return { label, description };\n}\n\nfunction globalRows(rows: Row[], command: string): Row[] {\n const scan = command === \"scan\" || command === \"scan import\";\n const plainOutput = [\"validate\", \"login\", \"logout\", \"export\"].includes(\n command,\n );\n const visible = rows.filter(({ label }) => {\n if (scan && label.startsWith(\"--filter-output\")) return false;\n return !(\n plainOutput &&\n /^(--format |--filter-output |--full-output$|--token-)/u.test(label)\n );\n });\n const formats = visible.find((row) => rowName(row) === \"format\");\n if (formats && (scan || command === \"scans rerun\")) {\n formats.label = formats.label.replace(\"|md\", \"\");\n }\n if (formats && command !== \"scan import\") {\n visible.push({\n label: \"--json\",\n description: \"Shorthand for --format json.\",\n });\n }\n return visible.map((row) =>\n optionRow(\n row.label === \"--help\" ? { ...row, label: \"-h, --help\" } : row,\n command,\n ),\n );\n}\n\n/** Present Incur's generated help without changing its routing or command output. */\nexport function formatCliHelp(text: string, columns = 80): string {\n const header = text.match(\n /^(codex-security(?:@[^\\s]+)?((?: [a-z][a-z-]*)*))(?: — ([^\\n]*))?\\n\\nUsage: /u,\n );\n if (!header) return text;\n const command = header[2]!.trim();\n const sections: string[] = [];\n // Presentation width only; long paths and copyable commands remain intact.\n const width = columns > 0 ? columns : 80;\n const blocks = text.trimEnd().split(/\\n\\n/u);\n const examples = blocks.find((block) => block.startsWith(\"Examples:\\n\"));\n for (const [index, block] of blocks.entries()) {\n const [title = \"\", ...lines] = block.split(\"\\n\");\n if (index === 0) {\n sections.push(\n [header[1], header[3] && wrap(header[3], width)]\n .filter(Boolean)\n .join(\"\\n\"),\n );\n } else if (title.startsWith(\"Usage: \")) {\n let usage = block.replace(\n /([a-z])([A-Z])/gu,\n (_, lower: string, upper: string) => `${lower}-${upper.toLowerCase()}`,\n );\n if (command === \"scans\" || command === \"findings\") {\n usage = usage.replace(\"<command>\", \"[command]\");\n usage += \"\\nDefault command: list\";\n }\n sections.push(\n usage\n .split(\"\\n\")\n .map((line) => wrap(line, width, \"\", \" \"))\n .join(\"\\n\"),\n );\n if (command === \"\") {\n sections.push(\n [\n \"Get started:\",\n \" codex-security login\",\n \"\",\n wrap(\n \"In your repository, draft SECURITY.md (optional):\",\n width,\n \" \",\n \" \",\n ),\n \" codex-security policy .\",\n wrap(\n \"Review the diff and notes. Edit the draft, then copy only SECURITY.md to the Policy target shown.\",\n width,\n \" \",\n \" \",\n ),\n wrap(\n \"Skip this step to keep your existing policy or scan without one.\",\n width,\n \" \",\n \" \",\n ),\n \"\",\n \" codex-security scan .\",\n \" codex-security findings\",\n ].join(\"\\n\"),\n );\n } else if (examples) {\n sections.push(examples);\n }\n } else if (title === \"Examples:\") {\n continue;\n } else if (title === \"Commands:\") {\n const rows = parseRows(lines);\n sections.push(\n ...(command === \"\"\n ? groupedRows(rows, COMMAND_GROUPS, \"Other commands\", width)\n : [renderRows(\"Commands\", rows, width)]),\n );\n } else if (title === \"Options:\") {\n const rows = parseRows(lines).map((row) => optionRow(row, command));\n sections.push(\n ...(command === \"scan\"\n ? groupedRows(rows, SCAN_GROUPS, \"Advanced\", width)\n : command === \"publish scan\"\n ? groupedRows(rows, PUBLISH_GROUPS, \"Options\", width)\n : [renderRows(\"Options\", rows, width)]),\n );\n } else if (title === \"Global Options:\") {\n sections.push(\n ...groupedRows(\n globalRows(parseRows(lines), command),\n OUTPUT_GROUPS,\n \"Agent options\",\n width,\n ),\n );\n } else if (\n [\"Arguments:\", \"Integrations:\", \"Environment Variables:\"].includes(title)\n ) {\n const rows = parseRows(lines).map((row) => ({\n ...row,\n label:\n title === \"Arguments:\"\n ? row.label.replace(/([a-z])([A-Z])/gu, \"$1-$2\").toLowerCase()\n : row.label,\n }));\n sections.push(renderRows(title.slice(0, -1), rows, width));\n } else {\n sections.push(\n block\n .split(\"\\n\")\n .map((line) => (line.startsWith(\" \") ? line : wrap(line, width)))\n .join(\"\\n\"),\n );\n }\n }\n if (command === \"\") {\n sections.push(\n wrap(\n \"Use codex-security <command> --help for options and examples.\",\n width,\n ),\n );\n sections.push(\"Docs: https://learn.chatgpt.com/docs/security/cli\");\n }\n return `${sections.join(\"\\n\\n\")}\\n`;\n}\n"]}
|
|
1
|
+
{"version":3,"file":"cli-help.js","sourceRoot":"","sources":["../src/cli-help.ts"],"names":[],"mappings":"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","sourcesContent":["import { DEEP_SCAN_SETTINGS, DeepScanSettingsSchema } from \"./scan-settings.js\";\n\ntype Row = { label: string; description: string };\ntype Group = readonly [title: string, names: readonly string[]];\n\nconst COMMAND_GROUPS: readonly Group[] = [\n [\"Scan and fix\", [\"scan\", \"policy\", \"validate\", \"patch\", \"verify-fix\"]],\n [\n \"Review and share\",\n [\n \"scans\",\n \"findings\",\n \"classify-severity\",\n \"dedupe\",\n \"suggest-owners\",\n \"export\",\n \"import\",\n \"publish\",\n ],\n ],\n [\"Automate\", [\"bulk-scan\", \"scan-components\", \"install-hook\"]],\n [\"Setup and support\", [\"login\", \"logout\", \"init\", \"info\", \"feedback\"]],\n];\n\nconst SCAN_GROUPS: readonly Group[] = [\n [\"Scope\", [\"path\", \"diff\", \"head\", \"working-tree\", \"base\"]],\n [\"Configuration\", [\"config\", \"mode\", \"knowledge-base\", \"dry-run\"]],\n [\"Model and authentication\", [\"auth\", \"model\", \"effort\", \"provider\"]],\n [\n \"Deep Scan\",\n DEEP_SCAN_SETTINGS.flatMap(([, , , flag]) =>\n flag === null ? [] : [flag.slice(2)],\n ),\n ],\n [\n \"Results, progress, and limits\",\n [\n \"output-dir\",\n \"archive-existing\",\n \"owner-suggestions\",\n \"max-cost\",\n \"max-time\",\n \"show-cost\",\n \"fail-on-severity\",\n \"headless\",\n \"verbose\",\n ],\n ],\n [\"Patch after scanning\", [\"patch\", \"patch-severity\", \"create-pr\"]],\n];\n\nconst PUBLISH_GROUPS: readonly Group[] = [\n [\"Input\", [\"scan\", \"scan-dir\", \"csv\", \"finding-id\", \"workflow-id\"]],\n [\"Destination\", [\"to\", \"findings-url\"]],\n [\n \"Linear\",\n [\n \"linear-team\",\n \"linear-project\",\n \"linear-assignee\",\n \"linear-api-key\",\n \"project\",\n ],\n ],\n [\"Publishing\", [\"dry-run\", \"skip-existing\"]],\n];\n\nconst VALUE_LABELS: Record<string, string> = {\n context: \"text\",\n \"context-file\": \"file\",\n \"output-schema\": \"file\",\n config: \"file\",\n path: \"path\",\n \"knowledge-base\": \"path\",\n \"scan-prompt-file\": \"file\",\n \"validation-prompt-file\": \"file\",\n \"post-scan-prompt-file\": \"file\",\n diff: \"ref\",\n head: \"ref\",\n base: \"ref\",\n model: \"model\",\n \"output-dir\": \"path\",\n \"scan-dir\": \"path\",\n \"plugin-path\": \"path\",\n \"source-root\": \"path\",\n python: \"path\",\n codex: \"key=value\",\n \"max-cost\": \"usd\",\n \"max-time\": \"minutes\",\n \"max-time-hours\": \"hours\",\n \"fail-on-severity\": \"level\",\n \"patch-severity\": \"level\",\n severity: \"level\",\n scan: \"scan-id\",\n \"finding-id\": \"id\",\n \"findings-url\": \"url\",\n output: \"file\",\n csv: \"file\",\n json: \"file\",\n rubric: \"file\",\n \"export-format\": \"format\",\n \"filter-output\": \"keys\",\n \"token-limit\": \"count\",\n \"token-offset\": \"count\",\n to: \"destination\",\n};\n\nconst OUTPUT_GROUPS: readonly Group[] = [\n [\"Help and updates\", [\"help\", \"version\", \"update\"]],\n [\"Output\", [\"format\", \"json\", \"filter-output\", \"full-output\"]],\n];\n\nfunction rowName(row: Row): string {\n return row.label.match(/--([\\w-]+)/u)?.[1] ?? row.label;\n}\n\nfunction parseRows(lines: string[]): Row[] {\n return lines.map((line) => {\n const match = line.trim().match(/^(.*?)\\s{2,}(.*)$/u);\n return { label: match?.[1] ?? line.trim(), description: match?.[2] ?? \"\" };\n });\n}\n\nfunction wrap(text: string, width: number, prefix = \"\", next = prefix): string {\n const lines: string[] = [];\n let line = prefix;\n let indent = prefix.length;\n for (const word of text.split(/\\s+/u)) {\n if (line.length > indent && line.length + 1 + word.length > width) {\n lines.push(line);\n line = next;\n indent = next.length;\n }\n line += `${line.length > indent ? \" \" : \"\"}${word}`;\n }\n lines.push(line);\n return lines.join(\"\\n\");\n}\n\nfunction renderRows(title: string, rows: Row[], width: number): string {\n // Keep long option names from moving every description across the terminal.\n const column = Math.min(\n 30,\n Math.floor(width / 2),\n Math.max(...rows.map((row) => row.label.length)) + 4,\n );\n return [\n `${title}:`,\n ...rows.map(({ label, description }) => {\n if (!description) return ` ${label}`;\n if (label.length + 4 > column) {\n return ` ${label}\\n${wrap(description, width, \" \")}`;\n }\n return wrap(\n description,\n width,\n ` ${label}${\" \".repeat(column - label.length - 2)}`,\n \" \".repeat(column),\n );\n }),\n ].join(\"\\n\");\n}\n\nfunction groupedRows(\n rows: Row[],\n groups: readonly Group[],\n remainingTitle: string,\n width: number,\n): string[] {\n const remaining = new Map(rows.map((row) => [rowName(row), row]));\n const sections: string[] = [];\n for (const [title, names] of groups) {\n const selected = names.flatMap((name) => {\n const row = remaining.get(name);\n remaining.delete(name);\n return row === undefined ? [] : [row];\n });\n if (selected.length) sections.push(renderRows(title, selected, width));\n }\n if (remaining.size) {\n sections.push(renderRows(remainingTitle, [...remaining.values()], width));\n }\n return sections;\n}\n\nfunction optionRow(row: Row, command: string): Row {\n const name = rowName(row);\n let { label, description } = row;\n label = label.replace(/<([^>]+)>/u, (_, type: string) => {\n const choices = type.split(\"|\");\n if (choices.length > 1) {\n description += `${description.endsWith(\".\") ? \"\" : \".\"} Choices: ${choices.join(\", \")}.`;\n }\n return `<${VALUE_LABELS[name] ?? (type === \"number\" ? \"count\" : name)}>`;\n });\n label = label.replace(/^--([\\w-]+), (-\\w)/u, \"$2, --$1\");\n if (command === \"scan\" && !/default:/iu.test(description)) {\n const setting = DEEP_SCAN_SETTINGS.find(\n ([, , , flag]) => flag === `--${name}`,\n );\n if (setting) {\n const value =\n DeepScanSettingsSchema.shape[setting[0]].meta()?.[\"default\"];\n if (value !== undefined) description += ` (default: ${value})`;\n }\n }\n return { label, description };\n}\n\nfunction globalRows(rows: Row[], command: string): Row[] {\n const scan = command === \"scan\" || command === \"scan import\";\n const plainOutput = [\"validate\", \"login\", \"logout\", \"export\"].includes(\n command,\n );\n const visible = rows.filter(({ label }) => {\n if (scan && label.startsWith(\"--filter-output\")) return false;\n return !(\n plainOutput &&\n /^(--format |--filter-output |--full-output$|--token-)/u.test(label)\n );\n });\n const formats = visible.find((row) => rowName(row) === \"format\");\n if (formats && (scan || command === \"scans rerun\")) {\n formats.label = formats.label.replace(\"|md\", \"\");\n }\n if (formats && command !== \"scan import\") {\n visible.push({\n label: \"--json\",\n description: \"Shorthand for --format json.\",\n });\n }\n return visible.map((row) =>\n optionRow(\n row.label === \"--help\" ? { ...row, label: \"-h, --help\" } : row,\n command,\n ),\n );\n}\n\n/** Present Incur's generated help without changing its routing or command output. */\nexport function formatCliHelp(text: string, columns = 80): string {\n const header = text.match(\n /^(codex-security(?:@[^\\s]+)?((?: [a-z][a-z-]*)*))(?: — ([^\\n]*))?\\n\\nUsage: /u,\n );\n if (!header) return text;\n const command = header[2]!.trim();\n const sections: string[] = [];\n // Presentation width only; long paths and copyable commands remain intact.\n const width = columns > 0 ? columns : 80;\n const blocks = text.trimEnd().split(/\\n\\n/u);\n const examples = blocks.find((block) => block.startsWith(\"Examples:\\n\"));\n for (const [index, block] of blocks.entries()) {\n const [title = \"\", ...lines] = block.split(\"\\n\");\n if (index === 0) {\n sections.push(\n [header[1], header[3] && wrap(header[3], width)]\n .filter(Boolean)\n .join(\"\\n\"),\n );\n } else if (title.startsWith(\"Usage: \")) {\n let usage = block.replace(\n /([a-z])([A-Z])/gu,\n (_, lower: string, upper: string) => `${lower}-${upper.toLowerCase()}`,\n );\n if (command === \"scans\" || command === \"findings\") {\n usage = usage.replace(\"<command>\", \"[command]\");\n usage += \"\\nDefault command: list\";\n }\n sections.push(\n usage\n .split(\"\\n\")\n .map((line) => wrap(line, width, \"\", \" \"))\n .join(\"\\n\"),\n );\n if (command === \"\") {\n sections.push(\n [\n \"Get started:\",\n \" codex-security login\",\n \"\",\n wrap(\n \"In your repository, draft SECURITY.md (optional):\",\n width,\n \" \",\n \" \",\n ),\n \" codex-security policy .\",\n wrap(\n \"Review the diff and notes. Edit the draft, then copy only SECURITY.md to the Policy target shown.\",\n width,\n \" \",\n \" \",\n ),\n wrap(\n \"Skip this step to keep your existing policy or scan without one.\",\n width,\n \" \",\n \" \",\n ),\n \"\",\n \" codex-security scan .\",\n \" codex-security findings\",\n ].join(\"\\n\"),\n );\n } else if (examples) {\n sections.push(examples);\n }\n } else if (title === \"Examples:\") {\n continue;\n } else if (title === \"Commands:\") {\n const rows = parseRows(lines);\n sections.push(\n ...(command === \"\"\n ? groupedRows(rows, COMMAND_GROUPS, \"Other commands\", width)\n : [renderRows(\"Commands\", rows, width)]),\n );\n } else if (title === \"Options:\") {\n const rows = parseRows(lines).map((row) => optionRow(row, command));\n sections.push(\n ...(command === \"scan\"\n ? groupedRows(rows, SCAN_GROUPS, \"Advanced\", width)\n : command === \"publish scan\"\n ? groupedRows(rows, PUBLISH_GROUPS, \"Options\", width)\n : [renderRows(\"Options\", rows, width)]),\n );\n } else if (title === \"Global Options:\") {\n sections.push(\n ...groupedRows(\n globalRows(parseRows(lines), command),\n OUTPUT_GROUPS,\n \"Agent options\",\n width,\n ),\n );\n } else if (\n [\"Arguments:\", \"Integrations:\", \"Environment Variables:\"].includes(title)\n ) {\n const rows = parseRows(lines).map((row) => ({\n ...row,\n label:\n title === \"Arguments:\"\n ? row.label.replace(/([a-z])([A-Z])/gu, \"$1-$2\").toLowerCase()\n : row.label,\n }));\n sections.push(renderRows(title.slice(0, -1), rows, width));\n } else {\n sections.push(\n block\n .split(\"\\n\")\n .map((line) => (line.startsWith(\" \") ? line : wrap(line, width)))\n .join(\"\\n\"),\n );\n }\n }\n if (command === \"\") {\n sections.push(\n wrap(\n \"Use codex-security <command> --help for options and examples.\",\n width,\n ),\n );\n sections.push(\"Docs: https://learn.chatgpt.com/docs/security/cli\");\n }\n return `${sections.join(\"\\n\\n\")}\\n`;\n}\n"]}
|
package/dist/cli.d.ts
CHANGED
|
@@ -7,11 +7,14 @@ export { exportEnvironment } from "./artifact-export.js";
|
|
|
7
7
|
import { CodexSecurity, type ScanAuthMode, type ScanAuthentication, type ScanOptions } from "./api.js";
|
|
8
8
|
import { suggestOwnersInternal } from "./suggest-owners.js";
|
|
9
9
|
import { publishScanToCustom } from "./custom-publish.js";
|
|
10
|
+
import { prepareLocalExternalImport } from "./external-findings-import.js";
|
|
11
|
+
import { listLocalExternalFindings } from "./external-findings-local.js";
|
|
10
12
|
import { deduplicateScanInternal } from "./deduplication/scan.js";
|
|
11
13
|
import { classifyScanSeverityInternal, classifyScanDirectorySeverityInternal } from "./classify-scan-severity.js";
|
|
12
14
|
import { publishFindingsCsvToCloud, publishScanToCloud } from "./cloud-publish.js";
|
|
13
15
|
import { type BulkScanDiscoveryDependencies, type BulkScanPrompt } from "./bulk-scan-discovery.js";
|
|
14
16
|
import { type CodexSecurityConfig, type ExternalModelProvider, type JsonObject } from "./config.js";
|
|
17
|
+
import { importGitHubAdvisories } from "./github-advisories.js";
|
|
15
18
|
import { importGitHubCodeScanningAlerts } from "./github.js";
|
|
16
19
|
import { type LinearClientFactory } from "./linear.js";
|
|
17
20
|
import type { Finding } from "./models.js";
|
|
@@ -87,6 +90,9 @@ interface CliDependencies {
|
|
|
87
90
|
scanAuthenticationPrompt?: Pick<BulkScanPrompt, "isInteractive" | "select">;
|
|
88
91
|
scanInput?: ConstructorParameters<typeof ScanDashboard>[1]["input"];
|
|
89
92
|
publishPrompt?: Pick<BulkScanPrompt, "isInteractive" | "select"> & Partial<Pick<BulkScanPrompt, "checkbox">>;
|
|
93
|
+
externalPublicationPrompt?: Pick<BulkScanPrompt, "isInteractive" | "confirm">;
|
|
94
|
+
prepareLocalExternalImport?: typeof prepareLocalExternalImport;
|
|
95
|
+
listLocalExternalFindings?: typeof listLocalExternalFindings;
|
|
90
96
|
checkScanPublication?: typeof checkScanPublication;
|
|
91
97
|
publishScan?: typeof publishScan;
|
|
92
98
|
deduplicateScan?: typeof deduplicateScanInternal;
|
|
@@ -122,6 +128,7 @@ interface CliDependencies {
|
|
|
122
128
|
planComponents?: typeof planComponents;
|
|
123
129
|
linearClient?: LinearClientFactory;
|
|
124
130
|
importGitHubAlerts?: typeof importGitHubCodeScanningAlerts;
|
|
131
|
+
importGitHubAdvisories?: typeof importGitHubAdvisories;
|
|
125
132
|
importScan?: typeof importScan;
|
|
126
133
|
readSavedFindings?: typeof readSavedFindings;
|
|
127
134
|
runWorkbench(args: readonly string[], input?: string, signal?: AbortSignal, pythonPath?: string, protectedRoot?: PluginPythonOptions["protectedRoot"]): Promise<JsonObject>;
|