claude-overnight 1.59.0 → 1.60.0

package/dist/bin/evolve-subcommands.d.ts

@@ -0,0 +1,3 @@
+export declare function runDiff(runIdA: string | undefined, runIdB: string | undefined): Promise<void>;
+export declare function runDownload(runIdArg?: string, ...rest: string[]): Promise<void>;
+export declare function runPromote(runIdArg?: string, ...rest: string[]): Promise<void>;

package/dist/bin/evolve-subcommands.js

@@ -0,0 +1,234 @@
+export async function runDiff(runIdA, runIdB) {
+    if (!runIdA || !runIdB) {
+        console.error("usage: claude-overnight-evolve diff <runIdA> <runIdB>");
+        process.exit(2);
+    }
+    const { loadRun } = await import("../prompt-evolution/persistence.js");
+    const a = loadRun(runIdA);
+    const b = loadRun(runIdB);
+    const collect = (run) => {
+        const out = new Map();
+        for (const rec of run.matrix) {
+            // Keep the latest-generation row per variantId so diff compares final state.
+            const existing = out.get(rec.variantId);
+            if (!existing || rec.generation > existing.generation) {
+                out.set(rec.variantId, { generation: rec.generation, variantId: rec.variantId, gmean: rec.gmean });
+            }
+        }
+        return out;
+    };
+    const rowsA = collect(a);
+    const rowsB = collect(b);
+    const ids = new Set([...rowsA.keys(), ...rowsB.keys()]);
+    console.log(`# Diff: ${runIdA} → ${runIdB}`);
+    console.log("");
+    console.log(`|  Variant  |  A gmean  |  B gmean  |   Δ   |  note  |`);
+    console.log(`|-----------|-----------|-----------|-------|--------|`);
+    const sorted = [...ids].sort();
+    for (const id of sorted) {
+        const ra = rowsA.get(id);
+        const rb = rowsB.get(id);
+        const ga = ra ? (ra.gmean * 100).toFixed(1) : "—";
+        const gb = rb ? (rb.gmean * 100).toFixed(1) : "—";
+        const delta = ra && rb ? ((rb.gmean - ra.gmean) * 100).toFixed(1) : "—";
+        const note = !ra ? "new in B" : !rb ? "missing in B" : ra.gmean < rb.gmean ? "↑" : ra.gmean > rb.gmean ? "↓" : "=";
+        console.log(`| ${id.padEnd(10)}| ${ga.padStart(9)} | ${gb.padStart(9)} | ${delta.padStart(5)} | ${note} |`);
+    }
+}
+export async function runDownload(runIdArg, ...rest) {
+    if (!runIdArg) {
+        console.error("usage: claude-overnight-evolve download <runId> --base-url <url> [--token <token>] [--project <id>]");
+        process.exit(2);
+    }
+    const runId = runIdArg;
+    let baseUrl;
+    let token;
+    let projectId;
+    for (let i = 0; i < rest.length; i++) {
+        if (rest[i] === "--base-url" && rest[i + 1]) {
+            baseUrl = rest[i + 1];
+            i++;
+        }
+        else if (rest[i] === "--token" && rest[i + 1]) {
+            token = rest[i + 1];
+            i++;
+        }
+        else if (rest[i] === "--project" && rest[i + 1]) {
+            projectId = rest[i + 1];
+            i++;
+        }
+    }
+    if (!baseUrl) {
+        console.error("--base-url is required (e.g. https://fornace.net or http://localhost:8787)");
+        process.exit(2);
+    }
+    const authHeaders = {};
+    if (token)
+        authHeaders.Authorization = `Bearer ${token}`;
+    const prefix = projectId
+        ? `${baseUrl.replace(/\/$/, "")}/api/projects/${projectId}/prompt-evolution/${runId}`
+        : `${baseUrl.replace(/\/$/, "")}/runs/${runId}`;
+    const metaRes = await fetch(prefix, { headers: authHeaders });
+    if (!metaRes.ok) {
+        console.error(`Failed to fetch run metadata: HTTP ${metaRes.status}`);
+        process.exit(1);
+    }
+    const metaBody = (await metaRes.json());
+    const remoteMeta = typeof metaBody.meta === "object" && metaBody.meta
+        ? metaBody.meta
+        : metaBody;
+    const { runDir } = await import("../prompt-evolution/persistence.js");
+    const { mkdirSync, writeFileSync } = await import("node:fs");
+    const { dirname, join } = await import("node:path");
+    const localDir = runDir(runId);
+    mkdirSync(localDir, { recursive: true });
+    mkdirSync(join(localDir, "prompts"), { recursive: true });
+    const meta = {
+        runId,
+        promptPath: (remoteMeta.promptPath ?? remoteMeta.prompt ?? ""),
+        target: (remoteMeta.target ?? "claude-overnight"),
+        evalModel: (remoteMeta.evalModel ?? ""),
+        mutateModel: (remoteMeta.mutateModel ?? remoteMeta.evalModel ?? ""),
+        generations: (remoteMeta.generations ?? 10),
+        populationCap: (remoteMeta.populationCap ?? remoteMeta.population ?? 8),
+        startedAt: (remoteMeta.startedAt ?? remoteMeta.queuedAt ?? new Date().toISOString()),
+        status: (remoteMeta.status ?? "done"),
+        caseNames: [],
+    };
+    writeFileSync(join(localDir, "meta.json"), JSON.stringify(meta, null, 2) + "\n");
+    const inlineReport = typeof metaBody.report === "string" ? metaBody.report : metaBody.report_md;
+    if (typeof inlineReport === "string") {
+        writeFileSync(join(localDir, "report.md"), inlineReport);
+        console.log("  ✓ report.md (inline)");
+    }
+    const listRes = await fetch(`${prefix}/files`, { headers: authHeaders });
+    let files = [];
+    if (listRes.ok) {
+        const listBody = (await listRes.json());
+        files = listBody.files ?? [];
+    }
+    else {
+        console.log(`  ⚠ File listing not available (HTTP ${listRes.status}); trying known files...`);
+        files = ["report.md", "best.md", "matrix.jsonl", "learning.jsonl"];
+    }
+    for (const file of files) {
+        const fileRes = await fetch(`${prefix}/files/${encodeURIComponent(file)}`, { headers: authHeaders });
+        if (!fileRes.ok) {
+            console.error(`  ⚠ ${file}: HTTP ${fileRes.status}`);
+            continue;
+        }
+        const data = Buffer.from(await fileRes.arrayBuffer());
+        const localPath = join(localDir, file);
+        mkdirSync(dirname(localPath), { recursive: true });
+        writeFileSync(localPath, data);
+        console.log(`  ✓ ${file}`);
+    }
+    const matrixPath = join(localDir, "matrix.jsonl");
+    const { existsSync, readFileSync } = await import("node:fs");
+    if (existsSync(matrixPath)) {
+        const variantIds = new Set();
+        for (const line of readFileSync(matrixPath, "utf-8").trim().split("\n")) {
+            if (!line)
+                continue;
+            try {
+                const row = JSON.parse(line);
+                if (row.variantId)
+                    variantIds.add(row.variantId);
+            }
+            catch { /* ignore */ }
+        }
+        for (const vid of variantIds) {
+            const safeId = vid.replace(/[^a-zA-Z0-9_-]/g, "_");
+            const promptFile = `prompts/${safeId}.md`;
+            if (existsSync(join(localDir, promptFile)))
+                continue;
+            const fileRes = await fetch(`${prefix}/files/${encodeURIComponent(promptFile)}`, { headers: authHeaders });
+            if (!fileRes.ok)
+                continue;
+            const data = Buffer.from(await fileRes.arrayBuffer());
+            mkdirSync(dirname(join(localDir, promptFile)), { recursive: true });
+            writeFileSync(join(localDir, promptFile), data);
+            console.log(`  ✓ ${promptFile} (from matrix)`);
+        }
+    }
+    console.log(`\nDownloaded to ${localDir}`);
+}
+export async function runPromote(runIdArg, ...rest) {
+    if (!runIdArg) {
+        console.error("usage: claude-overnight-evolve promote <runId> [--variant <id>] [--into <block>]");
+        process.exit(2);
+    }
+    const runId = runIdArg;
+    let variantId;
+    let intoBlock;
+    for (let i = 0; i < rest.length; i++) {
+        if (rest[i] === "--variant" && rest[i + 1]) {
+            variantId = rest[i + 1];
+            i++;
+        }
+        else if (rest[i] === "--into" && rest[i + 1]) {
+            intoBlock = rest[i + 1];
+            i++;
+        }
+    }
+    const { loadRun, runDir } = await import("../prompt-evolution/persistence.js");
+    const { PROMPTS_ROOT } = await import("../prompts/load.js");
+    const { readFileSync, writeFileSync, existsSync } = await import("node:fs");
+    const { join } = await import("node:path");
+    const run = loadRun(runId);
+    const promptPath = run.meta.promptPath;
+    let sourceVariant = variantId;
+    if (!sourceVariant) {
+        const bestMatch = run.bestMd.match(/variantId\s*\|\s*`([^`]+)`/);
+        sourceVariant = bestMatch ? bestMatch[1] : undefined;
+        if (!sourceVariant) {
+            const rows = run.matrix;
+            if (rows.length)
+                sourceVariant = [...rows].sort((a, b) => b.gmean - a.gmean)[0].variantId;
+        }
+    }
+    if (!sourceVariant) {
+        console.error("Could not determine best variant for run. Use --variant <id>.");
+        process.exit(2);
+    }
+    const safeId = sourceVariant.replace(/[^a-zA-Z0-9_-]/g, "_");
+    const variantFile = join(runDir(runId), "prompts", `${safeId}.md`);
+    if (!existsSync(variantFile)) {
+        console.error(`Variant file not found: ${variantFile}`);
+        process.exit(2);
+    }
+    const variantText = readFileSync(variantFile, "utf-8").replace(/^<!--\s*generation=[\s\S]*?-->\n\n?/, "");
+    const namedVariants = ["tight", "standard", "large", "wrap", "amend", "wave", "run", "file", "all", "postfailed", "nofiles"];
+    const targetBlock = intoBlock ?? (namedVariants.includes(sourceVariant.toLowerCase()) ? sourceVariant : undefined);
+    if (!targetBlock) {
+        console.error(`Variant "${sourceVariant}" is not a named seed variant. Use --into <block> to specify which marker block to overwrite.`);
+        process.exit(2);
+    }
+    const promptFile = join(PROMPTS_ROOT, promptPath + ".md");
+    if (!existsSync(promptFile)) {
+        console.error(`Prompt file not found: ${promptFile}`);
+        process.exit(2);
+    }
+    const newText = replaceVariantBlock(readFileSync(promptFile, "utf-8"), targetBlock, variantText);
+    writeFileSync(promptFile, newText);
+    console.log(`Promoted ${sourceVariant} → ${promptPath} (<!-- ${targetBlock.toUpperCase()} -->)`);
+    console.log(`  file: ${promptFile}`);
+}
+function replaceVariantBlock(fileText, blockName, newText) {
+    const separator = "\n<!-- @@@ -->\n";
+    const sections = fileText.split(separator);
+    const markerRegex = new RegExp(`<!--\\s*(?:[─\\-]+\\s*)?${blockName.toUpperCase()}\\s*-->`, "i");
+    let found = false;
+    const newSections = sections.map((section) => {
+        const lines = section.split("\n");
+        const markerIndex = lines.findIndex((line) => markerRegex.test(line));
+        if (markerIndex === -1)
+            return section;
+        found = true;
+        const before = lines.slice(0, markerIndex + 1);
+        return [...before, "", newText.trim(), ""].join("\n").trimEnd() + "\n";
+    });
+    if (!found)
+        throw new Error(`Variant block "${blockName.toUpperCase()}" not found in prompt file`);
+    return newSections.join(separator);
+}

package/dist/bin/evolve.js

@@ -19,6 +19,7 @@ import { evolvePrompt } from "../prompt-evolution/index.js";
 import { PLAN_CASES } from "../prompt-evolution/fixtures/plan-cases.js";
 import { harvestRealCases } from "../prompt-evolution/fixtures/harvest.js";
 import { generateCases } from "../prompt-evolution/fixtures/generate.js";
+import { runDiff, runDownload, runPromote } from "./evolve-subcommands.js";
 import { scenariosToCases, PLANNING_SCENARIOS, REVIEW_SCENARIOS, SUPERVISION_SCENARIOS, STUCK_SCENARIOS, hydrateCases, extractPrompt, } from "../prompt-evolution/adapters/mcp-browser.js";
 function help() {
     process.stdout.write(`Usage: claude-overnight-evolve [options]
@@ -57,6 +58,18 @@ Options:
   --gen-model <model>     Model used by the case generator (default: eval-model)
 
 Subcommands:
+  claude-overnight-evolve download <runId> --base-url <url> [--token <token>]
+                          [--project <id>]
+                          Pull a remote run (fornace or self-host) into the local
+                          ~/.claude-overnight/prompt-evolution/<runId>/ directory
+                          so you can audit, diff, or promote it offline. Use
+                          --project for fornace; omit for self-host.
+  claude-overnight-evolve promote <runId> [--variant <id>] [--into <block>]
+                          Write a run's winning variant back into the source
+                          prompt file's <!-- BLOCK --> marker. If --variant is
+                          omitted, uses the run's best variant. If the variant is
+                          a seed (tight/standard/large) --into defaults to its
+                          name; evo-* or default variants require --into.
   claude-overnight-evolve diff <runIdA> <runIdB>
                           Print a per-variant diff of two persisted runs
   --base-url <url>        API base URL override
@@ -208,6 +221,16 @@ function parseArgs() {
     return opts;
 }
 async function main() {
+    // Subcommand: download a remote run for local audit/promote.
+    if (process.argv[2] === "download") {
+        await runDownload(process.argv[3], ...process.argv.slice(4));
+        return;
+    }
+    // Subcommand: promote a run variant back into the source prompt file.
+    if (process.argv[2] === "promote") {
+        await runPromote(process.argv[3], ...process.argv.slice(4));
+        return;
+    }
     // Subcommand: diff two persisted runs.
     if (process.argv[2] === "diff") {
         await runDiff(process.argv[3], process.argv[4]);
@@ -357,43 +380,6 @@ async function evolveOne(opts) {
     console.log(result.bestVariant.text);
     return result;
 }
-async function runDiff(runIdA, runIdB) {
-    if (!runIdA || !runIdB) {
-        console.error("usage: claude-overnight-evolve diff <runIdA> <runIdB>");
-        process.exit(2);
-    }
-    const { loadRun } = await import("../prompt-evolution/persistence.js");
-    const a = loadRun(runIdA);
-    const b = loadRun(runIdB);
-    const collect = (run) => {
-        const out = new Map();
-        for (const rec of run.matrix) {
-            // Keep the latest-generation row per variantId so diff compares final state.
-            const existing = out.get(rec.variantId);
-            if (!existing || rec.generation > existing.generation) {
-                out.set(rec.variantId, { generation: rec.generation, variantId: rec.variantId, gmean: rec.gmean });
-            }
-        }
-        return out;
-    };
-    const rowsA = collect(a);
-    const rowsB = collect(b);
-    const ids = new Set([...rowsA.keys(), ...rowsB.keys()]);
-    console.log(`# Diff: ${runIdA} → ${runIdB}`);
-    console.log("");
-    console.log(`|  Variant  |  A gmean  |  B gmean  |   Δ   |  note  |`);
-    console.log(`|-----------|-----------|-----------|-------|--------|`);
-    const sorted = [...ids].sort();
-    for (const id of sorted) {
-        const ra = rowsA.get(id);
-        const rb = rowsB.get(id);
-        const ga = ra ? (ra.gmean * 100).toFixed(1) : "—";
-        const gb = rb ? (rb.gmean * 100).toFixed(1) : "—";
-        const delta = ra && rb ? ((rb.gmean - ra.gmean) * 100).toFixed(1) : "—";
-        const note = !ra ? "new in B" : !rb ? "missing in B" : ra.gmean < rb.gmean ? "↑" : ra.gmean > rb.gmean ? "↓" : "=";
-        console.log(`| ${id.padEnd(10)}| ${ga.padStart(9)} | ${gb.padStart(9)} | ${delta.padStart(5)} | ${note} |`);
-    }
-}
 main().catch((err) => {
     console.error(err);
     process.exit(1);

package/dist/core/_version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "1.59.0";
+export declare const VERSION = "1.60.0";

package/dist/core/_version.js

@@ -1,2 +1,2 @@
 // Auto-generated by build — do not edit manually.
-export const VERSION = "1.59.0";
+export const VERSION = "1.60.0";

package/dist/prompts/load.d.ts

@@ -1,3 +1,4 @@
+export declare const PROMPTS_ROOT: string;
 export type PromptVars = Record<string, string | number | boolean | undefined | null>;
 export interface RenderOpts {
     variant?: string;

package/dist/prompts/load.js

@@ -2,7 +2,7 @@ import { readFileSync } from "node:fs";
 import { dirname, join } from "node:path";
 import { fileURLToPath } from "node:url";
 // Resolve <pkg>/prompts whether running from dist/ (installed) or src/ (dev).
-const PROMPTS_ROOT = (() => {
+export const PROMPTS_ROOT = (() => {
     const here = dirname(fileURLToPath(import.meta.url));
     for (const depth of [2, 3, 4]) {
         const candidate = join(here, ...Array(depth).fill(".."), "prompts");

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-overnight",
-  "version": "1.59.0",
+  "version": "1.60.0",
   "description": "Overnight parallel coding agents in git worktrees, with a self-curating skill memory that improves while the run is going. Mix Claude Opus as planner, Kimi 2.6 or Cursor composer-2 as cheap fast worker, Gemini or Qwen for bulk implementation. Multi-wave autonomous loop that plans, executes, reviews, and steers itself until the objective is met. Crash-safe resume, rate-limit aware, usage cap preserves headroom for your interactive Claude Code.",
   "type": "module",
   "bin": {

package/plugins/claude-overnight/.claude-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-overnight",
-  "version": "1.59.0",
+  "version": "1.60.0",
   "description": "Claude Code skill for understanding, installing, and inspecting claude-overnight runs: overnight parallel coding agents in git worktrees with a self-curating skill memory, multi-wave steering, three-layer review, and crash-safe resume. Mix Opus planner with Kimi 2.6, Cursor composer-2, Gemini, Qwen, or any Anthropic-compatible worker.",
   "author": {
     "name": "Francesco Fornace"