@graypark/loophaus 3.4.0 → 3.5.0

package/dist/core/quality-scorer.js

@@ -0,0 +1,128 @@
+// core/quality-scorer.ts
+// Quality scoring for story implementations (autoresearch pattern: val_bpb -> quality score)
+import { execFile } from "node:child_process";
+import { promisify } from "node:util";
+import { readFile, stat } from "node:fs/promises";
+import { join } from "node:path";
+const execFileAsync = promisify(execFile);
+const CRITERIA = {
+    tests: { weight: 3, max: 10 },
+    typecheck: { weight: 2, max: 10 },
+    lint: { weight: 1, max: 10 },
+    verify: { weight: 2, max: 10 },
+    diff: { weight: 1, max: 10 },
+    custom: { weight: 1, max: 10 },
+};
+export function scoreStory(results) {
+    let totalWeight = 0;
+    let weightedSum = 0;
+    const breakdown = {};
+    for (const [key, config] of Object.entries(CRITERIA)) {
+        if (results[key] === undefined || results[key] === null)
+            continue;
+        const raw = results[key];
+        const value = typeof raw === "number" ? raw : (raw.score ?? 0);
+        const clamped = Math.max(0, Math.min(config.max, value));
+        breakdown[key] = clamped;
+        weightedSum += clamped * config.weight;
+        totalWeight += config.max * config.weight;
+    }
+    const score = totalWeight > 0 ? Math.round((weightedSum / totalWeight) * 100) : 0;
+    const grade = score >= 90 ? "A" : score >= 80 ? "B" : score >= 70 ? "C" : score >= 60 ? "D" : "F";
+    return { score, grade, breakdown };
+}
+export async function evaluateStory(storyId, cwd, config = {}) {
+    const results = {};
+    if (config.testCommand) {
+        try {
+            await execFileAsync("sh", ["-c", config.testCommand], { cwd, timeout: 120_000 });
+            results.tests = 10;
+        }
+        catch {
+            results.tests = 0;
+        }
+    }
+    if (config.typecheckCommand) {
+        try {
+            await execFileAsync("sh", ["-c", config.typecheckCommand], { cwd, timeout: 60_000 });
+            results.typecheck = 10;
+        }
+        catch (err) {
+            const errorCount = (err.stdout || "").split("\n").filter(l => l.includes("error")).length;
+            results.typecheck = Math.max(0, 10 - errorCount);
+        }
+    }
+    if (config.lintCommand) {
+        try {
+            await execFileAsync("sh", ["-c", config.lintCommand], { cwd, timeout: 60_000 });
+            results.lint = 10;
+        }
+        catch (err) {
+            const warnings = (err.stdout || "").split("\n").filter(l => l.includes("warning") || l.includes("error")).length;
+            results.lint = Math.max(0, 10 - warnings);
+        }
+    }
+    if (config.verifyScript) {
+        try {
+            await execFileAsync("sh", ["-c", config.verifyScript], { cwd, timeout: 60_000 });
+            results.verify = 10;
+        }
+        catch {
+            results.verify = 0;
+        }
+    }
+    try {
+        const { stdout } = await execFileAsync("git", ["diff", "--stat", "HEAD~1"], { cwd, timeout: 10_000 });
+        const lines = stdout.trim().split("\n");
+        const lastLine = lines[lines.length - 1] || "";
+        const match = lastLine.match(/(\d+) insertion.+?(\d+) deletion/);
+        if (match) {
+            const total = parseInt(match[1]) + parseInt(match[2]);
+            results.diff = total < 100 ? 10 : total < 300 ? 8 : total < 500 ? 6 : total < 1000 ? 4 : 2;
+        }
+    }
+    catch {
+        // No git diff available
+    }
+    const customPath = join(cwd, ".loophaus", "quality.mjs");
+    try {
+        await stat(customPath);
+        const mod = await import(customPath);
+        if (typeof mod.evaluate === "function") {
+            const customResult = await mod.evaluate(storyId, cwd);
+            results.custom = typeof customResult === "number" ? customResult : (customResult?.score ?? 0);
+        }
+    }
+    catch {
+        // No custom evaluator
+    }
+    return { storyId, results, ...scoreStory(results) };
+}
+export async function logResult(entry, cwd) {
+    const { appendFile, mkdir } = await import("node:fs/promises");
+    const tsvPath = join(cwd || process.cwd(), ".loophaus", "results.tsv");
+    await mkdir(join(cwd || process.cwd(), ".loophaus"), { recursive: true });
+    try {
+        await stat(tsvPath);
+    }
+    catch {
+        await appendFile(tsvPath, "story_id\tattempt\tscore\tstatus\tdescription\tcommit\n", "utf-8");
+    }
+    const line = `${entry.storyId}\t${entry.attempt}\t${entry.score}\t${entry.status}\t${entry.description}\t${entry.commit || ""}\n`;
+    await appendFile(tsvPath, line, "utf-8");
+}
+export async function readResults(cwd) {
+    const tsvPath = join(cwd || process.cwd(), ".loophaus", "results.tsv");
+    try {
+        const raw = await readFile(tsvPath, "utf-8");
+        const lines = raw.trim().split("\n").slice(1);
+        return lines.map(line => {
+            const [storyId, attempt, score, status, description, commit] = line.split("\t");
+            return { storyId, attempt: parseInt(attempt), score: parseInt(score), status, description, commit };
+        });
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=quality-scorer.js.map

package/dist/core/quality-scorer.js.map

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

package/dist/core/refine-loop.d.ts

@@ -0,0 +1,16 @@
+interface Evaluation {
+    storyId: string;
+    score: number;
+    grade: string;
+    breakdown: Record<string, number>;
+}
+interface PreviousAttempt {
+    attempt: number;
+    score: number;
+    status: string;
+}
+export declare function shouldKeep(newScore: number, baselineScore: number): boolean;
+export declare function generateFeedback(evaluation: Evaluation, previousAttempts?: PreviousAttempt[]): string;
+export declare function identifyRefinementTargets(evaluations: Evaluation[], threshold?: number): Evaluation[];
+export {};
+//# sourceMappingURL=refine-loop.d.ts.map

package/dist/core/refine-loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"refine-loop.d.ts","sourceRoot":"","sources":["../../core/refine-loop.ts"],"names":[],"mappings":"AAGA,UAAU,UAAU;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,UAAU,eAAe;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAE3E;AAED,wBAAgB,gBAAgB,CAAC,UAAU,EAAE,UAAU,EAAE,gBAAgB,GAAE,eAAe,EAAO,GAAG,MAAM,CAezG;AAED,wBAAgB,yBAAyB,CAAC,WAAW,EAAE,UAAU,EAAE,EAAE,SAAS,GAAE,MAAW,GAAG,UAAU,EAAE,CAIzG"}

package/dist/core/refine-loop.js

@@ -0,0 +1,26 @@
+// core/refine-loop.ts
+// autoresearch keep/discard pattern for code quality improvement
+export function shouldKeep(newScore, baselineScore) {
+    return newScore > baselineScore;
+}
+export function generateFeedback(evaluation, previousAttempts = []) {
+    const { storyId, score, grade, breakdown } = evaluation;
+    const failedCriteria = Object.entries(breakdown)
+        .filter(([_, v]) => v < 7)
+        .map(([k, v]) => `${k}: ${v}/10`);
+    let prompt = `Story ${storyId} quality: ${score}/100 (${grade}).\n`;
+    if (failedCriteria.length > 0) {
+        prompt += `Weak areas: ${failedCriteria.join(", ")}.\n`;
+    }
+    if (previousAttempts.length > 0) {
+        prompt += `Previous attempts: ${previousAttempts.map(a => `attempt ${a.attempt}: ${a.score} (${a.status})`).join(", ")}.\n`;
+    }
+    prompt += `Improve the implementation. Focus on the weak areas. Try a different approach if the same strategy keeps failing.`;
+    return prompt;
+}
+export function identifyRefinementTargets(evaluations, threshold = 80) {
+    return evaluations
+        .filter(e => e.score < threshold)
+        .sort((a, b) => a.score - b.score);
+}
+//# sourceMappingURL=refine-loop.js.map

package/dist/core/refine-loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"refine-loop.js","sourceRoot":"","sources":["../../core/refine-loop.ts"],"names":[],"mappings":"AAAA,sBAAsB;AACtB,iEAAiE;AAejE,MAAM,UAAU,UAAU,CAAC,QAAgB,EAAE,aAAqB;IAChE,OAAO,QAAQ,GAAG,aAAa,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,UAAsB,EAAE,mBAAsC,EAAE;IAC/F,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,GAAG,UAAU,CAAC;IACxD,MAAM,cAAc,GAAG,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC;SAC7C,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC;SACzB,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpC,IAAI,MAAM,GAAG,SAAS,OAAO,aAAa,KAAK,SAAS,KAAK,MAAM,CAAC;IACpE,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,MAAM,IAAI,eAAe,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IAC1D,CAAC;IACD,IAAI,gBAAgB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,sBAAsB,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,CAAC,CAAC,OAAO,KAAK,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC;IAC9H,CAAC;IACD,MAAM,IAAI,mHAAmH,CAAC;IAC9H,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,yBAAyB,CAAC,WAAyB,EAAE,YAAoB,EAAE;IACzF,OAAO,WAAW;SACf,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,SAAS,CAAC;SAChC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/core/session.d.ts

@@ -0,0 +1,27 @@
+interface CheckpointData {
+    [key: string]: unknown;
+}
+interface Checkpoint extends CheckpointData {
+    sessionId: string;
+    savedAt: string;
+}
+interface SessionData {
+    savedAt: string;
+    [key: string]: unknown;
+}
+export declare function saveCheckpoint(sessionId: string, data: CheckpointData, cwd?: string): Promise<Checkpoint>;
+export declare function loadCheckpoint(sessionId: string, cwd?: string): Promise<Checkpoint | null>;
+export declare function listSessions(cwd?: string): Promise<SessionData[]>;
+interface ResumedState {
+    active: boolean;
+    prompt: string;
+    completionPromise: string;
+    maxIterations: number;
+    currentIteration: number;
+    sessionId: string;
+    name: string;
+    startedAt: string;
+}
+export declare function resumeSession(sessionId: string, cwd?: string): Promise<ResumedState | null>;
+export {};
+//# sourceMappingURL=session.d.ts.map

package/dist/core/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../../core/session.ts"],"names":[],"mappings":"AAGA,UAAU,cAAc;IACtB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,UAAU,UAAW,SAAQ,cAAc;IACzC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,UAAU,WAAW;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAMD,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,IAAI,EAAE,cAAc,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,CAU/G;AAED,wBAAsB,cAAc,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAQhG;AAED,wBAAsB,YAAY,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,EAAE,CAAC,CAiBvE;AAYD,UAAU,YAAY;IACpB,MAAM,EAAE,OAAO,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAkBjG"}

package/dist/core/session.js

@@ -0,0 +1,67 @@
+import { readFile, writeFile, readdir, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+function getSessionsDir(cwd) {
+    return join(cwd || process.cwd(), ".loophaus", "sessions");
+}
+export async function saveCheckpoint(sessionId, data, cwd) {
+    const dir = getSessionsDir(cwd);
+    await mkdir(dir, { recursive: true });
+    const checkpoint = {
+        sessionId,
+        savedAt: new Date().toISOString(),
+        ...data,
+    };
+    await writeFile(join(dir, `${sessionId}.json`), JSON.stringify(checkpoint, null, 2), "utf-8");
+    return checkpoint;
+}
+export async function loadCheckpoint(sessionId, cwd) {
+    const dir = getSessionsDir(cwd);
+    try {
+        const raw = await readFile(join(dir, `${sessionId}.json`), "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return null;
+    }
+}
+export async function listSessions(cwd) {
+    const dir = getSessionsDir(cwd);
+    try {
+        const files = await readdir(dir);
+        const sessions = [];
+        for (const file of files) {
+            if (!file.endsWith(".json"))
+                continue;
+            try {
+                const raw = await readFile(join(dir, file), "utf-8");
+                const data = JSON.parse(raw);
+                sessions.push(data);
+            }
+            catch { /* skip malformed */ }
+        }
+        return sessions.sort((a, b) => new Date(b.savedAt).getTime() - new Date(a.savedAt).getTime());
+    }
+    catch {
+        return [];
+    }
+}
+export async function resumeSession(sessionId, cwd) {
+    const checkpoint = await loadCheckpoint(sessionId, cwd);
+    if (!checkpoint)
+        return null;
+    const stateStore = await import("../store/state-store.js");
+    const write = stateStore.write;
+    const state = {
+        active: true,
+        prompt: checkpoint.prompt || "",
+        completionPromise: checkpoint.completionPromise || "TADA",
+        maxIterations: checkpoint.maxIterations || 20,
+        currentIteration: checkpoint.currentIteration || 0,
+        sessionId: checkpoint.sessionId,
+        name: checkpoint.name || "",
+        startedAt: checkpoint.startedAt || new Date().toISOString(),
+    };
+    await write(state, cwd, checkpoint.name);
+    return state;
+}
+//# sourceMappingURL=session.js.map

package/dist/core/session.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.js","sourceRoot":"","sources":["../../core/session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAgBjC,SAAS,cAAc,CAAC,GAAY;IAClC,OAAO,IAAI,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;AAC7D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAiB,EAAE,IAAoB,EAAE,GAAY;IACxF,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAChC,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtC,MAAM,UAAU,GAAe;QAC7B,SAAS;QACT,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACjC,GAAG,IAAI;KACR,CAAC;IACF,MAAM,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IAC9F,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,SAAiB,EAAE,GAAY;IAClE,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,OAAO,CAAC,EAAE,OAAO,CAAC,CAAC;QACpE,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,GAAY;IAC7C,MAAM,GAAG,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,CAAC;QACH,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC;QACjC,MAAM,QAAQ,GAAkB,EAAE,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC;gBAAE,SAAS;YACtC,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,OAAO,CAAC,CAAC;gBACrD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAgB,CAAC;gBAC5C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACtB,CAAC;YAAC,MAAM,CAAC,CAAC,oBAAoB,CAAC,CAAC;QAClC,CAAC;QACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;IAChG,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAuBD,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,SAAiB,EAAE,GAAY;IACjE,MAAM,UAAU,GAAG,MAAM,cAAc,CAAC,SAAS,EAAE,GAAG,CAA4B,CAAC;IACnF,IAAI,CAAC,UAAU;QAAE,OAAO,IAAI,CAAC;IAE7B,MAAM,UAAU,GAAG,MAAM,MAAM,CAAC,yBAAyB,CAAC,CAAC;IAC3D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAuF,CAAC;IACjH,MAAM,KAAK,GAAiB;QAC1B,MAAM,EAAE,IAAI;QACZ,MAAM,EAAE,UAAU,CAAC,MAAM,IAAI,EAAE;QAC/B,iBAAiB,EAAE,UAAU,CAAC,iBAAiB,IAAI,MAAM;QACzD,aAAa,EAAE,UAAU,CAAC,aAAa,IAAI,EAAE;QAC7C,gBAAgB,EAAE,UAAU,CAAC,gBAAgB,IAAI,CAAC;QAClD,SAAS,EAAE,UAAU,CAAC,SAAS;QAC/B,IAAI,EAAE,UAAU,CAAC,IAAI,IAAI,EAAE;QAC3B,SAAS,EAAE,UAAU,CAAC,SAAS,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;KAC5D,CAAC;IACF,MAAM,KAAK,CAAC,KAAK,EAAE,GAAG,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC;IACzC,OAAO,KAAK,CAAC;AACf,CAAC"}

package/dist/core/trace-analyzer.d.ts

@@ -0,0 +1,28 @@
+import type { LoopEvent } from "./types.js";
+import type { EventSummary } from "./events.js";
+export interface TraceAnalysis extends EventSummary {
+    iterations: number;
+    stops: number;
+    errors: number;
+    storiesCompleted: number;
+    totalCost: number;
+    lastStopReason: string | null;
+    avgIterationMs: number;
+}
+export interface TraceComparison {
+    trace1: TraceAnalysis;
+    trace2: TraceAnalysis;
+    diff: {
+        iterations: number;
+        totalCost: number;
+        durationMs: number;
+        storiesCompleted: number;
+    };
+}
+export interface ReplayEvent extends LoopEvent {
+    relativeMs: number;
+}
+export declare function analyzeTrace(events: LoopEvent[]): TraceAnalysis;
+export declare function compareTraces(trace1: LoopEvent[], trace2: LoopEvent[]): TraceComparison;
+export declare function replayTrace(events: LoopEvent[], speed?: number): ReplayEvent[];
+//# sourceMappingURL=trace-analyzer.d.ts.map

package/dist/core/trace-analyzer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-analyzer.d.ts","sourceRoot":"","sources":["../../core/trace-analyzer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,aAAc,SAAQ,YAAY;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,aAAa,CAAC;IACtB,MAAM,EAAE,aAAa,CAAC;IACtB,IAAI,EAAE;QACJ,UAAU,EAAE,MAAM,CAAC;QACnB,SAAS,EAAE,MAAM,CAAC;QAClB,UAAU,EAAE,MAAM,CAAC;QACnB,gBAAgB,EAAE,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,aAAa,CAqB/D;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,eAAe,CAcvF;AAED,wBAAgB,WAAW,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,KAAK,GAAE,MAAU,GAAG,WAAW,EAAE,CAOjF"}

package/dist/core/trace-analyzer.js

@@ -0,0 +1,46 @@
+// Pure functions for trace analysis
+import { EventType, filterByType, summarizeEvents } from "./events.js";
+export function analyzeTrace(events) {
+    const summary = summarizeEvents(events);
+    const iterations = filterByType(events, EventType.ITERATION);
+    const stops = filterByType(events, EventType.STOP);
+    const errors = filterByType(events, EventType.ERROR);
+    const stories = filterByType(events, EventType.STORY_COMPLETE);
+    const costs = filterByType(events, EventType.COST);
+    const totalCost = costs.reduce((s, e) => s + (e.totalCost || 0), 0);
+    const lastStop = stops[stops.length - 1];
+    return {
+        ...summary,
+        iterations: iterations.length,
+        stops: stops.length,
+        errors: errors.length,
+        storiesCompleted: stories.length,
+        totalCost,
+        lastStopReason: lastStop?.reason || null,
+        avgIterationMs: iterations.length > 1 ? summary.durationMs / iterations.length : 0,
+    };
+}
+export function compareTraces(trace1, trace2) {
+    const a1 = analyzeTrace(trace1);
+    const a2 = analyzeTrace(trace2);
+    return {
+        trace1: a1,
+        trace2: a2,
+        diff: {
+            iterations: a2.iterations - a1.iterations,
+            totalCost: a2.totalCost - a1.totalCost,
+            durationMs: a2.durationMs - a1.durationMs,
+            storiesCompleted: a2.storiesCompleted - a1.storiesCompleted,
+        },
+    };
+}
+export function replayTrace(events, speed = 1) {
+    if (events.length === 0)
+        return [];
+    const firstTs = new Date(events[0].ts).getTime();
+    return events.map(e => ({
+        ...e,
+        relativeMs: Math.round((new Date(e.ts).getTime() - firstTs) / speed),
+    }));
+}
+//# sourceMappingURL=trace-analyzer.js.map

package/dist/core/trace-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trace-analyzer.js","sourceRoot":"","sources":["../../core/trace-analyzer.ts"],"names":[],"mappings":"AAAA,oCAAoC;AAGpC,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AA4BvE,MAAM,UAAU,YAAY,CAAC,MAAmB;IAC9C,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;IACxC,MAAM,UAAU,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC,CAAC;IAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;IACrD,MAAM,OAAO,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,cAAc,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,YAAY,CAAC,MAAM,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC;IAEnD,MAAM,SAAS,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAE,CAAC,CAAC,SAAoB,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAEzC,OAAO;QACL,GAAG,OAAO;QACV,UAAU,EAAE,UAAU,CAAC,MAAM;QAC7B,KAAK,EAAE,KAAK,CAAC,MAAM;QACnB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,gBAAgB,EAAE,OAAO,CAAC,MAAM;QAChC,SAAS;QACT,cAAc,EAAG,QAAQ,EAAE,MAAiB,IAAI,IAAI;QACpD,cAAc,EAAE,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,UAAU,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;KACnF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,MAAmB,EAAE,MAAmB;IACpE,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,EAAE,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEhC,OAAO;QACL,MAAM,EAAE,EAAE;QACV,MAAM,EAAE,EAAE;QACV,IAAI,EAAE;YACJ,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,UAAU;YACzC,SAAS,EAAE,EAAE,CAAC,SAAS,GAAG,EAAE,CAAC,SAAS;YACtC,UAAU,EAAE,EAAE,CAAC,UAAU,GAAG,EAAE,CAAC,UAAU;YACzC,gBAAgB,EAAE,EAAE,CAAC,gBAAgB,GAAG,EAAE,CAAC,gBAAgB;SAC5D;KACF,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,MAAmB,EAAE,QAAgB,CAAC;IAChE,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,CAAC;IACnC,MAAM,OAAO,GAAG,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAY,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3D,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;QACtB,GAAG,CAAC;QACJ,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,CAAC,EAAY,CAAC,CAAC,OAAO,EAAE,GAAG,OAAO,CAAC,GAAG,KAAK,CAAC;KAC/E,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/core/types.d.ts

@@ -0,0 +1,99 @@
+export interface LoopState {
+    active: boolean;
+    prompt: string;
+    completionPromise: string;
+    maxIterations: number;
+    currentIteration: number;
+    sessionId: string;
+    verifyScript: string;
+    name?: string;
+    startedAt?: string;
+    qualityThreshold?: number;
+    maxRefineAttempts?: number;
+    qualityConfig?: QualityConfig | null;
+}
+export interface StopHookInput {
+    last_assistant_text: string;
+    stop_hook_active: boolean;
+    has_pending_stories: boolean;
+    session_id: string;
+    transcript_path?: string;
+    policy_result?: PolicyResult;
+    verify_result?: VerifyResult;
+    test_results?: TestResult[];
+}
+export interface StopHookResult {
+    decision: "allow" | "block";
+    nextState: LoopState;
+    events: LoopEvent[];
+    output: StopHookOutput | null;
+    message?: string;
+}
+export interface StopHookOutput {
+    decision: "block";
+    reason: string;
+    systemMessage?: string;
+}
+export interface LoopEvent {
+    event: string;
+    [key: string]: unknown;
+}
+export interface PolicyResult {
+    shouldStop: boolean;
+    violations: PolicyViolation[];
+}
+export interface PolicyViolation {
+    type: string;
+    current: number;
+    limit: number;
+}
+export interface VerifyResult {
+    passed: boolean;
+    output?: string;
+}
+export interface TestResult {
+    storyId: string;
+    passed: boolean;
+}
+export interface QualityScore {
+    story: string;
+    tests: number;
+    typecheck: number;
+    lint: number;
+    verify: number;
+    diff: number;
+    custom: number;
+    total: number;
+    grade: string;
+}
+export interface QualityConfig {
+    weights?: Partial<Record<"tests" | "typecheck" | "lint" | "verify" | "diff" | "custom", number>>;
+}
+export interface RefineResult {
+    keep: boolean;
+    reason: string;
+}
+export interface MergeResult {
+    branch: string;
+    status: string;
+    error?: string;
+    commits?: number;
+}
+export interface WorktreeInfo {
+    name: string;
+    path: string;
+    branch: string;
+    head?: string;
+}
+export interface TraceEvent {
+    ts: string;
+    event: string;
+    [key: string]: unknown;
+}
+export interface CostEstimate {
+    inputTokens: number;
+    outputTokens: number;
+    totalCost: number;
+    model: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/core/types.d.ts.map

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

package/dist/core/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../core/types.ts"],"names":[],"mappings":""}

package/dist/core/validate.d.ts

@@ -0,0 +1,7 @@
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+}
+export declare function validateState(obj: unknown): ValidationResult;
+export declare function validateLoopConfig(obj: unknown): ValidationResult;
+//# sourceMappingURL=validate.d.ts.map

package/dist/core/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../../core/validate.ts"],"names":[],"mappings":"AAqBA,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAsB5D;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,OAAO,GAAG,gBAAgB,CAUjE"}

package/dist/core/validate.js

@@ -0,0 +1,55 @@
+// core/validate.ts — Zero-dep runtime schema validation
+const STATE_REQUIRED = {
+    active: "boolean",
+    prompt: "string",
+    maxIterations: "number",
+    currentIteration: "number",
+};
+const STATE_OPTIONAL = {
+    completionPromise: "string",
+    sessionId: "string",
+    name: "string",
+    verifyScript: "string",
+    startedAt: "string",
+    cost: "object",
+    qualityThreshold: "number",
+    maxRefineAttempts: "number",
+    qualityConfig: "object",
+};
+export function validateState(obj) {
+    const errors = [];
+    if (typeof obj !== "object" || obj === null) {
+        return { valid: false, errors: ["State must be an object"] };
+    }
+    const record = obj;
+    for (const [key, type] of Object.entries(STATE_REQUIRED)) {
+        if (!(key in record))
+            errors.push(`Missing required field: ${key}`);
+        else if (typeof record[key] !== type)
+            errors.push(`${key} must be ${type}, got ${typeof record[key]}`);
+    }
+    for (const [key, type] of Object.entries(STATE_OPTIONAL)) {
+        if (key in record && record[key] !== undefined && record[key] !== null && typeof record[key] !== type) {
+            errors.push(`${key} must be ${type}, got ${typeof record[key]}`);
+        }
+    }
+    if (typeof record.maxIterations === "number" && record.maxIterations < 0) {
+        errors.push("maxIterations must be >= 0");
+    }
+    if (typeof record.currentIteration === "number" && record.currentIteration < 0) {
+        errors.push("currentIteration must be >= 0");
+    }
+    return { valid: errors.length === 0, errors };
+}
+export function validateLoopConfig(obj) {
+    const errors = [];
+    if (typeof obj !== "object" || obj === null) {
+        return { valid: false, errors: ["Config must be an object"] };
+    }
+    const record = obj;
+    if (record.protocol_version && record.protocol_version !== "1.0") {
+        errors.push(`Unsupported protocol version: ${record.protocol_version}`);
+    }
+    return { valid: errors.length === 0, errors };
+}
+//# sourceMappingURL=validate.js.map

package/dist/core/validate.js.map

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

package/dist/core/worktree.d.ts

@@ -0,0 +1,13 @@
+import type { WorktreeInfo } from "./types.js";
+export declare function getRepoRoot(): Promise<string | null>;
+export declare function createWorktree(name: string, baseBranch?: string): Promise<{
+    name: string;
+    path: string;
+    branch: string;
+}>;
+export declare function removeWorktree(name: string): Promise<{
+    name: string;
+    removed: boolean;
+}>;
+export declare function listWorktrees(): Promise<WorktreeInfo[]>;
+//# sourceMappingURL=worktree.d.ts.map

package/dist/core/worktree.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worktree.d.ts","sourceRoot":"","sources":["../../core/worktree.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAQ/C,wBAAsB,WAAW,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAO1D;AASD,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,GAAE,MAAe,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC,CAiBvI;AAED,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,OAAO,CAAA;CAAE,CAAC,CAmB9F;AAED,wBAAsB,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC,CAmC7D"}