@exla/rudder 0.0.0-stage → 3.4.0

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,157 @@
+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;
+    /** True when the run hit an integration conflict at ANY point, even one a
+     * resolver already fixed by collect time (see collect.ts runHadMergeConflict). */
+    hadMergeConflict?: boolean;
+    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[]>;
+/**
+ * Values are epoch millis going forward; string entries (ISO or millis
+ * strings) are legacy formats from before the watermark was normalized, read
+ * through collect.ts watermarkValueMs.
+ */
+export type Watermark = {
+    version: 1;
+    projects: Record<string, string | number>;
+};
+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,264 @@
+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 = {
+    // The loop may prepare a complete, reviewed branch by default, but publishing
+    // a globally installed CLI is an explicit trust decision. Users who want the
+    // old unattended behavior can opt in with `improve.autonomy: "ship"`.
+    autonomy: "propose",
+    budgetUsd: 5,
+    maxFindings: 3,
+    allowedRemote: "exla-ai/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/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,88 @@
+#!/usr/bin/env node
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+const recovery = recoverCwdIfNeeded();
+try {
+    const { main } = await import("./main.js");
+    if (recovery.recovered) {
+        console.error(formatCwdRecoveryNotice(recovery));
+    }
+    await main();
+}
+catch (error) {
+    if (isMissingToolError(error)) {
+        console.error(error.message);
+        process.exit(1);
+    }
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`rudder: ${message}`);
+    process.exit(1);
+}
+function recoverCwdIfNeeded() {
+    try {
+        return { recovered: false, current: process.cwd() };
+    }
+    catch (error) {
+        const original = process.env.PWD?.trim() || undefined;
+        process.env.RUDDER_ORIGINAL_CWD = original ?? "";
+        process.env.RUDDER_CWD_RECOVERY_ERROR = error instanceof Error ? error.message : String(error);
+        for (const candidate of cwdRecoveryCandidates(original)) {
+            try {
+                if (!isReadableDirectory(candidate)) {
+                    continue;
+                }
+                process.chdir(candidate);
+                const current = process.cwd();
+                process.env.RUDDER_RECOVERED_CWD = current;
+                return { recovered: true, original, current, error };
+            }
+            catch {
+                // Try the next fallback candidate.
+            }
+        }
+        console.error([
+            "rudder: current directory is not readable, and Rudder could not recover.",
+            original ? `  original cwd: ${original}` : undefined,
+            "  Try `cd ~` or another readable directory, then run `rudder --cwd <repo>`.",
+        ]
+            .filter(Boolean)
+            .join("\n"));
+        process.exit(1);
+    }
+}
+function cwdRecoveryCandidates(original) {
+    const candidates = [];
+    if (original) {
+        candidates.push(original);
+        let next = path.dirname(original);
+        while (next && next !== path.dirname(next)) {
+            candidates.push(next);
+            next = path.dirname(next);
+        }
+    }
+    candidates.push(os.homedir(), "/tmp", "/");
+    return [...new Set(candidates.filter(Boolean))];
+}
+function isReadableDirectory(candidate) {
+    try {
+        const stat = fs.statSync(candidate);
+        if (!stat.isDirectory()) {
+            return false;
+        }
+        fs.accessSync(candidate, fs.constants.R_OK | fs.constants.X_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function formatCwdRecoveryNotice(recovery) {
+    const original = recovery.original ? ` from ${recovery.original}` : "";
+    const current = recovery.current ?? process.cwd();
+    return `rudder: recovered from an unreadable cwd${original}; using ${current}`;
+}
+function isMissingToolError(error) {
+    return error instanceof Error && error.name === "MissingToolError";
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/jj-binary.d.ts

@@ -0,0 +1,36 @@
+export declare const MANAGED_JJ_VERSION = "0.40.0";
+export declare const MANAGED_JJ_ASSETS: Record<string, {
+    target: string;
+    sha256: string;
+}>;
+export type JjSource = "system" | "managed";
+/** Why the last automatic install failed, for the "jj is missing" error. */
+export declare function managedJjInstallError(): string | null;
+export declare function managedJjDir(version?: string): string;
+export declare function managedJjPath(version?: string): string;
+export declare function managedJjAsset(platform?: NodeJS.Platform, arch?: NodeJS.Architecture): {
+    url: string;
+    sha256: string;
+} | null;
+/** True when the managed jj's directory is already on this process's PATH. */
+export declare function managedJjOnPath(): boolean;
+/**
+ * Make `jj` resolve for this process and its children. Returns where it comes
+ * from, or null when there is none and it could not be installed. Never throws:
+ * commands that need jj fail later with MissingToolError, which carries the
+ * reason recorded here.
+ */
+export declare function ensureJjAvailable(options?: {
+    onInstall?: (message: string) => void;
+}): Promise<JjSource | null>;
+/**
+ * Download a jj release archive, check it against the pinned sha256, unpack the
+ * `jj` binary, make sure it runs, then move it into place. Nothing is left at
+ * `dest` unless every step passed.
+ */
+export declare function installManagedJj(params: {
+    url: string;
+    sha256: string;
+    dest: string;
+    timeoutMs?: number;
+}): Promise<void>;