@sun-asterisk/sungen 3.2.35 → 3.3.0-alpha.10

package/dist/graph/unit-artifact-probes.js

@@ -0,0 +1,135 @@
+"use strict";
+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.readIfExists = exports.RESULT_FILE = void 0;
+exports.countScenarios = countScenarios;
+exports.hasResolvedSelector = hasResolvedSelector;
+exports.generatedDirs = generatedDirs;
+exports.isCompiled = isCompiled;
+exports.unitResultFiles = unitResultFiles;
+exports.countFailedResults = countFailedResults;
+exports.hasDeliverableFor = hasDeliverableFor;
+/**
+ * What a unit holds on disk, probed cheaply for `readUnitState` and `testCaseStates` (moved out of
+ * harness/next-step.ts unchanged). Every path here is legitimately absent at some point in a unit's
+ * life — the resolver exists to report exactly that — so nothing throws on a missing file.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml_1 = require("yaml");
+const unit_paths_1 = require("../harness/unit-paths");
+const read_text_1 = require("../harness/read-text");
+const playwright_report_parser_1 = require("../exporters/playwright-report-parser");
+const csv_exporter_1 = require("../exporters/csv-exporter");
+/** `<f>-test-result[.<os>][.<env>].json` — a mobile run writes the OS into the name, an env run the env (#868). */
+exports.RESULT_FILE = /-test-result(?:\.[^.]+)*\.json$/;
+const readIfExists = (p) => (fs.existsSync(p) ? (0, read_text_1.readTextFile)(p) : '');
+exports.readIfExists = readIfExists;
+function countScenarios(unitDir, unit) {
+    let n = 0;
+    for (const f of (0, unit_paths_1.featureFilesFor)(unitDir, unit)) {
+        n += ((0, exports.readIfExists)(f).match(/^\s*Scenario(?: Outline)?:/gm) ?? []).length;
+    }
+    return n;
+}
+/**
+ * Does the selector text resolve at least one element? A scaffold resolves none: the web one holds
+ * only the `page` route, the mobile one only header comments. Matching the WORD "placeholder" was
+ * wrong both ways (#868): it flagged a real file whose key names an input's placeholder text, and
+ * missed both scaffolds, which never contain it.
+ */
+function hasResolvedSelector(selectorText) {
+    let doc;
+    try {
+        doc = (0, yaml_1.parse)(selectorText);
+    }
+    catch {
+        return selectorText.trim().length >= 40;
+    }
+    if (!doc || typeof doc !== 'object')
+        return false;
+    // A real cell, not a marker left to be filled in. Numbers count (an id or index can be numeric).
+    const real = (v) => (typeof v === 'string' || typeof v === 'number')
+        && String(v).trim() !== '' && !/^(?:todo|tbd|placeholder|replace me)$/i.test(String(v).trim());
+    return Object.values(doc).some((e) => {
+        if (!e || typeof e !== 'object')
+            return false;
+        const { type, value, name, locator } = e;
+        // Every SelectorEntry shape: a CSS `locator`, or a non-page `type` with a value or a role name.
+        return real(locator) || (typeof type === 'string' && type !== 'page' && (real(value) || real(name)));
+    });
+}
+/** Where a unit's compiled spec and result files live. */
+function generatedDirs(projectRoot, unit) {
+    return [
+        path.join(projectRoot, 'specs', 'generated', 'flows', unit),
+        path.join(projectRoot, 'specs', 'generated', unit),
+    ];
+}
+function isCompiled(projectRoot, unit) {
+    return generatedDirs(projectRoot, unit).some((d) => {
+        try {
+            return fs.readdirSync(d).some((f) => f.endsWith('.spec.ts'));
+        }
+        catch {
+            return false;
+        }
+    });
+}
+function unitResultFiles(projectRoot, unit) {
+    return generatedDirs(projectRoot, unit).flatMap((d) => {
+        try {
+            return fs.readdirSync(d).filter((f) => exports.RESULT_FILE.test(f)).map((f) => path.join(d, f));
+        }
+        catch {
+            return [];
+        }
+    });
+}
+/** Final attempts that failed across the result files. An unreadable report counts nothing: "unknown" is never red. */
+function countFailedResults(resultFiles) {
+    return resultFiles.reduce((n, f) => n + [...((0, playwright_report_parser_1.loadPlaywrightReport)(f)?.values() ?? [])]
+        .filter((r) => r.status === 'failed' || r.status === 'timedOut' || r.status === 'interrupted').length, 0);
+}
+function hasDeliverableFor(projectRoot, slug) {
+    try {
+        // A `--preview` DRAFT is not a deliverable (#965).
+        return fs.readdirSync(path.join(projectRoot, 'qa', 'deliverables')).some((f) => f.startsWith(`${slug}-`) && !(0, csv_exporter_1.isDraftDeliverable)(f));
+    }
+    catch {
+        return false;
+    } // nothing exported yet
+}
+//# sourceMappingURL=unit-artifact-probes.js.map

package/dist/graph/unit-artifact-probes.js.map

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

package/dist/graph/unit-results-freshness.d.ts

@@ -0,0 +1,29 @@
+export interface ResultsFreshness {
+    files: Array<{
+        file: string;
+        runAt: string;
+        source: 'run' | 'file';
+    }>;
+    /** The oldest result file's run — what the counts are at least as old as. */
+    oldestRunAt: string;
+    newestRunAt: string;
+    /** How the oldest run is dated: Playwright's run start, or (none recorded) the file's change time. */
+    runAtSource: 'run' | 'file';
+    /** Inputs changed after the results they feed were recorded. */
+    newerInputs: Array<{
+        file: string;
+        changedAt: string;
+        source: 'commit' | 'file';
+    }>;
+    /** SUNGEN_ENV, when no result file is for it. */
+    missingEnv?: string;
+    /** One line: what makes these results untrustworthy — absent when nothing does. */
+    warning?: string;
+}
+/** The unit's results, dated, and what they are older than — undefined when the unit has none. */
+export declare function resultsFreshness(projectRoot: string, unitDir: string, unit: string, env?: string | undefined): ResultsFreshness | undefined;
+/** `2026-08-21 03:42Z` */
+export declare const shortDate: (isoTime: string) => string;
+/** `run 2026-08-21 03:42Z (65 days ago)` — the oldest run, and the newest when they are days apart. */
+export declare function describeResultsRun(f: ResultsFreshness, now?: number): string;
+//# sourceMappingURL=unit-results-freshness.d.ts.map

package/dist/graph/unit-results-freshness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-results-freshness.d.ts","sourceRoot":"","sources":["../../src/graph/unit-results-freshness.ts"],"names":[],"mappings":"AAyBA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,6EAA6E;IAC7E,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,sGAAsG;IACtG,WAAW,EAAE,KAAK,GAAG,MAAM,CAAC;IAC5B,gEAAgE;IAChE,WAAW,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,QAAQ,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IACnF,iDAAiD;IACjD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAoED,kGAAkG;AAClG,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,GAAG,SAAkC,GAAG,gBAAgB,GAAG,SAAS,CA0CnK;AAED,0BAA0B;AAC1B,eAAO,MAAM,SAAS,GAAI,SAAS,MAAM,KAAG,MAAsD,CAAC;AAEnG,uGAAuG;AACvG,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,gBAAgB,EAAE,GAAG,SAAa,GAAG,MAAM,CAShF"}

package/dist/graph/unit-results-freshness.js

@@ -0,0 +1,213 @@
+"use strict";
+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.shortDate = void 0;
+exports.resultsFreshness = resultsFreshness;
+exports.describeResultsRun = describeResultsRun;
+/**
+ * Which run a unit's results come from, and whether they still describe the suite (#942) — so `next`
+ * and the delivery checklist never read a months-old results JSON in silence. Read-only, like the rest
+ * of the graph's facts.
+ *
+ *   run       each result file's run start, as Playwright records it (`stats.startTime`); a file
+ *             without one is dated by its own change time, and says so
+ *   older     an input changed after the results it feeds were recorded:
+ *               per feature   its `.feature` and compiled `<base>.spec.ts` ↔ its `<base>-test-result*.json`
+ *               unit-wide     requirements/spec.md ↔ the oldest result file
+ *             Not contracts.lock.yaml: approving the contract after a run is the normal order, and it
+ *             changes no test — the contract check judges the lock, not the results.
+ *             A file's "change time" is its last commit when git tracks it unchanged, else its file
+ *             time. Results are "recorded" at the later of their run start and their own change time.
+ *             So a fresh checkout (every file the checkout's time) and results committed in the same
+ *             commit as the edit they ran against read fresh; an edit, or a commit, after them does not.
+ *   env       SUNGEN_ENV names an env no result file is for: readers fall back to another env's results
+ * Advisory: it states what it sees and warns; it decides no step and changes no exit code.
+ */
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const unit_paths_1 = require("../harness/unit-paths");
+const unit_artifact_probes_1 = require("./unit-artifact-probes");
+/** `next` also runs inside the Claude Code hooks (10 s budget, the contract's git calls included): a slow git dates by file time instead. */
+const GIT_TIMEOUT_MS = 2000;
+/** Commit times have one-second resolution: an edit and its results in one commit tie. */
+const TIE_MS = 1000;
+const posix = (p) => p.split(path.sep).join('/');
+const real = (p) => { try {
+    return fs.realpathSync(p);
+}
+catch {
+    return path.resolve(p);
+} };
+const iso = (ms) => new Date(ms).toISOString();
+/** project root → its git work tree (null outside one), asked once per process: `next` reads every unit. */
+const workTrees = new Map();
+function git(cwd, args) {
+    try {
+        return (0, child_process_1.execFileSync)('git', args, { cwd, stdio: ['ignore', 'pipe', 'ignore'], timeout: GIT_TIMEOUT_MS, maxBuffer: 16 * 1024 * 1024 }).toString('utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * When each file last changed: its last commit when git tracks it and it is unchanged, else its file
+ * time (no git, uncommitted, untracked, ignored, or git failed). Two git calls for the whole set.
+ */
+function changeTimes(projectRoot, files) {
+    const mtime = (abs) => { try {
+        return { ms: fs.statSync(abs).mtimeMs, source: 'file' };
+    }
+    catch {
+        return null;
+    } };
+    if (!workTrees.has(projectRoot))
+        workTrees.set(projectRoot, git(projectRoot, ['rev-parse', '--show-toplevel'])?.trim() || null);
+    const top = workTrees.get(projectRoot);
+    if (!top)
+        return mtime;
+    const topReal = real(top);
+    const rels = files.map((f) => posix(path.relative(topReal, real(f)))).filter((r) => r && !r.startsWith('..'));
+    if (!rels.length)
+        return mtime;
+    const status = git(topReal, ['status', '--porcelain=v1', '-z', '--untracked-files=all', '--', ...rels]);
+    const log = git(topReal, ['log', '-n', '500', '--format=%x01%ct', '--name-only', '--', ...rels]);
+    if (status === null || log === null)
+        return mtime;
+    const dirty = new Set();
+    const entries = status.split('\0');
+    for (let i = 0; i < entries.length; i++) {
+        const e = entries[i];
+        if (e.length < 4)
+            continue;
+        dirty.add(e.slice(3));
+        if (e[0] === 'R' || e[0] === 'C')
+            i++; // a rename/copy carries its source path next
+    }
+    const committed = new Map();
+    let at = 0;
+    for (const line of log.split('\n')) {
+        if (line.startsWith('\x01'))
+            at = Number(line.slice(1)) * 1000;
+        else if (line.trim() && at && !committed.has(line.trim()))
+            committed.set(line.trim(), at);
+    }
+    return (abs) => {
+        const rel = posix(path.relative(topReal, real(abs)));
+        const t = committed.get(rel);
+        return t !== undefined && !dirty.has(rel) && fs.existsSync(abs) ? { ms: t, source: 'commit' } : mtime(abs);
+    };
+}
+function runStartOf(file) {
+    try {
+        const t = JSON.parse(fs.readFileSync(file, 'utf8'))?.stats?.startTime;
+        const ms = typeof t === 'string' ? Date.parse(t) : NaN;
+        return Number.isNaN(ms) ? null : ms;
+    }
+    catch {
+        return null;
+    }
+}
+/** Every result file of the unit, in the directories its readers look in. */
+function resultFilesOf(projectRoot, unitDir, unit) {
+    const dirs = [...new Set([...(0, unit_artifact_probes_1.generatedDirs)(projectRoot, unit), path.join(projectRoot, 'specs', 'generated', (0, unit_paths_1.catalogIdFromScreenDir)(unitDir))])];
+    return dirs.flatMap((d) => { try {
+        return fs.readdirSync(d).filter((f) => unit_artifact_probes_1.RESULT_FILE.test(f)).sort().map((f) => path.join(d, f));
+    }
+    catch {
+        return [];
+    } });
+}
+/** The unit's results, dated, and what they are older than — undefined when the unit has none. */
+function resultsFreshness(projectRoot, unitDir, unit, env = process.env.SUNGEN_ENV) {
+    const results = resultFilesOf(projectRoot, unitDir, unit);
+    if (!results.length)
+        return undefined;
+    const features = (0, unit_paths_1.featureFilesFor)(unitDir, unit).filter((f) => fs.existsSync(f));
+    const specsOf = (base) => [...new Set(results.map((r) => path.join(path.dirname(r), `${base}.spec.ts`)))].filter((f) => fs.existsSync(f));
+    const unitWide = [path.join(unitDir, 'requirements', 'spec.md')].filter((f) => fs.existsSync(f));
+    const baseOf = (f) => path.basename(f).replace(unit_artifact_probes_1.RESULT_FILE, '');
+    const bases = [...new Set(results.map(baseOf))];
+    const changed = changeTimes(projectRoot, [...results, ...features, ...bases.flatMap(specsOf), ...unitWide]);
+    const rel = (f) => posix(path.relative(projectRoot, f));
+    const dated = results.map((file) => {
+        const start = runStartOf(file);
+        const own = changed(file)?.ms ?? 0;
+        return { file, base: baseOf(file), runAt: start ?? own, source: (start !== null ? 'run' : 'file'), recordedAt: Math.max(start ?? 0, own) };
+    });
+    const oldest = dated.reduce((a, b) => (b.runAt < a.runAt ? b : a));
+    const newest = dated.reduce((a, b) => (b.runAt > a.runAt ? b : a));
+    const recordedFor = (files) => Math.min(...files.map((d) => d.recordedAt));
+    const newerInputs = [];
+    const judge = (input, recordedAt) => {
+        const c = changed(input);
+        if (c && c.ms > recordedAt + TIE_MS)
+            newerInputs.push({ file: rel(input), changedAt: iso(c.ms), source: c.source });
+    };
+    for (const base of bases) {
+        const feeds = recordedFor(dated.filter((d) => d.base === base));
+        for (const f of [...features.filter((x) => path.basename(x, '.feature') === base), ...specsOf(base)])
+            judge(f, feeds);
+    }
+    for (const f of unitWide)
+        judge(f, recordedFor(dated));
+    const variants = results.map((f) => path.basename(f).replace(/^.*-test-result\.?/, '').replace(/\.?json$/, ''));
+    const missingEnv = env && !variants.some((v) => v === env || v.endsWith(`.${env}`)) ? env : undefined;
+    const problems = [
+        ...(newerInputs.length ? [`results are older than ${newerInputs.slice(0, 3).map((i) => `${i.file} (changed ${(0, exports.shortDate)(i.changedAt)})`).join(', ')}${newerInputs.length > 3 ? ', …' : ''} — re-run the tests before trusting the counts`] : []),
+        ...(missingEnv ? [`no results for SUNGEN_ENV=${missingEnv} — readers fall back to ${rel(oldest.file)}`] : []),
+    ];
+    return {
+        files: dated.map((d) => ({ file: rel(d.file), runAt: iso(d.runAt), source: d.source })),
+        oldestRunAt: iso(oldest.runAt), newestRunAt: iso(newest.runAt), runAtSource: oldest.source,
+        newerInputs, ...(missingEnv ? { missingEnv } : {}), ...(problems.length ? { warning: problems.join('; ') } : {}),
+    };
+}
+/** `2026-08-21 03:42Z` */
+const shortDate = (isoTime) => `${isoTime.slice(0, 16).replace('T', ' ')}Z`;
+exports.shortDate = shortDate;
+/** `run 2026-08-21 03:42Z (65 days ago)` — the oldest run, and the newest when they are days apart. */
+function describeResultsRun(f, now = Date.now()) {
+    // A file neither the JSON nor the file system could date reads as epoch 0 — "20000 days ago" is noise.
+    if (!(Date.parse(f.oldestRunAt) > 0))
+        return 'run time unknown (no run start in the JSON, no file time)';
+    const days = Math.floor((now - Date.parse(f.oldestRunAt)) / 86400000);
+    const age = days <= 0 ? 'today' : days === 1 ? '1 day ago' : `${days} days ago`;
+    const span = Date.parse(f.newestRunAt) - Date.parse(f.oldestRunAt) >= 86400000 ? ` to ${(0, exports.shortDate)(f.newestRunAt)}` : '';
+    return f.runAtSource === 'run'
+        ? `run ${(0, exports.shortDate)(f.oldestRunAt)} (${age})${span}`
+        : `file time ${(0, exports.shortDate)(f.oldestRunAt)} (${age}; the JSON records no run start)${span}`;
+}
+//# sourceMappingURL=unit-results-freshness.js.map

package/dist/graph/unit-results-freshness.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-results-freshness.js","sourceRoot":"","sources":["../../src/graph/unit-results-freshness.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA2GA,4CA0CC;AAMD,gDASC;AApKD;;;;;;;;;;;;;;;;;;GAkBG;AACH,iDAA6C;AAC7C,uCAAyB;AACzB,2CAA6B;AAC7B,sDAAgF;AAChF,iEAAoE;AAkBpE,6IAA6I;AAC7I,MAAM,cAAc,GAAG,IAAK,CAAC;AAC7B,0FAA0F;AAC1F,MAAM,MAAM,GAAG,IAAK,CAAC;AACrB,MAAM,KAAK,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACjE,MAAM,IAAI,GAAG,CAAC,CAAS,EAAU,EAAE,GAAG,IAAI,CAAC;IAAC,OAAO,EAAE,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC;AAAC,CAAC;AAAC,MAAM,CAAC;IAAC,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AAAC,CAAC,CAAC,CAAC,CAAC;AAC7G,MAAM,GAAG,GAAG,CAAC,EAAU,EAAU,EAAE,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AAE/D,4GAA4G;AAC5G,MAAM,SAAS,GAAG,IAAI,GAAG,EAAyB,CAAC;AAEnD,SAAS,GAAG,CAAC,GAAW,EAAE,IAAc;IACtC,IAAI,CAAC;QAAC,OAAO,IAAA,4BAAY,EAAC,KAAK,EAAE,IAAI,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,SAAS,EAAE,EAAE,GAAG,IAAI,GAAG,IAAI,EAAE,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AACvL,CAAC;AAED;;;GAGG;AACH,SAAS,WAAW,CAAC,WAAmB,EAAE,KAAe;IACvD,MAAM,KAAK,GAAG,CAAC,GAAW,EAAiB,EAAE,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC,CAAC,CAAC,CAAC;IAC1I,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC;QAAE,SAAS,CAAC,GAAG,CAAC,WAAW,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,CAAC;IAChI,MAAM,GAAG,GAAG,SAAS,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;IACvC,IAAI,CAAC,GAAG;QAAE,OAAO,KAAK,CAAC;IACvB,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,IAAI,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9G,IAAI,CAAC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC/B,MAAM,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,gBAAgB,EAAE,IAAI,EAAE,uBAAuB,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACxG,MAAM,GAAG,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,kBAAkB,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;IACjG,IAAI,MAAM,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAClD,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACnC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACxC,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;QACrB,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;YAAE,SAAS;QAC3B,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACtB,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG;YAAE,CAAC,EAAE,CAAC,CAAG,6CAA6C;IACxF,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC5C,IAAI,EAAE,GAAG,CAAC,CAAC;IACX,KAAK,MAAM,IAAI,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACnC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC;YAAE,EAAE,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;aAC1D,IAAI,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;YAAE,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,CAAC,GAAG,EAAE,EAAE;QACb,MAAM,GAAG,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACrD,MAAM,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC7B,OAAO,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC7G,CAAC,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,IAAY;IAC9B,IAAI,CAAC;QACH,MAAM,CAAC,GAAI,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAyC,EAAE,KAAK,EAAE,SAAS,CAAC;QAC/G,MAAM,EAAE,GAAG,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;QACvD,OAAO,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,IAAI,CAAC;IAAC,CAAC;AAC1B,CAAC;AAED,6EAA6E;AAC7E,SAAS,aAAa,CAAC,WAAmB,EAAE,OAAe,EAAE,IAAY;IACvE,MAAM,IAAI,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,GAAG,IAAA,oCAAa,EAAC,WAAW,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,IAAA,mCAAsB,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAChJ,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,GAAG,IAAI,CAAC;QAAC,OAAO,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kCAAW,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,EAAE,CAAC;IAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AAC/J,CAAC;AAED,kGAAkG;AAClG,SAAgB,gBAAgB,CAAC,WAAmB,EAAE,OAAe,EAAE,IAAY,EAAE,MAA0B,OAAO,CAAC,GAAG,CAAC,UAAU;IACnI,MAAM,OAAO,GAAG,aAAa,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IAC1D,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACtC,MAAM,QAAQ,GAAG,IAAA,4BAAe,EAAC,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAChF,MAAM,OAAO,GAAG,CAAC,IAAY,EAAY,EAAE,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5J,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,cAAc,EAAE,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;IACjG,MAAM,MAAM,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,kCAAW,EAAE,EAAE,CAAC,CAAC;IAChF,MAAM,KAAK,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,WAAW,CAAC,WAAW,EAAE,CAAC,GAAG,OAAO,EAAE,GAAG,QAAQ,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC;IAC5G,MAAM,GAAG,GAAG,CAAC,CAAS,EAAU,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IAExE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;QACjC,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC;QAC/B,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACnC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,KAAK,IAAI,GAAG,EAAE,MAAM,EAAE,CAAC,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAmB,EAAE,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;IAC/J,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACnE,MAAM,WAAW,GAAG,CAAC,KAAmB,EAAU,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC;IAEjG,MAAM,WAAW,GAAoC,EAAE,CAAC;IACxD,MAAM,KAAK,GAAG,CAAC,KAAa,EAAE,UAAkB,EAAQ,EAAE;QACxD,MAAM,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,GAAG,UAAU,GAAG,MAAM;YAAE,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,EAAE,SAAS,EAAE,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IACtH,CAAC,CAAC;IACF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,KAAK,GAAG,WAAW,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC;QAChE,KAAK,MAAM,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,EAAE,UAAU,CAAC,KAAK,IAAI,CAAC,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAAE,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACxH,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,QAAQ;QAAE,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC;IAEvD,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC,CAAC;IAChH,MAAM,UAAU,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,CAAC,QAAQ,CAAC,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC;IACtG,MAAM,QAAQ,GAAG;QACf,GAAG,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,0BAA0B,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,aAAa,IAAA,iBAAS,EAAC,CAAC,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,gDAAgD,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/O,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,6BAA6B,UAAU,2BAA2B,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;KAC9G,CAAC;IACF,OAAO;QACL,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;QACvF,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM;QAC1F,WAAW,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACjH,CAAC;AACJ,CAAC;AAED,0BAA0B;AACnB,MAAM,SAAS,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC;AAAtF,QAAA,SAAS,aAA6E;AAEnG,uGAAuG;AACvG,SAAgB,kBAAkB,CAAC,CAAmB,EAAE,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE;IACtE,uGAAuG;IACvG,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAAE,OAAO,2DAA2D,CAAC;IACzG,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,GAAG,QAAU,CAAC,CAAC;IACxE,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,GAAG,IAAI,WAAW,CAAC;IAChF,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,WAAW,CAAC,IAAI,QAAU,CAAC,CAAC,CAAC,OAAO,IAAA,iBAAS,EAAC,CAAC,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1H,OAAO,CAAC,CAAC,WAAW,KAAK,KAAK;QAC5B,CAAC,CAAC,OAAO,IAAA,iBAAS,EAAC,CAAC,CAAC,WAAW,CAAC,KAAK,GAAG,IAAI,IAAI,EAAE;QACnD,CAAC,CAAC,aAAa,IAAA,iBAAS,EAAC,CAAC,CAAC,WAAW,CAAC,KAAK,GAAG,mCAAmC,IAAI,EAAE,CAAC;AAC7F,CAAC"}

package/dist/graph/unit-state-facts.d.ts

@@ -0,0 +1,43 @@
+import { HeadSnapshot } from '../contract/contract-git';
+import type { TestCaseContract } from './test-case-state-shape';
+/** A report exists but does not count — `next` says "re-audit" exactly as gate and delivery block. */
+export interface AuditNotCounted {
+    state: 'stale' | 'invalid';
+    reason: string;
+}
+export interface ContractSummary {
+    verdict: 'pass' | 'review' | 'fail';
+    /** Scenarios with no approved lock entry (never block). */
+    proposed: number;
+    /** Approved scenarios changed, not weaker (`contract.hash-changed`) — review blocks delivery. */
+    review: number;
+    /** Approved scenarios that got weaker, changed target or lost a check (not `unproven`: no trace is no edit to undo). */
+    hard: number;
+    /** Approved free / impl:code scenarios no admissible trace proves (contract.unproven, hard) — a traced run, not a QA call. */
+    unproven?: number;
+    /** Approved free / impl:code scenarios whose trace is in review: opaque (incl. a low identity) or inconclusive. */
+    traceReview?: number;
+    /** Lock entries that are not what QA approved and committed (`contract.lock-uncommitted`). */
+    uncommitted: number;
+    /**
+     * What is wrong with them, the one to fix first: `tampered` (an entry no longer hashes to its steps),
+     * `untracked` (the lock was never committed), `edited` (a committed lock with uncommitted edits),
+     * `unverified` (no committed contract-approval decision vouches for an entry).
+     */
+    uncommittedKind?: 'tampered' | 'untracked' | 'edited' | 'unverified';
+    /** The first hard scenario, `<id> <class>`. */
+    headline?: string;
+    /** Set when the verdict could not be built (git unavailable with a lock, unreadable lock or feature). */
+    error?: string;
+}
+export declare function readTrustedAudit(projectRoot: string, unit: string): {
+    report: Record<string, unknown> | null;
+    notCounted?: AuditNotCounted;
+};
+export interface ContractFacts {
+    summary: ContractSummary;
+    cases: Map<string, TestCaseContract>;
+}
+export declare function readContractFacts(projectRoot: string, unit: string, unitDir: string, snapshot?: HeadSnapshot): ContractFacts;
+export declare const readContractSummary: (projectRoot: string, unit: string, unitDir: string, snapshot?: HeadSnapshot) => ContractSummary;
+//# sourceMappingURL=unit-state-facts.d.ts.map

package/dist/graph/unit-state-facts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-state-facts.d.ts","sourceRoot":"","sources":["../../src/graph/unit-state-facts.ts"],"names":[],"mappings":"AAYA,OAAO,EAAwB,YAAY,EAA0B,MAAM,0BAA0B,CAAC;AAKtG,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAEhE,sGAAsG;AACtG,MAAM,WAAW,eAAe;IAAG,KAAK,EAAE,OAAO,GAAG,SAAS,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAE/E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,GAAG,QAAQ,GAAG,MAAM,CAAC;IACpC,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,CAAC;IACjB,iGAAiG;IACjG,MAAM,EAAE,MAAM,CAAC;IACf,wHAAwH;IACxH,IAAI,EAAE,MAAM,CAAC;IACb,8HAA8H;IAC9H,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,mHAAmH;IACnH,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,8FAA8F;IAC9F,WAAW,EAAE,MAAM,CAAC;IACpB;;;;OAIG;IACH,eAAe,CAAC,EAAE,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,YAAY,CAAC;IACrE,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yGAAyG;IACzG,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAID,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAAC,UAAU,CAAC,EAAE,eAAe,CAAA;CAAE,CAU5I;AAwBD,MAAM,WAAW,aAAa;IAAG,OAAO,EAAE,eAAe,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAA;CAAE;AAEjG,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,YAAY,GAAG,aAAa,CAsB5H;AAED,eAAO,MAAM,mBAAmB,GAAI,aAAa,MAAM,EAAE,MAAM,MAAM,EAAE,SAAS,MAAM,EAAE,WAAW,YAAY,KAAG,eACjD,CAAC"}

package/dist/graph/unit-state-facts.js

@@ -0,0 +1,87 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readContractSummary = void 0;
+exports.readTrustedAudit = readTrustedAudit;
+exports.readContractFacts = readContractFacts;
+/**
+ * The facts `readUnitState` adds for the graph's newer nodes — read through the same code the gate,
+ * the delivery and the Claude Code guard use, so `next` cannot disagree with them (red-team #12):
+ *
+ *   readTrustedAudit     audit.json through verifyAuditReport (OES-11.4, DOS-14.0): a stale, invalid
+ *                        or verdict-mismatched report counts as never audited, and says why
+ *   readContractFacts    the contract verdict rebuilt by buildContractVerdict (DOS-14.4) — the
+ *                        function `sungen contract check` and the delivery guard run — as the unit
+ *                        summary plus each case's class (phase 09: the test-case contract nodes)
+ */
+const build_contract_verdict_1 = require("../contract/build-contract-verdict");
+const classify_trace_conformance_1 = require("../contract/classify-trace-conformance");
+const contract_git_1 = require("../contract/contract-git");
+const contract_schema_1 = require("../contract/contract-schema");
+const contracts_lock_file_1 = require("../contract/contracts-lock-file");
+const audit_report_verification_1 = require("../harness/gates/audit-report-verification");
+const message = (e) => (e instanceof Error ? e.message : String(e)).split('\n')[0];
+function readTrustedAudit(projectRoot, unit) {
+    try {
+        const v = (0, audit_report_verification_1.verifyAuditReport)(projectRoot, unit);
+        if ((0, audit_report_verification_1.auditCounts)(v))
+            return { report: v.report };
+        if (v.state === 'absent')
+            return { report: null };
+        const reason = v.problems.map((p) => p.message).join('; ') || v.state;
+        return { report: null, notCounted: { state: v.state === 'stale' ? 'stale' : 'invalid', reason } };
+    }
+    catch (e) {
+        return { report: null, notCounted: { state: 'invalid', reason: `the report could not be verified: ${message(e)}` } };
+    }
+}
+function uncommittedKindOf(entries, lockInHead) {
+    if (!entries.length)
+        return undefined;
+    if (entries.some((e) => e.change === 'tampered'))
+        return 'tampered';
+    if (entries.some((e) => e.change !== 'unverified'))
+        return lockInHead ? 'edited' : 'untracked';
+    return 'unverified';
+}
+/** scenario id → its class, the finding behind it, and whether a low identity or an uncommitted lock entry is behind it. */
+function caseContracts(v) {
+    const out = new Map();
+    for (const s of v.scenarios) {
+        const lead = s.findings.find((f) => f.class === s.class) ?? s.findings[0];
+        out.set(s.id, {
+            class: s.class,
+            ...(lead ? { detail: lead.detail } : {}),
+            ...(s.findings.some((f) => f.class === 'opaque' && f.detail.startsWith(classify_trace_conformance_1.LOW_IDENTITY_FINDING)) ? { lowIdentity: true } : {}),
+        });
+    }
+    for (const u of v.uncommitted)
+        out.set(u.id, { ...(out.get(u.id) ?? { class: 'match' }), uncommitted: true });
+    return out;
+}
+function readContractFacts(projectRoot, unit, unitDir, snapshot) {
+    try {
+        const snap = snapshot ?? (0, contract_git_1.headSnapshot)(projectRoot, contract_git_1.GUARD_GIT_TIMEOUT_MS);
+        const v = (0, build_contract_verdict_1.buildContractVerdict)(projectRoot, { name: unit, dir: unitDir }, { snapshot: snap });
+        const count = (...classes) => v.scenarios.filter((s) => classes.includes(s.class)).length;
+        const hard = v.scenarios.filter((s) => contract_schema_1.HARD_CLASSES.has(s.class) && s.class !== 'unproven');
+        const kind = uncommittedKindOf(v.uncommitted, Boolean(snap.blobs?.has((0, contract_git_1.posixRel)(projectRoot, (0, contracts_lock_file_1.lockPathFor)(unitDir)))));
+        const summary = {
+            verdict: v.verdict,
+            proposed: count('proposed'),
+            review: count('hash-changed'),
+            hard: hard.length,
+            uncommitted: v.uncommitted.length,
+            unproven: count('unproven'),
+            traceReview: count('opaque', 'inconclusive'),
+            ...(kind ? { uncommittedKind: kind } : {}),
+            ...(hard[0] ? { headline: `${hard[0].id} ${hard[0].class}` } : {}),
+        };
+        return { summary, cases: caseContracts(v) };
+    }
+    catch (e) {
+        return { summary: { verdict: 'fail', proposed: 0, review: 0, hard: 0, uncommitted: 0, error: message(e) }, cases: new Map() };
+    }
+}
+const readContractSummary = (projectRoot, unit, unitDir, snapshot) => readContractFacts(projectRoot, unit, unitDir, snapshot).summary;
+exports.readContractSummary = readContractSummary;
+//# sourceMappingURL=unit-state-facts.js.map

package/dist/graph/unit-state-facts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unit-state-facts.js","sourceRoot":"","sources":["../../src/graph/unit-state-facts.ts"],"names":[],"mappings":";;;AAkDA,4CAUC;AA0BD,8CAsBC;AA5GD;;;;;;;;;GASG;AACH,+EAA2F;AAC3F,uFAA8E;AAC9E,2DAAsG;AACtG,iEAA2D;AAC3D,yEAA8D;AAE9D,0FAA4F;AAgC5F,MAAM,OAAO,GAAG,CAAC,CAAU,EAAU,EAAE,CAAC,CAAC,CAAC,YAAY,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAEpG,SAAgB,gBAAgB,CAAC,WAAmB,EAAE,IAAY;IAChE,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAA,6CAAiB,EAAC,WAAW,EAAE,IAAI,CAAC,CAAC;QAC/C,IAAI,IAAA,uCAAW,EAAC,CAAC,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;QAChD,IAAI,CAAC,CAAC,KAAK,KAAK,QAAQ;YAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QAClD,MAAM,MAAM,GAAG,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC;QACtE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,EAAE,MAAM,EAAE,EAAE,CAAC;IACpG,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,qCAAqC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC;IACvH,CAAC;AACH,CAAC;AAED,SAAS,iBAAiB,CAAC,OAA2B,EAAE,UAAmB;IACzE,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,SAAS,CAAC;IACtC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,UAAU,CAAC;QAAE,OAAO,UAAU,CAAC;IACpE,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,KAAK,YAAY,CAAC;QAAE,OAAO,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW,CAAC;IAC/F,OAAO,YAAY,CAAC;AACtB,CAAC;AAED,4HAA4H;AAC5H,SAAS,aAAa,CAAC,CAAkB;IACvC,MAAM,GAAG,GAAG,IAAI,GAAG,EAA4B,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,CAAC;QAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC;QAC1E,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;YACZ,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACxC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,iDAAoB,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,IAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACrI,CAAC,CAAC;IACL,CAAC;IACD,KAAK,MAAM,CAAC,IAAI,CAAC,CAAC,WAAW;QAAE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,CAAC;IAC9G,OAAO,GAAG,CAAC;AACb,CAAC;AAID,SAAgB,iBAAiB,CAAC,WAAmB,EAAE,IAAY,EAAE,OAAe,EAAE,QAAuB;IAC3G,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,QAAQ,IAAI,IAAA,2BAAY,EAAC,WAAW,EAAE,mCAAoB,CAAC,CAAC;QACzE,MAAM,CAAC,GAAG,IAAA,6CAAoB,EAAC,WAAW,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;QAC9F,MAAM,KAAK,GAAG,CAAC,GAAG,OAAiB,EAAU,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;QAC5G,MAAM,IAAI,GAAG,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,8BAAY,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,KAAK,UAAU,CAAC,CAAC;QAC5F,MAAM,IAAI,GAAG,iBAAiB,CAAC,CAAC,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,IAAA,uBAAQ,EAAC,WAAW,EAAE,IAAA,iCAAW,EAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrH,MAAM,OAAO,GAAoB;YAC/B,OAAO,EAAE,CAAC,CAAC,OAAO;YAClB,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC;YAC3B,MAAM,EAAE,KAAK,CAAC,cAAc,CAAC;YAC7B,IAAI,EAAE,IAAI,CAAC,MAAM;YACjB,WAAW,EAAE,CAAC,CAAC,WAAW,CAAC,MAAM;YACjC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC;YAC3B,WAAW,EAAE,KAAK,CAAC,QAAQ,EAAE,cAAc,CAAC;YAC5C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC1C,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9C,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,OAAO,EAAE,OAAO,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,KAAK,EAAE,IAAI,GAAG,EAAE,EAAE,CAAC;IAChI,CAAC;AACH,CAAC;AAEM,MAAM,mBAAmB,GAAG,CAAC,WAAmB,EAAE,IAAY,EAAE,OAAe,EAAE,QAAuB,EAAmB,EAAE,CAClI,iBAAiB,CAAC,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC;AADrD,QAAA,mBAAmB,uBACkC"}

package/dist/harness/audit.d.ts

@@ -1,5 +1,6 @@
 import { ViewpointBaseline } from './viewpoint-baseline';
 import { FlowQualityResult, InventoryResult } from './flow-contract';
+import { catalogIdFromScreenDir } from './unit-paths';
 import { ReusedScenarioId, GateResult, DepthResult, BalanceResult, DuplicateResult, TraceResult, ClaimProofResult, TaxonomyResult, AutomatableManualResult, FlowDepthResult, OracleStrengthResult } from './sensors';
 import { IntentProfile } from './intent';
 import { Provenance } from './provenance';
@@ -7,6 +8,7 @@ import { SpecCoverageResult } from './spec-coverage';
 import { DownstreamResult, ManualOracleResult } from './quality-gates';
 import { LedgerResult } from './viewpoint-ledger';
 import { UiInventoryResult } from './ui-inventory';
+import { GateOverrideReport } from './gates/gate-override-report';
 export interface AuditReport {
     screen: string;
     scenarioCount: number;
@@ -80,14 +82,24 @@ export interface AuditReport {
     intent: IntentProfile;
     provenance: Provenance;
     spec: SpecCoverageResult;
+    /** OES-11.6 — every gate-override touching this unit (applied / ineffective / rejected). */
+    gateOverrides: GateOverrideReport[];
+    /** OES-11.4 — the decisions this audit was judged under; readers re-audit when it moves. */
+    decisionsHash: string;
+    /** T3 — hash of .feature + spec + viewpoint + decisionsHash; a reader recomputes it. */
+    inputsHash: string;
+    /** T3 — what `sungen audit` exits with for this gateStatus (0 PASS · 2 FAIL). */
+    exitCode: number;
+    /** A capability gate sensor reported an error-level finding — recorded so a reader can re-evaluate the gate. */
+    gateSensorError: boolean;
 }
 /**
  * Every unit name this project holds (screens + flows + api areas). Used to answer "does the
  * project actually contain the spec this one says its requirements come from?".
  */
 export declare function projectUnitDirs(projectRoot: string): string[];
-/** The catalog-resolution id for a unit dir (relative to qa/): screen · flows/<flow> · api/<area> · api/flows/<flow>. */
-export declare function catalogIdFromScreenDir(screenDir: string): string;
+/** The catalog-resolution id for a unit dir — lives in unit-paths.ts (the inputsHash reads it too); kept exported here. */
+export { catalogIdFromScreenDir };
 /**
  * The capability that owns SCORING for a unit (AO-1): the first path segment of the unit id when it
  * is a registered capability (`api/<area>` → `api`), else the default (UI) capability. Generic — a

package/dist/harness/audit.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/harness/audit.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"audit.d.ts","sourceRoot":"","sources":["../../src/harness/audit.ts"],"names":[],"mappings":"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"}