@sun-asterisk/sungen 3.2.28 → 3.2.29

package/dist/exporters/matrix/render-coverage-sheet.js

@@ -0,0 +1,160 @@
+"use strict";
+/**
+ * Sheet 4 — Coverage: requirement coverage (id ↔ items ↔ status), the
+ * target × category grid (with explicit `—` gaps), the mock-verified case
+ * tracker, dispositions, and the generation manifest.
+ *
+ * Reports on the WHOLE model — it is deliberately not split by execution mode,
+ * because a requirement is covered or not regardless of who runs the case.
+ *
+ * Moved out of `render-xlsx.ts` unchanged when the workbook grew to four sheets.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addCoverageSheet = addCoverageSheet;
+const xlsx_report_builder_1 = require("../xlsx-report-builder");
+const build_1 = require("./build");
+const xlsx_cells_1 = require("./xlsx-cells");
+const CATEGORY_ORDER = ['normal', 'abnormal', 'security', 'nfr'];
+function addCoverageSheet(wb, model, sungenVersion) {
+    const ws = wb.addWorksheet('Coverage');
+    ws.columns = [
+        { width: 3 }, { width: 22 }, { width: 18 }, { width: 16 }, { width: 16 }, { width: 16 },
+        { width: 16 }, { width: 44 },
+    ];
+    (0, xlsx_report_builder_1.renderReportHeaderBand)(wb, ws, `${model.unit.toUpperCase()} COVERAGE OVERVIEW`, sungenVersion, model.formNo);
+    (0, xlsx_cells_1.draftBanner)(ws, model);
+    let rowIdx = 7;
+    // --- Performance budget (#569) — advisory: config (qa/perf.yaml) vs measured runs.
+    if (model.perf) {
+        const p = model.perf;
+        (0, xlsx_cells_1.dataCell)(ws.getRow(rowIdx).getCell(2), 'Performance budget', { bold: true });
+        rowIdx++;
+        const r = ws.getRow(rowIdx);
+        (0, xlsx_cells_1.dataCell)(r.getCell(2), `p${p.percentile} ${p.metric.replace('_ms', ' time')}`);
+        (0, xlsx_cells_1.dataCell)(r.getCell(3), p.pass ? 'PASS' : 'OVER BUDGET', { bold: true });
+        (0, xlsx_cells_1.dataCell)(r.getCell(4), `measured ${p.measuredMs}ms`);
+        (0, xlsx_cells_1.dataCell)(r.getCell(5), `budget ${p.budgetMs}ms`);
+        (0, xlsx_cells_1.dataCell)(r.getCell(6), `${p.samples} runs`);
+        if (!p.pass && p.slowest.length)
+            (0, xlsx_cells_1.dataCell)(r.getCell(8), `slowest: ${p.slowest.map((x) => `${x.ms}ms ${x.title.slice(0, 40)}`).join(' · ')}`);
+        rowIdx += 2;
+    }
+    // --- External Dependency Tracking (#580, ISTQB system-test practice): every case that
+    // ran against a MOCK is listed centrally. Its Result stays in the canonical vocabulary
+    // (the roll-up formulas depend on it); THIS table is where "Pass (Mocked) ≠ Pass (Real)"
+    // is visible — a case verified only against mocks is not Done until re-verified real.
+    {
+        const mockedVars = model.items.flatMap((it) => it.variants.filter((v) => v.mocked).map((v) => ({ it, v })));
+        if (mockedVars.length > 0) {
+            (0, xlsx_cells_1.dataCell)(ws.getRow(rowIdx).getCell(2), 'External Dependency Tracking — mock-verified cases (Pass here = Pass (Mocked), not Pass (Real))', { bold: true });
+            rowIdx++;
+            const hd = ws.getRow(rowIdx);
+            (0, xlsx_cells_1.dataCell)(hd.getCell(2), 'Variant');
+            (0, xlsx_cells_1.dataCell)(hd.getCell(3), 'Mocked dependency');
+            (0, xlsx_cells_1.dataCell)(hd.getCell(4), 'Delivery item');
+            (0, xlsx_cells_1.dataCell)(hd.getCell(5), 'Result');
+            (0, xlsx_cells_1.dataCell)(hd.getCell(8), 'Real-environment re-verify');
+            rowIdx++;
+            for (const { it, v } of mockedVars) {
+                const r = ws.getRow(rowIdx);
+                (0, xlsx_cells_1.dataCell)(r.getCell(2), v.ref);
+                (0, xlsx_cells_1.dataCell)(r.getCell(3), (v.mockDeps ?? []).join(', ') || '(scenario-level @mock)');
+                (0, xlsx_cells_1.dataCell)(r.getCell(4), it.id);
+                (0, xlsx_cells_1.dataCell)(r.getCell(5), (0, build_1.variantState)(v));
+                (0, xlsx_cells_1.dataCell)(r.getCell(8), '');
+                rowIdx++;
+            }
+            rowIdx++;
+        }
+    }
+    // --- Requirement coverage (review §6): every requirement id gets ONE explicit status.
+    if (model.requirements.length > 0) {
+        (0, xlsx_cells_1.dataCell)(ws.getRow(rowIdx).getCell(2), 'Requirement coverage — every id has an explicit status', { bold: true });
+        rowIdx += 1;
+        const rh = ws.getRow(rowIdx);
+        ws.mergeCells(rowIdx, 4, rowIdx, 6);
+        (0, xlsx_cells_1.headerCell)(rh.getCell(2), 'Requirement');
+        (0, xlsx_cells_1.headerCell)(rh.getCell(3), 'Status');
+        (0, xlsx_cells_1.headerCell)(rh.getCell(4), 'Delivery items');
+        (0, xlsx_cells_1.headerCell)(rh.getCell(7), 'Variants');
+        (0, xlsx_cells_1.headerCell)(rh.getCell(8), 'Note');
+        rowIdx += 1;
+        for (const r of model.requirements) {
+            const row = ws.getRow(rowIdx++);
+            (0, xlsx_cells_1.dataCell)(row.getCell(2), r.id, { bold: true });
+            (0, xlsx_cells_1.dataCell)(row.getCell(3), r.status, {
+                center: true,
+                ...(r.status === 'gap' ? { fill: xlsx_cells_1.GAP_FILL, bold: true } : {}),
+            });
+            ws.mergeCells(rowIdx - 1, 4, rowIdx - 1, 6);
+            (0, xlsx_cells_1.dataCell)(row.getCell(4), r.items.join(', '));
+            (0, xlsx_cells_1.dataCell)(row.getCell(7), r.variantCount > 0 ? String(r.variantCount) : '', { center: true });
+            (0, xlsx_cells_1.dataCell)(row.getCell(8), r.note);
+        }
+        rowIdx += 1;
+    }
+    // --- Target × category grid ---
+    (0, xlsx_cells_1.dataCell)(ws.getRow(rowIdx).getCell(2), 'Coverage matrix — delivery items (coverage variants) per target × category', { bold: true });
+    rowIdx += 1;
+    const gridHeader = ws.getRow(rowIdx++);
+    (0, xlsx_cells_1.headerCell)(gridHeader.getCell(2), 'Target');
+    CATEGORY_ORDER.forEach((cat, i) => (0, xlsx_cells_1.headerCell)(gridHeader.getCell(3 + i), cat));
+    (0, xlsx_cells_1.headerCell)(gridHeader.getCell(3 + CATEGORY_ORDER.length), 'Total');
+    const targets = Array.from(new Set(model.items.map((i) => i.target)));
+    for (const target of targets) {
+        const row = ws.getRow(rowIdx++);
+        (0, xlsx_cells_1.dataCell)(row.getCell(2), target, { bold: true });
+        let totalItems = 0;
+        let totalVariants = 0;
+        CATEGORY_ORDER.forEach((cat, i) => {
+            const cell = row.getCell(3 + i);
+            const items = model.items.filter((it) => it.target === target && it.category === cat);
+            const variants = items.reduce((a, it) => a + it.variants.length, 0);
+            totalItems += items.length;
+            totalVariants += variants;
+            // `—` is an explicit statement: this target × category cell has NO coverage.
+            (0, xlsx_cells_1.dataCell)(cell, items.length === 0 ? '—' : `${items.length} (${variants})`, {
+                center: true,
+                ...(items.length === 0 ? { fill: xlsx_cells_1.GAP_FILL } : {}),
+            });
+        });
+        (0, xlsx_cells_1.dataCell)(row.getCell(3 + CATEGORY_ORDER.length), `${totalItems} (${totalVariants})`, { center: true, bold: true });
+    }
+    // --- Dispositions ---
+    if (model.dispositions.length > 0) {
+        rowIdx += 1;
+        (0, xlsx_cells_1.dataCell)(ws.getRow(rowIdx).getCell(2), 'Not in the matrix (explicit dispositions)', { bold: true });
+        rowIdx += 1;
+        const dh = ws.getRow(rowIdx++);
+        ['Source', 'Disposition', 'Reason', 'Title'].forEach((l, i) => (0, xlsx_cells_1.headerCell)(dh.getCell(2 + i), l));
+        for (const d of model.dispositions) {
+            const row = ws.getRow(rowIdx++);
+            (0, xlsx_cells_1.dataCell)(row.getCell(2), d.vpId);
+            (0, xlsx_cells_1.dataCell)(row.getCell(3), d.as, { center: true });
+            (0, xlsx_cells_1.dataCell)(row.getCell(4), d.reason);
+            (0, xlsx_cells_1.dataCell)(row.getCell(5), d.title);
+        }
+    }
+    // --- Manifest ---
+    rowIdx += 1;
+    (0, xlsx_cells_1.dataCell)(ws.getRow(rowIdx).getCell(2), 'Generation manifest', { bold: true });
+    rowIdx += 1;
+    const m = model.manifest;
+    const manifestRows = [
+        ['Unit', m.unit],
+        ['Approval state', m.approvalState],
+        ['Delivery items', String(m.itemCount)],
+        ['Coverage variants', String(m.variantCount)],
+        ['Source fingerprint', m.sourceFingerprint],
+        ['Map fingerprint', m.mapFingerprint],
+        ['Transformer version', m.transformerVersion],
+        ['Max variants / item (warn)', String(m.thresholds.maxVariantsPerItem)],
+    ];
+    for (const [k, v] of manifestRows) {
+        const row = ws.getRow(rowIdx++);
+        (0, xlsx_cells_1.dataCell)(row.getCell(2), k, { bold: true, fill: xlsx_cells_1.SOFT_BLUE });
+        ws.mergeCells(rowIdx - 1, 3, rowIdx - 1, 7);
+        (0, xlsx_cells_1.dataCell)(row.getCell(3), v);
+    }
+}
+//# sourceMappingURL=render-coverage-sheet.js.map

package/dist/exporters/matrix/render-coverage-sheet.js.map

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

package/dist/exporters/matrix/render-overview-sheet.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Sheet 1 — Overview: the roll-up table over the Auto and Manual sheets.
+ *
+ * Thin adapter. The table itself is `addOverviewSheet` in the shared report
+ * builder — the same one the legacy path uses — so both delivery formats show
+ * the customer one identical summary. All this module does is turn the matrix
+ * model plus the per-sheet item projections into the summary shape it wants.
+ *
+ * Every count in that table is a LIVE reference into the detail sheet's band
+ * (`'Auto'!D7`), never a frozen number, so it recomputes when QA edits results.
+ */
+import * as ExcelJS from 'exceljs';
+import { DeliveryItem, MatrixModel } from './types';
+/** One detail sheet: its tab name and the items projected onto it. */
+export interface SheetProjection {
+    sheetName: string;
+    items: DeliveryItem[];
+}
+export declare function addMatrixOverviewSheet(wb: ExcelJS.Workbook, model: MatrixModel, sheets: SheetProjection[], sungenVersion?: string): void;
+//# sourceMappingURL=render-overview-sheet.d.ts.map

package/dist/exporters/matrix/render-overview-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-overview-sheet.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/render-overview-sheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEpD,sEAAsE;AACtE,MAAM,WAAW,eAAe;IAC9B,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB;AAuBD,wBAAgB,sBAAsB,CACpC,EAAE,EAAE,OAAO,CAAC,QAAQ,EACpB,KAAK,EAAE,WAAW,EAClB,MAAM,EAAE,eAAe,EAAE,EACzB,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAON"}

package/dist/exporters/matrix/render-overview-sheet.js

@@ -0,0 +1,36 @@
+"use strict";
+/**
+ * Sheet 1 — Overview: the roll-up table over the Auto and Manual sheets.
+ *
+ * Thin adapter. The table itself is `addOverviewSheet` in the shared report
+ * builder — the same one the legacy path uses — so both delivery formats show
+ * the customer one identical summary. All this module does is turn the matrix
+ * model plus the per-sheet item projections into the summary shape it wants.
+ *
+ * Every count in that table is a LIVE reference into the detail sheet's band
+ * (`'Auto'!D7`), never a frozen number, so it recomputes when QA edits results.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.addMatrixOverviewSheet = addMatrixOverviewSheet;
+const xlsx_report_builder_1 = require("../xlsx-report-builder");
+/**
+ * `total` counts VARIANTS only — parent rows are delivery items, not executable
+ * cases. It must match what the detail band's `C7=COUNTA(K14:K…)` counts, since
+ * a cached value and the live formula beside it have to tell one story. See
+ * `testcase-summary-band.ts` for why the count anchors on column K.
+ */
+function summaryOf(unit, items) {
+    const sum = (k) => items.reduce((a, i) => a + i.resultCounts[k], 0);
+    return {
+        screen: unit,
+        total: items.reduce((a, i) => a + i.variants.length, 0),
+        passed: sum('passed'),
+        failed: sum('failed'),
+        pending: sum('notRun'),
+        na: sum('na'),
+    };
+}
+function addMatrixOverviewSheet(wb, model, sheets, sungenVersion) {
+    (0, xlsx_report_builder_1.addOverviewSheet)(wb, sheets.map((s) => ({ sheetName: s.sheetName, summary: summaryOf(model.unit, s.items) })), sungenVersion, { titleLabel: `${model.unit.toUpperCase()} TEST CASE & COVERAGE MATRIX`, formNo: model.formNo });
+}
+//# sourceMappingURL=render-overview-sheet.js.map

package/dist/exporters/matrix/render-overview-sheet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-overview-sheet.js","sourceRoot":"","sources":["../../../src/exporters/matrix/render-overview-sheet.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;GAUG;;AAiCH,wDAYC;AA1CD,gEAA0D;AAS1D;;;;;GAKG;AACH,SAAS,SAAS,CAAC,IAAY,EAAE,KAAqB;IAGpD,MAAM,GAAG,GAAG,CAAC,CAAwC,EAAU,EAAE,CAC/D,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACnD,OAAO;QACL,MAAM,EAAE,IAAI;QACZ,KAAK,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QACvD,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC;QACrB,MAAM,EAAE,GAAG,CAAC,QAAQ,CAAC;QACrB,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC;QACtB,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC;KACd,CAAC;AACJ,CAAC;AAED,SAAgB,sBAAsB,CACpC,EAAoB,EACpB,KAAkB,EAClB,MAAyB,EACzB,aAAsB;IAEtB,IAAA,sCAAgB,EACd,EAAE,EACF,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,OAAO,EAAE,SAAS,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,EACxF,aAAa,EACb,EAAE,UAAU,EAAE,GAAG,KAAK,CAAC,IAAI,CAAC,WAAW,EAAE,8BAA8B,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAChG,CAAC;AACJ,CAAC"}

package/dist/exporters/matrix/render-testcase-sheet.d.ts

@@ -0,0 +1,30 @@
+/**
+ * One BM-2-901-13 testcase sheet of the matrix workbook (Auto or Manual).
+ *
+ * Layout is the company template, cell for cell: masthead rows 1-4, the summary
+ * band on rows 6/7/8, the `*: Mandatory` legend on row 12, the 16 column headers
+ * `A..P` on row 13, and data from row 14.
+ *
+ * Two row levels: one parent row per delivery item, each followed by its variant
+ * sub-rows on Excel outline level 1 — the sub-row is where source traceability
+ * (VP-id), test data and the manual result/evidence entry live (review B-05/B-06).
+ * Variant Result cells carry the state dropdown; the parent Result is a live
+ * formula over its children, so a parent can never contradict its variants even
+ * after QA edits results by hand.
+ */
+import * as ExcelJS from 'exceljs';
+import { DeliveryItem, MatrixModel } from './types';
+/** Column headers on row 13 — `A..P`, matching the template exactly. */
+export declare const TESTCASE_HEADERS: string[];
+export declare const HEADER_ROW = 13;
+/** Column L — the one the band's COUNTIFs and the parent roll-ups read. */
+export declare const RESULT_COL = 12;
+/**
+ * Append one testcase sheet holding `items` (already projected onto this sheet's
+ * execution mode). Always called for both Auto and Manual, even when one side is
+ * empty: Overview then always has exactly two rows, and QA has somewhere to add
+ * hand-written cases. An empty sheet's band reads 0 and its percentages resolve
+ * through IFERROR — never `#DIV/0!`.
+ */
+export declare function addTestcaseSheet(wb: ExcelJS.Workbook, sheetName: string, model: MatrixModel, items: DeliveryItem[], sungenVersion?: string): void;
+//# sourceMappingURL=render-testcase-sheet.d.ts.map

package/dist/exporters/matrix/render-testcase-sheet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-testcase-sheet.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/render-testcase-sheet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAKnC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAOpD,wEAAwE;AACxE,eAAO,MAAM,gBAAgB,UAK5B,CAAC;AAKF,eAAO,MAAM,UAAU,KAAK,CAAC;AAC7B,2EAA2E;AAC3E,eAAO,MAAM,UAAU,KAAK,CAAC;AAqE7B;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,EAAE,EAAE,OAAO,CAAC,QAAQ,EACpB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,WAAW,EAClB,KAAK,EAAE,YAAY,EAAE,EACrB,aAAa,CAAC,EAAE,MAAM,GACrB,IAAI,CAuDN"}

package/dist/exporters/matrix/render-testcase-sheet.js

@@ -0,0 +1,156 @@
+"use strict";
+/**
+ * One BM-2-901-13 testcase sheet of the matrix workbook (Auto or Manual).
+ *
+ * Layout is the company template, cell for cell: masthead rows 1-4, the summary
+ * band on rows 6/7/8, the `*: Mandatory` legend on row 12, the 16 column headers
+ * `A..P` on row 13, and data from row 14.
+ *
+ * Two row levels: one parent row per delivery item, each followed by its variant
+ * sub-rows on Excel outline level 1 — the sub-row is where source traceability
+ * (VP-id), test data and the manual result/evidence entry live (review B-05/B-06).
+ * Variant Result cells carry the state dropdown; the parent Result is a live
+ * formula over its children, so a parent can never contradict its variants even
+ * after QA edits results by hand.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RESULT_COL = exports.HEADER_ROW = exports.TESTCASE_HEADERS = void 0;
+exports.addTestcaseSheet = addTestcaseSheet;
+const xlsx_report_builder_1 = require("../xlsx-report-builder");
+const api_testcase_formatter_1 = require("../api-testcase-formatter");
+const playwright_report_parser_1 = require("../playwright-report-parser");
+const build_1 = require("./build");
+const xlsx_cells_1 = require("./xlsx-cells");
+const testcase_summary_band_1 = require("./testcase-summary-band");
+const item_labels_1 = require("./item-labels");
+/** Column headers on row 13 — `A..P`, matching the template exactly. */
+exports.TESTCASE_HEADERS = [
+    'ID*', 'Target', 'Test Intent / Condition', 'Category', 'Priority', 'Precondition',
+    'Coverage / Test Data', 'Action / Trigger*', 'Expected results*', 'Trace', 'Testcase type',
+    'Test Result*', 'Executed Date*', 'Test Executor*', 'Test Environment',
+    'Note\n(Test evidence, DefectID, Actual result)',
+];
+/** Column widths `A..P`, from the template (H widened — Action / Trigger is the longest cell). */
+const COLUMN_WIDTHS = [20, 12.5, 15.38, 16.25, 17, 25.51, 24.88, 50, 41, 12, 13.5, 15.88, 13.5, 16.5, 23, 29];
+exports.HEADER_ROW = 13;
+/** Column L — the one the band's COUNTIFs and the parent roll-ups read. */
+exports.RESULT_COL = 12;
+/** Variant sub-row — only what distinguishes it from its parent (review GAP-01). */
+function variantValues(item, v, model) {
+    return [
+        v.ref,
+        '',
+        v.condition,
+        '', '',
+        (0, item_labels_1.numbered)(item.preconditionDeltas[v.ref] ?? []),
+        (0, item_labels_1.numbered)(v.data),
+        // Only the steps after the parent's shared prefix, numbered so the parent's
+        // steps + these read as one continuous procedure.
+        (0, item_labels_1.numbered)(item.triggerDeltas[v.ref] ?? [], item.trigger.length + 1),
+        (0, item_labels_1.expectedWithVerification)(v.oracle, v.verification),
+        v.traces.join(', '),
+        (0, item_labels_1.variantTypeLabel)(v),
+        (0, build_1.variantState)(v),
+        (0, item_labels_1.isoDate)(v.result?.startTime),
+        '',
+        '',
+        // Redact BEFORE clipping — same denylist as the testcases CSV Note column.
+        v.result?.error ? (0, playwright_report_parser_1.clipNoteField)((0, api_testcase_formatter_1.redactSecrets)(String(v.result.error), model.secretValues)) : '',
+    ];
+}
+/**
+ * Live parent roll-up over the child Result cells — precedence
+ * failed → blocked → pending → partial → passed. N/A variants leave the
+ * denominator (review GAP-06): eff = n − COUNTIF(N/A); all-N/A → "All N/A".
+ * The range covers only the children present in THIS sheet, so a mixed item's
+ * two parent rows legitimately report two different numbers.
+ */
+function rollUpFormula(n, firstChild, lastChild) {
+    const rng = `L${firstChild}:L${lastChild}`;
+    const EFF = `(${n}-COUNTIF(${rng},"N/A"))`;
+    const NA = `IF(COUNTIF(${rng},"N/A")>0," · "&COUNTIF(${rng},"N/A")&" N/A","")`;
+    return (`IF(COUNTIF(${rng},"Failed")>0,COUNTIF(${rng},"Passed")&"/"&${EFF}&" Passed · "&COUNTIF(${rng},"Failed")&" Failed"&${NA},` +
+        `IF(COUNTIF(${rng},"Blocked")>0,COUNTIF(${rng},"Passed")&"/"&${EFF}&" Passed · "&COUNTIF(${rng},"Blocked")&" Blocked"&${NA},` +
+        `IF(${EFF}=0,"All N/A",` +
+        `COUNTIF(${rng},"Passed")&"/"&${EFF}&" Passed"&${NA})))`);
+}
+/** Parent row — only values genuinely COMMON to the whole item (review M-04). */
+function parentValues(item, formula) {
+    return [
+        item.id,
+        item.target,
+        item.intent,
+        item.category,
+        item.priority,
+        (0, item_labels_1.numbered)(item.precondition),
+        (0, item_labels_1.coverageSummary)(item),
+        // The shared leading steps; each variant's remaining steps sit on its sub-row.
+        (0, item_labels_1.numbered)(item.trigger),
+        item.oracle,
+        item.traces.join(', '),
+        // K (Testcase type) stays blank on a parent — it is not an executable case.
+        '',
+        { formula, result: (0, item_labels_1.itemResultLabel)(item) },
+        '',
+        '',
+        '',
+        item.review === 'proposed' ? 'REVIEW REQUIRED' : '',
+    ];
+}
+/**
+ * Append one testcase sheet holding `items` (already projected onto this sheet's
+ * execution mode). Always called for both Auto and Manual, even when one side is
+ * empty: Overview then always has exactly two rows, and QA has somewhere to add
+ * hand-written cases. An empty sheet's band reads 0 and its percentages resolve
+ * through IFERROR — never `#DIV/0!`.
+ */
+function addTestcaseSheet(wb, sheetName, model, items, sungenVersion) {
+    const ws = wb.addWorksheet(sheetName);
+    ws.properties.outlineLevelRow = 1;
+    ws.columns = COLUMN_WIDTHS.map((width) => ({ width }));
+    (0, xlsx_report_builder_1.renderReportHeaderBand)(wb, ws, `${model.unit.toUpperCase()} TEST CASE & COVERAGE MATRIX`, sungenVersion, model.formNo);
+    (0, xlsx_cells_1.draftBanner)(ws, model);
+    (0, testcase_summary_band_1.addSummaryBand)(ws, items);
+    const legend = ws.getCell('A12');
+    legend.value = '*: Mandatory';
+    legend.font = { italic: true, size: 10, name: xlsx_report_builder_1.ARIAL_FONT, color: { argb: 'FF808080' } };
+    const hr = ws.getRow(exports.HEADER_ROW);
+    hr.height = 38;
+    exports.TESTCASE_HEADERS.forEach((label, i) => (0, xlsx_cells_1.headerCell)(hr.getCell(1 + i), label));
+    let rowIdx = exports.HEADER_ROW + 1;
+    for (const item of items) {
+        const parentRowIdx = rowIdx++;
+        // Variant sub-rows FIRST — the parent's formula needs their cell range.
+        const firstChild = rowIdx;
+        for (const v of item.variants) {
+            const vr = ws.getRow(rowIdx++);
+            vr.outlineLevel = 1;
+            variantValues(item, v, model).forEach((val, i) => (0, xlsx_cells_1.dataCell)(vr.getCell(1 + i), val, { center: i === 10 }));
+            // Manual-execution entry: constrain the Result cell to the known states.
+            vr.getCell(exports.RESULT_COL).dataValidation = {
+                type: 'list', allowBlank: true, formulae: [`"${xlsx_cells_1.RESULT_STATES}"`],
+            };
+        }
+        const pr = ws.getRow(parentRowIdx);
+        const values = parentValues(item, rollUpFormula(item.variants.length, firstChild, rowIdx - 1));
+        values.forEach((v, i) => (0, xlsx_cells_1.dataCell)(pr.getCell(1 + i), v, {
+            bold: true,
+            fill: xlsx_cells_1.SOFT_BLUE,
+            center: i === 3 || i === 4,
+            ...(i === 15 && item.review === 'proposed' ? { color: xlsx_cells_1.DRAFT_RED } : {}),
+        }));
+    }
+    const lastRow = Math.max(rowIdx - 1, exports.HEADER_ROW);
+    ws.autoFilter = { from: { row: exports.HEADER_ROW, column: 1 }, to: { row: lastRow, column: 16 } };
+    ws.views = [{ state: 'frozen', xSplit: 0, ySplit: exports.HEADER_ROW }];
+    // Print: landscape, fit width only (never squash all rows into one page),
+    // repeat the masthead + band + header rows on every page (review GAP-08).
+    ws.pageSetup = {
+        orientation: 'landscape',
+        fitToPage: true,
+        fitToWidth: 1,
+        fitToHeight: 0,
+        printTitlesRow: `1:${exports.HEADER_ROW}`,
+    };
+}
+//# sourceMappingURL=render-testcase-sheet.js.map

package/dist/exporters/matrix/render-testcase-sheet.js.map

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

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

@@ -1,41 +1,51 @@
 /**
- * Render the Test Case & Coverage Matrix workbook.
+ * Render the Test Case & Coverage Matrix workbook (BM-2-901-13).
  *
- * Sheets:
- *   1. Testcases — one parent row per delivery item; EVERY item (including
- *      single-variant ones) carries variant sub-rows on Excel outline level 1 —
- *      the sub-row is where source traceability (VP-id), test data, and the
- *      manual result/evidence entry live (review B-05/B-06). Collapse outline
- *      level 1 for the customer/review view; expand to execute.
- *   2. Coverage — requirement coverage (id ↔ items ↔ status), the target ×
- *      category grid (explicit `—` gaps), dispositions, and the manifest.
+ * Four sheets, in this order:
+ *   1. Overview — one roll-up row per detail sheet, every cell a live reference
+ *      into that sheet's summary band.
+ *   2. Auto     — the cases the suite runs.
+ *   3. Manual   — the cases a person runs.
+ *   4. Coverage — requirement coverage, the target × category grid,
+ *      dispositions and the generation manifest, over the whole model.
  *
- * Manual-execution support: variant Result cells carry a dropdown
- * (Passed/Failed/Blocked/Pending/N/A) and the parent Result is a live Excel
- * formula derived from its children — a parent can never contradict its
- * variants, even after QA edits results by hand (review B-06).
- *
- * Every sheet keeps the company ISO masthead. A draft matrix (unapproved
- * groups / review findings) carries a red DRAFT banner.
+ * Auto and Manual are always both created, even when one side is empty: the
+ * Overview then always reads the same two rows, and QA has a place to add
+ * hand-written cases.
  */
 import * as ExcelJS from 'exceljs';
 import { DeliveryItem, MatrixModel } from './types';
-/** Mode is a coverage dimension: mixed items show both counts. */
-export declare function itemModeLabel(item: DeliveryItem): string;
-/**
- * Parent roll-up label. It must NEVER be exactly one of the variant state words
- * (`Passed`/`Failed`/`Blocked`/`Pending`/`N/A`) — the summary band counts the
- * Result column with exact-match COUNTIF over parent AND child rows, so a parent
- * reading plain "Pending" was counted as an extra pending variant (109 instead
- * of 77 on st-login).
- */
-export declare function itemResultLabel(item: DeliveryItem): string;
+export { itemModeLabel, itemResultLabel, coverageSummary } from './item-labels';
 /**
- * Compact coverage summary for the parent row. A declared `dimensions:` digest
- * wins ("15 variants — required ×3 · format ×9 …"); otherwise a single variant
- * shows its condition and a group falls back to its variant REFS. Concatenating
- * every variant's full title turned this cell into an 800-character paragraph.
+ * Project an item onto one execution mode.
+ *
+ * The split is per VARIANT, not per item: an automated variant belongs on the
+ * Auto sheet even when a sibling variant under the same delivery item has to be
+ * run by hand. A mixed item therefore appears on BOTH sheets, each side carrying
+ * only its own variants. The repeated parent row is deliberate — a variant must
+ * always be readable next to the delivery item it verifies.
+ *
+ * Only the fields that would otherwise LIE about the filtered set are recomputed.
+ *
+ *   `variants` / `resultCounts` / `result` — recounted over what survived.
+ *   `dimensions` — dropped on a partial split. The digest enumerates every
+ *     variant ("keyboard operation ×1 · announced name ×1"); with half of them on
+ *     the other sheet it would contradict the count beside it. Cleared, the
+ *     coverage cell falls back to the surviving variants' own words.
+ *   `trigger` — when the parent has no shared opening step, `build.ts` puts a
+ *     synthesized "run each of the N variants below" note there. N is regenerated
+ *     for this sheet; a genuine step prefix is left alone.
+ *
+ * Everything else is kept as it stands. A precondition or trigger prefix common
+ * to every variant is still common to a subset of them, so the parent stays
+ * true — the children just repeat marginally more than the strict minimum. The
+ * delta maps are keyed by `v.ref`, so each surviving variant still finds its own.
+ *
+ * This is a projection over an assembled model, not a second build: nothing in
+ * `build.ts` is re-run.
  */
-export declare function coverageSummary(item: DeliveryItem): string;
+export declare function projectItem(item: DeliveryItem, mode: 'auto' | 'manual'): DeliveryItem | null;
+/** Items projected onto one sheet, in model order. */
+export declare function projectItems(model: MatrixModel, mode: 'auto' | 'manual'): DeliveryItem[];
 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

@@ -1 +1 @@
-{"version":3,"file":"render-xlsx.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/render-xlsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAWnC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAe,MAAM,SAAS,CAAC;AA0BjE,kEAAkE;AAClE,wBAAgB,aAAa,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAMxD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAQ1D;AAgBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAM1D;AA+VD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAK7F"}
+{"version":3,"file":"render-xlsx.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/render-xlsx.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,OAAO,MAAM,SAAS,CAAC;AAEnC,OAAO,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAOpD,OAAO,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,GAAG,IAAI,CAY5F;AAED,sDAAsD;AACtD,wBAAgB,YAAY,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,GAAG,YAAY,EAAE,CAExF;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAW7F"}