@sun-asterisk/sungen 2.7.0-beta.1 → 3.0.0-beta.71

package/dist/harness/ledger.js

@@ -0,0 +1,171 @@
+"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.segmentRuns = segmentRuns;
+exports.latestRunEvents = latestRunEvents;
+exports.recordEvent = recordEvent;
+exports.readEvents = readEvents;
+exports.buildReport = buildReport;
+/**
+ * Usage Ledger — observability for AI resource spend during test design.
+ *
+ * The orchestrator records one event per step; the report aggregates them and
+ * derives efficiency metrics so you can SEE where cost goes (e.g. "50% of tokens
+ * spent in repair" → first-pass generation is weak; fix the Guide, not the count).
+ *
+ * Tokens are OPTIONAL: exact counts come from the orchestrator/harness when known;
+ * otherwise the ledger still reports time, repair rounds, and per-step structure.
+ * (Exact AI token capture is a harness-integration concern; the schema is ready.)
+ *
+ * Events: .sungen/ledger/<screen>.jsonl (append-only)
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+// The ledger is append-only across runs. When events carry no runId, a gap longer
+// than this between consecutive timestamps marks a new run. Default report/trace
+// scope to the LATEST run so multiple invocations don't get conflated.
+const RUN_GAP_MS = 30 * 60 * 1000;
+/** Split events into runs — by runId when present, else by timestamp gap. */
+function segmentRuns(events) {
+    if (events.length === 0)
+        return [];
+    if (events.some((e) => e.runId)) {
+        const order = [];
+        const groups = new Map();
+        for (const e of events) {
+            const key = e.runId ?? '__none__';
+            if (!groups.has(key)) {
+                groups.set(key, []);
+                order.push(key);
+            }
+            groups.get(key).push(e);
+        }
+        return order.map((k) => groups.get(k));
+    }
+    const sorted = [...events].sort((a, b) => Date.parse(a.ts) - Date.parse(b.ts));
+    const runs = [[sorted[0]]];
+    for (let i = 1; i < sorted.length; i++) {
+        const gap = Date.parse(sorted[i].ts) - Date.parse(sorted[i - 1].ts);
+        if (gap > RUN_GAP_MS)
+            runs.push([]);
+        runs[runs.length - 1].push(sorted[i]);
+    }
+    return runs;
+}
+/** Events of the most recent run only. */
+function latestRunEvents(events) {
+    const runs = segmentRuns(events);
+    return runs.length ? runs[runs.length - 1] : [];
+}
+function ledgerPath(screen) {
+    return path.join(process.cwd(), '.sungen', 'ledger', `${screen}.jsonl`);
+}
+function recordEvent(screen, ev) {
+    const p = ledgerPath(screen);
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    const full = { ts: ev.ts ?? new Date().toISOString(), ...ev };
+    fs.appendFileSync(p, JSON.stringify(full) + '\n', 'utf-8');
+    return p;
+}
+function readEvents(screen) {
+    const p = ledgerPath(screen);
+    if (!fs.existsSync(p))
+        return [];
+    return fs.readFileSync(p, 'utf-8').split('\n').filter(Boolean).map((l) => JSON.parse(l));
+}
+function buildReport(screen, opts = {}) {
+    const allEvents = readEvents(screen);
+    const runCount = segmentRuns(allEvents).length;
+    const events = opts.allRuns ? allEvents : latestRunEvents(allEvents);
+    const byStep = {};
+    let totalTokens = 0, totalMs = 0, repairTokens = 0;
+    const repairSteps = new Set();
+    for (const e of events) {
+        const tok = (e.tokensIn ?? 0) + (e.tokensOut ?? 0);
+        const stepKey = e.step.replace(/:\d+$/, '');
+        byStep[stepKey] = byStep[stepKey] || { tokens: 0, ms: 0, count: 0 };
+        byStep[stepKey].tokens += tok;
+        byStep[stepKey].ms += e.ms ?? 0;
+        byStep[stepKey].count += 1;
+        totalTokens += tok;
+        totalMs += e.ms ?? 0;
+        if (/^repair/i.test(e.step)) {
+            repairTokens += tok;
+            repairSteps.add(e.step);
+        }
+    }
+    // Pull audit signals if present
+    let coveredCritical = null;
+    let scenarioCount = null;
+    const auditPath = path.join(process.cwd(), '.sungen', 'reports', `${screen}-audit.json`);
+    if (fs.existsSync(auditPath)) {
+        try {
+            const a = JSON.parse(fs.readFileSync(auditPath, 'utf-8'));
+            coveredCritical = a?.gate?.themesCovered ?? null;
+            scenarioCount = a?.scenarioCount ?? null;
+        }
+        catch { /* ignore */ }
+    }
+    const verdicts = [];
+    const repairPct = totalTokens ? repairTokens / totalTokens : 0;
+    if (totalTokens === 0)
+        verdicts.push('No token data recorded — record steps with --tokens-in/--tokens-out for cost metrics (time & rounds still shown).');
+    if (repairPct > 0.4)
+        verdicts.push(`High repair cost (${(repairPct * 100).toFixed(0)}% of tokens in repair) → first-pass generation is weak; improve the Guide/viewpoint step, not the count.`);
+    if (repairSteps.size >= 3)
+        verdicts.push(`${repairSteps.size} repair rounds — near/over budget; check which sensor keeps failing.`);
+    if (coveredCritical != null && totalTokens && coveredCritical > 0 && totalTokens / coveredCritical > 30000) {
+        verdicts.push(`~${Math.round(totalTokens / coveredCritical / 1000)}k tokens per covered critical viewpoint — expensive; check for low-value expansion.`);
+    }
+    if (verdicts.length === 0)
+        verdicts.push('Within expected efficiency.');
+    return {
+        screen,
+        runs: runCount,
+        runScope: opts.allRuns ? 'all' : 'latest',
+        events: events.length,
+        totalTokens,
+        totalMs,
+        byStep,
+        repairRounds: repairSteps.size,
+        repairTokenPct: Math.round(repairPct * 100) / 100,
+        coveredCriticalViewpoints: coveredCritical,
+        tokensPerCoveredCritical: coveredCritical && totalTokens ? Math.round(totalTokens / coveredCritical) : null,
+        scenarioCount,
+        tokensPerScenario: scenarioCount && totalTokens ? Math.round(totalTokens / scenarioCount) : null,
+        verdicts,
+    };
+}
+//# sourceMappingURL=ledger.js.map

package/dist/harness/ledger.js.map

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

package/dist/harness/manifest.d.ts

@@ -0,0 +1,42 @@
+export interface SpecSection {
+    name: string;
+    hash: string;
+}
+export interface ManifestEntry {
+    scenario: string;
+    vpCode?: string;
+    section: string;
+    specHash: string;
+}
+export interface Manifest {
+    screen: string;
+    builtAt: string;
+    specSections: Record<string, string>;
+    entries: ManifestEntry[];
+}
+export type ChangeKind = 'keep' | 'regenerate' | 'retire';
+export interface ChangePlan {
+    screen: string;
+    scenarios: {
+        scenario: string;
+        section: string;
+        change: ChangeKind;
+        reason: string;
+    }[];
+    newSections: string[];
+    removedSections: string[];
+    summary: {
+        keep: number;
+        regenerate: number;
+        retire: number;
+        newSections: number;
+    };
+}
+/** Parse spec.md into hashable sections (## and ### headings; "Section:" prefix stripped). */
+export declare function parseSpecSections(specPath: string): SpecSection[];
+export declare function buildManifest(screenDir: string, screenName: string): Manifest;
+export declare function diffManifest(screenDir: string, screenName: string, manifest: Manifest): ChangePlan;
+export declare function manifestPath(screenName: string): string;
+export declare function loadManifest(screenName: string): Manifest | null;
+export declare function saveManifest(m: Manifest): string;
+//# sourceMappingURL=manifest.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/harness/manifest.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,WAAW;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE;AAC3D,MAAM,WAAW,aAAa;IAAG,QAAQ,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE;AACvG,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,YAAY,GAAG,QAAQ,CAAC;AAC1D,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,UAAU,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACvF,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,CAAC;CACpF;AA2BD,8FAA8F;AAC9F,wBAAgB,iBAAiB,CAAC,QAAQ,EAAE,MAAM,GAAG,WAAW,EAAE,CAiBjE;AAsBD,wBAAgB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ,CAyB7E;AAED,wBAAgB,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,UAAU,CAkClG;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEvD;AACD,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,QAAQ,GAAG,IAAI,CAGhE;AACD,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAKhD"}

package/dist/harness/manifest.js

@@ -0,0 +1,209 @@
+"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.parseSpecSections = parseSpecSections;
+exports.buildManifest = buildManifest;
+exports.diffManifest = diffManifest;
+exports.manifestPath = manifestPath;
+exports.loadManifest = loadManifest;
+exports.saveManifest = saveManifest;
+/**
+ * Manifest + spec-fingerprint — make testcases reflect the SOFTWARE, not chase it.
+ *
+ * Records, per scenario, which spec section it was derived from + a hash of that
+ * section. On re-run, diff current spec hashes vs the manifest to classify each
+ * scenario: keep / regenerate / retire — so the orchestrator regenerates only the
+ * parts whose spec changed (stable + cheap), and never silently drifts.
+ *
+ * Deterministic. Manifest lives at .sungen/manifest/<screen>.json.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const crypto_1 = require("crypto");
+function norm(s) {
+    return s.replace(/\(Tier[^)]*\)/i, '').replace(/[#*-]/g, '').trim().toLowerCase().replace(/\s+/g, ' ');
+}
+function shortHash(s) {
+    return (0, crypto_1.createHash)('sha1').update(s).digest('hex').slice(0, 12);
+}
+const NO_SPEC = '(no-spec-link)';
+/**
+ * Match a feature section name to a spec section name. Feature comments often
+ * combine spec sections (e.g. "features items / product cards" → spec "features
+ * items"), so fall back to longest substring match in either direction.
+ */
+function matchSection(featureSection, specNames) {
+    if (specNames.includes(featureSection))
+        return featureSection;
+    let best = null;
+    for (const s of specNames) {
+        if (featureSection.includes(s) || s.includes(featureSection)) {
+            if (!best || s.length > best.length)
+                best = s;
+        }
+    }
+    return best;
+}
+/** Parse spec.md into hashable sections (## and ### headings; "Section:" prefix stripped). */
+function parseSpecSections(specPath) {
+    if (!fs.existsSync(specPath))
+        return [];
+    const lines = fs.readFileSync(specPath, 'utf-8').split('\n');
+    const sections = [];
+    let cur = null;
+    for (const line of lines) {
+        const h = line.match(/^#{2,3}\s+(.*)$/);
+        if (h) {
+            if (cur)
+                sections.push(cur);
+            const name = h[1].replace(/^Section:\s*/i, '').trim();
+            cur = { name, body: [] };
+        }
+        else if (cur) {
+            cur.body.push(line);
+        }
+    }
+    if (cur)
+        sections.push(cur);
+    return sections.map((s) => ({ name: norm(s.name), hash: shortHash(s.body.join('\n').trim()) }));
+}
+/** Parse feature into scenario → section mapping using `# --- Section: X ---` comments. */
+function parseFeatureSections(featurePath) {
+    if (!fs.existsSync(featurePath))
+        return [];
+    const lines = fs.readFileSync(featurePath, 'utf-8').split('\n');
+    const out = [];
+    let section = '(unsectioned)';
+    for (const raw of lines) {
+        const line = raw.trim();
+        const sc = line.match(/^#\s*-{2,}\s*Section:\s*(.*?)\s*-{2,}\s*$/i);
+        if (sc) {
+            section = norm(sc[1]);
+            continue;
+        }
+        const s = line.match(/^Scenario:\s*(.*)$/);
+        if (s) {
+            const name = s[1].trim();
+            const code = name.match(/\bVP-[A-Z]+-\d+/i)?.[0];
+            out.push({ scenario: name, vpCode: code, section });
+        }
+    }
+    return out;
+}
+function buildManifest(screenDir, screenName) {
+    const specPath = path.join(screenDir, 'requirements', 'spec.md');
+    const featurePath = path.join(screenDir, 'features', `${screenName}.feature`);
+    const specSections = parseSpecSections(specPath);
+    const specMap = {};
+    for (const s of specSections)
+        specMap[s.name] = s.hash;
+    const specNames = Object.keys(specMap);
+    const featScenarios = parseFeatureSections(featurePath);
+    const entries = featScenarios.map((f) => {
+        const matched = matchSection(f.section, specNames);
+        return {
+            scenario: f.scenario,
+            vpCode: f.vpCode,
+            section: matched ?? f.section, // canonical spec section when matched
+            specHash: matched ? specMap[matched] : NO_SPEC,
+        };
+    });
+    return {
+        screen: screenName,
+        builtAt: new Date().toISOString(),
+        specSections: specMap,
+        entries,
+    };
+}
+function diffManifest(screenDir, screenName, manifest) {
+    const specPath = path.join(screenDir, 'requirements', 'spec.md');
+    const current = parseSpecSections(specPath);
+    const currentMap = {};
+    for (const s of current)
+        currentMap[s.name] = s.hash;
+    const scenarios = manifest.entries.map((e) => {
+        let change;
+        let reason;
+        if (e.specHash === NO_SPEC) {
+            change = 'keep';
+            reason = 'not linked to a spec section (manual/cross-cutting)';
+        }
+        else {
+            const now = currentMap[e.section];
+            if (now === undefined) {
+                change = 'retire';
+                reason = `spec section "${e.section}" no longer exists`;
+            }
+            else if (now !== e.specHash) {
+                change = 'regenerate';
+                reason = `spec section "${e.section}" changed (${e.specHash} → ${now})`;
+            }
+            else {
+                change = 'keep';
+                reason = 'spec section unchanged';
+            }
+        }
+        return { scenario: e.scenario, section: e.section, change, reason };
+    });
+    const manifestSections = new Set(manifest.entries.map((e) => e.section));
+    const newSections = Object.keys(currentMap).filter((s) => !manifestSections.has(s) && !manifest.specSections[s]);
+    const removedSections = Object.keys(manifest.specSections).filter((s) => currentMap[s] === undefined);
+    return {
+        screen: screenName,
+        scenarios,
+        newSections,
+        removedSections,
+        summary: {
+            keep: scenarios.filter((s) => s.change === 'keep').length,
+            regenerate: scenarios.filter((s) => s.change === 'regenerate').length,
+            retire: scenarios.filter((s) => s.change === 'retire').length,
+            newSections: newSections.length,
+        },
+    };
+}
+function manifestPath(screenName) {
+    return path.join(process.cwd(), '.sungen', 'manifest', `${screenName}.json`);
+}
+function loadManifest(screenName) {
+    const p = manifestPath(screenName);
+    return fs.existsSync(p) ? JSON.parse(fs.readFileSync(p, 'utf-8')) : null;
+}
+function saveManifest(m) {
+    const p = manifestPath(m.screen);
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    fs.writeFileSync(p, JSON.stringify(m, null, 2), 'utf-8');
+    return p;
+}
+//# sourceMappingURL=manifest.js.map

package/dist/harness/manifest.js.map

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

package/dist/harness/parse.d.ts

@@ -0,0 +1,22 @@
+export type Priority = 'high' | 'normal' | 'low' | 'unknown';
+export interface ViewpointEntry {
+    id: string;
+    priority: 'High' | 'Medium' | 'Low' | 'Unknown';
+    reason: string;
+    group?: 'Required' | 'Recommended' | 'Optional';
+}
+export interface ScenarioInfo {
+    name: string;
+    vpCode?: string;
+    category?: string;
+    priority: Priority;
+    manual: boolean;
+    thenCount: number;
+    hasDataAssertion: boolean;
+    shallow: boolean;
+    stepSkeleton: string;
+    haystack: string;
+}
+export declare function parseViewpointOverview(filePath: string): ViewpointEntry[];
+export declare function loadScenarios(featurePath: string): ScenarioInfo[];
+//# sourceMappingURL=parse.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/harness/parse.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;AAE7D,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,SAAS,CAAC;IAChD,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,UAAU,GAAG,aAAa,GAAG,UAAU,CAAC;CACjD;AAED,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,QAAQ,CAAC;IACnB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAID,wBAAgB,sBAAsB,CAAC,QAAQ,EAAE,MAAM,GAAG,cAAc,EAAE,CA4CzE;AA2DD,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,YAAY,EAAE,CAOjE"}

package/dist/harness/parse.js

@@ -0,0 +1,163 @@
+"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.parseViewpointOverview = parseViewpointOverview;
+exports.loadScenarios = loadScenarios;
+/**
+ * Harness parsers — load the two test-design artifacts the sensors operate on:
+ *   1. requirements/test-viewpoint.md  → viewpoint-overview (id, priority, group)
+ *   2. features/<screen>.feature        → scenarios (vp code, priority, Then-shape)
+ *
+ * Reuses the existing GherkinParser (framework-agnostic) for the .feature file.
+ */
+const fs = __importStar(require("fs"));
+const gherkin_parser_1 = require("../generators/gherkin-parser");
+// ---------- test-viewpoint.md ----------
+function parseViewpointOverview(filePath) {
+    if (!fs.existsSync(filePath))
+        return [];
+    const text = fs.readFileSync(filePath, 'utf-8');
+    const lines = text.split('\n');
+    const entries = new Map();
+    // 1) Priority Viewpoints table: | VP | Priority | Reason |
+    let inPriorityTable = false;
+    for (const raw of lines) {
+        const line = raw.trim();
+        if (/^##\s+Priority Viewpoints/i.test(line)) {
+            inPriorityTable = true;
+            continue;
+        }
+        if (inPriorityTable && /^##\s/.test(line)) {
+            inPriorityTable = false;
+        }
+        if (inPriorityTable && line.startsWith('|')) {
+            const cells = line.split('|').map((c) => c.trim()).filter((_, i, a) => i > 0 && i < a.length - 1);
+            if (cells.length >= 3) {
+                const id = cells[0];
+                if (/^VP[-A-Z0-9]/i.test(id) && !/^vp$/i.test(id) && !/^-+$/.test(cells[1])) {
+                    const pr = /high/i.test(cells[1]) ? 'High' : /medium/i.test(cells[1]) ? 'Medium' : /low/i.test(cells[1]) ? 'Low' : 'Unknown';
+                    entries.set(id.toUpperCase(), { id: id.toUpperCase(), priority: pr, reason: cells[2] });
+                }
+            }
+        }
+    }
+    // 2) Viewpoint Grouping: ### Required / ### Recommended / ### Optional → bullet list
+    let group;
+    for (const raw of lines) {
+        const line = raw.trim();
+        const g = line.match(/^###\s+(Required|Recommended|Optional)/i);
+        if (g) {
+            group = (g[1][0].toUpperCase() + g[1].slice(1).toLowerCase());
+            continue;
+        }
+        if (/^##\s/.test(line)) {
+            group = undefined;
+        }
+        if (group) {
+            const m = line.match(/^-\s+(VP[-A-Z0-9]+)/i);
+            if (m) {
+                const id = m[1].toUpperCase();
+                const existing = entries.get(id);
+                if (existing)
+                    existing.group = group;
+                else
+                    entries.set(id, { id, priority: 'Unknown', reason: '', group });
+            }
+        }
+    }
+    return [...entries.values()];
+}
+// ---------- .feature ----------
+const PRIORITY_TAGS = { '@high': 'high', '@normal': 'normal', '@low': 'low' };
+function classifyScenario(sc) {
+    const tags = sc.tags || [];
+    const manual = tags.includes('@manual');
+    let priority = 'unknown';
+    for (const t of tags)
+        if (PRIORITY_TAGS[t])
+            priority = PRIORITY_TAGS[t];
+    const codeMatch = sc.name.match(/\bVP-([A-Z]+)-\d+/i);
+    const vpCode = codeMatch ? codeMatch[0].toUpperCase() : undefined;
+    const category = codeMatch ? codeMatch[1].toUpperCase() : undefined;
+    // Then-phase detection (And/But inherit previous primary keyword)
+    let last = 'Given';
+    let thenCount = 0;
+    let hasData = false;
+    const skeletonParts = [];
+    const textParts = [sc.name];
+    for (const step of sc.steps) {
+        const kw = step.keyword.trim();
+        if (kw === 'Given' || kw === 'When' || kw === 'Then')
+            last = kw;
+        textParts.push(step.text);
+        // normalized skeleton: keep [refs] (distinct targets = distinct tests),
+        // but neutralize {{vars}} and quoted values so EP/data families collapse.
+        const skel = step.text
+            .replace(/\{\{[^}]*\}\}/g, '{}')
+            .replace(/"[^"]*"/g, '""')
+            .replace(/\s+/g, ' ')
+            .trim()
+            .toLowerCase();
+        skeletonParts.push(`${kw === 'And' || kw === 'But' ? last : kw}:${skel}`);
+        if (last === 'Then') {
+            thenCount++;
+            if (/\{\{|contains|match data|toHaveText/i.test(step.text))
+                hasData = true;
+        }
+    }
+    const shallow = thenCount > 0 && !hasData;
+    return {
+        name: sc.name,
+        vpCode,
+        category,
+        priority,
+        manual,
+        thenCount,
+        hasDataAssertion: hasData,
+        shallow,
+        stepSkeleton: skeletonParts.join(' | '),
+        haystack: textParts.join(' ').toLowerCase(),
+    };
+}
+function loadScenarios(featurePath) {
+    if (!fs.existsSync(featurePath))
+        return [];
+    const parser = new gherkin_parser_1.GherkinParser();
+    const feature = parser.parseFeatureFile(featurePath);
+    return (feature.scenarios || [])
+        .filter((s) => !s.stepsName && !s.hookType) // skip @steps/@hook blocks
+        .map(classifyScenario);
+}
+//# sourceMappingURL=parse.js.map

package/dist/harness/parse.js.map

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