agentic-forge 0.0.0 → 0.7.1

package/src/steps/ralph-loop-step.ts

@@ -1,186 +0,0 @@
-/** Ralph loop step executor. */
-
-import type { ConsoleOutput } from "../console.js";
-import { extractSummary } from "../console.js";
-import type { WorkflowLogger } from "../logging/logger.js";
-import { WORKFLOW_STATUS, updateStepCompleted, updateStepFailed } from "../progress.js";
-import {
-	buildRalphSystemMessage,
-	createRalphState,
-	deactivateRalphState,
-	detectCompletionPromise,
-	loadRalphState,
-	updateRalphIteration,
-} from "../ralph-loop.js";
-import { runClaude } from "../runner.js";
-import type { StepDefinition, WorkflowProgress } from "../types.js";
-import {
-	type StepContext,
-	StepExecutor,
-	type StepResult,
-	buildTemplateContext,
-	resolveModel,
-} from "./base.js";
-
-export class RalphLoopStepExecutor extends StepExecutor {
-	async execute(
-		step: StepDefinition,
-		progress: WorkflowProgress,
-		context: StepContext,
-		logger: WorkflowLogger,
-		console: ConsoleOutput,
-	): Promise<StepResult> {
-		const promptTemplate = step.prompt ?? "";
-		const templateContext = buildTemplateContext(context);
-
-		let completionPromise = step.completionPromise ?? "COMPLETE";
-		if (context.renderer.hasVariables(completionPromise)) {
-			completionPromise = context.renderer.renderString(completionPromise, templateContext);
-		}
-
-		// Handle max_iterations which may be a template string or integer
-		const maxIterationsRaw = step.maxIterations;
-		let maxIterations: number;
-		if (typeof maxIterationsRaw === "string" && context.renderer.hasVariables(maxIterationsRaw)) {
-			maxIterations = Number.parseInt(
-				context.renderer.renderString(maxIterationsRaw, templateContext),
-				10,
-			);
-		} else {
-			maxIterations = maxIterationsRaw ? Number.parseInt(String(maxIterationsRaw), 10) : 5;
-		}
-
-		const timeout = (step.stepTimeoutMinutes ?? 30) * 60;
-		const bypassPermissions = context.workflowSettings?.bypassPermissions ?? false;
-		const allowedTools = context.workflowSettings?.requiredTools?.length
-			? context.workflowSettings.requiredTools
-			: null;
-
-		// Always enable streaming when console is provided
-		const printOutput = true;
-
-		logger.info(step.name, `Starting Ralph loop (max ${maxIterations} iterations)`);
-		console.info(`Ralph loop starting (max ${maxIterations} iterations)`);
-
-		const allOutputs: string[] = [];
-
-		// Check for existing ralph state to resume from
-		const existingState = loadRalphState(progress.workflowId, step.name, context.repoRoot);
-		let startIteration: number;
-		if (existingState?.active) {
-			startIteration = existingState.iteration;
-			logger.info(step.name, `Resuming Ralph loop from iteration ${startIteration}`);
-			console.info(`Resuming Ralph loop from iteration ${startIteration}`);
-		} else {
-			startIteration = 1;
-		}
-
-		for (let iteration = startIteration; iteration <= maxIterations; iteration++) {
-			logger.info(step.name, `Ralph loop iteration ${iteration}/${maxIterations}`);
-
-			// Render prompt with iteration context
-			const iterationContext = {
-				...templateContext,
-				iteration,
-				max_iterations: maxIterations,
-			};
-			let prompt: string;
-			if (context.renderer.hasVariables(promptTemplate)) {
-				prompt = context.renderer.renderString(promptTemplate, iterationContext);
-			} else {
-				prompt = promptTemplate;
-			}
-
-			// Create ralph state on first iteration
-			if (iteration === startIteration && !existingState?.active) {
-				createRalphState(
-					progress.workflowId,
-					step.name,
-					prompt,
-					maxIterations,
-					completionPromise,
-					context.repoRoot,
-				);
-			}
-
-			const systemMessage = buildRalphSystemMessage(iteration, maxIterations, completionPromise);
-			const fullPrompt = `${systemMessage}${prompt}`;
-
-			// Display iteration header BEFORE running Claude
-			console.ralphIterationStart(step.name, iteration, maxIterations);
-
-			const result = await runClaude({
-				prompt: fullPrompt,
-				cwd: context.repoRoot,
-				model: resolveModel(context, step.model),
-				timeout,
-				printOutput,
-				skipPermissions: bypassPermissions,
-				allowedTools,
-				console,
-				workflowId: context.workflowId,
-			});
-
-			if (!result.success) {
-				const errorSummary = result.stderr ? extractSummary(result.stderr) : "Unknown error";
-				logger.warning(step.name, `Iteration ${iteration} failed: ${result.stderr}`);
-				console.ralphIteration(step.name, iteration, maxIterations, `Failed: ${errorSummary}`);
-				if (iteration < maxIterations) {
-					updateRalphIteration(progress.workflowId, step.name, context.repoRoot);
-					continue;
-				}
-				deactivateRalphState(progress.workflowId, step.name, context.repoRoot);
-				const errorMsg = `Ralph loop failed after ${maxIterations} iterations`;
-				console.stepFailed(step.name, errorMsg);
-				updateStepFailed(progress, step.name, errorMsg);
-				progress.status = WORKFLOW_STATUS.FAILED;
-				return { success: false, error: errorMsg };
-			}
-
-			allOutputs.push(result.stdout);
-
-			// Print iteration summary
-			const iterationSummary = extractSummary(result.stdout);
-			console.ralphIteration(step.name, iteration, maxIterations, iterationSummary);
-
-			const completionResult = detectCompletionPromise(result.stdout, completionPromise);
-
-			// Check for failure signal first
-			if (completionResult.isFailed) {
-				const errorMsg = `Ralph loop failed: ${completionResult.failureReason}`;
-				logger.error(step.name, errorMsg);
-				deactivateRalphState(progress.workflowId, step.name, context.repoRoot);
-				const combinedOutput = allOutputs.join("\n\n---\n\n");
-				console.stepFailed(step.name, errorMsg);
-				updateStepFailed(progress, step.name, errorMsg);
-				progress.status = WORKFLOW_STATUS.FAILED;
-				return { success: false, error: errorMsg, fullOutput: combinedOutput };
-			}
-
-			if (completionResult.isComplete && completionResult.promiseMatched) {
-				logger.info(step.name, `Ralph loop completed at iteration ${iteration}`);
-				deactivateRalphState(progress.workflowId, step.name, context.repoRoot);
-				const combinedOutput = allOutputs.join("\n\n---\n\n");
-				const outputSummary = `Completed in ${iteration} iterations`;
-				updateStepCompleted(progress, step.name, outputSummary, combinedOutput);
-				console.ralphComplete(step.name, iteration, maxIterations);
-				return { success: true, outputSummary, fullOutput: combinedOutput };
-			}
-
-			if (iteration < maxIterations) {
-				updateRalphIteration(progress.workflowId, step.name, context.repoRoot);
-			}
-		}
-
-		logger.warning(
-			step.name,
-			`Ralph loop reached max iterations (${maxIterations}) without completion`,
-		);
-		deactivateRalphState(progress.workflowId, step.name, context.repoRoot);
-		const combinedOutput = allOutputs.join("\n\n---\n\n");
-		const outputSummary = `Max iterations (${maxIterations}) reached without completion promise`;
-		updateStepCompleted(progress, step.name, outputSummary, combinedOutput);
-		console.ralphMaxIterations(step.name, maxIterations);
-		return { success: true, outputSummary, fullOutput: combinedOutput };
-	}
-}

package/src/steps/serial-step.ts

@@ -1,84 +0,0 @@
-/** Serial step executor. */
-
-import type { ConsoleOutput } from "../console.js";
-import type { WorkflowLogger } from "../logging/logger.js";
-import { WORKFLOW_STATUS, updateStepCompleted, updateStepFailed } from "../progress.js";
-import type { StepDefinition, WorkflowProgress } from "../types.js";
-import {
-	type BranchStepExecutor,
-	type StepContext,
-	StepExecutor,
-	type StepResult,
-} from "./base.js";
-
-export class SerialStepExecutor extends StepExecutor {
-	constructor(private branchExecutor: BranchStepExecutor) {
-		super();
-	}
-
-	async execute(
-		step: StepDefinition,
-		progress: WorkflowProgress,
-		context: StepContext,
-		logger: WorkflowLogger,
-		console: ConsoleOutput,
-	): Promise<StepResult> {
-		if (!step.steps || step.steps.length === 0) {
-			logger.warning(step.name, "Serial step has no sub-steps");
-			updateStepCompleted(progress, step.name, "No sub-steps to execute");
-			console.stepComplete(step.name, "No sub-steps to execute");
-			return { success: true, outputSummary: "No sub-steps to execute" };
-		}
-
-		logger.info(step.name, `Starting serial execution of ${step.steps.length} steps`);
-		console.info(`Serial: executing ${step.steps.length} steps in sequence`);
-
-		let completedCount = 0;
-
-		for (const subStep of step.steps) {
-			try {
-				const result = await this.branchExecutor(subStep, progress, context, logger, console);
-
-				if (!result.success) {
-					logger.warning(
-						step.name,
-						`Serial block stopped at step '${subStep.name}' due to failure`,
-					);
-					const errorMsg = `Step '${subStep.name}' failed: ${result.error}`;
-					updateStepFailed(progress, step.name, errorMsg);
-					console.stepFailed(step.name, `Step '${subStep.name}' failed`);
-					progress.status = WORKFLOW_STATUS.FAILED;
-					return { success: false, error: errorMsg };
-				}
-
-				completedCount++;
-
-				if (progress.status === WORKFLOW_STATUS.FAILED) {
-					logger.warning(
-						step.name,
-						`Serial block stopped at step '${subStep.name}' due to failure`,
-					);
-					break;
-				}
-			} catch (e) {
-				const errStr = e instanceof Error ? e.message : String(e);
-				logger.error(subStep.name, `Step failed in serial block: ${errStr}`);
-				const errorMsg = `Step '${subStep.name}' failed: ${errStr}`;
-				updateStepFailed(progress, step.name, errorMsg);
-				console.stepFailed(step.name, `Step '${subStep.name}' failed`);
-				progress.status = WORKFLOW_STATUS.FAILED;
-				return { success: false, error: errorMsg };
-			}
-		}
-
-		if (progress.status !== WORKFLOW_STATUS.FAILED) {
-			const outputSummary = `Completed ${completedCount}/${step.steps.length} steps`;
-			updateStepCompleted(progress, step.name, outputSummary);
-			console.stepComplete(step.name, outputSummary);
-			logger.info(step.name, outputSummary);
-			return { success: true, outputSummary };
-		}
-
-		return { success: false, error: "Serial execution failed" };
-	}
-}

package/src/types.ts

@@ -1,141 +0,0 @@
-/** Core types for agentic-forge workflow engine. */
-
-// --- Step types ---
-
-export type StepType =
-	| "prompt"
-	| "parallel"
-	| "serial"
-	| "conditional"
-	| "ralph-loop"
-	| "wait-for-human";
-
-export const VALID_STEP_TYPES: StepType[] = [
-	"prompt",
-	"parallel",
-	"serial",
-	"conditional",
-	"ralph-loop",
-	"wait-for-human",
-];
-
-// --- Workflow definition types ---
-
-export interface Variable {
-	name: string;
-	type: string;
-	required: boolean;
-	default?: unknown;
-	description?: string;
-}
-
-export interface GitSettings {
-	enabled: boolean;
-	worktree: boolean;
-	autoCommit: boolean;
-	autoPr: boolean;
-	branchPrefix: string;
-}
-
-export interface StepGitSettings {
-	worktree: boolean;
-	autoPr: boolean;
-	branchPrefix: string;
-}
-
-export interface WorkflowSettings {
-	maxRetry: number;
-	timeoutMinutes: number;
-	trackProgress: boolean;
-	autofix: string;
-	terminalOutput: string;
-	bypassPermissions: boolean;
-	strictMode: boolean;
-	model: string | null;
-	requiredTools: string[];
-	git: GitSettings;
-}
-
-export interface StepDefinition {
-	name: string;
-	type: StepType;
-	prompt?: string | null;
-	agent?: string | null;
-	steps: StepDefinition[];
-	mergeStrategy: string;
-	mergeMode: string;
-	condition?: string | null;
-	thenSteps: StepDefinition[];
-	elseSteps: StepDefinition[];
-	maxIterations: number | string;
-	completionPromise?: string | null;
-	message?: string | null;
-	pollingInterval: number;
-	onTimeout: string;
-	model?: string | null;
-	stepTimeoutMinutes?: number | null;
-	stepMaxRetry?: number | null;
-	onError: string;
-	checkpoint: boolean;
-	dependsOn?: string | null;
-	git?: StepGitSettings | null;
-}
-
-export interface OutputDefinition {
-	name: string;
-	template: string;
-	path: string;
-	when: string;
-}
-
-export interface WorkflowDefinition {
-	name: string;
-	version: string;
-	description: string;
-	settings: WorkflowSettings;
-	variables: Variable[];
-	steps: StepDefinition[];
-	outputs: OutputDefinition[];
-}
-
-// --- Progress tracking types ---
-
-export type WorkflowStatus = "pending" | "running" | "completed" | "failed" | "paused" | "canceled";
-
-export type StepStatus = "pending" | "running" | "completed" | "failed" | "skipped";
-
-export interface StepProgress {
-	name: string;
-	status: string;
-	startedAt: string | null;
-	completedAt: string | null;
-	retryCount: number;
-	outputSummary: string;
-	error: string | null;
-	humanInput: string | null;
-}
-
-export interface ParallelBranch {
-	branchId: string;
-	status: string;
-	worktreePath: string;
-	progressFile: string;
-}
-
-export interface WorkflowProgress {
-	schemaVersion: string;
-	workflowId: string;
-	workflowName: string;
-	status: string;
-	startedAt: string | null;
-	completedAt: string | null;
-	currentStep: Record<string, unknown> | null;
-	completedSteps: StepProgress[];
-	pendingSteps: string[];
-	runningSteps: string[];
-	parallelBranches: ParallelBranch[];
-	errors: Record<string, unknown>[];
-	variables: Record<string, unknown>;
-	stepOutputs: Record<string, unknown>;
-	workflowFile: string;
-}

package/tests/config.test.ts

@@ -1,219 +0,0 @@
-import { mkdirSync, readFileSync, writeFileSync } from "node:fs";
-import { tmpdir } from "node:os";
-import path from "node:path";
-import { beforeEach, describe, expect, it } from "vitest";
-import {
-	deepMerge,
-	getConfigPath,
-	getConfigValue,
-	getDefaultConfig,
-	loadConfig,
-	saveConfig,
-	setConfigValue,
-} from "../src/config.js";
-
-function makeTempDir(): string {
-	const dir = path.join(
-		tmpdir(),
-		`agentic-test-${Date.now()}-${Math.random().toString(36).slice(2)}`,
-	);
-	mkdirSync(dir, { recursive: true });
-	return dir;
-}
-
-describe("Config defaults", () => {
-	it("should return a copy from getDefaultConfig", () => {
-		const config1 = getDefaultConfig();
-		const config2 = getDefaultConfig();
-
-		config1.outputDirectory = "modified";
-
-		expect(config2.outputDirectory).toBe("agentic");
-		expect(config1).not.toBe(config2);
-	});
-
-	it("should have correct default structure", () => {
-		const config = getDefaultConfig();
-
-		expect(config).toHaveProperty("outputDirectory");
-		expect(config).toHaveProperty("logging");
-		expect(config).toHaveProperty("git");
-		expect(config).toHaveProperty("defaults");
-		expect(config).toHaveProperty("execution");
-	});
-
-	it("should have sonnet as default model", () => {
-		const config = getDefaultConfig();
-		expect((config.defaults as Record<string, unknown>).model).toBe("sonnet");
-	});
-});
-
-describe("Config path", () => {
-	it("should construct correct config path", () => {
-		const tempDir = makeTempDir();
-		const configPath = getConfigPath(tempDir);
-		expect(configPath).toBe(path.join(tempDir, "agentic", "config.json"));
-	});
-
-	it("should use cwd when no root specified", () => {
-		const configPath = getConfigPath();
-		expect(path.basename(configPath)).toBe("config.json");
-		expect(path.basename(path.dirname(configPath))).toBe("agentic");
-	});
-});
-
-describe("Load config", () => {
-	let tempDir: string;
-
-	beforeEach(() => {
-		tempDir = makeTempDir();
-	});
-
-	it("should load default config when no file exists", () => {
-		const config = loadConfig(tempDir);
-
-		expect(config.outputDirectory).toBe("agentic");
-		expect((config.defaults as Record<string, unknown>).model).toBe("sonnet");
-	});
-
-	it("should load existing config file", () => {
-		const configDir = path.join(tempDir, "agentic");
-		mkdirSync(configDir, { recursive: true });
-		writeFileSync(
-			path.join(configDir, "config.json"),
-			JSON.stringify({
-				outputDirectory: "custom-output",
-				defaults: { model: "opus" },
-			}),
-		);
-
-		const config = loadConfig(tempDir);
-
-		expect(config.outputDirectory).toBe("custom-output");
-		expect((config.defaults as Record<string, unknown>).model).toBe("opus");
-		// Other defaults should still be present
-		expect((config.defaults as Record<string, unknown>).maxRetry).toBe(3);
-	});
-
-	it("should merge loaded config with defaults", () => {
-		const configDir = path.join(tempDir, "agentic");
-		mkdirSync(configDir, { recursive: true });
-		writeFileSync(
-			path.join(configDir, "config.json"),
-			JSON.stringify({ logging: { level: "Debug" } }),
-		);
-
-		const config = loadConfig(tempDir);
-
-		expect((config.logging as Record<string, unknown>).level).toBe("Debug");
-		expect((config.logging as Record<string, unknown>).enabled).toBe(true);
-	});
-});
-
-describe("Save config", () => {
-	let tempDir: string;
-
-	beforeEach(() => {
-		tempDir = makeTempDir();
-	});
-
-	it("should create directory if needed", () => {
-		const config = { test: "value" };
-		saveConfig(config, tempDir);
-
-		const configPath = getConfigPath(tempDir);
-		const content = readFileSync(configPath, "utf-8");
-		expect(content).toBeTruthy();
-	});
-
-	it("should write valid JSON", () => {
-		const config = { test: "value", nested: { key: 123 } };
-		saveConfig(config, tempDir);
-
-		const configPath = getConfigPath(tempDir);
-		const loaded = JSON.parse(readFileSync(configPath, "utf-8"));
-		expect(loaded).toEqual(config);
-	});
-});
-
-describe("Config values", () => {
-	let tempDir: string;
-
-	beforeEach(() => {
-		tempDir = makeTempDir();
-	});
-
-	it("should get simple config value", () => {
-		const value = getConfigValue("outputDirectory", tempDir);
-		expect(value).toBe("agentic");
-	});
-
-	it("should get nested config value", () => {
-		const value = getConfigValue("defaults.model", tempDir);
-		expect(value).toBe("sonnet");
-	});
-
-	it("should return null for missing key", () => {
-		const value = getConfigValue("nonexistent.key", tempDir);
-		expect(value).toBeNull();
-	});
-
-	it("should set simple config value", () => {
-		setConfigValue("outputDirectory", "new-output", tempDir);
-		const value = getConfigValue("outputDirectory", tempDir);
-		expect(value).toBe("new-output");
-	});
-
-	it("should set nested config value", () => {
-		setConfigValue("defaults.model", "opus", tempDir);
-		const value = getConfigValue("defaults.model", tempDir);
-		expect(value).toBe("opus");
-	});
-
-	it("should create nested structure when setting value", () => {
-		setConfigValue("new.nested.key", "value", tempDir);
-		const value = getConfigValue("new.nested.key", tempDir);
-		expect(value).toBe("value");
-	});
-
-	it("should parse boolean true value", () => {
-		setConfigValue("logging.enabled", "true", tempDir);
-		const value = getConfigValue("logging.enabled", tempDir);
-		expect(value).toBe(true);
-	});
-
-	it("should parse boolean false value", () => {
-		setConfigValue("logging.enabled", "false", tempDir);
-		const value = getConfigValue("logging.enabled", tempDir);
-		expect(value).toBe(false);
-	});
-
-	it("should parse integer value", () => {
-		setConfigValue("defaults.maxRetry", "10", tempDir);
-		const value = getConfigValue("defaults.maxRetry", tempDir);
-		expect(value).toBe(10);
-	});
-});
-
-describe("Deep merge", () => {
-	it("should merge simple objects", () => {
-		const base = { a: 1, b: 2 };
-		const override = { b: 3, c: 4 };
-		const result = deepMerge(base as Record<string, unknown>, override as Record<string, unknown>);
-		expect(result).toEqual({ a: 1, b: 3, c: 4 });
-	});
-
-	it("should merge nested objects", () => {
-		const base = { a: { x: 1, y: 2 }, b: 3 };
-		const override = { a: { y: 99, z: 100 } };
-		const result = deepMerge(base as Record<string, unknown>, override as Record<string, unknown>);
-		expect(result).toEqual({ a: { x: 1, y: 99, z: 100 }, b: 3 });
-	});
-
-	it("should not mutate base dictionary", () => {
-		const base = { a: { x: 1 } };
-		const override = { a: { y: 2 } };
-		deepMerge(base as Record<string, unknown>, override as Record<string, unknown>);
-		expect(base).toEqual({ a: { x: 1 } });
-	});
-});