jfl 0.9.9 → 0.9.10

package/dist/lib/agent-guards.js

@@ -0,0 +1,229 @@
+/**
+ * Agent Guards
+ *
+ * Pre-flight checks that run before an agent session starts.
+ * Implements the TOCTOU guard pattern used elsewhere (hub-health.ts, planning-loop.ts)
+ * but scoped to the agent runner lifecycle.
+ *
+ * Guards are composable: each returns a GuardResult, and runGuards() aggregates them.
+ * Non-critical guards warn but don't block; critical guards abort the session.
+ *
+ * @purpose Pre-flight guard checks for scoped agent runner sessions
+ * @invariant HubRequiredForScheduling (SystemSpec.tla)
+ */
+import { existsSync, readFileSync, readdirSync } from "fs";
+import { join } from "path";
+import { spawnSync } from "child_process";
+// ============================================================================
+// Individual Guards
+// ============================================================================
+/**
+ * Guard: Hub must be reachable before starting an agent session.
+ * Critical: false — agents can run without hub, but results won't be tracked.
+ *
+ * Re-implements the TOCTOU pattern from hub-health.ts for the agent runner path.
+ */
+export async function guardHub(projectRoot) {
+    try {
+        const { checkHubHealth } = await import("./hub-health.js");
+        const status = await checkHubHealth(projectRoot);
+        if (status.available) {
+            return {
+                name: "hub",
+                passed: true,
+                critical: false,
+            };
+        }
+        return {
+            name: "hub",
+            passed: false,
+            critical: false,
+            reason: `Hub unavailable (${status.error}). Agent will run but results won't be tracked.`,
+        };
+    }
+    catch {
+        return {
+            name: "hub",
+            passed: false,
+            critical: false,
+            reason: "Hub health check unavailable. Agent will run but results won't be tracked.",
+        };
+    }
+}
+/**
+ * Guard: No concurrent session for the same agent.
+ * Critical: true — running two sessions on the same agent causes git conflicts.
+ */
+export function guardNoConcurrentSession(projectRoot, agentName) {
+    const sessionsDir = join(projectRoot, ".jfl", "sessions");
+    if (!existsSync(sessionsDir)) {
+        return { name: "concurrent_session", passed: true, critical: true };
+    }
+    let entries;
+    try {
+        entries = readdirSync(sessionsDir);
+    }
+    catch {
+        return { name: "concurrent_session", passed: true, critical: true };
+    }
+    for (const entry of entries) {
+        // Only check sessions for this specific agent
+        if (!entry.startsWith(`${agentName}-`))
+            continue;
+        const statePath = join(sessionsDir, entry, "state.json");
+        if (!existsSync(statePath))
+            continue;
+        try {
+            const state = JSON.parse(readFileSync(statePath, "utf-8"));
+            if (state.status === "active") {
+                // Check if the worktree still exists (session might be stale)
+                if (state.worktreePath && existsSync(state.worktreePath)) {
+                    return {
+                        name: "concurrent_session",
+                        passed: false,
+                        critical: true,
+                        reason: `Agent "${agentName}" has an active session: ${entry}. ` +
+                            `Worktree: ${state.worktreePath}. ` +
+                            `If this is stale, remove it: rm -rf ${state.worktreePath} && rm -rf ${join(sessionsDir, entry)}`,
+                    };
+                }
+                // Worktree doesn't exist — session is stale, mark it as completed
+                // (don't block — just note it)
+            }
+        }
+        catch {
+            // Corrupted state file — skip
+        }
+    }
+    return { name: "concurrent_session", passed: true, critical: true };
+}
+/**
+ * Guard: Eval script and data files must exist.
+ * Critical: true — agent can't measure improvement without eval.
+ */
+export function guardEvalReady(projectRoot, config) {
+    const errors = [];
+    const evalScriptPath = join(projectRoot, config.eval.script);
+    if (!existsSync(evalScriptPath)) {
+        errors.push(`Eval script not found: ${config.eval.script}`);
+    }
+    const evalDataPath = join(projectRoot, config.eval.data);
+    if (!existsSync(evalDataPath)) {
+        errors.push(`Eval data not found: ${config.eval.data}`);
+    }
+    if (errors.length > 0) {
+        return {
+            name: "eval_ready",
+            passed: false,
+            critical: true,
+            reason: errors.join("; "),
+        };
+    }
+    return { name: "eval_ready", passed: true, critical: true };
+}
+/**
+ * Guard: No stale worktree for this agent.
+ * Critical: true — stale worktrees cause git worktree add to fail.
+ */
+export function guardWorktreeClean(projectRoot, agentName) {
+    // Check for stale /tmp worktrees matching this agent
+    const result = spawnSync("git", ["worktree", "list", "--porcelain"], {
+        cwd: projectRoot,
+        encoding: "utf-8",
+        stdio: "pipe",
+    });
+    if (result.status !== 0) {
+        // Can't check worktrees — don't block
+        return { name: "worktree_clean", passed: true, critical: true };
+    }
+    const lines = (result.stdout || "").split("\n");
+    const staleWorktrees = [];
+    for (const line of lines) {
+        if (line.startsWith("worktree ")) {
+            const worktreePath = line.replace("worktree ", "").trim();
+            // Match agent worktrees in /tmp
+            if (worktreePath.includes(`jfl-agent-${agentName}-`)) {
+                // Check if the directory actually exists
+                if (!existsSync(worktreePath)) {
+                    staleWorktrees.push(worktreePath);
+                }
+            }
+        }
+    }
+    if (staleWorktrees.length > 0) {
+        // Auto-prune stale worktrees — they're just git bookkeeping for deleted /tmp dirs
+        spawnSync("git", ["worktree", "prune"], {
+            cwd: projectRoot,
+            stdio: "pipe",
+        });
+        // Re-check after pruning
+        const recheck = spawnSync("git", ["worktree", "list", "--porcelain"], {
+            cwd: projectRoot,
+            encoding: "utf-8",
+            stdio: "pipe",
+        });
+        const recheckLines = (recheck.stdout || "").split("\n");
+        const remaining = recheckLines.filter((l) => l.startsWith("worktree ") && l.includes(`jfl-agent-${agentName}-`));
+        if (remaining.length > 0) {
+            const paths = remaining.map((l) => l.replace("worktree ", "").trim());
+            return {
+                name: "worktree_clean",
+                passed: false,
+                critical: true,
+                reason: `Stale worktrees found for agent "${agentName}": ${paths.join(", ")}. ` +
+                    `Clean up with: git worktree remove <path> --force`,
+            };
+        }
+    }
+    return { name: "worktree_clean", passed: true, critical: true };
+}
+/**
+ * Guard: Git repo must be in a clean state for the base branch.
+ * Critical: false — uncommitted changes are stashed by agent-session.
+ */
+export function guardGitClean(projectRoot) {
+    const result = spawnSync("git", ["status", "--porcelain"], {
+        cwd: projectRoot,
+        encoding: "utf-8",
+        stdio: "pipe",
+    });
+    const output = (result.stdout || "").trim();
+    if (output) {
+        return {
+            name: "git_clean",
+            passed: false,
+            critical: false,
+            reason: `Uncommitted changes in working directory (${output.split("\n").length} files). ` +
+                `These may conflict with agent worktree creation.`,
+        };
+    }
+    return { name: "git_clean", passed: true, critical: false };
+}
+// ============================================================================
+// Guard Runner
+// ============================================================================
+/**
+ * Run all guards for an agent session.
+ * Returns a summary with proceed/blockers/warnings.
+ */
+export async function runGuards(projectRoot, agentName, config) {
+    const results = [];
+    // Run all guards (async hub guard + sync guards)
+    const [hubResult] = await Promise.all([
+        guardHub(projectRoot),
+    ]);
+    results.push(hubResult);
+    results.push(guardNoConcurrentSession(projectRoot, agentName));
+    results.push(guardEvalReady(projectRoot, config));
+    results.push(guardWorktreeClean(projectRoot, agentName));
+    results.push(guardGitClean(projectRoot));
+    const blockers = results.filter((r) => !r.passed && r.critical);
+    const warnings = results.filter((r) => !r.passed && !r.critical);
+    return {
+        proceed: blockers.length === 0,
+        results,
+        blockers,
+        warnings,
+    };
+}
+//# sourceMappingURL=agent-guards.js.map

package/dist/lib/agent-guards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-guards.js","sourceRoot":"","sources":["../../src/lib/agent-guards.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,IAAI,CAAA;AAC1D,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAC3B,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AA6BzC,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,WAAmB;IAChD,IAAI,CAAC;QACH,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAA;QAC1D,MAAM,MAAM,GAAG,MAAM,cAAc,CAAC,WAAW,CAAC,CAAA;QAEhD,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACrB,OAAO;gBACL,IAAI,EAAE,KAAK;gBACX,MAAM,EAAE,IAAI;gBACZ,QAAQ,EAAE,KAAK;aAChB,CAAA;QACH,CAAC;QAED,OAAO;YACL,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,oBAAoB,MAAM,CAAC,KAAK,iDAAiD;SAC1F,CAAA;IACH,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,IAAI,EAAE,KAAK;YACX,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,4EAA4E;SACrF,CAAA;IACH,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,wBAAwB,CACtC,WAAmB,EACnB,SAAiB;IAEjB,MAAM,WAAW,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,EAAE,UAAU,CAAC,CAAA;IACzD,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;QAC7B,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IACrE,CAAC;IAED,IAAI,OAAiB,CAAA;IACrB,IAAI,CAAC;QACH,OAAO,GAAG,WAAW,CAAC,WAAW,CAAC,CAAA;IACpC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IACrE,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,8CAA8C;QAC9C,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,SAAS,GAAG,CAAC;YAAE,SAAQ;QAEhD,MAAM,SAAS,GAAG,IAAI,CAAC,WAAW,EAAE,KAAK,EAAE,YAAY,CAAC,CAAA;QACxD,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,SAAQ;QAEpC,IAAI,CAAC;YACH,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAA;YAC1D,IAAI,KAAK,CAAC,MAAM,KAAK,QAAQ,EAAE,CAAC;gBAC9B,8DAA8D;gBAC9D,IAAI,KAAK,CAAC,YAAY,IAAI,UAAU,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,CAAC;oBACzD,OAAO;wBACL,IAAI,EAAE,oBAAoB;wBAC1B,MAAM,EAAE,KAAK;wBACb,QAAQ,EAAE,IAAI;wBACd,MAAM,EAAE,UAAU,SAAS,4BAA4B,KAAK,IAAI;4BACxD,aAAa,KAAK,CAAC,YAAY,IAAI;4BACnC,uCAAuC,KAAK,CAAC,YAAY,cAAc,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,EAAE;qBAC1G,CAAA;gBACH,CAAC;gBACD,kEAAkE;gBAClE,+BAA+B;YACjC,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,8BAA8B;QAChC,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,oBAAoB,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;AACrE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc,CAC5B,WAAmB,EACnB,MAAmB;IAEnB,MAAM,MAAM,GAAa,EAAE,CAAA;IAE3B,MAAM,cAAc,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAA;IAC5D,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,EAAE,CAAC;QAChC,MAAM,CAAC,IAAI,CAAC,0BAA0B,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,CAAA;IAC7D,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;IACxD,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,wBAAwB,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAA;IACzD,CAAC;IAED,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,OAAO;YACL,IAAI,EAAE,YAAY;YAClB,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;SAC1B,CAAA;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;AAC7D,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAChC,WAAmB,EACnB,SAAiB;IAEjB,qDAAqD;IACrD,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE;QACnE,GAAG,EAAE,WAAW;QAChB,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,MAAM;KACd,CAAC,CAAA;IAEF,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,sCAAsC;QACtC,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IACjE,CAAC;IAED,MAAM,KAAK,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;IAC/C,MAAM,cAAc,GAAa,EAAE,CAAA;IAEnC,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,CAAC;YACjC,MAAM,YAAY,GAAG,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;YACzD,gCAAgC;YAChC,IAAI,YAAY,CAAC,QAAQ,CAAC,aAAa,SAAS,GAAG,CAAC,EAAE,CAAC;gBACrD,yCAAyC;gBACzC,IAAI,CAAC,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;oBAC9B,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAA;gBACnC,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,kFAAkF;QAClF,SAAS,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE;YACtC,GAAG,EAAE,WAAW;YAChB,KAAK,EAAE,MAAM;SACd,CAAC,CAAA;QAEF,yBAAyB;QACzB,MAAM,OAAO,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,UAAU,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE;YACpE,GAAG,EAAE,WAAW;YAChB,QAAQ,EAAE,OAAO;YACjB,KAAK,EAAE,MAAM;SACd,CAAC,CAAA;QAEF,MAAM,YAAY,GAAG,CAAC,OAAO,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;QACvD,MAAM,SAAS,GAAG,YAAY,CAAC,MAAM,CACnC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,aAAa,SAAS,GAAG,CAAC,CAC1E,CAAA;QAED,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAA;YACrE,OAAO;gBACL,IAAI,EAAE,gBAAgB;gBACtB,MAAM,EAAE,KAAK;gBACb,QAAQ,EAAE,IAAI;gBACd,MAAM,EAAE,oCAAoC,SAAS,MAAM,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;oBACvE,mDAAmD;aAC5D,CAAA;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;AACjE,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,WAAmB;IAC/C,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC,QAAQ,EAAE,aAAa,CAAC,EAAE;QACzD,GAAG,EAAE,WAAW;QAChB,QAAQ,EAAE,OAAO;QACjB,KAAK,EAAE,MAAM;KACd,CAAC,CAAA;IAEF,MAAM,MAAM,GAAG,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAA;IAC3C,IAAI,MAAM,EAAE,CAAC;QACX,OAAO;YACL,IAAI,EAAE,WAAW;YACjB,MAAM,EAAE,KAAK;YACb,QAAQ,EAAE,KAAK;YACf,MAAM,EAAE,6CAA6C,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,WAAW;gBACjF,kDAAkD;SAC3D,CAAA;IACH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAA;AAC7D,CAAC;AAED,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAC7B,WAAmB,EACnB,SAAiB,EACjB,MAAmB;IAEnB,MAAM,OAAO,GAAkB,EAAE,CAAA;IAEjC,iDAAiD;IACjD,MAAM,CAAC,SAAS,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;QACpC,QAAQ,CAAC,WAAW,CAAC;KACtB,CAAC,CAAA;IACF,OAAO,CAAC,IAAI,CAAC,SAAS,CAAC,CAAA;IAEvB,OAAO,CAAC,IAAI,CAAC,wBAAwB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAA;IAC9D,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,CAAA;IACjD,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC,CAAA;IACxD,OAAO,CAAC,IAAI,CAAC,aAAa,CAAC,WAAW,CAAC,CAAC,CAAA;IAExC,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAA;IAC/D,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,MAAM,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAA;IAEhE,OAAO;QACL,OAAO,EAAE,QAAQ,CAAC,MAAM,KAAK,CAAC;QAC9B,OAAO;QACP,QAAQ;QACR,QAAQ;KACT,CAAA;AACH,CAAC"}

package/dist/lib/agent-session.d.ts.map

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

package/dist/lib/agent-session.js

@@ -285,6 +285,19 @@ export function startSession(config, projectRoot, baseBranch = "main") {
     const repoRoot = config.target_repo
         ? join(projectRoot, config.target_repo)
         : projectRoot;
+    // Clean up stale worktree at this path (from crashed/killed sessions)
+    // Without this, git worktree add fails and falls back to main — breaking auto-PR
+    if (existsSync(worktreePath)) {
+        console.log(`  Cleaning stale worktree: ${worktreePath}`);
+        gitExec(["worktree", "remove", worktreePath, "--force"], repoRoot);
+    }
+    gitExec(["worktree", "prune"], repoRoot);
+    // Delete stale session branch if it exists (from a previous crashed session with same hash)
+    const branchCheck = gitExec(["rev-parse", "--verify", branch], repoRoot);
+    if (branchCheck.ok) {
+        console.log(`  Deleting stale branch: ${branch}`);
+        gitExec(["branch", "-D", branch], repoRoot);
+    }
     // Fetch latest base branch
     gitExec(["fetch", "origin", baseBranch], repoRoot);
     // Create worktree with new branch from origin/baseBranch (in the target repo, not GTM)
@@ -403,6 +416,59 @@ export async function runRound(session, round, task, hypothesis, previousTransit
         .trim()
         .split("\n")
         .filter(Boolean);
+    // ── Guard check: must pass before eval (T1.2) ──
+    // e.g. "cd ${AGENT_WORKTREE} && npx tsc --noEmit" catches type errors
+    const guardCmd = session.config.eval.guard;
+    if (guardCmd) {
+        const expandedGuard = guardCmd.replace(/\$\{AGENT_WORKTREE\}/g, session.worktreePath);
+        console.log(`  Running guard: ${expandedGuard.slice(0, 80)}...`);
+        const guardResult = spawnSync("bash", ["-c", expandedGuard], {
+            cwd: session.worktreePath,
+            encoding: "utf-8",
+            stdio: "pipe",
+            timeout: 60000, // 60s max for guard
+        });
+        if (guardResult.status !== 0) {
+            console.log(`  ✗ Guard FAILED — reverting changes`);
+            const guardError = (guardResult.stderr || guardResult.stdout || "").trim().split("\n").slice(-5).join("\n");
+            if (guardError)
+                console.log(`    ${guardError.split("\n").join("\n    ")}`);
+            // Revert: discard all changes in worktree
+            gitExec(["checkout", "--", "."], session.worktreePath);
+            gitExec(["clean", "-fd"], session.worktreePath);
+            const guardFailResult = {
+                round,
+                task,
+                hypothesis,
+                metricBefore: session.baselineMetric,
+                metricAfter: session.baselineMetric,
+                delta: 0,
+                kept: false,
+                duration_ms: Date.now() - startTime,
+                error: `Guard failed: ${guardError.slice(0, 200)}`,
+            };
+            const guardFailTransition = {
+                agent: session.agentName,
+                session_id: session.id,
+                state_hash: stateHash,
+                state: stateBefore,
+                action_diff: diff,
+                action: {
+                    type: "experiment",
+                    description: task,
+                    files_affected: changedFiles,
+                    scope: changedFiles.length <= 1 ? "small" : changedFiles.length <= 3 ? "medium" : "large",
+                    branch: session.branch,
+                },
+                hypothesis,
+                reward: -0.001, // Small negative signal — guard failures are worse than no-ops
+                timestamp: new Date().toISOString(),
+            };
+            logResult(session, guardFailResult);
+            return { result: guardFailResult, transition: guardFailTransition };
+        }
+        console.log(`  ✓ Guard passed`);
+    }
     // Commit changes in worktree with provenance signing
     signedAgentCommit(session.worktreePath, `agent(${session.agentName}): round ${round} - ${task.slice(0, 50)}`, {
         agentId: session.agentName,
@@ -462,34 +528,144 @@ export async function runRound(session, round, task, hypothesis, previousTransit
 }
 async function runClaudeCode(session, task) {
     const timeout = session.config.time_budget_seconds * 1000;
-    // Build enhanced task with experiment history reference
-    // This is the Karpathy pattern: agent sees program.md (EXPERIMENTS.md) with history
+    // Write all context to files — Karpathy pattern
+    // EXPERIMENTS.md has: eval diagnostics, code context, experiment history
+    // AGENT.md has: task, constraints, scope files
+    // CLAUDE.md has: minimal "read files, edit code, stop" instructions
+    writeAgentMd(session, task);
+    writeAgentClaudeMd(session);
+    // Task prompt is deliberately tiny — all context is in files.
+    // Long prompts waste tokens and slow down time-to-first-edit.
+    const tinyTask = `Read EXPERIMENTS.md then AGENT.md. Make ONE edit to improve ${session.config.metric}. Stop after editing.`;
+    return new Promise((resolve) => {
+        spawnAgentRuntime(tinyTask, session.worktreePath, timeout, resolve);
+    });
+}
+/**
+ * Write AGENT.md to the worktree — focused instructions for RL agents.
+ * Contains: task, scope, eval diagnostics, code context, constraints.
+ * This is what the agent reads instead of CLAUDE.md.
+ */
+function writeAgentMd(session, task) {
     const scopeFiles = (() => { const raw = session.config.constraints?.scope_files || session.config.constraints.files_in_scope || []; return Array.isArray(raw) ? raw : [String(raw)]; })();
-    const scopeFilesStr = scopeFiles.slice(0, 5).join(", ");
-    const enhancedTask = `You are an autonomous code improvement agent. Your job is to EDIT SOURCE CODE FILES to improve a metric.
+    const agentMd = `# Agent: ${session.agentName}
 
-TASK: ${task}
+## Task
+${task}
 
-INSTRUCTIONS:
-1. Read EXPERIMENTS.md — it has eval diagnostics showing WHAT IS FAILING and the actual source code
-2. Based on the failing queries/tests, identify ONE targeted fix in the source code
-3. EDIT the source file directly (e.g. ${scopeFiles[0] || "the scope files"}) — use the read and edit tools
-4. Do NOT just write documentation or update EXPERIMENTS.md — you must modify actual .ts source files
-5. Make ONE small, focused change to improve the metric
-6. Do NOT add new files. Do NOT modify files outside the scope: ${scopeFilesStr}
-7. After making the change, stop. The eval will run automatically.
+## Constraints
+- **Modify ONLY these files:** ${scopeFiles.join(", ")}
+- **Do NOT modify:** AGENT.md, EXPERIMENTS.md, eval scripts, node_modules, dist
+- **Max file changes:** ${session.config.constraints.max_file_changes || 2}
+- **Time budget:** ${session.config.time_budget_seconds}s
 
-CRITICAL: Your change must be to SOURCE CODE (.ts files), not markdown files. If you only modify EXPERIMENTS.md, the eval score will not change and your work will be reverted.`;
-    // RL agents use Claude CLI directly — not Pi
-    // Pi loads CLAUDE.md + full session init which overrides the agent's focused task
-    // Claude CLI with --dangerously-skip-permissions just executes the task
-    // Pi is for Layer 2 (interactive sessions). RL agents are Layer 3 (autonomous).
-    return new Promise((resolve) => {
-        spawnClaudeCli(enhancedTask, session.worktreePath, timeout, resolve);
-    });
+## How to Succeed
+1. Read EXPERIMENTS.md — it shows what failed and the actual source code
+2. Make ONE small, targeted change to a source file
+3. Stop after making the change — the eval runs automatically
+
+## What NOT to Do
+- Do not add new files
+- Do not modify test files or eval scripts
+- Do not just add comments or documentation
+- Do not repeat experiments listed as REJECTED in EXPERIMENTS.md
+`;
+    writeFileSync(join(session.worktreePath, "AGENT.md"), agentMd);
 }
+/**
+ * Write a minimal CLAUDE.md to the worktree for RL agents.
+ * Karpathy pattern: agent gets focused instructions, no ceremony.
+ * Claude CLI reads CLAUDE.md automatically — this replaces the full project CLAUDE.md.
+ */
+function writeAgentClaudeMd(session) {
+    const scopeFiles = (() => { const raw = session.config.constraints?.scope_files || session.config.constraints.files_in_scope || []; return Array.isArray(raw) ? raw : [String(raw)]; })();
+    const claudeMd = `# RL Agent — ${session.agentName}
+
+You are a lightweight code improvement agent. You have ONE job: improve a metric by editing source code.
+
+## Instructions
+1. Read EXPERIMENTS.md — it has eval diagnostics, code context, and experiment history
+2. Read AGENT.md — it has your specific task and constraints
+3. Make ONE small, targeted edit to a source file
+4. Stop immediately after making the change
+
+## Rules
+- Only modify: ${scopeFiles.join(", ")}
+- Do NOT modify: AGENT.md, EXPERIMENTS.md, CLAUDE.md, eval scripts, node_modules, dist
+- Do NOT add new files
+- Do NOT write documentation or comments as your primary change
+- Max file changes: ${session.config.constraints.max_file_changes || 2}
+- The eval runs automatically after you exit — do not run it yourself
+
+## Available Tools
+You have: read, edit, write, bash. That's all you need.
+Do NOT try to use any other tools (no memory search, no hub, no subway, no CRM).
+`;
+    writeFileSync(join(session.worktreePath, "CLAUDE.md"), claudeMd);
+}
+/**
+ * Spawn agent runtime — uses claude CLI for lightweight execution.
+ * Karpathy pattern: agent is just an LLM with file tools, all context in files.
+ * ~50MB per process vs ~500MB for full Pi with JFL extension.
+ * Use JFL_AGENT_USE_PI=1 to force Pi runtime (for debugging).
+ */
+function spawnAgentRuntime(task, cwd, timeout, resolve) {
+    const usePi = !!process.env.JFL_AGENT_USE_PI; // Opt-in to Pi (heavy), default is claude CLI (light)
+    if (usePi) {
+        console.log("  Spawning Pi agent (heavy — use for debugging only)...");
+        const child = spawn("pi", [
+            "--print", task,
+            "--no-session",
+            "--no-skills",
+            "--no-prompt-templates",
+            "--no-themes",
+        ], {
+            cwd,
+            stdio: "inherit",
+            env: {
+                ...process.env,
+                JFL_AGENT_MODE: "1",
+                JFL_PP_SPAWNED: "1",
+                CLAUDECODE: undefined,
+                CLAUDE_CODE: undefined,
+            },
+        });
+        const timeoutId = setTimeout(() => {
+            child.kill("SIGTERM");
+            setTimeout(() => {
+                if (!child.killed)
+                    child.kill("SIGKILL");
+            }, 5000);
+        }, timeout);
+        child.on("error", (err) => {
+            console.error(`  Pi agent error: ${err.message}`);
+            clearTimeout(timeoutId);
+            console.log("  Falling back to claude CLI...");
+            spawnClaudeCli(task, cwd, timeout, resolve);
+        });
+        child.on("exit", (code, signal) => {
+            if (code !== null) {
+                console.log(`  Pi agent exit: code=${code}`);
+            }
+            else if (signal) {
+                console.log(`  Pi agent killed: signal=${signal}`);
+            }
+            clearTimeout(timeoutId);
+            resolve();
+        });
+    }
+    else {
+        spawnClaudeCli(task, cwd, timeout, resolve);
+    }
+}
+/**
+ * Spawn claude CLI — lightweight agent runtime (~50MB).
+ * Karpathy pattern: LLM reads files, edits code, exits.
+ * CLAUDE.md in worktree provides focused instructions.
+ * EXPERIMENTS.md has all context (eval diagnostics, code, history).
+ */
 function spawnClaudeCli(task, cwd, timeout, resolve) {
-    console.log("  Spawning claude CLI...");
+    console.log("  Spawning claude CLI (lightweight, Karpathy-style)...");
     const child = spawn("claude", [
         "--dangerously-skip-permissions",
         "-p", task,
@@ -596,14 +772,62 @@ export async function endSession(session, transitions) {
         }
     }
     catch { }
-    // If we improved, push the branch (but do NOT create a PR or auto-merge)
-    // Following Karpathy's autoresearch pattern: branches grow overnight,
-    // humans (or their agents) review and merge in the morning
+    // If we improved, push the branch and create a PR for review
+    // T1.4: Auto-create PR from kept improvement
     if (improvedRounds > 0) {
         // Push the branch so it's available for review
         const push = gitExec(["push", "-u", "origin", session.branch], session.worktreePath);
         if (push.ok) {
             summary.branchUrl = `https://github.com/402goose/${session.worktreePath.split('/').pop()}/tree/${session.branch}`;
+            // Auto-create PR with improvement summary
+            const prTitle = `agent(${session.agentName}): ${session.config.metric} ${totalDelta > 0 ? "+" : ""}${totalDelta.toFixed(4)} (${improvedRounds}/${transitions.length} rounds kept)`;
+            const prBody = [
+                `## Agent Improvement: ${session.agentName}`,
+                "",
+                `**Metric:** ${session.config.metric} (${session.config.direction})`,
+                `**Baseline:** ${(session.baselineMetric - totalDelta).toFixed(4)}`,
+                `**Final:** ${session.baselineMetric.toFixed(4)}`,
+                `**Delta:** ${totalDelta > 0 ? "+" : ""}${totalDelta.toFixed(4)}`,
+                `**Rounds:** ${improvedRounds} kept / ${transitions.length} total`,
+                "",
+                "### Kept Changes",
+                ...transitions.filter(t => t.reward > 0).map(t => `- **+${t.reward.toFixed(4)}**: ${t.action.description.slice(0, 100)} (${t.action.files_affected.join(", ")})`),
+                "",
+                "### Rejected Changes",
+                `${transitions.filter(t => t.reward <= 0).length} experiments reverted (no improvement).`,
+                "",
+                `---`,
+                `Session: \`${session.id}\``,
+                `Branch: \`${session.branch}\``,
+                `Guard: ${session.config.eval.guard ? "✅ " + session.config.eval.guard.slice(0, 60) : "none"}`,
+            ].join("\n");
+            const prResult = spawnSync("gh", [
+                "pr", "create",
+                "--title", prTitle,
+                "--body", prBody,
+                "--base", session.baseBranch,
+                "--head", session.branch,
+            ], {
+                cwd: session.worktreePath,
+                encoding: "utf-8",
+                stdio: "pipe",
+                timeout: 30000,
+            });
+            if (prResult.status === 0) {
+                const prUrl = (prResult.stdout || "").trim();
+                summary.prUrl = prUrl;
+                console.log(`  PR created: ${prUrl}`);
+            }
+            else {
+                // PR creation failed — branch is still pushed for manual review
+                const err = (prResult.stderr || "").trim();
+                if (err.includes("already exists")) {
+                    console.log(`  PR already exists for ${session.branch}`);
+                }
+                else {
+                    console.log(`  PR creation failed: ${err.slice(0, 100)}`);
+                }
+            }
         }
         // Emit scope:impact events for each produces pattern
         // This triggers downstream agents that consume these patterns