@sun-asterisk/sungen 3.2.17 → 3.2.18

package/dist/exporters/matrix/export.js

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

@@ -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;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"}