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

package/dist/harness/challenge.d.ts

@@ -0,0 +1,21 @@
+export interface ChallengeFinding {
+    scenario?: string;
+    issue: string;
+    suggestion: string;
+}
+export interface ChallengeReport {
+    screen: string;
+    overCovered: {
+        bucket: string;
+        count: number;
+        note: string;
+    }[];
+    shallowThemes: string[];
+    collectionClaimSingular: ChallengeFinding[];
+    noveltyPrompts: string[];
+    explorationReadiness: string[];
+}
+export declare function buildChallenge(screenDir: string, screenName: string): ChallengeReport;
+/** Render the Challenge Report as Markdown (advisory — not part of the official suite). */
+export declare function renderChallengeMarkdown(r: ChallengeReport): string;
+//# sourceMappingURL=challenge.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"challenge.d.ts","sourceRoot":"","sources":["../../src/harness/challenge.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IAEf,WAAW,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC/D,aAAa,EAAE,MAAM,EAAE,CAAC;IAExB,uBAAuB,EAAE,gBAAgB,EAAE,CAAC;IAE5C,cAAc,EAAE,MAAM,EAAE,CAAC;IAEzB,oBAAoB,EAAE,MAAM,EAAE,CAAC;CAChC;AAkBD,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,eAAe,CA2CrF;AAED,2FAA2F;AAC3F,wBAAgB,uBAAuB,CAAC,CAAC,EAAE,eAAe,GAAG,MAAM,CA0BlE"}

package/dist/harness/challenge.js

@@ -0,0 +1,151 @@
+"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.buildChallenge = buildChallenge;
+exports.renderChallengeMarkdown = renderChallengeMarkdown;
+/**
+ * Challenge / Exploration Harness (harness-roadmap P4) — Loop 2.
+ *
+ * Production mode (Loop 1: create-test → audit gate → repair) is deterministic by
+ * design: same spec + viewpoint → same official suite. That is the *feature* for
+ * delivery/CI, but it can feel like "a machine that always outputs the same thing".
+ *
+ * The Challenge Harness is the antidote: it does NOT regenerate the suite — it
+ * ATTACKS the existing one to surface what production missed. It is advisory
+ * (never auto-merges) and read-only.
+ *
+ * This module is the DETERMINISTIC spine — three structural critics:
+ *   1. Coverage   — over-covered (low-value) areas + shallow gate themes.
+ *   2. Depth      — titles that claim a collection but assert a single element.
+ *   3. Novelty    — risk-based prompts the AI `sungen-challenge` agent expands into
+ *                   concrete novelty candidates (semantic — not deterministic here).
+ *
+ * The AI agent layer adds the semantic + novelty judgement on top of this spine.
+ */
+const path = __importStar(require("path"));
+const parse_1 = require("./parse");
+const audit_1 = require("./audit");
+// A collection claim = a PLURAL set noun (or an explicit quantifier) used with a
+// DISPLAY verb. Plural-only avoids false-positives on single-item actions like
+// "Adding A product ... shows the dialog" (which correctly asserts one item).
+const PLURAL_NOUN = /\b(cards|items|products|rows|results|prices|entries|records)\b/i;
+const QUANTIFIER = /\b(all|every|each)\b/i;
+const DISPLAY_VERB = /\b(displays?|shows?|lists?|grid|contains?)\b/i;
+/** Risk lenses the Novelty critic prompts the AI to explore (beyond the catalog). */
+const NOVELTY_LENSES = [
+    'double-submit / rapid repeat of the primary action (duplicate side-effects?)',
+    'state after partial / slow load (assert against a not-yet-ready page)',
+    'boundary & unusual data (very long text, 0 / max quantity, special chars)',
+    'concurrency / back-button / refresh mid-flow',
+    'historical-incident mindset — what has broken on similar screens before?',
+];
+function buildChallenge(screenDir, screenName) {
+    const featurePath = path.join(screenDir, 'features', `${screenName}.feature`);
+    const scenarios = (0, parse_1.loadScenarios)(featurePath);
+    const audit = (0, audit_1.runAudit)(screenDir, screenName);
+    // 1. Coverage critic — over-covered buckets (secondary >> business-core) + shallow themes.
+    const buckets = audit.balance.byBucket;
+    const core = buckets['business-core'] || 0;
+    const overCovered = [];
+    for (const [bucket, count] of Object.entries(buckets)) {
+        if (['business-core', 'other'].includes(bucket))
+            continue;
+        if (core > 0 && count > core * 1.5) {
+            overCovered.push({ bucket, count, note: `${count} scenarios vs ${core} business-core — likely low-value expansion; trim toward correctness.` });
+        }
+    }
+    const shallowThemes = audit.gate.gaps.filter((g) => g.status === 'shallow').map((g) => g.theme);
+    // 2. Depth critic — title claims a collection but the assertion is singular (no "see all").
+    const collectionClaimSingular = [];
+    for (const s of scenarios) {
+        if (s.manual || s.category === 'NAV')
+            continue;
+        const claimsCollection = (PLURAL_NOUN.test(s.name) || QUANTIFIER.test(s.name)) && DISPLAY_VERB.test(s.name);
+        const assertsAll = /\bsee all\b/.test(s.haystack);
+        if (claimsCollection && !assertsAll) {
+            collectionClaimSingular.push({
+                scenario: s.name,
+                issue: 'Title implies a set (cards/items/all) but the assertion targets a single element.',
+                suggestion: 'Prove EVERY member: `Then User see all [<Card/Row>] contain {{...}}` instead of a single `see [X]`.',
+            });
+        }
+    }
+    // 3. Novelty critic — deterministic prompts; the AI agent expands these into candidates.
+    const noveltyPrompts = NOVELTY_LENSES.map((l) => `Find 1 non-obvious, valuable scenario via: ${l}`);
+    // Roll-up — exploration readiness signals (not a fake score).
+    const explorationReadiness = [];
+    if (collectionClaimSingular.length)
+        explorationReadiness.push(`${collectionClaimSingular.length} title↔assertion gap(s) — deterministic depth critic flagged these; an AI Business-Depth critic should confirm + fix.`);
+    if (overCovered.length)
+        explorationReadiness.push(`${overCovered.length} possibly over-covered area(s) — rebalance toward correctness.`);
+    if (shallowThemes.length)
+        explorationReadiness.push(`Shallow themes: ${shallowThemes.join(', ')}.`);
+    explorationReadiness.push('Novelty candidates are NOT generated deterministically — run the `sungen-challenge` agent (Claude) or its inline criteria (Copilot) to propose them, then QA accept/reject (≤20% of official, no auto-merge).');
+    return { screen: screenName, overCovered, shallowThemes, collectionClaimSingular, noveltyPrompts, explorationReadiness };
+}
+/** Render the Challenge Report as Markdown (advisory — not part of the official suite). */
+function renderChallengeMarkdown(r) {
+    const lines = [];
+    lines.push(`# Challenge Report — ${r.screen}`, '');
+    lines.push('> Advisory (Loop 2 / exploration mode). Does NOT change the official suite — it attacks it to surface blind spots. QA decides what to adopt.', '');
+    lines.push('## Depth — title claims a collection but asserts a single element');
+    if (r.collectionClaimSingular.length) {
+        lines.push('| Scenario | Issue | Suggested |', '|---|---|---|');
+        for (const f of r.collectionClaimSingular)
+            lines.push(`| ${f.scenario} | ${f.issue} | ${f.suggestion} |`);
+    }
+    else
+        lines.push('_none_');
+    lines.push('');
+    lines.push('## Coverage — possibly over-covered / shallow');
+    if (r.overCovered.length)
+        for (const o of r.overCovered)
+            lines.push(`- **${o.bucket}** — ${o.note}`);
+    if (r.shallowThemes.length)
+        lines.push(`- Shallow themes: ${r.shallowThemes.join(', ')}`);
+    if (!r.overCovered.length && !r.shallowThemes.length)
+        lines.push('_balanced_');
+    lines.push('');
+    lines.push('## Novelty — prompts for the AI critic (expand into candidates, ≤20% of official, no auto-merge)');
+    for (const p of r.noveltyPrompts)
+        lines.push(`- ${p}`);
+    lines.push('');
+    lines.push('## Exploration readiness');
+    for (const e of r.explorationReadiness)
+        lines.push(`- ${e}`);
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=challenge.js.map

package/dist/harness/challenge.js.map

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

package/dist/harness/feedback.d.ts

@@ -0,0 +1,29 @@
+export type FeedbackType = 'test-design' | 'product' | 'other';
+export type FeedbackDecision = 'accept' | 'reject' | 'edit' | 'add' | 'none';
+export interface FeedbackEntry {
+    ts: string;
+    type: FeedbackType;
+    screen?: string;
+    target?: string;
+    decision?: FeedbackDecision;
+    message: string;
+    reason?: string;
+    source: string;
+    auditScore?: number;
+}
+export declare function recordFeedback(entry: Omit<FeedbackEntry, 'ts' | 'source' | 'auditScore'> & {
+    ts?: string;
+    source?: string;
+}): string;
+export declare function readFeedback(): FeedbackEntry[];
+export interface FeedbackSummary {
+    total: number;
+    byType: Record<string, number>;
+    byDecision: Record<string, number>;
+    entries: FeedbackEntry[];
+}
+export declare function summarize(filter?: {
+    screen?: string;
+    type?: FeedbackType;
+}): FeedbackSummary;
+//# sourceMappingURL=feedback.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../../src/harness/feedback.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,YAAY,GAAG,aAAa,GAAG,SAAS,GAAG,OAAO,CAAC;AAC/D,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAE7E,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,YAAY,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAaD,wBAAgB,cAAc,CAAC,KAAK,EAAE,IAAI,CAAC,aAAa,EAAE,IAAI,GAAG,QAAQ,GAAG,YAAY,CAAC,GAAG;IAAE,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,MAAM,CAgBpI;AAED,wBAAgB,YAAY,IAAI,aAAa,EAAE,CAI9C;AAED,MAAM,WAAW,eAAe;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B;AAED,wBAAgB,SAAS,CAAC,MAAM,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,YAAY,CAAA;CAAE,GAAG,eAAe,CAW5F"}

package/dist/harness/feedback.js

@@ -0,0 +1,106 @@
+"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.recordFeedback = recordFeedback;
+exports.readFeedback = readFeedback;
+exports.summarize = summarize;
+/**
+ * Feedback — local-first capture of QA feedback. The most valuable use of
+ * feedback is closing the learning loop WITHIN a project (feed reuse/regenerate
+ * + improve the Guide), which needs no server. A future opt-in `feedback sync`
+ * can push anonymized metadata to a central API (Nấc 2) — not implemented here.
+ *
+ * Two purposes are kept distinct:
+ *   - test-design: a viewpoint/scenario is wrong / missing / duplicate  → knowledge
+ *   - product:     Sungen itself did X wrong                            → telemetry/issue
+ *
+ * Storage: .sungen/feedback/feedback.jsonl (append-only)
+ */
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+function feedbackPath() {
+    return path.join(process.cwd(), '.sungen', 'feedback', 'feedback.jsonl');
+}
+function currentAuditScore(screen) {
+    if (!screen)
+        return undefined;
+    const p = path.join(process.cwd(), '.sungen', 'reports', `${screen}-audit.json`);
+    if (!fs.existsSync(p))
+        return undefined;
+    try {
+        return JSON.parse(fs.readFileSync(p, 'utf-8'))?.score?.overall;
+    }
+    catch {
+        return undefined;
+    }
+}
+function recordFeedback(entry) {
+    const p = feedbackPath();
+    fs.mkdirSync(path.dirname(p), { recursive: true });
+    const full = {
+        ts: entry.ts ?? new Date().toISOString(),
+        type: entry.type,
+        screen: entry.screen,
+        target: entry.target,
+        decision: entry.decision ?? 'none',
+        message: entry.message,
+        reason: entry.reason,
+        source: entry.source ?? 'qa',
+        auditScore: currentAuditScore(entry.screen),
+    };
+    fs.appendFileSync(p, JSON.stringify(full) + '\n', 'utf-8');
+    return p;
+}
+function readFeedback() {
+    const p = feedbackPath();
+    if (!fs.existsSync(p))
+        return [];
+    return fs.readFileSync(p, 'utf-8').split('\n').filter(Boolean).map((l) => JSON.parse(l));
+}
+function summarize(filter) {
+    let entries = readFeedback();
+    if (filter?.screen)
+        entries = entries.filter((e) => e.screen === filter.screen);
+    if (filter?.type)
+        entries = entries.filter((e) => e.type === filter.type);
+    const byType = {};
+    const byDecision = {};
+    for (const e of entries) {
+        byType[e.type] = (byType[e.type] || 0) + 1;
+        byDecision[e.decision || 'none'] = (byDecision[e.decision || 'none'] || 0) + 1;
+    }
+    return { total: entries.length, byType, byDecision, entries };
+}
+//# sourceMappingURL=feedback.js.map

package/dist/harness/feedback.js.map

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