@clear-capabilities/agentic-security-scanner 0.184.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 (228) hide show
  1. package/CHANGELOG.md +37 -0
  2. package/bin/agentic-security.js +111 -1
  3. package/dist/1128.index.js +912 -0
  4. package/dist/1665.index.js +828 -0
  5. package/dist/2584.index.js +1 -1
  6. package/dist/4171.index.js +2 -2
  7. package/dist/5752.index.js +466 -0
  8. package/dist/7405.index.js +1 -1
  9. package/dist/8158.index.js +1713 -0
  10. package/dist/8798.index.js +1 -1
  11. package/dist/9382.index.js +2 -2
  12. package/dist/9579.index.js +1 -1
  13. package/dist/agentic-security.mjs +29 -29
  14. package/dist/agentic-security.mjs.sha256 +1 -1
  15. package/dist/{dad58d1113a12c23a142.json → ca62ee93079be4c24eee.json} +29 -12
  16. package/dist/frontend/src/shell.js +12 -2
  17. package/package.json +29 -12
  18. package/src/dataflow/CLAUDE.md +46 -1
  19. package/src/dataflow/access-paths.js +12 -2
  20. package/src/dataflow/backward.js +42 -7
  21. package/src/dataflow/cross-service-taint.js +83 -1
  22. package/src/dataflow/demand-query.js +1168 -0
  23. package/src/dataflow/dep-fingerprint.js +718 -0
  24. package/src/dataflow/engine.js +48 -6
  25. package/src/dataflow/exploit-prover.js +6 -2
  26. package/src/dataflow/ifds-precise.js +22 -0
  27. package/src/dataflow/incremental-replay.js +118 -0
  28. package/src/dataflow/incremental-session.js +257 -0
  29. package/src/dataflow/incremental.js +237 -35
  30. package/src/dataflow/index.js +25 -94
  31. package/src/dataflow/ir-cache.js +268 -0
  32. package/src/dataflow/privacy-taint.js +7 -0
  33. package/src/dataflow/summaries.js +72 -6
  34. package/src/dataflow/tabulation.js +80 -24
  35. package/src/engine.js +113 -8
  36. package/src/graph/CLAUDE.md +31 -0
  37. package/src/graph/adapters/artifact.js +81 -0
  38. package/src/graph/adapters/crossrepo.js +75 -0
  39. package/src/graph/adapters/dataflow.js +76 -0
  40. package/src/graph/adapters/provenance.js +92 -0
  41. package/src/graph/adapters/semantic.js +89 -0
  42. package/src/graph/crosswalk-builders.js +152 -0
  43. package/src/graph/crosswalk.js +146 -0
  44. package/src/graph/index.js +15 -0
  45. package/src/graph/observation.js +57 -0
  46. package/src/graph/refs.js +105 -0
  47. package/src/graph/registry.js +129 -0
  48. package/src/graph/relations.js +81 -0
  49. package/src/graph/scc.js +241 -0
  50. package/src/graph/view.js +254 -0
  51. package/src/ir/CLAUDE.md +4 -0
  52. package/src/ir/callgraph.js +36 -8
  53. package/src/ir/index.js +18 -4
  54. package/src/ir/parser-js.js +10 -0
  55. package/src/language/CLAUDE.md +13 -0
  56. package/src/language/nix-option-types.js +170 -0
  57. package/src/language/nix-script-taint.js +46 -3
  58. package/src/language/nix-secrets.js +20 -2
  59. package/src/lineage/CLAUDE.md +72 -8
  60. package/src/lineage/DESIGN_GRAPH_BUILDER.md +1 -1
  61. package/src/lineage/DESIGN_PATH_PROVENANCE.md +6 -0
  62. package/src/lineage/boundary-contract.js +273 -0
  63. package/src/lineage/completion.js +205 -0
  64. package/src/lineage/continuation.js +140 -0
  65. package/src/lineage/control-credit.js +313 -0
  66. package/src/lineage/correlation.js +199 -0
  67. package/src/lineage/coverage.js +8 -1
  68. package/src/lineage/cross-repo-link.js +22 -0
  69. package/src/lineage/cut-planner.js +548 -0
  70. package/src/lineage/driver.js +219 -66
  71. package/src/lineage/engine.js +166 -21
  72. package/src/lineage/export-json.js +5 -0
  73. package/src/lineage/graph-builder.js +84 -7
  74. package/src/lineage/haskell-view.js +59 -0
  75. package/src/lineage/index.js +3 -0
  76. package/src/lineage/nix-view.js +35 -0
  77. package/src/lineage/owned-build.js +77 -0
  78. package/src/lineage/owned-worker-entry.js +22 -0
  79. package/src/lineage/owned-worker.js +95 -0
  80. package/src/lineage/path-evidence.js +123 -0
  81. package/src/lineage/path-predicates.js +529 -0
  82. package/src/lineage/path-query.js +189 -20
  83. package/src/lineage/path-store.js +191 -17
  84. package/src/lineage/scc-solver.js +186 -0
  85. package/src/lineage/smt-orchestrator.js +174 -0
  86. package/src/lineage/smt-z3-backend.js +294 -0
  87. package/src/lineage/source-seeding.js +36 -2
  88. package/src/lineage/summaries.js +66 -4
  89. package/src/lineage/value-versions.js +130 -0
  90. package/src/lineage/witness-selection.js +95 -0
  91. package/src/pipeline/scan-health.js +18 -0
  92. package/src/posture/CLAUDE.md +17 -0
  93. package/src/posture/business-logic.js +16 -7
  94. package/src/posture/dag-commands.js +442 -0
  95. package/src/posture/evidence-bundle.js +1 -1
  96. package/src/posture/finding-defaults.js +19 -0
  97. package/src/posture/git-history.js +91 -1
  98. package/src/posture/witness-bundle.js +573 -0
  99. package/src/posture/witness-runtime.js +276 -0
  100. package/src/report/index.js +2 -0
  101. package/src/sast/CLAUDE.md +2 -0
  102. package/src/sast/_call-args.js +70 -0
  103. package/src/sast/init-scope.js +87 -0
  104. package/src/sast/listen-bind-address.js +49 -0
  105. package/src/sast/redirect-target.js +106 -0
  106. package/src/sast/reflected-input.js +76 -0
  107. package/src/sast/send-file-root.js +27 -0
  108. package/src/sast/sensitive-data-logging.js +38 -1
  109. package/dist/119.index.js +0 -197
  110. package/dist/128.index.js +0 -129
  111. package/dist/1293.index.js +0 -5689
  112. package/dist/1336.index.js +0 -16182
  113. package/dist/1351.index.js +0 -133
  114. package/dist/1387.index.js +0 -271
  115. package/dist/1437.index.js +0 -23
  116. package/dist/1445.index.js +0 -110
  117. package/dist/1505.index.js +0 -151
  118. package/dist/1557.index.js +0 -293
  119. package/dist/1621.index.js +0 -311
  120. package/dist/1751.index.js +0 -160
  121. package/dist/1765.index.js +0 -727
  122. package/dist/1861.index.js +0 -690
  123. package/dist/1906.index.js +0 -433
  124. package/dist/208.index.js +0 -1631
  125. package/dist/2223.index.js +0 -159
  126. package/dist/2238.index.js +0 -295
  127. package/dist/2530.index.js +0 -152
  128. package/dist/2565.index.js +0 -116
  129. package/dist/2574.index.js +0 -127
  130. package/dist/2620.index.js +0 -345
  131. package/dist/2773.index.js +0 -98
  132. package/dist/2775.index.js +0 -32
  133. package/dist/2966.index.js +0 -171
  134. package/dist/2972.index.js +0 -87
  135. package/dist/2991.index.js +0 -131
  136. package/dist/3063.index.js +0 -833
  137. package/dist/3075.index.js +0 -227
  138. package/dist/3121.index.js +0 -297
  139. package/dist/3314.index.js +0 -263
  140. package/dist/3480.index.js +0 -1822
  141. package/dist/3481.index.js +0 -24
  142. package/dist/3506.index.js +0 -268
  143. package/dist/3533.index.js +0 -591
  144. package/dist/3653.index.js +0 -450
  145. package/dist/3740.index.js +0 -722
  146. package/dist/3822.index.js +0 -131
  147. package/dist/3868.index.js +0 -292
  148. package/dist/3918.index.js +0 -192
  149. package/dist/4090.index.js +0 -288
  150. package/dist/4113.index.js +0 -1286
  151. package/dist/4121.index.js +0 -1190
  152. package/dist/4142.index.js +0 -690
  153. package/dist/4168.index.js +0 -509
  154. package/dist/4281.index.js +0 -993
  155. package/dist/4336.index.js +0 -436
  156. package/dist/4387.index.js +0 -532
  157. package/dist/4413.index.js +0 -302
  158. package/dist/4476.index.js +0 -4510
  159. package/dist/4491.index.js +0 -133
  160. package/dist/4538.index.js +0 -185
  161. package/dist/4684.index.js +0 -319
  162. package/dist/4740.index.js +0 -165
  163. package/dist/4780.index.js +0 -209
  164. package/dist/4802.index.js +0 -225
  165. package/dist/4812.index.js +0 -379
  166. package/dist/4835.index.js +0 -126
  167. package/dist/494.index.js +0 -226
  168. package/dist/4991.index.js +0 -549
  169. package/dist/5199.index.js +0 -305
  170. package/dist/5216.index.js +0 -109
  171. package/dist/5439.index.js +0 -301
  172. package/dist/5443.index.js +0 -97
  173. package/dist/5496.index.js +0 -377
  174. package/dist/5738.index.js +0 -240
  175. package/dist/5801.index.js +0 -588
  176. package/dist/5817.index.js +0 -714
  177. package/dist/5858.index.js +0 -223
  178. package/dist/5933.index.js +0 -143
  179. package/dist/601.index.js +0 -23
  180. package/dist/6173.index.js +0 -273
  181. package/dist/6291.index.js +0 -1871
  182. package/dist/6312.index.js +0 -666
  183. package/dist/634.index.js +0 -16182
  184. package/dist/644.index.js +0 -87
  185. package/dist/6508.index.js +0 -283
  186. package/dist/6560.index.js +0 -645
  187. package/dist/6576.index.js +0 -422
  188. package/dist/6579.index.js +0 -271
  189. package/dist/6655.index.js +0 -3221
  190. package/dist/6745.index.js +0 -305
  191. package/dist/6818.index.js +0 -21642
  192. package/dist/6932.index.js +0 -1190
  193. package/dist/6972.index.js +0 -167
  194. package/dist/6995.index.js +0 -163
  195. package/dist/7249.index.js +0 -191
  196. package/dist/7372.index.js +0 -1197
  197. package/dist/7546.index.js +0 -541
  198. package/dist/76.index.js +0 -448
  199. package/dist/7879.index.js +0 -163
  200. package/dist/8025.index.js +0 -130
  201. package/dist/8054.index.js +0 -248
  202. package/dist/808.index.js +0 -1330
  203. package/dist/8097.index.js +0 -201
  204. package/dist/8126.index.js +0 -191
  205. package/dist/8178.index.js +0 -78
  206. package/dist/8382.index.js +0 -93
  207. package/dist/8408.index.js +0 -261
  208. package/dist/8540.index.js +0 -174
  209. package/dist/8635.index.js +0 -802
  210. package/dist/8688.index.js +0 -410
  211. package/dist/8699.index.js +0 -779
  212. package/dist/8891.index.js +0 -457
  213. package/dist/8916.index.js +0 -885
  214. package/dist/9146.index.js +0 -170
  215. package/dist/9168.index.js +0 -841
  216. package/dist/9292.index.js +0 -369
  217. package/dist/9422.index.js +0 -866
  218. package/dist/9440.index.js +0 -453
  219. package/dist/9479.index.js +0 -152
  220. package/dist/9481.index.js +0 -220
  221. package/dist/9539.index.js +0 -100
  222. package/dist/9547.index.js +0 -103
  223. package/dist/9692.index.js +0 -90
  224. package/dist/9800.index.js +0 -462
  225. package/dist/9899.index.js +0 -138
  226. package/dist/9981.index.js +0 -206
  227. package/dist/999.index.js +0 -117
  228. 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
- };