@viraatdas/rudder 2.10.22 → 2.10.24

package/dist/improve/mine.js

@@ -0,0 +1,173 @@
+import { callAdvisedTextModel } from "./advisor.js";
+import { titleKey, } from "./state.js";
+const MAX_SESSIONS_IN_PROMPT = 30;
+const MAX_FINDINGS_FROM_MODEL = 8;
+/**
+ * A condensed surface map so the miner proposes real file paths instead of
+ * hallucinated ones. Keep in sync with AGENTS.md section 2 when the layout
+ * moves.
+ */
+export const SURFACE_MAP = `Rudder surface map (repo-relative paths):
+- src/run-manager.ts    run lifecycle: start, worker, merge/sync routing
+- src/backends.ts       claude/codex/acpx adapters, spawn + event streaming
+- src/brain.ts          worker spec/contract rendering, verifyRun
+- src/planner.ts        headless DAG planner + plan block parsing
+- src/scheduler.ts      headless DAG scheduler (daemon), merge serialization
+- src/jj.ts             jj workspace create/merge/rebase/undo substrate
+- src/state.ts          run records, config, projects registry persistence
+- src/surfaces.ts       DECISIONS.md / completion notes / shared context
+- src/board/daemon.ts   web board HTTP+SSE server
+- src/cloud.ts          Rudder Cloud client
+- native/src/main.rs    Rust TUI: App state machine, poll loop, scheduling
+- native/src/tasks.rs   prompt construction, orchestrator system prompt
+- native/src/launch.rs  agent launch/resume command building
+- native/src/signals.rs completion signal hooks (Stop hook / notify)
+- native/src/detect.rs  idle/permission output heuristics (fallback only)
+- native/src/render.rs  TUI rendering`;
+const MINER_SYSTEM = `You are the triage stage of Rudder's continual improvement loop.
+Rudder is a terminal app that runs coding agents (Claude Code / Codex) in parallel jj worktrees with an orchestrator DAG.
+You receive telemetry summaries of recent Rudder sessions. Your job is to identify friction caused by RUDDER ITSELF (its prompts, orchestration, scheduling, merge handling, UX, performance, crashes), NOT problems in the user's own projects or model quality.
+Return findings as a single fenced json block: an array of objects with fields:
+  class: one of "prompt" | "orchestration" | "ux" | "perf" | "crash" | "other"
+  title: short imperative description of the defect (not the fix)
+  detail: 2-4 sentences: what happens, why it is Rudder's fault, what a fix might touch
+  evidence: array of {project, runId, excerpt} referencing the sessions given
+  severity: 1-5 (5 = data loss / task failure, 1 = cosmetic)
+  frequency: how many given sessions show it
+  suspectedSurfaces: repo-relative file paths from the surface map
+Only report findings supported by the evidence. Fewer, well-supported findings beat many speculative ones. If nothing is attributable to Rudder, return [].`;
+export async function mineFindings(params) {
+    const worst = [...params.sessions].sort((a, b) => frictionScore(b) - frictionScore(a));
+    const sample = worst.slice(0, MAX_SESSIONS_IN_PROMPT);
+    if (sample.length === 0)
+        return [];
+    const user = [
+        "Cycle metrics snapshot:",
+        JSON.stringify(params.snapshot),
+        "",
+        SURFACE_MAP,
+        "",
+        `Sessions (worst-first, ${sample.length} of ${params.sessions.length} new):`,
+        JSON.stringify(sample, null, 1),
+    ].join("\n");
+    if (!params.meter.canAfford(0.1))
+        return [];
+    // Advisor pattern: the executor (minerModel) does the bulk generation and
+    // consults the advisor for judgment; usage.iterations meters both sides.
+    const output = await callAdvisedTextModel({
+        executorModel: params.model,
+        advisorModel: params.advisorModel,
+        system: MINER_SYSTEM,
+        user,
+        maxTokens: 4096,
+        timeoutMs: 240000,
+        meter: params.meter,
+    });
+    const parsed = parseFindingsJson(output).slice(0, MAX_FINDINGS_FROM_MODEL);
+    const findings = parsed.map((raw, index) => normalizeFinding(raw, params.cycleId, index));
+    return dedupeAgainstLedger(findings, params.ledger);
+}
+export function frictionScore(session) {
+    let score = 0;
+    if (session.status === "failed")
+        score += 5;
+    if (session.status === "cancelled")
+        score += 3;
+    if (session.status === "merge-conflict" || session.mergeStatus === "conflict")
+        score += 4;
+    if (session.verifierSatisfied === false)
+        score += 4;
+    score += Math.min(3, session.steerCount);
+    score += Math.min(2, session.autoSteerCount);
+    score += session.errorExcerpts.length;
+    return score;
+}
+/** Parse the model's findings array out of a fenced block or bare JSON. */
+export function parseFindingsJson(output) {
+    const fenced = output.match(/```(?:json)?\s*([\s\S]*?)```/);
+    const candidates = [fenced?.[1], output];
+    for (const candidate of candidates) {
+        if (!candidate)
+            continue;
+        const start = candidate.indexOf("[");
+        const end = candidate.lastIndexOf("]");
+        if (start < 0 || end <= start)
+            continue;
+        try {
+            const value = JSON.parse(candidate.slice(start, end + 1));
+            if (Array.isArray(value)) {
+                return value.filter((item) => typeof item === "object" && item !== null);
+            }
+        }
+        catch {
+            // try the next candidate
+        }
+    }
+    return [];
+}
+const FINDING_CLASSES = ["prompt", "orchestration", "ux", "perf", "crash", "other"];
+function normalizeFinding(raw, cycleId, index) {
+    const classValue = typeof raw.class === "string" && FINDING_CLASSES.includes(raw.class)
+        ? raw.class
+        : "other";
+    const evidence = Array.isArray(raw.evidence)
+        ? raw.evidence
+            .filter((item) => typeof item === "object" && item !== null)
+            .slice(0, 5)
+            .map((item) => ({
+            project: String(item.project ?? ""),
+            runId: String(item.runId ?? ""),
+            excerpt: String(item.excerpt ?? "").slice(0, 400),
+        }))
+        : [];
+    return {
+        id: `f-${cycleId}-${index}`,
+        class: classValue,
+        title: String(raw.title ?? "untitled finding").slice(0, 160),
+        detail: String(raw.detail ?? "").slice(0, 1200),
+        evidence,
+        severity: clampInt(raw.severity, 1, 5, 2),
+        frequency: clampInt(raw.frequency, 1, 1000, 1),
+        suspectedSurfaces: Array.isArray(raw.suspectedSurfaces)
+            ? raw.suspectedSurfaces.map((s) => String(s)).slice(0, 6)
+            : [],
+    };
+}
+/**
+ * Drop findings the ledger already knows: anything shipped or currently
+ * banked under the same title key, and anything previously rejected unless
+ * its frequency has at least doubled since the rejection was recorded.
+ */
+export function dedupeAgainstLedger(findings, ledger) {
+    const byKey = new Map();
+    for (const entry of ledger) {
+        const list = byKey.get(entry.titleKey) ?? [];
+        list.push(entry);
+        byKey.set(entry.titleKey, list);
+    }
+    return findings.filter((finding) => {
+        const history = byKey.get(titleKey(finding.title)) ?? [];
+        if (history.length === 0)
+            return true;
+        if (history.some((e) => e.status === "shipped" || e.status === "branch-pushed")) {
+            return false;
+        }
+        const rejected = history.filter((e) => e.status === "judge-rejected" || e.status === "gated-out" || e.status === "agent-failed");
+        if (rejected.length > 0) {
+            const lastFrequency = extractFrequency(rejected.at(-1)?.detail ?? "");
+            return finding.frequency >= Math.max(2, lastFrequency * 2);
+        }
+        return true;
+    });
+}
+function extractFrequency(detail) {
+    const match = detail.match(/frequency=(\d+)/);
+    return match ? Number.parseInt(match[1], 10) : 1;
+}
+function clampInt(value, min, max, fallback) {
+    const parsed = typeof value === "number" ? Math.round(value) : Number.parseInt(String(value), 10);
+    if (!Number.isFinite(parsed))
+        return fallback;
+    return Math.min(max, Math.max(min, parsed));
+}
+//# sourceMappingURL=mine.js.map

package/dist/improve/mine.js.map

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

package/dist/improve/propose.d.ts

@@ -0,0 +1,51 @@
+import { type Finding, type ImproveSettings, type LedgerEntry, type MetricsSnapshot, type StepResult } from "./state.js";
+export type Proposal = {
+    finding: Finding;
+    worktree: string;
+    branch: string;
+    baseRef: string;
+    changedFiles: string[];
+    diffStat: string;
+    diffText: string;
+    resultNote: {
+        summary: string;
+        changeClass: "prompt-only" | "logic";
+        testsRun?: string;
+        risks?: string;
+    } | null;
+    agentLogPath: string;
+};
+/**
+ * Create an isolated git worktree of the rudder checkout for one finding.
+ * Plain git worktrees are safe on the jj-colocated repo: jj does not track
+ * them and the loop only ever uses git plumbing inside them.
+ */
+export declare function prepareWorktree(settings: ImproveSettings, findingId: string): Promise<{
+    worktree: string;
+    branch: string;
+    baseRef: string;
+}>;
+export declare function removeWorktree(settings: ImproveSettings, worktree: string, branch: string): Promise<void>;
+/**
+ * The context pack: everything an autonomous agent needs to fix this finding
+ * well. It runs inside a full rudder worktree, so the pack points at the
+ * canonical context (AGENTS.md, the design doc, real paths, prior attempts)
+ * instead of pasting whole files.
+ */
+export declare function buildContextPack(params: {
+    finding: Finding;
+    history: LedgerEntry[];
+    snapshot: MetricsSnapshot;
+}): string;
+export declare function runImprovementAgent(params: {
+    settings: ImproveSettings;
+    finding: Finding;
+    worktree: string;
+    branch: string;
+    baseRef: string;
+    contextPack: string;
+    extraNote?: string;
+}): Promise<{
+    proposal: Proposal | null;
+    agentResult: StepResult;
+}>;

package/dist/improve/propose.js

@@ -0,0 +1,150 @@
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import { readJson, runCommand } from "../util.js";
+import { SURFACE_MAP } from "./mine.js";
+import { execStep, logsDir, tail, worktreesDir, } from "./state.js";
+/**
+ * Create an isolated git worktree of the rudder checkout for one finding.
+ * Plain git worktrees are safe on the jj-colocated repo: jj does not track
+ * them and the loop only ever uses git plumbing inside them.
+ */
+export async function prepareWorktree(settings, findingId) {
+    const repo = settings.repoPath;
+    const pkg = await readJson(path.join(repo, "package.json"));
+    if (pkg?.name !== "@viraatdas/rudder") {
+        throw new Error(`improve.repoPath ${repo} is not a rudder checkout (package name ${pkg?.name ?? "missing"})`);
+    }
+    await runCommand("git", ["fetch", "origin", "main"], { cwd: repo, allowFailure: true });
+    const originMain = await runCommand("git", ["rev-parse", "--verify", "origin/main"], {
+        cwd: repo,
+        allowFailure: true,
+    });
+    const baseRef = originMain.code === 0 ? "origin/main" : "HEAD";
+    const branch = `improve/${findingId}`;
+    const worktree = path.join(worktreesDir(), findingId);
+    await fs.rm(worktree, { recursive: true, force: true });
+    await runCommand("git", ["worktree", "prune"], { cwd: repo, allowFailure: true });
+    await runCommand("git", ["branch", "-D", branch], { cwd: repo, allowFailure: true });
+    await runCommand("git", ["worktree", "add", "-b", branch, worktree, baseRef], { cwd: repo });
+    return { worktree, branch, baseRef };
+}
+export async function removeWorktree(settings, worktree, branch) {
+    await runCommand("git", ["worktree", "remove", "--force", worktree], {
+        cwd: settings.repoPath,
+        allowFailure: true,
+    });
+    await runCommand("git", ["branch", "-D", branch], { cwd: settings.repoPath, allowFailure: true });
+}
+/**
+ * The context pack: everything an autonomous agent needs to fix this finding
+ * well. It runs inside a full rudder worktree, so the pack points at the
+ * canonical context (AGENTS.md, the design doc, real paths, prior attempts)
+ * instead of pasting whole files.
+ */
+export function buildContextPack(params) {
+    const { finding } = params;
+    const evidence = finding.evidence
+        .map((item, i) => `  ${i + 1}. [${item.project} run ${item.runId}] ${item.excerpt}`)
+        .join("\n");
+    const priorAttempts = params.history
+        .filter((entry) => ["judge-rejected", "gated-out", "agent-failed", "push-conflict"].includes(entry.status))
+        .slice(-3)
+        .map((entry) => `  - ${entry.ts} ${entry.status}: ${entry.detail ?? "no detail"}`)
+        .join("\n");
+    return `You are an autonomous maintenance engineer working on Rudder itself, dispatched by Rudder's continual improvement loop (docs/continual-improvement.md). You are in an isolated git worktree of the rudder repo on branch-per-finding; nothing you do here touches the user's checkout.
+
+FIRST, before changing anything: read AGENTS.md in the repo root end to end. It is the engineering reference and the source of truth for architecture, conventions, invariants, and gotchas. Respect it over your instincts.
+
+FINDING (mined from real usage telemetry)
+- id: ${finding.id}
+- class: ${finding.class}
+- severity: ${finding.severity}/5, seen in ${finding.frequency} recent session(s)
+- title: ${finding.title}
+- detail: ${finding.detail}
+
+EVIDENCE (redacted excerpts from real sessions)
+${evidence || "  (none beyond the metrics)"}
+
+SUSPECTED SURFACES (verify before trusting; the miner can be wrong)
+${finding.suspectedSurfaces.map((s) => `  - ${s}`).join("\n") || "  (none suggested)"}
+
+${SURFACE_MAP}
+
+CURRENT CYCLE METRICS
+${JSON.stringify(params.snapshot)}
+
+PRIOR ATTEMPTS ON THIS FINDING (do not repeat what already failed)
+${priorAttempts || "  (none)"}
+
+REQUIREMENTS
+1. Diagnose the root cause in the actual code before writing a fix. If the finding is wrong or not actionable, make NO changes and say why in the result file.
+2. Keep the diff minimal and surgical. Match surrounding style. Follow repo conventions from AGENTS.md (atomic writes via writeJson/updateJson, no em dashes in copy, signals wiring invariant, parity fixtures, etc.).
+3. Add or update tests that lock the fix in: tests/*.test.mjs for TypeScript, native/src/app_tests.rs for the TUI.
+4. Verify your own work: run \`npm run check\`, and the relevant test suite(s) for what you touched.
+5. Commit your work yourself with a clear message: git add -A && git commit. Leave the worktree clean.
+6. Write a file .rudder-improve-result.json at the worktree root: {"summary": "...", "changeClass": "prompt-only" | "logic", "testsRun": "...", "risks": "..."}. changeClass is prompt-only when you changed only prompt/instruction text.
+7. NEVER: bump the version, touch package.json version or tags, push, publish, or edit files outside this worktree.`;
+}
+export async function runImprovementAgent(params) {
+    const agentLogPath = path.join(logsDir(), `${params.finding.id}-agent.log`);
+    const args = ["-p", "--dangerously-skip-permissions"];
+    if (params.settings.workerModel) {
+        args.push("--model", params.settings.workerModel);
+    }
+    const prompt = params.extraNote
+        ? `${params.contextPack}\n\nADDITIONAL CONTEXT FROM THE PREVIOUS ATTEMPT\n${params.extraNote}`
+        : params.contextPack;
+    const agentResult = await execStep({
+        command: "claude",
+        args,
+        cwd: params.worktree,
+        timeoutMs: params.settings.agentTimeoutMs,
+        stdin: prompt,
+        logFile: agentLogPath,
+    });
+    // Read (then drop) the agent's structured result note so it never lands in
+    // the commit history.
+    const resultPath = path.join(params.worktree, ".rudder-improve-result.json");
+    const rawNote = await readJson(resultPath);
+    await fs.rm(resultPath, { force: true });
+    const resultNote = rawNote
+        ? {
+            summary: String(rawNote.summary ?? "").slice(0, 800),
+            changeClass: rawNote.changeClass === "prompt-only" ? "prompt-only" : "logic",
+            testsRun: rawNote.testsRun ? String(rawNote.testsRun).slice(0, 400) : undefined,
+            risks: rawNote.risks ? String(rawNote.risks).slice(0, 400) : undefined,
+        }
+        : null;
+    // Commit any uncommitted leftovers so the diff below is complete.
+    const status = await runCommand("git", ["status", "--porcelain"], { cwd: params.worktree });
+    if (status.stdout.trim()) {
+        await runCommand("git", ["add", "-A"], { cwd: params.worktree });
+        await runCommand("git", ["commit", "-m", `improve: ${params.finding.title}\n\nAutomated fix for ${params.finding.id} (continual improvement loop).`], { cwd: params.worktree, allowFailure: true });
+    }
+    const changed = await runCommand("git", ["diff", "--name-only", `${params.baseRef}..HEAD`], {
+        cwd: params.worktree,
+    });
+    const changedFiles = changed.stdout.split("\n").map((line) => line.trim()).filter(Boolean);
+    if (changedFiles.length === 0) {
+        return { proposal: null, agentResult };
+    }
+    const diffStat = await runCommand("git", ["diff", "--stat", `${params.baseRef}..HEAD`], {
+        cwd: params.worktree,
+    });
+    const diffText = await runCommand("git", ["diff", `${params.baseRef}..HEAD`], { cwd: params.worktree });
+    return {
+        agentResult,
+        proposal: {
+            finding: params.finding,
+            worktree: params.worktree,
+            branch: params.branch,
+            baseRef: params.baseRef,
+            changedFiles,
+            diffStat: diffStat.stdout.trim(),
+            diffText: tail(diffText.stdout, 120_000),
+            resultNote,
+            agentLogPath,
+        },
+    };
+}
+//# sourceMappingURL=propose.js.map

package/dist/improve/propose.js.map

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

package/dist/improve/rank.d.ts

@@ -0,0 +1,16 @@
+import type { Finding, FindingClass } from "./state.js";
+/**
+ * Static tractability weights: how likely a one-shot autonomous agent is to
+ * land a safe fix in that area. Prompt/text changes are cheap and low-risk;
+ * native scheduler/merge changes are not. Phase 4 of the design feeds shipped
+ * outcomes back into these; until then they are priors.
+ */
+export declare const TRACTABILITY: Record<FindingClass, number>;
+export declare function scoreFinding(finding: Finding): number;
+/** Rank findings best-first and return the top N; the rest is banked. */
+export declare function rankFindings(findings: Finding[], maxFindings: number): {
+    selected: Finding[];
+    banked: Finding[];
+};
+/** The production metric a finding class is expected to move (see §8). */
+export declare function targetMetricFor(findingClass: FindingClass): string;

package/dist/improve/rank.js

@@ -0,0 +1,49 @@
+/**
+ * Static tractability weights: how likely a one-shot autonomous agent is to
+ * land a safe fix in that area. Prompt/text changes are cheap and low-risk;
+ * native scheduler/merge changes are not. Phase 4 of the design feeds shipped
+ * outcomes back into these; until then they are priors.
+ */
+export const TRACTABILITY = {
+    prompt: 1.0,
+    ux: 0.8,
+    orchestration: 0.6,
+    crash: 0.6,
+    perf: 0.5,
+    other: 0.4,
+};
+export function scoreFinding(finding) {
+    const tractability = TRACTABILITY[finding.class] ?? 0.4;
+    return round2(finding.severity * Math.log(1 + finding.frequency) * tractability);
+}
+/** Rank findings best-first and return the top N; the rest is banked. */
+export function rankFindings(findings, maxFindings) {
+    const scored = findings
+        .map((finding) => ({ ...finding, score: scoreFinding(finding) }))
+        .sort((a, b) => (b.score ?? 0) - (a.score ?? 0));
+    return {
+        selected: scored.slice(0, Math.max(0, maxFindings)),
+        banked: scored.slice(Math.max(0, maxFindings)),
+    };
+}
+/** The production metric a finding class is expected to move (see §8). */
+export function targetMetricFor(findingClass) {
+    switch (findingClass) {
+        case "prompt":
+            return "verifierMissRate";
+        case "ux":
+            return "steerRate";
+        case "orchestration":
+            return "mergeConflictRate";
+        case "perf":
+            return "medianDurationMs";
+        case "crash":
+            return "failedRate";
+        default:
+            return "failedRate";
+    }
+}
+function round2(value) {
+    return Math.round(value * 100) / 100;
+}
+//# sourceMappingURL=rank.js.map

package/dist/improve/rank.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rank.js","sourceRoot":"","sources":["../../src/improve/rank.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAiC;IACxD,MAAM,EAAE,GAAG;IACX,EAAE,EAAE,GAAG;IACP,aAAa,EAAE,GAAG;IAClB,KAAK,EAAE,GAAG;IACV,IAAI,EAAE,GAAG;IACT,KAAK,EAAE,GAAG;CACX,CAAC;AAEF,MAAM,UAAU,YAAY,CAAC,OAAgB;IAC3C,MAAM,YAAY,GAAG,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;IACxD,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,SAAS,CAAC,GAAG,YAAY,CAAC,CAAC;AACnF,CAAC;AAED,yEAAyE;AACzE,MAAM,UAAU,YAAY,CAAC,QAAmB,EAAE,WAAmB;IAInE,MAAM,MAAM,GAAG,QAAQ;SACpB,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;SAChE,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC;IACnD,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QACnD,MAAM,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;KAC/C,CAAC;AACJ,CAAC;AAED,0EAA0E;AAC1E,MAAM,UAAU,eAAe,CAAC,YAA0B;IACxD,QAAQ,YAAY,EAAE,CAAC;QACrB,KAAK,QAAQ;YACX,OAAO,kBAAkB,CAAC;QAC5B,KAAK,IAAI;YACP,OAAO,WAAW,CAAC;QACrB,KAAK,eAAe;YAClB,OAAO,mBAAmB,CAAC;QAC7B,KAAK,MAAM;YACT,OAAO,kBAAkB,CAAC;QAC5B,KAAK,OAAO;YACV,OAAO,YAAY,CAAC;QACtB;YACE,OAAO,YAAY,CAAC;IACxB,CAAC;AACH,CAAC;AAED,SAAS,MAAM,CAAC,KAAa;IAC3B,OAAO,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC;AACvC,CAAC"}

package/dist/improve/schedule.d.ts

@@ -0,0 +1 @@
+export declare function scheduleCommand(action: string): Promise<void>;

package/dist/improve/schedule.js

@@ -0,0 +1,93 @@
+import os from "node:os";
+import path from "node:path";
+import { promises as fs } from "node:fs";
+import { ensureDir, pathExists, runCommand, shortenHome } from "../util.js";
+import { improveHome } from "./state.js";
+const LAUNCHD_LABEL = "dev.rudder.improve";
+function plistPath() {
+    return path.join(os.homedir(), "Library", "LaunchAgents", `${LAUNCHD_LABEL}.plist`);
+}
+function launchdLogPath() {
+    return path.join(improveHome(), "launchd.log");
+}
+/**
+ * Scheduled batch, not a resident daemon (docs/continual-improvement.md §2).
+ * The plist shells through a login shell so the globally installed `rudder`
+ * resolves via the user's normal PATH. launchd fires missed
+ * StartCalendarInterval jobs on wake, which is exactly the laptop behavior we
+ * want.
+ */
+function renderPlist() {
+    const log = launchdLogPath();
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${LAUNCHD_LABEL}</string>
+  <key>ProgramArguments</key>
+  <array>
+    <string>/bin/zsh</string>
+    <string>-lc</string>
+    <string>rudder improve run</string>
+  </array>
+  <key>StartCalendarInterval</key>
+  <dict>
+    <key>Hour</key>
+    <integer>3</integer>
+    <key>Minute</key>
+    <integer>30</integer>
+  </dict>
+  <key>StandardOutPath</key>
+  <string>${log}</string>
+  <key>StandardErrorPath</key>
+  <string>${log}</string>
+</dict>
+</plist>
+`;
+}
+export async function scheduleCommand(action) {
+    if (process.platform !== "darwin") {
+        throw new Error("rudder improve schedule currently supports macOS (launchd) only; run `rudder improve run` from cron/systemd on other platforms.");
+    }
+    switch (action) {
+        case "install": {
+            await ensureDir(path.dirname(plistPath()));
+            await ensureDir(improveHome());
+            await fs.writeFile(plistPath(), renderPlist(), "utf8");
+            const uid = process.getuid?.() ?? 501;
+            // Re-bootstrap idempotently: boot out any prior registration first.
+            await runCommand("launchctl", ["bootout", `gui/${uid}/${LAUNCHD_LABEL}`], { allowFailure: true });
+            const bootstrap = await runCommand("launchctl", ["bootstrap", `gui/${uid}`, plistPath()], {
+                allowFailure: true,
+            });
+            if (bootstrap.code !== 0) {
+                await runCommand("launchctl", ["load", "-w", plistPath()]);
+            }
+            console.log(`Installed ${shortenHome(plistPath())}: nightly \`rudder improve run\` at 03:30.`);
+            console.log(`Logs: ${shortenHome(launchdLogPath())}`);
+            return;
+        }
+        case "uninstall": {
+            const uid = process.getuid?.() ?? 501;
+            await runCommand("launchctl", ["bootout", `gui/${uid}/${LAUNCHD_LABEL}`], { allowFailure: true });
+            await runCommand("launchctl", ["unload", plistPath()], { allowFailure: true });
+            await fs.rm(plistPath(), { force: true });
+            console.log(`Removed ${shortenHome(plistPath())}.`);
+            return;
+        }
+        case "status": {
+            const installed = await pathExists(plistPath());
+            const uid = process.getuid?.() ?? 501;
+            const print = await runCommand("launchctl", ["print", `gui/${uid}/${LAUNCHD_LABEL}`], {
+                allowFailure: true,
+            });
+            console.log(`plist: ${installed ? shortenHome(plistPath()) : "not installed"}`);
+            console.log(`launchd: ${print.code === 0 ? "loaded" : "not loaded"}`);
+            return;
+        }
+        default:
+            throw new Error("Usage: rudder improve schedule install|uninstall|status");
+    }
+}
+//# sourceMappingURL=schedule.js.map

package/dist/improve/schedule.js.map

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

package/dist/improve/ship.d.ts

@@ -0,0 +1,25 @@
+import { type ImproveSettings } from "./state.js";
+import type { Proposal } from "./propose.js";
+export type ShipResult = {
+    status: "shipped";
+    version: string;
+} | {
+    status: "branch-pushed";
+    branch: string;
+} | {
+    status: "push-conflict";
+    detail: string;
+};
+/**
+ * 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 declare function shipProposal(params: {
+    settings: ImproveSettings;
+    proposal: Proposal;
+}): Promise<ShipResult>;