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

package/dist/harness/viewpoint-review-open.js

@@ -0,0 +1,90 @@
+"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.VIEWPOINT_REVIEW_FILE = void 0;
+exports.openReviewPoints = openReviewPoints;
+exports.viewpointReviewOpenFindings = viewpointReviewOpenFindings;
+/**
+ * VIEWPOINT-REVIEW-OPEN (info) — the audit's one line about `requirements/viewpoint-review.md`.
+ *
+ * create-test reviews test-viewpoint.md with the sungen-viewpoint checklist and writes each point a
+ * QA should look at as a table row whose last cell is `[ ]`; the QA ticks it `[x]` or deletes the
+ * row. While rows stay unticked the audit says how many, once. Advisory only: no score, no gate, no
+ * baseline effect. A missing or unreadable file says nothing — the review is optional input.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const read_text_1 = require("./read-text");
+exports.VIEWPOINT_REVIEW_FILE = 'viewpoint-review.md';
+const SEPARATOR = /^\s*\|?\s*:?-{2,}:?\s*(\|\s*:?-{2,}:?\s*)*\|?\s*$/;
+/** A table separator, not a `---` rule under a row. */
+const isSeparator = (line) => SEPARATOR.test(line) && line.includes('|');
+const UNTICKED = /^\[\s?\]$/;
+/** The last cell of a markdown table row, or null for a line that is not one. */
+function lastCell(line) {
+    const t = line.trim();
+    if (!t.startsWith('|') || !t.endsWith('|') || t.length < 2)
+        return null;
+    const cells = t.slice(1, -1).split(/(?<!\\)\|/);
+    return cells[cells.length - 1].trim();
+}
+/** Body rows whose last cell is `[ ]`. The header row (`… | [ ] |` above `|---|`) is not a point. */
+function openReviewPoints(text) {
+    const lines = (0, read_text_1.stripHtmlComments)(text.replace(/\r\n?/g, '\n')).split('\n');
+    let open = 0;
+    for (let i = 0; i < lines.length; i++) {
+        if (isSeparator(lines[i]) || isSeparator(lines[i + 1] ?? ''))
+            continue;
+        const last = lastCell(lines[i]);
+        if (last !== null && UNTICKED.test(last))
+            open++;
+    }
+    return open;
+}
+/** The info finding for one unit's `requirements/` directory; empty when nothing is open. */
+function viewpointReviewOpenFindings(requirementsDir) {
+    let text;
+    try {
+        text = fs.readFileSync(path.join(requirementsDir, exports.VIEWPOINT_REVIEW_FILE), 'utf-8');
+    }
+    catch {
+        return [];
+    }
+    const open = openReviewPoints(text);
+    if (open === 0)
+        return [];
+    return [`VIEWPOINT-REVIEW-OPEN (info): ${open} open point(s) in requirements/${exports.VIEWPOINT_REVIEW_FILE} — the checklist review of test-viewpoint.md is waiting for QA. QA: fix the viewpoint where you agree, then tick the row \`[x]\` or delete it. Not scored; an agent does not tick rows for the QA.`];
+}
+//# sourceMappingURL=viewpoint-review-open.js.map

package/dist/harness/viewpoint-review-open.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewpoint-review-open.js","sourceRoot":"","sources":["../../src/harness/viewpoint-review-open.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA4BA,4CASC;AAGD,kEAUC;AAlDD;;;;;;;GAOG;AACH,uCAAyB;AACzB,2CAA6B;AAC7B,2CAAgD;AAEnC,QAAA,qBAAqB,GAAG,qBAAqB,CAAC;AAE3D,MAAM,SAAS,GAAG,mDAAmD,CAAC;AACtE,uDAAuD;AACvD,MAAM,WAAW,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;AAC1F,MAAM,QAAQ,GAAG,WAAW,CAAC;AAE7B,iFAAiF;AACjF,SAAS,QAAQ,CAAC,IAAY;IAC5B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IACtB,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACxE,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;IAChD,OAAO,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;AACxC,CAAC;AAED,qGAAqG;AACrG,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,MAAM,KAAK,GAAG,IAAA,6BAAiB,EAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC1E,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,WAAW,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;YAAE,SAAS;QACvE,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QAChC,IAAI,IAAI,KAAK,IAAI,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,IAAI,EAAE,CAAC;IACnD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,6FAA6F;AAC7F,SAAgB,2BAA2B,CAAC,eAAuB;IACjE,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QACH,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,EAAE,6BAAqB,CAAC,EAAE,OAAO,CAAC,CAAC;IACrF,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;IACD,MAAM,IAAI,GAAG,gBAAgB,CAAC,IAAI,CAAC,CAAC;IACpC,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IAC1B,OAAO,CAAC,iCAAiC,IAAI,kCAAkC,6BAAqB,oMAAoM,CAAC,CAAC;AAC5S,CAAC"}

package/dist/harness/viewpoint-scan-refs.d.ts

@@ -0,0 +1,50 @@
+export interface TableRow {
+    /** 1-based line in the (comment-stripped, newline-preserving) text. */
+    line: number;
+    raw: string;
+    /** Cells with `**`, backticks and edge spaces removed. */
+    cells: string[];
+    /** The table's header cells; null for a table with no separator line. */
+    header: string[] | null;
+    /** Text of every heading enclosing the row (outermost first) — where a `# MANUAL/ENV` mark may sit. */
+    section: string;
+}
+/** Every body row of every markdown table, with its header and enclosing headings. */
+export declare function tableRows(text: string): TableRow[];
+/** `009` → `9`, `4.03` → `4.3`; null when the text is not a plain (dotted) number. */
+export declare function normRef(s: string): string | null;
+/**
+ * Item numbers a cell cites: `item 9`, `item 2, 3, 7`, `item 4–6`, `item 5.4–5.8`, `項目 4.3〜4.6`, `UI #9`,
+ * `UI-009`, `[9]`, `§4.3.2`. Prose (`Auth guard`), message codes (`M02`) and question ids
+ * (`Q-01`) are not refs.
+ */
+export declare function extractRefs(text: string): string[];
+export type ItemSource = 'spec-ids' | 'spec-table' | 'spec-ids+spec-table' | 'ui-inventory' | 'none';
+export interface UniverseItem {
+    ref: string;
+    name: string;
+}
+/** Every list a citation could point at, each in its own notation. */
+export interface ItemUniverses {
+    specIds: UniverseItem[];
+    specTable: UniverseItem[];
+    inventory: UniverseItem[];
+}
+/**
+ * The unit's lists, by where each id is DECLARED: requirement ids spec.md declares (`**FR-BC-03**:`),
+ * the spec's item table (`No` + name + type columns), and ui-inventory ids (`UI-NNN`). An id's shape
+ * says nothing about which list it belongs to — `item 9` on a mockup and `UI-009` in the inventory
+ * number different things.
+ */
+export declare function itemUniverses(reqDir: string): ItemUniverses;
+/**
+ * The list(s) the viewpoint actually cites — a list nobody cites says nothing about gaps. The spec's
+ * ids and its item table, each when cited (both when both are: the notations cannot collide, and
+ * dropping one would under-report); the table also when nothing is cited at all (then every item is
+ * uncited, which is true); the inventory only when the viewpoint writes `UI-NNN`; else none.
+ */
+export declare function citedUniverse(u: ItemUniverses, cited: ReadonlySet<string>, writesInventoryIds: boolean): {
+    source: ItemSource;
+    items: UniverseItem[];
+};
+//# sourceMappingURL=viewpoint-scan-refs.d.ts.map

package/dist/harness/viewpoint-scan-refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewpoint-scan-refs.d.ts","sourceRoot":"","sources":["../../src/harness/viewpoint-scan-refs.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,QAAQ;IACvB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,0DAA0D;IAC1D,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,yEAAyE;IACzE,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACxB,uGAAuG;IACvG,OAAO,EAAE,MAAM,CAAC;CACjB;AAMD,sFAAsF;AACtF,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,QAAQ,EAAE,CAelD;AAKD,sFAAsF;AACtF,wBAAgB,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGhD;AAkBD;;;;GAIG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAiBlD;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,YAAY,GAAG,qBAAqB,GAAG,cAAc,GAAG,MAAM,CAAC;AACrG,MAAM,WAAW,YAAY;IAAG,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC3D,sEAAsE;AACtE,MAAM,WAAW,aAAa;IAAG,OAAO,EAAE,YAAY,EAAE,CAAC;IAAC,SAAS,EAAE,YAAY,EAAE,CAAC;IAAC,SAAS,EAAE,YAAY,EAAE,CAAA;CAAE;AAMhH;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,aAAa,CA2B3D;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,EAAE,WAAW,CAAC,MAAM,CAAC,EAAE,kBAAkB,EAAE,OAAO,GAAG;IAAE,MAAM,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,YAAY,EAAE,CAAA;CAAE,CAStJ"}

package/dist/harness/viewpoint-scan-refs.js

@@ -0,0 +1,200 @@
+"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.tableRows = tableRows;
+exports.normRef = normRef;
+exports.extractRefs = extractRefs;
+exports.itemUniverses = itemUniverses;
+exports.citedUniverse = citedUniverse;
+/**
+ * Building blocks of `sungen viewpoint scan` (viewpoint-scan.ts): the markdown table walker, the
+ * item-reference reader and the item universe. Pure, read-only, format-tolerant by design — a
+ * QA-written file is never judged here, only its ids and item numbers are read.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const read_text_1 = require("./read-text");
+const ui_inventory_1 = require("./ui-inventory");
+const spec_coverage_1 = require("./spec-coverage");
+const SEPARATOR = /^\s*\|?\s*:?-{2,}:?\s*(\|\s*:?-{2,}:?\s*)*\|?\s*$/;
+const splitCells = (line) => line.trim().replace(/^\|/, '').replace(/\|$/, '')
+    .split(/(?<!\\)\|/).map((c) => c.replace(/\*\*|`/g, '').trim());
+/** Every body row of every markdown table, with its header and enclosing headings. */
+function tableRows(text) {
+    const lines = text.split('\n');
+    const out = [];
+    const headings = []; // index = level − 1
+    let header = null;
+    for (let i = 0; i < lines.length; i++) {
+        const raw = lines[i];
+        const h = raw.match(/^(#{1,6})\s+(.*)$/);
+        if (h) {
+            headings.length = h[1].length - 1;
+            headings[h[1].length - 1] = h[2];
+            header = null;
+            continue;
+        }
+        if (!raw.includes('|')) {
+            header = null;
+            continue;
+        }
+        if (SEPARATOR.test(raw))
+            continue;
+        if (i + 1 < lines.length && SEPARATOR.test(lines[i + 1])) {
+            header = splitCells(raw);
+            continue;
+        }
+        out.push({ line: i + 1, raw, cells: splitCells(raw), header, section: headings.join(' ') });
+    }
+    return out;
+}
+const NUM = String.raw `(?<!\d)\d{1,3}(?:\.\d{1,3})*(?![\d])`;
+const LIST = new RegExp(`(?:\\bitems?|項目|(?<![\\w-])UI[\\s-]*#?|#)\\s*(${NUM}(?:\\s*(?:[-–—~〜～,;&/]|(?<![\\p{L}\\p{N}])(?:và|and)(?![\\p{L}\\p{N}]))\\s*${NUM})*)`, 'giu');
+/** `009` → `9`, `4.03` → `4.3`; null when the text is not a plain (dotted) number. */
+function normRef(s) {
+    const t = s.replace(/[[\]§#]/g, '').trim();
+    return /^\d+(\.\d+)*$/.test(t) ? t.split('.').map((p) => String(Number(p))).join('.') : null;
+}
+/**
+ * The refs strictly between `a` and `b` (normalised): `4`–`6` → `5`, `5.4`–`5.8` → `5.5 … 5.7`.
+ * Only the last level steps, so both ends need the same prefix; `5.4–6.2` or `3–5.2` cannot be
+ * enumerated without the item list and give nothing.
+ */
+function between(a, b) {
+    const pa = a.split('.');
+    const pb = b.split('.');
+    if (pa.length !== pb.length || pa.slice(0, -1).join('.') !== pb.slice(0, -1).join('.'))
+        return [];
+    const lo = Number(pa[pa.length - 1]);
+    const hi = Number(pb[pb.length - 1]);
+    if (!(hi > lo && hi - lo < 200))
+        return [];
+    const prefix = pa.slice(0, -1).map((p) => `${p}.`).join('');
+    return Array.from({ length: hi - lo - 1 }, (_, k) => `${prefix}${lo + 1 + k}`);
+}
+/**
+ * Item numbers a cell cites: `item 9`, `item 2, 3, 7`, `item 4–6`, `item 5.4–5.8`, `項目 4.3〜4.6`, `UI #9`,
+ * `UI-009`, `[9]`, `§4.3.2`. Prose (`Auth guard`), message codes (`M02`) and question ids
+ * (`Q-01`) are not refs.
+ */
+function extractRefs(text) {
+    const refs = new Set();
+    const add = (s) => { const r = normRef(s); if (r)
+        refs.add(r); };
+    for (const m of text.matchAll(LIST)) {
+        let prev = null;
+        let range = false;
+        for (const tok of m[1].matchAll(new RegExp(`(${NUM})|([-–—~〜～])`, 'g'))) {
+            if (tok[2]) {
+                range = prev !== null;
+                continue;
+            }
+            const n = normRef(tok[1]);
+            if (!n)
+                continue;
+            if (range && prev)
+                for (const r of between(prev, n))
+                    refs.add(r);
+            refs.add(n);
+            prev = n;
+            range = false;
+        }
+    }
+    for (const m of text.matchAll(/\[(\d{1,3})\]/g))
+        add(m[1]);
+    for (const m of text.matchAll(/§\s*(\d{1,3}(?:\.\d{1,3})*)/g))
+        add(m[1]);
+    return [...refs];
+}
+const NO_COL = /^(no\.?|#|stt|№|番号)$/i;
+const TYPE_COL = /種別|\b(type|kind)\b|loại/i;
+const NAME_COL = /item|name|tên|項目|名|field|label|trường|thành phần|component/i;
+/**
+ * The unit's lists, by where each id is DECLARED: requirement ids spec.md declares (`**FR-BC-03**:`),
+ * the spec's item table (`No` + name + type columns), and ui-inventory ids (`UI-NNN`). An id's shape
+ * says nothing about which list it belongs to — `item 9` on a mockup and `UI-009` in the inventory
+ * number different things.
+ */
+function itemUniverses(reqDir) {
+    const read = (f) => {
+        const p = path.join(reqDir, f);
+        return fs.existsSync(p) ? (0, read_text_1.stripHtmlComments)((0, read_text_1.readTextFile)(p)) : null;
+    };
+    const out = { specIds: [], specTable: [], inventory: [] };
+    const spec = read('spec.md');
+    if (spec) {
+        out.specIds = (0, spec_coverage_1.parseSpecClauses)(path.join(reqDir, 'spec.md')).frs.map((f) => ({ ref: f.id, name: f.text.slice(0, 80) }));
+        for (const row of tableRows(spec)) {
+            const h = row.header;
+            const no = h?.findIndex((c) => NO_COL.test(c)) ?? -1;
+            const type = h?.findIndex((c) => TYPE_COL.test(c)) ?? -1;
+            const name = h?.findIndex((c, i) => i !== no && i !== type && NAME_COL.test(c)) ?? -1;
+            if (no < 0 || type < 0 || name < 0)
+                continue;
+            const ref = normRef(row.cells[no] ?? '');
+            if (ref)
+                out.specTable.push({ ref, name: row.cells[name] ?? '' });
+        }
+    }
+    const inv = read('ui-inventory.md');
+    if (inv) {
+        out.inventory = (0, ui_inventory_1.parseUiInventory)(inv).items.flatMap((i) => {
+            const ref = normRef(i.id.replace(/^UI-/i, ''));
+            return ref ? [{ ref, name: i.item }] : [];
+        });
+    }
+    return out;
+}
+/**
+ * The list(s) the viewpoint actually cites — a list nobody cites says nothing about gaps. The spec's
+ * ids and its item table, each when cited (both when both are: the notations cannot collide, and
+ * dropping one would under-report); the table also when nothing is cited at all (then every item is
+ * uncited, which is true); the inventory only when the viewpoint writes `UI-NNN`; else none.
+ */
+function citedUniverse(u, cited, writesInventoryIds) {
+    const hits = (items) => items.some((i) => cited.has(i.ref));
+    const ids = hits(u.specIds);
+    const table = u.specTable.length > 0 && (cited.size === 0 || hits(u.specTable));
+    if (ids && table)
+        return { source: 'spec-ids+spec-table', items: [...u.specIds, ...u.specTable] };
+    if (ids)
+        return { source: 'spec-ids', items: u.specIds };
+    if (table)
+        return { source: 'spec-table', items: u.specTable };
+    if (writesInventoryIds && hits(u.inventory))
+        return { source: 'ui-inventory', items: u.inventory };
+    return { source: 'none', items: [] };
+}
+//# sourceMappingURL=viewpoint-scan-refs.js.map

package/dist/harness/viewpoint-scan-refs.js.map

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

package/dist/harness/viewpoint-scan.d.ts

@@ -0,0 +1,41 @@
+import { ItemSource } from './viewpoint-scan-refs';
+import { ViewpointMode } from './viewpoint-mode';
+export interface VpRow {
+    id: string;
+    line: number;
+    /** Item numbers the row cites (normalised: `009` → `9`), and spec-declared ids it cites (`FR-BC-03`). */
+    refs: string[];
+    /** `# MANUAL/ENV` or `@manual` on the row or an enclosing heading. */
+    manual: boolean;
+    /** The Kỳ vọng / Expected cell has text (best effort when the table has no such header). */
+    hasExpected: boolean;
+}
+export interface ViewpointScan {
+    /** The create-test mode this file calls for (viewpoint-mode.ts): 2 = AI drafts, 1 = review only. */
+    mode: ViewpointMode;
+    modeReason: string;
+    vpRows: VpRow[];
+    /** Distinct VP ids among `vpRows` — a reused id is several rows but one id. */
+    distinctIds: number;
+    rowsWithoutExpected: string[];
+    manualRows: string[];
+    itemSource: ItemSource;
+    /** Spec/inventory items no VP row cites — a hint for the review, not a verdict. */
+    uncitedItems: {
+        ref: string;
+        name: string;
+    }[];
+    /** VP ids no feature file mentions; null when the unit has no feature file yet. */
+    withoutScenario: string[] | null;
+    /** Why `vpRows` is empty, else null. */
+    note: string | null;
+}
+export declare const NO_VP_IDS_NOTE = "file has no VP ids; review falls back to AI-only";
+/**
+ * VP rows of one viewpoint text (already comment-stripped, as `readViewpointText` returns it).
+ * `specIds`: the requirement ids spec.md declares — only those count as spec citations.
+ */
+export declare function scanViewpointText(text: string, specIds?: ReadonlySet<string>): VpRow[];
+/** Scan one unit directory (`qa/screens/<n>`, `qa/flows/<n>`, …); `unit` names its feature files. */
+export declare function scanViewpointUnit(unitDir: string, unit: string): ViewpointScan;
+//# sourceMappingURL=viewpoint-scan.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"viewpoint-scan.d.ts","sourceRoot":"","sources":["../../src/harness/viewpoint-scan.ts"],"names":[],"mappings":"AAeA,OAAO,EAAwD,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACzG,OAAO,EAAiB,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAEhE,MAAM,WAAW,KAAK;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,yGAAyG;IACzG,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,sEAAsE;IACtE,MAAM,EAAE,OAAO,CAAC;IAChB,4FAA4F;IAC5F,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC5B,oGAAoG;IACpG,IAAI,EAAE,aAAa,CAAC;IACpB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,KAAK,EAAE,CAAC;IAChB,+EAA+E;IAC/E,WAAW,EAAE,MAAM,CAAC;IACpB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,EAAE,UAAU,CAAC;IACvB,mFAAmF;IACnF,YAAY,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC9C,mFAAmF;IACnF,eAAe,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;IACjC,wCAAwC;IACxC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAUD,eAAO,MAAM,cAAc,qDAAqD,CAAC;AAEjF;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,WAAW,CAAC,MAAM,CAAa,GAAG,KAAK,EAAE,CAoBjG;AAED,qGAAqG;AACrG,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,aAAa,CA0B9E"}

package/dist/harness/viewpoint-scan.js

@@ -0,0 +1,118 @@
+"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.NO_VP_IDS_NOTE = void 0;
+exports.scanViewpointText = scanViewpointText;
+exports.scanViewpointUnit = scanViewpointUnit;
+/**
+ * `sungen viewpoint scan` — the code half of reviewing a QA-written test-viewpoint.md.
+ *
+ * It does set arithmetic on ids and nothing else: which VP rows exist, what each cites, which spec
+ * items nobody cites, which ids no scenario carries. It never judges meaning, never edits the file,
+ * and feeds no audit finding, score or baseline.
+ *
+ * A VP row is a markdown table row whose FIRST cell is a full id (`VP-UI-001`, `FL-LOGIN-3`).
+ * Priority-table rows (`VP-LOGIN (Auth)`), bullets and appendix text are not rows. This is
+ * deliberately NOT `parseViewpointItems` (viewpoint-ledger.ts), which also reads id-less rows.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const read_text_1 = require("./read-text");
+const unit_paths_1 = require("./unit-paths");
+const viewpoint_scan_refs_1 = require("./viewpoint-scan-refs");
+const viewpoint_mode_1 = require("./viewpoint-mode");
+const VP_ID = /^(VP|FL)-[A-Z][A-Z0-9]*(-[A-Z0-9]+)*-\d+$/;
+const MANUAL = /\bMANUAL\/ENV\b|@manual\b/i;
+const EXPECTED_COL = /kỳ vọng|kết quả mong đợi|expected|期待/i;
+/** Whole-word match (Unicode-aware: `\b` fails on `ồ`) so `Resource` / `Datasource` are not a source column. */
+const SOURCE_COL = /(?<![\p{L}\p{N}])(?:nguồn|source|tham chiếu|ref|出典|根拠)(?![\p{L}\p{N}])/iu;
+const PRIORITY = /^(critical|high|med(?:ium)?|low|cao|trung bình|thấp)$/i;
+const BLANK = /^[\s\-–—…]*$/;
+const SPEC_ID = /(?<![\w-])[A-Z][A-Z0-9]*(?:-[A-Z0-9]+)*-\d+[A-Z]?(?![\w-])/gi;
+exports.NO_VP_IDS_NOTE = 'file has no VP ids; review falls back to AI-only';
+/**
+ * VP rows of one viewpoint text (already comment-stripped, as `readViewpointText` returns it).
+ * `specIds`: the requirement ids spec.md declares — only those count as spec citations.
+ */
+function scanViewpointText(text, specIds = new Set()) {
+    const rows = [];
+    for (const r of (0, viewpoint_scan_refs_1.tableRows)(text)) {
+        const id = r.cells[0];
+        if (!VP_ID.test(id))
+            continue;
+        const exp = r.header?.findIndex((c) => EXPECTED_COL.test(c)) ?? -1;
+        const src = r.header?.findIndex((c) => SOURCE_COL.test(c)) ?? -1;
+        const cites = src > 0 ? r.cells[src] ?? '' : r.cells.slice(1).join(' | ');
+        rows.push({
+            id,
+            line: r.line,
+            refs: [...(0, viewpoint_scan_refs_1.extractRefs)(cites), ...[...cites.matchAll(SPEC_ID)].map((m) => m[0].toUpperCase()).filter((id) => specIds.has(id))],
+            manual: MANUAL.test(r.raw) || MANUAL.test(r.section),
+            // Without a Kỳ vọng header: any later cell with text that is neither a priority word nor a ref.
+            hasExpected: exp > 0
+                ? !BLANK.test(r.cells[exp] ?? '')
+                : r.cells.slice(2).some((c) => !BLANK.test(c) && !PRIORITY.test(c) && (0, viewpoint_scan_refs_1.extractRefs)(c).length === 0),
+        });
+    }
+    return rows;
+}
+/** Scan one unit directory (`qa/screens/<n>`, `qa/flows/<n>`, …); `unit` names its feature files. */
+function scanViewpointUnit(unitDir, unit) {
+    const reqDir = path.join(unitDir, 'requirements');
+    const vpPath = path.join(reqDir, 'test-viewpoint.md');
+    const vpText = (0, read_text_1.readViewpointText)(vpPath);
+    const universes = (0, viewpoint_scan_refs_1.itemUniverses)(reqDir);
+    const vpRows = scanViewpointText(vpText, new Set(universes.specIds.map((i) => i.ref)));
+    const { mode, reason } = (0, viewpoint_mode_1.viewpointMode)(fs.existsSync(vpPath) ? (0, read_text_1.readTextFile)(vpPath) : null, vpRows);
+    const cited = new Set(vpRows.flatMap((r) => r.refs));
+    const { source, items } = (0, viewpoint_scan_refs_1.citedUniverse)(universes, cited, /(?<![\w-])UI-\d{1,3}\b/i.test(vpText));
+    const features = (0, unit_paths_1.featureFilesFor)(unitDir, unit).filter((f) => fs.existsSync(f));
+    // Same rule as the ledger (viewpoint-ledger.ts): an id is carried when the feature text contains it.
+    const featureText = features.map((f) => (0, read_text_1.readTextFile)(f).toLowerCase()).join('\n');
+    return {
+        mode,
+        modeReason: reason,
+        vpRows,
+        distinctIds: new Set(vpRows.map((r) => r.id)).size,
+        rowsWithoutExpected: vpRows.filter((r) => !r.hasExpected).map((r) => r.id),
+        manualRows: vpRows.filter((r) => r.manual).map((r) => r.id),
+        itemSource: source,
+        uncitedItems: items.filter((i) => !cited.has(i.ref)),
+        withoutScenario: features.length === 0 ? null : vpRows.filter((r) => !featureText.includes(r.id.toLowerCase())).map((r) => r.id),
+        note: vpRows.length > 0 ? null
+            : fs.existsSync(vpPath) ? exports.NO_VP_IDS_NOTE : 'requirements/test-viewpoint.md is missing',
+    };
+}
+//# sourceMappingURL=viewpoint-scan.js.map

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

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

package/dist/harness/write-atomic.d.ts

@@ -0,0 +1,2 @@
+export declare function writeFileAtomic(file: string, data: string): void;
+//# sourceMappingURL=write-atomic.d.ts.map

package/dist/harness/write-atomic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-atomic.d.ts","sourceRoot":"","sources":["../../src/harness/write-atomic.ts"],"names":[],"mappings":"AAYA,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAShE"}

package/dist/harness/write-atomic.js

@@ -0,0 +1,62 @@
+"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.writeFileAtomic = writeFileAtomic;
+/**
+ * Write a file so that a crash mid-write can never leave a truncated one behind: write a sibling
+ * tmp, then rename. Same directory = same device, so the rename is atomic; a concurrent writer is
+ * last-rename-wins. On failure the tmp is removed and the error rethrown — the caller still learns.
+ *
+ * `results merge` and `results sanitize` each grew this block inline, for the same reason and with
+ * the same comment. The third caller (`ai-skills/writer.ts`) did not, and its truncated manifest is
+ * precisely the corrupt input that #782's readers then absorbed in silence — so the two halves of
+ * that defect are one file apart.
+ */
+const fs = __importStar(require("fs"));
+function writeFileAtomic(file, data) {
+    const tmp = `${file}.tmp-${process.pid}`;
+    try {
+        fs.writeFileSync(tmp, data);
+        fs.renameSync(tmp, file);
+    }
+    catch (err) {
+        try {
+            fs.rmSync(tmp, { force: true });
+        }
+        catch { /* best-effort cleanup — the real error is below */ }
+        throw err;
+    }
+}
+//# sourceMappingURL=write-atomic.js.map

package/dist/harness/write-atomic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"write-atomic.js","sourceRoot":"","sources":["../../src/harness/write-atomic.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,0CASC;AArBD;;;;;;;;;GASG;AACH,uCAAyB;AAEzB,SAAgB,eAAe,CAAC,IAAY,EAAE,IAAY;IACxD,MAAM,GAAG,GAAG,GAAG,IAAI,QAAQ,OAAO,CAAC,GAAG,EAAE,CAAC;IACzC,IAAI,CAAC;QACH,EAAE,CAAC,aAAa,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC5B,EAAE,CAAC,UAAU,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,CAAC;YAAC,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,mDAAmD,CAAC,CAAC;QACtG,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/orchestrator/ai-skills/writer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/ai-skills/writer.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,MAAM,WAAW,YAAY;IAAG,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACpF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IAClE,cAAc,EAAE,MAAM,EAAE,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CACtD;AA2BD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG,WAAW,CA4E/F"}
+{"version":3,"file":"writer.d.ts","sourceRoot":"","sources":["../../../src/orchestrator/ai-skills/writer.ts"],"names":[],"mappings":"AAgBA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAKpC,MAAM,WAAW,YAAY;IAAG,KAAK,CAAC,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AACpF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,aAAa,EAAE,MAAM,EAAE,CAAC;IAClE,cAAc,EAAE,MAAM,EAAE,CAAC;IAAC,gBAAgB,EAAE,MAAM,EAAE,CAAC;CACtD;AAsCD,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,IAAI,EAAE,YAAY,GAAG,WAAW,CA8E/F"}