opencodekit 0.14.3 → 0.14.5

package/dist/template/.opencode/plugin/ralph-wiggum.ts

@@ -1,182 +0,0 @@
-/**
- * Ralph Wiggum Plugin for OpenCode
- *
- * Handles the session.idle event to continue the Ralph loop.
- * Tools are defined separately in .opencode/tool/ralph.ts
- *
- * Based on: https://ghuntley.com/ralph/
- */
-
-import fs from "node:fs/promises";
-import type { Plugin } from "@opencode-ai/plugin";
-
-const STATE_FILE = ".opencode/.ralph-state.json";
-const IDLE_DEBOUNCE_MS = 2000;
-let lastIdleTime = 0;
-
-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";
-}
-
-async function loadState(): Promise<RalphState | null> {
-	try {
-		const content = await fs.readFile(STATE_FILE, "utf-8");
-		return JSON.parse(content);
-	} catch {
-		return null;
-	}
-}
-
-async function saveState(state: RalphState): Promise<void> {
-	await fs.writeFile(STATE_FILE, JSON.stringify(state, null, 2));
-}
-
-async function resetState(): Promise<void> {
-	try {
-		await fs.unlink(STATE_FILE);
-	} catch {
-		// File doesn't exist, that's fine
-	}
-}
-
-export const RalphWiggum: Plugin = async ({ client }) => {
-	const log = async (
-		message: string,
-		level: "info" | "warn" | "error" = "info",
-	) => {
-		await client.app
-			.log({
-				body: { service: "ralph-wiggum", level, message },
-			})
-			.catch(() => {});
-	};
-
-	const showToast = async (
-		title: string,
-		message: string,
-		variant: "info" | "success" | "warning" | "error" = "info",
-	) => {
-		await client.tui
-			.showToast({
-				body: {
-					title: `Ralph: ${title}`,
-					message,
-					variant,
-					duration: variant === "error" ? 8000 : 5000,
-				},
-			})
-			.catch(() => {});
-	};
-
-	const buildContinuationPrompt = (state: RalphState): string => {
-		const prdRef = state.prdFile ? `@${state.prdFile} ` : "";
-		const progressRef = `@${state.progressFile}`;
-
-		return `
-${prdRef}${progressRef}
-
-## Ralph Wiggum Loop - Iteration ${state.iteration}/${state.maxIterations}
-
-You are in an autonomous loop. Continue working on the task.
-
-**Task:** ${state.task}
-
-**Instructions:**
-1. Review the PRD/task list and progress file
-2. Choose the highest-priority INCOMPLETE task
-3. Implement ONE feature/change only
-4. Run feedback loops: typecheck, test, lint
-5. Commit if all pass
-6. Update ${state.progressFile}
-7. If ALL tasks complete, output: ${state.completionPromise}
-
-**Constraints:** ONE feature per iteration. Quality over speed.
-`.trim();
-	};
-
-	const handleSessionIdle = async (sessionID: string): Promise<void> => {
-		const now = Date.now();
-		if (now - lastIdleTime < IDLE_DEBOUNCE_MS) return;
-		lastIdleTime = now;
-
-		const state = await loadState();
-		if (!state?.active || state.sessionID !== sessionID) return;
-
-		try {
-			const messagesResponse = await client.session.messages({
-				path: { id: sessionID },
-			});
-			const messages = messagesResponse.data || [];
-			const lastMessage = messages[messages.length - 1];
-
-			const lastText =
-				lastMessage?.parts
-					?.filter((p) => p.type === "text")
-					.map((p) => ("text" in p ? (p.text as string) : ""))
-					.join("") || "";
-
-			if (lastText.includes(state.completionPromise)) {
-				const duration = state.startedAt
-					? Math.round((Date.now() - state.startedAt) / 1000 / 60)
-					: 0;
-				await showToast(
-					"Complete!",
-					`Finished in ${state.iteration} iterations (${duration} min)`,
-					"success",
-				);
-				await log(`Loop completed in ${state.iteration} iterations`);
-				await resetState();
-				return;
-			}
-
-			state.iteration++;
-			if (state.iteration >= state.maxIterations) {
-				await showToast(
-					"Stopped",
-					`Max iterations (${state.maxIterations}) reached`,
-					"warning",
-				);
-				await log(`Max iterations reached: ${state.maxIterations}`, "warn");
-				await resetState();
-				return;
-			}
-
-			await saveState(state);
-
-			await client.session.prompt({
-				path: { id: sessionID },
-				body: {
-					parts: [{ type: "text", text: buildContinuationPrompt(state) }],
-				},
-			});
-
-			await log(`Iteration ${state.iteration}/${state.maxIterations}`);
-		} catch (error) {
-			await log(`Error in Ralph loop: ${error}`, "error");
-			await resetState();
-		}
-	};
-
-	return {
-		event: async ({ event }) => {
-			if (event.type === "session.idle") {
-				const sessionID = (event as { properties?: { sessionID?: string } })
-					.properties?.sessionID;
-				if (sessionID) {
-					await handleSessionIdle(sessionID);
-				}
-			}
-		},
-	};
-};
-
-export default RalphWiggum;

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

@@ -1,203 +0,0 @@
-/**
- * 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();
-	},
-});