@sun-asterisk/sungen 3.2.17 → 3.2.18

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 (187) hide show
  1. package/dist/cli/commands/audit.d.ts.map +1 -1
  2. package/dist/cli/commands/audit.js +23 -0
  3. package/dist/cli/commands/audit.js.map +1 -1
  4. package/dist/cli/commands/delivery.d.ts.map +1 -1
  5. package/dist/cli/commands/delivery.js +209 -16
  6. package/dist/cli/commands/delivery.js.map +1 -1
  7. package/dist/cli/index.js +5 -0
  8. package/dist/cli/index.js.map +1 -1
  9. package/dist/dashboard/snapshot-builder.d.ts.map +1 -1
  10. package/dist/dashboard/snapshot-builder.js +8 -1
  11. package/dist/dashboard/snapshot-builder.js.map +1 -1
  12. package/dist/dashboard/templates/index.html +1 -1
  13. package/dist/exporters/api-environment.d.ts +11 -0
  14. package/dist/exporters/api-environment.d.ts.map +1 -0
  15. package/dist/exporters/api-environment.js +129 -0
  16. package/dist/exporters/api-environment.js.map +1 -0
  17. package/dist/exporters/feature-parser.d.ts +16 -1
  18. package/dist/exporters/feature-parser.d.ts.map +1 -1
  19. package/dist/exporters/feature-parser.js +21 -2
  20. package/dist/exporters/feature-parser.js.map +1 -1
  21. package/dist/exporters/matrix/build.d.ts +70 -0
  22. package/dist/exporters/matrix/build.d.ts.map +1 -0
  23. package/dist/exporters/matrix/build.js +516 -0
  24. package/dist/exporters/matrix/build.js.map +1 -0
  25. package/dist/exporters/matrix/export.d.ts +50 -0
  26. package/dist/exporters/matrix/export.d.ts.map +1 -0
  27. package/dist/exporters/matrix/export.js +152 -0
  28. package/dist/exporters/matrix/export.js.map +1 -0
  29. package/dist/exporters/matrix/fingerprint.d.ts +20 -0
  30. package/dist/exporters/matrix/fingerprint.d.ts.map +1 -0
  31. package/dist/exporters/matrix/fingerprint.js +83 -0
  32. package/dist/exporters/matrix/fingerprint.js.map +1 -0
  33. package/dist/exporters/matrix/gates.d.ts +21 -0
  34. package/dist/exporters/matrix/gates.d.ts.map +1 -0
  35. package/dist/exporters/matrix/gates.js +367 -0
  36. package/dist/exporters/matrix/gates.js.map +1 -0
  37. package/dist/exporters/matrix/map-loader.d.ts +22 -0
  38. package/dist/exporters/matrix/map-loader.d.ts.map +1 -0
  39. package/dist/exporters/matrix/map-loader.js +193 -0
  40. package/dist/exporters/matrix/map-loader.js.map +1 -0
  41. package/dist/exporters/matrix/render-csv.d.ts +9 -0
  42. package/dist/exporters/matrix/render-csv.d.ts.map +1 -0
  43. package/dist/exporters/matrix/render-csv.js +92 -0
  44. package/dist/exporters/matrix/render-csv.js.map +1 -0
  45. package/dist/exporters/matrix/render-xlsx.d.ts +41 -0
  46. package/dist/exporters/matrix/render-xlsx.d.ts.map +1 -0
  47. package/dist/exporters/matrix/render-xlsx.js +430 -0
  48. package/dist/exporters/matrix/render-xlsx.js.map +1 -0
  49. package/dist/exporters/matrix/types.d.ts +199 -0
  50. package/dist/exporters/matrix/types.d.ts.map +1 -0
  51. package/dist/exporters/matrix/types.js +15 -0
  52. package/dist/exporters/matrix/types.js.map +1 -0
  53. package/dist/exporters/matrix/wording.d.ts +61 -0
  54. package/dist/exporters/matrix/wording.d.ts.map +1 -0
  55. package/dist/exporters/matrix/wording.js +221 -0
  56. package/dist/exporters/matrix/wording.js.map +1 -0
  57. package/dist/exporters/scenario-merger.d.ts.map +1 -1
  58. package/dist/exporters/scenario-merger.js +2 -1
  59. package/dist/exporters/scenario-merger.js.map +1 -1
  60. package/dist/exporters/spec-parser.d.ts.map +1 -1
  61. package/dist/exporters/spec-parser.js +2 -1
  62. package/dist/exporters/spec-parser.js.map +1 -1
  63. package/dist/exporters/xlsx-report-builder.d.ts +1 -1
  64. package/dist/exporters/xlsx-report-builder.d.ts.map +1 -1
  65. package/dist/exporters/xlsx-report-builder.js +3 -3
  66. package/dist/exporters/xlsx-report-builder.js.map +1 -1
  67. package/dist/harness/audit.d.ts +10 -0
  68. package/dist/harness/audit.d.ts.map +1 -1
  69. package/dist/harness/audit.js +98 -16
  70. package/dist/harness/audit.js.map +1 -1
  71. package/dist/harness/blindspot.d.ts.map +1 -1
  72. package/dist/harness/blindspot.js +2 -1
  73. package/dist/harness/blindspot.js.map +1 -1
  74. package/dist/harness/capability-plan.d.ts +2 -0
  75. package/dist/harness/capability-plan.d.ts.map +1 -1
  76. package/dist/harness/capability-plan.js +17 -4
  77. package/dist/harness/capability-plan.js.map +1 -1
  78. package/dist/harness/feedback.d.ts.map +1 -1
  79. package/dist/harness/feedback.js +3 -2
  80. package/dist/harness/feedback.js.map +1 -1
  81. package/dist/harness/flow-check.d.ts.map +1 -1
  82. package/dist/harness/flow-check.js +2 -1
  83. package/dist/harness/flow-check.js.map +1 -1
  84. package/dist/harness/flow-plan.d.ts.map +1 -1
  85. package/dist/harness/flow-plan.js +3 -2
  86. package/dist/harness/flow-plan.js.map +1 -1
  87. package/dist/harness/intent.d.ts.map +1 -1
  88. package/dist/harness/intent.js +2 -1
  89. package/dist/harness/intent.js.map +1 -1
  90. package/dist/harness/journey.d.ts.map +1 -1
  91. package/dist/harness/journey.js +3 -2
  92. package/dist/harness/journey.js.map +1 -1
  93. package/dist/harness/ledger.d.ts.map +1 -1
  94. package/dist/harness/ledger.js +3 -2
  95. package/dist/harness/ledger.js.map +1 -1
  96. package/dist/harness/manifest.d.ts.map +1 -1
  97. package/dist/harness/manifest.js +4 -3
  98. package/dist/harness/manifest.js.map +1 -1
  99. package/dist/harness/parse.d.ts.map +1 -1
  100. package/dist/harness/parse.js +16 -3
  101. package/dist/harness/parse.js.map +1 -1
  102. package/dist/harness/quality-gates.d.ts.map +1 -1
  103. package/dist/harness/quality-gates.js +2 -1
  104. package/dist/harness/quality-gates.js.map +1 -1
  105. package/dist/harness/read-text.d.ts +22 -0
  106. package/dist/harness/read-text.d.ts.map +1 -0
  107. package/dist/harness/read-text.js +64 -0
  108. package/dist/harness/read-text.js.map +1 -0
  109. package/dist/harness/script-check.d.ts.map +1 -1
  110. package/dist/harness/script-check.js +3 -2
  111. package/dist/harness/script-check.js.map +1 -1
  112. package/dist/harness/sensors.d.ts +13 -1
  113. package/dist/harness/sensors.d.ts.map +1 -1
  114. package/dist/harness/sensors.js +63 -20
  115. package/dist/harness/sensors.js.map +1 -1
  116. package/dist/harness/spec-coverage.d.ts +5 -0
  117. package/dist/harness/spec-coverage.d.ts.map +1 -1
  118. package/dist/harness/spec-coverage.js +17 -7
  119. package/dist/harness/spec-coverage.js.map +1 -1
  120. package/dist/harness/trace.d.ts.map +1 -1
  121. package/dist/harness/trace.js +4 -3
  122. package/dist/harness/trace.js.map +1 -1
  123. package/dist/harness/viewpoint-baseline.d.ts +49 -0
  124. package/dist/harness/viewpoint-baseline.d.ts.map +1 -0
  125. package/dist/harness/viewpoint-baseline.js +141 -0
  126. package/dist/harness/viewpoint-baseline.js.map +1 -0
  127. package/dist/harness/viewpoint-ledger.d.ts.map +1 -1
  128. package/dist/harness/viewpoint-ledger.js +2 -1
  129. package/dist/harness/viewpoint-ledger.js.map +1 -1
  130. package/dist/orchestrator/assets-drift.d.ts +24 -0
  131. package/dist/orchestrator/assets-drift.d.ts.map +1 -0
  132. package/dist/orchestrator/assets-drift.js +80 -0
  133. package/dist/orchestrator/assets-drift.js.map +1 -0
  134. package/dist/orchestrator/templates/ai-src/commands/create-test.md +24 -0
  135. package/dist/orchestrator/templates/ai-src/commands/delivery.md +203 -120
  136. package/dist/orchestrator/templates/ai-src/config/claude.md +1 -1
  137. package/dist/orchestrator/templates/ai-src/config/copilot.md +1 -1
  138. package/dist/orchestrator/templates/ai-src/skills/sungen-delivery/SKILL.md +102 -6
  139. package/dist/orchestrator/templates/ai-src/skills/sungen-gherkin-syntax/SKILL.md +1 -0
  140. package/dist/orchestrator/templates/ai-src/skills/sungen-tc-generation/SKILL.md +23 -0
  141. package/package.json +3 -3
  142. package/src/cli/commands/audit.ts +23 -1
  143. package/src/cli/commands/delivery.ts +240 -18
  144. package/src/cli/index.ts +6 -0
  145. package/src/dashboard/snapshot-builder.ts +8 -1
  146. package/src/dashboard/templates/index.html +1 -1
  147. package/src/exporters/api-environment.ts +97 -0
  148. package/src/exporters/feature-parser.ts +21 -2
  149. package/src/exporters/matrix/build.ts +551 -0
  150. package/src/exporters/matrix/export.ts +149 -0
  151. package/src/exporters/matrix/fingerprint.ts +49 -0
  152. package/src/exporters/matrix/gates.ts +400 -0
  153. package/src/exporters/matrix/map-loader.ts +163 -0
  154. package/src/exporters/matrix/render-csv.ts +94 -0
  155. package/src/exporters/matrix/render-xlsx.ts +420 -0
  156. package/src/exporters/matrix/types.ts +226 -0
  157. package/src/exporters/matrix/wording.ts +221 -0
  158. package/src/exporters/scenario-merger.ts +2 -1
  159. package/src/exporters/spec-parser.ts +2 -1
  160. package/src/exporters/xlsx-report-builder.ts +3 -2
  161. package/src/harness/audit.ts +104 -18
  162. package/src/harness/blindspot.ts +2 -1
  163. package/src/harness/capability-plan.ts +17 -4
  164. package/src/harness/feedback.ts +3 -2
  165. package/src/harness/flow-check.ts +2 -1
  166. package/src/harness/flow-plan.ts +3 -2
  167. package/src/harness/intent.ts +2 -1
  168. package/src/harness/journey.ts +3 -2
  169. package/src/harness/ledger.ts +3 -2
  170. package/src/harness/manifest.ts +4 -3
  171. package/src/harness/parse.ts +17 -3
  172. package/src/harness/quality-gates.ts +2 -1
  173. package/src/harness/read-text.ts +28 -0
  174. package/src/harness/script-check.ts +3 -2
  175. package/src/harness/sensors.ts +55 -8
  176. package/src/harness/spec-coverage.ts +22 -7
  177. package/src/harness/trace.ts +4 -3
  178. package/src/harness/viewpoint-baseline.ts +128 -0
  179. package/src/harness/viewpoint-ledger.ts +2 -1
  180. package/src/orchestrator/assets-drift.ts +64 -0
  181. package/src/orchestrator/templates/ai-src/commands/create-test.md +24 -0
  182. package/src/orchestrator/templates/ai-src/commands/delivery.md +203 -120
  183. package/src/orchestrator/templates/ai-src/config/claude.md +1 -1
  184. package/src/orchestrator/templates/ai-src/config/copilot.md +1 -1
  185. package/src/orchestrator/templates/ai-src/skills/sungen-delivery/SKILL.md +102 -6
  186. package/src/orchestrator/templates/ai-src/skills/sungen-gherkin-syntax/SKILL.md +1 -0
  187. package/src/orchestrator/templates/ai-src/skills/sungen-tc-generation/SKILL.md +23 -0
@@ -0,0 +1,367 @@
1
+ "use strict";
2
+ /**
3
+ * Deterministic quality gates for the Test Case & Coverage Matrix
4
+ * (docs/spec/delivery-coverage-matrix-spec.md §6).
5
+ *
6
+ * Severity behavior:
7
+ * error → blocks any render
8
+ * review → blocks the official render; `--preview` renders with a DRAFT watermark
9
+ * warning → prints + renders
10
+ *
11
+ * The gates recompute every signature part from the .feature — the map is never
12
+ * trusted for derivable facts, only for the semantic fields (target/intent/oracle).
13
+ */
14
+ Object.defineProperty(exports, "__esModule", { value: true });
15
+ exports.runGates = runGates;
16
+ const feature_parser_1 = require("../feature-parser");
17
+ const fingerprint_1 = require("./fingerprint");
18
+ const types_1 = require("./types");
19
+ const build_1 = require("./build");
20
+ function runGates(ctx) {
21
+ const findings = [];
22
+ gateASource(ctx, findings);
23
+ gateBMapping(ctx, findings);
24
+ gateCAggregation(ctx, findings);
25
+ gateDExecutability(ctx, findings);
26
+ gateEDrift(ctx, findings);
27
+ gateGReviewState(ctx, findings);
28
+ gateWWording(ctx, findings);
29
+ gateKCategory(ctx, findings);
30
+ return findings;
31
+ }
32
+ // --- Gate K — category vs the source viewpoint class -------------------------
33
+ /**
34
+ * Viewpoint classes whose delivery category is not a judgement call — the source
35
+ * decides it. Matched on the id's category segment, so a project scheme without
36
+ * the `VP-` prefix (`SEC-123`, `PER-345`) classifies the same as `VP-SEC-001`.
37
+ */
38
+ const VP_CATEGORY_RULE = [
39
+ [/^(SEC|SECURITY)$/i, 'security', 'SEC'],
40
+ [/^(NFR|PERF|PER|PERFORMANCE|A11Y|ACCESSIBILITY)$/i, 'nfr', 'NFR/PERF/A11Y'],
41
+ ];
42
+ /**
43
+ * A `VP-SEC-*` scenario filed under `normal`/`abnormal` empties the Coverage
44
+ * sheet's `security` column — the grid then reports a gap the unit does not
45
+ * have while hiding the security work it does have. Same for `VP-NFR-*`.
46
+ * (normal vs abnormal stays a judgement call and is never checked.)
47
+ */
48
+ function gateKCategory(ctx, findings) {
49
+ for (const g of ctx.inputs.map.groups) {
50
+ const vs = g.variants.flatMap((ref) => (0, build_1.expandMapRef)(ref, ctx.variantsByVp));
51
+ for (const [re, expected, label] of VP_CATEGORY_RULE) {
52
+ const hits = vs.filter((v) => re.test(v.vpCategory));
53
+ if (hits.length > 0 && g.category !== expected) {
54
+ findings.push({
55
+ gate: 'K', severity: 'warning', ref: g.id,
56
+ message: `group ${g.id} is \`category: ${g.category}\` but ${hits.length}/${vs.length} of its variants are ${label} scenarios (${hits.slice(0, 3).map((v) => v.vpId).join(', ')}) — use \`category: ${expected}\` or the Coverage grid's ${expected} column stays empty`,
57
+ });
58
+ }
59
+ }
60
+ }
61
+ }
62
+ // --- Gate A — source quality ------------------------------------------------
63
+ function gateASource(ctx, findings) {
64
+ const { feature, merged } = ctx.inputs;
65
+ if (feature.backgroundWhenSteps.length > 0 || feature.backgroundThenSteps.length > 0) {
66
+ findings.push({
67
+ gate: 'A', severity: 'error',
68
+ message: 'Background contains When/Then steps — setup only; move the action/oracle into scenarios',
69
+ });
70
+ }
71
+ const seen = new Map();
72
+ for (const m of merged) {
73
+ const { vpId } = (0, feature_parser_1.splitVpAndName)(m.feature.name);
74
+ if (!vpId) {
75
+ findings.push({
76
+ gate: 'A', severity: 'error', ref: m.feature.name,
77
+ message: `scenario "${m.feature.name}" has no VP-id prefix — matrix variants must be addressable`,
78
+ });
79
+ continue;
80
+ }
81
+ seen.set(vpId, (seen.get(vpId) ?? 0) + 1);
82
+ const isManual = (0, feature_parser_1.extractTestcaseType)(m.feature.tags) === 'Manual';
83
+ if (m.resolvedExpected.length === 0) {
84
+ findings.push({
85
+ gate: 'A', severity: 'error', ref: vpId,
86
+ message: isManual
87
+ ? `manual scenario ${vpId} has no observable oracle (no Then steps and no Observable/Oracle comment lines)`
88
+ : `scenario ${vpId} has no Then step — a variant without an observable oracle cannot be delivered`,
89
+ });
90
+ }
91
+ }
92
+ for (const [vpId, n] of seen) {
93
+ if (n > 1)
94
+ findings.push({ gate: 'A', severity: 'error', ref: vpId, message: `duplicate VP-id ${vpId} (${n} scenarios)` });
95
+ }
96
+ }
97
+ // --- Gate B — mapping completeness -------------------------------------------
98
+ function gateBMapping(ctx, findings) {
99
+ const { map } = ctx.inputs;
100
+ const { variants, variantsByVp } = ctx;
101
+ // Where each derived variant landed: 0 → unmapped, >1 → double-mapped.
102
+ const owners = new Map();
103
+ for (const g of map.groups) {
104
+ for (const ref of g.variants) {
105
+ const expanded = (0, build_1.expandMapRef)(ref, variantsByVp);
106
+ if (expanded.length === 0) {
107
+ findings.push({
108
+ gate: 'B', severity: 'error', ref: g.id,
109
+ message: `group ${g.id} references ${ref} which matches no scenario/@cases row in the .feature`,
110
+ });
111
+ continue;
112
+ }
113
+ for (const v of expanded) {
114
+ const list = owners.get(v.ref) ?? [];
115
+ list.push(g.id);
116
+ owners.set(v.ref, list);
117
+ }
118
+ }
119
+ }
120
+ for (const [ref, groups] of owners) {
121
+ if (groups.length > 1) {
122
+ findings.push({
123
+ gate: 'B', severity: 'error', ref,
124
+ message: `variant ${ref} belongs to ${groups.length} groups (${groups.join(', ')}) — exactly one required`,
125
+ });
126
+ }
127
+ }
128
+ for (const v of variants) {
129
+ const grouped = owners.has(v.ref);
130
+ const disposed = v.vpId in map.dispositions;
131
+ if (!grouped && !disposed) {
132
+ findings.push({
133
+ gate: 'B', severity: 'error', ref: v.ref,
134
+ message: `variant ${v.ref} is in no group and has no disposition — 100% source disposition is required`,
135
+ });
136
+ }
137
+ if (grouped && disposed) {
138
+ findings.push({
139
+ gate: 'B', severity: 'error', ref: v.ref,
140
+ message: `variant ${v.ref} is grouped AND disposed (${map.dispositions[v.vpId].as}) — pick one`,
141
+ });
142
+ }
143
+ }
144
+ for (const vpId of Object.keys(map.dispositions)) {
145
+ if (!variantsByVp.has(vpId)) {
146
+ findings.push({
147
+ gate: 'B', severity: 'warning', ref: vpId,
148
+ message: `disposition for ${vpId} matches no scenario (stale entry?)`,
149
+ });
150
+ }
151
+ }
152
+ }
153
+ // --- Gate C — aggregation safety ---------------------------------------------
154
+ function gateCAggregation(ctx, findings) {
155
+ const { map } = ctx.inputs;
156
+ const { variantsByVp } = ctx;
157
+ for (const g of map.groups) {
158
+ const vs = g.variants.flatMap((ref) => (0, build_1.expandMapRef)(ref, variantsByVp));
159
+ if (vs.length <= 1)
160
+ continue;
161
+ // Approval IS the QA confirmation of the heuristic parts (oracle family,
162
+ // precondition equivalence, sequence safety) — once approved AND unchanged
163
+ // (fingerprints intact), only the hard signature checks keep firing. A
164
+ // drifted variant re-opens the heuristics (Gate E flips the item to
165
+ // proposed at the same time).
166
+ const stale = vs.some((v) => {
167
+ const stamped = map.fingerprints[v.ref] ?? map.fingerprints[v.vpId];
168
+ return !stamped || stamped !== v.fingerprint;
169
+ });
170
+ const heuristicsConfirmed = g.review === 'approved' && !stale;
171
+ // Hard signature parts — recomputed, never trusted from the map. ERROR on mismatch.
172
+ // Execution mode and priority are deliberately NOT here: they are coverage
173
+ // dimensions (account states may need seeded manual variants next to auto ones;
174
+ // an item takes the highest variant priority) — shown per variant, never split on.
175
+ const hard = [
176
+ ['test layer', (v) => [...v.layers].sort().join('+')],
177
+ ];
178
+ for (const [label, keyOf] of hard) {
179
+ const distinct = new Set(vs.map(keyOf));
180
+ if (distinct.size > 1) {
181
+ findings.push({
182
+ gate: 'C', severity: 'error', ref: g.id,
183
+ message: `group ${g.id} mixes ${label}s (${[...distinct].join(' vs ')}) — mandatory split`,
184
+ });
185
+ }
186
+ }
187
+ // Heuristic signature parts — REVIEW_REQUIRED (equivalence was inferred, not declared).
188
+ const preProfiles = new Set(vs.map((v) => v.preconditionProfile));
189
+ if (!heuristicsConfirmed && preProfiles.size > 1) {
190
+ findings.push({
191
+ gate: 'C', severity: 'review', ref: g.id,
192
+ message: `group ${g.id} variants have different precondition profiles — confirm the grouping is safe or split`,
193
+ });
194
+ }
195
+ const oracleShapes = new Set(vs.map((v) => v.oracleShape.join(' ; ')));
196
+ if (!heuristicsConfirmed && oracleShapes.size > 1) {
197
+ findings.push({
198
+ gate: 'C', severity: 'review', ref: g.id,
199
+ message: `group ${g.id} variants assert different oracle shapes (${oracleShapes.size} shapes) — confirm they are one oracle family`,
200
+ });
201
+ }
202
+ if (!heuristicsConfirmed && vs.some((v) => v.procedureProfile === 'sequence')) {
203
+ findings.push({
204
+ gate: 'C', severity: 'review', ref: g.id,
205
+ message: `group ${g.id} contains a sequence-sensitive scenario — ordered flows stay solo items unless QA confirms`,
206
+ });
207
+ }
208
+ if (vs.length > types_1.MAX_VARIANTS_PER_ITEM) {
209
+ findings.push({
210
+ gate: 'C', severity: 'warning', ref: g.id,
211
+ message: `group ${g.id} has ${vs.length} variants (> ${types_1.MAX_VARIANTS_PER_ITEM}) — consider splitting for reviewability`,
212
+ });
213
+ }
214
+ }
215
+ }
216
+ // --- Gate D — manual executability -------------------------------------------
217
+ function gateDExecutability(ctx, findings) {
218
+ const { map, testData, feature } = ctx.inputs;
219
+ const { variantsByVp } = ctx;
220
+ for (const g of map.groups) {
221
+ const vs = g.variants.flatMap((ref) => (0, build_1.expandMapRef)(ref, variantsByVp));
222
+ for (const v of vs) {
223
+ const hasPrecondition = v.precondition.length > 0 || feature.backgroundGivenSteps.length > 0;
224
+ if (!hasPrecondition) {
225
+ findings.push({
226
+ gate: 'D', severity: 'error', ref: v.ref,
227
+ message: `${v.ref}: no precondition (no Background, auth tag, or Given) — a tester cannot establish the start state`,
228
+ });
229
+ }
230
+ if (v.trigger.length === 0) {
231
+ findings.push({
232
+ gate: 'D', severity: 'error', ref: v.ref,
233
+ message: `${v.ref}: no action/trigger (no When steps${v.mode === 'manual' ? ' and no Setup/Action comment lines' : ''})`,
234
+ });
235
+ }
236
+ // Oracle emptiness is Gate A (source) — not repeated here.
237
+ }
238
+ }
239
+ // Every {{var}} must resolve — data the tester cannot obtain is not executable.
240
+ for (const [vpId, vs] of variantsByVp) {
241
+ const scenario = ctx.inputs.merged.find((m) => (0, feature_parser_1.splitVpAndName)(m.feature.name).vpId === vpId);
242
+ if (!scenario)
243
+ continue;
244
+ // Values produced during the run (`remember … as {{v}}`, capability bindings)
245
+ // are provided by the test itself — demanding a test-data entry for them
246
+ // blocked 14 scenarios of a real suite that compiles and runs fine.
247
+ const runtime = new Set(vs.flatMap((v) => v.runtimeVars));
248
+ for (const varName of scenario.feature.referencedVars) {
249
+ const inRows = vs.some((v) => v.caseLabel !== undefined); // dataset rows carry their own columns
250
+ const atRuntime = runtime.has(varName) || runtime.has(varName.split(/[.[]/)[0]);
251
+ if (!inRows && !atRuntime && (!testData || !(varName in testData))) {
252
+ findings.push({
253
+ gate: 'D', severity: 'error', ref: vpId,
254
+ message: `${vpId}: {{${varName}}} does not resolve in test-data — the variant is not reproducible`,
255
+ });
256
+ }
257
+ }
258
+ }
259
+ // No template token may survive into a RENDERED cell (review B-04) — this also
260
+ // catches cross-referencing test-data values the one-level resolver couldn't close.
261
+ for (const [, vs] of variantsByVp) {
262
+ for (const v of vs) {
263
+ const rendered = [...v.precondition, ...v.trigger, ...v.oracle, ...v.verification, ...v.data];
264
+ const token = rendered.map((t) => t.match(/\{\{[^}]*\}\}/)).find(Boolean);
265
+ if (token) {
266
+ findings.push({
267
+ gate: 'D', severity: 'error', ref: v.ref,
268
+ message: `${v.ref}: unresolved template token ${token[0]} remains in the rendered output — the export is not deterministic for a tester`,
269
+ });
270
+ }
271
+ }
272
+ }
273
+ }
274
+ // --- Gate E — drift (stale approval) ------------------------------------------
275
+ function gateEDrift(ctx, findings) {
276
+ const { map } = ctx.inputs;
277
+ const { variantsByVp } = ctx;
278
+ // The map's own semantics (targets/intents/oracles/grouping) are part of what
279
+ // was approved — an edit after approval must be re-reviewed, not silently
280
+ // published (review GAP-09).
281
+ const stampedMap = map.fingerprints.__map__;
282
+ const liveMap = (0, fingerprint_1.mapContentFingerprint)(map.groups, map.dispositions);
283
+ if (map.groups.some((g) => g.review === 'approved')) {
284
+ if (!stampedMap) {
285
+ findings.push({
286
+ gate: 'E', severity: 'review',
287
+ message: 'the delivery map has no stamped content fingerprint — run `sungen delivery --approve` to record the reviewed wording',
288
+ });
289
+ }
290
+ else if (stampedMap !== liveMap) {
291
+ findings.push({
292
+ gate: 'E', severity: 'review',
293
+ message: 'the delivery map wording/grouping changed since approval — re-review, then `sungen delivery --approve`',
294
+ });
295
+ }
296
+ }
297
+ for (const g of map.groups) {
298
+ if (g.review !== 'approved')
299
+ continue; // proposed groups are already under review
300
+ for (const ref of g.variants) {
301
+ const vs = (0, build_1.expandMapRef)(ref, variantsByVp);
302
+ for (const v of vs) {
303
+ const stamped = map.fingerprints[v.ref] ?? map.fingerprints[v.vpId];
304
+ if (!stamped) {
305
+ findings.push({
306
+ gate: 'E', severity: 'review', ref: g.id,
307
+ message: `group ${g.id}: ${v.ref} has no stamped fingerprint — run \`sungen delivery --approve\` after review`,
308
+ });
309
+ }
310
+ else if (stamped !== v.fingerprint) {
311
+ findings.push({
312
+ gate: 'E', severity: 'review', ref: g.id,
313
+ message: `group ${g.id}: ${v.ref} changed since approval (fingerprint drift) — re-review the grouping`,
314
+ });
315
+ }
316
+ }
317
+ }
318
+ }
319
+ }
320
+ // --- Gate W — controlled-language lint on the map's semantic fields --------------
321
+ /** Patterns that make customer-facing wording read machine-generated (review §10). */
322
+ const WORDING_SMELLS = [
323
+ [/\{\{[^}]*\}\}/, 'an unresolved {{token}}'],
324
+ [/\b(?:Setup|Observable|Oracle):/, 'a generator label (Setup:/Observable:/Oracle:)'],
325
+ [/\bUser (?:fill|click|press|see|wait)\b/i, 'DSL phrasing ("User fill/click/see…") — write plain product language'],
326
+ [/\[[^\]]+\]/, 'a [selector-style] reference — use the visible UI label'],
327
+ ];
328
+ function gateWWording(ctx, findings) {
329
+ for (const g of ctx.inputs.map.groups) {
330
+ const variantCount = g.variants.flatMap((ref) => (0, build_1.expandMapRef)(ref, ctx.variantsByVp)).length;
331
+ // Without a digest the parent row can only list variant refs — a reviewer
332
+ // then has to expand the item to learn which dimensions it covers.
333
+ if (variantCount > 3 && !g.dimensions) {
334
+ findings.push({
335
+ gate: 'W', severity: 'warning', ref: g.id,
336
+ message: `group ${g.id} has ${variantCount} variants and no \`dimensions:\` digest — add a short one (e.g. "required ×3 · format ×9") so the collapsed view stays informative`,
337
+ });
338
+ }
339
+ if (g.dimensions && g.dimensions.length > 120) {
340
+ findings.push({
341
+ gate: 'W', severity: 'warning', ref: g.id,
342
+ message: `group ${g.id} \`dimensions:\` is ${g.dimensions.length} chars — keep the digest short (≤120)`,
343
+ });
344
+ }
345
+ for (const [field, text] of [['intent', g.intent], ['oracle', g.oracle], ...(g.dimensions ? [['dimensions', g.dimensions]] : [])]) {
346
+ for (const [re, what] of WORDING_SMELLS) {
347
+ if (re.test(text)) {
348
+ findings.push({
349
+ gate: 'W', severity: 'warning', ref: g.id,
350
+ message: `group ${g.id} ${field} contains ${what}`,
351
+ });
352
+ }
353
+ }
354
+ }
355
+ }
356
+ }
357
+ // --- Gate G — review state -----------------------------------------------------
358
+ function gateGReviewState(ctx, findings) {
359
+ const proposed = ctx.inputs.map.groups.filter((g) => g.review !== 'approved');
360
+ if (proposed.length > 0) {
361
+ findings.push({
362
+ gate: 'G', severity: 'review',
363
+ message: `${proposed.length} group(s) still \`proposed\` (${proposed.slice(0, 5).map((g) => g.id).join(', ')}${proposed.length > 5 ? ', …' : ''}) — approve them or render with --preview`,
364
+ });
365
+ }
366
+ }
367
+ //# sourceMappingURL=gates.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"gates.js","sourceRoot":"","sources":["../../../src/exporters/matrix/gates.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;GAWG;;AAaH,4BAWC;AAtBD,sDAAwE;AACxE,+CAAsD;AACtD,mCAAgF;AAChF,mCAAoD;AAQpD,SAAgB,QAAQ,CAAC,GAAgB;IACvC,MAAM,QAAQ,GAAoB,EAAE,CAAC;IACrC,WAAW,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC3B,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5B,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAChC,kBAAkB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAClC,UAAU,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1B,gBAAgB,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAChC,YAAY,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC5B,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC7B,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,gFAAgF;AAEhF;;;;GAIG;AACH,MAAM,gBAAgB,GAAoC;IACxD,CAAC,mBAAmB,EAAE,UAAU,EAAE,KAAK,CAAC;IACxC,CAAC,kDAAkD,EAAE,KAAK,EAAE,eAAe,CAAC;CAC7E,CAAC;AAEF;;;;;GAKG;AACH,SAAS,aAAa,CAAC,GAAgB,EAAE,QAAyB;IAChE,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,oBAAY,EAAC,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC;QAC5E,KAAK,MAAM,CAAC,EAAE,EAAE,QAAQ,EAAE,KAAK,CAAC,IAAI,gBAAgB,EAAE,CAAC;YACrD,MAAM,IAAI,GAAG,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;YACrD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;gBAC/C,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;oBACzC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,mBAAmB,CAAC,CAAC,QAAQ,UAAU,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,MAAM,wBAAwB,KAAK,eAAe,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,uBAAuB,QAAQ,6BAA6B,QAAQ,qBAAqB;iBACzQ,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,+EAA+E;AAE/E,SAAS,WAAW,CAAC,GAAgB,EAAE,QAAyB;IAC9D,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IAEvC,IAAI,OAAO,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrF,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO;YAC5B,OAAO,EAAE,yFAAyF;SACnG,CAAC,CAAC;IACL,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,GAAG,EAAkB,CAAC;IACvC,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACvB,MAAM,EAAE,IAAI,EAAE,GAAG,IAAA,+BAAc,EAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,OAAO,CAAC,IAAI;gBACjD,OAAO,EAAE,aAAa,CAAC,CAAC,OAAO,CAAC,IAAI,6DAA6D;aAClG,CAAC,CAAC;YACH,SAAS;QACX,CAAC;QACD,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;QAE1C,MAAM,QAAQ,GAAG,IAAA,oCAAmB,EAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,QAAQ,CAAC;QAClE,IAAI,CAAC,CAAC,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACpC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI;gBACvC,OAAO,EAAE,QAAQ;oBACf,CAAC,CAAC,mBAAmB,IAAI,kFAAkF;oBAC3G,CAAC,CAAC,YAAY,IAAI,gFAAgF;aACrG,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC;QAC7B,IAAI,CAAC,GAAG,CAAC;YAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,EAAE,mBAAmB,IAAI,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC;IAC7H,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF,SAAS,YAAY,CAAC,GAAgB,EAAE,QAAyB;IAC/D,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC;IAEvC,uEAAuE;IACvE,MAAM,MAAM,GAAG,IAAI,GAAG,EAAoB,CAAC;IAC3C,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC3B,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7B,MAAM,QAAQ,GAAG,IAAA,oBAAY,EAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YACjD,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC1B,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;oBACvC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,eAAe,GAAG,uDAAuD;iBAChG,CAAC,CAAC;gBACH,SAAS;YACX,CAAC;YACD,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;gBACzB,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBACrC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBAChB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;YAC1B,CAAC;QACH,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACnC,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACtB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG;gBACjC,OAAO,EAAE,WAAW,GAAG,eAAe,MAAM,CAAC,MAAM,YAAY,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,0BAA0B;aAC3G,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,YAAY,CAAC;QAC5C,IAAI,CAAC,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC;YAC1B,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG;gBACxC,OAAO,EAAE,WAAW,CAAC,CAAC,GAAG,8EAA8E;aACxG,CAAC,CAAC;QACL,CAAC;QACD,IAAI,OAAO,IAAI,QAAQ,EAAE,CAAC;YACxB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG;gBACxC,OAAO,EAAE,WAAW,CAAC,CAAC,GAAG,6BAA6B,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,cAAc;aAChG,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACjD,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;YAC5B,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,IAAI;gBACzC,OAAO,EAAE,mBAAmB,IAAI,qCAAqC;aACtE,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF,SAAS,gBAAgB,CAAC,GAAgB,EAAE,QAAyB;IACnE,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC;IAE7B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,oBAAY,EAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;QACxE,IAAI,EAAE,CAAC,MAAM,IAAI,CAAC;YAAE,SAAS;QAE7B,yEAAyE;QACzE,2EAA2E;QAC3E,uEAAuE;QACvE,oEAAoE;QACpE,8BAA8B;QAC9B,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE;YAC1B,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;YACpE,OAAO,CAAC,OAAO,IAAI,OAAO,KAAK,CAAC,CAAC,WAAW,CAAC;QAC/C,CAAC,CAAC,CAAC;QACH,MAAM,mBAAmB,GAAG,CAAC,CAAC,MAAM,KAAK,UAAU,IAAI,CAAC,KAAK,CAAC;QAE9D,oFAAoF;QACpF,2EAA2E;QAC3E,gFAAgF;QAChF,mFAAmF;QACnF,MAAM,IAAI,GAAoD;YAC5D,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;SACtD,CAAC;QACF,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,EAAE,CAAC;YAClC,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;YACxC,IAAI,QAAQ,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;gBACtB,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;oBACvC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,UAAU,KAAK,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,qBAAqB;iBAC3F,CAAC,CAAC;YACL,CAAC;QACH,CAAC;QAED,wFAAwF;QACxF,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,mBAAmB,IAAI,WAAW,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YACjD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;gBACxC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,wFAAwF;aAC/G,CAAC,CAAC;QACL,CAAC;QACD,MAAM,YAAY,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;QACvE,IAAI,CAAC,mBAAmB,IAAI,YAAY,CAAC,IAAI,GAAG,CAAC,EAAE,CAAC;YAClD,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;gBACxC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,6CAA6C,YAAY,CAAC,IAAI,+CAA+C;aACpI,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,mBAAmB,IAAI,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,gBAAgB,KAAK,UAAU,CAAC,EAAE,CAAC;YAC9E,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;gBACxC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,4FAA4F;aACnH,CAAC,CAAC;QACL,CAAC;QAED,IAAI,EAAE,CAAC,MAAM,GAAG,6BAAqB,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;gBACzC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,MAAM,gBAAgB,6BAAqB,0CAA0C;aACvH,CAAC,CAAC;QACL,CAAC;IACH,CAAC;AACH,CAAC;AAED,gFAAgF;AAEhF,SAAS,kBAAkB,CAAC,GAAgB,EAAE,QAAyB;IACrE,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IAC9C,MAAM,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC;IAE7B,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC3B,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,oBAAY,EAAC,GAAG,EAAE,YAAY,CAAC,CAAC,CAAC;QACxE,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,MAAM,eAAe,GAAG,CAAC,CAAC,YAAY,CAAC,MAAM,GAAG,CAAC,IAAI,OAAO,CAAC,oBAAoB,CAAC,MAAM,GAAG,CAAC,CAAC;YAC7F,IAAI,CAAC,eAAe,EAAE,CAAC;gBACrB,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG;oBACxC,OAAO,EAAE,GAAG,CAAC,CAAC,GAAG,mGAAmG;iBACrH,CAAC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBAC3B,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG;oBACxC,OAAO,EAAE,GAAG,CAAC,CAAC,GAAG,qCAAqC,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,oCAAoC,CAAC,CAAC,CAAC,EAAE,GAAG;iBACzH,CAAC,CAAC;YACL,CAAC;YACD,2DAA2D;QAC7D,CAAC;IACH,CAAC;IAED,gFAAgF;IAChF,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC;QACtC,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAA,+BAAc,EAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAC7F,IAAI,CAAC,QAAQ;YAAE,SAAS;QACxB,8EAA8E;QAC9E,yEAAyE;QACzE,oEAAoE;QACpE,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;QAC1D,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,OAAO,CAAC,cAAc,EAAE,CAAC;YACtD,MAAM,MAAM,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC,CAAC,uCAAuC;YACjG,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,IAAI,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YAChF,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,OAAO,IAAI,QAAQ,CAAC,CAAC,EAAE,CAAC;gBACnE,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,IAAI;oBACvC,OAAO,EAAE,GAAG,IAAI,OAAO,OAAO,oEAAoE;iBACnG,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED,+EAA+E;IAC/E,oFAAoF;IACpF,KAAK,MAAM,CAAC,EAAE,EAAE,CAAC,IAAI,YAAY,EAAE,CAAC;QAClC,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;YACnB,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,YAAY,EAAE,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;YAC9F,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1E,IAAI,KAAK,EAAE,CAAC;gBACV,QAAQ,CAAC,IAAI,CAAC;oBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,EAAE,CAAC,CAAC,GAAG;oBACxC,OAAO,EAAE,GAAG,CAAC,CAAC,GAAG,+BAA+B,KAAK,CAAC,CAAC,CAAC,gFAAgF;iBACzI,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF,SAAS,UAAU,CAAC,GAAgB,EAAE,QAAyB;IAC7D,MAAM,EAAE,GAAG,EAAE,GAAG,GAAG,CAAC,MAAM,CAAC;IAC3B,MAAM,EAAE,YAAY,EAAE,GAAG,GAAG,CAAC;IAE7B,8EAA8E;IAC9E,0EAA0E;IAC1E,6BAA6B;IAC7B,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,OAAO,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAA,mCAAqB,EAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC;IACpE,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,EAAE,CAAC;QACpD,IAAI,CAAC,UAAU,EAAE,CAAC;YAChB,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ;gBAC7B,OAAO,EAAE,sHAAsH;aAChI,CAAC,CAAC;QACL,CAAC;aAAM,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;YAClC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ;gBAC7B,OAAO,EAAE,wGAAwG;aAClH,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC;QAC3B,IAAI,CAAC,CAAC,MAAM,KAAK,UAAU;YAAE,SAAS,CAAC,2CAA2C;QAClF,KAAK,MAAM,GAAG,IAAI,CAAC,CAAC,QAAQ,EAAE,CAAC;YAC7B,MAAM,EAAE,GAAG,IAAA,oBAAY,EAAC,GAAG,EAAE,YAAY,CAAC,CAAC;YAC3C,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBACnB,MAAM,OAAO,GAAG,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;gBACpE,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;wBACxC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,8EAA8E;qBAC/G,CAAC,CAAC;gBACL,CAAC;qBAAM,IAAI,OAAO,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;oBACrC,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;wBACxC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,GAAG,sEAAsE;qBACvG,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,oFAAoF;AAEpF,sFAAsF;AACtF,MAAM,cAAc,GAA4B;IAC9C,CAAC,eAAe,EAAE,yBAAyB,CAAC;IAC5C,CAAC,gCAAgC,EAAE,gDAAgD,CAAC;IACpF,CAAC,yCAAyC,EAAE,sEAAsE,CAAC;IACnH,CAAC,YAAY,EAAE,yDAAyD,CAAC;CAC1E,CAAC;AAEF,SAAS,YAAY,CAAC,GAAgB,EAAE,QAAyB;IAC/D,KAAK,MAAM,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;QACtC,MAAM,YAAY,GAAG,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAA,oBAAY,EAAC,GAAG,EAAE,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC;QAC7F,0EAA0E;QAC1E,mEAAmE;QACnE,IAAI,YAAY,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC;YACtC,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;gBACzC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,QAAQ,YAAY,oIAAoI;aAC/K,CAAC,CAAC;QACL,CAAC;QACD,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,UAAU,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC;gBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;gBACzC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,uBAAuB,CAAC,CAAC,UAAU,CAAC,MAAM,uCAAuC;aACxG,CAAC,CAAC;QACL,CAAC;QACD,KAAK,MAAM,CAAC,KAAK,EAAE,IAAI,CAAC,IAAK,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC,CAAC,UAAU,CAAU,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAW,EAAE,CAAC;YACtJ,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,cAAc,EAAE,CAAC;gBACxC,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;oBAClB,QAAQ,CAAC,IAAI,CAAC;wBACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE;wBACzC,OAAO,EAAE,SAAS,CAAC,CAAC,EAAE,IAAI,KAAK,aAAa,IAAI,EAAE;qBACnD,CAAC,CAAC;gBACL,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,kFAAkF;AAElF,SAAS,gBAAgB,CAAC,GAAgB,EAAE,QAAyB;IACnE,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;IAC9E,IAAI,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACxB,QAAQ,CAAC,IAAI,CAAC;YACZ,IAAI,EAAE,GAAG,EAAE,QAAQ,EAAE,QAAQ;YAC7B,OAAO,EAAE,GAAG,QAAQ,CAAC,MAAM,iCAAiC,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,2CAA2C;SAC3L,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}
@@ -0,0 +1,22 @@
1
+ /**
2
+ * Delivery Map loader — `qa/<kind>/<unit>/delivery/<unit>.map.yaml`.
3
+ *
4
+ * Structural validation only (shape, required fields, enum values, duplicate ids).
5
+ * Semantic validation against the .feature is the gates' job (gates.ts) — the loader
6
+ * never reads the feature.
7
+ */
8
+ import { DeliveryMap } from './types';
9
+ export interface MapLoadResult {
10
+ map: DeliveryMap | null;
11
+ /** Structural problems — any entry blocks the matrix path (fix the file first). */
12
+ errors: string[];
13
+ }
14
+ /** Path of the map file for a unit directory (qa/<kind>/<screen>) + feature basename. */
15
+ export declare function mapFilePath(unitDir: string, featureBaseName: string): string;
16
+ export declare function loadDeliveryMap(file: string): MapLoadResult;
17
+ /**
18
+ * Write the map back (used by `--approve` to flip review states + stamp fingerprints).
19
+ * Field order is kept stable so approve-diffs stay minimal and reviewable.
20
+ */
21
+ export declare function writeDeliveryMap(file: string, map: DeliveryMap): void;
22
+ //# sourceMappingURL=map-loader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"map-loader.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/map-loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,WAAW,EAA8F,MAAM,SAAS,CAAC;AAQlI,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACxB,mFAAmF;IACnF,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,yFAAyF;AACzF,wBAAgB,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,CAyG3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAqBrE"}
@@ -0,0 +1,193 @@
1
+ "use strict";
2
+ /**
3
+ * Delivery Map loader — `qa/<kind>/<unit>/delivery/<unit>.map.yaml`.
4
+ *
5
+ * Structural validation only (shape, required fields, enum values, duplicate ids).
6
+ * Semantic validation against the .feature is the gates' job (gates.ts) — the loader
7
+ * never reads the feature.
8
+ */
9
+ var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
10
+ if (k2 === undefined) k2 = k;
11
+ var desc = Object.getOwnPropertyDescriptor(m, k);
12
+ if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
13
+ desc = { enumerable: true, get: function() { return m[k]; } };
14
+ }
15
+ Object.defineProperty(o, k2, desc);
16
+ }) : (function(o, m, k, k2) {
17
+ if (k2 === undefined) k2 = k;
18
+ o[k2] = m[k];
19
+ }));
20
+ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
21
+ Object.defineProperty(o, "default", { enumerable: true, value: v });
22
+ }) : function(o, v) {
23
+ o["default"] = v;
24
+ });
25
+ var __importStar = (this && this.__importStar) || (function () {
26
+ var ownKeys = function(o) {
27
+ ownKeys = Object.getOwnPropertyNames || function (o) {
28
+ var ar = [];
29
+ for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
30
+ return ar;
31
+ };
32
+ return ownKeys(o);
33
+ };
34
+ return function (mod) {
35
+ if (mod && mod.__esModule) return mod;
36
+ var result = {};
37
+ if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
38
+ __setModuleDefault(result, mod);
39
+ return result;
40
+ };
41
+ })();
42
+ Object.defineProperty(exports, "__esModule", { value: true });
43
+ exports.mapFilePath = mapFilePath;
44
+ exports.loadDeliveryMap = loadDeliveryMap;
45
+ exports.writeDeliveryMap = writeDeliveryMap;
46
+ const fs = __importStar(require("fs"));
47
+ const path = __importStar(require("path"));
48
+ const yaml_1 = require("yaml");
49
+ const CATEGORIES = ['normal', 'abnormal', 'security', 'nfr'];
50
+ const REVIEW_STATES = ['proposed', 'approved'];
51
+ const DISPOSITIONS = ['excluded', 'blocked', 'covered_elsewhere', 'accepted_risk'];
52
+ const REQUIREMENT_STATUSES = ['covered', 'partially_covered', 'covered_elsewhere', 'planned', 'gap', 'not_applicable'];
53
+ /** Path of the map file for a unit directory (qa/<kind>/<screen>) + feature basename. */
54
+ function mapFilePath(unitDir, featureBaseName) {
55
+ return path.join(unitDir, 'delivery', `${featureBaseName}.map.yaml`);
56
+ }
57
+ function loadDeliveryMap(file) {
58
+ if (!fs.existsSync(file))
59
+ return { map: null, errors: [] };
60
+ const errors = [];
61
+ let raw;
62
+ try {
63
+ raw = (0, yaml_1.parse)(fs.readFileSync(file, 'utf-8'));
64
+ }
65
+ catch (e) {
66
+ return { map: null, errors: [`map YAML does not parse: ${e instanceof Error ? e.message : e}`] };
67
+ }
68
+ if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
69
+ return { map: null, errors: ['map root must be a YAML mapping'] };
70
+ }
71
+ const doc = raw;
72
+ const groups = [];
73
+ const seenIds = new Set();
74
+ const rawGroups = doc.groups;
75
+ if (!Array.isArray(rawGroups) || rawGroups.length === 0) {
76
+ errors.push('map has no `groups` list');
77
+ }
78
+ else {
79
+ rawGroups.forEach((g, i) => {
80
+ if (!g || typeof g !== 'object') {
81
+ errors.push(`groups[${i}] is not a mapping`);
82
+ return;
83
+ }
84
+ const grp = g;
85
+ const where = `groups[${i}]${typeof grp.id === 'string' ? ` (${grp.id})` : ''}`;
86
+ for (const field of ['id', 'target', 'intent', 'oracle']) {
87
+ if (typeof grp[field] !== 'string' || !grp[field].trim()) {
88
+ errors.push(`${where}: missing/empty \`${field}\``);
89
+ }
90
+ }
91
+ if (!CATEGORIES.includes(grp.category)) {
92
+ errors.push(`${where}: \`category\` must be one of ${CATEGORIES.join(' | ')}`);
93
+ }
94
+ const review = (grp.review ?? 'proposed');
95
+ if (!REVIEW_STATES.includes(review)) {
96
+ errors.push(`${where}: \`review\` must be proposed | approved`);
97
+ }
98
+ const variants = grp.variants;
99
+ if (!Array.isArray(variants) || variants.length === 0 || variants.some((v) => typeof v !== 'string' || !v.trim())) {
100
+ errors.push(`${where}: \`variants\` must be a non-empty list of VP refs`);
101
+ }
102
+ const id = String(grp.id ?? '');
103
+ if (id) {
104
+ if (seenIds.has(id))
105
+ errors.push(`duplicate group id \`${id}\``);
106
+ seenIds.add(id);
107
+ }
108
+ groups.push({
109
+ id,
110
+ target: String(grp.target ?? ''),
111
+ intent: String(grp.intent ?? ''),
112
+ oracle: String(grp.oracle ?? ''),
113
+ ...(grp.dimensions !== undefined ? { dimensions: String(grp.dimensions) } : {}),
114
+ category: grp.category,
115
+ review,
116
+ variants: Array.isArray(variants) ? variants.map(String) : [],
117
+ });
118
+ });
119
+ }
120
+ const dispositions = {};
121
+ if (doc.dispositions !== undefined) {
122
+ if (!doc.dispositions || typeof doc.dispositions !== 'object' || Array.isArray(doc.dispositions)) {
123
+ errors.push('`dispositions` must be a mapping of VP-id → { as, reason }');
124
+ }
125
+ else {
126
+ for (const [vpId, d] of Object.entries(doc.dispositions)) {
127
+ const dd = (d && typeof d === 'object' ? d : {});
128
+ if (!DISPOSITIONS.includes(String(dd.as))) {
129
+ errors.push(`dispositions.${vpId}: \`as\` must be one of ${DISPOSITIONS.join(' | ')}`);
130
+ }
131
+ dispositions[vpId] = { as: dd.as, reason: dd.reason ? String(dd.reason) : undefined };
132
+ }
133
+ }
134
+ }
135
+ const requirements = {};
136
+ if (doc.requirements !== undefined) {
137
+ if (!doc.requirements || typeof doc.requirements !== 'object' || Array.isArray(doc.requirements)) {
138
+ errors.push('`requirements` must be a mapping of requirement-id → { status, note }');
139
+ }
140
+ else {
141
+ for (const [reqId, r] of Object.entries(doc.requirements)) {
142
+ const rr = (r && typeof r === 'object' ? r : {});
143
+ if (!REQUIREMENT_STATUSES.includes(String(rr.status))) {
144
+ errors.push(`requirements.${reqId}: \`status\` must be one of ${REQUIREMENT_STATUSES.join(' | ')}`);
145
+ }
146
+ requirements[reqId] = { status: rr.status, note: rr.note ? String(rr.note) : undefined };
147
+ }
148
+ }
149
+ }
150
+ const fingerprints = {};
151
+ if (doc.fingerprints && typeof doc.fingerprints === 'object' && !Array.isArray(doc.fingerprints)) {
152
+ for (const [k, v] of Object.entries(doc.fingerprints)) {
153
+ fingerprints[k] = String(v);
154
+ }
155
+ }
156
+ const map = {
157
+ version: Number(doc.version ?? 1),
158
+ unit: String(doc.unit ?? ''),
159
+ formNo: doc.form_no !== undefined ? String(doc.form_no) : undefined,
160
+ groups,
161
+ dispositions,
162
+ requirements,
163
+ fingerprints,
164
+ };
165
+ return { map: errors.length > 0 ? null : map, errors };
166
+ }
167
+ /**
168
+ * Write the map back (used by `--approve` to flip review states + stamp fingerprints).
169
+ * Field order is kept stable so approve-diffs stay minimal and reviewable.
170
+ */
171
+ function writeDeliveryMap(file, map) {
172
+ const doc = {
173
+ version: map.version,
174
+ unit: map.unit,
175
+ ...(map.formNo !== undefined ? { form_no: map.formNo } : {}),
176
+ groups: map.groups.map((g) => ({
177
+ id: g.id,
178
+ target: g.target,
179
+ intent: g.intent,
180
+ oracle: g.oracle,
181
+ ...(g.dimensions !== undefined ? { dimensions: g.dimensions } : {}),
182
+ category: g.category,
183
+ review: g.review,
184
+ variants: g.variants,
185
+ })),
186
+ ...(Object.keys(map.dispositions).length > 0 ? { dispositions: map.dispositions } : {}),
187
+ ...(Object.keys(map.requirements).length > 0 ? { requirements: map.requirements } : {}),
188
+ ...(Object.keys(map.fingerprints).length > 0 ? { fingerprints: map.fingerprints } : {}),
189
+ };
190
+ fs.mkdirSync(path.dirname(file), { recursive: true });
191
+ fs.writeFileSync(file, (0, yaml_1.stringify)(doc, { lineWidth: 0 }), 'utf-8');
192
+ }
193
+ //# sourceMappingURL=map-loader.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"map-loader.js","sourceRoot":"","sources":["../../../src/exporters/matrix/map-loader.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBH,kCAEC;AAED,0CAyGC;AAMD,4CAqBC;AA1JD,uCAAyB;AACzB,2CAA6B;AAC7B,+BAAsE;AAGtE,MAAM,UAAU,GAAkB,CAAC,QAAQ,EAAE,UAAU,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;AAC5E,MAAM,aAAa,GAAkB,CAAC,UAAU,EAAE,UAAU,CAAC,CAAC;AAC9D,MAAM,YAAY,GAAG,CAAC,UAAU,EAAE,SAAS,EAAE,mBAAmB,EAAE,eAAe,CAAC,CAAC;AACnF,MAAM,oBAAoB,GACxB,CAAC,SAAS,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,SAAS,EAAE,KAAK,EAAE,gBAAgB,CAAC,CAAC;AAQ5F,yFAAyF;AACzF,SAAgB,WAAW,CAAC,OAAe,EAAE,eAAuB;IAClE,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,UAAU,EAAE,GAAG,eAAe,WAAW,CAAC,CAAC;AACvE,CAAC;AAED,SAAgB,eAAe,CAAC,IAAY;IAC1C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;IAC3D,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,IAAI,GAAY,CAAC;IACjB,IAAI,CAAC;QACH,GAAG,GAAG,IAAA,YAAS,EAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,4BAA4B,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IACnG,CAAC;IACD,IAAI,CAAC,GAAG,IAAI,OAAO,GAAG,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1D,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,iCAAiC,CAAC,EAAE,CAAC;IACpE,CAAC;IACD,MAAM,GAAG,GAAG,GAA8B,CAAC;IAE3C,MAAM,MAAM,GAAe,EAAE,CAAC;IAC9B,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,MAAM,SAAS,GAAG,GAAG,CAAC,MAAM,CAAC;IAC7B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxD,MAAM,CAAC,IAAI,CAAC,0BAA0B,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACN,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;YACzB,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,EAAE,CAAC;gBAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,oBAAoB,CAAC,CAAC;gBAAC,OAAO;YAAC,CAAC;YAC1F,MAAM,GAAG,GAAG,CAA4B,CAAC;YACzC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,OAAO,GAAG,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;YAChF,KAAK,MAAM,KAAK,IAAI,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,CAAU,EAAE,CAAC;gBAClE,IAAI,OAAO,GAAG,CAAC,KAAK,CAAC,KAAK,QAAQ,IAAI,CAAE,GAAG,CAAC,KAAK,CAAY,CAAC,IAAI,EAAE,EAAE,CAAC;oBACrE,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,qBAAqB,KAAK,IAAI,CAAC,CAAC;gBACtD,CAAC;YACH,CAAC;YACD,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,QAAuB,CAAC,EAAE,CAAC;gBACtD,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,iCAAiC,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACjF,CAAC;YACD,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,MAAM,IAAI,UAAU,CAAgB,CAAC;YACzD,IAAI,CAAC,aAAa,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,0CAA0C,CAAC,CAAC;YAClE,CAAC;YACD,MAAM,QAAQ,GAAG,GAAG,CAAC,QAAQ,CAAC;YAC9B,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBAClH,MAAM,CAAC,IAAI,CAAC,GAAG,KAAK,oDAAoD,CAAC,CAAC;YAC5E,CAAC;YACD,MAAM,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;YAChC,IAAI,EAAE,EAAE,CAAC;gBACP,IAAI,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;oBAAE,MAAM,CAAC,IAAI,CAAC,wBAAwB,EAAE,IAAI,CAAC,CAAC;gBACjE,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,CAAC,IAAI,CAAC;gBACV,EAAE;gBACF,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;gBAChC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;gBAChC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,IAAI,EAAE,CAAC;gBAChC,GAAG,CAAC,GAAG,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC/E,QAAQ,EAAE,GAAG,CAAC,QAAuB;gBACrC,MAAM;gBACN,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;aAC9D,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAmC,EAAE,CAAC;IACxD,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACjG,MAAM,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;QAC5E,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAuC,CAAC,EAAE,CAAC;gBACpF,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;gBAC5E,IAAI,CAAC,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC;oBAC1C,MAAM,CAAC,IAAI,CAAC,gBAAgB,IAAI,2BAA2B,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACzF,CAAC;gBACD,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,EAAE,EAAE,EAAE,CAAC,EAA0B,EAAE,MAAM,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YAChH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAAwC,EAAE,CAAC;IAC7D,IAAI,GAAG,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;QACnC,IAAI,CAAC,GAAG,CAAC,YAAY,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;YACjG,MAAM,CAAC,IAAI,CAAC,uEAAuE,CAAC,CAAC;QACvF,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAuC,CAAC,EAAE,CAAC;gBACrF,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAA4B,CAAC;gBAC5E,IAAI,CAAC,oBAAoB,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAsB,CAAC,EAAE,CAAC;oBAC3E,MAAM,CAAC,IAAI,CAAC,gBAAgB,KAAK,+BAA+B,oBAAoB,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;gBACtG,CAAC;gBACD,YAAY,CAAC,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,CAAC,MAA2B,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;YAChH,CAAC;QACH,CAAC;IACH,CAAC;IAED,MAAM,YAAY,GAA2B,EAAE,CAAC;IAChD,IAAI,GAAG,CAAC,YAAY,IAAI,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,EAAE,CAAC;QACjG,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,YAAuC,CAAC,EAAE,CAAC;YACjF,YAAY,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAC9B,CAAC;IACH,CAAC;IAED,MAAM,GAAG,GAAgB;QACvB,OAAO,EAAE,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,CAAC;QACjC,IAAI,EAAE,MAAM,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,SAAS;QACnE,MAAM;QACN,YAAY;QACZ,YAAY;QACZ,YAAY;KACb,CAAC;IACF,OAAO,EAAE,GAAG,EAAE,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,CAAC;AACzD,CAAC;AAED;;;GAGG;AACH,SAAgB,gBAAgB,CAAC,IAAY,EAAE,GAAgB;IAC7D,MAAM,GAAG,GAA4B;QACnC,OAAO,EAAE,GAAG,CAAC,OAAO;QACpB,IAAI,EAAE,GAAG,CAAC,IAAI;QACd,GAAG,CAAC,GAAG,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC7B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,GAAG,CAAC,CAAC,CAAC,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,QAAQ,EAAE,CAAC,CAAC,QAAQ;YACpB,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,QAAQ,EAAE,CAAC,CAAC,QAAQ;SACrB,CAAC,CAAC;QACH,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxF,CAAC;IACF,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAA,gBAAa,EAAC,GAAG,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;AACxE,CAAC"}
@@ -0,0 +1,9 @@
1
+ /**
2
+ * Flat CSV rendering of the matrix — same model as the workbook, one row per
3
+ * delivery item (`Level: item`) followed by its variant rows (`Level: variant`;
4
+ * every item has them — the variant row carries the source scenario id, data,
5
+ * and result), so downstream pipelines can re-derive both views from one file.
6
+ */
7
+ import { MatrixModel } from './types';
8
+ export declare function renderMatrixCsv(model: MatrixModel): string;
9
+ //# sourceMappingURL=render-csv.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"render-csv.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/render-csv.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAoBtC,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAgE1D"}