@sun-asterisk/sungen 3.0.0-beta.75 → 3.0.0-beta.78

package/dist/ingest/gsheet-fetch.js

@@ -0,0 +1,180 @@
+"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.parseSpreadsheetId = parseSpreadsheetId;
+exports.fetchGoogleSheet = fetchGoogleSheet;
+/**
+ * Fetch a Google Sheet's tabs as a sheet-bundle — runs under the USER's own Google
+ * identity (Application Default Credentials), read-only. This is NOT an AI context, so
+ * it is not subject to the "ineligible for generative AI contexts" DLP that blocks AI
+ * connectors; and read access (Viewer/Commenter is enough) is all it needs.
+ *
+ * `googleapis` is an OPTIONAL dependency (lazy-required) — the core install stays lean;
+ * users who want the Google fetch run `npm i googleapis` + authenticate once with
+ * `gcloud auth application-default login` (or set GOOGLE_APPLICATION_CREDENTIALS).
+ */
+const path = __importStar(require("path"));
+const readline = __importStar(require("readline"));
+const child_process_1 = require("child_process");
+const SCOPE = 'https://www.googleapis.com/auth/spreadsheets.readonly';
+/** Accept a full Sheets URL or a bare spreadsheet ID. */
+function parseSpreadsheetId(idOrUrl) {
+    const m = idOrUrl.match(/\/spreadsheets\/d\/([a-zA-Z0-9_-]+)/);
+    return m ? m[1] : idOrUrl.trim();
+}
+function ask(prompt) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+        rl.question(prompt, (a) => { rl.close(); resolve(a.trim()); });
+    });
+}
+/** Load `googleapis`; if missing, ask to install it (default Yes) and install into the
+ * sungen package dir, then load it. Throws with manual instructions if declined/failed. */
+async function ensureGoogleapis() {
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return require('googleapis').google;
+    }
+    catch { /* not installed → offer to install */ }
+    const manual = '\n  Install it manually:  npm i googleapis\n' +
+        '  Then authenticate:    gcloud auth application-default login --scopes=' + SCOPE;
+    if (!process.stdin.isTTY) {
+        throw new Error('`--gsheet` needs the optional dependency `googleapis` (non-interactive shell — cannot prompt).' + manual);
+    }
+    const answer = (await ask('  `--gsheet` needs the `googleapis` package (read-only Google Sheets). Install it now? [Y/n] ')).toLowerCase();
+    if (answer && !/^y(es)?$/.test(answer)) {
+        throw new Error('Skipped install — `--gsheet` needs `googleapis`.' + manual);
+    }
+    const pkgDir = path.resolve(__dirname, '..', '..'); // dist/ingest|src/ingest → package root
+    console.log('  Installing googleapis (local to sungen, not saved to your project)…');
+    try {
+        // --no-save: keep sungen's core lean; this machine gets googleapis without declaring a dep.
+        (0, child_process_1.execSync)('npm install googleapis --no-save', { cwd: pkgDir, stdio: 'inherit' });
+    }
+    catch {
+        throw new Error('npm install googleapis failed (permissions?).' + manual);
+    }
+    // Node caches the negative module lookup from process start, so requiring a just-installed
+    // package in THIS process is unreliable. Ask for a clean re-run (next process finds it).
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        return require(require.resolve('googleapis', { paths: [pkgDir] })).google;
+    }
+    catch {
+        console.log('\n  ✓ googleapis installed. Please re-run the same `sungen ingest --gsheet …` command.\n');
+        process.exit(0);
+    }
+}
+/** Open the Google login in the browser (via gcloud ADC) so the user picks THEIR
+ * account, then store read-only credentials. Returns false if gcloud is unavailable. */
+async function tryInteractiveLogin() {
+    try {
+        (0, child_process_1.execSync)('gcloud --version', { stdio: 'ignore' });
+    }
+    catch {
+        console.log('\n  (gcloud not found — install the Google Cloud SDK, or export the sheet to .xlsx and use --legacy.)');
+        return false;
+    }
+    const ans = (await ask('  Open Google login in your browser now (pick the account that can see the sheet)? [Y/n] ')).toLowerCase();
+    if (ans && !/^y(es)?$/.test(ans))
+        return false;
+    try {
+        (0, child_process_1.execSync)(`gcloud auth application-default login --scopes=${SCOPE},https://www.googleapis.com/auth/cloud-platform`, { stdio: 'inherit' });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function fetchGoogleSheet(idOrUrl) {
+    const google = await ensureGoogleapis();
+    const spreadsheetId = parseSpreadsheetId(idOrUrl);
+    const doFetch = async () => {
+        // ADC: the user's own credentials (gcloud ADC). Fresh client each attempt so a
+        // just-completed login is picked up.
+        const auth = new google.auth.GoogleAuth({ scopes: [SCOPE] });
+        const sheets = google.sheets({ version: 'v4', auth });
+        const m = await sheets.spreadsheets.get({ spreadsheetId, fields: 'properties.title,sheets.properties.title' });
+        const tabs = (m.data?.sheets || []).map((s) => s.properties.title);
+        const r = await sheets.spreadsheets.values.batchGet({ spreadsheetId, ranges: tabs, majorDimension: 'ROWS' });
+        return { m, r };
+    };
+    let meta, resp;
+    try {
+        ({ m: meta, r: resp } = await doFetch());
+    }
+    catch (e) {
+        const msg = String(e?.message || e);
+        const noCreds = /default credentials|could not load|invalid_grant|reauth|unauthenticated/i.test(msg);
+        // Tool-driven browser login: on missing/expired creds, offer to open the Google
+        // login (gcloud ADC) so the user picks THEIR account, then retry once.
+        if (noCreds && process.stdin.isTTY && await tryInteractiveLogin()) {
+            ({ m: meta, r: resp } = await doFetch());
+        }
+        else if (noCreds) {
+            throw new Error('Google login needed (no usable credentials for your account).\n' +
+                '  Run:  gcloud auth application-default login --scopes=' + SCOPE + '\n' +
+                '  (opens a browser — pick the account that can see the sheet). Then re-run.\n' +
+                '  No gcloud? Export the sheet to .xlsx and use --legacy instead.');
+        }
+        else if (/access_denied|app is blocked|blocked this access|disallowed_useragent|admin|policy|org_internal|403/i.test(msg)) {
+            throw new Error('Blocked by your organization\'s Google Workspace policy (admin App-access control):\n' +
+                '  "' + msg.split('\n')[0] + '"\n' +
+                '  Your org blocks OAuth apps from reading Sheets (a sensitive scope). This affects gcloud,\n' +
+                '  a custom OAuth app, AND the AI connector equally — it is an admin decision, not a sungen bug.\n' +
+                '  → Use the local path instead: have an owner export the sheet to .xlsx and run\n' +
+                '       sungen ingest --legacy <file>.xlsx\n' +
+                '    (no API, no admin needed). Or ask a Workspace admin to trust an app for the\n' +
+                '    spreadsheets.readonly scope (Admin Console → Security → API controls).');
+        }
+        else if (/no access|permission|not found|insufficient|API has not been used/i.test(msg)) {
+            throw new Error('Google access failed: ' + msg.split('\n')[0] + '\n' +
+                '  Ensure the logged-in account has Viewer/Commenter on the sheet and the Sheets API is enabled.\n' +
+                '  If your org blocks programmatic access to this file, ask an owner to export .xlsx → use --legacy.');
+        }
+        else {
+            throw e;
+        }
+    }
+    const title = meta.data?.properties?.title || spreadsheetId;
+    const tabNames = (meta.data?.sheets || []).map((s) => s.properties.title);
+    const ranges = resp.data?.valueRanges || [];
+    const out = tabNames.map((name, i) => ({
+        name,
+        rows: (ranges[i]?.values || []).map((row) => row.map((c) => (c == null ? '' : String(c)))),
+    }));
+    return { source: title, sheets: out };
+}
+//# sourceMappingURL=gsheet-fetch.js.map

package/dist/ingest/gsheet-fetch.js.map

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

package/dist/ingest/index.d.ts

@@ -0,0 +1,6 @@
+export * from './legacy-parser';
+export * from './baseline-audit';
+export * from './to-gherkin';
+export * from './reconcile';
+export * from './gsheet-fetch';
+//# sourceMappingURL=index.d.ts.map

package/dist/ingest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ingest/index.ts"],"names":[],"mappings":"AAAA,cAAc,iBAAiB,CAAC;AAChC,cAAc,kBAAkB,CAAC;AACjC,cAAc,cAAc,CAAC;AAC7B,cAAc,aAAa,CAAC;AAC5B,cAAc,gBAAgB,CAAC"}

package/dist/ingest/index.js

@@ -0,0 +1,22 @@
+"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 __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./legacy-parser"), exports);
+__exportStar(require("./baseline-audit"), exports);
+__exportStar(require("./to-gherkin"), exports);
+__exportStar(require("./reconcile"), exports);
+__exportStar(require("./gsheet-fetch"), exports);
+//# sourceMappingURL=index.js.map

package/dist/ingest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ingest/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAgC;AAChC,mDAAiC;AACjC,+CAA6B;AAC7B,8CAA4B;AAC5B,iDAA+B"}

package/dist/ingest/legacy-parser.d.ts

@@ -0,0 +1,39 @@
+export type SheetType = 'testcase' | 'viewpoint-matrix' | 'ui-checklist' | 'unknown';
+export type Priority = 'high' | 'normal' | 'low' | 'unknown';
+export interface LegacyTestcase {
+    id: string;
+    page: string;
+    category: string;
+    subCategory?: string;
+    precondition?: string;
+    testData?: string;
+    steps: string;
+    expected: string;
+    priority: Priority;
+    type?: string;
+    result?: string;
+    sheet: string;
+}
+export interface SheetInfo {
+    name: string;
+    type: SheetType;
+    rows: number;
+}
+export interface LegacyInventory {
+    source: {
+        file: string;
+    };
+    sheets: SheetInfo[];
+    testcases: LegacyTestcase[];
+}
+export declare function parseCSV(text: string): string[][];
+export interface RawSheet {
+    name: string;
+    rows: string[][];
+}
+/** Classify sheets without parsing testcases — for `--list-sheets`. */
+export declare function listSheets(filePaths: string | string[]): Promise<SheetInfo[]>;
+/** Parse one or more inputs (CSV/XLSX/JSON-bundle) into an inventory. Optionally
+ * restrict to a set of tab names (`onlySheets`) — workbooks carry many tabs. */
+export declare function parseLegacyFile(filePaths: string | string[], onlySheets?: string[]): Promise<LegacyInventory>;
+//# sourceMappingURL=legacy-parser.d.ts.map

package/dist/ingest/legacy-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"legacy-parser.d.ts","sourceRoot":"","sources":["../../src/ingest/legacy-parser.ts"],"names":[],"mappings":"AAQA,MAAM,MAAM,SAAS,GAAG,UAAU,GAAG,kBAAkB,GAAG,cAAc,GAAG,SAAS,CAAC;AACrF,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,QAAQ,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,SAAS;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAE1E,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,SAAS,EAAE,cAAc,EAAE,CAAC;CAC7B;AAGD,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,CAcjD;AA8DD,MAAM,WAAW,QAAQ;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CAAE;AAsC5D,uEAAuE;AACvE,wBAAsB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAUnF;AAED;gFACgF;AAChF,wBAAsB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,eAAe,CAAC,CAmBnH"}

package/dist/ingest/legacy-parser.js

@@ -0,0 +1,218 @@
+"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.parseCSV = parseCSV;
+exports.listSheets = listSheets;
+exports.parseLegacyFile = parseLegacyFile;
+/**
+ * Legacy testcase ingest (P-A) — parse a manual testcase workbook (CSV or XLSX)
+ * into a normalized inventory. Deterministic: pure function of the input file
+ * (no network, no MCP). The AI skill handles the Google-Sheets/MCP fetch upstream.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// ---- quote-aware CSV parser (embedded commas + newlines) ----
+function parseCSV(text) {
+    const rows = [];
+    let row = [], field = '', q = false;
+    for (let i = 0; i < text.length; i++) {
+        const c = text[i];
+        if (q) {
+            if (c === '"') {
+                if (text[i + 1] === '"') {
+                    field += '"';
+                    i++;
+                }
+                else
+                    q = false;
+            }
+            else
+                field += c;
+        }
+        else if (c === '"')
+            q = true;
+        else if (c === ',') {
+            row.push(field);
+            field = '';
+        }
+        else if (c === '\n') {
+            row.push(field);
+            rows.push(row);
+            row = [];
+            field = '';
+        }
+        else if (c !== '\r')
+            field += c;
+    }
+    if (field.length || row.length) {
+        row.push(field);
+        rows.push(row);
+    }
+    return rows;
+}
+const norm = (s) => (s || '').replace(/\*/g, '').trim().toLowerCase();
+function detectSheetType(rows) {
+    for (let i = 0; i < Math.min(rows.length, 40); i++) {
+        const cells = rows[i].map(norm);
+        if (cells.some((c) => /^tc\s*id$/.test(c)) && cells.some((c) => /steps?|expected/.test(c)))
+            return { type: 'testcase', headerRow: i };
+        if (cells.some((c) => /item type/.test(c)) || (cells[0] === 'id' && cells.some((c) => /^item/.test(c))))
+            return { type: 'ui-checklist', headerRow: i };
+        if (cells.some((c) => /^id\/function$/.test(c)) || cells.some((c) => /viewpoint/.test(c)))
+            return { type: 'viewpoint-matrix', headerRow: i };
+    }
+    return { type: 'unknown', headerRow: -1 };
+}
+function colMap(header) {
+    const m = {};
+    header.forEach((h, i) => { const k = norm(h); if (k && !(k in m))
+        m[k] = i; });
+    return m;
+}
+function toPriority(raw) {
+    const p = (raw || '').toLowerCase();
+    if (/high|cao/.test(p))
+        return 'high';
+    if (/low|thấp/.test(p))
+        return 'low';
+    if (/medium|normal|trung/.test(p))
+        return 'normal';
+    return 'unknown';
+}
+function parseTestcaseSheet(rows, headerRow, sheet) {
+    const cm = colMap(rows[headerRow]);
+    if (cm['tc id'] == null)
+        return [];
+    const col = (r, key) => (cm[key] != null ? (r[cm[key]] || '').trim() : '');
+    const out = [];
+    // Fill-down ONLY the grouping columns (genuinely merged across rows). Precondition is
+    // kept PER-ROW: filling it down would bleed one row's "needs API/DB/login" into unrelated
+    // rows and falsely inflate the capability/driver signal.
+    const fd = { page: '', category: '', sub: '' };
+    for (let i = headerRow + 1; i < rows.length; i++) {
+        const r = rows[i];
+        const id = col(r, 'tc id');
+        if (!id || /^(total|module|test environment)/i.test(id))
+            continue;
+        fd.page = col(r, 'page name') || fd.page;
+        fd.category = col(r, 'category') || fd.category;
+        fd.sub = col(r, 'sub-category') || fd.sub;
+        const steps = col(r, 'steps');
+        const expected = col(r, 'expected results') || col(r, 'expected result');
+        if (!steps && !expected)
+            continue; // skip noise / spacer rows
+        out.push({
+            id, sheet, page: fd.page, category: fd.category || '(uncategorized)',
+            subCategory: fd.sub || undefined, precondition: col(r, 'pre-condition') || undefined,
+            testData: col(r, 'test data') || undefined, steps, expected,
+            priority: toPriority(col(r, 'priority')),
+            type: col(r, 'testcase type') || undefined,
+            result: col(r, 'test result') || col(r, 'test result\nchrome (100%)') || undefined,
+        });
+    }
+    return out;
+}
+/** Load sheets from one input file: CSV (1 sheet), XLSX (all sheets), or a JSON
+ * sheet-bundle (the shape the Google-Sheets/MCP skill produces). */
+async function loadSheets(filePath) {
+    const ext = path.extname(filePath).toLowerCase();
+    if (ext === '.csv') {
+        return [{ name: path.basename(filePath, '.csv'), rows: parseCSV(fs.readFileSync(filePath, 'utf8')) }];
+    }
+    if (ext === '.json') {
+        // Bundle shapes: { sheets: [{name, rows}] } | [{name, rows}] | { "<tab>": [[..]] }
+        const data = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        const arr = Array.isArray(data) ? data : Array.isArray(data.sheets) ? data.sheets : null;
+        if (arr)
+            return arr.map((s) => ({ name: String(s.name), rows: s.rows }));
+        if (data && typeof data === 'object')
+            return Object.entries(data).map(([name, rows]) => ({ name, rows: rows }));
+        throw new Error('Invalid JSON sheet-bundle: expected { sheets: [{name, rows}] }');
+    }
+    if (ext === '.xlsx') {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        const ExcelJS = require('exceljs');
+        const wb = new ExcelJS.Workbook();
+        await wb.xlsx.readFile(filePath);
+        const out = [];
+        wb.eachSheet((ws) => {
+            const rows = [];
+            ws.eachRow((row) => {
+                const cells = [];
+                row.eachCell({ includeEmpty: true }, (cell) => { cells.push(cell.text != null ? String(cell.text) : ''); });
+                rows.push(cells);
+            });
+            out.push({ name: ws.name, rows });
+        });
+        return out;
+    }
+    throw new Error(`Unsupported file type: ${ext} (use .csv, .xlsx, or a .json sheet-bundle)`);
+}
+/** Classify sheets without parsing testcases — for `--list-sheets`. */
+async function listSheets(filePaths) {
+    const files = Array.isArray(filePaths) ? filePaths : [filePaths];
+    const out = [];
+    for (const f of files) {
+        for (const s of await loadSheets(f)) {
+            const { type } = detectSheetType(s.rows);
+            out.push({ name: s.name, type, rows: s.rows.length });
+        }
+    }
+    return out;
+}
+/** Parse one or more inputs (CSV/XLSX/JSON-bundle) into an inventory. Optionally
+ * restrict to a set of tab names (`onlySheets`) — workbooks carry many tabs. */
+async function parseLegacyFile(filePaths, onlySheets) {
+    const files = Array.isArray(filePaths) ? filePaths : [filePaths];
+    const want = onlySheets && onlySheets.length ? new Set(onlySheets.map((s) => s.trim().toLowerCase())) : null;
+    const inv = {
+        source: { file: files.map((f) => path.basename(f)).join(', ') },
+        sheets: [], testcases: [],
+    };
+    for (const f of files) {
+        for (const s of await loadSheets(f)) {
+            if (want && !want.has(s.name.trim().toLowerCase()))
+                continue;
+            const { type, headerRow } = detectSheetType(s.rows);
+            let tcs = [];
+            if (type === 'testcase' && headerRow >= 0)
+                tcs = parseTestcaseSheet(s.rows, headerRow, s.name);
+            inv.sheets.push({ name: s.name, type, rows: tcs.length || s.rows.length });
+            inv.testcases.push(...tcs);
+        }
+    }
+    return inv;
+}
+//# sourceMappingURL=legacy-parser.js.map

package/dist/ingest/legacy-parser.js.map

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

package/dist/ingest/reconcile.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Viewpoint Reconciliation (P-C) — the link between a legacy suite and the Harness.
+ *
+ * A 1:1 convert reproduces the legacy suite's blind spots. Reconciliation runs the
+ * harness viewpoint-gate over the legacy-derived scenarios to answer: which catalog-
+ * expected viewpoints does the legacy suite ALREADY cover, and which are MISSING
+ * (blind spots the old QA never wrote)? It emits a draft viewpoint overview that
+ * seeds `/sungen:create-test` + the harness coverage-gate, so the generated suite is
+ * raised to catalog quality instead of merely mirroring the legacy.
+ */
+import { LegacyInventory } from './legacy-parser';
+export interface Reconciliation {
+    pageType: string | null;
+    coverageRatio: number;
+    themesCovered: number;
+    themesTotal: number;
+    blindSpots: {
+        theme: string;
+        status: 'missing' | 'shallow';
+    }[];
+    universalGaps: string[];
+    legacyViewpoints: {
+        vpGroup: string;
+        count: number;
+    }[];
+}
+export declare function reconcileViewpoints(inv: LegacyInventory): Reconciliation;
+/** A draft test-viewpoint.md: legacy-derived viewpoints + catalog blind-spots to fill. */
+export declare function renderViewpointOverview(featureName: string, r: Reconciliation): string;
+//# sourceMappingURL=reconcile.d.ts.map

package/dist/ingest/reconcile.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"reconcile.d.ts","sourceRoot":"","sources":["../../src/ingest/reconcile.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAIlD,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,SAAS,GAAG,SAAS,CAAA;KAAE,EAAE,CAAC;IAC/D,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,gBAAgB,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CACxD;AAaD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,eAAe,GAAG,cAAc,CAqBxE;AAED,0FAA0F;AAC1F,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,EAAE,CAAC,EAAE,cAAc,GAAG,MAAM,CAoBtF"}

package/dist/ingest/reconcile.js

@@ -0,0 +1,65 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reconcileViewpoints = reconcileViewpoints;
+exports.renderViewpointOverview = renderViewpointOverview;
+const baseline_audit_1 = require("./baseline-audit");
+const sensors_1 = require("../harness/sensors");
+function vpGroupOf(category) {
+    const c = (category || '').toLowerCase();
+    if (/search|filter|điều kiện|条件/.test(c))
+        return 'SEARCH';
+    if (/input|validation|nhập|入力/.test(c))
+        return 'VAL';
+    if (/display|hiển thị|表示|data/.test(c))
+        return 'DISPLAY';
+    if (/layout|responsive|tab order|ui|giao diện/.test(c))
+        return 'UI';
+    if (/flow|navigation|遷移|chuyển|event/.test(c))
+        return 'NAV';
+    if (/paging|sort|phân trang/.test(c))
+        return 'LIST';
+    return (c.replace(/[^a-z0-9]+/g, '-').replace(/^-|-$/g, '').toUpperCase().slice(0, 8)) || 'GEN';
+}
+function reconcileViewpoints(inv) {
+    const scenarios = inv.testcases.map(baseline_audit_1.legacyToScenarioInfo);
+    const catalog = (0, sensors_1.loadCatalog)();
+    const gate = (0, sensors_1.viewpointGate)(scenarios, [], catalog);
+    const groups = {};
+    for (const tc of inv.testcases) {
+        const g = vpGroupOf(tc.category);
+        groups[g] = (groups[g] || 0) + 1;
+    }
+    return {
+        pageType: gate.pageType,
+        coverageRatio: gate.coverageRatio,
+        themesCovered: gate.themesCovered,
+        themesTotal: gate.themesTotal,
+        blindSpots: gate.gaps.map((g) => ({ theme: g.theme, status: g.status })),
+        universalGaps: gate.universalGaps,
+        legacyViewpoints: Object.entries(groups).map(([vpGroup, count]) => ({ vpGroup, count }))
+            .sort((a, b) => b.count - a.count),
+    };
+}
+/** A draft test-viewpoint.md: legacy-derived viewpoints + catalog blind-spots to fill. */
+function renderViewpointOverview(featureName, r) {
+    const L = [];
+    L.push(`# Test Viewpoint — ${featureName} (drafted from legacy + reconciled with the catalog)`, '');
+    L.push('> Auto-drafted by `sungen ingest`. Rows from the legacy suite are listed first;');
+    L.push('> rows marked **⚠ BLIND-SPOT** are catalog-expected viewpoints the legacy suite does');
+    L.push('> NOT cover — add scenarios for them via `/sungen:create-test`. Refine before use.', '');
+    L.push(`Detected page-type: \`${r.pageType ?? 'unknown'}\` · legacy covers ${r.themesCovered}/${r.themesTotal} catalog themes (${(r.coverageRatio * 100).toFixed(0)}%)`, '');
+    L.push('## Priority Viewpoints', '', '| VP | Priority | Reason |', '|---|---|---|');
+    let n = 1;
+    for (const v of r.legacyViewpoints) {
+        L.push(`| VP-${v.vpGroup}-${String(n).padStart(3, '0')} | Medium | legacy suite: ${v.count} testcase(s) |`);
+        n++;
+    }
+    for (const b of r.blindSpots) {
+        L.push(`| VP-GAP-${String(n).padStart(3, '0')} | High | ⚠ BLIND-SPOT — catalog expects "${b.theme}" (${b.status}); legacy has none |`);
+        n++;
+    }
+    if (r.universalGaps.length)
+        L.push('', `> Universal reminders not covered: ${r.universalGaps.join(', ')}`);
+    return L.join('\n') + '\n';
+}
+//# sourceMappingURL=reconcile.js.map

package/dist/ingest/reconcile.js.map

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