agentic-forge 0.0.0 → 0.7.1

package/dist/ralph-loop.js

@@ -0,0 +1,194 @@
+/** 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";
+// --- State path ---
+export function getRalphStatePath(workflowId, stepName, repoRoot) {
+    const safeName = stepName.replace(/[^\w-]/g, "_");
+    return path.join(repoRoot, "agentic", "outputs", workflowId, `ralph-${safeName}.md`);
+}
+// --- State management ---
+export function createRalphState(workflowId, stepName, prompt, maxIterations, completionPromise, repoRoot) {
+    const state = {
+        active: true,
+        iteration: 1,
+        maxIterations,
+        completionPromise,
+        startedAt: new Date().toISOString(),
+        prompt,
+    };
+    saveRalphState(workflowId, stepName, state, repoRoot);
+    return state;
+}
+export function loadRalphState(workflowId, stepName, repoRoot) {
+    const statePath = getRalphStatePath(workflowId, stepName, repoRoot);
+    if (!existsSync(statePath))
+        return null;
+    const content = readFileSync(statePath, "utf-8");
+    return parseRalphState(content);
+}
+export function updateRalphIteration(workflowId, stepName, repoRoot) {
+    const state = loadRalphState(workflowId, stepName, repoRoot);
+    if (!state)
+        return null;
+    state.iteration += 1;
+    saveRalphState(workflowId, stepName, state, repoRoot);
+    return state;
+}
+export function deactivateRalphState(workflowId, stepName, repoRoot) {
+    const state = loadRalphState(workflowId, stepName, repoRoot);
+    if (state) {
+        state.active = false;
+        saveRalphState(workflowId, stepName, state, repoRoot);
+    }
+}
+export function deleteRalphState(workflowId, stepName, repoRoot) {
+    const statePath = getRalphStatePath(workflowId, stepName, repoRoot);
+    if (existsSync(statePath)) {
+        unlinkSync(statePath);
+    }
+}
+// --- Internal helpers ---
+function saveRalphState(workflowId, stepName, state, repoRoot) {
+    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) {
+    if (!content.startsWith("---"))
+        return null;
+    const parts = content.split("---");
+    if (parts.length < 3)
+        return null;
+    let frontmatter;
+    try {
+        frontmatter = yaml.load(parts[1]);
+    }
+    catch {
+        return null;
+    }
+    const promptSection = parts.slice(2).join("---").trim();
+    let prompt;
+    if (promptSection.includes("# Ralph Loop Prompt")) {
+        prompt = promptSection.split("# Ralph Loop Prompt")[1].trim();
+    }
+    else {
+        prompt = promptSection;
+    }
+    return {
+        active: frontmatter.active ?? false,
+        iteration: frontmatter.iteration ?? 1,
+        maxIterations: frontmatter.max_iterations ?? 5,
+        completionPromise: frontmatter.completion_promise ?? "COMPLETE",
+        startedAt: frontmatter.started_at ?? "",
+        prompt,
+    };
+}
+// --- Completion detection ---
+export function detectCompletionPromise(output, expectedPromise) {
+    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, maxIterations, completionPromise) {
+    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
+
+---
+
+`;
+}
+//# sourceMappingURL=ralph-loop.js.map

package/dist/ralph-loop.js.map

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

package/dist/renderer.d.ts

@@ -0,0 +1,15 @@
+/** Nunjucks template rendering for workflows. */
+export declare class TemplateRenderer {
+    templateDirs: string[];
+    strictMode: boolean;
+    private env;
+    constructor(templateDirs?: string[], strictMode?: boolean);
+    render(templateName: string, context: Record<string, unknown>): string;
+    renderString(templateStr: string, context: Record<string, unknown>): string;
+    hasVariables(text: string): boolean;
+    addTemplateDir(dirPath: string): void;
+}
+export declare function extractAnalysisSteps(stepOutputs: Record<string, Record<string, unknown>>): Record<string, Record<string, unknown>>;
+export declare function extractFixSteps(stepOutputs: Record<string, Record<string, unknown>>): Record<string, Record<string, unknown>>;
+export declare 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>;
+export declare function renderWorkflowOutput(templatePath: string, outputPath: string, context: Record<string, unknown>, templateDirs?: string[], strictMode?: boolean): void;

package/dist/renderer.js

@@ -0,0 +1,123 @@
+/** 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();
+/**
+ * Custom nunjucks loader that warns on undefined variables instead of failing.
+ * Returns the original `{{ variable_name }}` syntax for undefined variables.
+ */
+function createLenientEnvironment(templateDirs) {
+    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) {
+    const loader = new nunjucks.FileSystemLoader(templateDirs, { noCache: true });
+    return new nunjucks.Environment(loader, {
+        autoescape: false,
+        throwOnUndefined: true,
+    });
+}
+export class TemplateRenderer {
+    templateDirs;
+    strictMode;
+    env;
+    constructor(templateDirs, 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, context) {
+        if (!this.strictMode) {
+            warnedVars.clear();
+        }
+        return this.env.render(templateName, context);
+    }
+    renderString(templateStr, context) {
+        if (!this.strictMode) {
+            warnedVars.clear();
+        }
+        return this.env.renderString(templateStr, context);
+    }
+    hasVariables(text) {
+        return text.includes("{{") || text.includes("{%");
+    }
+    addTemplateDir(dirPath) {
+        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) {
+    const result = {};
+    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) {
+    const result = {};
+    for (const [name, data] of Object.entries(stepOutputs)) {
+        if (name.startsWith("fix-") || name.startsWith("apply-")) {
+            result[name] = data;
+        }
+    }
+    return result;
+}
+export function buildTemplateContext(workflowName, workflowId, startedAt, completedAt, stepOutputs, filesChanged, branches, pullRequests, inputs) {
+    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, outputPath, context, templateDirs, strictMode = false) {
+    const renderer = new TemplateRenderer(templateDirs, strictMode);
+    let rendered;
+    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");
+}
+//# sourceMappingURL=renderer.js.map

package/dist/renderer.js.map

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

package/dist/runner.d.ts

@@ -0,0 +1,84 @@
+/** Claude CLI runner for workflow orchestration. */
+import type { ConsoleOutput } from "./console.js";
+/** Path to the bundled skills directory for --add-dir. */
+export declare const SKILLS_DIR: string;
+/** Path to the agentic system prompt file. */
+export declare const AGENTIC_SYSTEM_PROMPT_FILE: string;
+export declare const MODEL_MAP: Record<string, string>;
+/**
+ * Resolve executable path for cross-platform subprocess calls.
+ *
+ * Uses `where` on Windows and `which` on Unix to find the full path,
+ * allowing shell=false in subprocess calls.
+ */
+export declare function getExecutable(name: string): string;
+/** Custom error for missing executables. */
+export declare class FileNotFoundError extends Error {
+    constructor(message: string);
+}
+/** Parse a single line of stream-json output. */
+export declare function parseStreamJsonLine(line: string): Record<string, unknown> | null;
+/** Extract model name from an assistant or system message. */
+export declare function extractModelFromMessage(data: Record<string, unknown>): string | null;
+/** Format model name for display. */
+export declare function formatModelName(model: string | null): string;
+/**
+ * Extract text content from an assistant message.
+ *
+ * Handles two stream-json formats:
+ * 1. Verbose format: {"type": "assistant", "message": {"content": [...]}}
+ * 2. Stream event format: {"type": "stream_event", "event": {"type": "content_block_delta", ...}}
+ *
+ * Returns array of [content_block_index, text] tuples.
+ */
+export declare function extractTextFromMessage(data: Record<string, unknown>): Array<[number, string]>;
+/** Extract text content from a user message. */
+export declare function extractUserText(data: Record<string, unknown>): string | null;
+/** Extract the final result text from a result message. */
+export declare function extractResultText(data: Record<string, unknown>): string | null;
+/** Load the agentic system prompt from file. */
+export declare function getAgenticSystemPrompt(): string | null;
+export declare class SessionOutput {
+    sessionId: string | null;
+    isSuccess: boolean;
+    context: string;
+    extra: Record<string, unknown>;
+    rawJson: Record<string, unknown> | null;
+    constructor(sessionId?: string | null, isSuccess?: boolean, context?: string, extra?: Record<string, unknown>, rawJson?: Record<string, unknown> | null);
+    /**
+     * Extract the session output JSON from Claude's stdout.
+     *
+     * Looks for the last JSON block that contains the required base keys
+     * (sessionId, isSuccess, context).
+     */
+    static fromStdout(stdout: string): SessionOutput;
+}
+export declare class ClaudeResult {
+    returncode: number;
+    stdout: string;
+    stderr: string;
+    prompt: string;
+    cwd: string | null;
+    model: string | null;
+    private _sessionOutput;
+    constructor(returncode: number, stdout: string, stderr: string, prompt: string, cwd: string | null, model?: string | null);
+    get success(): boolean;
+    get sessionOutput(): SessionOutput;
+    toString(): string;
+}
+export interface RunClaudeOptions {
+    prompt: string;
+    cwd?: string | null;
+    model?: string;
+    timeout?: number | null;
+    printOutput?: boolean;
+    skipPermissions?: boolean;
+    allowedTools?: string[] | null;
+    console?: ConsoleOutput | null;
+    appendSystemPrompt?: boolean;
+    workflowId?: string | null;
+}
+/** Run claude with the given prompt. */
+export declare function runClaude(options: RunClaudeOptions): Promise<ClaudeResult>;
+/** Check if the claude CLI is available. */
+export declare function checkClaudeAvailable(): boolean;