@viraatdas/rudder 2.10.22 → 2.10.24

package/README.md

@@ -16,6 +16,11 @@ isolated, reviewable, and easy to merge. It opens a native three-pane dashboard,
 gives every task its own git worktree, and runs real Claude Code or Codex
 processes in the worker pane.
 
+> **AI agents and contributors:** this README is for using Rudder. If you are
+> an AI agent (or a human) working on the Rudder codebase itself, read
+> [`AGENTS.md`](./AGENTS.md) first; it is the engineering reference and the
+> source of truth for architecture, conventions, and release rules.
+
 ## Install
 
 ```bash
@@ -351,6 +356,42 @@ rudder cleanup
   `rudder mouse-test parsed`. Set `RUDDER_WHEEL_SCROLL_ROWS=<n>` to change the
   scroll step, or `RUDDER_MOUSE_DEBUG=1` to inspect routing.
 
+## Continual improvement loop
+
+Rudder improves itself from its own telemetry. Every run already leaves a
+record on disk (`.rudder/runs/`, event logs, verifier results, steer history,
+token usage). The improvement loop, `rudder improve`, is a scheduled local
+batch job (launchd on macOS, not a resident daemon) that:
+
+1. **Collects** recent session telemetry across your registered projects,
+   redacting secrets at the source.
+2. **Mines** it into ranked friction findings (failed runs, user redirects,
+   merge conflicts, verifier misses) using the advisor pattern: a Sonnet
+   executor consults a Fable 5 advisor mid-generation, so most tokens bill at
+   the executor rate.
+3. **Proposes** fixes with headless agents in isolated worktrees of the
+   rudder repo, each briefed with a rich context pack (finding, evidence,
+   surface map, prior failed attempts, repo conventions).
+4. **Judges** each candidate with the repo's full test gates plus a
+   three-lens adversarial LLM panel that fails closed.
+5. **Ships** survivors automatically: rebase onto `origin/main`,
+   `npm version patch`, push main + tag, and the normal tag-driven CI
+   publishes the new version to npm. Later cycles verify the targeted metric
+   actually improved and flag regressions for revert.
+
+```bash
+rudder improve run --dry-run     # see what it would do, propose nothing
+rudder improve schedule install  # nightly cycle at 03:30 via launchd
+rudder improve status            # shipped versions, metrics trend, ledger
+```
+
+Everything stays on your machine, spend is hard-capped per cycle
+(`improve.budgetUsd`, default $5), autonomy is configurable
+(`improve.autonomy`: `observe` | `propose` | `ship`), and `RUDDER_IMPROVE=0`
+disables it. The full harness spec is in
+[`docs/continual-improvement.md`](./docs/continual-improvement.md);
+implementation details live in [`AGENTS.md`](./AGENTS.md) section 15.
+
 ## Building from source
 
 ```bash

package/dist/improve/advisor.d.ts

@@ -0,0 +1,10 @@
+import type { SpendMeter } from "./state.js";
+export declare function callAdvisedTextModel(params: {
+    executorModel: string;
+    advisorModel: string;
+    system: string;
+    user: string;
+    maxTokens?: number;
+    timeoutMs?: number;
+    meter?: SpendMeter;
+}): Promise<string>;

package/dist/improve/advisor.js

@@ -0,0 +1,115 @@
+import { callTextModel, resolveAnthropicApiKey } from "../task-summary.js";
+/**
+ * Advisor-pattern text call (Anthropic advisor tool, beta
+ * advisor-tool-2026-03-01): a cheaper executor model generates the output and
+ * consults a higher-intelligence advisor mid-generation for strategic
+ * guidance. Most tokens bill at the executor rate; the loop gets near
+ * advisor-grade judgment on its mining and judging calls at a fraction of the
+ * cost of running the big model end to end.
+ *
+ * Degradation path: the deterministic test hook and the no-API-key case (CLI
+ * auth) fall back to callTextModel, and any advisor-request failure falls
+ * back to a plain executor-only call, so the loop never hard-depends on the
+ * beta.
+ */
+const ADVISOR_BETA = "advisor-tool-2026-03-01";
+const ADVISOR_MAX_TOKENS = 2048;
+const MAX_PAUSE_RESUMES = 3;
+const ADVISOR_SYSTEM_NUDGE = `
+
+You have access to an \`advisor\` tool backed by a stronger reviewer model. It takes NO parameters; your full context is forwarded automatically. Consult it once before committing to your answer, weigh its guidance seriously, then produce the final output yourself in the requested format.`;
+const ADVISOR_USER_SUFFIX = "\n\n(Advisor: please keep your guidance under 200 words; a focused verdict on the hard part beats a comprehensive plan.)";
+export async function callAdvisedTextModel(params) {
+    const plainFallback = () => callTextModel({
+        model: params.executorModel,
+        system: params.system,
+        user: params.user,
+        maxTokens: params.maxTokens,
+        timeoutMs: params.timeoutMs,
+    });
+    // Deterministic test hook and disabled-advisor path go straight through.
+    if (process.env.RUDDER_FAKE_MODEL_OUTPUT || !params.advisorModel) {
+        return await plainFallback();
+    }
+    const apiKey = await resolveAnthropicApiKey();
+    if (!apiKey) {
+        // CLI-auth users have no raw key to hit the API with; use the CLI path.
+        return await plainFallback();
+    }
+    const tools = [
+        {
+            type: "advisor_20260301",
+            name: "advisor",
+            model: params.advisorModel,
+            max_tokens: ADVISOR_MAX_TOKENS,
+        },
+    ];
+    const messages = [
+        { role: "user", content: params.user + ADVISOR_USER_SUFFIX },
+    ];
+    const timeoutMs = params.timeoutMs ?? 240000;
+    const collected = [];
+    for (let attempt = 0; attempt <= MAX_PAUSE_RESUMES; attempt += 1) {
+        let data;
+        try {
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), timeoutMs);
+            const response = await fetch("https://api.anthropic.com/v1/messages", {
+                method: "POST",
+                headers: {
+                    "content-type": "application/json",
+                    "x-api-key": apiKey,
+                    "anthropic-version": "2023-06-01",
+                    "anthropic-beta": ADVISOR_BETA,
+                },
+                body: JSON.stringify({
+                    model: params.executorModel,
+                    max_tokens: params.maxTokens ?? 2048,
+                    system: params.system + ADVISOR_SYSTEM_NUDGE,
+                    tools,
+                    messages,
+                }),
+                signal: controller.signal,
+            });
+            clearTimeout(timer);
+            if (!response.ok) {
+                // Invalid pair / beta unavailable / overloaded: degrade to plain.
+                return await plainFallback();
+            }
+            data = (await response.json());
+        }
+        catch {
+            return await plainFallback();
+        }
+        meterIterations(params, data);
+        for (const block of data.content ?? []) {
+            if (block.type === "text" && typeof block.text === "string") {
+                collected.push(block.text);
+            }
+        }
+        if (data.stop_reason === "pause_turn" && attempt < MAX_PAUSE_RESUMES) {
+            // Resume the paused turn: round-trip the assistant content verbatim.
+            messages.push({ role: "assistant", content: data.content ?? [] });
+            continue;
+        }
+        break;
+    }
+    const text = collected.join("").trim();
+    return text || (await plainFallback());
+}
+function meterIterations(params, data) {
+    if (!params.meter)
+        return;
+    const iterations = data.usage?.iterations;
+    if (iterations && iterations.length > 0) {
+        for (const iteration of iterations) {
+            const model = iteration.type === "advisor_message"
+                ? (iteration.model ?? params.advisorModel)
+                : params.executorModel;
+            params.meter.addModelTokens(model, iteration.input_tokens ?? 0, iteration.output_tokens ?? 0);
+        }
+        return;
+    }
+    params.meter.addModelTokens(params.executorModel, data.usage?.input_tokens ?? 0, data.usage?.output_tokens ?? 0);
+}
+//# sourceMappingURL=advisor.js.map

package/dist/improve/advisor.js.map

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

package/dist/improve/collect.d.ts

@@ -0,0 +1,23 @@
+import type { RunRecord } from "../types.js";
+import type { ImproveSettings, MetricsSnapshot, SessionRecord, Watermark } from "./state.js";
+/**
+ * Walk registered projects and build redacted session records for every run
+ * newer than the watermark. Pure telemetry read; never writes into a project.
+ */
+export declare function collectSessions(settings: ImproveSettings, watermark: Watermark): Promise<{
+    sessions: SessionRecord[];
+    nextWatermark: Watermark;
+}>;
+/**
+ * Whether a run experienced an integration conflict at ANY point, not just one
+ * still unresolved at collect time. `status`/`merge.status` are LIVE state:
+ * once a resolver or re-merge succeeds they are rewritten to merged, which is
+ * why counting them alone reported mergeConflictRate 0 while resolver-labeled
+ * sessions were everywhere. Reads, in order of reliability: the durable
+ * `hadMergeConflict` marker, the live conflict state, `resolverFor` (the
+ * daemon's resolver runs), and finally the native resolver task labels, which
+ * are the only trace on records written before `hadMergeConflict` existed
+ * (formats set in native/src/main.rs start_conflict_resolution_agent).
+ */
+export declare function runHadMergeConflict(run: Pick<RunRecord, "status" | "merge" | "sync" | "hadMergeConflict" | "resolverFor" | "task" | "taskSummary">): boolean;
+export declare function computeMetrics(cycleId: string, sessions: SessionRecord[]): MetricsSnapshot;

package/dist/improve/collect.js

@@ -0,0 +1,228 @@
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import { loadProjects, runRecordPath, runsDir, verifierPath } from "../state.js";
+import { readJson } from "../util.js";
+import { redactTaskSummarySecrets } from "../task-summary.js";
+const MAX_SESSIONS_PER_PROJECT = 200;
+const MAX_ERROR_EXCERPTS = 3;
+const ERROR_EXCERPT_CHARS = 300;
+const EVENTS_TAIL_BYTES = 64 * 1024;
+/**
+ * Walk registered projects and build redacted session records for every run
+ * newer than the watermark. Pure telemetry read; never writes into a project.
+ */
+export async function collectSessions(settings, watermark) {
+    const projects = await loadProjects();
+    const sessions = [];
+    const nextWatermark = { version: 1, projects: { ...watermark.projects } };
+    for (const project of projects) {
+        if (!project.repoRoot)
+            continue;
+        if (settings.excludeProjects.some((pattern) => matchesGlobish(project.repoRoot, pattern))) {
+            continue;
+        }
+        let exists = false;
+        try {
+            exists = (await fs.stat(project.repoRoot)).isDirectory();
+        }
+        catch {
+            exists = false;
+        }
+        if (!exists)
+            continue;
+        const since = watermark.projects[project.repoRoot] ?? "";
+        const runs = await readRunsRaw(project.repoRoot);
+        const fresh = runs
+            .filter((run) => (run.updatedAt ?? "") > since)
+            // Skip runs still in flight; their story is not over yet.
+            .filter((run) => !["created", "running", "steering", "verifying"].includes(run.status))
+            .sort((a, b) => (a.updatedAt < b.updatedAt ? -1 : 1))
+            .slice(-MAX_SESSIONS_PER_PROJECT);
+        for (const run of fresh) {
+            sessions.push(await sessionFromRun(project.name ?? project.slug ?? project.repoRoot, run));
+        }
+        const newest = fresh.at(-1)?.updatedAt;
+        if (newest && newest > (nextWatermark.projects[project.repoRoot] ?? "")) {
+            nextWatermark.projects[project.repoRoot] = newest;
+        }
+    }
+    return { sessions, nextWatermark };
+}
+/**
+ * Read run records WITHOUT the state.ts load path: loadRunRecord fires the
+ * background LLM task summarizer per record, which both costs model calls and
+ * rewrites run.json (bumping updatedAt past the watermark). Telemetry
+ * collection must be a pure read.
+ */
+async function readRunsRaw(repoRoot) {
+    let entries = [];
+    try {
+        const dirents = await fs.readdir(runsDir(repoRoot), { withFileTypes: true });
+        entries = dirents.filter((entry) => entry.isDirectory()).map((entry) => entry.name);
+    }
+    catch {
+        return [];
+    }
+    const runs = await Promise.all(entries.map((id) => readJson(runRecordPath(repoRoot, id))));
+    return runs.filter((run) => Boolean(run?.id && run?.status && run?.updatedAt));
+}
+/**
+ * Whether a run experienced an integration conflict at ANY point, not just one
+ * still unresolved at collect time. `status`/`merge.status` are LIVE state:
+ * once a resolver or re-merge succeeds they are rewritten to merged, which is
+ * why counting them alone reported mergeConflictRate 0 while resolver-labeled
+ * sessions were everywhere. Reads, in order of reliability: the durable
+ * `hadMergeConflict` marker, the live conflict state, `resolverFor` (the
+ * daemon's resolver runs), and finally the native resolver task labels, which
+ * are the only trace on records written before `hadMergeConflict` existed
+ * (formats set in native/src/main.rs start_conflict_resolution_agent).
+ */
+export function runHadMergeConflict(run) {
+    if (run.hadMergeConflict)
+        return true;
+    if (run.status === "merge-conflict")
+        return true;
+    if (run.merge?.status === "conflict" || run.sync?.status === "conflict")
+        return true;
+    if (run.resolverFor)
+        return true;
+    if (/^(?:merge|rebase) conflicts → /.test(run.taskSummary ?? ""))
+        return true;
+    return /^Resolve (?:merge|rebase) conflicts(?::|$)/.test(run.task ?? "");
+}
+async function sessionFromRun(project, run) {
+    const steerCount = (run.turns ?? []).filter((turn) => turn.source === "steerer" || turn.source === "regoal").length;
+    const startedAt = run.process?.startedAt ?? run.createdAt;
+    const endedAt = run.process?.endedAt ?? run.updatedAt;
+    let durationMs;
+    const startMs = Date.parse(startedAt ?? "");
+    const endMs = Date.parse(endedAt ?? "");
+    if (Number.isFinite(startMs) && Number.isFinite(endMs) && endMs >= startMs) {
+        durationMs = endMs - startMs;
+    }
+    let verifierSatisfied;
+    let verifierMissing;
+    const verification = run.verification ??
+        (await readJson(verifierPath(run.repoRoot, run.id))) ??
+        undefined;
+    if (verification && typeof verification.satisfied === "boolean") {
+        verifierSatisfied = verification.satisfied;
+        verifierMissing = (verification.missing ?? []).slice(0, 5).map(redactAndTrim);
+    }
+    const hadMergeConflict = runHadMergeConflict(run);
+    const interesting = run.status === "failed" ||
+        run.status === "cancelled" ||
+        hadMergeConflict ||
+        verifierSatisfied === false;
+    return {
+        project,
+        repoRoot: run.repoRoot,
+        runId: run.id,
+        task: redactAndTrim(run.taskSummary ?? run.task ?? "", 160),
+        backend: run.backend,
+        model: run.model,
+        effort: run.effort,
+        status: run.status,
+        createdAt: run.createdAt,
+        updatedAt: run.updatedAt,
+        durationMs,
+        steerCount,
+        autoSteerCount: run.autoSteer?.count ?? 0,
+        tokensIn: run.tokens?.input ?? 0,
+        tokensOut: run.tokens?.output ?? 0,
+        verifierSatisfied,
+        verifierMissing,
+        mergeStatus: run.merge?.status,
+        hadMergeConflict,
+        errorExcerpts: interesting ? await readErrorExcerpts(run) : [],
+    };
+}
+/**
+ * Read the tail of a run's events.ndjson and pull out error-shaped events.
+ * Redaction happens here, before anything reaches a model.
+ */
+async function readErrorExcerpts(run) {
+    const eventsFile = path.join(run.repoRoot, ".rudder", "runs", run.id, "events.ndjson");
+    let raw = "";
+    try {
+        const handle = await fs.open(eventsFile, "r");
+        try {
+            const stat = await handle.stat();
+            const start = Math.max(0, stat.size - EVENTS_TAIL_BYTES);
+            const buffer = Buffer.alloc(stat.size - start);
+            await handle.read(buffer, 0, buffer.length, start);
+            raw = buffer.toString("utf8");
+        }
+        finally {
+            await handle.close();
+        }
+    }
+    catch {
+        return [];
+    }
+    const excerpts = [];
+    for (const line of raw.split("\n").reverse()) {
+        if (excerpts.length >= MAX_ERROR_EXCERPTS)
+            break;
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        let event = null;
+        try {
+            event = JSON.parse(trimmed);
+        }
+        catch {
+            continue;
+        }
+        const type = event?.type ?? "";
+        if (!/error|fail/i.test(type))
+            continue;
+        const text = event?.text ?? event?.message ?? "";
+        if (!text.trim())
+            continue;
+        excerpts.push(`[${type}] ${redactAndTrim(text, ERROR_EXCERPT_CHARS)}`);
+    }
+    return excerpts;
+}
+export function computeMetrics(cycleId, sessions) {
+    const n = sessions.length;
+    const rate = (count) => (n === 0 ? 0 : round4(count / n));
+    const failed = sessions.filter((s) => s.status === "failed").length;
+    const cancelled = sessions.filter((s) => s.status === "cancelled").length;
+    const conflicts = sessions.filter((s) => s.hadMergeConflict || s.status === "merge-conflict" || s.mergeStatus === "conflict").length;
+    const verifierMisses = sessions.filter((s) => s.verifierSatisfied === false).length;
+    const steered = sessions.filter((s) => s.steerCount > 0).length;
+    const durations = sessions
+        .map((s) => s.durationMs)
+        .filter((d) => typeof d === "number")
+        .sort((a, b) => a - b);
+    return {
+        ts: new Date().toISOString(),
+        cycleId,
+        runsSeen: n,
+        failedRate: rate(failed),
+        cancelledRate: rate(cancelled),
+        steerRate: rate(steered),
+        mergeConflictRate: rate(conflicts),
+        verifierMissRate: rate(verifierMisses),
+        medianDurationMs: durations.length ? durations[Math.floor(durations.length / 2)] : 0,
+        totalTokensIn: sessions.reduce((sum, s) => sum + s.tokensIn, 0),
+        totalTokensOut: sessions.reduce((sum, s) => sum + s.tokensOut, 0),
+    };
+}
+function redactAndTrim(value, maxChars = 240) {
+    const redacted = redactTaskSummarySecrets(value).replace(/\s+/g, " ").trim();
+    return redacted.length > maxChars ? `${redacted.slice(0, maxChars - 1)}…` : redacted;
+}
+function round4(value) {
+    return Math.round(value * 10000) / 10000;
+}
+/** Minimal glob support: `*` wildcards only, matched against the repo path. */
+function matchesGlobish(value, pattern) {
+    const regex = new RegExp(`^${pattern.split("*").map(escapeRegExp).join(".*")}$`);
+    return regex.test(value);
+}
+function escapeRegExp(value) {
+    return value.replace(/[.*+?^${}()|[\]\\]/g, "\\$&");
+}
+//# sourceMappingURL=collect.js.map

package/dist/improve/collect.js.map

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

package/dist/improve/gate.d.ts

@@ -0,0 +1,17 @@
+import type { Proposal } from "./propose.js";
+export type GateResult = {
+    passed: boolean;
+    steps: Array<{
+        name: string;
+        code: number;
+        timedOut: boolean;
+        failureTail?: string;
+    }>;
+};
+/**
+ * The repo's own deterministic gates, run inside the proposal worktree before
+ * any judge tokens are spent. Order matches AGENTS.md section 11: typecheck,
+ * native tests when native/ changed, then the node test suite (which builds).
+ */
+export declare function runGates(proposal: Proposal): Promise<GateResult>;
+export declare function gateSummary(gate: GateResult): string;

package/dist/improve/gate.js

@@ -0,0 +1,60 @@
+import path from "node:path";
+import { execStep, logsDir, tail } from "./state.js";
+const MINUTE = 60 * 1000;
+/**
+ * The repo's own deterministic gates, run inside the proposal worktree before
+ * any judge tokens are spent. Order matches AGENTS.md section 11: typecheck,
+ * native tests when native/ changed, then the node test suite (which builds).
+ */
+export async function runGates(proposal) {
+    const logFile = path.join(logsDir(), `${proposal.finding.id}-gates.log`);
+    const nativeChanged = proposal.changedFiles.some((file) => file.startsWith("native/"));
+    const steps = [
+        {
+            name: "npm ci",
+            command: "npm",
+            args: ["ci", "--no-audit", "--no-fund"],
+            timeoutMs: 15 * MINUTE,
+        },
+        { name: "npm run check", command: "npm", args: ["run", "check"], timeoutMs: 10 * MINUTE },
+        ...(nativeChanged
+            ? [
+                {
+                    name: "cargo test",
+                    command: "cargo",
+                    args: ["test", "--manifest-path", "native/Cargo.toml"],
+                    timeoutMs: 40 * MINUTE,
+                },
+            ]
+            : []),
+        { name: "npm test", command: "npm", args: ["test"], timeoutMs: 40 * MINUTE },
+    ];
+    const result = { passed: true, steps: [] };
+    for (const step of steps) {
+        const outcome = await execStep({
+            command: step.command,
+            args: step.args,
+            cwd: proposal.worktree,
+            timeoutMs: step.timeoutMs,
+            logFile,
+        });
+        const entry = {
+            name: step.name,
+            code: outcome.code,
+            timedOut: outcome.timedOut,
+            ...(outcome.code !== 0 ? { failureTail: tail(outcome.output, 4000) } : {}),
+        };
+        result.steps.push(entry);
+        if (outcome.code !== 0) {
+            result.passed = false;
+            break;
+        }
+    }
+    return result;
+}
+export function gateSummary(gate) {
+    return gate.steps
+        .map((step) => `${step.name}: ${step.code === 0 ? "ok" : step.timedOut ? "TIMEOUT" : `exit ${step.code}`}`)
+        .join(", ");
+}
+//# sourceMappingURL=gate.js.map

package/dist/improve/gate.js.map

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

package/dist/improve/index.d.ts

@@ -0,0 +1,9 @@
+type ImproveArgs = {
+    args: string[];
+    flags: {
+        dryRun?: boolean;
+        json?: boolean;
+    };
+};
+export declare function runImprove(parsed: ImproveArgs): Promise<void>;
+export {};