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

package/dist/harness/flow-check.d.ts

@@ -0,0 +1,23 @@
+export interface Deferral {
+    screen: string;
+    scenario: string;
+    hint: string;
+    targets: string[];
+    verdict: 'covered' | 'shallow' | 'missing';
+    via?: string;
+}
+export interface Contract {
+    flow: string;
+    kind: 'SAME-CARD' | 'ISOLATION';
+    scenario?: string;
+    message: string;
+}
+export interface FlowCheckReport {
+    screens: string[];
+    flows: string[];
+    deferrals: Deferral[];
+    contracts: Contract[];
+    missing: number;
+}
+export declare function buildFlowCheck(cwd: string, onlyFlow?: string): FlowCheckReport;
+//# sourceMappingURL=flow-check.d.ts.map

package/dist/harness/flow-check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-check.d.ts","sourceRoot":"","sources":["../../src/harness/flow-check.ts"],"names":[],"mappings":"AAkBA,MAAM,WAAW,QAAQ;IAAG,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE;AACzJ,MAAM,WAAW,QAAQ;IAAG,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,WAAW,GAAG,WAAW,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;AAC/G,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,EAAE,CAAC;IACnC,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB;AA0BD,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,eAAe,CA+C9E"}

package/dist/harness/flow-check.js

@@ -0,0 +1,132 @@
+"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.buildFlowCheck = buildFlowCheck;
+/**
+ * Flow first-class checks (flow_firstclass_spec).
+ *
+ * A. Deferral integrity — every screen `@manual` "deferred to a flow (X -> Y)" must
+ *    be backed by a real flow scenario that covers Y (deeply). Otherwise the
+ *    cross-screen (XS) manual is a hidden gap, not "flow-covered".
+ * B. Run-test contract — surface the fragile cross-screen patterns (same-card
+ *    identity scope, shared-state isolation under @parallel) as explicit checks.
+ *
+ * Deterministic + read-only. No test execution, no selector resolution.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const parse_1 = require("./parse");
+const capability_plan_1 = require("./capability-plan");
+const KNOWN_TARGETS = ['cart', 'category', 'brand', 'detail', 'checkout', 'wishlist', 'order', 'payment', 'login'];
+function listDirs(p) {
+    return fs.existsSync(p) ? fs.readdirSync(p, { withFileTypes: true }).filter((d) => d.isDirectory()).map((d) => d.name) : [];
+}
+function featurePath(base, kind, name) {
+    return path.join(base, 'qa', kind, name, 'features', `${name}.feature`);
+}
+function featureTags(fp) {
+    if (!fs.existsSync(fp))
+        return [];
+    for (const line of fs.readFileSync(fp, 'utf-8').split('\n')) {
+        const t = line.trim();
+        if (t.startsWith('Feature:'))
+            break;
+        if (t.startsWith('@'))
+            return t.split(/\s+/).filter((x) => x.startsWith('@'));
+    }
+    return [];
+}
+function targetsFromHint(hint) {
+    const h = hint.toLowerCase();
+    const hits = KNOWN_TARGETS.filter((k) => h.includes(k));
+    if (hits.length)
+        return hits;
+    // fallback: significant words after "->"
+    const after = h.split('->').pop() || h;
+    return after.split(/[^a-z]+/).filter((w) => w.length > 3 && !['home', 'page', 'flow', 'products', 'product', 'result'].includes(w));
+}
+function buildFlowCheck(cwd, onlyFlow) {
+    const screens = listDirs(path.join(cwd, 'qa', 'screens'));
+    const flows = (onlyFlow ? [onlyFlow] : listDirs(path.join(cwd, 'qa', 'flows')));
+    // Index flow scenarios (name + haystack + depth).
+    const flowScenarios = [];
+    for (const f of listDirs(path.join(cwd, 'qa', 'flows'))) {
+        for (const s of (0, parse_1.loadScenarios)(featurePath(cwd, 'flows', f))) {
+            flowScenarios.push({ flow: f, name: s.name, haystack: s.haystack, deep: s.hasDataAssertion });
+        }
+    }
+    // A. Deferral integrity (screens).
+    const deferrals = [];
+    for (const sc of screens) {
+        for (const s of (0, capability_plan_1.parseScenarios)(featurePath(cwd, 'screens', sc))) {
+            if (!s.manual || !/deferred to a flow/i.test(s.reason))
+                continue;
+            const targets = targetsFromHint(s.reason);
+            const matches = flowScenarios.filter((fs2) => targets.some((t) => fs2.haystack.includes(t)));
+            let verdict = 'missing';
+            let via;
+            if (matches.some((m) => m.deep)) {
+                verdict = 'covered';
+                via = matches.find((m) => m.deep).flow;
+            }
+            else if (matches.length) {
+                verdict = 'shallow';
+                via = matches[0].flow;
+            }
+            deferrals.push({ screen: sc, scenario: s.name, hint: s.reason, targets, verdict, via });
+        }
+    }
+    // B. Run-test contract (per flow).
+    const contracts = [];
+    for (const f of flows) {
+        const fp = featurePath(cwd, 'flows', f);
+        const parallel = featureTags(fp).some((t) => /^@parallel$/i.test(t));
+        const scs = (0, parse_1.loadScenarios)(fp);
+        let cartStateCount = 0;
+        for (const s of scs) {
+            const h = s.haystack;
+            if (/\bremember\b/.test(h) && /(add to cart|view product)/.test(h)) {
+                contracts.push({ flow: f, kind: 'SAME-CARD', scenario: s.name, message: 'remember + Add To Cart/View Product → scope to ONE card at run-test, else the identity proof is hollow.' });
+            }
+            if (/(add to cart|remove|\bcart\b|quantity)/.test(h))
+                cartStateCount++;
+        }
+        if (parallel && cartStateCount >= 2) {
+            contracts.push({ flow: f, kind: 'ISOLATION', message: `@parallel + ${cartStateCount} cart/state scenarios → give each a fresh browser context, else count/quantity asserts are flaky.` });
+        }
+    }
+    return { screens, flows, deferrals, contracts, missing: deferrals.filter((d) => d.verdict === 'missing').length };
+}
+//# sourceMappingURL=flow-check.js.map

package/dist/harness/flow-check.js.map

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

package/dist/harness/flow-plan.d.ts

@@ -0,0 +1,23 @@
+import { Contract } from './flow-check';
+export interface LegPlan {
+    screen: string;
+    scenarios: number;
+    refs: string[];
+    haveKeys: number;
+    readiness: 'ready' | 'partial' | 'missing';
+    touchedByAutomated: boolean;
+}
+export interface FlowPlan {
+    flow: string;
+    total: number;
+    legs: LegPlan[];
+    byReason: Record<string, number>;
+    capabilityManual: number;
+    judgmentManual: number;
+    contracts: Contract[];
+    readiness: 'ready' | 'not-ready';
+    missingLegs: string[];
+    plan: string[];
+}
+export declare function buildFlowPlan(cwd: string, flow: string): FlowPlan;
+//# sourceMappingURL=flow-plan.d.ts.map

package/dist/harness/flow-plan.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flow-plan.d.ts","sourceRoot":"","sources":["../../src/harness/flow-plan.ts"],"names":[],"mappings":"AAaA,OAAO,EAAkB,QAAQ,EAAE,MAAM,cAAc,CAAC;AA4CxD,MAAM,WAAW,OAAO;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,GAAG,SAAS,GAAG,SAAS,CAAC;IAC3C,kBAAkB,EAAE,OAAO,CAAC;CAC7B;AACD,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,QAAQ,EAAE,CAAC;IACtB,SAAS,EAAE,OAAO,GAAG,WAAW,CAAC;IACjC,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,IAAI,EAAE,MAAM,EAAE,CAAC;CAChB;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,QAAQ,CAwDjE"}

package/dist/harness/flow-plan.js

@@ -0,0 +1,166 @@
+"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.buildFlowPlan = buildFlowPlan;
+/**
+ * Flow Capability Planner (Phase 2c) — flow-aware, deterministic, recommend-only.
+ *
+ * Decomposes a flow into per-screen LEGS (from [Screen:Element] refs), reports each
+ * leg's SELECTOR READINESS + capability, folds in the manual-reason taxonomy
+ * (capability-plan) and the run-test contract (flow-check), and emits a run-test
+ * PLAN. Automates the manual diagnosis done while healing cart-and-filter.
+ * See reports/sungen_phase2c_spec.md.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml_1 = require("yaml");
+const capability_plan_1 = require("./capability-plan");
+const flow_check_1 = require("./flow-check");
+const REF_RE = /\[([A-Za-z][\w ]*?):([\w &.-]+?)\]/g;
+function parseFlowScenarios(featurePath) {
+    if (!fs.existsSync(featurePath))
+        return [];
+    const lines = fs.readFileSync(featurePath, 'utf-8').split('\n');
+    const out = [];
+    const idx = [];
+    lines.forEach((l, i) => { if (/^\s*Scenario:/.test(l))
+        idx.push(i); });
+    for (let s = 0; s < idx.length; s++) {
+        const i = idx[s];
+        const end = s + 1 < idx.length ? idx[s + 1] : lines.length;
+        const name = lines[i].replace(/^\s*Scenario:\s*/, '').trim();
+        // tags + reason from the lines above + first comment in body
+        const tags = [];
+        let reason = '';
+        for (let j = i - 1; j >= 0; j--) {
+            const t = lines[j].trim();
+            if (t === '')
+                break;
+            if (/^@/.test(t))
+                tags.unshift(...t.split(/\s+/).filter((x) => x.startsWith('@')));
+            else if (/^#/.test(t)) {
+                if (!reason)
+                    reason = t.replace(/^#+\s*/, '');
+            }
+            else
+                break;
+        }
+        const body = lines.slice(i, end).join('\n');
+        if (!reason) {
+            const m = body.match(/^\s*#\s*(.+)$/m);
+            if (m)
+                reason = m[1].trim();
+        }
+        const refs = [];
+        let mm;
+        REF_RE.lastIndex = 0;
+        while ((mm = REF_RE.exec(body)))
+            refs.push({ screen: mm[1].trim(), element: mm[2].trim() });
+        out.push({ name, manual: tags.some((t) => /^@manual\b/i.test(t)), reason, tags, refs });
+    }
+    return out;
+}
+function selectorKeys(selectorsPath) {
+    if (!fs.existsSync(selectorsPath))
+        return new Set();
+    try {
+        const y = (0, yaml_1.parse)(fs.readFileSync(selectorsPath, 'utf-8')) || {};
+        return new Set(Object.keys(y).map((k) => k.toLowerCase()));
+    }
+    catch {
+        return new Set();
+    }
+}
+function buildFlowPlan(cwd, flow) {
+    const featurePath = path.join(cwd, 'qa', 'flows', flow, 'features', `${flow}.feature`);
+    const selectorsPath = path.join(cwd, 'qa', 'flows', flow, 'selectors', `${flow}.yaml`);
+    const scenarios = parseFlowScenarios(featurePath);
+    const keys = selectorKeys(selectorsPath);
+    // Legs = distinct screen namespaces.
+    const legMap = new Map();
+    const byReason = {};
+    let capabilityManual = 0, judgmentManual = 0;
+    for (const sc of scenarios) {
+        if (sc.manual) {
+            const { code } = (0, capability_plan_1.inferReasonCode)(sc.tags, sc.reason);
+            byReason[code] = (byReason[code] || 0) + 1;
+            const cls = capability_plan_1.MANUAL_REASONS[code]?.cls;
+            if (cls === 'capability')
+                capabilityManual++;
+            else if (cls === 'keep')
+                judgmentManual++;
+        }
+        for (const r of sc.refs) {
+            const leg = r.screen.toLowerCase();
+            const entry = legMap.get(leg) || { scenarios: new Set(), refs: new Set(), automated: false };
+            entry.scenarios.add(sc.name);
+            entry.refs.add(`${leg}:${r.element.toLowerCase()}`);
+            if (!sc.manual)
+                entry.automated = true;
+            legMap.set(leg, entry);
+        }
+    }
+    const legs = [...legMap.entries()].map(([screen, e]) => {
+        const refs = [...e.refs];
+        const haveKeys = refs.filter((rk) => keys.has(rk)).length;
+        const readiness = haveKeys === refs.length ? 'ready' : haveKeys === 0 ? 'missing' : 'partial';
+        return { screen, scenarios: e.scenarios.size, refs, haveKeys, readiness, touchedByAutomated: e.automated };
+    }).sort((a, b) => b.scenarios - a.scenarios);
+    const missingLegs = legs.filter((l) => l.touchedByAutomated && l.readiness !== 'ready').map((l) => l.screen);
+    const fc = (0, flow_check_1.buildFlowCheck)(cwd, flow);
+    const contracts = fc.contracts.filter((c) => c.flow === flow);
+    const readiness = missingLegs.length ? 'not-ready' : 'ready';
+    const plan = [];
+    if (missingLegs.length) {
+        plan.push(`Run \`/sungen:run-test ${flow}\` → Phase 0 generates selectors for: ${missingLegs.join(', ')} (from the live pages).`);
+    }
+    if (contracts.some((c) => c.kind === 'SAME-CARD'))
+        plan.push('Honour SAME-CARD: scope remember + Add To Cart/View Product to ONE card at run-test.');
+    if (contracts.some((c) => c.kind === 'ISOLATION'))
+        plan.push('Honour ISOLATION: fresh browser context per cart/state scenario (@parallel).');
+    const driverReasons = Object.keys(byReason).filter((c) => capability_plan_1.MANUAL_REASONS[c]?.cls === 'capability');
+    if (driverReasons.length) {
+        const drivers = [...new Set(driverReasons.flatMap((c) => capability_plan_1.MANUAL_REASONS[c].drivers))];
+        if (drivers.length)
+            plan.push(`Consider drivers (recommend-only): ${drivers.join(', ')} — for capability-manual (${driverReasons.join('/')}).`);
+    }
+    else {
+        plan.push('No capability driver needed — all automated legs are @ui.');
+    }
+    if (readiness === 'ready')
+        plan.unshift('Selectors present for every automated leg — ready to compile + run.');
+    return { flow, total: scenarios.length, legs, byReason, capabilityManual, judgmentManual, contracts, readiness, missingLegs, plan };
+}
+//# sourceMappingURL=flow-plan.js.map

package/dist/harness/flow-plan.js.map

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

package/dist/harness/intent.d.ts

@@ -0,0 +1,11 @@
+export type IntentFocus = 'functional' | 'e-commerce' | 'security' | 'smoke';
+export interface IntentProfile {
+    focus: IntentFocus;
+    riskTier: 'high' | 'normal' | 'low';
+    tierScope: 'tier-1' | 'full';
+    source: 'context.md' | 'default';
+}
+/** Resolve project root from a screen/flow dir (…/qa/screens/<name>). */
+export declare function projectRootFromScreenDir(screenDir: string): string;
+export declare function readIntent(projectRoot: string): IntentProfile;
+//# sourceMappingURL=intent.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"intent.d.ts","sourceRoot":"","sources":["../../src/harness/intent.ts"],"names":[],"mappings":"AAiBA,MAAM,MAAM,WAAW,GAAG,YAAY,GAAG,YAAY,GAAG,UAAU,GAAG,OAAO,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,WAAW,CAAC;IACnB,QAAQ,EAAE,MAAM,GAAG,QAAQ,GAAG,KAAK,CAAC;IACpC,SAAS,EAAE,QAAQ,GAAG,MAAM,CAAC;IAC7B,MAAM,EAAE,YAAY,GAAG,SAAS,CAAC;CAClC;AAQD,yEAAyE;AACzE,wBAAgB,wBAAwB,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,CAElE;AAED,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,CAoB7D"}

package/dist/harness/intent.js

@@ -0,0 +1,86 @@
+"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.projectRootFromScreenDir = projectRootFromScreenDir;
+exports.readIntent = readIntent;
+/**
+ * Intent Profile (harness-roadmap P3) — lets the gate flex to project intent.
+ *
+ * Read from qa/context.md so a project can declare what it cares about:
+ *
+ *   ## Intent
+ *   focus: security          # functional | e-commerce | security | smoke
+ *   risk_tier: high          # high | normal | low   (reserved — future weighting)
+ *   tier_scope: full         # tier-1 | full         (reserved)
+ *
+ * Keys may appear anywhere in context.md (a heading is optional). Unknown / missing
+ * values fall back to the safe default (functional), so behaviour is unchanged for
+ * projects that haven't declared an intent.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const DEFAULT_INTENT = {
+    focus: 'functional', riskTier: 'normal', tierScope: 'full', source: 'default',
+};
+const FOCI = ['functional', 'e-commerce', 'security', 'smoke'];
+/** Resolve project root from a screen/flow dir (…/qa/screens/<name>). */
+function projectRootFromScreenDir(screenDir) {
+    return path.resolve(screenDir, '..', '..', '..');
+}
+function readIntent(projectRoot) {
+    const ctx = path.join(projectRoot, 'qa', 'context.md');
+    if (!fs.existsSync(ctx))
+        return DEFAULT_INTENT;
+    let text;
+    try {
+        text = fs.readFileSync(ctx, 'utf-8').toLowerCase();
+    }
+    catch {
+        return DEFAULT_INTENT;
+    }
+    const grab = (key) => {
+        const m = text.match(new RegExp(`(?:^|\\n)\\s*${key}\\s*:\\s*([a-z0-9-]+)`));
+        return m?.[1];
+    };
+    const focusRaw = grab('focus');
+    const focus = (FOCI.includes(focusRaw) ? focusRaw : DEFAULT_INTENT.focus);
+    const risk = grab('risk_tier');
+    const riskTier = (['high', 'normal', 'low'].includes(risk) ? risk : DEFAULT_INTENT.riskTier);
+    const scope = grab('tier_scope');
+    const tierScope = (['tier-1', 'full'].includes(scope) ? scope : DEFAULT_INTENT.tierScope);
+    const found = focusRaw || risk || scope;
+    return { focus, riskTier, tierScope, source: found ? 'context.md' : 'default' };
+}
+//# sourceMappingURL=intent.js.map

package/dist/harness/intent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"intent.js","sourceRoot":"","sources":["../../src/harness/intent.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiCA,4DAEC;AAED,gCAoBC;AAzDD;;;;;;;;;;;;;GAaG;AACH,uCAAyB;AACzB,2CAA6B;AAW7B,MAAM,cAAc,GAAkB;IACpC,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,SAAS;CAC9E,CAAC;AAEF,MAAM,IAAI,GAAkB,CAAC,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;AAE9E,yEAAyE;AACzE,SAAgB,wBAAwB,CAAC,SAAiB;IACxD,OAAO,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,SAAgB,UAAU,CAAC,WAAmB;IAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,cAAc,CAAC;IAC/C,IAAI,IAAY,CAAC;IACjB,IAAI,CAAC;QAAC,IAAI,GAAG,EAAE,CAAC,YAAY,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,cAAc,CAAC;IAAC,CAAC;IAE5F,MAAM,IAAI,GAAG,CAAC,GAAW,EAAsB,EAAE;QAC/C,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,MAAM,CAAC,gBAAgB,GAAG,uBAAuB,CAAC,CAAC,CAAC;QAC7E,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IAChB,CAAC,CAAC;IAEF,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC;IAC/B,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAuB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,KAAK,CAAgB,CAAC;IACxG,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;IAC/B,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,QAAQ,CAAC,IAAc,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAA8B,CAAC;IACpI,MAAM,KAAK,GAAG,IAAI,CAAC,YAAY,CAAC,CAAC;IACjC,MAAM,SAAS,GAAG,CAAC,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,KAAe,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,SAAS,CAA+B,CAAC;IAElI,MAAM,KAAK,GAAG,QAAQ,IAAI,IAAI,IAAI,KAAK,CAAC;IACxC,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC;AAClF,CAAC"}

package/dist/harness/ledger.d.ts

@@ -0,0 +1,42 @@
+export interface LedgerEvent {
+    ts: string;
+    step: string;
+    runId?: string;
+    model?: string;
+    tokensIn?: number;
+    tokensOut?: number;
+    ms?: number;
+    note?: string;
+}
+/** Split events into runs — by runId when present, else by timestamp gap. */
+export declare function segmentRuns(events: LedgerEvent[]): LedgerEvent[][];
+/** Events of the most recent run only. */
+export declare function latestRunEvents(events: LedgerEvent[]): LedgerEvent[];
+export declare function recordEvent(screen: string, ev: Omit<LedgerEvent, 'ts'> & {
+    ts?: string;
+}): string;
+export declare function readEvents(screen: string): LedgerEvent[];
+export interface LedgerReport {
+    screen: string;
+    runs: number;
+    runScope: 'latest' | 'all';
+    events: number;
+    totalTokens: number;
+    totalMs: number;
+    byStep: Record<string, {
+        tokens: number;
+        ms: number;
+        count: number;
+    }>;
+    repairRounds: number;
+    repairTokenPct: number;
+    coveredCriticalViewpoints: number | null;
+    tokensPerCoveredCritical: number | null;
+    scenarioCount: number | null;
+    tokensPerScenario: number | null;
+    verdicts: string[];
+}
+export declare function buildReport(screen: string, opts?: {
+    allRuns?: boolean;
+}): LedgerReport;
+//# sourceMappingURL=ledger.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ledger.d.ts","sourceRoot":"","sources":["../../src/harness/ledger.ts"],"names":[],"mappings":"AAgBA,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAOD,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,EAAE,CAoBlE;AAED,0CAA0C;AAC1C,wBAAgB,eAAe,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CAGpE;AAMD,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAMjG;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,WAAW,EAAE,CAIxD;AAED,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,QAAQ,GAAG,KAAK,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtE,YAAY,EAAE,MAAM,CAAC;IACrB,cAAc,EAAE,MAAM,CAAC;IACvB,yBAAyB,EAAE,MAAM,GAAG,IAAI,CAAC;IACzC,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAAG,YAAY,CA0D1F"}