@clear-capabilities/agentic-security-scanner 0.185.0 → 0.186.1

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 (167) hide show
  1. package/CHANGELOG.md +22 -0
  2. package/bin/agentic-security.js +24 -1
  3. package/dist/1128.index.js +25 -21
  4. package/dist/2584.index.js +1 -1
  5. package/dist/4171.index.js +2 -2
  6. package/dist/5752.index.js +466 -0
  7. package/dist/7405.index.js +1 -1
  8. package/dist/8158.index.js +1713 -0
  9. package/dist/8798.index.js +1 -1
  10. package/dist/9382.index.js +2 -2
  11. package/dist/9579.index.js +1 -1
  12. package/dist/agentic-security.mjs +29 -29
  13. package/dist/agentic-security.mjs.sha256 +1 -1
  14. package/dist/{0b301d45b231f144a1b4.json → ca62ee93079be4c24eee.json} +7 -7
  15. package/package.json +7 -7
  16. package/src/dataflow/CLAUDE.md +6 -3
  17. package/src/dataflow/access-paths.js +12 -2
  18. package/src/dataflow/demand-query.js +279 -40
  19. package/src/dataflow/dep-fingerprint.js +1 -1
  20. package/src/dataflow/exploit-prover.js +6 -2
  21. package/src/dataflow/ir-cache.js +268 -0
  22. package/src/dataflow/privacy-taint.js +7 -0
  23. package/src/engine.js +62 -5
  24. package/src/ir/CLAUDE.md +4 -0
  25. package/src/ir/callgraph.js +36 -8
  26. package/src/ir/index.js +18 -4
  27. package/src/ir/parser-js.js +10 -0
  28. package/src/language/CLAUDE.md +13 -0
  29. package/src/language/nix-option-types.js +170 -0
  30. package/src/language/nix-script-taint.js +46 -3
  31. package/src/language/nix-secrets.js +20 -2
  32. package/src/lineage/CLAUDE.md +2 -1
  33. package/src/lineage/smt-orchestrator.js +47 -11
  34. package/src/lineage/smt-z3-backend.js +294 -0
  35. package/src/posture/CLAUDE.md +5 -1
  36. package/src/posture/business-logic.js +16 -7
  37. package/src/posture/dag-commands.js +442 -0
  38. package/src/posture/finding-defaults.js +19 -0
  39. package/src/posture/git-history.js +91 -1
  40. package/src/sast/CLAUDE.md +2 -0
  41. package/src/sast/_call-args.js +70 -0
  42. package/src/sast/init-scope.js +87 -0
  43. package/src/sast/listen-bind-address.js +49 -0
  44. package/src/sast/redirect-target.js +106 -0
  45. package/src/sast/reflected-input.js +76 -0
  46. package/src/sast/send-file-root.js +27 -0
  47. package/src/sast/sensitive-data-logging.js +38 -1
  48. package/dist/119.index.js +0 -197
  49. package/dist/128.index.js +0 -129
  50. package/dist/1293.index.js +0 -5689
  51. package/dist/1336.index.js +0 -16331
  52. package/dist/1351.index.js +0 -133
  53. package/dist/1387.index.js +0 -271
  54. package/dist/1437.index.js +0 -23
  55. package/dist/1445.index.js +0 -110
  56. package/dist/1505.index.js +0 -151
  57. package/dist/1557.index.js +0 -293
  58. package/dist/1621.index.js +0 -311
  59. package/dist/1751.index.js +0 -160
  60. package/dist/1765.index.js +0 -727
  61. package/dist/1861.index.js +0 -690
  62. package/dist/1906.index.js +0 -433
  63. package/dist/208.index.js +0 -1631
  64. package/dist/2223.index.js +0 -159
  65. package/dist/2238.index.js +0 -295
  66. package/dist/2530.index.js +0 -152
  67. package/dist/2565.index.js +0 -116
  68. package/dist/2574.index.js +0 -127
  69. package/dist/2620.index.js +0 -345
  70. package/dist/2773.index.js +0 -98
  71. package/dist/2775.index.js +0 -32
  72. package/dist/2966.index.js +0 -171
  73. package/dist/2972.index.js +0 -87
  74. package/dist/2991.index.js +0 -131
  75. package/dist/3063.index.js +0 -833
  76. package/dist/3075.index.js +0 -227
  77. package/dist/3121.index.js +0 -297
  78. package/dist/3314.index.js +0 -263
  79. package/dist/3480.index.js +0 -1822
  80. package/dist/3481.index.js +0 -24
  81. package/dist/3506.index.js +0 -268
  82. package/dist/3533.index.js +0 -591
  83. package/dist/3653.index.js +0 -450
  84. package/dist/3740.index.js +0 -722
  85. package/dist/3822.index.js +0 -131
  86. package/dist/3868.index.js +0 -292
  87. package/dist/3918.index.js +0 -192
  88. package/dist/4090.index.js +0 -288
  89. package/dist/4113.index.js +0 -1286
  90. package/dist/4121.index.js +0 -1190
  91. package/dist/4142.index.js +0 -690
  92. package/dist/4168.index.js +0 -509
  93. package/dist/4281.index.js +0 -993
  94. package/dist/4336.index.js +0 -436
  95. package/dist/4387.index.js +0 -532
  96. package/dist/4413.index.js +0 -302
  97. package/dist/4476.index.js +0 -4510
  98. package/dist/4491.index.js +0 -133
  99. package/dist/4538.index.js +0 -185
  100. package/dist/4684.index.js +0 -319
  101. package/dist/4740.index.js +0 -165
  102. package/dist/4780.index.js +0 -209
  103. package/dist/4802.index.js +0 -225
  104. package/dist/4812.index.js +0 -379
  105. package/dist/4835.index.js +0 -126
  106. package/dist/494.index.js +0 -226
  107. package/dist/4991.index.js +0 -549
  108. package/dist/5199.index.js +0 -305
  109. package/dist/5216.index.js +0 -109
  110. package/dist/5439.index.js +0 -301
  111. package/dist/5443.index.js +0 -97
  112. package/dist/5496.index.js +0 -377
  113. package/dist/5738.index.js +0 -240
  114. package/dist/5801.index.js +0 -588
  115. package/dist/5817.index.js +0 -714
  116. package/dist/5858.index.js +0 -223
  117. package/dist/5933.index.js +0 -143
  118. package/dist/601.index.js +0 -23
  119. package/dist/6173.index.js +0 -273
  120. package/dist/6291.index.js +0 -1871
  121. package/dist/6312.index.js +0 -666
  122. package/dist/634.index.js +0 -16182
  123. package/dist/644.index.js +0 -87
  124. package/dist/6508.index.js +0 -283
  125. package/dist/6560.index.js +0 -645
  126. package/dist/6576.index.js +0 -422
  127. package/dist/6579.index.js +0 -271
  128. package/dist/6655.index.js +0 -3221
  129. package/dist/6745.index.js +0 -305
  130. package/dist/6818.index.js +0 -21642
  131. package/dist/6932.index.js +0 -1190
  132. package/dist/6972.index.js +0 -167
  133. package/dist/6995.index.js +0 -163
  134. package/dist/7249.index.js +0 -191
  135. package/dist/7372.index.js +0 -1197
  136. package/dist/7546.index.js +0 -541
  137. package/dist/76.index.js +0 -448
  138. package/dist/7879.index.js +0 -163
  139. package/dist/8025.index.js +0 -130
  140. package/dist/8054.index.js +0 -248
  141. package/dist/808.index.js +0 -1330
  142. package/dist/8097.index.js +0 -201
  143. package/dist/8126.index.js +0 -191
  144. package/dist/8178.index.js +0 -78
  145. package/dist/8382.index.js +0 -93
  146. package/dist/8408.index.js +0 -261
  147. package/dist/8540.index.js +0 -174
  148. package/dist/8635.index.js +0 -802
  149. package/dist/8688.index.js +0 -410
  150. package/dist/8699.index.js +0 -779
  151. package/dist/8891.index.js +0 -457
  152. package/dist/8916.index.js +0 -885
  153. package/dist/9146.index.js +0 -170
  154. package/dist/9168.index.js +0 -841
  155. package/dist/9292.index.js +0 -369
  156. package/dist/9422.index.js +0 -866
  157. package/dist/9440.index.js +0 -453
  158. package/dist/9479.index.js +0 -152
  159. package/dist/9481.index.js +0 -220
  160. package/dist/9539.index.js +0 -100
  161. package/dist/9547.index.js +0 -103
  162. package/dist/9692.index.js +0 -90
  163. package/dist/9800.index.js +0 -462
  164. package/dist/9899.index.js +0 -138
  165. package/dist/9981.index.js +0 -206
  166. package/dist/999.index.js +0 -117
  167. package/dist/9999.index.js +0 -1698
@@ -1,206 +0,0 @@
1
- export const id = 9981;
2
- export const ids = [9981];
3
- export const modules = {
4
-
5
- /***/ 89981:
6
- /***/ ((__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) => {
7
-
8
- /* harmony export */ __webpack_require__.d(__webpack_exports__, {
9
- /* harmony export */ buildBaselineMap: () => (/* binding */ buildBaselineMap),
10
- /* harmony export */ computeMTTR: () => (/* binding */ computeMTTR),
11
- /* harmony export */ fingerprintFinding: () => (/* binding */ fingerprintFinding),
12
- /* harmony export */ renderSlaSummary: () => (/* binding */ renderSlaSummary),
13
- /* harmony export */ stampFindingTimestamps: () => (/* binding */ stampFindingTimestamps)
14
- /* harmony export */ });
15
- /* unused harmony export findingsExceedingSLA */
16
- /* harmony import */ var node_crypto__WEBPACK_IMPORTED_MODULE_0__ = __webpack_require__(77598);
17
- /* harmony import */ var _provenance_schema_js__WEBPACK_IMPORTED_MODULE_1__ = __webpack_require__(49171);
18
- // 0.8.0 Feat-11: MTTR / finding-age tracking — per-finding firstSeenAt/lastSeenAt with SLA breach detection.
19
- //
20
- // Stamps every finding with `firstSeenAt` (preserved from the baseline if the
21
- // finding existed previously) and `lastSeenAt` (the current scan time). Surfaces
22
- // findings exceeding an SLA threshold per severity.
23
- //
24
- // Pure function — does not write to disk. The caller (CLI / fix workflow) decides
25
- // when to persist firstSeenAt back into the baseline.
26
-
27
-
28
-
29
-
30
- // FR-PROV-019: "reports never show an age without its basis and confidence."
31
- // FINDING_ORIGIN is the only basis backed by a resolved git commit for the
32
- // finding's actual introduction; EARLIEST_OBSERVABLE is also git-derived but
33
- // partial (weaker claim, no exact introduction commit). UNCOMMITTED and
34
- // FIRST_OBSERVED are both wall-clock fallbacks — the age is a first-seen
35
- // timestamp, never resolved against git history — and must say so honestly
36
- // rather than read like a proven date.
37
- function _ageBasisLabel(ageBasis, confidence) {
38
- const level = confidence?.level && confidence.level !== 'unknown' ? confidence.level.toUpperCase() : null;
39
- switch (ageBasis) {
40
- case _provenance_schema_js__WEBPACK_IMPORTED_MODULE_1__/* .AGE_BASIS */ .pI.FINDING_ORIGIN:
41
- return `proven origin${level ? `, ${level} confidence` : ''}`;
42
- case _provenance_schema_js__WEBPACK_IMPORTED_MODULE_1__/* .AGE_BASIS */ .pI.EARLIEST_OBSERVABLE:
43
- return `earliest observable commit, partial history${level ? `, ${level} confidence` : ''}`;
44
- case _provenance_schema_js__WEBPACK_IMPORTED_MODULE_1__/* .AGE_BASIS */ .pI.UNCOMMITTED:
45
- return 'uncommitted — first-seen fallback, origin not proven';
46
- case _provenance_schema_js__WEBPACK_IMPORTED_MODULE_1__/* .AGE_BASIS */ .pI.FIRST_OBSERVED:
47
- default:
48
- return 'first-seen fallback — origin not proven';
49
- }
50
- }
51
-
52
- // Stable fingerprint for cross-scan finding identity. Mirrors the dedupe key.
53
- // Exported so a caller can compute the "removed since baseline" (i.e. fixed)
54
- // set that computeMTTR needs, using the exact same identity function
55
- // buildBaselineMap uses internally — a caller-side reimplementation would
56
- // risk drifting from this one and silently under/over-counting fixes.
57
- function fingerprintFinding(f) { return _fingerprint(f); }
58
- function _fingerprint(f) {
59
- const file = (f.file || '').split(' -> ').pop();
60
- const line = f.line || f.source?.line || f.sink?.line || 0;
61
- const vuln = (f.vuln || f.type || '').replace(/\W+/g, '_').toLowerCase();
62
- const cwe = (f.cwe || '').toUpperCase();
63
- return node_crypto__WEBPACK_IMPORTED_MODULE_0__.createHash('sha256').update(`${file}:${line}:${vuln}:${cwe}`).digest('hex').slice(0, 16);
64
- }
65
-
66
- // Stamp findings in-place with firstSeenAt / lastSeenAt / ageDays.
67
- // `findings` — current scan findings (will be mutated).
68
- // `baselineMap` — optional Map of fingerprint → { firstSeenAt }. Pass an empty Map for first run.
69
- // `now` — Date.now() at scan time (allow injection for tests).
70
- function stampFindingTimestamps(findings, baselineMap = new Map(), now = Date.now()) {
71
- const nowIso = new Date(now).toISOString();
72
- for (const f of findings) {
73
- const fp = _fingerprint(f);
74
- f._fp = fp;
75
- const prev = baselineMap.get(fp);
76
- f.firstSeenAt = prev?.firstSeenAt || nowIso;
77
- f.lastSeenAt = nowIso;
78
- const firstMs = Date.parse(f.firstSeenAt);
79
- f.ageDays = Math.max(0, Math.floor((now - firstMs) / 86400000));
80
- // FR-PROV-019: age/SLA basis. ageDays above stays pure wall-clock —
81
- // every existing SLA/computeMTTR consumer keeps its current meaning.
82
- // ageBasis + provenAgeDays are ADDITIVE: a report can show both and
83
- // explain the discrepancy, never silently swap which number "age" means.
84
- const status = f.findingProvenance?.status;
85
- const origin = f.findingProvenance?.findingOrigin;
86
- if (status === 'complete' && origin?.authorDate) {
87
- f.ageBasis = _provenance_schema_js__WEBPACK_IMPORTED_MODULE_1__/* .AGE_BASIS */ .pI.FINDING_ORIGIN;
88
- f.provenAgeDays = Math.max(0, Math.floor((now - Date.parse(origin.authorDate)) / 86400000));
89
- } else if (status === 'partial' && origin?.authorDate) {
90
- f.ageBasis = _provenance_schema_js__WEBPACK_IMPORTED_MODULE_1__/* .AGE_BASIS */ .pI.EARLIEST_OBSERVABLE;
91
- f.provenAgeDays = Math.max(0, Math.floor((now - Date.parse(origin.authorDate)) / 86400000));
92
- } else if (status === 'uncommitted') {
93
- f.ageBasis = _provenance_schema_js__WEBPACK_IMPORTED_MODULE_1__/* .AGE_BASIS */ .pI.UNCOMMITTED;
94
- f.provenAgeDays = f.ageDays;
95
- } else {
96
- f.ageBasis = _provenance_schema_js__WEBPACK_IMPORTED_MODULE_1__/* .AGE_BASIS */ .pI.FIRST_OBSERVED;
97
- f.provenAgeDays = f.ageDays;
98
- }
99
- }
100
- return findings;
101
- }
102
-
103
- // Build a baseline map from an existing baseline JSON (or scan JSON shape).
104
- // Recognised top-level: { findings, secrets, supplyChain }. Each entry retains
105
- // firstSeenAt if it had one previously.
106
- function buildBaselineMap(baselineJson) {
107
- const map = new Map();
108
- const all = [
109
- ...(baselineJson?.findings || []),
110
- ...(baselineJson?.secrets || []),
111
- ...(baselineJson?.supplyChain || []).filter(s => s.type === 'vulnerable_dep'),
112
- ];
113
- for (const f of all) {
114
- const fp = _fingerprint(f);
115
- if (f.firstSeenAt) map.set(fp, { firstSeenAt: f.firstSeenAt });
116
- }
117
- return map;
118
- }
119
-
120
- // Identify findings exceeding an SLA threshold.
121
- // slaDays: { critical: 7, high: 30, medium: 60, low: 90, info: 180 } (default).
122
- function findingsExceedingSLA(findings, slaDays = null) {
123
- const SLA = slaDays || { critical: 7, high: 30, medium: 60, low: 90, info: 180 };
124
- return findings.filter(f => {
125
- const limit = SLA[f.severity] ?? 90;
126
- return (f.ageDays || 0) > limit;
127
- });
128
- }
129
-
130
- // Median age (days) of the currently-open findings, PLUS the ageBasis/
131
- // confidence of whichever finding landed on that median — a single-scan proxy
132
- // for "how long has this debt been sitting". True MTTR (computeMTTR) needs the
133
- // set of findings that were FIXED; this reports the open backlog's median age
134
- // so a scan can show whether debt is getting older. Returns null on empty
135
- // input. Local — surfaced only through renderSlaSummary (its sole consumer).
136
- //
137
- // FR-PROV-019: the days figure prefers `provenAgeDays` (git-derived when
138
- // available) over the pure-wall-clock `ageDays`, and the ageBasis/confidence
139
- // travel WITH the day count they describe — never a bare number with the
140
- // basis looked up separately, which is how the original miss happened
141
- // (ageBasis was stamped onto the finding but never reached the string that
142
- // printed its age). Findings stamped by an older/test caller that never ran
143
- // through stampFindingTimestamps (no ageBasis at all) degrade to the same
144
- // honest "not proven" label FIRST_OBSERVED gets, never a false claim.
145
- function medianOpenAge(findings) {
146
- const entries = (findings || [])
147
- .map(f => ({
148
- days: f.provenAgeDays != null ? f.provenAgeDays : (f.ageDays || 0),
149
- ageBasis: f.ageBasis || _provenance_schema_js__WEBPACK_IMPORTED_MODULE_1__/* .AGE_BASIS */ .pI.FIRST_OBSERVED,
150
- confidence: f.findingProvenance?.confidence || null,
151
- }))
152
- .sort((a, b) => a.days - b.days);
153
- if (!entries.length) return null;
154
- return entries[Math.floor(entries.length / 2)];
155
- }
156
-
157
- // One-line SLA-breach summary for surfacing after a scan (#10). Returns null
158
- // when nothing is past its per-severity SLA. Pairs with medianOpenAge for a
159
- // "is my security debt aging" readout that the vibecoder can act on.
160
- //
161
- // FR-PROV-019: never prints the median age number without its basis and
162
- // confidence alongside it — see medianOpenAge/_ageBasisLabel above.
163
- function renderSlaSummary(findings, slaDays = null) {
164
- const breached = findingsExceedingSLA(findings || [], slaDays);
165
- if (!breached.length) return null;
166
- const bySev = {};
167
- for (const f of breached) bySev[f.severity] = (bySev[f.severity] || 0) + 1;
168
- const parts = ['critical', 'high', 'medium', 'low', 'info'].filter(s => bySev[s]).map(s => `${bySev[s]} ${s}`);
169
- const median = medianOpenAge(findings);
170
- const ageNote = median != null
171
- ? ` (median open age ${median.days}d, ${_ageBasisLabel(median.ageBasis, median.confidence)})`
172
- : '';
173
- return `${breached.length} finding(s) past remediation SLA: ${parts.join(', ')}${ageNote}`;
174
- }
175
-
176
- // Compute MTTR statistics from a series of saved scans (each with firstSeen/lastSeen).
177
- // Useful for trend reporting.
178
- function computeMTTR(removedFindings) {
179
- // removedFindings: findings that existed in baseline but no longer in current
180
- // (i.e., were fixed). Each carries firstSeenAt and lastSeenAt from the baseline.
181
- if (!removedFindings.length) return { count: 0, meanDays: null, medianDays: null, perSeverity: {} };
182
- const ages = removedFindings.map(f => {
183
- const first = Date.parse(f.firstSeenAt || 0);
184
- const last = Date.parse(f.lastSeenAt || 0);
185
- return Math.max(0, (last - first) / 86400000);
186
- }).sort((a, b) => a - b);
187
- const meanDays = ages.reduce((s, x) => s + x, 0) / ages.length;
188
- const medianDays = ages[Math.floor(ages.length / 2)];
189
- const perSeverity = {};
190
- for (const f of removedFindings) {
191
- const sev = f.severity || 'medium';
192
- (perSeverity[sev] = perSeverity[sev] || []).push(
193
- Math.max(0, (Date.parse(f.lastSeenAt || 0) - Date.parse(f.firstSeenAt || 0)) / 86400000)
194
- );
195
- }
196
- for (const k of Object.keys(perSeverity)) {
197
- const a = perSeverity[k];
198
- perSeverity[k] = { count: a.length, meanDays: a.reduce((s,x)=>s+x,0)/a.length };
199
- }
200
- return { count: removedFindings.length, meanDays, medianDays, perSeverity };
201
- }
202
-
203
-
204
- /***/ })
205
-
206
- };
package/dist/999.index.js DELETED
@@ -1,117 +0,0 @@
1
- export const id = 999;
2
- export const ids = [999];
3
- export const modules = {
4
-
5
- /***/ 60999:
6
- /***/ ((__unused_webpack___webpack_module__, __webpack_exports__, __webpack_require__) => {
7
-
8
- /* harmony export */ __webpack_require__.d(__webpack_exports__, {
9
- /* harmony export */ validateScenario: () => (/* binding */ validateScenario)
10
- /* harmony export */ });
11
- /* unused harmony exports SCENARIO_VERSION, SCENARIO_OPERATION_KINDS, SCENARIO_OPERATION_REQUIRED_FIELDS */
12
- // scenario.js — M5 deliverable #3a (FR-502 §10.10, DFG-0xx): the
13
- // Scenario extension contract — a hypothetical set of graph overrides,
14
- // NOT a DataFlowGraph v1 entity, mirrors recipient-profile.js's own
15
- // contract shape exactly (structural-only {valid, errors} validator,
16
- // zero graph access, per-field evidence typing for the fields a
17
- // Scenario actually overrides).
18
- //
19
- // See docs/superpowers/plans/2026-09-02-data-flow-explorer-m5-whatif-simulator-scoping.md
20
- // for the full design reasoning, including why EVIDENCE_GRADES gained
21
- // 'assumed' instead of reusing 'declared', and why this module's own
22
- // operations catalog excludes synthetic node/edge insertion (deferred).
23
-
24
- const SCENARIO_VERSION = '1.0.0';
25
-
26
- // The 6 in-scope hypothetical-change kinds (FR-502's own 7, minus the
27
- // deferred synthetic-insertion category). Each operation names its
28
- // target canonical id(s) plus the override value(s); scenario-engine.js
29
- // is the only consumer that interprets `kind`.
30
- const SCENARIO_OPERATION_KINDS = Object.freeze([
31
- 'require_transit_protection',
32
- 'apply_handling',
33
- 'remove_entity',
34
- 'replace_recipient_fact',
35
- 'change_storage_fact',
36
- 'change_governance_fact',
37
- ]);
38
-
39
- // Per-operation-kind required fields, beyond the universal `kind`. Kept
40
- // as data (not inline in validateScenario) for the same reason
41
- // SCENARIO_OPERATION_KINDS above is — a single source of truth a table
42
- // can be checked against — though scenario-engine.js does not currently
43
- // import this table itself; it only mentions it in a prose comment on
44
- // its own _applyReplaceRecipientFact.
45
- const SCENARIO_OPERATION_REQUIRED_FIELDS = Object.freeze({
46
- require_transit_protection: ['targetEdgeId'],
47
- apply_handling: ['targetEdgeId', 'handling'],
48
- remove_entity: ['targetNodeId'],
49
- replace_recipient_fact: ['targetNodeId', 'field', 'value'],
50
- change_storage_fact: ['targetNodeId', 'field', 'value'],
51
- change_governance_fact: ['targetFlowId', 'field', 'value'],
52
- });
53
-
54
- function _isNonEmptyString(v) { return typeof v === 'string' && v.length > 0; }
55
- function _isPlainObject(v) { return v !== null && typeof v === 'object' && !Array.isArray(v); }
56
- function _isStringArray(v) { return Array.isArray(v) && v.every((x) => typeof x === 'string'); }
57
-
58
- /**
59
- * Structural validation only — mirrors validateRecipientProfile's own
60
- * {valid, errors} shape and "never throws" contract. Does not check
61
- * that targetEdgeId/targetNodeId/targetFlowId actually exist in any
62
- * real graph — that is scenario-engine.js's job at apply time, since
63
- * this module has zero graph access by design.
64
- */
65
- function validateScenario(record) {
66
- const errors = [];
67
- const err = (p, message) => errors.push({ path: p, message });
68
- if (!record || typeof record !== 'object' || Array.isArray(record)) {
69
- err('$', 'Scenario record must be an object');
70
- return { valid: false, errors };
71
- }
72
- if (!_isNonEmptyString(record.id) || !record.id.startsWith('scenario:')) {
73
- err('$.id', 'id is required and must start with "scenario:"');
74
- }
75
- if (!_isNonEmptyString(record.version)) err('$.version', 'version is required');
76
- if (!_isNonEmptyString(record.baseGraphId)) err('$.baseGraphId', 'baseGraphId is required');
77
- if (!_isNonEmptyString(record.baseGraphDigest)) err('$.baseGraphDigest', 'baseGraphDigest is required');
78
- if (!_isNonEmptyString(record.author)) err('$.author', 'author is required');
79
- if (!_isNonEmptyString(record.createdAt)) err('$.createdAt', 'createdAt is required');
80
- if (record.expiration !== null && record.expiration !== undefined && !_isNonEmptyString(record.expiration)) {
81
- err('$.expiration', 'expiration must be a string or null');
82
- }
83
- if (!_isStringArray(record.assumptions ?? [])) err('$.assumptions', 'assumptions must be an array of strings');
84
- if (!_isStringArray(record.verificationRequirements ?? [])) {
85
- err('$.verificationRequirements', 'verificationRequirements must be an array of strings');
86
- }
87
- if (!Array.isArray(record.operations) || record.operations.length === 0) {
88
- err('$.operations', 'operations is required and must be a non-empty array');
89
- } else {
90
- record.operations.forEach((op, i) => {
91
- const p = `$.operations[${i}]`;
92
- if (!_isPlainObject(op)) { err(p, 'each operation must be an object'); return; }
93
- if (!SCENARIO_OPERATION_KINDS.includes(op.kind)) {
94
- err(`${p}.kind`, `unrecognized operation kind "${op.kind}" — must be one of ${SCENARIO_OPERATION_KINDS.join('|')}`);
95
- return;
96
- }
97
- for (const field of SCENARIO_OPERATION_REQUIRED_FIELDS[op.kind]) {
98
- if (op[field] === undefined || op[field] === null || op[field] === '') {
99
- err(`${p}.${field}`, `operation of kind "${op.kind}" requires "${field}"`);
100
- }
101
- }
102
- });
103
- }
104
- // simulatedDelta is populated by scenario-engine.js after apply, never
105
- // by a caller constructing the pre-apply record — null is the only
106
- // valid pre-apply value, an object (scenario-diff.js's own shape) the
107
- // only valid post-apply value.
108
- if (record.simulatedDelta !== null && record.simulatedDelta !== undefined && !_isPlainObject(record.simulatedDelta)) {
109
- err('$.simulatedDelta', 'simulatedDelta must be null (before apply) or an object (after apply)');
110
- }
111
- return { valid: errors.length === 0, errors };
112
- }
113
-
114
-
115
- /***/ })
116
-
117
- };