@sun-asterisk/sungen 3.0.0-beta.71 → 3.0.0-beta.73

package/dist/harness/capability-plan.js

@@ -0,0 +1,215 @@
+"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.MANUAL_REASONS = void 0;
+exports.parseScenarios = parseScenarios;
+exports.inferReasonCode = inferReasonCode;
+exports.buildPlan = buildPlan;
+/**
+ * Capability Planner (Phase 2b) — deterministic, recommend-only.
+ *
+ * Classifies each scenario's execution mode + each @manual case by reason code
+ * (M1–M9), maps capability-reasons to drivers, and emits the manual-reason KPI.
+ * Never installs anything (that's `sungen capability add`). See
+ * reports/sungen_phase2b_spec.md.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const capability_1 = require("./capability");
+exports.MANUAL_REASONS = {
+    M1: { code: 'M1', label: 'Missing data setup', cls: 'capability', drivers: ['data-factory'] },
+    M2: { code: 'M2', label: 'Missing API/DB assertion', cls: 'capability', drivers: ['api', 'db'] },
+    M3: { code: 'M3', label: 'Missing mock/network control', cls: 'capability', drivers: ['mock'] },
+    M4: { code: 'M4', label: 'Missing stable selector/test-id', cls: 'capability', drivers: [] }, // locator contract, no driver
+    M5: { code: 'M5', label: 'External dependency', cls: 'capability', drivers: ['mail-file', 'contract'] },
+    M6: { code: 'M6', label: 'Visual / UX judgment', cls: 'keep', drivers: ['specialized'] },
+    M7: { code: 'M7', label: 'Environment limitation', cls: 'capability', drivers: [] }, // testability, no driver
+    M8: { code: 'M8', label: 'Not worth automating', cls: 'keep', drivers: [] },
+    M9: { code: 'M9', label: 'True human judgment', cls: 'keep', drivers: [] },
+    // Not a single-screen driver gap: automatable cross-screen via a flow (/sungen:add-flow).
+    XS: { code: 'XS', label: 'Cross-screen (automate via flow)', cls: 'flow', drivers: [] },
+};
+// Keyword inference (best-effort retrofit). Order matters — first match wins.
+// Cross-screen "deferred to a flow" is checked FIRST: it is not a driver gap on
+// this screen, it is handled by a flow — so it must not recommend a driver.
+const INFER = [
+    { code: 'XS', re: /\b(deferred to a flow|cross[-\s]?screen|in a flow|via a flow)\b/i },
+    { code: 'M4', re: /\b(selector|test[-\s]?id|locator|data-testid)\b/i },
+    { code: 'M3', re: /\b(mock|stub|network|offline|slow network|intercept)\b/i },
+    { code: 'M2', re: /\b(api|endpoint|backend|db|database|server[-\s]?side|via api)\b/i },
+    { code: 'M1', re: /\b(data setup|dataset|seed|test data|empty (category|product|dataset|state)|zero products|forcing an empty|backend\/test data)\b/i },
+    { code: 'M5', re: /\b(external|third[-\s]?party|sandbox|email|mail|payment gateway|invoice|download)\b/i },
+    { code: 'M6', re: /\b(visual|responsive|layout|accessibilit|a11y|keyboard|screen reader|ux|breakpoint)\b/i },
+    { code: 'M7', re: /\b(environment|staging[-\s]?only|infra|env limitation)\b/i },
+    { code: 'M8', re: /\b(not worth|exploratory|one[-\s]?off)\b/i },
+    { code: 'M9', re: /\b(judgment|human|subjective|manual review)\b/i },
+];
+/** Parse scenarios with their tags + the reason comment line above (for @manual). */
+function parseScenarios(featurePath) {
+    if (!fs.existsSync(featurePath))
+        return [];
+    const lines = fs.readFileSync(featurePath, 'utf-8').split('\n');
+    const out = [];
+    for (let i = 0; i < lines.length; i++) {
+        const m = lines[i].match(/^\s*Scenario:\s*(.+)$/);
+        if (!m)
+            continue;
+        const tags = [];
+        let reason = '';
+        // Scan UP over the ADJACENT block (tag line + a directly-above reason comment).
+        // Stop at a blank line so section-divider comments further up aren't captured.
+        for (let j = i - 1; j >= 0 && j >= i - 6; j--) {
+            const l = lines[j].trim();
+            if (l === '')
+                break;
+            if (/^@/.test(l))
+                tags.unshift(...l.split(/\s+/).filter((t) => t.startsWith('@')));
+            else if (/^#/.test(l)) {
+                if (!reason)
+                    reason = l.replace(/^#+\s*/, '');
+            }
+            else
+                break;
+        }
+        // Scan DOWN for the reason comment placed as the first line inside the body.
+        for (let k = i + 1; k < lines.length && k <= i + 4; k++) {
+            const l = lines[k].trim();
+            if (/^#/.test(l)) {
+                if (!reason)
+                    reason = l.replace(/^#+\s*/, '');
+                break;
+            }
+            else if (l === '')
+                continue;
+            else
+                break; // a real step → stop
+        }
+        out.push({ name: m[1].trim(), tags, manual: tags.some((t) => /^@manual\b/i.test(t)), reason });
+    }
+    return out;
+}
+function explicitCode(tags) {
+    for (const t of tags) {
+        const m = t.match(/^@(?:manual|reason):(M[1-9])$/i);
+        if (m)
+            return m[1].toUpperCase();
+    }
+    return undefined;
+}
+function inferReasonCode(tags, reason) {
+    const ex = explicitCode(tags);
+    if (ex)
+        return { code: ex, explicit: true, unclassified: false };
+    for (const r of INFER)
+        if (r.re.test(reason))
+            return { code: r.code, explicit: false, unclassified: false };
+    return { code: 'M9', explicit: false, unclassified: true };
+}
+function classifyMode(tags) {
+    const has = (re) => tags.some((t) => re.test(t));
+    if (has(/^@manual\b/i))
+        return 'manual';
+    if (has(/^@hybrid$/i))
+        return 'hybrid';
+    if (has(/^@(api|apiassert)$/i))
+        return 'api';
+    if (has(/^@(mock|network)$/i))
+        return 'mock';
+    if (has(/^@dbassert$/i))
+        return 'dbAssert';
+    return 'ui';
+}
+function buildPlan(screenDir, screenName) {
+    const featurePath = path.join(screenDir, 'features', `${screenName}.feature`);
+    const scenarios = parseScenarios(featurePath);
+    const catalog = (0, capability_1.loadDriverCatalog)();
+    const modes = {};
+    const byReason = {};
+    const unclassified = [];
+    // driver → {reasonCode, scenarios}
+    const recByDriver = new Map();
+    const keepCount = {};
+    let capabilityManual = 0, judgmentManual = 0, crossScreen = 0;
+    for (const s of scenarios) {
+        const mode = classifyMode(s.tags);
+        modes[mode] = (modes[mode] || 0) + 1;
+        if (mode !== 'manual')
+            continue;
+        const { code, unclassified: unc } = inferReasonCode(s.tags, s.reason);
+        byReason[code] = (byReason[code] || 0) + 1;
+        if (unc)
+            unclassified.push({ name: s.name, reason: s.reason || '(no reason comment)' });
+        const def = exports.MANUAL_REASONS[code];
+        if (def.cls === 'flow') {
+            crossScreen++;
+        }
+        else if (def.cls === 'capability') {
+            capabilityManual++;
+            for (const d of def.drivers) {
+                const cur = recByDriver.get(d) || { reason: code, scenarios: [] };
+                cur.scenarios.push(s.name);
+                recByDriver.set(d, cur);
+            }
+        }
+        else {
+            judgmentManual++;
+            keepCount[code] = (keepCount[code] || 0) + 1;
+        }
+    }
+    const recommendations = [...recByDriver.entries()]
+        .map(([driver, v]) => ({
+        driver,
+        pkg: catalog[driver]?.package || `@sungen/driver-${driver}`,
+        reason: v.reason,
+        count: v.scenarios.length,
+        scenarios: v.scenarios,
+    }))
+        .sort((a, b) => b.count - a.count);
+    const manualTotal = modes['manual'] || 0;
+    return {
+        screen: screenName,
+        total: scenarios.length,
+        modes,
+        byReason,
+        unclassified,
+        capabilityManual,
+        judgmentManual,
+        crossScreen,
+        capabilityManualPct: manualTotal ? Math.round((capabilityManual / manualTotal) * 100) : 0,
+        recommendations,
+        keep: Object.entries(keepCount).map(([code, count]) => ({ code, count })).sort((a, b) => b.count - a.count),
+    };
+}
+//# sourceMappingURL=capability-plan.js.map

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

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

package/dist/harness/capability.d.ts

@@ -0,0 +1,23 @@
+export interface CapabilityProfile {
+    platform?: string;
+    enabled: string[];
+    source: 'capabilities.yaml' | 'absent';
+}
+export interface DriverMeta {
+    id: string;
+    kind: 'platform' | 'capability';
+    package: string;
+    runtime?: string;
+    adapter?: string;
+    capabilities: string[];
+    unblocks?: string[];
+}
+export declare function capabilitiesPath(cwd: string): string;
+export declare function readCapabilities(cwd: string): CapabilityProfile;
+export declare function writeCapabilities(cwd: string, profile: {
+    platform?: string;
+    enabled: string[];
+}): string;
+export declare function loadDriverCatalog(): Record<string, DriverMeta>;
+export declare function driverMeta(id: string): DriverMeta | undefined;
+//# sourceMappingURL=capability.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/harness/capability.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,MAAM,EAAE,mBAAmB,GAAG,QAAQ,CAAC;CACxC;AAED,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,UAAU,GAAG,YAAY,CAAC;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAa/D;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,MAAM,CAUxG;AAGD,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAQ9D;AAED,wBAAgB,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAE7D"}

package/dist/harness/capability.js

@@ -0,0 +1,98 @@
+"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.capabilitiesPath = capabilitiesPath;
+exports.readCapabilities = readCapabilities;
+exports.writeCapabilities = writeCapabilities;
+exports.loadDriverCatalog = loadDriverCatalog;
+exports.driverMeta = driverMeta;
+/**
+ * Capability profile + driver catalog (harness-roadmap Phase 2a).
+ *
+ * Sungen core is runtime-agnostic: a project declares its PLATFORM driver (web →
+ * Playwright, mobile → Appium) + any capability drivers in qa/capabilities.yaml.
+ * There is no default runtime — but for back-compat, an ABSENT profile is treated
+ * as `web` (the bundled adapter) with a one-time notice + scaffold.
+ *
+ * This module is metadata + profile I/O only. It never installs or imports a driver.
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const yaml_1 = require("yaml");
+function capabilitiesPath(cwd) {
+    return path.join(cwd, 'qa', 'capabilities.yaml');
+}
+function readCapabilities(cwd) {
+    const p = capabilitiesPath(cwd);
+    if (!fs.existsSync(p))
+        return { platform: undefined, enabled: [], source: 'absent' };
+    try {
+        const y = (0, yaml_1.parse)(fs.readFileSync(p, 'utf-8')) || {};
+        return {
+            platform: typeof y.platform === 'string' ? y.platform : undefined,
+            enabled: Array.isArray(y.enabled) ? y.enabled.map(String) : [],
+            source: 'capabilities.yaml',
+        };
+    }
+    catch {
+        return { platform: undefined, enabled: [], source: 'absent' };
+    }
+}
+function writeCapabilities(cwd, profile) {
+    const p = capabilitiesPath(cwd);
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    const body = '# Sungen capability profile — which runtime/drivers this project uses.\n' +
+        '# platform: the runtime adapter (web → Playwright, mobile → Appium). No default.\n' +
+        '# enabled: drivers turned on (added via `sungen capability add <driver>`).\n\n' +
+        (0, yaml_1.stringify)({ platform: profile.platform, enabled: profile.enabled });
+    fs.writeFileSync(p, body, 'utf-8');
+    return p;
+}
+let _catalog = null;
+function loadDriverCatalog() {
+    if (_catalog)
+        return _catalog;
+    const p = path.join(__dirname, 'catalog', 'drivers.yaml');
+    const y = (0, yaml_1.parse)(fs.readFileSync(p, 'utf-8'));
+    const out = {};
+    for (const [id, meta] of Object.entries(y.drivers))
+        out[id] = { id, ...meta };
+    _catalog = out;
+    return out;
+}
+function driverMeta(id) {
+    return loadDriverCatalog()[id];
+}
+//# sourceMappingURL=capability.js.map

package/dist/harness/capability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.js","sourceRoot":"","sources":["../../src/harness/capability.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AA8BA,4CAEC;AAED,4CAaC;AAED,8CAUC;AAGD,8CAQC;AAED,gCAEC;AA1ED;;;;;;;;;GASG;AACH,uCAAyB;AACzB,2CAA6B;AAC7B,+BAAsE;AAkBtE,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,mBAAmB,CAAC,CAAC;AACnD,CAAC;AAED,SAAgB,gBAAgB,CAAC,GAAW;IAC1C,MAAM,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;QAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IACrF,IAAI,CAAC;QACH,MAAM,CAAC,GAAG,IAAA,YAAS,EAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;QACvD,OAAO;YACL,QAAQ,EAAE,OAAO,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS;YACjE,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE;YAC9D,MAAM,EAAE,mBAAmB;SAC5B,CAAC;IACJ,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC;IAChE,CAAC;AACH,CAAC;AAED,SAAgB,iBAAiB,CAAC,GAAW,EAAE,OAAiD;IAC9F,MAAM,CAAC,GAAG,gBAAgB,CAAC,GAAG,CAAC,CAAC;IAChC,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACnD,MAAM,IAAI,GACR,0EAA0E;QAC1E,oFAAoF;QACpF,gFAAgF;QAChF,IAAA,gBAAa,EAAC,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC;IAC1E,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,CAAC,CAAC;AACX,CAAC;AAED,IAAI,QAAQ,GAAsC,IAAI,CAAC;AACvD,SAAgB,iBAAiB;IAC/B,IAAI,QAAQ;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,SAAS,EAAE,cAAc,CAAC,CAAC;IAC1D,MAAM,CAAC,GAAG,IAAA,YAAS,EAAC,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC,CAAwD,CAAC;IACxG,MAAM,GAAG,GAA+B,EAAE,CAAC;IAC3C,KAAK,MAAM,CAAC,EAAE,EAAE,IAAI,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC;QAAE,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,EAAE,GAAG,IAAI,EAAE,CAAC;IAC9E,QAAQ,GAAG,GAAG,CAAC;IACf,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAgB,UAAU,CAAC,EAAU;IACnC,OAAO,iBAAiB,EAAE,CAAC,EAAE,CAAC,CAAC;AACjC,CAAC"}

package/dist/harness/catalog/drivers.yaml

@@ -0,0 +1,57 @@
+# Driver Catalog (metadata only — NO driver code is bundled here).
+# Lets Sungen RECOMMEND/RESOLVE a driver that may not be installed yet, and tells
+# `sungen capability add` which package to install. See reports/sungen_phase2a_spec.md.
+#
+# kind: platform → the runtime/codegen adapter for a target (pick ONE per project)
+# kind: capability → an extra ability added on top of a platform (Phase 3)
+# unblocks: manual-reason codes (M1–M9) this driver can resolve (Phase 2b taxonomy)
+
+drivers:
+  web:
+    kind: platform
+    package: "@sungen/driver-web"     # Phase 2a: bundled Playwright adapter serves this (back-compat)
+    runtime: playwright
+    adapter: web                       # registry adapter name
+    capabilities: ["@ui"]
+  mobile:
+    kind: platform
+    package: "@sungen/driver-mobile"
+    runtime: appium
+    adapter: mobile
+    capabilities: ["@ui"]
+
+  api:
+    kind: capability
+    package: "@sungen/driver-api"
+    capabilities: ["@api", "@apiAssert", "@hybrid"]
+    unblocks: [M2]
+  data-factory:
+    kind: capability
+    package: "@sungen/driver-data-factory"
+    capabilities: ["@dataFactory"]
+    unblocks: [M1]
+  db:
+    kind: capability
+    package: "@sungen/driver-db"
+    capabilities: ["@dbAssert"]
+    unblocks: [M2]
+  mock:
+    kind: capability
+    package: "@sungen/driver-mock"
+    capabilities: ["@mock", "@network"]
+    unblocks: [M3]
+  mail-file:
+    kind: capability
+    package: "@sungen/driver-mail-file"
+    capabilities: ["@mail", "@file"]
+    unblocks: [M5]
+  contract:
+    kind: capability
+    package: "@sungen/driver-contract"
+    capabilities: ["@contract"]
+    unblocks: [M5]
+  specialized:
+    kind: capability
+    package: "@sungen/driver-specialized"
+    capabilities: ["@specialized"]
+    unblocks: [M6]

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"}