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

package/dist/exporters/matrix/build.js

@@ -0,0 +1,267 @@
+"use strict";
+/**
+ * Build the matrix model: derive atomic coverage variants from the merged
+ * feature/spec view, assemble delivery items per the Delivery Map, attach
+ * per-variant Playwright results, and roll parents up (derived only — Gate F
+ * is structural: there is no independent parent result input).
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.deriveVariants = deriveVariants;
+exports.rollUp = rollUp;
+exports.expandMapRef = expandMapRef;
+exports.buildMatrix = buildMatrix;
+const scenario_merger_1 = require("../scenario-merger");
+const feature_parser_1 = require("../feature-parser");
+const result_variants_1 = require("../result-variants");
+const test_data_resolver_1 = require("../test-data-resolver");
+const fingerprint_1 = require("./fingerprint");
+const types_1 = require("./types");
+const gates_1 = require("./gates");
+// ---------------------------------------------------------------------------
+// Variant derivation
+// ---------------------------------------------------------------------------
+/** Collapse `{{var}}` placeholders so data values become parameters, not shape. */
+function normalizeShape(text) {
+    return text.replace(/\{\{[^}]*\}\}/g, '{{*}}').replace(/\s+/g, ' ').trim();
+}
+function deriveLayers(tags) {
+    const layers = new Set(['ui']);
+    if (tags.some((t) => t === '@api' || t.startsWith('@api:') || t === '@requires:api'))
+        layers.add('api');
+    if (tags.some((t) => t.startsWith('@query') || t === '@requires:db'))
+        layers.add('db');
+    return Array.from(layers);
+}
+/** 'simple' single G*→W*→T* pass; 'sequence' when the flow re-enters Given/When after a Then. */
+function deriveProcedureProfile(m) {
+    if ((0, feature_parser_1.extractTestcaseType)(m.feature.tags) === 'Manual')
+        return 'manual';
+    const order = m.feature.orderedSteps.map((s) => s.bucket);
+    let seenThen = false;
+    for (const bucket of order) {
+        if (bucket === 'then')
+            seenThen = true;
+        else if (seenThen)
+            return 'sequence'; // action/setup after an assertion → ordered flow
+    }
+    return 'simple';
+}
+function manualReason(tags) {
+    const t = tags.find((x) => x.startsWith('@manual:'));
+    return t ? t.slice('@manual:'.length) : undefined;
+}
+/** Resolve `{{var}}` refs of a scenario into display `key: value` pairs. */
+function resolveDataPairs(vars, testData, row) {
+    const pairs = [];
+    if (row) {
+        for (const [k, v] of Object.entries(row)) {
+            if (k.startsWith('__') || k === 'case' || k === 'name' || k === 'label')
+                continue;
+            pairs.push(`${k}: ${String(v)}`);
+        }
+    }
+    for (const v of vars) {
+        const val = row && v in row ? undefined : testData?.[v]; // row columns already listed
+        if (val !== undefined)
+            pairs.push(`${v}: ${val}`);
+    }
+    return pairs;
+}
+/**
+ * Derive every atomic coverage variant of the unit (one per scenario, or one per
+ * `@cases` dataset row). Exported separately so the gates + the map-proposal
+ * support tooling see the same universe the builder does.
+ */
+function deriveVariants(inputs) {
+    const { merged, testData, results } = inputs;
+    const variants = [];
+    for (const m of merged) {
+        const { vpId, category1 } = (0, feature_parser_1.splitVpAndName)(m.feature.name);
+        if (!vpId)
+            continue; // Gate A reports it — no variant can be addressed without a VP-id
+        const tags = m.feature.tags;
+        const mode = (0, feature_parser_1.extractTestcaseType)(tags) === 'Manual' ? 'manual' : 'auto';
+        const authRole = (0, feature_parser_1.extractAuthRole)(tags);
+        const vpCategory = vpId.replace(/^VP-/, '').replace(/-\d+[a-zA-Z]?$/, '');
+        // Manual procedure comes from the parsed comment block; auto from Gherkin buckets.
+        const manual = mode === 'manual' && m.feature.comments?.length
+            ? (0, scenario_merger_1.parseManualComments)(m.feature.comments)
+            : null;
+        // A pure-render check (Given + Then only) is triggered by the page load itself —
+        // that IS its action, not a Gate-D executability gap.
+        const rawTrigger = manual ? manual.steps.map((s) => s.text) : m.feature.rawWhenSteps;
+        const triggerSteps = rawTrigger.length > 0 ? rawTrigger : ['(on page load)'];
+        const oracleSteps = m.resolvedExpected.map((s) => s.text);
+        const preconditionProfile = [
+            authRole ?? '-',
+            m.feature.extendsName ?? '-',
+            ...m.feature.rawGivenSteps.map(normalizeShape),
+        ].join(' | ');
+        const precondition = [
+            ...(authRole ? [authRole === 'no-auth' ? 'Not authenticated' : `Authenticated as ${authRole}`] : []),
+            ...m.feature.rawGivenSteps,
+        ];
+        const base = {
+            vpId,
+            vpCategory,
+            priority: (0, feature_parser_1.extractPriority)(tags),
+            mode: mode,
+            manualReason: manualReason(tags),
+            layers: deriveLayers(tags),
+            traces: tags.filter((t) => t.startsWith('@spec:')).map((t) => t.slice('@spec:'.length)),
+            triggerShape: triggerSteps.map(normalizeShape),
+            oracleShape: oracleSteps.map(normalizeShape),
+            preconditionProfile,
+            precondition,
+            procedureProfile: deriveProcedureProfile(m),
+        };
+        const rows = (0, result_variants_1.getCasesDatasetRows)(m, testData ?? undefined);
+        if (rows) {
+            // One variant per dataset row; results matched per row label by the shared resolver.
+            const resultVariants = (0, result_variants_1.resolveResultVariants)(m, results ?? null, testData ?? undefined);
+            const resultByLabel = new Map(resultVariants.map((rv) => [rv.nameSuffix.replace(/^ — /, ''), rv.result]));
+            rows.forEach((row, i) => {
+                const label = String(row.case ?? row.name ?? row.label ?? `row ${i + 1}`);
+                variants.push({
+                    ...base,
+                    ref: `${vpId}#${label}`,
+                    caseLabel: label,
+                    title: `${category1} — ${label}`,
+                    condition: label,
+                    data: resolveDataPairs(m.feature.referencedVars, testData, row),
+                    trigger: triggerSteps.map((s) => (0, test_data_resolver_1.substituteTestDataVars)(s, { ...(testData ?? {}), ...rowAsStrings(row) })),
+                    oracle: oracleSteps.map((s) => (0, test_data_resolver_1.substituteTestDataVars)(s, { ...(testData ?? {}), ...rowAsStrings(row) })),
+                    fingerprint: (0, fingerprint_1.scenarioFingerprint)(m.feature, row),
+                    result: resultByLabel.get(label),
+                });
+            });
+        }
+        else {
+            variants.push({
+                ...base,
+                ref: vpId,
+                title: category1,
+                condition: category1,
+                data: resolveDataPairs(m.feature.referencedVars, testData),
+                trigger: triggerSteps.map((s) => (0, test_data_resolver_1.substituteTestDataVars)(s, testData ?? {})),
+                oracle: oracleSteps.map((s) => (0, test_data_resolver_1.substituteTestDataVars)(s, testData ?? {})),
+                fingerprint: (0, fingerprint_1.scenarioFingerprint)(m.feature),
+                result: (0, result_variants_1.resolveResultVariants)(m, results ?? null, testData ?? undefined)[0]?.result,
+            });
+        }
+    }
+    return variants;
+}
+function rowAsStrings(row) {
+    const out = {};
+    for (const [k, v] of Object.entries(row))
+        out[k] = String(v);
+    return out;
+}
+// ---------------------------------------------------------------------------
+// Item assembly + roll-up
+// ---------------------------------------------------------------------------
+function classifyResult(r) {
+    if (!r)
+        return 'notRun';
+    if (r.status === 'passed')
+        return 'passed';
+    if (r.status === 'failed' || r.status === 'timedOut')
+        return 'failed';
+    if (r.status === 'interrupted')
+        return 'blocked';
+    return 'notRun'; // skipped / unknown
+}
+/** Derived parent result — precedence: failed → blocked → not_run → partial → passed. */
+function rollUp(variants) {
+    const counts = { passed: 0, failed: 0, blocked: 0, notRun: 0 };
+    for (const v of variants)
+        counts[classifyResult(v.result)]++;
+    const run = counts.passed + counts.failed + counts.blocked;
+    let result;
+    if (counts.failed > 0)
+        result = 'failed';
+    else if (counts.blocked > 0)
+        result = 'blocked';
+    else if (run === 0)
+        result = 'not_run';
+    else if (counts.notRun > 0)
+        result = 'partial';
+    else
+        result = 'passed';
+    return { result, counts };
+}
+/**
+ * Expand one map variant ref to concrete variant refs:
+ * a bare VP-id whose scenario has a dataset means ALL its rows.
+ */
+function expandMapRef(ref, variantsByVp) {
+    if (ref.includes('#')) {
+        const [vp] = ref.split('#');
+        return (variantsByVp.get(vp) ?? []).filter((v) => v.ref === ref);
+    }
+    return variantsByVp.get(ref) ?? [];
+}
+function buildMatrix(inputs) {
+    const { unit, map, transformerVersion } = inputs;
+    const variants = deriveVariants(inputs);
+    const variantsByVp = new Map();
+    for (const v of variants) {
+        const list = variantsByVp.get(v.vpId) ?? [];
+        list.push(v);
+        variantsByVp.set(v.vpId, list);
+    }
+    const findings = (0, gates_1.runGates)({ inputs, variants, variantsByVp });
+    const stale = new Set(findings.filter((f) => f.gate === 'E' && f.ref).map((f) => f.ref));
+    const items = map.groups.map((g) => {
+        const groupVariants = g.variants.flatMap((ref) => expandMapRef(ref, variantsByVp));
+        const { result, counts } = rollUp(groupVariants);
+        const first = groupVariants[0];
+        const triggerShapes = new Set(groupVariants.map((v) => v.triggerShape.join(' ; ')));
+        return {
+            id: g.id,
+            target: g.target,
+            intent: g.intent,
+            oracle: g.oracle,
+            category: g.category,
+            // A stale (drifted) group presents as proposed regardless of its stored state.
+            review: stale.has(g.id) ? 'proposed' : g.review,
+            priority: first?.priority ?? 'Normal',
+            mode: first?.mode ?? 'auto',
+            layers: Array.from(new Set(groupVariants.flatMap((v) => v.layers))),
+            traces: Array.from(new Set(groupVariants.flatMap((v) => v.traces))),
+            precondition: first?.precondition ?? [],
+            trigger: triggerShapes.size === 1 ? (first?.trigger ?? []) : ['(per variant)'],
+            variants: groupVariants,
+            result,
+            resultCounts: counts,
+        };
+    });
+    const dispositions = Object.entries(map.dispositions).map(([vpId, d]) => ({
+        vpId,
+        title: variantsByVp.get(vpId)?.[0]?.title ?? '',
+        as: d.as,
+        reason: d.reason ?? '',
+    }));
+    const variantCount = items.reduce((a, i) => a + i.variants.length, 0);
+    const approved = items.every((i) => i.review === 'approved')
+        && !findings.some((f) => f.severity === 'error' || f.severity === 'review');
+    return {
+        unit,
+        formNo: map.formNo ?? 'BM-2-901-13',
+        items,
+        dispositions,
+        findings,
+        manifest: {
+            unit,
+            transformerVersion,
+            sourceFingerprint: (0, fingerprint_1.combinedFingerprint)(variants.map((v) => v.fingerprint)),
+            mapFingerprint: (0, fingerprint_1.mapContentFingerprint)(map.groups, map.dispositions),
+            approvalState: approved ? 'approved' : 'draft',
+            itemCount: items.length,
+            variantCount,
+            thresholds: { maxVariantsPerItem: types_1.MAX_VARIANTS_PER_ITEM },
+        },
+    };
+}
+//# sourceMappingURL=build.js.map

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

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

package/dist/exporters/matrix/export.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Matrix export orchestration — the piece `sungen delivery` calls.
+ *
+ * Composes the existing parsing seams (feature-parser, spec-parser, test-data,
+ * playwright report) with the map loader, builder, gates, and renderers. All
+ * inputs arrive as resolved paths so the CLI's discovery logic stays the single
+ * owner of unit-kind layout rules.
+ */
+import { DeliveryMap, MatrixFinding, MatrixModel } from './types';
+export interface MatrixTargetPaths {
+    cwd: string;
+    /** Feature basename — names the deliverable files. */
+    unit: string;
+    /** Display label (flow/… prefix for flows). */
+    label: string;
+    featureFile: string;
+    testDataFile: string;
+    specFile: string;
+    resultsPath: string | null;
+    mapFile: string;
+}
+export interface MatrixLoadResult {
+    model?: MatrixModel;
+    map?: DeliveryMap;
+    /** No map file → the caller prints the guidance path (AI proposal or --legacy). */
+    mapMissing?: boolean;
+    /** Structural map problems (bad YAML/shape) — fix the file before anything else. */
+    mapErrors: string[];
+}
+export declare function loadMatrixModel(paths: MatrixTargetPaths): MatrixLoadResult;
+export declare const hasErrors: (f: MatrixFinding[]) => boolean;
+export declare const hasReview: (f: MatrixFinding[]) => boolean;
+/**
+ * Stamp fingerprints + flip groups to `approved` (all groups, or just `groupIds`).
+ * Refuses when gate ERRORs remain — an invalid map must not be frozen as approved.
+ * Returns the findings so the caller reports what blocked or what was approved.
+ */
+export declare function approveMatrix(paths: MatrixTargetPaths, groupIds?: string[]): {
+    findings: MatrixFinding[];
+    approved: string[];
+};
+/** Render + write both artifacts. Caller has already enforced the gate policy. */
+export declare function writeMatrixDeliverables(paths: MatrixTargetPaths, model: MatrixModel): Promise<{
+    csvPath: string;
+    xlsxPath: string;
+}>;
+//# sourceMappingURL=export.d.ts.map

package/dist/exporters/matrix/export.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"export.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/export.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH,OAAO,EAAE,WAAW,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,sDAAsD;IACtD,IAAI,EAAE,MAAM,CAAC;IACb,+CAA+C;IAC/C,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,GAAG,CAAC,EAAE,WAAW,CAAC;IAClB,mFAAmF;IACnF,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,oFAAoF;IACpF,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,iBAAiB,GAAG,gBAAgB,CAsB1E;AAED,eAAO,MAAM,SAAS,GAAI,GAAG,aAAa,EAAE,KAAG,OAAgD,CAAC;AAChG,eAAO,MAAM,SAAS,GAAI,GAAG,aAAa,EAAE,KAAG,OAAiD,CAAC;AAEjG;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,iBAAiB,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,GAAG;IAAE,QAAQ,EAAE,aAAa,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,EAAE,CAAA;CAAE,CAqC9H;AAED,kFAAkF;AAClF,wBAAsB,uBAAuB,CAAC,KAAK,EAAE,iBAAiB,EAAE,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAK1I"}

package/dist/exporters/matrix/export.js

@@ -0,0 +1,136 @@
+"use strict";
+/**
+ * Matrix export orchestration — the piece `sungen delivery` calls.
+ *
+ * Composes the existing parsing seams (feature-parser, spec-parser, test-data,
+ * playwright report) with the map loader, builder, gates, and renderers. All
+ * inputs arrive as resolved paths so the CLI's discovery logic stays the single
+ * owner of unit-kind layout rules.
+ */
+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.hasReview = exports.hasErrors = void 0;
+exports.loadMatrixModel = loadMatrixModel;
+exports.approveMatrix = approveMatrix;
+exports.writeMatrixDeliverables = writeMatrixDeliverables;
+const fs = __importStar(require("fs"));
+const feature_parser_1 = require("../feature-parser");
+const spec_parser_1 = require("../spec-parser");
+const test_data_resolver_1 = require("../test-data-resolver");
+const playwright_report_parser_1 = require("../playwright-report-parser");
+const scenario_merger_1 = require("../scenario-merger");
+const package_info_1 = require("../package-info");
+const csv_exporter_1 = require("../csv-exporter");
+const xlsx_exporter_1 = require("../xlsx-exporter");
+const map_loader_1 = require("./map-loader");
+const build_1 = require("./build");
+const render_xlsx_1 = require("./render-xlsx");
+const render_csv_1 = require("./render-csv");
+function loadMatrixModel(paths) {
+    const { map, errors } = (0, map_loader_1.loadDeliveryMap)(paths.mapFile);
+    if (!map) {
+        return errors.length === 0 ? { mapMissing: true, mapErrors: [] } : { mapErrors: errors };
+    }
+    const feature = (0, feature_parser_1.parseFeatureMetadata)(paths.featureFile);
+    const spec = (0, spec_parser_1.parseSpecFile)(paths.specFile);
+    const merged = (0, scenario_merger_1.mergeFeatureAndSpec)(feature, spec);
+    const testData = fs.existsSync(paths.testDataFile) ? (0, test_data_resolver_1.loadTestData)(paths.testDataFile, process.env.SUNGEN_ENV ?? null) : null;
+    const results = paths.resultsPath ? (0, playwright_report_parser_1.loadPlaywrightReport)(paths.resultsPath) : null;
+    const model = (0, build_1.buildMatrix)({
+        unit: paths.unit,
+        feature,
+        merged,
+        testData,
+        results,
+        map,
+        transformerVersion: (0, package_info_1.getPackageVersion)(),
+    });
+    return { model, map, mapErrors: [] };
+}
+const hasErrors = (f) => f.some((x) => x.severity === 'error');
+exports.hasErrors = hasErrors;
+const hasReview = (f) => f.some((x) => x.severity === 'review');
+exports.hasReview = hasReview;
+/**
+ * Stamp fingerprints + flip groups to `approved` (all groups, or just `groupIds`).
+ * Refuses when gate ERRORs remain — an invalid map must not be frozen as approved.
+ * Returns the findings so the caller reports what blocked or what was approved.
+ */
+function approveMatrix(paths, groupIds) {
+    const { map, errors } = (0, map_loader_1.loadDeliveryMap)(paths.mapFile);
+    if (!map)
+        throw new Error(errors.length > 0 ? `map is invalid:\n  - ${errors.join('\n  - ')}` : `no delivery map at ${paths.mapFile}`);
+    const feature = (0, feature_parser_1.parseFeatureMetadata)(paths.featureFile);
+    const spec = (0, spec_parser_1.parseSpecFile)(paths.specFile);
+    const merged = (0, scenario_merger_1.mergeFeatureAndSpec)(feature, spec);
+    const testData = fs.existsSync(paths.testDataFile) ? (0, test_data_resolver_1.loadTestData)(paths.testDataFile, process.env.SUNGEN_ENV ?? null) : null;
+    const model = (0, build_1.buildMatrix)({
+        unit: paths.unit, feature, merged, testData, results: null, map,
+        transformerVersion: (0, package_info_1.getPackageVersion)(),
+    });
+    const blocking = model.findings.filter((f) => f.severity === 'error');
+    if (blocking.length > 0)
+        return { findings: blocking, approved: [] };
+    const variants = (0, build_1.deriveVariants)({ feature, merged, testData, results: null });
+    const byRef = new Map(variants.map((v) => [v.ref, v]));
+    const byVp = new Map();
+    for (const v of variants) {
+        const list = byVp.get(v.vpId) ?? [];
+        list.push(v);
+        byVp.set(v.vpId, list);
+    }
+    const approved = [];
+    for (const g of map.groups) {
+        if (groupIds && groupIds.length > 0 && !groupIds.includes(g.id))
+            continue;
+        for (const ref of g.variants) {
+            const expanded = ref.includes('#') ? [byRef.get(ref)].filter(Boolean) : (byVp.get(ref) ?? []);
+            for (const v of expanded)
+                map.fingerprints[v.ref] = v.fingerprint;
+        }
+        g.review = 'approved';
+        approved.push(g.id);
+    }
+    (0, map_loader_1.writeDeliveryMap)(paths.mapFile, map);
+    return { findings: model.findings.filter((f) => f.severity !== 'error'), approved };
+}
+/** Render + write both artifacts. Caller has already enforced the gate policy. */
+async function writeMatrixDeliverables(paths, model) {
+    const csvPath = (0, csv_exporter_1.writeCsv)(paths.cwd, paths.unit, (0, render_csv_1.renderMatrixCsv)(model));
+    const wb = (0, render_xlsx_1.renderMatrixXlsx)(model, (0, package_info_1.getPackageVersion)());
+    const xlsxPath = await (0, xlsx_exporter_1.writeXlsx)(paths.cwd, paths.unit, wb);
+    return { csvPath, xlsxPath };
+}
+//# sourceMappingURL=export.js.map

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

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

package/dist/exporters/matrix/fingerprint.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Canonical scenario fingerprints for the Delivery Map drift detector (Gate E).
+ *
+ * A fingerprint hashes what changes the MEANING of a variant: sorted tags + ordered
+ * step text (+ the dataset row for a @cases variant). Formatting, comments, and
+ * scenario order do NOT change it. `--approve` stamps these into the map; a later
+ * mismatch drops the group back to review (stale grouping).
+ */
+import { ScenarioMetadata } from '../types';
+/**
+ * Fingerprint one scenario. Tags are sorted (order is presentation); steps keep
+ * their order (order is meaning). Manual scenarios include their procedure
+ * comments — for them the comments ARE the test.
+ */
+export declare function scenarioFingerprint(sc: ScenarioMetadata, datasetRow?: Record<string, unknown>): string;
+/** Fingerprint of the whole source (all variants) — manifest `sourceFingerprint`. */
+export declare function combinedFingerprint(parts: string[]): string;
+/** Fingerprint of the map's semantic content (groups + dispositions, not stamps). */
+export declare function mapContentFingerprint(groups: unknown, dispositions: unknown): string;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/exporters/matrix/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAe5C;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,EAAE,gBAAgB,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAQtG;AAED,qFAAqF;AACrF,wBAAgB,mBAAmB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,MAAM,CAE3D;AAED,qFAAqF;AACrF,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,OAAO,GAAG,MAAM,CAEpF"}

package/dist/exporters/matrix/fingerprint.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * Canonical scenario fingerprints for the Delivery Map drift detector (Gate E).
+ *
+ * A fingerprint hashes what changes the MEANING of a variant: sorted tags + ordered
+ * step text (+ the dataset row for a @cases variant). Formatting, comments, and
+ * scenario order do NOT change it. `--approve` stamps these into the map; a later
+ * mismatch drops the group back to review (stale grouping).
+ */
+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.scenarioFingerprint = scenarioFingerprint;
+exports.combinedFingerprint = combinedFingerprint;
+exports.mapContentFingerprint = mapContentFingerprint;
+const crypto = __importStar(require("crypto"));
+/** Stable stringify: objects get sorted keys so row column order can't shift the hash. */
+function canonical(value) {
+    if (value === null || typeof value !== 'object')
+        return JSON.stringify(value);
+    if (Array.isArray(value))
+        return `[${value.map(canonical).join(',')}]`;
+    const obj = value;
+    const keys = Object.keys(obj).sort();
+    return `{${keys.map((k) => `${JSON.stringify(k)}:${canonical(obj[k])}`).join(',')}}`;
+}
+function sha1(text) {
+    return 'sha1:' + crypto.createHash('sha1').update(text, 'utf-8').digest('hex');
+}
+/**
+ * Fingerprint one scenario. Tags are sorted (order is presentation); steps keep
+ * their order (order is meaning). Manual scenarios include their procedure
+ * comments — for them the comments ARE the test.
+ */
+function scenarioFingerprint(sc, datasetRow) {
+    const body = canonical({
+        tags: [...sc.tags].sort(),
+        steps: sc.orderedSteps.map((s) => `${s.bucket}:${s.text}`),
+        comments: sc.tags.some((t) => t === '@manual' || t.startsWith('@manual:')) ? (sc.comments ?? []) : [],
+        row: datasetRow ?? null,
+    });
+    return sha1(body);
+}
+/** Fingerprint of the whole source (all variants) — manifest `sourceFingerprint`. */
+function combinedFingerprint(parts) {
+    return sha1(canonical([...parts].sort()));
+}
+/** Fingerprint of the map's semantic content (groups + dispositions, not stamps). */
+function mapContentFingerprint(groups, dispositions) {
+    return sha1(canonical({ groups, dispositions }));
+}
+//# sourceMappingURL=fingerprint.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../../src/exporters/matrix/fingerprint.ts"],"names":[],"mappings":";AAAA;;;;;;;GAOG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuBH,kDAQC;AAGD,kDAEC;AAGD,sDAEC;AAvCD,+CAAiC;AAGjC,0FAA0F;AAC1F,SAAS,SAAS,CAAC,KAAc;IAC/B,IAAI,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC9E,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;IACvE,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACrC,OAAO,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;AACvF,CAAC;AAED,SAAS,IAAI,CAAC,IAAY;IACxB,OAAO,OAAO,GAAG,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AACjF,CAAC;AAED;;;;GAIG;AACH,SAAgB,mBAAmB,CAAC,EAAoB,EAAE,UAAoC;IAC5F,MAAM,IAAI,GAAG,SAAS,CAAC;QACrB,IAAI,EAAE,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE;QACzB,KAAK,EAAE,EAAE,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE;QACrG,GAAG,EAAE,UAAU,IAAI,IAAI;KACxB,CAAC,CAAC;IACH,OAAO,IAAI,CAAC,IAAI,CAAC,CAAC;AACpB,CAAC;AAED,qFAAqF;AACrF,SAAgB,mBAAmB,CAAC,KAAe;IACjD,OAAO,IAAI,CAAC,SAAS,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AAC5C,CAAC;AAED,qFAAqF;AACrF,SAAgB,qBAAqB,CAAC,MAAe,EAAE,YAAqB;IAC1E,OAAO,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;AACnD,CAAC"}

package/dist/exporters/matrix/gates.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 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).
+ */
+import { CoverageVariant, MatrixFinding } from './types';
+import { BuildInputs } from './build';
+export interface GateContext {
+    inputs: BuildInputs;
+    variants: CoverageVariant[];
+    variantsByVp: Map<string, CoverageVariant[]>;
+}
+export declare function runGates(ctx: GateContext): MatrixFinding[];
+//# sourceMappingURL=gates.d.ts.map

package/dist/exporters/matrix/gates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gates.d.ts","sourceRoot":"","sources":["../../../src/exporters/matrix/gates.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAGH,OAAO,EAAE,eAAe,EAAE,aAAa,EAAyB,MAAM,SAAS,CAAC;AAChF,OAAO,EAAgB,WAAW,EAAE,MAAM,SAAS,CAAC;AAEpD,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;CAC9C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,aAAa,EAAE,CAS1D"}