ralph-research 0.1.0

package/dist/app/services/run-cycle-service.js

@@ -0,0 +1,69 @@
+import { join, resolve } from "node:path";
+import { JsonFileDecisionStore } from "../../adapters/fs/json-file-decision-store.js";
+import { JsonFileFrontierStore } from "../../adapters/fs/json-file-frontier-store.js";
+import { JsonFileRunStore } from "../../adapters/fs/json-file-run-store.js";
+import { GitClient } from "../../adapters/git/git-client.js";
+import { acquireLock, releaseLock } from "../../adapters/fs/lockfile.js";
+import { loadManifestFromFile } from "../../adapters/fs/manifest-loader.js";
+import { DEFAULT_MANIFEST_FILENAME } from "../../core/manifest/schema.js";
+import { DEFAULT_STORAGE_ROOT } from "../../core/manifest/defaults.js";
+import { canResume, recoverRun } from "../../core/state/run-state-machine.js";
+import { GitWorktreeWorkspaceManager } from "../../core/engine/workspace-manager.js";
+import { runCycle } from "../../core/engine/cycle-runner.js";
+export class RunCycleService {
+    judgeProvider;
+    now;
+    constructor(dependencies = {}) {
+        this.judgeProvider = dependencies.judgeProvider;
+        this.now = dependencies.now;
+    }
+    async run(input) {
+        const repoRoot = resolve(input.repoRoot);
+        const manifestPath = resolve(repoRoot, input.manifestPath ?? DEFAULT_MANIFEST_FILENAME);
+        const lockPath = join(repoRoot, DEFAULT_STORAGE_ROOT, "lock");
+        const lock = await acquireLock(lockPath);
+        try {
+            const loadedManifest = await loadManifestFromFile(manifestPath);
+            const storageRoot = join(repoRoot, loadedManifest.manifest.storage.root);
+            const runStore = new JsonFileRunStore(join(storageRoot, "runs"));
+            const frontierStore = new JsonFileFrontierStore(join(storageRoot, "frontier.json"));
+            const decisionStore = new JsonFileDecisionStore(join(storageRoot, "decisions"));
+            const latestRun = (await runStore.list()).at(-1);
+            if (latestRun && canResume(latestRun) && !input.resume) {
+                return {
+                    status: "resume_required",
+                    manifestPath: loadedManifest.path,
+                    lockPath,
+                    recoveryPlan: recoverRun(latestRun),
+                };
+            }
+            const frontier = await frontierStore.load();
+            const workspaceManager = new GitWorktreeWorkspaceManager(repoRoot, storageRoot);
+            const gitClient = new GitClient(repoRoot);
+            const runResult = await runCycle({
+                repoRoot,
+                manifestPath: loadedManifest.path,
+                manifest: loadedManifest.manifest,
+                currentFrontier: frontier,
+            }, {
+                runStore,
+                frontierStore,
+                decisionStore,
+                workspaceManager,
+                gitClient,
+                ...(this.judgeProvider ? { judgeProvider: this.judgeProvider } : {}),
+                ...(this.now ? { now: this.now } : {}),
+            });
+            return {
+                status: runResult.status,
+                manifestPath: loadedManifest.path,
+                lockPath,
+                runResult,
+            };
+        }
+        finally {
+            await releaseLock(lock.path, lock.metadata.token);
+        }
+    }
+}
+//# sourceMappingURL=run-cycle-service.js.map

package/dist/app/services/run-cycle-service.js.map

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

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

@@ -0,0 +1,10 @@
+import type { Command } from "commander";
+import type { CommandIO } from "./run.js";
+export interface AcceptCommandOptions {
+    path?: string;
+    note?: string;
+    by?: string;
+    json?: boolean;
+}
+export declare function runAcceptCommand(runId: string, options: AcceptCommandOptions, io?: CommandIO): Promise<number>;
+export declare function registerAcceptCommand(program: Command): void;

package/dist/cli/commands/accept.js

@@ -0,0 +1,54 @@
+import { ManualDecisionService } from "../../app/services/manual-decision-service.js";
+const defaultCommandIO = {
+    stdout: (message) => {
+        process.stdout.write(`${message}\n`);
+    },
+    stderr: (message) => {
+        process.stderr.write(`${message}\n`);
+    },
+};
+export async function runAcceptCommand(runId, options, io = defaultCommandIO) {
+    try {
+        const result = await new ManualDecisionService().accept({
+            repoRoot: process.cwd(),
+            runId,
+            ...(options.path ? { manifestPath: options.path } : {}),
+            ...(options.note ? { note: options.note } : {}),
+            ...(options.by ? { by: options.by } : {}),
+        });
+        if (options.json) {
+            io.stdout(JSON.stringify({ ok: true, result }, null, 2));
+        }
+        else {
+            io.stdout(`Accepted ${runId}${result.decision.commitSha ? ` at ${result.decision.commitSha}` : ""}`);
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Failed to accept run";
+        if (options.json) {
+            io.stderr(JSON.stringify({ ok: false, error: message }, null, 2));
+        }
+        else {
+            io.stderr(message);
+        }
+        return 1;
+    }
+}
+export function registerAcceptCommand(program) {
+    program
+        .command("accept")
+        .description("Accept a pending human review run and promote it to the frontier.")
+        .argument("<runId>", "Run identifier")
+        .option("-p, --path <path>", "Path to the manifest file")
+        .option("--note <note>", "Optional acceptance note")
+        .option("--by <actor>", "Human actor identifier")
+        .option("--json", "Emit machine-readable output", false)
+        .action(async (runId, options) => {
+        const exitCode = await runAcceptCommand(runId, options);
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+    });
+}
+//# sourceMappingURL=accept.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"accept.js","sourceRoot":"","sources":["../../../src/cli/commands/accept.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAUtF,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,KAAa,EACb,OAA6B,EAC7B,KAAgB,gBAAgB;IAEhC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,qBAAqB,EAAE,CAAC,MAAM,CAAC;YACtD,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE;YACvB,KAAK;YACL,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,MAAM,CAAC,YAAY,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACvG,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,sBAAsB,CAAC;QAChF,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,mEAAmE,CAAC;SAChF,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;SACrC,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,CAAC;SACxD,MAAM,CAAC,eAAe,EAAE,0BAA0B,CAAC;SACnD,MAAM,CAAC,cAAc,EAAE,wBAAwB,CAAC;SAChD,MAAM,CAAC,QAAQ,EAAE,8BAA8B,EAAE,KAAK,CAAC;SACvD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,OAA6B,EAAE,EAAE;QAC7D,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACxD,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/demo.d.ts

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

package/dist/cli/commands/demo.js

@@ -0,0 +1,108 @@
+import { mkdir, mkdtemp, rm } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join, resolve } from "node:path";
+import { execa } from "execa";
+import { inspectRun } from "../../app/services/project-state-service.js";
+import { RunCycleService } from "../../app/services/run-cycle-service.js";
+import { DEFAULT_MANIFEST_FILENAME } from "../../core/manifest/schema.js";
+import { copyTemplate } from "../../shared/template-utils.js";
+const defaultCommandIO = {
+    stdout: (message) => {
+        process.stdout.write(`${message}\n`);
+    },
+    stderr: (message) => {
+        process.stderr.write(`${message}\n`);
+    },
+};
+export async function runDemoCommand(template, options, io = defaultCommandIO) {
+    if (template !== "writing") {
+        const message = `Unsupported demo template ${template}; only writing is available in v0.1`;
+        if (options.json) {
+            io.stderr(JSON.stringify({ ok: false, error: message }, null, 2));
+        }
+        else {
+            io.stderr(message);
+        }
+        return 1;
+    }
+    try {
+        const targetDir = options.path
+            ? resolve(options.path)
+            : await mkdtemp(join(tmpdir(), "rrx-demo-writing-"));
+        if (options.force) {
+            await rm(targetDir, { recursive: true, force: true });
+        }
+        await mkdir(targetDir, { recursive: true });
+        await copyTemplate(template, targetDir, {
+            ...(options.force === undefined ? {} : { force: options.force }),
+        });
+        await initializeDemoRepo(targetDir);
+        const service = new RunCycleService();
+        const result = await service.run({
+            repoRoot: targetDir,
+            manifestPath: join(targetDir, DEFAULT_MANIFEST_FILENAME),
+        });
+        const runId = result.runResult?.run.runId;
+        if (!runId) {
+            throw new Error(`Demo run did not produce a run record; status=${result.status}`);
+        }
+        const inspection = await inspectRun({
+            repoRoot: targetDir,
+            manifestPath: join(targetDir, DEFAULT_MANIFEST_FILENAME),
+            runId,
+        });
+        if (options.json) {
+            io.stdout(JSON.stringify({
+                ok: true,
+                template,
+                targetDir,
+                status: result.status,
+                runId,
+                inspect: inspection.explainability,
+            }, null, 2));
+        }
+        else {
+            io.stdout([
+                `Demo created at ${targetDir}`,
+                `Cycle status: ${result.status}`,
+                `Run: ${runId}`,
+                `Decision: ${inspection.explainability.decisionReason ?? "n/a"}`,
+                `Next: cd ${targetDir} && rrx inspect ${runId} --json`,
+            ].join("\n"));
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Failed to run demo";
+        if (options.json) {
+            io.stderr(JSON.stringify({ ok: false, error: message }, null, 2));
+        }
+        else {
+            io.stderr(message);
+        }
+        return 1;
+    }
+}
+export function registerDemoCommand(program) {
+    program
+        .command("demo")
+        .description("Create and run a zero-config demo.")
+        .argument("<template>", "Demo template name")
+        .option("-p, --path <path>", "Destination directory")
+        .option("--force", "Replace the destination directory if it already exists", false)
+        .option("--json", "Emit machine-readable output", false)
+        .action(async (template, options) => {
+        const exitCode = await runDemoCommand(template, options);
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+    });
+}
+async function initializeDemoRepo(repoRoot) {
+    await execa("git", ["init"], { cwd: repoRoot });
+    await execa("git", ["config", "user.name", "ralph-research demo"], { cwd: repoRoot });
+    await execa("git", ["config", "user.email", "demo@example.com"], { cwd: repoRoot });
+    await execa("git", ["add", "."], { cwd: repoRoot });
+    await execa("git", ["commit", "-m", "demo fixture"], { cwd: repoRoot });
+}
+//# sourceMappingURL=demo.js.map

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

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

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

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

package/dist/cli/commands/frontier.js

@@ -0,0 +1,48 @@
+import { getProjectFrontier } 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 runFrontierCommand(options, io = defaultCommandIO) {
+    try {
+        const frontier = await getProjectFrontier({
+            repoRoot: process.cwd(),
+            ...(options.path ? { manifestPath: options.path } : {}),
+        });
+        if (options.json) {
+            io.stdout(JSON.stringify(frontier, null, 2));
+        }
+        else {
+            io.stdout(`frontier entries: ${frontier.frontier.length}`);
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Failed to load frontier";
+        if (options.json) {
+            io.stderr(JSON.stringify({ ok: false, error: message }, null, 2));
+        }
+        else {
+            io.stderr(message);
+        }
+        return 1;
+    }
+}
+export function registerFrontierCommand(program) {
+    program
+        .command("frontier")
+        .description("Show the current frontier.")
+        .option("-p, --path <path>", "Path to the manifest file")
+        .option("--json", "Emit machine-readable output", false)
+        .action(async (options) => {
+        const exitCode = await runFrontierCommand(options);
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+    });
+}
+//# sourceMappingURL=frontier.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"frontier.js","sourceRoot":"","sources":["../../../src/cli/commands/frontier.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AAQjF,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,CAAC;QACH,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC;YACxC,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,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,MAAM,CAAC,qBAAqB,QAAQ,CAAC,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;QAC7D,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,yBAAyB,CAAC;QACnF,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,uBAAuB,CAAC,OAAgB;IACtD,OAAO;SACJ,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CAAC,4BAA4B,CAAC;SACzC,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,CAAC;SACxD,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/commands/init.d.ts

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

package/dist/cli/commands/init.js

@@ -0,0 +1,123 @@
+import { mkdir } from "node:fs/promises";
+import { resolve } from "node:path";
+import { execa } from "execa";
+import { loadManifestFromFile } from "../../adapters/fs/manifest-loader.js";
+import { DEFAULT_MANIFEST_FILENAME } from "../../core/manifest/schema.js";
+import { copyTemplate } from "../../shared/template-utils.js";
+const defaultCommandIO = {
+    stdout: (message) => {
+        process.stdout.write(`${message}\n`);
+    },
+    stderr: (message) => {
+        process.stderr.write(`${message}\n`);
+    },
+};
+export async function runInitCommand(options, io = defaultCommandIO) {
+    try {
+        const targetDir = resolve(options.path ?? process.cwd());
+        await mkdir(targetDir, { recursive: true });
+        const copied = await copyTemplate(options.template, targetDir, {
+            ...(options.force === undefined ? {} : { force: options.force }),
+        });
+        const manifestPath = resolve(targetDir, DEFAULT_MANIFEST_FILENAME);
+        const manifest = await loadManifestFromFile(manifestPath);
+        const initializedGit = await ensureRunnableGitRepo(targetDir, `rrx: init ${options.template} template`);
+        if (options.json) {
+            io.stdout(JSON.stringify({
+                ok: true,
+                template: options.template,
+                targetDir,
+                copiedFiles: copied.copiedFiles,
+                manifestPath: manifest.path,
+                project: manifest.manifest.project.name,
+                initializedGit,
+            }, null, 2));
+        }
+        else {
+            io.stdout([
+                `Initialized ${options.template} template in ${targetDir}`,
+                `Manifest: ${manifest.path}`,
+                initializedGit ? "Git: initialized runnable repository with first commit" : "Git: reused existing repository",
+                "Next: rrx run --json",
+            ].join("\n"));
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Failed to initialize template";
+        if (options.json) {
+            io.stderr(JSON.stringify({ ok: false, error: message }, null, 2));
+        }
+        else {
+            io.stderr(message);
+        }
+        return 1;
+    }
+}
+async function ensureRunnableGitRepo(repoRoot, message) {
+    const insideGitRepo = await isInsideGitRepo(repoRoot);
+    if (!insideGitRepo) {
+        await execa("git", ["init"], { cwd: repoRoot });
+    }
+    await ensureGitIdentity(repoRoot);
+    const hasHead = await hasGitHead(repoRoot);
+    if (!hasHead) {
+        await execa("git", ["add", "."], { cwd: repoRoot });
+        await execa("git", ["commit", "-m", message], { cwd: repoRoot });
+    }
+    return !insideGitRepo || !hasHead;
+}
+async function isInsideGitRepo(repoRoot) {
+    try {
+        await execa("git", ["rev-parse", "--is-inside-work-tree"], { cwd: repoRoot });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function hasGitHead(repoRoot) {
+    try {
+        await execa("git", ["rev-parse", "--verify", "HEAD"], { cwd: repoRoot });
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function ensureGitIdentity(repoRoot) {
+    const name = await readGitConfig(repoRoot, "user.name");
+    if (!name) {
+        await execa("git", ["config", "user.name", "ralph-research"], { cwd: repoRoot });
+    }
+    const email = await readGitConfig(repoRoot, "user.email");
+    if (!email) {
+        await execa("git", ["config", "user.email", "rrx@example.invalid"], { cwd: repoRoot });
+    }
+}
+async function readGitConfig(repoRoot, key) {
+    try {
+        const { stdout } = await execa("git", ["config", "--get", key], { cwd: repoRoot });
+        const value = stdout.trim();
+        return value.length > 0 ? value : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function registerInitCommand(program) {
+    program
+        .command("init")
+        .description("Copy a starter template into the current directory or a target path.")
+        .requiredOption("--template <name>", "Template name", "writing")
+        .option("-p, --path <path>", "Destination directory", process.cwd())
+        .option("--force", "Overwrite existing files when needed", false)
+        .option("--json", "Emit machine-readable output", false)
+        .action(async (options) => {
+        const exitCode = await runInitCommand(options);
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

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

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

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

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

package/dist/cli/commands/inspect.js

@@ -0,0 +1,55 @@
+import { RunNotFoundError, inspectRun } 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 runInspectCommand(runId, options, io = defaultCommandIO) {
+    try {
+        const result = await inspectRun({
+            repoRoot: process.cwd(),
+            runId,
+            ...(options.path ? { manifestPath: options.path } : {}),
+        });
+        if (options.json) {
+            io.stdout(JSON.stringify(result, null, 2));
+        }
+        else {
+            io.stdout([
+                `run: ${result.run.runId} (${result.run.status})`,
+                `decision: ${result.decision?.outcome ?? "n/a"}`,
+                `reason: ${result.explainability.decisionReason ?? "n/a"}`,
+                `judge rationales: ${result.explainability.judgeRationales.length}`,
+            ].join("\n"));
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof RunNotFoundError ? error.message : "Failed to inspect run";
+        if (options.json) {
+            io.stderr(JSON.stringify({ ok: false, error: message }, null, 2));
+        }
+        else {
+            io.stderr(message);
+        }
+        return 1;
+    }
+}
+export function registerInspectCommand(program) {
+    program
+        .command("inspect")
+        .description("Inspect a run with diff, metrics, and decision rationale.")
+        .argument("<runId>", "Run identifier")
+        .option("-p, --path <path>", "Path to the manifest file")
+        .option("--json", "Emit machine-readable output", false)
+        .action(async (runId, options) => {
+        const exitCode = await runInspectCommand(runId, options);
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+    });
+}
+//# sourceMappingURL=inspect.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspect.js","sourceRoot":"","sources":["../../../src/cli/commands/inspect.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAC;AAQ3F,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,iBAAiB,CACrC,KAAa,EACb,OAA8B,EAC9B,KAAgB,gBAAgB;IAEhC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC;YAC9B,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE;YACvB,KAAK;YACL,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,QAAQ,MAAM,CAAC,GAAG,CAAC,KAAK,KAAK,MAAM,CAAC,GAAG,CAAC,MAAM,GAAG;gBACjD,aAAa,MAAM,CAAC,QAAQ,EAAE,OAAO,IAAI,KAAK,EAAE;gBAChD,WAAW,MAAM,CAAC,cAAc,CAAC,cAAc,IAAI,KAAK,EAAE;gBAC1D,qBAAqB,MAAM,CAAC,cAAc,CAAC,eAAe,CAAC,MAAM,EAAE;aACpE,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,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,uBAAuB,CAAC;QAC5F,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,sBAAsB,CAAC,OAAgB;IACrD,OAAO;SACJ,OAAO,CAAC,SAAS,CAAC;SAClB,WAAW,CAAC,2DAA2D,CAAC;SACxE,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;SACrC,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,CAAC;SACxD,MAAM,CAAC,QAAQ,EAAE,8BAA8B,EAAE,KAAK,CAAC;SACvD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,OAA8B,EAAE,EAAE;QAC9D,MAAM,QAAQ,GAAG,MAAM,iBAAiB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACzD,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/reject.d.ts

@@ -0,0 +1,10 @@
+import type { Command } from "commander";
+import type { CommandIO } from "./run.js";
+export interface RejectCommandOptions {
+    path?: string;
+    note?: string;
+    by?: string;
+    json?: boolean;
+}
+export declare function runRejectCommand(runId: string, options: RejectCommandOptions, io?: CommandIO): Promise<number>;
+export declare function registerRejectCommand(program: Command): void;

package/dist/cli/commands/reject.js

@@ -0,0 +1,54 @@
+import { ManualDecisionService } from "../../app/services/manual-decision-service.js";
+const defaultCommandIO = {
+    stdout: (message) => {
+        process.stdout.write(`${message}\n`);
+    },
+    stderr: (message) => {
+        process.stderr.write(`${message}\n`);
+    },
+};
+export async function runRejectCommand(runId, options, io = defaultCommandIO) {
+    try {
+        const result = await new ManualDecisionService().reject({
+            repoRoot: process.cwd(),
+            runId,
+            ...(options.path ? { manifestPath: options.path } : {}),
+            ...(options.note ? { note: options.note } : {}),
+            ...(options.by ? { by: options.by } : {}),
+        });
+        if (options.json) {
+            io.stdout(JSON.stringify({ ok: true, result }, null, 2));
+        }
+        else {
+            io.stdout(`Rejected ${runId}`);
+        }
+        return 0;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : "Failed to reject run";
+        if (options.json) {
+            io.stderr(JSON.stringify({ ok: false, error: message }, null, 2));
+        }
+        else {
+            io.stderr(message);
+        }
+        return 1;
+    }
+}
+export function registerRejectCommand(program) {
+    program
+        .command("reject")
+        .description("Reject a pending human review run and discard its workspace.")
+        .argument("<runId>", "Run identifier")
+        .option("-p, --path <path>", "Path to the manifest file")
+        .option("--note <note>", "Optional rejection note")
+        .option("--by <actor>", "Human actor identifier")
+        .option("--json", "Emit machine-readable output", false)
+        .action(async (runId, options) => {
+        const exitCode = await runRejectCommand(runId, options);
+        if (exitCode !== 0) {
+            process.exitCode = exitCode;
+        }
+    });
+}
+//# sourceMappingURL=reject.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"reject.js","sourceRoot":"","sources":["../../../src/cli/commands/reject.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AAUtF,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,KAAa,EACb,OAA6B,EAC7B,KAAgB,gBAAgB;IAEhC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,qBAAqB,EAAE,CAAC,MAAM,CAAC;YACtD,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE;YACvB,KAAK;YACL,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvD,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC/C,GAAG,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAC1C,CAAC,CAAC;QAEH,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACjB,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,EAAE,CAAC,MAAM,CAAC,YAAY,KAAK,EAAE,CAAC,CAAC;QACjC,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,sBAAsB,CAAC;QAChF,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,8DAA8D,CAAC;SAC3E,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;SACrC,MAAM,CAAC,mBAAmB,EAAE,2BAA2B,CAAC;SACxD,MAAM,CAAC,eAAe,EAAE,yBAAyB,CAAC;SAClD,MAAM,CAAC,cAAc,EAAE,wBAAwB,CAAC;SAChD,MAAM,CAAC,QAAQ,EAAE,8BAA8B,EAAE,KAAK,CAAC;SACvD,MAAM,CAAC,KAAK,EAAE,KAAa,EAAE,OAA6B,EAAE,EAAE;QAC7D,MAAM,QAAQ,GAAG,MAAM,gBAAgB,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QACxD,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/run.d.ts

@@ -0,0 +1,13 @@
+import type { Command } from "commander";
+export interface RunCommandOptions {
+    path?: string;
+    cycles?: number;
+    json?: boolean;
+    resume?: boolean;
+}
+export interface CommandIO {
+    stdout(message: string): void;
+    stderr(message: string): void;
+}
+export declare function runRunCommand(options: RunCommandOptions, io?: CommandIO): Promise<number>;
+export declare function registerRunCommand(program: Command): void;