@sun-asterisk/sungen 3.2.16-beta.7 → 3.2.17

package/dist/exporters/matrix/export.js

@@ -1,152 +0,0 @@
-"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 fingerprint_1 = require("./fingerprint");
-const build_1 = require("./build");
-const render_xlsx_1 = require("./render-xlsx");
-const render_csv_1 = require("./render-csv");
-function readSpecText(paths) {
-    return paths.specMdFile && fs.existsSync(paths.specMdFile)
-        ? fs.readFileSync(paths.specMdFile, 'utf-8')
-        : '';
-}
-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)(),
-        specText: readSpecText(paths),
-    });
-    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)(),
-        specText: readSpecText(paths),
-    });
-    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);
-    }
-    // Freeze the reviewed map semantics as well (GAP-09) — computed AFTER the
-    // review flips so re-running approve on an unchanged map is idempotent.
-    map.fingerprints.__map__ = (0, fingerprint_1.mapContentFingerprint)(map.groups, map.dispositions);
-    (0, map_loader_1.writeDeliveryMap)(paths.mapFile, map);
-    return { findings: model.findings.filter((f) => f.severity !== 'error'), approved };
-}
-/** Render + write the requested format(s). Caller has already enforced the gate policy. */
-async function writeMatrixDeliverables(paths, model, format = 'xlsx') {
-    const out = {};
-    if (format === 'csv' || format === 'both') {
-        out.csvPath = (0, csv_exporter_1.writeCsv)(paths.cwd, paths.unit, (0, render_csv_1.renderMatrixCsv)(model));
-    }
-    if (format === 'xlsx' || format === 'both') {
-        const wb = (0, render_xlsx_1.renderMatrixXlsx)(model, (0, package_info_1.getPackageVersion)());
-        out.xlsxPath = await (0, xlsx_exporter_1.writeXlsx)(paths.cwd, paths.unit, wb);
-    }
-    return out;
-}
-//# sourceMappingURL=export.js.map

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

@@ -1 +0,0 @@
-{"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

@@ -1,20 +0,0 @@
-/**
- * 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

@@ -1 +0,0 @@
-{"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

@@ -1,83 +0,0 @@
-"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

@@ -1 +0,0 @@
-{"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

@@ -1,21 +0,0 @@
-/**
- * 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

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

package/dist/exporters/matrix/gates.js

@@ -1,358 +0,0 @@
-"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 fingerprint_1 = require("./fingerprint");
-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);
-    gateWWording(ctx, findings);
-    gateKCategory(ctx, findings);
-    return findings;
-}
-// --- Gate K — category vs the source viewpoint class -------------------------
-/** VP prefixes whose category is not a judgement call — the source decides it. */
-const VP_CATEGORY_RULE = [
-    ['SEC', 'security'],
-    ['NFR', 'nfr'],
-];
-/**
- * A `VP-SEC-*` scenario filed under `normal`/`abnormal` empties the Coverage
- * sheet's `security` column — the grid then reports a gap the unit does not
- * have while hiding the security work it does have. Same for `VP-NFR-*`.
- * (normal vs abnormal stays a judgement call and is never checked.)
- */
-function gateKCategory(ctx, findings) {
-    for (const g of ctx.inputs.map.groups) {
-        const vs = g.variants.flatMap((ref) => (0, build_1.expandMapRef)(ref, ctx.variantsByVp));
-        for (const [prefix, expected] of VP_CATEGORY_RULE) {
-            const hits = vs.filter((v) => v.vpCategory === prefix);
-            if (hits.length > 0 && g.category !== expected) {
-                findings.push({
-                    gate: 'K', severity: 'warning', ref: g.id,
-                    message: `group ${g.id} is \`category: ${g.category}\` but ${hits.length}/${vs.length} of its variants are VP-${prefix}-* (${hits.slice(0, 3).map((v) => v.vpId).join(', ')}) — use \`category: ${expected}\` or the Coverage grid's ${expected} column stays empty`,
-                });
-            }
-        }
-    }
-}
-// --- 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.
-        // Execution mode and priority are deliberately NOT here: they are coverage
-        // dimensions (account states may need seeded manual variants next to auto ones;
-        // an item takes the highest variant priority) — shown per variant, never split on.
-        const hard = [
-            ['test layer', (v) => [...v.layers].sort().join('+')],
-        ];
-        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`,
-                });
-            }
-        }
-    }
-    // No template token may survive into a RENDERED cell (review B-04) — this also
-    // catches cross-referencing test-data values the one-level resolver couldn't close.
-    for (const [, vs] of variantsByVp) {
-        for (const v of vs) {
-            const rendered = [...v.precondition, ...v.trigger, ...v.oracle, ...v.verification, ...v.data];
-            const token = rendered.map((t) => t.match(/\{\{[^}]*\}\}/)).find(Boolean);
-            if (token) {
-                findings.push({
-                    gate: 'D', severity: 'error', ref: v.ref,
-                    message: `${v.ref}: unresolved template token ${token[0]} remains in the rendered output — the export is not deterministic for a tester`,
-                });
-            }
-        }
-    }
-}
-// --- Gate E — drift (stale approval) ------------------------------------------
-function gateEDrift(ctx, findings) {
-    const { map } = ctx.inputs;
-    const { variantsByVp } = ctx;
-    // The map's own semantics (targets/intents/oracles/grouping) are part of what
-    // was approved — an edit after approval must be re-reviewed, not silently
-    // published (review GAP-09).
-    const stampedMap = map.fingerprints.__map__;
-    const liveMap = (0, fingerprint_1.mapContentFingerprint)(map.groups, map.dispositions);
-    if (map.groups.some((g) => g.review === 'approved')) {
-        if (!stampedMap) {
-            findings.push({
-                gate: 'E', severity: 'review',
-                message: 'the delivery map has no stamped content fingerprint — run `sungen delivery --approve` to record the reviewed wording',
-            });
-        }
-        else if (stampedMap !== liveMap) {
-            findings.push({
-                gate: 'E', severity: 'review',
-                message: 'the delivery map wording/grouping changed since approval — re-review, then `sungen delivery --approve`',
-            });
-        }
-    }
-    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 W — controlled-language lint on the map's semantic fields --------------
-/** Patterns that make customer-facing wording read machine-generated (review §10). */
-const WORDING_SMELLS = [
-    [/\{\{[^}]*\}\}/, 'an unresolved {{token}}'],
-    [/\b(?:Setup|Observable|Oracle):/, 'a generator label (Setup:/Observable:/Oracle:)'],
-    [/\bUser (?:fill|click|press|see|wait)\b/i, 'DSL phrasing ("User fill/click/see…") — write plain product language'],
-    [/\[[^\]]+\]/, 'a [selector-style] reference — use the visible UI label'],
-];
-function gateWWording(ctx, findings) {
-    for (const g of ctx.inputs.map.groups) {
-        const variantCount = g.variants.flatMap((ref) => (0, build_1.expandMapRef)(ref, ctx.variantsByVp)).length;
-        // Without a digest the parent row can only list variant refs — a reviewer
-        // then has to expand the item to learn which dimensions it covers.
-        if (variantCount > 3 && !g.dimensions) {
-            findings.push({
-                gate: 'W', severity: 'warning', ref: g.id,
-                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`,
-            });
-        }
-        if (g.dimensions && g.dimensions.length > 120) {
-            findings.push({
-                gate: 'W', severity: 'warning', ref: g.id,
-                message: `group ${g.id} \`dimensions:\` is ${g.dimensions.length} chars — keep the digest short (≤120)`,
-            });
-        }
-        for (const [field, text] of [['intent', g.intent], ['oracle', g.oracle], ...(g.dimensions ? [['dimensions', g.dimensions]] : [])]) {
-            for (const [re, what] of WORDING_SMELLS) {
-                if (re.test(text)) {
-                    findings.push({
-                        gate: 'W', severity: 'warning', ref: g.id,
-                        message: `group ${g.id} ${field} contains ${what}`,
-                    });
-                }
-            }
-        }
-    }
-}
-// --- 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