ralph-research 0.1.0 → 0.1.2

package/dist/core/state/recovery-classifier.js

@@ -0,0 +1,150 @@
+export function derivePendingAction(run) {
+    switch (run.phase) {
+        case "started":
+            return "prepare_proposal";
+        case "proposed":
+            return "execute_experiment";
+        case "executed":
+            return "evaluate_metrics";
+        case "evaluated":
+            return "write_decision";
+        case "decision_written":
+            if (run.status === "accepted") {
+                return "commit_candidate";
+            }
+            if (run.status === "needs_human") {
+                return "none";
+            }
+            return "cleanup_workspace";
+        case "committed":
+            return "update_frontier";
+        case "frontier_updated":
+            return "cleanup_workspace";
+        case "completed":
+        case "failed":
+            return "none";
+    }
+}
+export function classifyRecovery(input) {
+    const run = input.latestRun;
+    if (!run) {
+        return {
+            classification: "idle",
+            nextAction: "none",
+            reason: "no latest run exists",
+            resumeAllowed: false,
+        };
+    }
+    if (run.status === "needs_human") {
+        return {
+            classification: "manual_review_blocked",
+            nextAction: "none",
+            reason: "latest run is waiting for manual review",
+            resumeAllowed: false,
+        };
+    }
+    if (run.proposal.proposerType === "parallel") {
+        return {
+            classification: "repair_required",
+            nextAction: "none",
+            reason: "parallel proposer runs cannot be resumed truthfully yet",
+            resumeAllowed: false,
+        };
+    }
+    if (run.phase === "completed") {
+        return {
+            classification: "idle",
+            nextAction: "none",
+            reason: "latest run already completed",
+            resumeAllowed: false,
+        };
+    }
+    if (run.phase === "failed") {
+        return {
+            classification: "repair_required",
+            nextAction: "none",
+            reason: "latest run failed and requires repair before it can be trusted",
+            resumeAllowed: false,
+        };
+    }
+    const nextAction = run.pendingAction !== "none"
+        ? run.pendingAction
+        : derivePendingAction(run);
+    const evidenceFailure = findEvidenceFailure(input, nextAction);
+    if (evidenceFailure) {
+        return {
+            classification: "repair_required",
+            nextAction: "none",
+            reason: evidenceFailure,
+            resumeAllowed: false,
+        };
+    }
+    return {
+        classification: "resumable",
+        nextAction,
+        reason: `resume from ${run.phase} via ${nextAction}`,
+        resumeAllowed: true,
+    };
+}
+function findEvidenceFailure(input, nextAction) {
+    const run = input.latestRun;
+    if (!run) {
+        return "missing latest run";
+    }
+    switch (run.phase) {
+        case "started":
+            return null;
+        case "proposed":
+            if (!run.workspacePath) {
+                return "proposal checkpoint is missing a durable workspace path";
+            }
+            if (run.proposal.summary === "proposal pending") {
+                return "proposal checkpoint does not contain a durable proposal result";
+            }
+            return null;
+        case "executed":
+            if (!run.workspacePath) {
+                return "experiment checkpoint is missing a durable workspace path";
+            }
+            if (!run.logs.runStdoutPath) {
+                return "experiment checkpoint is missing execution logs";
+            }
+            return null;
+        case "evaluated":
+            if (Object.keys(run.metrics).length === 0) {
+                return "evaluation checkpoint is missing persisted metrics";
+            }
+            return null;
+        case "decision_written":
+            if (!run.decisionId) {
+                return "decision checkpoint is missing the decision identifier";
+            }
+            if (run.status === "accepted" && !run.proposal.patchPath) {
+                return "accepted decision checkpoint is missing a durable promotion patch";
+            }
+            if (run.status === "accepted" && nextAction !== "commit_candidate") {
+                return "accepted decision checkpoint has an invalid next action";
+            }
+            return null;
+        case "committed":
+            if (!run.decisionId) {
+                return "commit checkpoint is missing the decision identifier";
+            }
+            if (!input.decision?.commitSha) {
+                return "commit checkpoint is missing a durable commit sha";
+            }
+            return null;
+        case "frontier_updated":
+            if (!frontierContainsRun(input.frontier, run.runId)) {
+                return "frontier-updated checkpoint is missing persisted frontier membership";
+            }
+            return null;
+        case "completed":
+        case "failed":
+            return null;
+    }
+}
+function frontierContainsRun(frontier, runId) {
+    return frontier?.some((entry) => entry.runId === runId) ?? false;
+}
+//# sourceMappingURL=recovery-classifier.js.map

package/dist/core/state/recovery-classifier.js.map

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

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

@@ -1,5 +1,7 @@
 import { pendingActionSchema, runRecordSchema, } from "../model/run-record.js";
+import { classifyRecovery, derivePendingAction } from "./recovery-classifier.js";
 const phaseOrder = [
+    "started",
     "proposed",
     "executed",
     "evaluated",
@@ -16,16 +18,30 @@ export function advanceRunPhase(run, nextPhase, options = {}) {
         return runRecordSchema.parse(run);
     }
     const resolvedPhase = nextIndex === currentIndex ? run.phase : nextPhase;
+    const at = options.at ?? new Date().toISOString();
     const status = options.status ?? inferStatusForPhase(run.status, resolvedPhase);
-    const pendingAction = options.pendingAction ?? inferPendingAction({ ...run, status, phase: resolvedPhase });
+    const pendingAction = options.pendingAction ?? derivePendingAction({ ...run, status, phase: resolvedPhase });
+    if (resolvedPhase === run.phase
+        && status === run.status
+        && pendingAction === run.pendingAction
+        && options.decisionId === undefined
+        && options.error === undefined
+        && options.at === undefined) {
+        return runRecordSchema.parse(run);
+    }
+    const currentStepStartedAt = pendingAction !== run.pendingAction
+        ? at
+        : run.currentStepStartedAt ?? run.updatedAt ?? run.startedAt;
     const updated = runRecordSchema.parse({
         ...run,
         status,
         phase: resolvedPhase,
         pendingAction: pendingActionSchema.parse(pendingAction),
+        updatedAt: at,
+        currentStepStartedAt,
         decisionId: options.decisionId ?? run.decisionId,
         error: options.error ?? run.error,
-        endedAt: resolvedPhase === "completed" || resolvedPhase === "failed" ? options.at ?? run.endedAt ?? new Date().toISOString() : run.endedAt,
+        endedAt: resolvedPhase === "completed" || resolvedPhase === "failed" ? at : run.endedAt,
     });
     return updated;
 }
@@ -33,6 +49,13 @@ export function canResume(run) {
     return recoverRun(run).resumable;
 }
 export function recoverRun(run) {
+    if (run.status === "needs_human") {
+        return {
+            resumable: false,
+            nextAction: "none",
+            reason: "run is waiting for manual review",
+        };
+    }
     if (run.phase === "completed") {
         return {
             resumable: false,
@@ -47,15 +70,21 @@ export function recoverRun(run) {
             reason: "run failed and requires explicit intervention",
         };
     }
-    const nextAction = run.pendingAction !== "none" ? run.pendingAction : inferPendingAction(run);
+    const recovery = classifyRecovery({ latestRun: run });
+    const nextAction = run.pendingAction !== "none"
+        ? run.pendingAction
+        : derivePendingAction(run);
     return {
         resumable: nextAction !== "none",
         nextAction,
-        reason: `resume from phase ${run.phase} with action ${nextAction}`,
+        reason: recovery.classification === "repair_required"
+            ? `resume from ${run.phase} with action ${nextAction}`
+            : recovery.reason,
     };
 }
 function inferStatusForPhase(currentStatus, phase) {
     switch (phase) {
+        case "started":
         case "proposed":
         case "executed":
             return "running";
@@ -72,23 +101,4 @@ function inferStatusForPhase(currentStatus, phase) {
             return "failed";
     }
 }
-function inferPendingAction(run) {
-    switch (run.phase) {
-        case "proposed":
-            return "execute_experiment";
-        case "executed":
-            return "evaluate_metrics";
-        case "evaluated":
-            return "write_decision";
-        case "decision_written":
-            return run.status === "accepted" ? "commit_candidate" : "cleanup_workspace";
-        case "committed":
-            return "update_frontier";
-        case "frontier_updated":
-            return "cleanup_workspace";
-        case "completed":
-        case "failed":
-            return "none";
-    }
-}
 //# sourceMappingURL=run-state-machine.js.map

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

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

package/dist/core/state/stopping-target.d.ts

@@ -0,0 +1,14 @@
+import type { ComparisonOperator, RalphManifest } from "../manifest/schema.js";
+import type { FrontierEntry } from "../model/frontier-entry.js";
+import type { MetricResult } from "../model/metric.js";
+export interface StoppingTargetStatus {
+    configured: boolean;
+    met: boolean;
+    metricId?: string;
+    op?: ComparisonOperator;
+    targetValue?: number;
+    currentValue?: number;
+    direction?: MetricResult["direction"];
+    reason: string;
+}
+export declare function evaluateStoppingTarget(manifest: RalphManifest, frontier: FrontierEntry[]): StoppingTargetStatus;

package/dist/core/state/stopping-target.js

@@ -0,0 +1,67 @@
+export function evaluateStoppingTarget(manifest, frontier) {
+    const target = manifest.stopping.target;
+    if (!target) {
+        return {
+            configured: false,
+            met: false,
+            reason: "manifest does not define stopping.target",
+        };
+    }
+    const metricId = target.metric ?? getReferenceMetric(manifest);
+    const frontierMetrics = frontier
+        .map((entry) => entry.metrics[metricId])
+        .filter((metric) => Boolean(metric));
+    if (frontierMetrics.length === 0) {
+        return {
+            configured: true,
+            met: false,
+            metricId,
+            op: target.op,
+            targetValue: target.value,
+            reason: `target ${metricId} ${target.op} ${target.value} is not met because the frontier is empty`,
+        };
+    }
+    const bestMetric = frontierMetrics.reduce((best, current) => {
+        if (best.direction !== current.direction) {
+            throw new Error(`frontier metric direction mismatch for stopping target ${metricId}`);
+        }
+        if (best.direction === "maximize") {
+            return current.value > best.value ? current : best;
+        }
+        return current.value < best.value ? current : best;
+    });
+    const met = compare(bestMetric.value, target.op, target.value);
+    return {
+        configured: true,
+        met,
+        metricId,
+        op: target.op,
+        targetValue: target.value,
+        currentValue: bestMetric.value,
+        direction: bestMetric.direction,
+        reason: met
+            ? `target met: ${metricId}=${bestMetric.value} ${target.op} ${target.value}`
+            : `target pending: ${metricId}=${bestMetric.value} does not satisfy ${target.op} ${target.value}`,
+    };
+}
+function compare(actual, op, expected) {
+    switch (op) {
+        case ">=":
+            return actual >= expected;
+        case ">":
+            return actual > expected;
+        case "<=":
+            return actual <= expected;
+        case "<":
+            return actual < expected;
+        case "==":
+            return actual === expected;
+    }
+}
+function getReferenceMetric(manifest) {
+    if (manifest.frontier.strategy === "single_best") {
+        return manifest.frontier.primaryMetric;
+    }
+    return manifest.frontier.objectives[0].metric;
+}
+//# sourceMappingURL=stopping-target.js.map

package/dist/core/state/stopping-target.js.map

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

package/dist/mcp/server.js

@@ -3,45 +3,39 @@ 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";
+import { RunLoopService } from "../app/services/run-loop-service.js";
 export function createRalphResearchMcpServer(options = {}) {
     const defaultRepoRoot = resolve(options.repoRoot ?? process.cwd());
     const server = new McpServer({
         name: "ralph-research",
-        version: "0.1.0",
+        version: "0.1.2",
     });
     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."),
+            cycles: z.number().int().min(1).max(100).optional().describe("Exact cycle count, or a max-cycle cap when used with progressive stop flags."),
+            untilTarget: z.boolean().default(false).describe("Keep running until manifest.stopping.target is met."),
+            untilNoImprove: z.number().int().min(1).max(100).optional().describe("Stop after N consecutive cycles without frontier improvement."),
+            fresh: z.boolean().default(false).describe("Start a fresh run instead of auto-resuming the latest recoverable run."),
         },
-    }, async ({ repoRoot, manifestPath, cycles = 1, resume = false }) => {
-        const service = new RunCycleService();
+    }, async ({ repoRoot, manifestPath, cycles, untilTarget = false, untilNoImprove, fresh = false }) => {
+        const service = new RunLoopService();
         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;
-            }
-        }
+        const result = await service.run({
+            repoRoot: resolvedRepoRoot,
+            ...(manifestPath ? { manifestPath } : {}),
+            ...(cycles === undefined ? {} : { cycles }),
+            ...(untilTarget ? { untilTarget } : {}),
+            ...(untilNoImprove === undefined ? {} : { untilNoImprove }),
+            fresh,
+        });
         return {
             content: [
                 {
                     type: "text",
-                    text: JSON.stringify({
-                        ok: results.every((result) => result.status !== "failed" && result.status !== "resume_required"),
-                        cycles,
-                        results,
-                    }, null, 2),
+                    text: JSON.stringify(result, null, 2),
                 },
             ],
         };

package/dist/mcp/server.js.map

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

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "ralph-research",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Local-first runtime for recursive research improvement.",
   "type": "module",
   "bin": {
-    "rrx": "./dist/cli/main.js"
+    "rrx": "dist/cli/main.js"
   },
   "files": [
     "dist",

package/templates/writing/ralph.yaml

@@ -59,5 +59,12 @@ ratchet:
   metric: quality
   epsilon: 0
 
+# Optional progressive-stop contract:
+# stopping:
+#   target:
+#     metric: quality
+#     op: ">="
+#     value: 0.8
+
 storage:
   root: .ralph