dvalincode 0.17.0 → 0.19.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (104) hide show
  1. package/README.md +320 -46
  2. package/README.zh-CN.md +277 -39
  3. package/THIRD_PARTY_NOTICES.md +98 -43
  4. package/dist/cli.js +4 -0
  5. package/dist/cli.js.map +1 -1
  6. package/dist/commands/dvalin.d.ts +41 -1
  7. package/dist/commands/dvalin.js +219 -37
  8. package/dist/commands/dvalin.js.map +1 -1
  9. package/dist/commands/mcpInstall.d.ts +2 -0
  10. package/dist/commands/mcpInstall.js +69 -0
  11. package/dist/commands/mcpInstall.js.map +1 -0
  12. package/dist/commands/run.js +21 -0
  13. package/dist/commands/run.js.map +1 -1
  14. package/dist/commands/security.d.ts +47 -0
  15. package/dist/commands/security.js +415 -0
  16. package/dist/commands/security.js.map +1 -0
  17. package/dist/dvalinCli.d.ts +3 -0
  18. package/dist/dvalinCli.js +36 -0
  19. package/dist/dvalinCli.js.map +1 -0
  20. package/dist/dvalinIndex.d.ts +2 -0
  21. package/dist/dvalinIndex.js +9 -0
  22. package/dist/dvalinIndex.js.map +1 -0
  23. package/dist/evidence/pack.d.ts +8 -0
  24. package/dist/evidence/pack.js +16 -0
  25. package/dist/evidence/pack.js.map +1 -1
  26. package/dist/harness/run.d.ts +15 -0
  27. package/dist/harness/run.js +45 -19
  28. package/dist/harness/run.js.map +1 -1
  29. package/dist/harness/verification.d.ts +56 -0
  30. package/dist/harness/verification.js +90 -0
  31. package/dist/harness/verification.js.map +1 -0
  32. package/dist/mcp/install.d.ts +48 -0
  33. package/dist/mcp/install.js +74 -0
  34. package/dist/mcp/install.js.map +1 -0
  35. package/dist/mcp/server.d.ts +10 -1
  36. package/dist/mcp/server.js +251 -34
  37. package/dist/mcp/server.js.map +1 -1
  38. package/dist/remediation/automate.d.ts +4 -1
  39. package/dist/remediation/automate.js +35 -18
  40. package/dist/remediation/automate.js.map +1 -1
  41. package/dist/remediation/diffScope.d.ts +29 -0
  42. package/dist/remediation/diffScope.js +107 -0
  43. package/dist/remediation/diffScope.js.map +1 -0
  44. package/dist/remediation/executor.d.ts +60 -0
  45. package/dist/remediation/executor.js +144 -0
  46. package/dist/remediation/executor.js.map +1 -0
  47. package/dist/remediation/localScan.d.ts +2 -1
  48. package/dist/remediation/localScan.js +73 -3
  49. package/dist/remediation/localScan.js.map +1 -1
  50. package/dist/remediation/sarif.d.ts +6 -0
  51. package/dist/remediation/sarif.js +36 -14
  52. package/dist/remediation/sarif.js.map +1 -1
  53. package/dist/remediation/scannerSuite.d.ts +21 -0
  54. package/dist/remediation/scannerSuite.js +65 -4
  55. package/dist/remediation/scannerSuite.js.map +1 -1
  56. package/dist/remediation/verify.d.ts +38 -0
  57. package/dist/remediation/verify.js +116 -0
  58. package/dist/remediation/verify.js.map +1 -0
  59. package/dist/security/baseline.d.ts +7 -0
  60. package/dist/security/baseline.js +26 -0
  61. package/dist/security/baseline.js.map +1 -0
  62. package/dist/security/config.d.ts +32 -0
  63. package/dist/security/config.js +131 -0
  64. package/dist/security/config.js.map +1 -0
  65. package/dist/security/contracts.d.ts +149 -0
  66. package/dist/security/contracts.js +231 -0
  67. package/dist/security/contracts.js.map +1 -0
  68. package/dist/security/fixRecord.d.ts +231 -0
  69. package/dist/security/fixRecord.js +327 -0
  70. package/dist/security/fixRecord.js.map +1 -0
  71. package/dist/security/fixRecordFile.d.ts +8 -0
  72. package/dist/security/fixRecordFile.js +37 -0
  73. package/dist/security/fixRecordFile.js.map +1 -0
  74. package/dist/security/fixRecordStore.d.ts +23 -0
  75. package/dist/security/fixRecordStore.js +74 -0
  76. package/dist/security/fixRecordStore.js.map +1 -0
  77. package/dist/security/render.d.ts +8 -0
  78. package/dist/security/render.js +20 -0
  79. package/dist/security/render.js.map +1 -0
  80. package/dist/security/suppressions.d.ts +12 -0
  81. package/dist/security/suppressions.js +60 -0
  82. package/dist/security/suppressions.js.map +1 -0
  83. package/dist/security/verifyRun.d.ts +21 -0
  84. package/dist/security/verifyRun.js +74 -0
  85. package/dist/security/verifyRun.js.map +1 -0
  86. package/dist/security/workflow.d.ts +98 -0
  87. package/dist/security/workflow.js +276 -0
  88. package/dist/security/workflow.js.map +1 -0
  89. package/dist/server/routes/remediation.d.ts +19 -0
  90. package/dist/server/routes/remediation.js +90 -18
  91. package/dist/server/routes/remediation.js.map +1 -1
  92. package/dist/tools/runCheck.d.ts +6 -0
  93. package/dist/tools/runCheck.js +1 -1
  94. package/dist/tools/runCheck.js.map +1 -1
  95. package/dist/tools/runSecuritySuite.d.ts +3 -0
  96. package/dist/tools/runSecuritySuite.js +18 -11
  97. package/dist/tools/runSecuritySuite.js.map +1 -1
  98. package/dist/tui/app.js +21 -2
  99. package/dist/tui/app.js.map +1 -1
  100. package/dist/tui/render.js +2 -0
  101. package/dist/tui/render.js.map +1 -1
  102. package/dist/version.d.ts +1 -1
  103. package/dist/version.js +1 -1
  104. package/package.json +17 -10
@@ -0,0 +1,74 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { AuditSink } from '../audit/log.js';
3
+ import { loadPolicy } from '../core/policy.js';
4
+ import { runProjectVerification } from '../remediation/verify.js';
5
+ import { runDvalinScanSuite } from '../remediation/scannerSuite.js';
6
+ import { deriveCoverage } from './contracts.js';
7
+ import { saveFixRecord } from './fixRecordStore.js';
8
+ import { evaluateWorkflowVerificationGate, verifySecurityWorkflow, } from './workflow.js';
9
+ /**
10
+ * The one verification path.
11
+ *
12
+ * Every surface that verifies a repair — this command, the `--fix --verify`
13
+ * pipeline, and the MCP server — comes through here, so "verified" means the
14
+ * same thing regardless of who asked. Dvalin re-scans, Dvalin runs the checks,
15
+ * and the record is issued from what Dvalin observed.
16
+ */
17
+ export async function runWorkflowVerification(input) {
18
+ const { workflow } = input;
19
+ // The checks are governed commands; opening a run puts them in the
20
+ // hash-chained log so the record has something to anchor to.
21
+ const audit = new AuditSink(`verify-${randomUUID().slice(0, 8)}`);
22
+ const loadedPolicy = loadPolicy(workflow.root);
23
+ audit.append({
24
+ type: 'run_start',
25
+ task: `security verify ${workflow.id}`,
26
+ mode: 'security-verify',
27
+ provider: 'none',
28
+ model: 'none',
29
+ cwd: workflow.root,
30
+ gitHead: null,
31
+ policyHash: loadedPolicy.hash,
32
+ });
33
+ let result;
34
+ let verification;
35
+ let status = 'done';
36
+ try {
37
+ result = await (input.runScan ?? runDvalinScanSuite)(workflow.root, {
38
+ scanners: workflow.scanners,
39
+ timeoutMs: input.timeoutMs,
40
+ });
41
+ verification = await runProjectVerification({
42
+ cwd: workflow.root,
43
+ kinds: input.checks,
44
+ commands: input.verifyCommands?.length ? input.verifyCommands : undefined,
45
+ timeoutMs: input.timeoutMs,
46
+ audit,
47
+ });
48
+ }
49
+ catch (error) {
50
+ // Recorded as what it was. A run that threw must not be written into the
51
+ // chain as a clean completion — that is the one thing the log exists to
52
+ // make impossible.
53
+ status = 'error';
54
+ throw error;
55
+ }
56
+ finally {
57
+ audit.append({ type: 'run_end', status, iterations: 1, warnings: audit.getWarnings() });
58
+ }
59
+ const gate = evaluateWorkflowVerificationGate(workflow, result);
60
+ const updated = await verifySecurityWorkflow({
61
+ workflow,
62
+ result,
63
+ gate,
64
+ checks: verification.evidence,
65
+ coverage: deriveCoverage(result),
66
+ executor: input.executor,
67
+ audit: { runId: audit.runId, headHash: audit.head() },
68
+ policyHash: loadedPolicy.hash,
69
+ });
70
+ if (updated.verification?.record)
71
+ saveFixRecord(updated.verification.record);
72
+ return updated;
73
+ }
74
+ //# sourceMappingURL=verifyRun.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"verifyRun.js","sourceRoot":"","sources":["../../src/security/verifyRun.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,98 @@
1
+ import { type DvalinScannerId, type DvalinScanMetrics, type DvalinScanSuiteResult } from '../remediation/scannerSuite.js';
2
+ import { type FixExecutor, type VerifiedFixRecord } from './fixRecord.js';
3
+ import { SECURITY_SCHEMA_VERSION, type SecurityCoverage, type SecurityFindingDelta, type SecurityFindingSnapshot, type SecurityGateResult } from './contracts.js';
4
+ export type SecurityWorkflowState = 'created' | 'scanning' | 'ready' | 'external_handoff' | 'internal_fix' | 'verifying' | 'passed' | 'needs_work' | 'blocked' | 'evidence_ready' | 'publication_pending' | 'published';
5
+ export type SecurityCheckEvidence = {
6
+ kind: string;
7
+ command: string;
8
+ exitCode: number | null;
9
+ passed: boolean;
10
+ };
11
+ export type SecurityWorkflowScan = {
12
+ id: string;
13
+ completedAt: string;
14
+ score: number;
15
+ grade: DvalinScanSuiteResult['grade'];
16
+ metrics: DvalinScanMetrics;
17
+ findings: SecurityFindingSnapshot[];
18
+ };
19
+ export type SecurityWorkflow = {
20
+ schemaVersion: typeof SECURITY_SCHEMA_VERSION;
21
+ kind: 'dvalin-security-workflow';
22
+ id: string;
23
+ projectId: string;
24
+ root: string;
25
+ state: SecurityWorkflowState;
26
+ scanners: DvalinScannerId[];
27
+ createdAt: string;
28
+ updatedAt: string;
29
+ initialScan: SecurityWorkflowScan;
30
+ latestScan: SecurityWorkflowScan;
31
+ /**
32
+ * What the latest scan covered. Absent on workflows persisted before coverage
33
+ * was recorded; readers should treat that as `unknown`, not as complete.
34
+ */
35
+ coverage?: SecurityCoverage;
36
+ delta?: SecurityFindingDelta;
37
+ /** The most recent gate result. Overwritten on every verification round. */
38
+ gate: SecurityGateResult;
39
+ /**
40
+ * The gate as it stood when the workflow was created — the findings the
41
+ * repair is actually meant to eliminate. Kept separately because `gate` is
42
+ * overwritten, and a second verification round comparing against the first
43
+ * round's result would quietly move the goalposts. Absent on workflows
44
+ * persisted before this field existed; readers fall back to `gate`.
45
+ */
46
+ initialGate?: SecurityGateResult;
47
+ verification?: {
48
+ assurance: 'scan-only' | 'scan-and-checks';
49
+ checks: SecurityCheckEvidence[];
50
+ verifiedAt: string;
51
+ /** The portable, offline re-verifiable record of this verification. */
52
+ record?: VerifiedFixRecord;
53
+ };
54
+ history: Array<{
55
+ state: SecurityWorkflowState;
56
+ at: string;
57
+ note?: string;
58
+ }>;
59
+ };
60
+ export declare function createSecurityWorkflow(input: {
61
+ root: string;
62
+ result: DvalinScanSuiteResult;
63
+ gate: SecurityGateResult;
64
+ delta?: SecurityFindingDelta;
65
+ coverage?: SecurityCoverage;
66
+ }): Promise<SecurityWorkflow>;
67
+ export declare function loadSecurityWorkflow(id: string): Promise<SecurityWorkflow>;
68
+ export declare function transitionSecurityWorkflow(workflow: SecurityWorkflow, next: SecurityWorkflowState, note?: string): Promise<SecurityWorkflow>;
69
+ export declare function verifySecurityWorkflow(input: {
70
+ workflow: SecurityWorkflow;
71
+ result: DvalinScanSuiteResult;
72
+ gate: SecurityGateResult;
73
+ checks?: SecurityCheckEvidence[];
74
+ /** Coverage of the verifying scan. Omitted means the record says `unknown`. */
75
+ coverage?: SecurityCoverage;
76
+ /** Who edited the code. Recorded on the fix record, never consulted. */
77
+ executor?: FixExecutor;
78
+ changes?: {
79
+ files: string[];
80
+ diffHash: string;
81
+ };
82
+ audit?: {
83
+ runId: string;
84
+ headHash: string;
85
+ };
86
+ policyHash?: string;
87
+ }): Promise<SecurityWorkflow>;
88
+ /**
89
+ * Coverage for a workflow, including one persisted before coverage was
90
+ * recorded. Read it through here rather than off the field, so a legacy record
91
+ * reports `unknown` instead of looking like it covered nothing.
92
+ */
93
+ export declare function workflowCoverage(workflow: SecurityWorkflow): SecurityCoverage;
94
+ export declare function getWorkflowFinding(workflow: SecurityWorkflow, fingerprint: string): SecurityFindingSnapshot | undefined;
95
+ /** The findings this workflow set out to eliminate, stable across verification rounds. */
96
+ export declare function originalGate(workflow: SecurityWorkflow): SecurityGateResult;
97
+ /** Re-check the original blocked targets and reject newly introduced severe findings. */
98
+ export declare function evaluateWorkflowVerificationGate(workflow: SecurityWorkflow, result: DvalinScanSuiteResult): SecurityGateResult;
@@ -0,0 +1,276 @@
1
+ import { randomUUID } from 'node:crypto';
2
+ import { mkdir, readFile, rename, writeFile } from 'node:fs/promises';
3
+ import path from 'node:path';
4
+ import { dvalinHome } from '../memory/store.js';
5
+ import { DVALIN_SCANNER_IDS, } from '../remediation/scannerSuite.js';
6
+ import { UsageError } from '../core/exitCodes.js';
7
+ import { buildFixRecord } from './fixRecord.js';
8
+ import { SECURITY_SCHEMA_VERSION, SECURITY_SEVERITIES, isSupportedSecuritySchemaVersion, securityProjectId, severityOfFinding, snapshotFinding, unknownCoverage, } from './contracts.js';
9
+ const SECURITY_WORKFLOW_STATES = [
10
+ 'created', 'scanning', 'ready', 'external_handoff', 'internal_fix', 'verifying',
11
+ 'passed', 'needs_work', 'blocked', 'evidence_ready', 'publication_pending', 'published',
12
+ ];
13
+ const TRANSITIONS = {
14
+ created: ['scanning', 'blocked'],
15
+ scanning: ['ready', 'passed', 'needs_work', 'blocked'],
16
+ ready: ['external_handoff', 'internal_fix', 'verifying', 'needs_work', 'blocked'],
17
+ external_handoff: ['verifying', 'blocked'],
18
+ internal_fix: ['verifying', 'blocked'],
19
+ verifying: ['passed', 'needs_work', 'blocked'],
20
+ passed: ['evidence_ready', 'publication_pending', 'published', 'verifying'],
21
+ needs_work: ['external_handoff', 'internal_fix', 'verifying', 'blocked'],
22
+ blocked: ['scanning', 'verifying'],
23
+ evidence_ready: ['publication_pending', 'published', 'verifying'],
24
+ publication_pending: ['published', 'blocked'],
25
+ published: ['verifying'],
26
+ };
27
+ export async function createSecurityWorkflow(input) {
28
+ const now = new Date().toISOString();
29
+ const root = path.resolve(input.root);
30
+ const initialScan = workflowScan(input.result);
31
+ const state = input.gate.passed ? 'passed' : 'needs_work';
32
+ const workflow = {
33
+ schemaVersion: SECURITY_SCHEMA_VERSION,
34
+ kind: 'dvalin-security-workflow',
35
+ id: `security-${now.replace(/[:.]/g, '-')}-${randomUUID().slice(0, 8)}`,
36
+ projectId: securityProjectId(root),
37
+ root,
38
+ state,
39
+ scanners: input.result.scanners.map(scanner => scanner.id),
40
+ createdAt: now,
41
+ updatedAt: now,
42
+ initialScan,
43
+ latestScan: initialScan,
44
+ coverage: input.coverage,
45
+ delta: input.delta,
46
+ gate: input.gate,
47
+ initialGate: input.gate,
48
+ history: [
49
+ { state: 'created', at: now },
50
+ { state: 'scanning', at: now },
51
+ { state, at: now, note: input.gate.passed ? 'Security gate passed.' : 'Security gate needs remediation.' },
52
+ ],
53
+ };
54
+ await persistSecurityWorkflow(workflow);
55
+ return workflow;
56
+ }
57
+ export async function loadSecurityWorkflow(id) {
58
+ assertWorkflowId(id);
59
+ let value;
60
+ try {
61
+ value = JSON.parse(await readFile(workflowPath(id), 'utf8'));
62
+ }
63
+ catch (error) {
64
+ throw new UsageError(`Cannot read security workflow ${id}: ${error instanceof Error ? error.message : String(error)}`);
65
+ }
66
+ if (!isSecurityWorkflow(value) || value.id !== id)
67
+ throw new UsageError(`Invalid or unsupported security workflow: ${id}`);
68
+ return value;
69
+ }
70
+ export async function transitionSecurityWorkflow(workflow, next, note) {
71
+ if (workflow.state !== next && !TRANSITIONS[workflow.state].includes(next)) {
72
+ throw new UsageError(`Invalid security workflow transition: ${workflow.state} -> ${next}`);
73
+ }
74
+ const at = new Date().toISOString();
75
+ const updated = {
76
+ ...workflow,
77
+ state: next,
78
+ updatedAt: at,
79
+ history: [...workflow.history, { state: next, at, ...(note ? { note } : {}) }],
80
+ };
81
+ await persistSecurityWorkflow(updated);
82
+ return updated;
83
+ }
84
+ export async function verifySecurityWorkflow(input) {
85
+ let workflow = input.workflow;
86
+ if (workflow.state !== 'verifying')
87
+ workflow = await transitionSecurityWorkflow(workflow, 'verifying');
88
+ const checks = input.checks ?? [];
89
+ const at = new Date().toISOString();
90
+ const originalTargetKeys = new Set(originalGate(workflow).blocking.map(finding => finding.targetFingerprint));
91
+ const initialFingerprints = new Set(workflow.initialScan.findings.map(finding => finding.fingerprint));
92
+ const record = buildFixRecord({
93
+ workflowId: workflow.id,
94
+ projectId: workflow.projectId,
95
+ executor: input.executor,
96
+ before: {
97
+ scanId: workflow.initialScan.id,
98
+ completedAt: workflow.initialScan.completedAt,
99
+ coverage: workflowCoverage(workflow),
100
+ targets: originalGate(workflow).blocking,
101
+ },
102
+ after: {
103
+ scanId: input.result.id,
104
+ completedAt: input.result.completedAt,
105
+ coverage: input.coverage
106
+ ?? unknownCoverage('The verifying scan did not record its coverage.'),
107
+ // Only the original targets. `gate.blocking` also carries findings the
108
+ // repair introduced, and folding the two into one field is what let this
109
+ // path and the --fix path mean different things by the same record.
110
+ remainingTargets: input.gate.blocking.filter(finding => originalTargetKeys.has(finding.targetFingerprint)),
111
+ },
112
+ regression: {
113
+ gate: { threshold: input.gate.threshold, mode: input.gate.mode },
114
+ // The complete set, not the gate's threshold-filtered one: the record
115
+ // keeps the observation so a stricter reader can re-decide from it.
116
+ introduced: input.result.findings
117
+ .map(snapshotFinding)
118
+ .filter(finding => !initialFingerprints.has(finding.fingerprint)),
119
+ },
120
+ ...(input.changes ? { changes: input.changes } : {}),
121
+ checks,
122
+ ...(input.audit ? { audit: input.audit } : {}),
123
+ ...(input.policyHash ? { policyHash: input.policyHash } : {}),
124
+ generatedAt: at,
125
+ });
126
+ // The record decides. Deriving the workflow state from anything else would
127
+ // give "verified" two definitions — and the earlier one passed a project with
128
+ // no runnable check, because every() over an empty list is vacuously true.
129
+ const passed = record.verdict.verified;
130
+ const next = passed ? 'passed' : 'needs_work';
131
+ const updated = {
132
+ ...workflow,
133
+ state: next,
134
+ updatedAt: at,
135
+ latestScan: workflowScan(input.result),
136
+ gate: input.gate,
137
+ coverage: input.coverage ?? workflow.coverage,
138
+ verification: {
139
+ assurance: record.assurance,
140
+ checks,
141
+ verifiedAt: at,
142
+ record,
143
+ },
144
+ history: [
145
+ ...workflow.history,
146
+ { state: next, at, note: passed ? 'Deterministic verification passed.' : 'Deterministic verification failed.' },
147
+ ],
148
+ };
149
+ await persistSecurityWorkflow(updated);
150
+ return updated;
151
+ }
152
+ /**
153
+ * Coverage for a workflow, including one persisted before coverage was
154
+ * recorded. Read it through here rather than off the field, so a legacy record
155
+ * reports `unknown` instead of looking like it covered nothing.
156
+ */
157
+ export function workflowCoverage(workflow) {
158
+ return workflow.coverage
159
+ ?? unknownCoverage('This workflow was recorded before scan coverage was tracked.');
160
+ }
161
+ export function getWorkflowFinding(workflow, fingerprint) {
162
+ return workflow.latestScan.findings.find(finding => finding.fingerprint === fingerprint)
163
+ ?? workflow.initialScan.findings.find(finding => finding.fingerprint === fingerprint);
164
+ }
165
+ /** The findings this workflow set out to eliminate, stable across verification rounds. */
166
+ export function originalGate(workflow) {
167
+ return workflow.initialGate ?? workflow.gate;
168
+ }
169
+ /** Re-check the original blocked targets and reject newly introduced severe findings. */
170
+ export function evaluateWorkflowVerificationGate(workflow, result) {
171
+ const original = originalGate(workflow);
172
+ if (original.threshold === 'none') {
173
+ return { passed: true, mode: original.mode, threshold: 'none', considered: result.findings.length, blocking: [] };
174
+ }
175
+ const current = result.findings.map(snapshotFinding);
176
+ const originalTargets = new Set(originalGate(workflow).blocking.map(finding => finding.targetFingerprint));
177
+ const initialFingerprints = new Set(workflow.initialScan.findings.map(finding => finding.fingerprint));
178
+ const thresholdIndex = SECURITY_SEVERITIES.indexOf(original.threshold);
179
+ const blocking = current.filter(finding => {
180
+ if (originalTargets.has(finding.targetFingerprint))
181
+ return true;
182
+ return !initialFingerprints.has(finding.fingerprint)
183
+ && SECURITY_SEVERITIES.indexOf(severityOfFinding(finding)) <= thresholdIndex;
184
+ });
185
+ return {
186
+ passed: blocking.length === 0,
187
+ mode: original.mode,
188
+ threshold: original.threshold,
189
+ considered: current.length,
190
+ blocking,
191
+ };
192
+ }
193
+ function workflowScan(result) {
194
+ return {
195
+ id: result.id,
196
+ completedAt: result.completedAt,
197
+ score: result.score,
198
+ grade: result.grade,
199
+ metrics: { ...result.metrics },
200
+ findings: result.findings.map(snapshotFinding),
201
+ };
202
+ }
203
+ async function persistSecurityWorkflow(workflow) {
204
+ const directory = workflowDirectory();
205
+ await mkdir(directory, { recursive: true });
206
+ const target = workflowPath(workflow.id);
207
+ const temporary = `${target}.${process.pid}.${randomUUID().slice(0, 8)}.tmp`;
208
+ await writeFile(temporary, `${JSON.stringify(workflow, null, 2)}\n`, { encoding: 'utf8', mode: 0o600 });
209
+ await rename(temporary, target);
210
+ }
211
+ function workflowDirectory() {
212
+ return path.join(dvalinHome(), 'security', 'workflows');
213
+ }
214
+ function workflowPath(id) {
215
+ assertWorkflowId(id);
216
+ return path.join(workflowDirectory(), `${id}.json`);
217
+ }
218
+ function assertWorkflowId(id) {
219
+ if (!/^security-[A-Za-z0-9-]+$/.test(id))
220
+ throw new UsageError(`Invalid security workflow id: ${id}`);
221
+ }
222
+ function isSecurityWorkflow(value) {
223
+ if (!value || typeof value !== 'object' || Array.isArray(value))
224
+ return false;
225
+ const record = value;
226
+ return isSupportedSecuritySchemaVersion(record.schemaVersion)
227
+ && record.kind === 'dvalin-security-workflow'
228
+ && typeof record.id === 'string'
229
+ && typeof record.projectId === 'string'
230
+ && typeof record.root === 'string'
231
+ && SECURITY_WORKFLOW_STATES.includes(record.state)
232
+ && Array.isArray(record.scanners)
233
+ && record.scanners.length > 0
234
+ && record.scanners.every(scanner => DVALIN_SCANNER_IDS.includes(scanner))
235
+ && Array.isArray(record.history)
236
+ && record.history.every(entry => {
237
+ if (!entry || typeof entry !== 'object' || Array.isArray(entry))
238
+ return false;
239
+ const history = entry;
240
+ return SECURITY_WORKFLOW_STATES.includes(history.state) && typeof history.at === 'string';
241
+ })
242
+ && isWorkflowScan(record.initialScan)
243
+ && isWorkflowScan(record.latestScan)
244
+ && isWorkflowGate(record.gate);
245
+ }
246
+ function isWorkflowScan(value) {
247
+ if (!value || typeof value !== 'object' || Array.isArray(value))
248
+ return false;
249
+ const scan = value;
250
+ return typeof scan.id === 'string'
251
+ && typeof scan.completedAt === 'string'
252
+ && typeof scan.score === 'number'
253
+ && ['A', 'B', 'C', 'D', 'F'].includes(String(scan.grade))
254
+ && !!scan.metrics
255
+ && Array.isArray(scan.findings)
256
+ && scan.findings.every(finding => {
257
+ if (!finding || typeof finding !== 'object' || Array.isArray(finding))
258
+ return false;
259
+ const snapshot = finding;
260
+ return typeof snapshot.fingerprint === 'string'
261
+ && typeof snapshot.targetFingerprint === 'string'
262
+ && typeof snapshot.ruleId === 'string'
263
+ && typeof snapshot.path === 'string';
264
+ });
265
+ }
266
+ function isWorkflowGate(value) {
267
+ if (!value || typeof value !== 'object' || Array.isArray(value))
268
+ return false;
269
+ const gate = value;
270
+ return typeof gate.passed === 'boolean'
271
+ && (gate.mode === 'all' || gate.mode === 'new')
272
+ && ['critical', 'high', 'medium', 'low', 'none'].includes(String(gate.threshold))
273
+ && typeof gate.considered === 'number'
274
+ && Array.isArray(gate.blocking);
275
+ }
276
+ //# sourceMappingURL=workflow.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"workflow.js","sourceRoot":"","sources":["../../src/security/workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,UAAU,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACtE,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EACL,kBAAkB,GAInB,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,cAAc,EAA4C,MAAM,gBAAgB,CAAC;AAC1F,OAAO,EACL,uBAAuB,EACvB,mBAAmB,EACnB,gCAAgC,EAChC,iBAAiB,EACjB,iBAAiB,EACjB,eAAe,EACf,eAAe,GAKhB,MAAM,gBAAgB,CAAC;AAgBxB,MAAM,wBAAwB,GAA4B;IACxD,SAAS,EAAE,UAAU,EAAE,OAAO,EAAE,kBAAkB,EAAE,cAAc,EAAE,WAAW;IAC/E,QAAQ,EAAE,YAAY,EAAE,SAAS,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,WAAW;CACxF,CAAC;AAwDF,MAAM,WAAW,GAA2D;IAC1E,OAAO,EAAE,CAAC,UAAU,EAAE,SAAS,CAAC;IAChC,QAAQ,EAAE,CAAC,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC;IACtD,KAAK,EAAE,CAAC,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,YAAY,EAAE,SAAS,CAAC;IACjF,gBAAgB,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;IAC1C,YAAY,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;IACtC,SAAS,EAAE,CAAC,QAAQ,EAAE,YAAY,EAAE,SAAS,CAAC;IAC9C,MAAM,EAAE,CAAC,gBAAgB,EAAE,qBAAqB,EAAE,WAAW,EAAE,WAAW,CAAC;IAC3E,UAAU,EAAE,CAAC,kBAAkB,EAAE,cAAc,EAAE,WAAW,EAAE,SAAS,CAAC;IACxE,OAAO,EAAE,CAAC,UAAU,EAAE,WAAW,CAAC;IAClC,cAAc,EAAE,CAAC,qBAAqB,EAAE,WAAW,EAAE,WAAW,CAAC;IACjE,mBAAmB,EAAE,CAAC,WAAW,EAAE,SAAS,CAAC;IAC7C,SAAS,EAAE,CAAC,WAAW,CAAC;CACzB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAM5C;IACC,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACrC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,WAAW,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,KAAK,GAA0B,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;IACjF,MAAM,QAAQ,GAAqB;QACjC,aAAa,EAAE,uBAAuB;QACtC,IAAI,EAAE,0BAA0B;QAChC,EAAE,EAAE,YAAY,GAAG,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE;QACvE,SAAS,EAAE,iBAAiB,CAAC,IAAI,CAAC;QAClC,IAAI;QACJ,KAAK;QACL,QAAQ,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1D,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,WAAW;QACX,UAAU,EAAE,WAAW;QACvB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,WAAW,EAAE,KAAK,CAAC,IAAI;QACvB,OAAO,EAAE;YACP,EAAE,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,GAAG,EAAE;YAC7B,EAAE,KAAK,EAAE,UAAU,EAAE,EAAE,EAAE,GAAG,EAAE;YAC9B,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB,CAAC,CAAC,CAAC,kCAAkC,EAAE;SAC3G;KACF,CAAC;IACF,MAAM,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IACxC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,EAAU;IACnD,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACrB,IAAI,KAAc,CAAC;IACnB,IAAI,CAAC;QACH,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAY,CAAC;IAC1E,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,UAAU,CAAC,iCAAiC,EAAE,KAAK,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACzH,CAAC;IACD,IAAI,CAAC,kBAAkB,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,EAAE,KAAK,EAAE;QAAE,MAAM,IAAI,UAAU,CAAC,6CAA6C,EAAE,EAAE,CAAC,CAAC;IAC3H,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAC9C,QAA0B,EAC1B,IAA2B,EAC3B,IAAa;IAEb,IAAI,QAAQ,CAAC,KAAK,KAAK,IAAI,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QAC3E,MAAM,IAAI,UAAU,CAAC,yCAAyC,QAAQ,CAAC,KAAK,OAAO,IAAI,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,OAAO,GAAqB;QAChC,GAAG,QAAQ;QACX,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,EAAE;QACb,OAAO,EAAE,CAAC,GAAG,QAAQ,CAAC,OAAO,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;KAC/E,CAAC;IACF,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAAC,KAY5C;IACC,IAAI,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;IAC9B,IAAI,QAAQ,CAAC,KAAK,KAAK,WAAW;QAAE,QAAQ,GAAG,MAAM,0BAA0B,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;IACvG,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,IAAI,EAAE,CAAC;IAClC,MAAM,EAAE,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC9G,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACvG,MAAM,MAAM,GAAG,cAAc,CAAC;QAC5B,UAAU,EAAE,QAAQ,CAAC,EAAE;QACvB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,MAAM,EAAE;YACN,MAAM,EAAE,QAAQ,CAAC,WAAW,CAAC,EAAE;YAC/B,WAAW,EAAE,QAAQ,CAAC,WAAW,CAAC,WAAW;YAC7C,QAAQ,EAAE,gBAAgB,CAAC,QAAQ,CAAC;YACpC,OAAO,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ;SACzC;QACD,KAAK,EAAE;YACL,MAAM,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE;YACvB,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,WAAW;YACrC,QAAQ,EAAE,KAAK,CAAC,QAAQ;mBACnB,eAAe,CAAC,iDAAiD,CAAC;YACvE,uEAAuE;YACvE,yEAAyE;YACzE,oEAAoE;YACpE,gBAAgB,EAAE,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,kBAAkB,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC;SAC3G;QACD,UAAU,EAAE;YACV,IAAI,EAAE,EAAE,SAAS,EAAE,KAAK,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE;YAChE,sEAAsE;YACtE,oEAAoE;YACpE,UAAU,EAAE,KAAK,CAAC,MAAM,CAAC,QAAQ;iBAC9B,GAAG,CAAC,eAAe,CAAC;iBACpB,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;SACpE;QACD,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,MAAM;QACN,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9C,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,WAAW,EAAE,EAAE;KAChB,CAAC,CAAC;IACH,2EAA2E;IAC3E,8EAA8E;IAC9E,2EAA2E;IAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;IACvC,MAAM,IAAI,GAA0B,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,YAAY,CAAC;IACrE,MAAM,OAAO,GAAqB;QAChC,GAAG,QAAQ;QACX,KAAK,EAAE,IAAI;QACX,SAAS,EAAE,EAAE;QACb,UAAU,EAAE,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC;QACtC,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,QAAQ,EAAE,KAAK,CAAC,QAAQ,IAAI,QAAQ,CAAC,QAAQ;QAC7C,YAAY,EAAE;YACZ,SAAS,EAAE,MAAM,CAAC,SAAS;YAC3B,MAAM;YACN,UAAU,EAAE,EAAE;YACd,MAAM;SACP;QACD,OAAO,EAAE;YACP,GAAG,QAAQ,CAAC,OAAO;YACnB,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,oCAAoC,EAAE;SAChH;KACF,CAAC;IACF,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IACvC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAA0B;IACzD,OAAO,QAAQ,CAAC,QAAQ;WACnB,eAAe,CAAC,8DAA8D,CAAC,CAAC;AACvF,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAA0B,EAAE,WAAmB;IAChF,OAAO,QAAQ,CAAC,UAAU,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,KAAK,WAAW,CAAC;WACnF,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,KAAK,WAAW,CAAC,CAAC;AAC1F,CAAC;AAED,0FAA0F;AAC1F,MAAM,UAAU,YAAY,CAAC,QAA0B;IACrD,OAAO,QAAQ,CAAC,WAAW,IAAI,QAAQ,CAAC,IAAI,CAAC;AAC/C,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,gCAAgC,CAC9C,QAA0B,EAC1B,MAA6B;IAE7B,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,QAAQ,CAAC,SAAS,KAAK,MAAM,EAAE,CAAC;QAClC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACpH,CAAC;IACD,MAAM,OAAO,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;IACrD,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC3G,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,QAAQ,CAAC,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;IACvG,MAAM,cAAc,GAAG,mBAAmB,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;IACvE,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE;QACxC,IAAI,eAAe,CAAC,GAAG,CAAC,OAAO,CAAC,iBAAiB,CAAC;YAAE,OAAO,IAAI,CAAC;QAChE,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,OAAO,CAAC,WAAW,CAAC;eAC/C,mBAAmB,CAAC,OAAO,CAAC,iBAAiB,CAAC,OAAO,CAAC,CAAC,IAAI,cAAc,CAAC;IACjF,CAAC,CAAC,CAAC;IACH,OAAO;QACL,MAAM,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC7B,IAAI,EAAE,QAAQ,CAAC,IAAI;QACnB,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,UAAU,EAAE,OAAO,CAAC,MAAM;QAC1B,QAAQ;KACT,CAAC;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,MAA6B;IACjD,OAAO;QACL,EAAE,EAAE,MAAM,CAAC,EAAE;QACb,WAAW,EAAE,MAAM,CAAC,WAAW;QAC/B,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,EAAE,GAAG,MAAM,CAAC,OAAO,EAAE;QAC9B,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC,eAAe,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,uBAAuB,CAAC,QAA0B;IAC/D,MAAM,SAAS,GAAG,iBAAiB,EAAE,CAAC;IACtC,MAAM,KAAK,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IACzC,MAAM,SAAS,GAAG,GAAG,MAAM,IAAI,OAAO,CAAC,GAAG,IAAI,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,MAAM,CAAC;IAC7E,MAAM,SAAS,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACxG,MAAM,MAAM,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAClC,CAAC;AAED,SAAS,iBAAiB;IACxB,OAAO,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,WAAW,CAAC,CAAC;AAC1D,CAAC;AAED,SAAS,YAAY,CAAC,EAAU;IAC9B,gBAAgB,CAAC,EAAE,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACtD,CAAC;AAED,SAAS,gBAAgB,CAAC,EAAU;IAClC,IAAI,CAAC,0BAA0B,CAAC,IAAI,CAAC,EAAE,CAAC;QAAE,MAAM,IAAI,UAAU,CAAC,iCAAiC,EAAE,EAAE,CAAC,CAAC;AACxG,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,MAAM,GAAG,KAAgC,CAAC;IAChD,OAAO,gCAAgC,CAAC,MAAM,CAAC,aAAa,CAAC;WACxD,MAAM,CAAC,IAAI,KAAK,0BAA0B;WAC1C,OAAO,MAAM,CAAC,EAAE,KAAK,QAAQ;WAC7B,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ;WACpC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ;WAC/B,wBAAwB,CAAC,QAAQ,CAAC,MAAM,CAAC,KAA8B,CAAC;WACxE,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC;WAC9B,MAAM,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC;WAC1B,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,kBAAkB,CAAC,QAAQ,CAAC,OAA0B,CAAC,CAAC;WACzF,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;WAC7B,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE;YAC9B,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,KAAK,CAAC;YAC9E,MAAM,OAAO,GAAG,KAAgC,CAAC;YACjD,OAAO,wBAAwB,CAAC,QAAQ,CAAC,OAAO,CAAC,KAA8B,CAAC,IAAI,OAAO,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC;QACrH,CAAC,CAAC;WACC,cAAc,CAAC,MAAM,CAAC,WAAW,CAAC;WAClC,cAAc,CAAC,MAAM,CAAC,UAAU,CAAC;WACjC,cAAc,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,OAAO,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;WAC7B,OAAO,IAAI,CAAC,WAAW,KAAK,QAAQ;WACpC,OAAO,IAAI,CAAC,KAAK,KAAK,QAAQ;WAC9B,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;WACtD,CAAC,CAAC,IAAI,CAAC,OAAO;WACd,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC;WAC5B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE;YAC/B,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;gBAAE,OAAO,KAAK,CAAC;YACpF,MAAM,QAAQ,GAAG,OAAkC,CAAC;YACpD,OAAO,OAAO,QAAQ,CAAC,WAAW,KAAK,QAAQ;mBAC1C,OAAO,QAAQ,CAAC,iBAAiB,KAAK,QAAQ;mBAC9C,OAAO,QAAQ,CAAC,MAAM,KAAK,QAAQ;mBACnC,OAAO,QAAQ,CAAC,IAAI,KAAK,QAAQ,CAAC;QACzC,CAAC,CAAC,CAAC;AACP,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,IAAI,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IAC9E,MAAM,IAAI,GAAG,KAAgC,CAAC;IAC9C,OAAO,OAAO,IAAI,CAAC,MAAM,KAAK,SAAS;WAClC,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC;WAC5C,CAAC,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;WAC9E,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;WACnC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACpC,CAAC"}
@@ -1 +1,20 @@
1
+ import { type Request, type Response } from 'express';
2
+ import { executeSecurityScan } from '../../commands/security.js';
3
+ import { upsertRemediationCases } from '../../remediation/cases.js';
4
+ import { consumeScannerWorkspaceGrant } from '../scannerWorkspaceGrants.js';
1
5
  export declare const remediationRouter: import("express-serve-static-core").Router;
6
+ export type SuiteRouteDeps = {
7
+ executeScan: typeof executeSecurityScan;
8
+ consumeGrant: typeof consumeScannerWorkspaceGrant;
9
+ upsertCases: typeof upsertRemediationCases;
10
+ };
11
+ /**
12
+ * Server adapter for the versioned security scan contract.
13
+ *
14
+ * The scan is intentionally still spread at the top level: the current web
15
+ * client consumes that legacy shape. The versioned envelope is added beside
16
+ * it so newer clients can reason about coverage and the gate without breaking
17
+ * existing ones.
18
+ */
19
+ export declare function handleSuiteRequest(req: Request, res: Response, deps?: SuiteRouteDeps): Promise<void>;
20
+ export declare function handleVerifyFixRequest(req: Request, res: Response): void;
@@ -1,44 +1,116 @@
1
1
  import { Router } from 'express';
2
+ import { executeSecurityScan } from '../../commands/security.js';
3
+ import { UsageError } from '../../core/exitCodes.js';
2
4
  import { listRemediationCases, updateRemediationCase, upsertRemediationCases } from '../../remediation/cases.js';
3
5
  import { runLocalSecurityScan } from '../../remediation/localScan.js';
4
6
  import { parseSarifForRemediation } from '../../remediation/sarif.js';
5
7
  import { createRemediationWorktree } from '../../remediation/worktree.js';
6
- import { listDvalinScanners, runDvalinScanSuite } from '../../remediation/scannerSuite.js';
8
+ import { dvalinScannerInstallPlan, installDvalinScanner, listDvalinScanners, } from '../../remediation/scannerSuite.js';
9
+ import { verifyFixRecord } from '../../security/fixRecord.js';
7
10
  import { allowWorkspaceRoot, resolveAllowedCwd } from '../security.js';
8
11
  import { consumeScannerWorkspaceGrant, issueScannerWorkspaceGrant } from '../scannerWorkspaceGrants.js';
9
12
  export const remediationRouter = Router();
13
+ const suiteRouteDeps = {
14
+ executeScan: executeSecurityScan,
15
+ consumeGrant: consumeScannerWorkspaceGrant,
16
+ upsertCases: upsertRemediationCases,
17
+ };
18
+ /**
19
+ * Server adapter for the versioned security scan contract.
20
+ *
21
+ * The scan is intentionally still spread at the top level: the current web
22
+ * client consumes that legacy shape. The versioned envelope is added beside
23
+ * it so newer clients can reason about coverage and the gate without breaking
24
+ * existing ones.
25
+ */
26
+ export async function handleSuiteRequest(req, res, deps = suiteRouteDeps) {
27
+ const body = req.body;
28
+ try {
29
+ const allowedScanners = new Set(['builtin', 'semgrep', 'trivy', 'osv-scanner']);
30
+ if (body.scanners && (!Array.isArray(body.scanners) || body.scanners.some(scanner => !allowedScanners.has(scanner)))) {
31
+ res.status(400).json({ error: 'scanners must contain only builtin, semgrep, trivy, or osv-scanner' });
32
+ return;
33
+ }
34
+ // The capability is consumed before any scan input is used. Its canonical
35
+ // server-side cwd remains the only workspace root passed to the scanner.
36
+ const cwd = deps.consumeGrant(body.grant);
37
+ const execution = await deps.executeScan({
38
+ root: cwd,
39
+ scanners: body.scanners,
40
+ saveWorkflow: false,
41
+ });
42
+ const cases = execution.scan.findings.length
43
+ ? await deps.upsertCases({ cwd, findings: execution.scan.findings })
44
+ : [];
45
+ const response = {
46
+ ...execution.scan,
47
+ scan: execution.scan,
48
+ coverage: execution.coverage,
49
+ delta: execution.delta ?? null,
50
+ gate: execution.gate,
51
+ workflowId: execution.workflow?.id ?? null,
52
+ schemaVersion: execution.schemaVersion,
53
+ cases,
54
+ };
55
+ res.json(response);
56
+ }
57
+ catch (err) {
58
+ // A new-findings gate without a baseline is a bad request, not a scanner
59
+ // crash. Preserve UsageError text so the caller sees the baseline remedy.
60
+ if (err instanceof UsageError) {
61
+ res.status(400).json({ error: err.message });
62
+ return;
63
+ }
64
+ res.status(400).json({ error: err instanceof Error ? err.message : 'Could not run Dvalin security suite' });
65
+ }
66
+ }
67
+ export function handleVerifyFixRequest(req, res) {
68
+ const verification = verifyFixRecord(req.body);
69
+ res.json({
70
+ ok: verification.ok,
71
+ reasons: verification.reasons,
72
+ record: verification.record ?? null,
73
+ });
74
+ }
10
75
  remediationRouter.get('/scanners', async (_req, res) => {
11
76
  res.json(await listDvalinScanners());
12
77
  });
13
- remediationRouter.post('/suite/authorize', async (req, res) => {
78
+ remediationRouter.post('/scanners/install', async (req, res) => {
14
79
  const body = req.body;
80
+ const allowed = new Set(['semgrep', 'trivy', 'osv-scanner']);
81
+ if (!body.scanner || !allowed.has(body.scanner)) {
82
+ res.status(400).json({ error: 'scanner must be semgrep, trivy, or osv-scanner' });
83
+ return;
84
+ }
85
+ const plan = dvalinScannerInstallPlan(body.scanner);
86
+ if (!plan.command || body.confirmed !== true || body.command !== plan.command) {
87
+ res.status(400).json({ error: 'The fixed scanner install command must be explicitly confirmed.' });
88
+ return;
89
+ }
15
90
  try {
16
91
  const cwd = await resolveAllowedCwd(body.cwd);
17
- res.json({ grant: issueScannerWorkspaceGrant(cwd) });
92
+ await installDvalinScanner(cwd, body.scanner);
93
+ const scanner = (await listDvalinScanners()).find(candidate => candidate.id === body.scanner);
94
+ if (!scanner?.available)
95
+ throw new Error(`${body.scanner} completed installation but is not available on PATH.`);
96
+ res.json(scanner);
18
97
  }
19
- catch (err) {
20
- res.status(403).json({ error: err instanceof Error ? err.message : 'Workspace is not allowed' });
98
+ catch (error) {
99
+ res.status(400).json({ error: error instanceof Error ? error.message : 'Could not install scanner' });
21
100
  }
22
101
  });
23
- remediationRouter.post('/suite', async (req, res) => {
102
+ remediationRouter.post('/suite/authorize', async (req, res) => {
24
103
  const body = req.body;
25
104
  try {
26
- const allowedScanners = new Set(['builtin', 'semgrep', 'trivy', 'osv-scanner']);
27
- if (body.scanners && (!Array.isArray(body.scanners) || body.scanners.some(scanner => !allowedScanners.has(scanner)))) {
28
- res.status(400).json({ error: 'scanners must contain only builtin, semgrep, trivy, or osv-scanner' });
29
- return;
30
- }
31
- const cwd = consumeScannerWorkspaceGrant(body.grant);
32
- const result = await runDvalinScanSuite(cwd, { scanners: body.scanners });
33
- const cases = result.findings.length
34
- ? await upsertRemediationCases({ cwd, findings: result.findings })
35
- : [];
36
- res.json({ ...result, cases });
105
+ const cwd = await resolveAllowedCwd(body.cwd);
106
+ res.json({ grant: issueScannerWorkspaceGrant(cwd) });
37
107
  }
38
108
  catch (err) {
39
- res.status(400).json({ error: err instanceof Error ? err.message : 'Could not run Dvalin security suite' });
109
+ res.status(403).json({ error: err instanceof Error ? err.message : 'Workspace is not allowed' });
40
110
  }
41
111
  });
112
+ remediationRouter.post('/suite', (req, res) => void handleSuiteRequest(req, res));
113
+ remediationRouter.post('/verify-fix', handleVerifyFixRequest);
42
114
  remediationRouter.get('/cases', async (req, res) => {
43
115
  try {
44
116
  const cwd = typeof req.query.cwd === 'string' && req.query.cwd