@sun-asterisk/sungen 3.2.15 → 3.2.16-beta.1

package/dist/exporters/matrix/gates.js

@@ -0,0 +1,258 @@
+"use strict";
+/**
+ * Deterministic quality gates for the Test Case & Coverage Matrix
+ * (docs/spec/delivery-coverage-matrix-spec.md §6).
+ *
+ * Severity behavior:
+ *   error   → blocks any render
+ *   review  → blocks the official render; `--preview` renders with a DRAFT watermark
+ *   warning → prints + renders
+ *
+ * The gates recompute every signature part from the .feature — the map is never
+ * trusted for derivable facts, only for the semantic fields (target/intent/oracle).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.runGates = runGates;
+const feature_parser_1 = require("../feature-parser");
+const types_1 = require("./types");
+const build_1 = require("./build");
+function runGates(ctx) {
+    const findings = [];
+    gateASource(ctx, findings);
+    gateBMapping(ctx, findings);
+    gateCAggregation(ctx, findings);
+    gateDExecutability(ctx, findings);
+    gateEDrift(ctx, findings);
+    gateGReviewState(ctx, findings);
+    return findings;
+}
+// --- Gate A — source quality ------------------------------------------------
+function gateASource(ctx, findings) {
+    const { feature, merged } = ctx.inputs;
+    if (feature.backgroundWhenSteps.length > 0 || feature.backgroundThenSteps.length > 0) {
+        findings.push({
+            gate: 'A', severity: 'error',
+            message: 'Background contains When/Then steps — setup only; move the action/oracle into scenarios',
+        });
+    }
+    const seen = new Map();
+    for (const m of merged) {
+        const { vpId } = (0, feature_parser_1.splitVpAndName)(m.feature.name);
+        if (!vpId) {
+            findings.push({
+                gate: 'A', severity: 'error', ref: m.feature.name,
+                message: `scenario "${m.feature.name}" has no VP-id prefix — matrix variants must be addressable`,
+            });
+            continue;
+        }
+        seen.set(vpId, (seen.get(vpId) ?? 0) + 1);
+        const isManual = (0, feature_parser_1.extractTestcaseType)(m.feature.tags) === 'Manual';
+        if (m.resolvedExpected.length === 0) {
+            findings.push({
+                gate: 'A', severity: 'error', ref: vpId,
+                message: isManual
+                    ? `manual scenario ${vpId} has no observable oracle (no Then steps and no Observable/Oracle comment lines)`
+                    : `scenario ${vpId} has no Then step — a variant without an observable oracle cannot be delivered`,
+            });
+        }
+    }
+    for (const [vpId, n] of seen) {
+        if (n > 1)
+            findings.push({ gate: 'A', severity: 'error', ref: vpId, message: `duplicate VP-id ${vpId} (${n} scenarios)` });
+    }
+}
+// --- Gate B — mapping completeness -------------------------------------------
+function gateBMapping(ctx, findings) {
+    const { map } = ctx.inputs;
+    const { variants, variantsByVp } = ctx;
+    // Where each derived variant landed: 0 → unmapped, >1 → double-mapped.
+    const owners = new Map();
+    for (const g of map.groups) {
+        for (const ref of g.variants) {
+            const expanded = (0, build_1.expandMapRef)(ref, variantsByVp);
+            if (expanded.length === 0) {
+                findings.push({
+                    gate: 'B', severity: 'error', ref: g.id,
+                    message: `group ${g.id} references ${ref} which matches no scenario/@cases row in the .feature`,
+                });
+                continue;
+            }
+            for (const v of expanded) {
+                const list = owners.get(v.ref) ?? [];
+                list.push(g.id);
+                owners.set(v.ref, list);
+            }
+        }
+    }
+    for (const [ref, groups] of owners) {
+        if (groups.length > 1) {
+            findings.push({
+                gate: 'B', severity: 'error', ref,
+                message: `variant ${ref} belongs to ${groups.length} groups (${groups.join(', ')}) — exactly one required`,
+            });
+        }
+    }
+    for (const v of variants) {
+        const grouped = owners.has(v.ref);
+        const disposed = v.vpId in map.dispositions;
+        if (!grouped && !disposed) {
+            findings.push({
+                gate: 'B', severity: 'error', ref: v.ref,
+                message: `variant ${v.ref} is in no group and has no disposition — 100% source disposition is required`,
+            });
+        }
+        if (grouped && disposed) {
+            findings.push({
+                gate: 'B', severity: 'error', ref: v.ref,
+                message: `variant ${v.ref} is grouped AND disposed (${map.dispositions[v.vpId].as}) — pick one`,
+            });
+        }
+    }
+    for (const vpId of Object.keys(map.dispositions)) {
+        if (!variantsByVp.has(vpId)) {
+            findings.push({
+                gate: 'B', severity: 'warning', ref: vpId,
+                message: `disposition for ${vpId} matches no scenario (stale entry?)`,
+            });
+        }
+    }
+}
+// --- Gate C — aggregation safety ---------------------------------------------
+function gateCAggregation(ctx, findings) {
+    const { map } = ctx.inputs;
+    const { variantsByVp } = ctx;
+    for (const g of map.groups) {
+        const vs = g.variants.flatMap((ref) => (0, build_1.expandMapRef)(ref, variantsByVp));
+        if (vs.length <= 1)
+            continue;
+        // Approval IS the QA confirmation of the heuristic parts (oracle family,
+        // precondition equivalence, sequence safety) — once approved AND unchanged
+        // (fingerprints intact), only the hard signature checks keep firing. A
+        // drifted variant re-opens the heuristics (Gate E flips the item to
+        // proposed at the same time).
+        const stale = vs.some((v) => {
+            const stamped = map.fingerprints[v.ref] ?? map.fingerprints[v.vpId];
+            return !stamped || stamped !== v.fingerprint;
+        });
+        const heuristicsConfirmed = g.review === 'approved' && !stale;
+        // Hard signature parts — recomputed, never trusted from the map. ERROR on mismatch.
+        const hard = [
+            ['execution mode', (v) => v.mode],
+            ['test layer', (v) => [...v.layers].sort().join('+')],
+            ['priority', (v) => v.priority],
+        ];
+        for (const [label, keyOf] of hard) {
+            const distinct = new Set(vs.map(keyOf));
+            if (distinct.size > 1) {
+                findings.push({
+                    gate: 'C', severity: 'error', ref: g.id,
+                    message: `group ${g.id} mixes ${label}s (${[...distinct].join(' vs ')}) — mandatory split`,
+                });
+            }
+        }
+        // Heuristic signature parts — REVIEW_REQUIRED (equivalence was inferred, not declared).
+        const preProfiles = new Set(vs.map((v) => v.preconditionProfile));
+        if (!heuristicsConfirmed && preProfiles.size > 1) {
+            findings.push({
+                gate: 'C', severity: 'review', ref: g.id,
+                message: `group ${g.id} variants have different precondition profiles — confirm the grouping is safe or split`,
+            });
+        }
+        const oracleShapes = new Set(vs.map((v) => v.oracleShape.join(' ; ')));
+        if (!heuristicsConfirmed && oracleShapes.size > 1) {
+            findings.push({
+                gate: 'C', severity: 'review', ref: g.id,
+                message: `group ${g.id} variants assert different oracle shapes (${oracleShapes.size} shapes) — confirm they are one oracle family`,
+            });
+        }
+        if (!heuristicsConfirmed && vs.some((v) => v.procedureProfile === 'sequence')) {
+            findings.push({
+                gate: 'C', severity: 'review', ref: g.id,
+                message: `group ${g.id} contains a sequence-sensitive scenario — ordered flows stay solo items unless QA confirms`,
+            });
+        }
+        if (vs.length > types_1.MAX_VARIANTS_PER_ITEM) {
+            findings.push({
+                gate: 'C', severity: 'warning', ref: g.id,
+                message: `group ${g.id} has ${vs.length} variants (> ${types_1.MAX_VARIANTS_PER_ITEM}) — consider splitting for reviewability`,
+            });
+        }
+    }
+}
+// --- Gate D — manual executability -------------------------------------------
+function gateDExecutability(ctx, findings) {
+    const { map, testData, feature } = ctx.inputs;
+    const { variantsByVp } = ctx;
+    for (const g of map.groups) {
+        const vs = g.variants.flatMap((ref) => (0, build_1.expandMapRef)(ref, variantsByVp));
+        for (const v of vs) {
+            const hasPrecondition = v.precondition.length > 0 || feature.backgroundGivenSteps.length > 0;
+            if (!hasPrecondition) {
+                findings.push({
+                    gate: 'D', severity: 'error', ref: v.ref,
+                    message: `${v.ref}: no precondition (no Background, auth tag, or Given) — a tester cannot establish the start state`,
+                });
+            }
+            if (v.trigger.length === 0) {
+                findings.push({
+                    gate: 'D', severity: 'error', ref: v.ref,
+                    message: `${v.ref}: no action/trigger (no When steps${v.mode === 'manual' ? ' and no Setup/Action comment lines' : ''})`,
+                });
+            }
+            // Oracle emptiness is Gate A (source) — not repeated here.
+        }
+    }
+    // Every {{var}} must resolve — data the tester cannot obtain is not executable.
+    for (const [vpId, vs] of variantsByVp) {
+        const scenario = ctx.inputs.merged.find((m) => (0, feature_parser_1.splitVpAndName)(m.feature.name).vpId === vpId);
+        if (!scenario)
+            continue;
+        for (const varName of scenario.feature.referencedVars) {
+            const inRows = vs.some((v) => v.caseLabel !== undefined); // dataset rows carry their own columns
+            if (!inRows && (!testData || !(varName in testData))) {
+                findings.push({
+                    gate: 'D', severity: 'error', ref: vpId,
+                    message: `${vpId}: {{${varName}}} does not resolve in test-data — the variant is not reproducible`,
+                });
+            }
+        }
+    }
+}
+// --- Gate E — drift (stale approval) ------------------------------------------
+function gateEDrift(ctx, findings) {
+    const { map } = ctx.inputs;
+    const { variantsByVp } = ctx;
+    for (const g of map.groups) {
+        if (g.review !== 'approved')
+            continue; // proposed groups are already under review
+        for (const ref of g.variants) {
+            const vs = (0, build_1.expandMapRef)(ref, variantsByVp);
+            for (const v of vs) {
+                const stamped = map.fingerprints[v.ref] ?? map.fingerprints[v.vpId];
+                if (!stamped) {
+                    findings.push({
+                        gate: 'E', severity: 'review', ref: g.id,
+                        message: `group ${g.id}: ${v.ref} has no stamped fingerprint — run \`sungen delivery --approve\` after review`,
+                    });
+                }
+                else if (stamped !== v.fingerprint) {
+                    findings.push({
+                        gate: 'E', severity: 'review', ref: g.id,
+                        message: `group ${g.id}: ${v.ref} changed since approval (fingerprint drift) — re-review the grouping`,
+                    });
+                }
+            }
+        }
+    }
+}
+// --- Gate G — review state -----------------------------------------------------
+function gateGReviewState(ctx, findings) {
+    const proposed = ctx.inputs.map.groups.filter((g) => g.review !== 'approved');
+    if (proposed.length > 0) {
+        findings.push({
+            gate: 'G', severity: 'review',
+            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`,
+        });
+    }
+}
+//# sourceMappingURL=gates.js.map

package/dist/exporters/matrix/gates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates.js","sourceRoot":"","sources":["../../../src/exporters/matrix/gates.ts"],"names":[],"mappings":"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"}

package/dist/exporters/matrix/map-loader.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Delivery Map loader — `qa/<kind>/<unit>/delivery/<unit>.map.yaml`.
+ *
+ * Structural validation only (shape, required fields, enum values, duplicate ids).
+ * Semantic validation against the .feature is the gates' job (gates.ts) — the loader
+ * never reads the feature.
+ */
+import { DeliveryMap } from './types';
+export interface MapLoadResult {
+    map: DeliveryMap | null;
+    /** Structural problems — any entry blocks the matrix path (fix the file first). */
+    errors: string[];
+}
+/** Path of the map file for a unit directory (qa/<kind>/<screen>) + feature basename. */
+export declare function mapFilePath(unitDir: string, featureBaseName: string): string;
+export declare function loadDeliveryMap(file: string): MapLoadResult;
+/**
+ * Write the map back (used by `--approve` to flip review states + stamp fingerprints).
+ * Field order is kept stable so approve-diffs stay minimal and reviewable.
+ */
+export declare function writeDeliveryMap(file: string, map: DeliveryMap): void;
+//# sourceMappingURL=map-loader.d.ts.map

package/dist/exporters/matrix/map-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-loader.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/map-loader.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,OAAO,EAAE,WAAW,EAAsD,MAAM,SAAS,CAAC;AAM1F,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,CAwF3D;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,WAAW,GAAG,IAAI,CAmBrE"}

package/dist/exporters/matrix/map-loader.js

@@ -0,0 +1,173 @@
+"use strict";
+/**
+ * Delivery Map loader — `qa/<kind>/<unit>/delivery/<unit>.map.yaml`.
+ *
+ * Structural validation only (shape, required fields, enum values, duplicate ids).
+ * Semantic validation against the .feature is the gates' job (gates.ts) — the loader
+ * never reads the feature.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapFilePath = mapFilePath;
+exports.loadDeliveryMap = loadDeliveryMap;
+exports.writeDeliveryMap = writeDeliveryMap;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml_1 = require("yaml");
+const CATEGORIES = ['normal', 'abnormal', 'security', 'nfr'];
+const REVIEW_STATES = ['proposed', 'approved'];
+const DISPOSITIONS = ['excluded', 'blocked', 'covered_elsewhere', 'accepted_risk'];
+/** Path of the map file for a unit directory (qa/<kind>/<screen>) + feature basename. */
+function mapFilePath(unitDir, featureBaseName) {
+    return path.join(unitDir, 'delivery', `${featureBaseName}.map.yaml`);
+}
+function loadDeliveryMap(file) {
+    if (!fs.existsSync(file))
+        return { map: null, errors: [] };
+    const errors = [];
+    let raw;
+    try {
+        raw = (0, yaml_1.parse)(fs.readFileSync(file, 'utf-8'));
+    }
+    catch (e) {
+        return { map: null, errors: [`map YAML does not parse: ${e instanceof Error ? e.message : e}`] };
+    }
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return { map: null, errors: ['map root must be a YAML mapping'] };
+    }
+    const doc = raw;
+    const groups = [];
+    const seenIds = new Set();
+    const rawGroups = doc.groups;
+    if (!Array.isArray(rawGroups) || rawGroups.length === 0) {
+        errors.push('map has no `groups` list');
+    }
+    else {
+        rawGroups.forEach((g, i) => {
+            if (!g || typeof g !== 'object') {
+                errors.push(`groups[${i}] is not a mapping`);
+                return;
+            }
+            const grp = g;
+            const where = `groups[${i}]${typeof grp.id === 'string' ? ` (${grp.id})` : ''}`;
+            for (const field of ['id', 'target', 'intent', 'oracle']) {
+                if (typeof grp[field] !== 'string' || !grp[field].trim()) {
+                    errors.push(`${where}: missing/empty \`${field}\``);
+                }
+            }
+            if (!CATEGORIES.includes(grp.category)) {
+                errors.push(`${where}: \`category\` must be one of ${CATEGORIES.join(' | ')}`);
+            }
+            const review = (grp.review ?? 'proposed');
+            if (!REVIEW_STATES.includes(review)) {
+                errors.push(`${where}: \`review\` must be proposed | approved`);
+            }
+            const variants = grp.variants;
+            if (!Array.isArray(variants) || variants.length === 0 || variants.some((v) => typeof v !== 'string' || !v.trim())) {
+                errors.push(`${where}: \`variants\` must be a non-empty list of VP refs`);
+            }
+            const id = String(grp.id ?? '');
+            if (id) {
+                if (seenIds.has(id))
+                    errors.push(`duplicate group id \`${id}\``);
+                seenIds.add(id);
+            }
+            groups.push({
+                id,
+                target: String(grp.target ?? ''),
+                intent: String(grp.intent ?? ''),
+                oracle: String(grp.oracle ?? ''),
+                category: grp.category,
+                review,
+                variants: Array.isArray(variants) ? variants.map(String) : [],
+            });
+        });
+    }
+    const dispositions = {};
+    if (doc.dispositions !== undefined) {
+        if (!doc.dispositions || typeof doc.dispositions !== 'object' || Array.isArray(doc.dispositions)) {
+            errors.push('`dispositions` must be a mapping of VP-id → { as, reason }');
+        }
+        else {
+            for (const [vpId, d] of Object.entries(doc.dispositions)) {
+                const dd = (d && typeof d === 'object' ? d : {});
+                if (!DISPOSITIONS.includes(String(dd.as))) {
+                    errors.push(`dispositions.${vpId}: \`as\` must be one of ${DISPOSITIONS.join(' | ')}`);
+                }
+                dispositions[vpId] = { as: dd.as, reason: dd.reason ? String(dd.reason) : undefined };
+            }
+        }
+    }
+    const fingerprints = {};
+    if (doc.fingerprints && typeof doc.fingerprints === 'object' && !Array.isArray(doc.fingerprints)) {
+        for (const [k, v] of Object.entries(doc.fingerprints)) {
+            fingerprints[k] = String(v);
+        }
+    }
+    const map = {
+        version: Number(doc.version ?? 1),
+        unit: String(doc.unit ?? ''),
+        formNo: doc.form_no !== undefined ? String(doc.form_no) : undefined,
+        groups,
+        dispositions,
+        fingerprints,
+    };
+    return { map: errors.length > 0 ? null : map, errors };
+}
+/**
+ * Write the map back (used by `--approve` to flip review states + stamp fingerprints).
+ * Field order is kept stable so approve-diffs stay minimal and reviewable.
+ */
+function writeDeliveryMap(file, map) {
+    const doc = {
+        version: map.version,
+        unit: map.unit,
+        ...(map.formNo !== undefined ? { form_no: map.formNo } : {}),
+        groups: map.groups.map((g) => ({
+            id: g.id,
+            target: g.target,
+            intent: g.intent,
+            oracle: g.oracle,
+            category: g.category,
+            review: g.review,
+            variants: g.variants,
+        })),
+        ...(Object.keys(map.dispositions).length > 0 ? { dispositions: map.dispositions } : {}),
+        ...(Object.keys(map.fingerprints).length > 0 ? { fingerprints: map.fingerprints } : {}),
+    };
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, (0, yaml_1.stringify)(doc, { lineWidth: 0 }), 'utf-8');
+}
+//# sourceMappingURL=map-loader.js.map

package/dist/exporters/matrix/map-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-loader.js","sourceRoot":"","sources":["../../../src/exporters/matrix/map-loader.ts"],"names":[],"mappings":"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"}

package/dist/exporters/matrix/render-csv.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Flat CSV rendering of the matrix — same model as the workbook, one row per
+ * delivery item (`Level: item`) followed by its variant rows (`Level: variant`),
+ * so downstream pipelines can re-derive both views from one file.
+ */
+import { MatrixModel } from './types';
+export declare function renderMatrixCsv(model: MatrixModel): string;
+//# sourceMappingURL=render-csv.d.ts.map

package/dist/exporters/matrix/render-csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-csv.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/render-csv.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAatC,wBAAgB,eAAe,CAAC,KAAK,EAAE,WAAW,GAAG,MAAM,CAkD1D"}

package/dist/exporters/matrix/render-csv.js

@@ -0,0 +1,69 @@
+"use strict";
+/**
+ * Flat CSV rendering of the matrix — same model as the workbook, one row per
+ * delivery item (`Level: item`) followed by its variant rows (`Level: variant`),
+ * so downstream pipelines can re-derive both views from one file.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.renderMatrixCsv = renderMatrixCsv;
+const playwright_report_parser_1 = require("../playwright-report-parser");
+const HEADERS = [
+    'Level', 'ID', 'Target', 'Test Intent / Condition', 'Category', 'Priority',
+    'Precondition', 'Coverage / Test Data', 'Action / Trigger', 'Expected (Oracle)',
+    'Mode', 'Trace', 'Result', 'Executed Date', 'Note',
+];
+function esc(value) {
+    if (/[",\n]/.test(value))
+        return `"${value.replace(/"/g, '""')}"`;
+    return value;
+}
+function renderMatrixCsv(model) {
+    const BOM = '\ufeff'; // Excel compatibility (Vietnamese/Japanese content)
+    const lines = [];
+    lines.push(`# Test Case & Coverage Matrix — ${model.unit}`);
+    lines.push(`# delivery items: ${model.manifest.itemCount} · coverage variants: ${model.manifest.variantCount} · state: ${model.manifest.approvalState}`);
+    lines.push(HEADERS.map(esc).join(','));
+    for (const item of model.items) {
+        const single = item.variants.length === 1;
+        const only = single ? item.variants[0] : undefined;
+        lines.push([
+            'item',
+            item.id,
+            item.target,
+            item.intent,
+            item.category,
+            item.priority,
+            item.precondition.join('\n'),
+            single ? only.data.join('\n') : `${item.variants.length} variants`,
+            item.trigger.join('\n'),
+            item.oracle,
+            item.mode === 'manual' ? 'Manual' : 'Auto',
+            item.traces.join(' '),
+            item.result,
+            single ? (0, playwright_report_parser_1.formatExecutedDate)(only.result?.startTime) : '',
+            item.review === 'proposed' ? 'REVIEW REQUIRED' : '',
+        ].map(esc).join(','));
+        if (!single) {
+            for (const v of item.variants) {
+                lines.push([
+                    'variant',
+                    v.ref,
+                    '',
+                    v.condition,
+                    '', '',
+                    '',
+                    v.data.join('\n'),
+                    v.trigger.join('\n'),
+                    v.oracle.join('\n'),
+                    v.mode === 'manual' ? 'Manual' : 'Auto',
+                    v.traces.join(' '),
+                    v.result ? (0, playwright_report_parser_1.statusToTestResult)(v.result.status) : 'Pending',
+                    (0, playwright_report_parser_1.formatExecutedDate)(v.result?.startTime),
+                    v.result?.error ? String(v.result.error).slice(0, 200) : '',
+                ].map(esc).join(','));
+            }
+        }
+    }
+    return BOM + lines.join('\n') + '\n';
+}
+//# sourceMappingURL=render-csv.js.map

package/dist/exporters/matrix/render-csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-csv.js","sourceRoot":"","sources":["../../../src/exporters/matrix/render-csv.ts"],"names":[],"mappings":"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"}

package/dist/exporters/matrix/render-xlsx.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Render the Test Case & Coverage Matrix workbook.
+ *
+ * Sheets:
+ *   1. Testcases — one parent row per delivery item, variant sub-rows grouped with
+ *      Excel outline (expanded for execution; the level-1 outline button collapses
+ *      to the customer/review view — same sheet, one model, two views).
+ *   2. Coverage — target × category grid (items + variants, `—` marks the gaps),
+ *      dispositions, and the generation manifest.
+ *
+ * Every sheet keeps the company ISO masthead (renderReportHeaderBand). A draft
+ * matrix (unapproved groups / review findings) carries a red DRAFT banner.
+ */
+import * as ExcelJS from 'exceljs';
+import { MatrixModel } from './types';
+export declare function renderMatrixXlsx(model: MatrixModel, sungenVersion?: string): ExcelJS.Workbook;
+//# sourceMappingURL=render-xlsx.d.ts.map

package/dist/exporters/matrix/render-xlsx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-xlsx.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/render-xlsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AASnC,OAAO,EAA6C,WAAW,EAAe,MAAM,SAAS,CAAC;AAoQ9F,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAK7F"}