@sun-asterisk/sungen 3.2.32 → 3.2.34-beta.1

package/dist/harness/triage-unit.js

@@ -0,0 +1,142 @@
+"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.unitSecrets = unitSecrets;
+exports.triageUnit = triageUnit;
+exports.triageReportPath = triageReportPath;
+exports.readTriageReport = readTriageReport;
+exports.writeTriageReport = writeTriageReport;
+/**
+ * `sungen triage` IO: find a unit's feature(s) and result file(s), join them on the same seam
+ * delivery and the dashboard use (`mergeFeatureAndSpec` + `resolveResultVariants`), classify each
+ * scenario, and persist `.sungen/triage/<unit>.json`. Read-only apart from that one report file.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const feature_parser_1 = require("../exporters/feature-parser");
+const playwright_report_parser_1 = require("../exporters/playwright-report-parser");
+const qa_env_secret_denylist_1 = require("../exporters/qa-env-secret-denylist");
+const sensitive_key_1 = require("../exporters/sensitive-key");
+const result_variants_1 = require("../exporters/result-variants");
+const scenario_merger_1 = require("../exporters/scenario-merger");
+const spec_parser_1 = require("../exporters/spec-parser");
+const test_data_resolver_1 = require("../exporters/test-data-resolver");
+const triage_1 = require("./triage");
+/**
+ * Values that must never reach a triage evidence line or a defect record: the resolved `${QA_*}`
+ * secrets AND the literal values of credential-named test-data keys — an assertion on a password
+ * field prints that value in its Expected/Received.
+ */
+function unitSecrets(testData, cwd) {
+    const literal = Object.entries(testData)
+        .filter(([k, v]) => (0, sensitive_key_1.isSensitiveKey)(k) && typeof v === 'string' && v.length >= 3 && !v.includes('${'))
+        .map(([, v]) => String(v));
+    return [...new Set([...(0, qa_env_secret_denylist_1.collectQaEnvSecretDenylist)(testData, cwd).values, ...literal])].sort((a, b) => b.length - a.length);
+}
+function generatedDir(cwd, u) {
+    return path.join(cwd, 'specs', 'generated', u.unitId);
+}
+/**
+ * Every result file of one feature, labelled by variant: `<base>-test-result.json` (no label),
+ * `<base>-test-result.<os|env>[.<env>].json` (label = the middle part). A mobile unit has only
+ * per-OS files, so all of them are read rather than the first one found. Falls back to the shared
+ * lookup (incl. `test-results/results.json`) when the generated dir holds none.
+ */
+function resultFilesFor(cwd, genDir, base) {
+    const prefix = `${base}-test-result`;
+    const own = fs.existsSync(genDir)
+        ? fs.readdirSync(genDir).filter((f) => f.startsWith(prefix) && f.endsWith('.json')).sort()
+        : [];
+    if (own.length > 0) {
+        return own.map((f) => {
+            const variant = f.slice(prefix.length, -'.json'.length).replace(/^\./, '');
+            return { file: path.join(genDir, f), ...(variant ? { variant } : {}) };
+        });
+    }
+    const shared = (0, playwright_report_parser_1.resolveResultsPath)(cwd, genDir, base);
+    return shared ? [{ file: shared }] : [];
+}
+function triageUnit(cwd, u) {
+    const genDir = generatedDir(cwd, u);
+    const featuresDir = path.join(u.dir, 'features');
+    const features = fs.existsSync(featuresDir) ? fs.readdirSync(featuresDir).filter((f) => f.endsWith('.feature')).sort() : [];
+    const rows = [];
+    const resultFiles = [];
+    for (const f of features) {
+        const base = f.replace(/\.feature$/, '');
+        const files = resultFilesFor(cwd, genDir, base);
+        if (files.length === 0)
+            continue;
+        const merged = (0, scenario_merger_1.mergeFeatureAndSpec)((0, feature_parser_1.parseFeatureMetadata)(path.join(featuresDir, f)), (0, spec_parser_1.parseSpecFile)(path.join(genDir, `${base}.spec.ts`)));
+        const dataFile = path.join(u.dir, 'test-data', `${base}.yaml`);
+        const testData = fs.existsSync(dataFile) ? (0, test_data_resolver_1.loadTestData)(dataFile) : {};
+        const secrets = unitSecrets(testData, cwd);
+        for (const { file, variant } of files) {
+            resultFiles.push(path.relative(cwd, file));
+            const results = (0, playwright_report_parser_1.loadPlaywrightReport)(file);
+            for (const m of merged) {
+                for (const v of (0, result_variants_1.resolveResultVariants)(m, results, testData)) {
+                    const r = (0, triage_1.classifyScenario)({ unit: u.unitId, title: `${m.feature.name}${v.nameSuffix}`, tags: m.feature.tags, result: v.result, variant }, secrets);
+                    if (r)
+                        rows.push(r);
+                }
+            }
+        }
+    }
+    const counts = {};
+    for (const r of rows)
+        counts[r.class] = (counts[r.class] ?? 0) + 1;
+    return { unit: u.unitId, generatedAt: new Date().toISOString(), resultFiles, counts, rows };
+}
+function triageReportPath(cwd, unitId) {
+    return path.join(cwd, '.sungen', 'triage', `${unitId.replace(/\//g, '-')}.json`);
+}
+/** The last triage of a unit, or null when `sungen triage` has not run for it. */
+function readTriageReport(cwd, unitId) {
+    try {
+        return JSON.parse(fs.readFileSync(triageReportPath(cwd, unitId), 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/** Persist under `.sungen/triage/<unit>.json` (a flow `flows/x` → `flows-x.json`); returns the path. */
+function writeTriageReport(cwd, report) {
+    const out = triageReportPath(cwd, report.unit);
+    fs.mkdirSync(path.dirname(out), { recursive: true });
+    fs.writeFileSync(out, `${JSON.stringify(report, null, 2)}\n`, 'utf-8');
+    return out;
+}
+//# sourceMappingURL=triage-unit.js.map

package/dist/harness/triage-unit.js.map

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

package/dist/harness/triage.d.ts

@@ -0,0 +1,28 @@
+import type { PlaywrightResult } from '../exporters/types';
+export type TriageClass = 'known-defect' | 'blocked-capability' | 'environment' | 'test-defect' | 'product-candidate' | 'unclassified' | 'flaky';
+export interface TriageInput {
+    unit: string;
+    title: string;
+    tags: string[];
+    result?: PlaywrightResult;
+    /** Result-file variant (`android`, `ios`, an env name) when the unit has several. */
+    variant?: string;
+}
+export interface TriageRow {
+    unit: string;
+    scenario: string;
+    variant?: string;
+    class: TriageClass;
+    ruleId: string;
+    evidence: string;
+    ids: string[];
+    legacy: string[];
+    defectId?: string;
+    tracePath?: string;
+    /** product-candidate only: the two halves of the assertion, for a defect draft. */
+    expected?: string;
+    received?: string;
+}
+/** Classify one scenario. Null when it needs no triage (clean pass, or never ran). */
+export declare function classifyScenario(input: TriageInput, secrets?: string[]): TriageRow | null;
+//# sourceMappingURL=triage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"triage.d.ts","sourceRoot":"","sources":["../../src/harness/triage.ts"],"names":[],"mappings":"AAyBA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG3D,MAAM,MAAM,WAAW,GACnB,cAAc,GAAG,oBAAoB,GAAG,aAAa,GAAG,aAAa,GAAG,mBAAmB,GAAG,cAAc,GAAG,OAAO,CAAC;AAE3H,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,MAAM,CAAC,EAAE,gBAAgB,CAAC;IAC1B,qFAAqF;IACrF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,WAAW,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mFAAmF;IACnF,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAoBD,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,OAAO,GAAE,MAAM,EAAO,GAAG,SAAS,GAAG,IAAI,CAmD7F"}

package/dist/harness/triage.js

@@ -0,0 +1,99 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.classifyScenario = classifyScenario;
+/**
+ * `sungen triage` — classify each red or flaky scenario of a run into exactly one class, with the
+ * rule that fired and one evidence line. Deterministic and read-only; it reports, it never gates.
+ *
+ * Order (first match wins):
+ *   1. known-defect        `@known-defect` / `@known-defect:<id>` — an expected red.
+ *   2. blocked-capability  `@manual:*` / `@requires:*`, or skipped by design.
+ *   3. environment         the session or network never gave the test a usable app.
+ *   4. test-defect         the test could not reach its element or data.
+ *   5. product-candidate   an assertion whose Expected and Received both exist and differ.
+ *   6. unclassified        anything else — left for the agent or QA, with the raw first message.
+ * A `passed` scenario that needed a retry is `flaky` (green, listed separately).
+ *
+ * 5 is tested before 3 and 4 in code: a parsed Expected/Received pair that differs means the app
+ * answered, which outranks any wrapper text (a test timeout around the assertion included).
+ *
+ * A bare test timeout (no locator, no assertion) is `unclassified` too: a slow environment, a page
+ * that hangs on a product bug and a test waiting on the wrong thing all print the same line.
+ *
+ * An assertion on an element that never appeared (`Received: <element(s) not found>`) is NOT a test
+ * defect: a wrong selector and a missing message look identical, so it is left for judgment rather
+ * than hiding a possible product bug behind "fix the selector".
+ */
+const api_testcase_formatter_1 = require("../exporters/api-testcase-formatter");
+const playwright_report_parser_1 = require("../exporters/playwright-report-parser");
+const triage_signals_1 = require("./triage-signals");
+const EVIDENCE_MAX = 200;
+const VIEWPOINT_ID = /\b(?:VP|FL)-[A-Z0-9]+(?:-[A-Z0-9]+)*\b/gi;
+const ELEMENT_ABSENT = /Received:\s*<element\(s\) not found>/;
+/** The part of a message the run itself wrote: before `Call log:`, without `Locator:` echo lines. */
+const runHead = (m) => m.split(/\n\s*Call log:/)[0].replace(/^\s*Locator:.*$/gm, '');
+/** Every failure message, stack frames and a leading `Error:` dropped. */
+function messagesOf(result) {
+    const raw = result.errorMessages?.length ? result.errorMessages : [result.error ?? ''];
+    return raw.map((m) => m.split(/\n\s*at\s/)[0].replace(/^Error:\s*/i, '').trim()).filter(Boolean);
+}
+function evidenceLine(text, secrets) {
+    const flat = (0, api_testcase_formatter_1.redactSecrets)(text, secrets).replace(/\s+/g, ' ').trim();
+    return flat.length > EVIDENCE_MAX ? `${flat.slice(0, EVIDENCE_MAX - 1)}…` : flat;
+}
+/** Classify one scenario. Null when it needs no triage (clean pass, or never ran). */
+function classifyScenario(input, secrets = []) {
+    const { result, tags } = input;
+    if (!result)
+        return null;
+    const base = {
+        unit: input.unit,
+        scenario: input.title,
+        ...(input.variant ? { variant: input.variant } : {}),
+        ids: [...new Set([input.title, ...tags].join(' ').match(VIEWPOINT_ID) ?? [])],
+        legacy: tags.filter((t) => t.startsWith('@legacy:')).map((t) => t.slice('@legacy:'.length)),
+        ...(result.tracePath ? { tracePath: result.tracePath } : {}),
+    };
+    const row = (cls, ruleId, evidence) => ({ ...base, class: cls, ruleId, evidence: evidenceLine(evidence, secrets) });
+    if (result.status === 'passed') {
+        return (result.attempts ?? 1) > 1 ? row('flaky', 'passed-after-retry', `passed on attempt ${result.attempts}`) : null;
+    }
+    const messages = messagesOf(result);
+    const first = messages[0] ?? result.status;
+    const known = tags.find((t) => t === '@known-defect' || t.startsWith('@known-defect:'));
+    if (known) {
+        const r = row('known-defect', 'tag-known-defect', first);
+        const id = known.split(':')[1];
+        return id ? { ...r, defectId: id } : r;
+    }
+    if (tags.some((t) => t.startsWith('@manual')))
+        return row('blocked-capability', 'tag-manual', `${tags.find((t) => t.startsWith('@manual'))} — ${first}`);
+    if (tags.some((t) => t.startsWith('@requires:')))
+        return row('blocked-capability', 'tag-requires', `${tags.find((t) => t.startsWith('@requires:'))} — ${first}`);
+    if (result.status === 'skipped')
+        return row('blocked-capability', 'status-skipped', 'skipped');
+    // An assertion with both halves decides the case even when a timeout wraps it.
+    for (const m of messages) {
+        const { expected, received } = (0, playwright_report_parser_1.parseExpectedReceived)(m);
+        if (expected && received && !ELEMENT_ABSENT.test(m) && expected !== received) {
+            return { ...row('product-candidate', 'assertion-mismatch', `Expected ${expected} · Received ${received}`),
+                expected: evidenceLine(expected, secrets), received: evidenceLine(received, secrets) };
+        }
+    }
+    for (const s of triage_signals_1.TRIAGE_SIGNALS) {
+        // Environment signals read only what the RUN said, never the test's own selector text that a
+        // message echoes in `Locator:` / `Call log:` — `getByText('Invalid URL')` is a missing message,
+        // not a bad base URL. Test-defect signals need the call log (`waiting for …`), so they read it all.
+        const hit = messages.find((m) => s.match.test(s.class === 'environment' ? runHead(m) : m));
+        if (hit)
+            return row(s.class, s.id, hit);
+    }
+    const absent = messages.find((m) => ELEMENT_ABSENT.test(m));
+    if (absent)
+        return row('unclassified', 'assertion-element-absent', absent);
+    if (messages.length > 0 && messages.every((m) => triage_signals_1.BARE_TIMEOUT.test(m))) {
+        return row('unclassified', 'bare-timeout', `${first} No locator or assertion detail: a slow environment, a hanging page, or a wait in the test. Re-run once, then read the trace's last action.`);
+    }
+    return row('unclassified', 'no-signal', first);
+}
+//# sourceMappingURL=triage.js.map

package/dist/harness/triage.js.map

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

package/dist/harness/ui-inventory.d.ts

@@ -0,0 +1,40 @@
+export type UiItemSource = 'spec+design' | 'design-only' | 'conflict';
+export interface UiItem {
+    id: string;
+    item: string;
+    kind: string;
+    source: UiItemSource;
+}
+export interface UiInventoryResult {
+    /** Design sources the unit holds: image files, figma-meta.md, spec_figma.md. */
+    designSources: string[];
+    /** `requirements/ui-inventory.md` exists. */
+    hasInventory: boolean;
+    items: UiItem[];
+    /** `images read: a/b` from the inventory header — null when the line is absent. */
+    imagesRead: {
+        read: number;
+        total: number;
+    } | null;
+    /** Images on disk, for comparing against `imagesRead.total`. */
+    imagesOnDisk: number;
+    covered: string[];
+    deferred: string[];
+    /** design-only / conflict items neither covered nor deferred. */
+    uncovered: UiItem[];
+}
+/** Every design source in a unit's `requirements/` — what makes an inventory necessary. */
+export declare function designSourcesOf(reqDir: string): string[];
+/**
+ * Parse the inventory table: any markdown row whose first cell is a `UI-<n>` id. Leading/trailing
+ * pipes are optional (GFM), and the Source cell is FOUND rather than counted — a `|` written inside
+ * the Item cell shifts the columns, and a positional read then misfiled a design-only row.
+ */
+export declare function parseUiInventory(text: string): {
+    items: UiItem[];
+    imagesRead: UiInventoryResult['imagesRead'];
+};
+export declare function uiInventoryCoverage(reqDir: string, featureText: string): UiInventoryResult;
+/** Advisory findings for the audit report. */
+export declare function uiInventoryFindings(r: UiInventoryResult): string[];
+//# sourceMappingURL=ui-inventory.d.ts.map

package/dist/harness/ui-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ui-inventory.d.ts","sourceRoot":"","sources":["../../src/harness/ui-inventory.ts"],"names":[],"mappings":"AAsBA,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,aAAa,GAAG,UAAU,CAAC;AAEtE,MAAM,WAAW,MAAM;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,YAAY,CAAC;CACtB;AAED,MAAM,WAAW,iBAAiB;IAChC,gFAAgF;IAChF,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,6CAA6C;IAC7C,YAAY,EAAE,OAAO,CAAC;IACtB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,mFAAmF;IACnF,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnD,gEAAgE;IAChE,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,iEAAiE;IACjE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAID,2FAA2F;AAC3F,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAUxD;AAeD;;;;GAIG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAAC,UAAU,EAAE,iBAAiB,CAAC,YAAY,CAAC,CAAA;CAAE,CAoB/G;AAeD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,iBAAiB,CA4B1F;AAED,8CAA8C;AAC9C,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAiBlE"}

package/dist/harness/ui-inventory.js

@@ -0,0 +1,191 @@
+"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.designSourcesOf = designSourcesOf;
+exports.parseUiInventory = parseUiInventory;
+exports.uiInventoryCoverage = uiInventoryCoverage;
+exports.uiInventoryFindings = uiInventoryFindings;
+/**
+ * #811 — the design inventory: is every item the DESIGN shows accounted for by the suite?
+ *
+ * Design sources in `requirements/ui/` (images, `figma-meta.md`) and `requirements/spec_figma.md`
+ * were read "for visual context" and never turned into a checkable list, so a column that exists
+ * only on the design — or contradicts the spec — was missed by the author AND the reviewer, and a
+ * deliberate deferral looked exactly like an oversight.
+ *
+ * create-test now writes `requirements/ui-inventory.md`: one `UI-NNN` row per component / column /
+ * button / state / annotation, with its source (`spec+design` | `design-only` | `conflict`). An
+ * item is accounted for by a scenario tag (`@ui:UI-014`) or a reasoned deferral comment
+ * (`# UI-DEFERRED: UI-002..013 — <reason>`) — no other mention counts; ranges and `/`
+ * enumerations read the same way as spec ids (spec-coverage `citedIds`). `spec+design` items are already measured
+ * by spec-coverage, so only `design-only` / `conflict` items are reported uncovered.
+ *
+ * Advisory: findings never move the score or the gate.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const spec_coverage_1 = require("./spec-coverage");
+const read_text_1 = require("./read-text");
+const IMAGE = /\.(png|jpe?g|webp|gif)$/i;
+/** Every design source in a unit's `requirements/` — what makes an inventory necessary. */
+function designSourcesOf(reqDir) {
+    const out = [];
+    const uiDir = path.join(reqDir, 'ui');
+    try {
+        for (const f of fs.readdirSync(uiDir).sort()) {
+            if (IMAGE.test(f) || f === 'figma-meta.md')
+                out.push(`ui/${f}`);
+        }
+    }
+    catch { /* no ui/ dir */ }
+    if (fs.existsSync(path.join(reqDir, 'spec_figma.md')))
+        out.push('spec_figma.md');
+    return out;
+}
+/**
+ * The Source cell, read leniently ("design only", "Spec + Design", "conflict — …"). Anything else
+ * is NOT assumed to be spec-backed: an unreadable source is reported like a design-only item, so a
+ * typo can never make an item disappear from the check.
+ */
+function sourceOf(cell) {
+    const c = cell.trim().toLowerCase();
+    if (/^design[\s_-]*only\b/.test(c))
+        return 'design-only';
+    if (/^conflict\b/.test(c))
+        return 'conflict';
+    if (/^spec\s*(?:\+|&|and)\s*design\b/.test(c))
+        return 'spec+design';
+    return null;
+}
+/**
+ * Parse the inventory table: any markdown row whose first cell is a `UI-<n>` id. Leading/trailing
+ * pipes are optional (GFM), and the Source cell is FOUND rather than counted — a `|` written inside
+ * the Item cell shifts the columns, and a positional read then misfiled a design-only row.
+ */
+function parseUiInventory(text) {
+    const items = [];
+    for (const line of text.split('\n')) {
+        if (!line.includes('|'))
+            continue;
+        const cells = line.trim().replace(/^\|/, '').replace(/\|$/, '').split('|').map((c) => c.trim());
+        if (!/^UI-\d+$/i.test(cells[0] ?? ''))
+            continue;
+        // Source = the last cell that reads as one (Seen-in follows it; prose in Item never starts so).
+        let srcIdx = -1;
+        for (let i = cells.length - 1; i >= 2; i--)
+            if (sourceOf(cells[i])) {
+                srcIdx = i;
+                break;
+            }
+        const source = srcIdx >= 0 ? sourceOf(cells[srcIdx]) : 'design-only';
+        const kindIdx = srcIdx >= 0 ? srcIdx - 1 : Math.min(2, cells.length - 1);
+        items.push({
+            id: cells[0].toUpperCase(),
+            item: cells.slice(1, Math.max(2, kindIdx)).join(' | '),
+            kind: cells[kindIdx] ?? '',
+            source,
+        });
+    }
+    const m = text.match(/images read:\s*(\d+)\s*\/\s*(\d+)/i);
+    return { items, imagesRead: m ? { read: Number(m[1]), total: Number(m[2]) } : null };
+}
+/**
+ * Ids cited on a `UI-DEFERRED` comment line — a deliberate, REASONED omission. A line that lists
+ * ids and nothing else is not a decision anyone can review, so it defers nothing.
+ */
+function deferredIds(featureText) {
+    const lines = featureText.split('\n').filter((l) => {
+        if (!/^\s*#\s*UI-DEFERRED\b/i.test(l))
+            return false;
+        const reason = l.replace(/^\s*#\s*UI-DEFERRED\b\s*:?/i, '').replace(/\bUI-\d+(?:\s*(?:\.\.|–|—|~|\/)\s*(?:UI-)?\d+)*/gi, '');
+        return /[\p{L}]{3,}/u.test(reason);
+    });
+    return (0, spec_coverage_1.citedIds)(lines.join('\n'));
+}
+function uiInventoryCoverage(reqDir, featureText) {
+    const designSources = designSourcesOf(reqDir);
+    const invPath = path.join(reqDir, 'ui-inventory.md');
+    const invText = fs.existsSync(invPath) ? (0, read_text_1.readTextFile)(invPath) : null;
+    const { items, imagesRead } = invText ? parseUiInventory(invText) : { items: [], imagesRead: null };
+    // Coverage is the `@ui:` TAG, nothing else: a `UI-001`-shaped string elsewhere (an `@spec:UI-001`
+    // requirement in a project that numbers its FRs that way, prose, an unreasoned deferral line)
+    // must not mark a design item as proven.
+    const cites = (0, spec_coverage_1.citedIds)((featureText.match(/@ui:\S+/gi) ?? []).join(' '));
+    const deferSet = deferredIds(featureText);
+    const covered = [];
+    const deferred = [];
+    const uncovered = [];
+    for (const it of items) {
+        if (deferSet.has(it.id))
+            deferred.push(it.id);
+        else if (cites.has(it.id))
+            covered.push(it.id);
+        else if (it.source !== 'spec+design')
+            uncovered.push(it);
+    }
+    return {
+        designSources,
+        hasInventory: invText !== null,
+        items,
+        imagesRead,
+        imagesOnDisk: designSources.filter((s) => IMAGE.test(s)).length,
+        covered,
+        deferred,
+        uncovered,
+    };
+}
+/** Advisory findings for the audit report. */
+function uiInventoryFindings(r) {
+    const out = [];
+    if (r.designSources.length === 0)
+        return out;
+    if (!r.hasInventory) {
+        out.push(`UI-INVENTORY-MISSING: the unit has design sources (${r.designSources.slice(0, 4).join(', ')}${r.designSources.length > 4 ? ', …' : ''}) but no \`requirements/ui-inventory.md\` — nothing shows the design was read item by item, so an item that exists only on the design (or contradicts the spec) is invisible to the gate and to review. Re-run /sungen:create-test so it writes the inventory, or write it by hand: one \`| UI-NNN | item | kind | spec+design / design-only / conflict |\` row per component, column, button, state and annotation.`);
+        return out;
+    }
+    if (r.imagesRead && r.imagesRead.read < Math.max(r.imagesRead.total, r.imagesOnDisk)) {
+        out.push(`UI-INVENTORY-INCOMPLETE: the inventory records "images read: ${r.imagesRead.read}/${r.imagesRead.total}" and the unit holds ${r.imagesOnDisk} image(s) — the unread design is not inventoried. Read the remaining images and add their items.`);
+    }
+    else if (!r.imagesRead && r.imagesOnDisk > 0) {
+        out.push(`UI-INVENTORY-INCOMPLETE: the unit holds ${r.imagesOnDisk} image(s) but the inventory does not record "images read: N/N" — nothing shows every image was opened. Add the line after reading them all.`);
+    }
+    for (const it of r.uncovered.slice(0, 10)) {
+        out.push(`UI-ITEM-UNCOVERED: ${it.id} "${it.item}" (${it.kind}, ${it.source}) has no scenario and no deferral — ${it.source === 'conflict' ? 'the design and spec.md disagree on it; resolve which is right, then cover it' : 'it exists only on the design, outside spec.md'}. Cover it (\`@ui:${it.id}\` on the scenario that proves it), or record the decision: \`# UI-DEFERRED: ${it.id} — <reason>\`.`);
+    }
+    if (r.uncovered.length > 10)
+        out.push(`UI-ITEM-UNCOVERED: … and ${r.uncovered.length - 10} more design-only/conflict item(s).`);
+    return out;
+}
+//# sourceMappingURL=ui-inventory.js.map

package/dist/harness/ui-inventory.js.map

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

package/dist/harness/viewpoint-baseline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"viewpoint-baseline.d.ts","sourceRoot":"","sources":["../../src/harness/viewpoint-baseline.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,+FAA+F;AAC/F,eAAO,MAAM,wBAAwB,2CAA4C,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;IACnD,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAmDD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,iBAAiB,CAiCnB;AAED,mGAAmG;AACnG,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,IAAI,CASN;AAED,sFAAsF;AACtF,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKxH"}
+{"version":3,"file":"viewpoint-baseline.d.ts","sourceRoot":"","sources":["../../src/harness/viewpoint-baseline.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,+FAA+F;AAC/F,eAAO,MAAM,wBAAwB,2CAA4C,CAAC;AAElF,MAAM,WAAW,iBAAiB;IAChC,MAAM,EAAE,QAAQ,GAAG,KAAK,GAAG,WAAW,GAAG,SAAS,CAAC;IACnD,+EAA+E;IAC/E,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,EAAE,CAAC;IACd,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB;;;OAGG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,wFAAwF;IACxF,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAwDD;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,aAAa,EAAE,MAAM,GACpB,iBAAiB,CAiCnB;AAED,mGAAmG;AACnG,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAAE,GAC1D,IAAI,CASN;AAED,sFAAsF;AACtF,wBAAgB,wBAAwB,CAAC,aAAa,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAKxH"}

package/dist/harness/viewpoint-baseline.js

@@ -41,6 +41,7 @@ const crypto = __importStar(require("crypto"));
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
 const parse_1 = require("./parse");
+const viewpoint_draft_header_1 = require("./viewpoint-draft-header");
 /**
  * Keep the yardstick from moving with the thing it measures.
  *
@@ -100,7 +101,12 @@ function fingerprint(ids) {
  */
 function fileFingerprint(viewpointPath) {
     try {
-        return crypto.createHash('sha1').update(fs.readFileSync(viewpointPath)).digest('hex').slice(0, 12);
+        const bytes = fs.readFileSync(viewpointPath);
+        // `drafted-by: ai` is provenance that accept REMOVES, so it is not part of what was reviewed:
+        // counted, accepting a draft would read as the declaration changing. Every other byte stays raw.
+        const text = bytes.toString('utf-8');
+        const hashed = (0, viewpoint_draft_header_1.isAiDraft)(text) ? Buffer.from((0, viewpoint_draft_header_1.removeDraftLine)(text), 'utf-8') : bytes;
+        return crypto.createHash('sha1').update(hashed).digest('hex').slice(0, 12);
     }
     catch {
         return '';

package/dist/harness/viewpoint-baseline.js.map

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

package/dist/harness/viewpoint-draft-header.d.ts

@@ -0,0 +1,7 @@
+export declare function isAiDraft(text: string): boolean;
+/** `raw` without the one draft line; every other byte is untouched. A file with no draft line comes back as is. */
+export declare function removeDraftLine(raw: string): string;
+export declare function viewpointFileIsAiDraft(viewpointPath: string): boolean;
+/** Remove the draft line from the file, atomically. True when a line was removed; throws a clear error when the write fails. */
+export declare function removeDraftLineFromFile(viewpointPath: string): boolean;
+//# sourceMappingURL=viewpoint-draft-header.d.ts.map

package/dist/harness/viewpoint-draft-header.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewpoint-draft-header.d.ts","sourceRoot":"","sources":["../../src/harness/viewpoint-draft-header.ts"],"names":[],"mappings":"AA+BA,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE/C;AAED,mHAAmH;AACnH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAInD;AAED,wBAAgB,sBAAsB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAErE;AAED,gIAAgI;AAChI,wBAAgB,uBAAuB,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAOtE"}