agentic-forge 0.0.0 → 0.7.1

package/src/ralph-loop.ts

@@ -1,260 +0,0 @@
-/** Ralph Wiggum loop state management and completion detection. */
-
-import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync } from "node:fs";
-import path from "node:path";
-import yaml from "js-yaml";
-
-// --- Types ---
-
-export interface RalphLoopState {
-	active: boolean;
-	iteration: number;
-	maxIterations: number;
-	completionPromise: string;
-	startedAt: string;
-	prompt: string;
-}
-
-export interface CompletionResult {
-	isComplete: boolean;
-	promiseMatched: boolean;
-	promiseValue: string | null;
-	output: string;
-	isFailed: boolean;
-	failureReason: string | null;
-}
-
-// --- State path ---
-
-export function getRalphStatePath(workflowId: string, stepName: string, repoRoot: string): string {
-	const safeName = stepName.replace(/[^\w-]/g, "_");
-	return path.join(repoRoot, "agentic", "outputs", workflowId, `ralph-${safeName}.md`);
-}
-
-// --- State management ---
-
-export function createRalphState(
-	workflowId: string,
-	stepName: string,
-	prompt: string,
-	maxIterations: number,
-	completionPromise: string,
-	repoRoot: string,
-): RalphLoopState {
-	const state: RalphLoopState = {
-		active: true,
-		iteration: 1,
-		maxIterations,
-		completionPromise,
-		startedAt: new Date().toISOString(),
-		prompt,
-	};
-
-	saveRalphState(workflowId, stepName, state, repoRoot);
-	return state;
-}
-
-export function loadRalphState(
-	workflowId: string,
-	stepName: string,
-	repoRoot: string,
-): RalphLoopState | null {
-	const statePath = getRalphStatePath(workflowId, stepName, repoRoot);
-	if (!existsSync(statePath)) return null;
-
-	const content = readFileSync(statePath, "utf-8");
-	return parseRalphState(content);
-}
-
-export function updateRalphIteration(
-	workflowId: string,
-	stepName: string,
-	repoRoot: string,
-): RalphLoopState | null {
-	const state = loadRalphState(workflowId, stepName, repoRoot);
-	if (!state) return null;
-
-	state.iteration += 1;
-	saveRalphState(workflowId, stepName, state, repoRoot);
-	return state;
-}
-
-export function deactivateRalphState(workflowId: string, stepName: string, repoRoot: string): void {
-	const state = loadRalphState(workflowId, stepName, repoRoot);
-	if (state) {
-		state.active = false;
-		saveRalphState(workflowId, stepName, state, repoRoot);
-	}
-}
-
-export function deleteRalphState(workflowId: string, stepName: string, repoRoot: string): void {
-	const statePath = getRalphStatePath(workflowId, stepName, repoRoot);
-	if (existsSync(statePath)) {
-		unlinkSync(statePath);
-	}
-}
-
-// --- Internal helpers ---
-
-function saveRalphState(
-	workflowId: string,
-	stepName: string,
-	state: RalphLoopState,
-	repoRoot: string,
-): void {
-	const statePath = getRalphStatePath(workflowId, stepName, repoRoot);
-	const dir = path.dirname(statePath);
-	mkdirSync(dir, { recursive: true });
-
-	const frontmatter = {
-		active: state.active,
-		iteration: state.iteration,
-		max_iterations: state.maxIterations,
-		completion_promise: state.completionPromise,
-		started_at: state.startedAt,
-	};
-
-	const yamlStr = yaml.dump(frontmatter, { flowLevel: -1 }).trim();
-	const content = `---
-${yamlStr}
----
-
-# Ralph Loop Prompt
-
-${state.prompt}
-`;
-
-	writeFileSync(statePath, content, "utf-8");
-}
-
-export function parseRalphState(content: string): RalphLoopState | null {
-	if (!content.startsWith("---")) return null;
-
-	const parts = content.split("---");
-	if (parts.length < 3) return null;
-
-	let frontmatter: Record<string, unknown>;
-	try {
-		frontmatter = yaml.load(parts[1]) as Record<string, unknown>;
-	} catch {
-		return null;
-	}
-
-	const promptSection = parts.slice(2).join("---").trim();
-	let prompt: string;
-	if (promptSection.includes("# Ralph Loop Prompt")) {
-		prompt = promptSection.split("# Ralph Loop Prompt")[1].trim();
-	} else {
-		prompt = promptSection;
-	}
-
-	return {
-		active: (frontmatter.active as boolean) ?? false,
-		iteration: (frontmatter.iteration as number) ?? 1,
-		maxIterations: (frontmatter.max_iterations as number) ?? 5,
-		completionPromise: (frontmatter.completion_promise as string) ?? "COMPLETE",
-		startedAt: (frontmatter.started_at as string) ?? "",
-		prompt,
-	};
-}
-
-// --- Completion detection ---
-
-export function detectCompletionPromise(output: string, expectedPromise: string): CompletionResult {
-	const jsonPatterns = [
-		/```json\s*\n?(.*?)\n?```/gis,
-		/```\s*\n?(\{.*?\})\n?```/gis,
-		/(\{[^{}]*"ralph_complete"[^{}]*\})/gi,
-		/(\{[^{}]*"ralph_failed"[^{}]*\})/gi,
-	];
-
-	for (const pattern of jsonPatterns) {
-		pattern.lastIndex = 0;
-		const matches = [...output.matchAll(pattern)];
-		for (const match of matches) {
-			try {
-				const data = JSON.parse(match[1].trim());
-				if (typeof data !== "object" || data === null) continue;
-
-				// Check for completion signal
-				if (data.ralph_complete) {
-					const promiseValue = String(data.promise ?? "");
-					const promiseMatched =
-						promiseValue.trim().toUpperCase() === expectedPromise.trim().toUpperCase();
-					return {
-						isComplete: true,
-						promiseMatched,
-						promiseValue,
-						output,
-						isFailed: false,
-						failureReason: null,
-					};
-				}
-
-				// Check for failure signal
-				if (data.ralph_failed) {
-					const failureReason = String(data.reason ?? "Unknown error");
-					return {
-						isComplete: true,
-						promiseMatched: false,
-						promiseValue: null,
-						output,
-						isFailed: true,
-						failureReason,
-					};
-				}
-			} catch {
-				// Invalid JSON, skip
-			}
-		}
-	}
-
-	return {
-		isComplete: false,
-		promiseMatched: false,
-		promiseValue: null,
-		output,
-		isFailed: false,
-		failureReason: null,
-	};
-}
-
-// --- System message builder ---
-
-export function buildRalphSystemMessage(
-	iteration: number,
-	maxIterations: number,
-	completionPromise: string,
-): string {
-	return `## Ralph Wiggum Loop - Iteration ${iteration}/${maxIterations}
-
-You are in a Ralph Wiggum iterative loop. Each iteration starts a fresh session.
-
-**Completion Signal:**
-When your task is FULLY complete, output a JSON block:
-\`\`\`json
-{
-  "ralph_complete": true,
-  "promise": "${completionPromise}"
-}
-\`\`\`
-
-**Failure Signal:**
-If you encounter a BLOCKING error that prevents completion (e.g., missing permissions, cannot write files, access denied), output a failure JSON block:
-\`\`\`json
-{
-  "ralph_failed": true,
-  "reason": "<brief description of the blocking error>"
-}
-\`\`\`
-
-**IMPORTANT:**
-- Only output the completion JSON when the task is genuinely finished
-- Do not output false promises to exit early
-- Output the FAILURE JSON immediately if you encounter permission errors or other unrecoverable blocking issues - do NOT continue iterating
-- If the task is incomplete but can still progress, continue working - you have ${maxIterations - iteration} iterations remaining
-
----
-
-`;
-}

package/src/renderer.ts

@@ -1,164 +0,0 @@
-/** Nunjucks template rendering for workflows. */
-
-import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import path from "node:path";
-import { fileURLToPath } from "node:url";
-import nunjucks from "nunjucks";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-/** Set of variable names already warned about (reset per render). */
-const warnedVars = new Set<string>();
-
-/**
- * Custom nunjucks loader that warns on undefined variables instead of failing.
- * Returns the original `{{ variable_name }}` syntax for undefined variables.
- */
-function createLenientEnvironment(templateDirs: string[]): nunjucks.Environment {
-	const loader = new nunjucks.FileSystemLoader(templateDirs, { noCache: true });
-	const env = new nunjucks.Environment(loader, { autoescape: false });
-
-	// Install a global that intercepts missing variables
-	// Nunjucks doesn't have a direct WarnOnUndefined equivalent,
-	// so we use a custom extension approach
-	return env;
-}
-
-function createStrictEnvironment(templateDirs: string[]): nunjucks.Environment {
-	const loader = new nunjucks.FileSystemLoader(templateDirs, { noCache: true });
-	return new nunjucks.Environment(loader, {
-		autoescape: false,
-		throwOnUndefined: true,
-	});
-}
-
-export class TemplateRenderer {
-	templateDirs: string[];
-	strictMode: boolean;
-	private env: nunjucks.Environment;
-
-	constructor(templateDirs?: string[], strictMode = false) {
-		const dirs = templateDirs ?? [path.join(__dirname, "templates")];
-
-		this.templateDirs = dirs;
-		this.strictMode = strictMode;
-
-		const existingDirs = dirs.filter((d) => existsSync(d));
-		this.env = strictMode
-			? createStrictEnvironment(existingDirs)
-			: createLenientEnvironment(existingDirs);
-	}
-
-	render(templateName: string, context: Record<string, unknown>): string {
-		if (!this.strictMode) {
-			warnedVars.clear();
-		}
-		return this.env.render(templateName, context);
-	}
-
-	renderString(templateStr: string, context: Record<string, unknown>): string {
-		if (!this.strictMode) {
-			warnedVars.clear();
-		}
-		return this.env.renderString(templateStr, context);
-	}
-
-	hasVariables(text: string): boolean {
-		return text.includes("{{") || text.includes("{%");
-	}
-
-	addTemplateDir(dirPath: string): void {
-		if (existsSync(dirPath) && !this.templateDirs.includes(dirPath)) {
-			this.templateDirs.push(dirPath);
-			const existingDirs = this.templateDirs.filter((d) => existsSync(d));
-			this.env = this.strictMode
-				? createStrictEnvironment(existingDirs)
-				: createLenientEnvironment(existingDirs);
-		}
-	}
-}
-
-// --- Helper functions ---
-
-const ANALYSIS_TYPES = ["bug", "debt", "doc", "security", "style"];
-
-export function extractAnalysisSteps(
-	stepOutputs: Record<string, Record<string, unknown>>,
-): Record<string, Record<string, unknown>> {
-	const result: Record<string, Record<string, unknown>> = {};
-	for (const [name, data] of Object.entries(stepOutputs)) {
-		if (name.startsWith("analyze-")) {
-			const analysisType = name.slice("analyze-".length);
-			if (ANALYSIS_TYPES.includes(analysisType)) {
-				result[name] = data;
-			}
-		}
-	}
-	return result;
-}
-
-export function extractFixSteps(
-	stepOutputs: Record<string, Record<string, unknown>>,
-): Record<string, Record<string, unknown>> {
-	const result: Record<string, Record<string, unknown>> = {};
-	for (const [name, data] of Object.entries(stepOutputs)) {
-		if (name.startsWith("fix-") || name.startsWith("apply-")) {
-			result[name] = data;
-		}
-	}
-	return result;
-}
-
-export function buildTemplateContext(
-	workflowName: string,
-	workflowId: string,
-	startedAt: string,
-	completedAt: string | null,
-	stepOutputs: Record<string, Record<string, unknown>>,
-	filesChanged: string[],
-	branches: string[],
-	pullRequests: Record<string, unknown>[],
-	inputs: Record<string, unknown>,
-): Record<string, unknown> {
-	const analysisSteps = extractAnalysisSteps(stepOutputs);
-	const fixSteps = extractFixSteps(stepOutputs);
-
-	return {
-		workflow: {
-			name: workflowName,
-			id: workflowId,
-			started_at: startedAt,
-			completed_at: completedAt,
-		},
-		workflow_id: workflowId,
-		steps: stepOutputs,
-		analysis_steps: analysisSteps,
-		fix_steps: fixSteps,
-		files_changed: filesChanged,
-		branches,
-		pull_requests: pullRequests,
-		inputs,
-	};
-}
-
-export function renderWorkflowOutput(
-	templatePath: string,
-	outputPath: string,
-	context: Record<string, unknown>,
-	templateDirs?: string[],
-	strictMode = false,
-): void {
-	const renderer = new TemplateRenderer(templateDirs, strictMode);
-
-	let rendered: string;
-	if (path.isAbsolute(templatePath)) {
-		const content = readFileSync(templatePath, "utf-8");
-		rendered = renderer.renderString(content, context);
-	} else {
-		rendered = renderer.render(templatePath, context);
-	}
-
-	const dir = path.dirname(outputPath);
-	mkdirSync(dir, { recursive: true });
-	writeFileSync(outputPath, rendered, "utf-8");
-}