ralph-research 0.1.0

package/dist/cli/commands/run.js

@@ -0,0 +1,71 @@
+import { RunCycleService } from "../../app/services/run-cycle-service.js";
+const defaultCommandIO = {
+    stdout: (message) => {
+        process.stdout.write(`${message}\n`);
+    },
+    stderr: (message) => {
+        process.stderr.write(`${message}\n`);
+    },
+};
+export async function runRunCommand(options, io = defaultCommandIO) {
+    try {
+        const service = new RunCycleService();
+        const cycles = options.cycles ?? 1;
+        const results = [];
+        for (let index = 0; index < cycles; index += 1) {
+            const result = await service.run({
+                repoRoot: process.cwd(),
+                ...(options.path ? { manifestPath: options.path } : {}),
+                ...(options.resume ? { resume: options.resume } : {}),
+            });
+            results.push(result);
+            if (result.status === "failed" || result.status === "resume_required") {
+                if (options.json) {
+                    io.stdout(JSON.stringify({ ok: false, results }, null, 2));
+                }
+                else {
+                    io.stderr(`Cycle ${index + 1} ended with status ${result.status}`);
+                }
+                return 1;
+            }
+        }
+        if (options.json) {
+            io.stdout(JSON.stringify({
+                ok: true,
+                cycles,
+                results,
+            }, null, 2));
+        }
+        else {
+            const latest = results.at(-1);
+            io.stdout(`Completed ${cycles} cycle(s); latest status=${latest?.status ?? "unknown"}`);
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Failed to run cycle";
+        if (options.json) {
+            io.stderr(JSON.stringify({ ok: false, error: message }, null, 2));
+        }
+        else {
+            io.stderr(message);
+        }
+        return 1;
+    }
+}
+export function registerRunCommand(program) {
+    program
+        .command("run")
+        .description("Run one or more research cycles.")
+        .option("-p, --path <path>", "Path to the manifest file")
+        .option("-c, --cycles <count>", "Number of cycles to run", (value) => Number.parseInt(value, 10), 1)
+        .option("--resume", "Resume if the latest run is recoverable", false)
+        .option("--json", "Emit machine-readable output", false)
+        .action(async (options) => {
+        const exitCode = await runRunCommand(options);
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+    });
+}
+//# sourceMappingURL=run.js.map

package/dist/cli/commands/run.js.map

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

package/dist/cli/commands/serve-mcp.d.ts

@@ -0,0 +1,7 @@
+import type { Command } from "commander";
+import type { CommandIO } from "./run.js";
+export interface ServeMcpCommandOptions {
+    stdio?: boolean;
+}
+export declare function runServeMcpCommand(options: ServeMcpCommandOptions, io?: CommandIO): Promise<number>;
+export declare function registerServeMcpCommand(program: Command): void;

package/dist/cli/commands/serve-mcp.js

@@ -0,0 +1,32 @@
+import { startMcpServer } from "../../mcp/server.js";
+const defaultCommandIO = {
+    stdout: (message) => {
+        process.stdout.write(`${message}\n`);
+    },
+    stderr: (message) => {
+        process.stderr.write(`${message}\n`);
+    },
+};
+export async function runServeMcpCommand(options, io = defaultCommandIO) {
+    if (options.stdio === false) {
+        io.stderr("Only stdio transport is supported in v0.1");
+        return 1;
+    }
+    await startMcpServer({
+        repoRoot: process.cwd(),
+    });
+    return 0;
+}
+export function registerServeMcpCommand(program) {
+    program
+        .command("serve-mcp")
+        .description("Start the minimal MCP server over stdio.")
+        .option("--stdio", "Use stdio transport", true)
+        .action(async (options) => {
+        const exitCode = await runServeMcpCommand(options);
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+    });
+}
+//# sourceMappingURL=serve-mcp.js.map

package/dist/cli/commands/serve-mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serve-mcp.js","sourceRoot":"","sources":["../../../src/cli/commands/serve-mcp.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAOrD,MAAM,gBAAgB,GAAc;IAClC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACvC,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA+B,EAC/B,KAAgB,gBAAgB;IAEhC,IAAI,OAAO,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QAC5B,EAAE,CAAC,MAAM,CAAC,2CAA2C,CAAC,CAAC;QACvD,OAAO,CAAC,CAAC;IACX,CAAC;IAED,MAAM,cAAc,CAAC;QACnB,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE;KACxB,CAAC,CAAC;IAEH,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,WAAW,CAAC;SACpB,WAAW,CAAC,0CAA0C,CAAC;SACvD,MAAM,CAAC,SAAS,EAAE,qBAAqB,EAAE,IAAI,CAAC;SAC9C,MAAM,CAAC,KAAK,EAAE,OAA+B,EAAE,EAAE;QAChD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/status.d.ts

@@ -0,0 +1,8 @@
+import type { Command } from "commander";
+import type { CommandIO } from "./run.js";
+export interface StatusCommandOptions {
+    path?: string;
+    json?: boolean;
+}
+export declare function runStatusCommand(options: StatusCommandOptions, io?: CommandIO): Promise<number>;
+export declare function registerStatusCommand(program: Command): void;

package/dist/cli/commands/status.js

@@ -0,0 +1,53 @@
+import { getProjectStatus } from "../../app/services/project-state-service.js";
+const defaultCommandIO = {
+    stdout: (message) => {
+        process.stdout.write(`${message}\n`);
+    },
+    stderr: (message) => {
+        process.stderr.write(`${message}\n`);
+    },
+};
+export async function runStatusCommand(options, io = defaultCommandIO) {
+    try {
+        const status = await getProjectStatus({
+            repoRoot: process.cwd(),
+            ...(options.path ? { manifestPath: options.path } : {}),
+        });
+        if (options.json) {
+            io.stdout(JSON.stringify(status, null, 2));
+        }
+        else {
+            io.stdout([
+                `manifest: ${status.manifestPath}`,
+                `latest run: ${status.latestRun?.runId ?? "none"} (${status.latestRun?.status ?? "n/a"})`,
+                `frontier entries: ${status.frontier.length}`,
+                `pending human: ${status.pendingHumanRuns.length}`,
+            ].join("\n"));
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Failed to load project status";
+        if (options.json) {
+            io.stderr(JSON.stringify({ ok: false, error: message }, null, 2));
+        }
+        else {
+            io.stderr(message);
+        }
+        return 1;
+    }
+}
+export function registerStatusCommand(program) {
+    program
+        .command("status")
+        .description("Show project status, current frontier, and pending human review.")
+        .option("-p, --path <path>", "Path to the manifest file")
+        .option("--json", "Emit machine-readable output", false)
+        .action(async (options) => {
+        const exitCode = await runStatusCommand(options);
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+    });
+}
+//# sourceMappingURL=status.js.map

package/dist/cli/commands/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../src/cli/commands/status.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAQ/E,MAAM,gBAAgB,GAAc;IAClC,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACvC,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAA6B,EAC7B,KAAgB,gBAAgB;IAEhC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,gBAAgB,CAAC;YACpC,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE;YACvB,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACxD,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7C,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,MAAM,CACP;gBACE,aAAa,MAAM,CAAC,YAAY,EAAE;gBAClC,eAAe,MAAM,CAAC,SAAS,EAAE,KAAK,IAAI,MAAM,KAAK,MAAM,CAAC,SAAS,EAAE,MAAM,IAAI,KAAK,GAAG;gBACzF,qBAAqB,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE;gBAC7C,kBAAkB,MAAM,CAAC,gBAAgB,CAAC,MAAM,EAAE;aACnD,CAAC,IAAI,CAAC,IAAI,CAAC,CACb,CAAC;QACJ,CAAC;QAED,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,+BAA+B,CAAC;QACzF,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QACpE,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,OAAO;SACJ,OAAO,CAAC,QAAQ,CAAC;SACjB,WAAW,CAAC,kEAAkE,CAAC;SAC/E,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,CAAC;SACxD,MAAM,CAAC,QAAQ,EAAE,8BAA8B,EAAE,KAAK,CAAC;SACvD,MAAM,CAAC,KAAK,EAAE,OAA6B,EAAE,EAAE;QAC9C,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;QACjD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/commands/validate.d.ts

@@ -0,0 +1,11 @@
+import type { Command } from "commander";
+export interface ValidateCommandOptions {
+    path: string;
+    json?: boolean;
+}
+export interface ValidateCommandIO {
+    stdout(message: string): void;
+    stderr(message: string): void;
+}
+export declare function runValidateCommand(options: ValidateCommandOptions, io?: ValidateCommandIO): Promise<number>;
+export declare function registerValidateCommand(program: Command): void;

package/dist/cli/commands/validate.js

@@ -0,0 +1,56 @@
+import { loadManifestFromFile, ManifestLoadError } from "../../adapters/fs/manifest-loader.js";
+import { DEFAULT_MANIFEST_FILENAME } from "../../core/manifest/schema.js";
+const defaultValidateCommandIO = {
+    stdout: (message) => {
+        process.stdout.write(`${message}\n`);
+    },
+    stderr: (message) => {
+        process.stderr.write(`${message}\n`);
+    },
+};
+export async function runValidateCommand(options, io = defaultValidateCommandIO) {
+    try {
+        const loaded = await loadManifestFromFile(options.path);
+        if (options.json) {
+            io.stdout(JSON.stringify({
+                ok: true,
+                path: loaded.path,
+                project: loaded.manifest.project.name,
+                schemaVersion: loaded.manifest.schemaVersion,
+            }, null, 2));
+        }
+        else {
+            io.stdout(`Manifest is valid: ${loaded.path}`);
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof ManifestLoadError ? error.message : "Unknown validation error";
+        const details = error instanceof ManifestLoadError && error.causeValue ? `\n${JSON.stringify(error.causeValue, null, 2)}` : "";
+        if (options.json) {
+            io.stderr(JSON.stringify({
+                ok: false,
+                error: message,
+                details: error instanceof ManifestLoadError ? error.causeValue : undefined,
+            }, null, 2));
+        }
+        else {
+            io.stderr(`${message}${details}`);
+        }
+        return 1;
+    }
+}
+export function registerValidateCommand(program) {
+    program
+        .command("validate")
+        .description("Validate a ralph-research manifest.")
+        .option("-p, --path <path>", "Path to the manifest file", DEFAULT_MANIFEST_FILENAME)
+        .option("--json", "Emit machine-readable output", false)
+        .action(async (options) => {
+        const exitCode = await runValidateCommand(options);
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+    });
+}
+//# sourceMappingURL=validate.js.map

package/dist/cli/commands/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../../src/cli/commands/validate.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,oBAAoB,EAAE,iBAAiB,EAAE,MAAM,sCAAsC,CAAC;AAC/F,OAAO,EAAE,yBAAyB,EAAE,MAAM,+BAA+B,CAAC;AAY1E,MAAM,wBAAwB,GAAsB;IAClD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACvC,CAAC;IACD,MAAM,EAAE,CAAC,OAAO,EAAE,EAAE;QAClB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,OAAO,IAAI,CAAC,CAAC;IACvC,CAAC;CACF,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAA+B,EAC/B,KAAwB,wBAAwB;IAEhD,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,oBAAoB,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAExD,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,EAAE,CAAC,MAAM,CACP,IAAI,CAAC,SAAS,CACZ;gBACE,EAAE,EAAE,IAAI;gBACR,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI;gBACrC,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa;aAC7C,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,MAAM,CAAC,sBAAsB,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,OAAO,GAAG,KAAK,YAAY,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,0BAA0B,CAAC;QAChG,MAAM,OAAO,GAAG,KAAK,YAAY,iBAAiB,IAAI,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAE/H,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,EAAE,CAAC,MAAM,CACP,IAAI,CAAC,SAAS,CACZ;gBACE,EAAE,EAAE,KAAK;gBACT,KAAK,EAAE,OAAO;gBACd,OAAO,EAAE,KAAK,YAAY,iBAAiB,CAAC,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS;aAC3E,EACD,IAAI,EACJ,CAAC,CACF,CACF,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,MAAM,CAAC,GAAG,OAAO,GAAG,OAAO,EAAE,CAAC,CAAC;QACpC,CAAC;QAED,OAAO,CAAC,CAAC;IACX,CAAC;AACH,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,qCAAqC,CAAC;SAClD,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,EAAE,yBAAyB,CAAC;SACnF,MAAM,CAAC,QAAQ,EAAE,8BAA8B,EAAE,KAAK,CAAC;SACvD,MAAM,CAAC,KAAK,EAAE,OAA+B,EAAE,EAAE;QAChD,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACnD,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC9B,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/cli/main.d.ts

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

package/dist/cli/main.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { Command } from "commander";
+import { createAppContext } from "../app/context.js";
+import { registerAcceptCommand } from "./commands/accept.js";
+import { registerDemoCommand } from "./commands/demo.js";
+import { registerFrontierCommand } from "./commands/frontier.js";
+import { registerInitCommand } from "./commands/init.js";
+import { registerInspectCommand } from "./commands/inspect.js";
+import { registerRejectCommand } from "./commands/reject.js";
+import { registerRunCommand } from "./commands/run.js";
+import { registerServeMcpCommand } from "./commands/serve-mcp.js";
+import { registerStatusCommand } from "./commands/status.js";
+import { registerValidateCommand } from "./commands/validate.js";
+import { logger } from "../shared/logger.js";
+const program = new Command();
+program
+    .name("rrx")
+    .description("Local-first runtime for recursive research improvement.")
+    .version("0.1.0");
+program
+    .command("doctor")
+    .description("Print scaffold status.")
+    .action(() => {
+    const context = createAppContext();
+    logger.info({ appName: context.appName, phase: context.phase }, "scaffold ready");
+});
+registerValidateCommand(program);
+registerInitCommand(program);
+registerDemoCommand(program);
+registerRunCommand(program);
+registerStatusCommand(program);
+registerFrontierCommand(program);
+registerInspectCommand(program);
+registerAcceptCommand(program);
+registerRejectCommand(program);
+registerServeMcpCommand(program);
+await program.parseAsync(process.argv);
+//# sourceMappingURL=main.js.map

package/dist/cli/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/cli/main.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,OAAO,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,sBAAsB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,uBAAuB,EAAE,MAAM,yBAAyB,CAAC;AAClE,OAAO,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAE7C,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,yDAAyD,CAAC;KACtE,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,OAAO;KACJ,OAAO,CAAC,QAAQ,CAAC;KACjB,WAAW,CAAC,wBAAwB,CAAC;KACrC,MAAM,CAAC,GAAG,EAAE;IACX,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;IACnC,MAAM,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,EAAE,gBAAgB,CAAC,CAAC;AACpF,CAAC,CAAC,CAAC;AAEL,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,mBAAmB,CAAC,OAAO,CAAC,CAAC;AAC7B,kBAAkB,CAAC,OAAO,CAAC,CAAC;AAC5B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AACjC,sBAAsB,CAAC,OAAO,CAAC,CAAC;AAChC,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,qBAAqB,CAAC,OAAO,CAAC,CAAC;AAC/B,uBAAuB,CAAC,OAAO,CAAC,CAAC;AAEjC,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC"}

package/dist/core/engine/anchor-checker.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import type { JudgePack, LlmJudgeMetricExtractorConfig } from "../manifest/schema.js";
+import type { JudgeProvider } from "../../adapters/judge/llm-judge-provider.js";
+declare const anchorRecordSchema: z.ZodObject<{
+    id: z.ZodString;
+    prompt: z.ZodString;
+    expectedWinner: z.ZodEnum<{
+        candidate: "candidate";
+        incumbent: "incumbent";
+        tie: "tie";
+    }>;
+}, z.core.$strip>;
+export type AnchorRecord = z.infer<typeof anchorRecordSchema>;
+export interface AnchorCheckResult {
+    checked: boolean;
+    passed: boolean;
+    agreement: number;
+    minAgreement: number;
+    autoAcceptAllowed: boolean;
+    reason: string;
+    sampleCount: number;
+}
+export interface EvaluateAnchorAgreementInput {
+    pack: JudgePack;
+    extractor: LlmJudgeMetricExtractorConfig;
+    provider: JudgeProvider;
+    anchors?: AnchorRecord[];
+}
+export declare function loadAnchorRecords(path: string): Promise<AnchorRecord[]>;
+export declare function evaluateAnchorAgreement(input: EvaluateAnchorAgreementInput): Promise<AnchorCheckResult>;
+export declare function applyAnchorAgreementGate(tentativeOutcome: "accepted" | "rejected" | "needs_human", anchorCheck: AnchorCheckResult): {
+    outcome: "accepted" | "rejected" | "needs_human";
+    reason: string;
+};
+export {};

package/dist/core/engine/anchor-checker.js

@@ -0,0 +1,84 @@
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+import { z } from "zod";
+import { evaluateJudgePack } from "./judge-pack.js";
+const anchorRecordSchema = z.object({
+    id: z.string().min(1),
+    prompt: z.string().min(1),
+    expectedWinner: z.enum(["candidate", "incumbent", "tie"]),
+});
+export async function loadAnchorRecords(path) {
+    const raw = await readFile(resolve(path), "utf8");
+    return raw
+        .split("\n")
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .map((line) => anchorRecordSchema.parse(JSON.parse(line)));
+}
+export async function evaluateAnchorAgreement(input) {
+    const anchors = input.anchors ?? [];
+    const minAgreement = input.pack.anchors?.minAgreementWithHuman ?? 0;
+    if (!input.pack.anchors || anchors.length === 0) {
+        return {
+            checked: false,
+            passed: true,
+            agreement: 1,
+            minAgreement,
+            autoAcceptAllowed: true,
+            reason: "no anchors configured",
+            sampleCount: 0,
+        };
+    }
+    let agreed = 0;
+    for (const anchor of anchors) {
+        const samples = [];
+        for (let repeat = 0; repeat < input.pack.repeats; repeat += 1) {
+            for (const judge of input.pack.judges) {
+                samples.push(await input.provider.evaluate({
+                    mode: input.extractor.mode,
+                    prompt: anchor.prompt,
+                    model: judge.model,
+                }));
+            }
+        }
+        const aggregation = evaluateJudgePack({ pack: input.pack, samples });
+        const winner = aggregation.mode === "pairwise" ? aggregation.winner : aggregation.score >= 0.5 ? "candidate" : "incumbent";
+        if (winner === anchor.expectedWinner) {
+            agreed += 1;
+        }
+    }
+    const sampleCount = anchors.length;
+    const agreement = sampleCount === 0 ? 1 : agreed / sampleCount;
+    const passed = agreement >= minAgreement;
+    const autoAcceptAllowed = passed || !input.pack.audit.freezeAutoAcceptIfAnchorFails;
+    return {
+        checked: true,
+        passed,
+        agreement,
+        minAgreement,
+        autoAcceptAllowed,
+        reason: passed
+            ? `anchor agreement ${agreement.toFixed(2)} passed threshold ${minAgreement.toFixed(2)}`
+            : `anchor agreement ${agreement.toFixed(2)} below threshold ${minAgreement.toFixed(2)}`,
+        sampleCount,
+    };
+}
+export function applyAnchorAgreementGate(tentativeOutcome, anchorCheck) {
+    if (tentativeOutcome !== "accepted") {
+        return {
+            outcome: tentativeOutcome,
+            reason: anchorCheck.reason,
+        };
+    }
+    if (!anchorCheck.autoAcceptAllowed) {
+        return {
+            outcome: "needs_human",
+            reason: `${anchorCheck.reason}; auto-accept disabled`,
+        };
+    }
+    return {
+        outcome: tentativeOutcome,
+        reason: anchorCheck.reason,
+    };
+}
+//# sourceMappingURL=anchor-checker.js.map

package/dist/core/engine/anchor-checker.js.map

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

package/dist/core/engine/audit-sampler.d.ts

@@ -0,0 +1,16 @@
+import type { JudgePack } from "../manifest/schema.js";
+export interface AuditCandidate {
+    runId: string;
+    decisionId?: string;
+    outcome: "accepted" | "rejected" | "needs_human";
+    metricId: string;
+    reason: string;
+}
+export interface AuditQueueItem extends AuditCandidate {
+    auditId: string;
+    sampledAt: string;
+    sampleRate: number;
+    trigger: "sample_rate";
+}
+export declare function shouldSampleAudit(candidate: Pick<AuditCandidate, "runId" | "outcome">, sampleRate: number): boolean;
+export declare function sampleAuditQueue(candidates: AuditCandidate[], pack: Pick<JudgePack, "audit">, sampledAt?: string): AuditQueueItem[];

package/dist/core/engine/audit-sampler.js

@@ -0,0 +1,25 @@
+export function shouldSampleAudit(candidate, sampleRate) {
+    if (sampleRate <= 0 || candidate.outcome === "needs_human") {
+        return false;
+    }
+    return stableFraction(`${candidate.runId}:${candidate.outcome}`) < sampleRate;
+}
+export function sampleAuditQueue(candidates, pack, sampledAt = new Date().toISOString()) {
+    return candidates
+        .filter((candidate) => shouldSampleAudit(candidate, pack.audit.sampleRate))
+        .map((candidate) => ({
+        ...candidate,
+        auditId: `audit-${candidate.runId}`,
+        sampledAt,
+        sampleRate: pack.audit.sampleRate,
+        trigger: "sample_rate",
+    }));
+}
+function stableFraction(input) {
+    let hash = 0;
+    for (let index = 0; index < input.length; index += 1) {
+        hash = (hash * 31 + input.charCodeAt(index)) >>> 0;
+    }
+    return hash / 0x1_0000_0000;
+}
+//# sourceMappingURL=audit-sampler.js.map

package/dist/core/engine/audit-sampler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audit-sampler.js","sourceRoot":"","sources":["../../../src/core/engine/audit-sampler.ts"],"names":[],"mappings":"AAiBA,MAAM,UAAU,iBAAiB,CAAC,SAAoD,EAAE,UAAkB;IACxG,IAAI,UAAU,IAAI,CAAC,IAAI,SAAS,CAAC,OAAO,KAAK,aAAa,EAAE,CAAC;QAC3D,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,cAAc,CAAC,GAAG,SAAS,CAAC,KAAK,IAAI,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,UAAU,CAAC;AAChF,CAAC;AAED,MAAM,UAAU,gBAAgB,CAC9B,UAA4B,EAC5B,IAA8B,EAC9B,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;IAEpC,OAAO,UAAU;SACd,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,iBAAiB,CAAC,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;SAC1E,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;QACnB,GAAG,SAAS;QACZ,OAAO,EAAE,SAAS,SAAS,CAAC,KAAK,EAAE;QACnC,SAAS;QACT,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU;QACjC,OAAO,EAAE,aAAa;KACvB,CAAC,CAAC,CAAC;AACR,CAAC;AAED,SAAS,cAAc,CAAC,KAAa;IACnC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,IAAI,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,GAAG,aAAa,CAAC;AAC9B,CAAC"}

package/dist/core/engine/change-budget.d.ts

@@ -0,0 +1,11 @@
+import type { ScopeConfig } from "../manifest/schema.js";
+import type { ScopeCheckResult } from "./scope-checker.js";
+export interface EvaluateChangeBudgetInput {
+    workspacePath: string;
+    scope: ScopeConfig;
+    violationOutcome?: "rejected" | "needs_human";
+}
+export interface ChangeBudgetDecision extends ScopeCheckResult {
+    outcome: "none" | "rejected" | "needs_human";
+}
+export declare function evaluateChangeBudget(input: EvaluateChangeBudgetInput): Promise<ChangeBudgetDecision>;

package/dist/core/engine/change-budget.js

@@ -0,0 +1,10 @@
+import { checkScope, collectDiffSummary } from "./scope-checker.js";
+export async function evaluateChangeBudget(input) {
+    const summary = await collectDiffSummary(input.workspacePath);
+    const scopeCheck = checkScope(summary, input.scope);
+    return {
+        ...scopeCheck,
+        outcome: scopeCheck.withinBudget ? "none" : (input.violationOutcome ?? "rejected"),
+    };
+}
+//# sourceMappingURL=change-budget.js.map

package/dist/core/engine/change-budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-budget.js","sourceRoot":"","sources":["../../../src/core/engine/change-budget.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAYpE,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,KAAgC;IACzE,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IAEpD,OAAO;QACL,GAAG,UAAU;QACb,OAAO,EAAE,UAAU,CAAC,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,gBAAgB,IAAI,UAAU,CAAC;KACnF,CAAC;AACJ,CAAC"}

package/dist/core/engine/cycle-runner.d.ts

@@ -0,0 +1,39 @@
+import type { DecisionStore } from "../ports/decision-store.js";
+import type { FrontierStore } from "../ports/frontier-store.js";
+import type { RunStore } from "../ports/run-store.js";
+import type { RalphManifest } from "../manifest/schema.js";
+import type { DecisionRecord } from "../model/decision-record.js";
+import type { FrontierEntry } from "../model/frontier-entry.js";
+import type { RunRecord } from "../model/run-record.js";
+import { type AnchorCheckResult } from "./anchor-checker.js";
+import { type AuditQueueItem } from "./audit-sampler.js";
+import { type ChangeBudgetDecision } from "./change-budget.js";
+import { GitWorktreeWorkspaceManager } from "./workspace-manager.js";
+import { GitClient } from "../../adapters/git/git-client.js";
+import type { JudgeProvider } from "../../adapters/judge/llm-judge-provider.js";
+export interface CycleRunnerDependencies {
+    runStore: RunStore;
+    decisionStore: DecisionStore;
+    frontierStore: FrontierStore;
+    workspaceManager: GitWorktreeWorkspaceManager;
+    gitClient: GitClient;
+    judgeProvider?: JudgeProvider;
+    now?: () => Date;
+}
+export interface RunCycleInput {
+    repoRoot: string;
+    manifestPath: string;
+    manifest: RalphManifest;
+    currentFrontier: FrontierEntry[];
+}
+export type CycleRunStatus = "accepted" | "rejected" | "needs_human" | "failed";
+export interface CycleRunResult {
+    status: CycleRunStatus;
+    run: RunRecord;
+    decision?: DecisionRecord;
+    frontier: FrontierEntry[];
+    auditQueue: AuditQueueItem[];
+    changeBudget?: ChangeBudgetDecision;
+    anchorCheck?: AnchorCheckResult;
+}
+export declare function runCycle(input: RunCycleInput, dependencies: CycleRunnerDependencies): Promise<CycleRunResult>;