ralph-research 0.1.0

package/dist/core/state/run-state-machine.js.map

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

package/dist/mcp/main.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/mcp/main.js

@@ -0,0 +1,8 @@
+import { startMcpServer } from "./server.js";
+void startMcpServer({
+    repoRoot: process.cwd(),
+}).catch((error) => {
+    process.stderr.write(`${error instanceof Error ? error.message : String(error)}\n`);
+    process.exitCode = 1;
+});
+//# sourceMappingURL=main.js.map

package/dist/mcp/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../src/mcp/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAE7C,KAAK,cAAc,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC,GAAG,EAAE;CACxB,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACpF,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAC;AACvB,CAAC,CAAC,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export interface RalphResearchMcpServerOptions {
+    repoRoot?: string;
+}
+export declare function createRalphResearchMcpServer(options?: RalphResearchMcpServerOptions): McpServer;
+export declare function startMcpServer(options?: RalphResearchMcpServerOptions): Promise<McpServer>;

package/dist/mcp/server.js

@@ -0,0 +1,97 @@
+import { resolve } from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import * as z from "zod/v4";
+import { getProjectFrontier, getProjectStatus } from "../app/services/project-state-service.js";
+import { RunCycleService } from "../app/services/run-cycle-service.js";
+export function createRalphResearchMcpServer(options = {}) {
+    const defaultRepoRoot = resolve(options.repoRoot ?? process.cwd());
+    const server = new McpServer({
+        name: "ralph-research",
+        version: "0.1.0",
+    });
+    server.registerTool("run_research_cycle", {
+        description: "Run one or more research cycles using the shared ralph-research service layer.",
+        inputSchema: {
+            repoRoot: z.string().optional().describe("Repository root; defaults to the server working directory."),
+            manifestPath: z.string().optional().describe("Optional path to the manifest file."),
+            cycles: z.number().int().min(1).max(20).default(1).describe("Number of cycles to run."),
+            resume: z.boolean().default(false).describe("Resume the latest run if it is recoverable."),
+        },
+    }, async ({ repoRoot, manifestPath, cycles = 1, resume = false }) => {
+        const service = new RunCycleService();
+        const resolvedRepoRoot = resolve(repoRoot ?? defaultRepoRoot);
+        const results = [];
+        for (let index = 0; index < cycles; index += 1) {
+            const result = await service.run({
+                repoRoot: resolvedRepoRoot,
+                ...(manifestPath ? { manifestPath } : {}),
+                resume,
+            });
+            results.push(result);
+            if (result.status === "failed" || result.status === "resume_required") {
+                break;
+            }
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        ok: results.every((result) => result.status !== "failed" && result.status !== "resume_required"),
+                        cycles,
+                        results,
+                    }, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerTool("get_research_status", {
+        description: "Get the latest run, frontier summary, and pending human review items.",
+        inputSchema: {
+            repoRoot: z.string().optional().describe("Repository root; defaults to the server working directory."),
+            manifestPath: z.string().optional().describe("Optional path to the manifest file."),
+        },
+    }, async ({ repoRoot, manifestPath }) => {
+        const payload = await getProjectStatus({
+            repoRoot: resolve(repoRoot ?? defaultRepoRoot),
+            ...(manifestPath ? { manifestPath } : {}),
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(payload, null, 2),
+                },
+            ],
+        };
+    });
+    server.registerTool("get_frontier", {
+        description: "Get the current frontier entries for the active manifest.",
+        inputSchema: {
+            repoRoot: z.string().optional().describe("Repository root; defaults to the server working directory."),
+            manifestPath: z.string().optional().describe("Optional path to the manifest file."),
+        },
+    }, async ({ repoRoot, manifestPath }) => {
+        const payload = await getProjectFrontier({
+            repoRoot: resolve(repoRoot ?? defaultRepoRoot),
+            ...(manifestPath ? { manifestPath } : {}),
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(payload, null, 2),
+                },
+            ],
+        };
+    });
+    return server;
+}
+export async function startMcpServer(options = {}) {
+    const server = createRalphResearchMcpServer(options);
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/shared/fs-errors.d.ts

@@ -0,0 +1 @@
+export declare function isMissingFileError(error: unknown): error is NodeJS.ErrnoException;

package/dist/shared/fs-errors.js

@@ -0,0 +1,4 @@
+export function isMissingFileError(error) {
+    return error instanceof Error && "code" in error && error.code === "ENOENT";
+}
+//# sourceMappingURL=fs-errors.js.map

package/dist/shared/fs-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-errors.js","sourceRoot":"","sources":["../../src/shared/fs-errors.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,kBAAkB,CAAC,KAAc;IAC/C,OAAO,KAAK,YAAY,KAAK,IAAI,MAAM,IAAI,KAAK,IAAK,KAA+B,CAAC,IAAI,KAAK,QAAQ,CAAC;AACzG,CAAC"}

package/dist/shared/logger.d.ts

@@ -0,0 +1,2 @@
+import pino from "pino";
+export declare const logger: pino.Logger<never, boolean>;

package/dist/shared/logger.js

@@ -0,0 +1,5 @@
+import pino from "pino";
+export const logger = pino({
+    name: "ralph-research",
+});
+//# sourceMappingURL=logger.js.map

package/dist/shared/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/shared/logger.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,MAAM,CAAC,MAAM,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,gBAAgB;CACvB,CAAC,CAAC"}

package/dist/shared/template-utils.d.ts

@@ -0,0 +1,9 @@
+export interface TemplateCopyOptions {
+    force?: boolean;
+}
+export declare function getTemplateRoot(templateName: string): string;
+export declare function copyTemplate(templateName: string, targetDir: string, options?: TemplateCopyOptions): Promise<{
+    templateRoot: string;
+    targetDir: string;
+    copiedFiles: string[];
+}>;

package/dist/shared/template-utils.js

@@ -0,0 +1,50 @@
+import { cp, mkdir, readdir, stat } from "node:fs/promises";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+const packageRoot = resolve(fileURLToPath(new URL("../../", import.meta.url)));
+export function getTemplateRoot(templateName) {
+    return join(packageRoot, "templates", templateName);
+}
+export async function copyTemplate(templateName, targetDir, options = {}) {
+    const templateRoot = getTemplateRoot(templateName);
+    const resolvedTargetDir = resolve(targetDir);
+    const copiedFiles = await copyDirectoryContents(templateRoot, resolvedTargetDir, options);
+    return {
+        templateRoot,
+        targetDir: resolvedTargetDir,
+        copiedFiles,
+    };
+}
+async function copyDirectoryContents(sourceDir, targetDir, options, relativeDir = "") {
+    const sourcePath = relativeDir ? join(sourceDir, relativeDir) : sourceDir;
+    const entries = await readdir(sourcePath, { withFileTypes: true });
+    const copiedFiles = [];
+    for (const entry of entries) {
+        const entryRelativePath = relativeDir ? join(relativeDir, entry.name) : entry.name;
+        const sourceEntryPath = join(sourceDir, entryRelativePath);
+        const targetEntryPath = join(targetDir, entryRelativePath);
+        if (entry.isDirectory()) {
+            await mkdir(targetEntryPath, { recursive: true });
+            copiedFiles.push(...(await copyDirectoryContents(sourceDir, targetDir, options, entryRelativePath)));
+            continue;
+        }
+        await mkdir(dirname(targetEntryPath), { recursive: true });
+        const exists = await pathExists(targetEntryPath);
+        if (exists && !options.force) {
+            throw new Error(`Refusing to overwrite ${targetEntryPath}; rerun with --force to replace it`);
+        }
+        await cp(sourceEntryPath, targetEntryPath, { force: options.force ?? false });
+        copiedFiles.push(entryRelativePath.replaceAll("\\", "/"));
+    }
+    return copiedFiles.sort();
+}
+async function pathExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=template-utils.js.map

package/dist/shared/template-utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-utils.js","sourceRoot":"","sources":["../../src/shared/template-utils.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAMzC,MAAM,WAAW,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAE/E,MAAM,UAAU,eAAe,CAAC,YAAoB;IAClD,OAAO,IAAI,CAAC,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY,CAChC,YAAoB,EACpB,SAAiB,EACjB,UAA+B,EAAE;IAEjC,MAAM,YAAY,GAAG,eAAe,CAAC,YAAY,CAAC,CAAC;IACnD,MAAM,iBAAiB,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,MAAM,qBAAqB,CAAC,YAAY,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAE1F,OAAO;QACL,YAAY;QACZ,SAAS,EAAE,iBAAiB;QAC5B,WAAW;KACZ,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,qBAAqB,CAClC,SAAiB,EACjB,SAAiB,EACjB,OAA4B,EAC5B,WAAW,GAAG,EAAE;IAEhB,MAAM,UAAU,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC1E,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACnE,MAAM,WAAW,GAAa,EAAE,CAAC;IAEjC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,iBAAiB,GAAG,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC;QACnF,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QAC3D,MAAM,eAAe,GAAG,IAAI,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;QAE3D,IAAI,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;YACxB,MAAM,KAAK,CAAC,eAAe,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YAClD,WAAW,CAAC,IAAI,CACd,GAAG,CAAC,MAAM,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CACnF,CAAC;YACF,SAAS;QACX,CAAC;QAED,MAAM,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,eAAe,CAAC,CAAC;QACjD,IAAI,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YAC7B,MAAM,IAAI,KAAK,CAAC,yBAAyB,eAAe,oCAAoC,CAAC,CAAC;QAChG,CAAC;QAED,MAAM,EAAE,CAAC,eAAe,EAAE,eAAe,EAAE,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,IAAI,KAAK,EAAE,CAAC,CAAC;QAC9E,WAAW,CAAC,IAAI,CAAC,iBAAiB,CAAC,UAAU,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO,WAAW,CAAC,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,UAAU,CAAC,IAAY;IACpC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "ralph-research",
+  "version": "0.1.0",
+  "description": "Local-first runtime for recursive research improvement.",
+  "type": "module",
+  "bin": {
+    "rrx": "./dist/cli/main.js"
+  },
+  "files": [
+    "dist",
+    "templates",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/cli/main.ts",
+    "mcp": "tsx src/mcp/main.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit -p tsconfig.json"
+  },
+  "keywords": [
+    "research",
+    "ratchet",
+    "cli",
+    "mcp"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.4",
+    "commander": "^14.0.1",
+    "execa": "^9.6.0",
+    "pino": "^10.0.0",
+    "yaml": "^2.8.1",
+    "zod": "^4.1.11"
+  },
+  "devDependencies": {
+    "@types/node": "^24.7.2",
+    "tsx": "^4.20.6",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  }
+}

package/templates/writing/docs/draft.md

@@ -0,0 +1 @@
+ralph-research is important for research work. It is important because teams need a loop, and the loop should help improve drafts. The system should look at a draft, make a change, and then maybe keep it if it seems better. This is useful, but the idea is still repetitive and not very concrete.

package/templates/writing/prompts/judge.md

@@ -0,0 +1,15 @@
+You are comparing two versions of the same technical draft.
+
+Instructions:
+- Read both drafts closely.
+- Prefer the draft that is clearer, better structured, more concrete, and more faithful to the core idea.
+- Penalize repetition, vague claims, and weak linkage between claim and evidence.
+- If neither draft is materially better, return `"tie"`.
+- Return JSON only.
+
+Required JSON shape:
+{
+  "winner": "candidate" | "incumbent" | "tie",
+  "confidence": 0.0-1.0,
+  "rationale": "short explanation"
+}

package/templates/writing/ralph.yaml

@@ -0,0 +1,63 @@
+schemaVersion: "0.1"
+
+project:
+  name: writing-demo
+  artifact: manuscript
+  baselineRef: main
+  workspace: git
+
+scope:
+  allowedGlobs:
+    - "**/*.md"
+  maxFilesChanged: 2
+  maxLineDelta: 40
+
+proposer:
+  type: command
+  command: "node scripts/propose.mjs"
+
+experiment:
+  run:
+    command: "node scripts/experiment.mjs"
+  outputs:
+    - id: draft
+      path: out/draft.md
+
+judgePacks:
+  - id: writing-pack
+    mode: pairwise
+    blindPairwise: true
+    orderRandomized: true
+    repeats: 5
+    aggregation: majority_vote
+    judges:
+      - model: your-judge-model
+        weight: 1
+    lowConfidenceThreshold: 0.75
+    audit:
+      sampleRate: 0.1
+      freezeAutoAcceptIfAnchorFails: true
+
+metrics:
+  catalog:
+    - id: quality
+      kind: numeric
+      direction: maximize
+      extractor:
+        type: command
+        command: "node scripts/metric.mjs"
+        parser: plain_number
+
+constraints: []
+
+frontier:
+  strategy: single_best
+  primaryMetric: quality
+
+ratchet:
+  type: epsilon_improve
+  metric: quality
+  epsilon: 0
+
+storage:
+  root: .ralph

package/templates/writing/scripts/experiment.mjs

@@ -0,0 +1,6 @@
+import { cpSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+
+mkdirSync(join(process.cwd(), "out"), { recursive: true });
+cpSync(join(process.cwd(), "docs", "draft.md"), join(process.cwd(), "out", "draft.md"));
+console.log("experiment complete");

package/templates/writing/scripts/metric.mjs

@@ -0,0 +1,24 @@
+import { readFileSync } from "node:fs";
+import { join } from "node:path";
+
+const draft = readFileSync(join(process.cwd(), "out", "draft.md"), "utf8").toLowerCase();
+
+let score = 0;
+
+if (draft.includes("metric")) {
+  score += 0.3;
+}
+if (draft.includes("bounded experiment")) {
+  score += 0.3;
+}
+if (draft.includes("verified to be better")) {
+  score += 0.2;
+}
+if (draft.includes("claim and the evidence")) {
+  score += 0.1;
+}
+if (!draft.includes("it is important")) {
+  score += 0.1;
+}
+
+console.log(score.toFixed(2));

package/templates/writing/scripts/propose.mjs

@@ -0,0 +1,13 @@
+import { writeFileSync } from "node:fs";
+import { join } from "node:path";
+
+const improvedDraft = [
+  "ralph-research improves a draft through a measurable loop.",
+  "",
+  "The loop defines a metric, runs one bounded experiment, and keeps the result only when the revision is verified to be better.",
+  "",
+  "For writing workflows, that means clearer structure, tighter wording, and a more explicit connection between the claim and the evidence.",
+].join("\n");
+
+writeFileSync(join(process.cwd(), "docs", "draft.md"), improvedDraft, "utf8");
+console.log("proposal complete");