@viraatdas/rudder 2.10.21 → 2.10.23

package/dist/improve/ship.js

@@ -0,0 +1,82 @@
+import { runCommand } from "../util.js";
+import { execStep, tail } from "./state.js";
+const MINUTE = 60 * 1000;
+/**
+ * Ship a judged proposal. In `ship` autonomy this follows the repo release
+ * rule end to end: rebase onto the latest origin/main, re-typecheck, `npm
+ * version patch` (commit + tag vX.Y.Z), and push commit + tag together so the
+ * tag-driven release workflow publishes to npm. Non-force push: if main moved
+ * between the rebase and the push, this fails cleanly and is recorded as a
+ * push-conflict for the next cycle. In `propose` autonomy only the branch is
+ * pushed for human review.
+ */
+export async function shipProposal(params) {
+    const { settings, proposal } = params;
+    const cwd = proposal.worktree;
+    await assertAllowedRemote(settings);
+    if (settings.autonomy === "propose") {
+        const push = await runCommand("git", ["push", "-u", "origin", proposal.branch], {
+            cwd,
+            allowFailure: true,
+        });
+        if (push.code !== 0) {
+            return { status: "push-conflict", detail: tail(push.stderr || push.stdout, 800) };
+        }
+        return { status: "branch-pushed", branch: proposal.branch };
+    }
+    // Rebase onto the freshest main so the version bump reads the latest
+    // package.json (two winners in one cycle ship sequentially through here).
+    const fetch = await runCommand("git", ["fetch", "origin", "main"], { cwd, allowFailure: true });
+    if (fetch.code !== 0) {
+        return { status: "push-conflict", detail: `fetch failed: ${tail(fetch.stderr, 400)}` };
+    }
+    const rebase = await runCommand("git", ["rebase", "origin/main"], { cwd, allowFailure: true });
+    if (rebase.code !== 0) {
+        await runCommand("git", ["rebase", "--abort"], { cwd, allowFailure: true });
+        return { status: "push-conflict", detail: `rebase onto origin/main failed: ${tail(rebase.stderr, 800)}` };
+    }
+    // Cheap re-gate after the rebase; the full suites already passed pre-judge.
+    const recheck = await execStep({
+        command: "npm",
+        args: ["run", "check"],
+        cwd,
+        timeoutMs: 10 * MINUTE,
+    });
+    if (recheck.code !== 0) {
+        return { status: "push-conflict", detail: `post-rebase typecheck failed: ${tail(recheck.output, 800)}` };
+    }
+    const version = await runCommand("npm", ["version", "patch", "-m", `improve: ${proposal.finding.title} (v%s)`], { cwd, allowFailure: true });
+    if (version.code !== 0) {
+        return { status: "push-conflict", detail: `npm version patch failed: ${tail(version.stderr || version.stdout, 800)}` };
+    }
+    const tag = version.stdout.trim().split("\n").at(-1)?.trim() ?? "";
+    if (!/^v\d+\.\d+\.\d+$/.test(tag)) {
+        return { status: "push-conflict", detail: `unexpected npm version output: ${tail(version.stdout, 200)}` };
+    }
+    const push = await runCommand("git", ["push", "origin", `HEAD:main`, `refs/tags/${tag}`], {
+        cwd,
+        allowFailure: true,
+    });
+    if (push.code !== 0) {
+        // Undo the local tag so a retry next cycle does not collide with it.
+        await runCommand("git", ["tag", "-d", tag], { cwd, allowFailure: true });
+        return { status: "push-conflict", detail: `push failed: ${tail(push.stderr || push.stdout, 800)}` };
+    }
+    return { status: "shipped", version: tag };
+}
+/**
+ * The ship stage refuses to push anywhere but the configured rudder remote.
+ * This is the guard that keeps an unattended loop from ever pushing another
+ * project.
+ */
+async function assertAllowedRemote(settings) {
+    const remote = await runCommand("git", ["remote", "get-url", "origin"], {
+        cwd: settings.repoPath,
+        allowFailure: true,
+    });
+    const url = remote.stdout.trim();
+    if (remote.code !== 0 || !url.includes(settings.allowedRemote)) {
+        throw new Error(`refusing to ship: origin (${url || "missing"}) does not match improve.allowedRemote (${settings.allowedRemote})`);
+    }
+}
+//# sourceMappingURL=ship.js.map

package/dist/improve/ship.js.map

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

package/dist/improve/state.d.ts

@@ -0,0 +1,149 @@
+import type { RudderConfig } from "../types.js";
+export declare function improveHome(): string;
+export declare function watermarkPath(): string;
+export declare function metricsPath(): string;
+export declare function ledgerPath(): string;
+export declare function reportsDir(): string;
+export declare function logsDir(): string;
+export declare function worktreesDir(): string;
+export declare function cycleLockDir(): string;
+export type ImproveAutonomy = "observe" | "propose" | "ship";
+export type ImproveSettings = {
+    enabled: boolean;
+    autonomy: ImproveAutonomy;
+    budgetUsd: number;
+    maxFindings: number;
+    /** The rudder checkout the loop improves. */
+    repoPath: string;
+    /** Remote slug guard: ship only when `origin` matches. */
+    allowedRemote: string;
+    excludeProjects: string[];
+    minerModel: string;
+    judgeModel: string;
+    /**
+     * Advisor tool model for mining/judging calls (Anthropic advisor pattern:
+     * cheap executor + high-intelligence advisor). Empty string disables.
+     */
+    advisorModel: string;
+    /** Model passed to the improvement agent CLI; empty = CLI default. */
+    workerModel: string;
+    agentTimeoutMs: number;
+};
+export declare const IMPROVE_DEFAULTS: {
+    autonomy: ImproveAutonomy;
+    budgetUsd: number;
+    maxFindings: number;
+    allowedRemote: string;
+    minerModel: string;
+    judgeModel: string;
+    advisorModel: string;
+    agentTimeoutMs: number;
+};
+export declare function resolveImproveSettings(config: RudderConfig, repoFallback: string): ImproveSettings;
+export type SessionRecord = {
+    project: string;
+    repoRoot: string;
+    runId: string;
+    task: string;
+    backend: string;
+    model?: string;
+    effort?: string;
+    status: string;
+    createdAt: string;
+    updatedAt: string;
+    durationMs?: number;
+    steerCount: number;
+    autoSteerCount: number;
+    tokensIn: number;
+    tokensOut: number;
+    verifierSatisfied?: boolean;
+    verifierMissing?: string[];
+    mergeStatus?: string;
+    errorExcerpts: string[];
+};
+export type MetricsSnapshot = {
+    ts: string;
+    cycleId: string;
+    runsSeen: number;
+    failedRate: number;
+    cancelledRate: number;
+    steerRate: number;
+    mergeConflictRate: number;
+    verifierMissRate: number;
+    medianDurationMs: number;
+    totalTokensIn: number;
+    totalTokensOut: number;
+};
+export type FindingClass = "prompt" | "orchestration" | "ux" | "perf" | "crash" | "other";
+export type Finding = {
+    id: string;
+    class: FindingClass;
+    title: string;
+    detail: string;
+    evidence: Array<{
+        project: string;
+        runId: string;
+        excerpt: string;
+    }>;
+    severity: number;
+    frequency: number;
+    suspectedSurfaces: string[];
+    score?: number;
+};
+export type LedgerStatus = "reported" | "banked" | "agent-failed" | "gated-out" | "judge-rejected" | "branch-pushed" | "push-conflict" | "shipped" | "outcome";
+export type LedgerEntry = {
+    ts: string;
+    cycleId: string;
+    findingId: string;
+    titleKey: string;
+    title: string;
+    class: string;
+    status: LedgerStatus;
+    detail?: string;
+    version?: string;
+    branch?: string;
+    targetMetric?: string;
+    metricAtShip?: number;
+    outcome?: "confirmed" | "no-effect" | "regressed";
+};
+export declare function titleKey(title: string): string;
+export declare function appendJsonl(filePath: string, value: unknown): Promise<void>;
+export declare function readJsonl<T>(filePath: string): Promise<T[]>;
+export type Watermark = {
+    version: 1;
+    projects: Record<string, string>;
+};
+export declare function loadWatermark(): Promise<Watermark>;
+export declare function saveWatermark(mark: Watermark): Promise<void>;
+export declare function acquireCycleLock(): Promise<boolean>;
+export declare function releaseCycleLock(): Promise<void>;
+export declare const AGENT_RUN_FLAT_USD = 0.75;
+export declare class SpendMeter {
+    private readonly budgetUsd;
+    private spent;
+    constructor(budgetUsd: number);
+    addModelCall(model: string, inChars: number, outChars: number): void;
+    /** Exact token accounting (used when the API reports usage.iterations). */
+    addModelTokens(model: string, inputTokens: number, outputTokens: number): void;
+    addFlat(usd: number): void;
+    spentUsd(): number;
+    remainingUsd(): number;
+    /** True when there is room for at least `usd` more estimated spend. */
+    canAfford(usd: number): boolean;
+}
+export type StepResult = {
+    code: number;
+    timedOut: boolean;
+    output: string;
+};
+export declare function execStep(params: {
+    command: string;
+    args: string[];
+    cwd: string;
+    timeoutMs: number;
+    stdin?: string;
+    env?: NodeJS.ProcessEnv;
+    logFile?: string;
+}): Promise<StepResult>;
+export declare function tail(text: string, maxChars: number): string;
+export declare function fileExists(filePath: string): Promise<boolean>;

package/dist/improve/state.js

@@ -0,0 +1,261 @@
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import { spawn } from "node:child_process";
+import { commandEnv, ensureDir, pathExists, readJson, rudderHome, writeJson } from "../util.js";
+// ---------------------------------------------------------------------------
+// The continual improvement loop's on-disk state lives under ~/.rudder/improve.
+// Everything here is append-only JSONL or atomic JSON via writeJson, matching
+// the repo persistence conventions. See docs/continual-improvement.md.
+// ---------------------------------------------------------------------------
+export function improveHome() {
+    return path.join(rudderHome(), "improve");
+}
+export function watermarkPath() {
+    return path.join(improveHome(), "watermark.json");
+}
+export function metricsPath() {
+    return path.join(improveHome(), "metrics.jsonl");
+}
+export function ledgerPath() {
+    return path.join(improveHome(), "ledger.jsonl");
+}
+export function reportsDir() {
+    return path.join(improveHome(), "reports");
+}
+export function logsDir() {
+    return path.join(improveHome(), "logs");
+}
+export function worktreesDir() {
+    return path.join(improveHome(), "worktrees");
+}
+export function cycleLockDir() {
+    return path.join(improveHome(), "cycle.lock");
+}
+export const IMPROVE_DEFAULTS = {
+    autonomy: "ship",
+    budgetUsd: 5,
+    maxFindings: 3,
+    allowedRemote: "viraatdas/rudder",
+    minerModel: "claude-sonnet-4-6",
+    judgeModel: "claude-sonnet-4-6",
+    advisorModel: "claude-fable-5",
+    agentTimeoutMs: 25 * 60 * 1000,
+};
+export function resolveImproveSettings(config, repoFallback) {
+    const raw = config.improve ?? {};
+    const envDisabled = process.env.RUDDER_IMPROVE === "0";
+    return {
+        enabled: !envDisabled && raw.enabled !== false,
+        autonomy: raw.autonomy ?? IMPROVE_DEFAULTS.autonomy,
+        budgetUsd: raw.budgetUsd ?? IMPROVE_DEFAULTS.budgetUsd,
+        maxFindings: raw.maxFindings ?? IMPROVE_DEFAULTS.maxFindings,
+        repoPath: raw.repoPath ?? repoFallback,
+        allowedRemote: raw.allowedRemote ?? IMPROVE_DEFAULTS.allowedRemote,
+        excludeProjects: raw.excludeProjects ?? [],
+        minerModel: raw.minerModel ?? IMPROVE_DEFAULTS.minerModel,
+        judgeModel: raw.judgeModel ?? IMPROVE_DEFAULTS.judgeModel,
+        advisorModel: raw.advisorModel ?? IMPROVE_DEFAULTS.advisorModel,
+        workerModel: raw.workerModel ?? "",
+        agentTimeoutMs: raw.agentTimeoutMs ?? IMPROVE_DEFAULTS.agentTimeoutMs,
+    };
+}
+export function titleKey(title) {
+    return title
+        .toLowerCase()
+        .replace(/[^a-z0-9 ]+/g, "")
+        .split(/\s+/)
+        .filter(Boolean)
+        .slice(0, 8)
+        .join("-");
+}
+// ---------------------------------------------------------------------------
+// JSONL helpers
+// ---------------------------------------------------------------------------
+export async function appendJsonl(filePath, value) {
+    await ensureDir(path.dirname(filePath));
+    await fs.appendFile(filePath, `${JSON.stringify(value)}\n`, "utf8");
+}
+export async function readJsonl(filePath) {
+    try {
+        const raw = await fs.readFile(filePath, "utf8");
+        const out = [];
+        for (const line of raw.split("\n")) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            try {
+                out.push(JSON.parse(trimmed));
+            }
+            catch {
+                // skip torn/corrupt lines; the files are append-only diagnostics
+            }
+        }
+        return out;
+    }
+    catch {
+        return [];
+    }
+}
+export async function loadWatermark() {
+    const existing = await readJson(watermarkPath());
+    if (existing?.version === 1 && existing.projects) {
+        return existing;
+    }
+    return { version: 1, projects: {} };
+}
+export async function saveWatermark(mark) {
+    await ensureDir(improveHome());
+    await writeJson(watermarkPath(), mark);
+}
+// ---------------------------------------------------------------------------
+// Single-instance cycle lock (mkdir lock, stale takeover), the same shape as
+// .rudder/integrate.lock. Not reentrant.
+// ---------------------------------------------------------------------------
+const LOCK_STALE_MS = 6 * 60 * 60 * 1000;
+export async function acquireCycleLock() {
+    await ensureDir(improveHome());
+    const lock = cycleLockDir();
+    try {
+        await fs.mkdir(lock);
+        await fs.writeFile(path.join(lock, "pid"), String(process.pid), "utf8");
+        return true;
+    }
+    catch {
+        try {
+            const stat = await fs.stat(lock);
+            if (Date.now() - stat.mtimeMs > LOCK_STALE_MS) {
+                await fs.rm(lock, { recursive: true, force: true });
+                await fs.mkdir(lock);
+                await fs.writeFile(path.join(lock, "pid"), String(process.pid), "utf8");
+                return true;
+            }
+        }
+        catch {
+            // fall through: someone else holds it
+        }
+        return false;
+    }
+}
+export async function releaseCycleLock() {
+    await fs.rm(cycleLockDir(), { recursive: true, force: true });
+}
+// ---------------------------------------------------------------------------
+// Spend meter: a coarse budget guardrail, not accounting. Model calls are
+// estimated at chars/4 tokens against a small price table; agent runs are a
+// flat estimate because the CLI's own auth (subscription) hides real cost.
+// ---------------------------------------------------------------------------
+const PRICE_PER_MTOK = [
+    { match: /haiku/i, inUsd: 1, outUsd: 5 },
+    { match: /sonnet/i, inUsd: 3, outUsd: 15 },
+    { match: /opus|fable/i, inUsd: 5, outUsd: 25 },
+];
+export const AGENT_RUN_FLAT_USD = 0.75;
+export class SpendMeter {
+    budgetUsd;
+    spent = 0;
+    constructor(budgetUsd) {
+        this.budgetUsd = budgetUsd;
+    }
+    addModelCall(model, inChars, outChars) {
+        this.addModelTokens(model, inChars / 4, outChars / 4);
+    }
+    /** Exact token accounting (used when the API reports usage.iterations). */
+    addModelTokens(model, inputTokens, outputTokens) {
+        const price = PRICE_PER_MTOK.find((p) => p.match.test(model)) ?? PRICE_PER_MTOK[1];
+        this.spent += (inputTokens / 1_000_000) * price.inUsd + (outputTokens / 1_000_000) * price.outUsd;
+    }
+    addFlat(usd) {
+        this.spent += usd;
+    }
+    spentUsd() {
+        return this.spent;
+    }
+    remainingUsd() {
+        return Math.max(0, this.budgetUsd - this.spent);
+    }
+    /** True when there is room for at least `usd` more estimated spend. */
+    canAfford(usd) {
+        return this.spent + usd <= this.budgetUsd;
+    }
+}
+export async function execStep(params) {
+    return await new Promise((resolve) => {
+        let settled = false;
+        let timedOut = false;
+        let output = "";
+        const finish = (code) => {
+            if (settled)
+                return;
+            settled = true;
+            if (params.logFile) {
+                void ensureDir(path.dirname(params.logFile)).then(() => fs.appendFile(params.logFile, `\n===== ${params.command} ${params.args.join(" ")} (exit ${code}${timedOut ? ", timed out" : ""}) =====\n${output}`, "utf8"));
+            }
+            resolve({ code, timedOut, output });
+        };
+        let child;
+        try {
+            child = spawn(params.command, params.args, {
+                cwd: params.cwd,
+                env: commandEnv(params.env),
+                stdio: [params.stdin === undefined ? "ignore" : "pipe", "pipe", "pipe"],
+            });
+        }
+        catch (error) {
+            output = String(error);
+            finish(127);
+            return;
+        }
+        const timer = setTimeout(() => {
+            timedOut = true;
+            try {
+                child.kill("SIGTERM");
+                setTimeout(() => {
+                    try {
+                        child.kill("SIGKILL");
+                    }
+                    catch {
+                        // already gone
+                    }
+                }, 5000).unref();
+            }
+            catch {
+                // already gone
+            }
+        }, params.timeoutMs);
+        child.stdout?.setEncoding("utf8");
+        child.stderr?.setEncoding("utf8");
+        child.stdout?.on("data", (chunk) => {
+            output += chunk;
+        });
+        child.stderr?.on("data", (chunk) => {
+            output += chunk;
+        });
+        child.on("error", (error) => {
+            clearTimeout(timer);
+            output += `\n${String(error)}`;
+            finish(127);
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            finish(timedOut ? 124 : (code ?? 1));
+        });
+        if (params.stdin !== undefined) {
+            try {
+                child.stdin?.write(params.stdin);
+                child.stdin?.end();
+            }
+            catch {
+                // child error handler will fire
+            }
+        }
+    });
+}
+export function tail(text, maxChars) {
+    if (text.length <= maxChars)
+        return text;
+    return `…${text.slice(text.length - maxChars)}`;
+}
+export async function fileExists(filePath) {
+    return await pathExists(filePath);
+}
+//# sourceMappingURL=state.js.map

package/dist/improve/state.js.map

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

package/dist/main.js

@@ -236,6 +236,11 @@ export async function main() {
         case "gc":
             await runGc({ dryRun: Boolean(parsed.flags.dryRun) });
             return;
+        case "improve": {
+            const { runImprove } = await import("./improve/index.js");
+            await runImprove(parsed);
+            return;
+        }
         case "board":
         case "serve": {
             await runBoard(parsed);
@@ -924,6 +929,12 @@ Run management:
   rudder gc [--dry-run]           Prune bounded diagnostics, old binaries, and stale run records
   rudder undo [opId]              Rewind jj to an op id, or the last undo-stack entry (global)
 
+Improvement loop:
+  rudder improve run [--dry-run] [--budget-usd N]   Mine telemetry, propose+judge fixes, ship a release
+  rudder improve status                             Last cycle, shipped versions, ledger tail
+  rudder improve report [date]                      Print a cycle report
+  rudder improve schedule install|uninstall|status  Nightly launchd schedule (macOS)
+
 Planner:
   rudder plan "task"             Decompose a task into a DAG, scaffold empty jj changes, write graph.json
   rudder fanout "task" [--n N]   Fan out N variant agents on one task, then a judge picks/merges the best (default N=3)