opencodekit 0.14.1 → 0.14.2

package/dist/template/.opencode/tool/ralph.ts

@@ -0,0 +1,203 @@
+/**
+ * Ralph Wiggum Tools
+ *
+ * Standalone tools for the Ralph Wiggum autonomous loop pattern.
+ * The plugin (ralph-wiggum.ts) handles event listening, these handle user interaction.
+ */
+
+import fs from "node:fs/promises";
+import path from "node:path";
+import { tool } from "@opencode-ai/plugin";
+
+const STATE_FILE = ".opencode/.ralph-state.json";
+
+interface RalphState {
+	active: boolean;
+	sessionID: string | null;
+	iteration: number;
+	maxIterations: number;
+	completionPromise: string;
+	task: string;
+	prdFile: string | null;
+	progressFile: string;
+	startedAt: number | null;
+	mode: "hitl" | "afk";
+}
+
+const DEFAULT_STATE: RalphState = {
+	active: false,
+	sessionID: null,
+	iteration: 0,
+	maxIterations: 50,
+	completionPromise: "<promise>COMPLETE</promise>",
+	task: "",
+	prdFile: null,
+	progressFile: "progress.txt",
+	startedAt: null,
+	mode: "hitl",
+};
+
+async function loadState(): Promise<RalphState> {
+	try {
+		const content = await fs.readFile(STATE_FILE, "utf-8");
+		return JSON.parse(content);
+	} catch {
+		return { ...DEFAULT_STATE };
+	}
+}
+
+async function saveState(state: RalphState): Promise<void> {
+	await fs.mkdir(path.dirname(STATE_FILE), { recursive: true });
+	await fs.writeFile(STATE_FILE, JSON.stringify(state, null, 2));
+}
+
+/**
+ * Start Ralph Wiggum autonomous loop
+ */
+export const ralph_start = tool({
+	description:
+		"Start Ralph Wiggum autonomous loop. Agent will work on tasks until completion or max iterations.",
+	args: {
+		task: tool.schema
+			.string()
+			.describe(
+				"Task description or goal (e.g., 'Migrate all Jest tests to Vitest')",
+			),
+		prdFile: tool.schema
+			.string()
+			.optional()
+			.describe("Path to PRD/task list file (e.g., 'PRD.md')"),
+		progressFile: tool.schema
+			.string()
+			.optional()
+			.describe("Path to progress tracking file (default: progress.txt)"),
+		completionPromise: tool.schema
+			.string()
+			.optional()
+			.describe(
+				"Text to output when done (default: <promise>COMPLETE</promise>)",
+			),
+		maxIterations: tool.schema
+			.number()
+			.optional()
+			.describe("Maximum iterations before stopping (default: 50)"),
+		mode: tool.schema
+			.enum(["hitl", "afk"])
+			.optional()
+			.describe("Mode: hitl (human-in-the-loop) or afk (away-from-keyboard)"),
+	},
+	execute: async (args, context) => {
+		const state: RalphState = {
+			active: true,
+			sessionID: context.sessionID,
+			iteration: 0,
+			maxIterations: args.maxIterations || 50,
+			completionPromise:
+				args.completionPromise || "<promise>COMPLETE</promise>",
+			task: args.task,
+			prdFile: args.prdFile || null,
+			progressFile: args.progressFile || "progress.txt",
+			startedAt: Date.now(),
+			mode: args.mode || "hitl",
+		};
+
+		await saveState(state);
+
+		const modeDesc =
+			state.mode === "hitl"
+				? "Human-in-the-loop (watch and intervene)"
+				: "Away-from-keyboard (autonomous)";
+
+		return `
+## Ralph Loop Active
+
+**Task:** ${state.task}
+**Mode:** ${modeDesc}
+**Max Iterations:** ${state.maxIterations}
+**Completion Signal:** ${state.completionPromise}
+**PRD File:** ${state.prdFile || "(none - using task description)"}
+**Progress File:** ${state.progressFile}
+
+### Next Steps
+
+1. Work on the task described above
+2. After each feature, update ${state.progressFile}
+3. Run feedback loops (typecheck, test, lint)
+4. Commit changes
+5. When ALL tasks complete, output: ${state.completionPromise}
+
+The loop will continue automatically after each completion until:
+- You output the completion promise, OR
+- Max iterations (${state.maxIterations}) reached
+
+**Remember:** ONE feature per iteration. Small steps. Quality over speed.
+`.trim();
+	},
+});
+
+/**
+ * Stop Ralph Wiggum loop
+ */
+export const ralph_stop = tool({
+	description: "Stop the Ralph Wiggum loop gracefully",
+	args: {
+		reason: tool.schema.string().optional().describe("Reason for stopping"),
+	},
+	execute: async (args) => {
+		const state = await loadState();
+
+		if (!state.active) {
+			return "No Ralph loop is currently running.";
+		}
+
+		const duration = state.startedAt
+			? Math.round((Date.now() - state.startedAt) / 1000 / 60)
+			: 0;
+
+		const summary = `
+## Ralph Loop Stopped
+
+**Iterations Completed:** ${state.iteration}
+**Duration:** ${duration} minutes
+**Reason:** ${args.reason || "Manual stop requested"}
+**Task:** ${state.task}
+
+Progress has been saved to ${state.progressFile}.
+`.trim();
+
+		// Reset state
+		await saveState(DEFAULT_STATE);
+
+		return summary;
+	},
+});
+
+/**
+ * Get Ralph Wiggum status
+ */
+export const ralph_status = tool({
+	description: "Get current Ralph Wiggum loop status",
+	args: {},
+	execute: async () => {
+		const state = await loadState();
+
+		if (!state.active) {
+			return "No Ralph loop is currently active.";
+		}
+
+		const duration = state.startedAt
+			? Math.round((Date.now() - state.startedAt) / 1000 / 60)
+			: 0;
+
+		return `
+## Ralph Loop Active
+
+**Task:** ${state.task}
+**Iteration:** ${state.iteration}/${state.maxIterations}
+**Duration:** ${duration} minutes
+**Mode:** ${state.mode}
+**Completion Signal:** ${state.completionPromise}
+**Progress File:** ${state.progressFile}
+`.trim();
+	},
+});

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "opencodekit",
-	"version": "0.14.1",
+	"version": "0.14.2",
 	"description": "CLI tool for bootstrapping and managing OpenCodeKit projects",
 	"type": "module",
 	"repository": {