aicodeman 0.2.8

package/dist/prompts/research-agent.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Research Agent Prompt
+ *
+ * Gathers external resources, codebase patterns, and technical context
+ * before other agents analyze the task.
+ *
+ * Placeholders: {TASK}, {WORKING_DIR}
+ */
+export declare const RESEARCH_AGENT_PROMPT = "You are a Research Specialist preparing context for an implementation task. Your job is to gather all relevant information that will help the development team succeed.\n\n## YOUR TASK\nResearch and gather comprehensive context for implementing this task:\n\n## TASK DESCRIPTION\n{TASK}\n\n## WORKING DIRECTORY\n{WORKING_DIR}\n\n## INSTRUCTIONS\nPerform thorough research across multiple sources:\n\n### 1. LOCAL PROJECT EXPLORATION (DO THIS FIRST)\nExplore the working directory to understand the existing project:\n\n**PRIORITY: Read CLAUDE.md First!**\nIf a CLAUDE.md file exists in the working directory, READ IT IMMEDIATELY. This file contains:\n- Project-specific instructions and conventions\n- Build and test commands\n- Architecture overview\n- Important patterns and gotchas\n- Files and directories to focus on\n\n**Project Structure:**\n- List files and directories to understand the project layout\n- Look for package.json, tsconfig.json, Cargo.toml, requirements.txt, etc. to identify tech stack\n- Also check README.md or docs/ for additional documentation\n- Identify the main source directories (src/, lib/, app/, etc.)\n\n**Existing Code Patterns:**\n- Search for similar features or functionality already implemented\n- Identify coding conventions (naming, file organization, module patterns)\n- Look at existing tests to understand testing patterns\n- Check for configuration files, environment setup, types/interfaces\n\n**Key Files to Examine:**\n- Entry points (index.ts, main.py, App.tsx, etc.)\n- Type definitions and interfaces\n- Utility functions and shared code\n- Database models or schemas if applicable\n\nUSE THESE TOOLS:\n- `Glob` to find files by pattern (e.g., \"**/*.ts\", \"src/**/*.tsx\")\n- `Grep` to search for specific patterns, function names, or imports\n- `Read` to examine file contents\n- Look at the most recently modified files - they're likely relevant\n\n### 2. WEB RESEARCH\nUse web search to find:\n- **Official documentation** for technologies used in the project\n- **GitHub repositories** that implement similar features\n- **Best practice guides** for the tech stack identified\n- **Stack Overflow answers** for specific implementation questions\n\nFocus your web search on:\n- How others have solved similar problems with the same tech stack\n- Common pitfalls and gotchas for the specific technologies\n- Library/package recommendations compatible with the project\n- API usage examples\n\n### 3. TECHNICAL ANALYSIS\nBased on your research:\n- Recommend the best approach that fits the existing codebase style\n- Identify files that will need to be modified or created\n- Suggest where new code should live based on existing structure\n- Note any compatibility or integration concerns\n\n## OUTPUT FORMAT\nReturn ONLY a JSON object:\n{\n  \"projectContext\": {\n    \"techStack\": [\"TypeScript\", \"React\", \"Node.js\", ...],\n    \"projectType\": \"web-app|cli|library|api|monorepo|...\",\n    \"buildSystem\": \"npm|yarn|pnpm|cargo|pip|...\",\n    \"testFramework\": \"vitest|jest|pytest|...\",\n    \"keyDirectories\": {\n      \"source\": \"src/\",\n      \"tests\": \"test/\",\n      \"config\": \"...\"\n    },\n    \"entryPoints\": [\"src/index.ts\", ...],\n    \"hasDocumentation\": true|false,\n    \"documentationNotes\": \"Summary of CLAUDE.md or README if found\"\n  },\n  \"existingPatterns\": [\n    {\n      \"pattern\": \"Pattern name (e.g., 'EventEmitter for async communication')\",\n      \"location\": \"src/events/*.ts\",\n      \"example\": \"Brief code example or file reference\",\n      \"relevance\": \"Why this pattern matters for the task\"\n    }\n  ],\n  \"relevantFiles\": [\n    {\n      \"path\": \"src/components/Auth.tsx\",\n      \"purpose\": \"What this file does\",\n      \"relevance\": \"Why it's relevant to the task\",\n      \"shouldModify\": true|false\n    }\n  ],\n  \"externalResources\": [\n    {\n      \"type\": \"github|documentation|tutorial|article|stackoverflow\",\n      \"url\": \"https://...\",\n      \"title\": \"Resource title\",\n      \"relevance\": \"Why this is relevant to the task\",\n      \"keyInsights\": [\"Insight 1\", \"Insight 2\"]\n    }\n  ],\n  \"technicalRecommendations\": [\n    \"Use the existing EventEmitter pattern from src/events/ for...\",\n    \"Follow the component structure in src/components/...\"\n  ],\n  \"potentialChallenges\": [\n    \"The existing auth system uses X, need to integrate with...\",\n    \"Watch out for Y when modifying Z\"\n  ],\n  \"suggestedApproach\": {\n    \"summary\": \"Brief 2-3 sentence approach recommendation\",\n    \"newFiles\": [\"src/features/new-feature.ts\", ...],\n    \"modifyFiles\": [\"src/index.ts\", ...],\n    \"testFiles\": [\"test/new-feature.test.ts\", ...]\n  },\n  \"enrichedTaskDescription\": \"A detailed version of the original task, enriched with specific file paths, existing patterns to follow, and technical details from your exploration. Should reference actual files and patterns found in the codebase.\"\n}\n\nCRITICAL REQUIREMENTS:\n1. ALWAYS explore the local project FIRST - understand what exists before searching online\n2. Reference ACTUAL files and patterns found in the codebase, not hypothetical ones\n3. The enrichedTaskDescription MUST include specific file paths and patterns from the project\n4. Use Glob/Grep/Read tools to actually explore - don't guess about project structure\n5. If web search finds useful resources, include real URLs";
+//# sourceMappingURL=research-agent.d.ts.map

package/dist/prompts/research-agent.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-agent.d.ts","sourceRoot":"","sources":["../../src/prompts/research-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,qBAAqB,01KAqIyB,CAAC"}

package/dist/prompts/research-agent.js

@@ -0,0 +1,143 @@
+/**
+ * Research Agent Prompt
+ *
+ * Gathers external resources, codebase patterns, and technical context
+ * before other agents analyze the task.
+ *
+ * Placeholders: {TASK}, {WORKING_DIR}
+ */
+export const RESEARCH_AGENT_PROMPT = `You are a Research Specialist preparing context for an implementation task. Your job is to gather all relevant information that will help the development team succeed.
+
+## YOUR TASK
+Research and gather comprehensive context for implementing this task:
+
+## TASK DESCRIPTION
+{TASK}
+
+## WORKING DIRECTORY
+{WORKING_DIR}
+
+## INSTRUCTIONS
+Perform thorough research across multiple sources:
+
+### 1. LOCAL PROJECT EXPLORATION (DO THIS FIRST)
+Explore the working directory to understand the existing project:
+
+**PRIORITY: Read CLAUDE.md First!**
+If a CLAUDE.md file exists in the working directory, READ IT IMMEDIATELY. This file contains:
+- Project-specific instructions and conventions
+- Build and test commands
+- Architecture overview
+- Important patterns and gotchas
+- Files and directories to focus on
+
+**Project Structure:**
+- List files and directories to understand the project layout
+- Look for package.json, tsconfig.json, Cargo.toml, requirements.txt, etc. to identify tech stack
+- Also check README.md or docs/ for additional documentation
+- Identify the main source directories (src/, lib/, app/, etc.)
+
+**Existing Code Patterns:**
+- Search for similar features or functionality already implemented
+- Identify coding conventions (naming, file organization, module patterns)
+- Look at existing tests to understand testing patterns
+- Check for configuration files, environment setup, types/interfaces
+
+**Key Files to Examine:**
+- Entry points (index.ts, main.py, App.tsx, etc.)
+- Type definitions and interfaces
+- Utility functions and shared code
+- Database models or schemas if applicable
+
+USE THESE TOOLS:
+- \`Glob\` to find files by pattern (e.g., "**/*.ts", "src/**/*.tsx")
+- \`Grep\` to search for specific patterns, function names, or imports
+- \`Read\` to examine file contents
+- Look at the most recently modified files - they're likely relevant
+
+### 2. WEB RESEARCH
+Use web search to find:
+- **Official documentation** for technologies used in the project
+- **GitHub repositories** that implement similar features
+- **Best practice guides** for the tech stack identified
+- **Stack Overflow answers** for specific implementation questions
+
+Focus your web search on:
+- How others have solved similar problems with the same tech stack
+- Common pitfalls and gotchas for the specific technologies
+- Library/package recommendations compatible with the project
+- API usage examples
+
+### 3. TECHNICAL ANALYSIS
+Based on your research:
+- Recommend the best approach that fits the existing codebase style
+- Identify files that will need to be modified or created
+- Suggest where new code should live based on existing structure
+- Note any compatibility or integration concerns
+
+## OUTPUT FORMAT
+Return ONLY a JSON object:
+{
+  "projectContext": {
+    "techStack": ["TypeScript", "React", "Node.js", ...],
+    "projectType": "web-app|cli|library|api|monorepo|...",
+    "buildSystem": "npm|yarn|pnpm|cargo|pip|...",
+    "testFramework": "vitest|jest|pytest|...",
+    "keyDirectories": {
+      "source": "src/",
+      "tests": "test/",
+      "config": "..."
+    },
+    "entryPoints": ["src/index.ts", ...],
+    "hasDocumentation": true|false,
+    "documentationNotes": "Summary of CLAUDE.md or README if found"
+  },
+  "existingPatterns": [
+    {
+      "pattern": "Pattern name (e.g., 'EventEmitter for async communication')",
+      "location": "src/events/*.ts",
+      "example": "Brief code example or file reference",
+      "relevance": "Why this pattern matters for the task"
+    }
+  ],
+  "relevantFiles": [
+    {
+      "path": "src/components/Auth.tsx",
+      "purpose": "What this file does",
+      "relevance": "Why it's relevant to the task",
+      "shouldModify": true|false
+    }
+  ],
+  "externalResources": [
+    {
+      "type": "github|documentation|tutorial|article|stackoverflow",
+      "url": "https://...",
+      "title": "Resource title",
+      "relevance": "Why this is relevant to the task",
+      "keyInsights": ["Insight 1", "Insight 2"]
+    }
+  ],
+  "technicalRecommendations": [
+    "Use the existing EventEmitter pattern from src/events/ for...",
+    "Follow the component structure in src/components/..."
+  ],
+  "potentialChallenges": [
+    "The existing auth system uses X, need to integrate with...",
+    "Watch out for Y when modifying Z"
+  ],
+  "suggestedApproach": {
+    "summary": "Brief 2-3 sentence approach recommendation",
+    "newFiles": ["src/features/new-feature.ts", ...],
+    "modifyFiles": ["src/index.ts", ...],
+    "testFiles": ["test/new-feature.test.ts", ...]
+  },
+  "enrichedTaskDescription": "A detailed version of the original task, enriched with specific file paths, existing patterns to follow, and technical details from your exploration. Should reference actual files and patterns found in the codebase."
+}
+
+CRITICAL REQUIREMENTS:
+1. ALWAYS explore the local project FIRST - understand what exists before searching online
+2. Reference ACTUAL files and patterns found in the codebase, not hypothetical ones
+3. The enrichedTaskDescription MUST include specific file paths and patterns from the project
+4. Use Glob/Grep/Read tools to actually explore - don't guess about project structure
+5. If web search finds useful resources, include real URLs`;
+//# sourceMappingURL=research-agent.js.map

package/dist/prompts/research-agent.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"research-agent.js","sourceRoot":"","sources":["../../src/prompts/research-agent.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,qBAAqB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;2DAqIsB,CAAC"}

package/dist/push-store.d.ts

@@ -0,0 +1,41 @@
+/**
+ * @fileoverview VAPID key auto-generation and push subscription CRUD.
+ *
+ * Persists VAPID keys to ~/.codeman/push-keys.json and subscriptions
+ * to ~/.codeman/push-subscriptions.json. Debounced saves prevent
+ * excessive disk I/O during rapid subscription updates.
+ */
+import type { VapidKeys, PushSubscriptionRecord } from './types.js';
+export declare class PushSubscriptionStore {
+    private vapidKeys;
+    private subscriptions;
+    private saveTimer;
+    private _disposed;
+    constructor();
+    get isDisposed(): boolean;
+    /** Get or generate VAPID keys */
+    getVapidKeys(): VapidKeys;
+    /** Get the public VAPID key for client subscription */
+    getPublicKey(): string;
+    /** Register or update a push subscription (deduplicates by endpoint) */
+    addSubscription(sub: Omit<PushSubscriptionRecord, 'lastUsedAt'>): PushSubscriptionRecord;
+    /** Update push preferences for a subscription */
+    updatePreferences(id: string, preferences: Record<string, boolean>): PushSubscriptionRecord | null;
+    /** Remove a subscription */
+    removeSubscription(id: string): boolean;
+    /** Remove subscription by endpoint (used for auto-cleanup of expired subs) */
+    removeByEndpoint(endpoint: string): void;
+    /** Get all subscriptions */
+    getAll(): PushSubscriptionRecord[];
+    /** Get a single subscription by ID */
+    get(id: string): PushSubscriptionRecord | null;
+    /** Load subscriptions from disk */
+    private loadSubscriptions;
+    /** Schedule a debounced save */
+    private scheduleSave;
+    /** Immediately persist subscriptions to disk */
+    private flushSave;
+    /** Clean shutdown */
+    dispose(): void;
+}
+//# sourceMappingURL=push-store.d.ts.map

package/dist/push-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"push-store.d.ts","sourceRoot":"","sources":["../src/push-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAMH,OAAO,KAAK,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAOpE,qBAAa,qBAAqB;IAChC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,aAAa,CAAkD;IACvE,OAAO,CAAC,SAAS,CAA+B;IAChD,OAAO,CAAC,SAAS,CAAS;;IAM1B,IAAI,UAAU,IAAI,OAAO,CAExB;IAED,iCAAiC;IACjC,YAAY,IAAI,SAAS;IA4BzB,uDAAuD;IACvD,YAAY,IAAI,MAAM;IAItB,wEAAwE;IACxE,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,sBAAsB,EAAE,YAAY,CAAC,GAAG,sBAAsB;IA4BxF,iDAAiD;IACjD,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,sBAAsB,GAAG,IAAI;IASlG,4BAA4B;IAC5B,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAMvC,8EAA8E;IAC9E,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAUxC,4BAA4B;IAC5B,MAAM,IAAI,sBAAsB,EAAE;IAIlC,sCAAsC;IACtC,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,sBAAsB,GAAG,IAAI;IAI9C,mCAAmC;IACnC,OAAO,CAAC,iBAAiB;IAazB,gCAAgC;IAChC,OAAO,CAAC,YAAY;IAQpB,gDAAgD;IAChD,OAAO,CAAC,SAAS;IASjB,qBAAqB;IACrB,OAAO,IAAI,IAAI;CAUhB"}

package/dist/push-store.js

@@ -0,0 +1,168 @@
+/**
+ * @fileoverview VAPID key auto-generation and push subscription CRUD.
+ *
+ * Persists VAPID keys to ~/.codeman/push-keys.json and subscriptions
+ * to ~/.codeman/push-subscriptions.json. Debounced saves prevent
+ * excessive disk I/O during rapid subscription updates.
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+import webpush from 'web-push';
+const DATA_DIR = join(homedir(), '.codeman');
+const KEYS_FILE = join(DATA_DIR, 'push-keys.json');
+const SUBS_FILE = join(DATA_DIR, 'push-subscriptions.json');
+const SAVE_DEBOUNCE_MS = 500;
+export class PushSubscriptionStore {
+    vapidKeys = null;
+    subscriptions = new Map();
+    saveTimer = null;
+    _disposed = false;
+    constructor() {
+        this.loadSubscriptions();
+    }
+    get isDisposed() {
+        return this._disposed;
+    }
+    /** Get or generate VAPID keys */
+    getVapidKeys() {
+        if (this.vapidKeys)
+            return this.vapidKeys;
+        // Try loading from disk
+        if (existsSync(KEYS_FILE)) {
+            try {
+                const raw = readFileSync(KEYS_FILE, 'utf-8');
+                this.vapidKeys = JSON.parse(raw);
+                return this.vapidKeys;
+            }
+            catch {
+                // Regenerate on parse error
+            }
+        }
+        // Generate new keys
+        const keys = webpush.generateVAPIDKeys();
+        this.vapidKeys = {
+            publicKey: keys.publicKey,
+            privateKey: keys.privateKey,
+            generatedAt: Date.now(),
+        };
+        // Persist
+        mkdirSync(DATA_DIR, { recursive: true });
+        writeFileSync(KEYS_FILE, JSON.stringify(this.vapidKeys, null, 2));
+        return this.vapidKeys;
+    }
+    /** Get the public VAPID key for client subscription */
+    getPublicKey() {
+        return this.getVapidKeys().publicKey;
+    }
+    /** Register or update a push subscription (deduplicates by endpoint) */
+    addSubscription(sub) {
+        // Check for existing subscription with same endpoint
+        for (const [existingId, existing] of this.subscriptions) {
+            if (existing.endpoint === sub.endpoint) {
+                // Update existing
+                const updated = {
+                    ...existing,
+                    keys: sub.keys,
+                    userAgent: sub.userAgent,
+                    lastUsedAt: Date.now(),
+                    pushPreferences: sub.pushPreferences,
+                };
+                this.subscriptions.set(existingId, updated);
+                this.scheduleSave();
+                return updated;
+            }
+        }
+        // New subscription
+        const record = {
+            ...sub,
+            lastUsedAt: Date.now(),
+        };
+        this.subscriptions.set(record.id, record);
+        this.scheduleSave();
+        return record;
+    }
+    /** Update push preferences for a subscription */
+    updatePreferences(id, preferences) {
+        const sub = this.subscriptions.get(id);
+        if (!sub)
+            return null;
+        sub.pushPreferences = preferences;
+        sub.lastUsedAt = Date.now();
+        this.scheduleSave();
+        return sub;
+    }
+    /** Remove a subscription */
+    removeSubscription(id) {
+        const deleted = this.subscriptions.delete(id);
+        if (deleted)
+            this.scheduleSave();
+        return deleted;
+    }
+    /** Remove subscription by endpoint (used for auto-cleanup of expired subs) */
+    removeByEndpoint(endpoint) {
+        for (const [id, sub] of this.subscriptions) {
+            if (sub.endpoint === endpoint) {
+                this.subscriptions.delete(id);
+                this.scheduleSave();
+                return;
+            }
+        }
+    }
+    /** Get all subscriptions */
+    getAll() {
+        return Array.from(this.subscriptions.values());
+    }
+    /** Get a single subscription by ID */
+    get(id) {
+        return this.subscriptions.get(id) ?? null;
+    }
+    /** Load subscriptions from disk */
+    loadSubscriptions() {
+        if (!existsSync(SUBS_FILE))
+            return;
+        try {
+            const raw = readFileSync(SUBS_FILE, 'utf-8');
+            const arr = JSON.parse(raw);
+            for (const sub of arr) {
+                this.subscriptions.set(sub.id, sub);
+            }
+        }
+        catch {
+            // Start fresh on parse error
+        }
+    }
+    /** Schedule a debounced save */
+    scheduleSave() {
+        if (this._disposed)
+            return;
+        if (this.saveTimer)
+            clearTimeout(this.saveTimer);
+        this.saveTimer = setTimeout(() => {
+            this.flushSave();
+        }, SAVE_DEBOUNCE_MS);
+    }
+    /** Immediately persist subscriptions to disk */
+    flushSave() {
+        try {
+            mkdirSync(DATA_DIR, { recursive: true });
+            writeFileSync(SUBS_FILE, JSON.stringify(Array.from(this.subscriptions.values()), null, 2));
+        }
+        catch {
+            // Ignore write errors
+        }
+    }
+    /** Clean shutdown */
+    dispose() {
+        if (this._disposed)
+            return;
+        this._disposed = true;
+        if (this.saveTimer) {
+            clearTimeout(this.saveTimer);
+            this.saveTimer = null;
+        }
+        // Final flush
+        this.flushSave();
+    }
+}
+//# sourceMappingURL=push-store.js.map

package/dist/push-store.js.map

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

package/dist/ralph-config.d.ts

@@ -0,0 +1,67 @@
+/**
+ * @fileoverview Ralph Wiggum configuration parser
+ *
+ * Parses the official Ralph Wiggum plugin state file (.claude/ralph-loop.local.md)
+ * and extracts configuration for session tracking.
+ *
+ * @module ralph-config
+ */
+/**
+ * Ralph Loop configuration from .claude/ralph-loop.local.md
+ */
+export interface RalphLoopConfig {
+    enabled: boolean;
+    iteration: number;
+    maxIterations: number | null;
+    completionPromise: string | null;
+}
+/**
+ * Parse Ralph Wiggum loop config from .claude/ralph-loop.local.md
+ *
+ * The official Ralph Wiggum plugin stores state in this file with YAML frontmatter:
+ * ```yaml
+ * ---
+ * enabled: true
+ * iteration: 5
+ * max-iterations: 50
+ * completion-promise: "COMPLETE"
+ * ---
+ * # Original Prompt
+ * ...
+ * ```
+ *
+ * @param workingDir - Working directory to search in
+ * @returns Parsed config or null if file doesn't exist or is invalid
+ */
+export declare function parseRalphLoopConfig(workingDir: string): RalphLoopConfig | null;
+/**
+ * Parse Ralph Wiggum loop config from file content.
+ * Exported for testing.
+ *
+ * @param content - File content to parse
+ * @returns Parsed config or null if content is invalid
+ */
+export declare function parseRalphLoopConfigFromContent(content: string): RalphLoopConfig | null;
+/**
+ * Extract completion phrase from CLAUDE.md content.
+ * Looks for <promise>PHRASE</promise> pattern.
+ *
+ * Handles multiple variations:
+ * - Raw text: <promise>PHRASE</promise>
+ * - In backticks: `<promise>PHRASE</promise>`
+ * - With whitespace: <promise> PHRASE </promise>
+ * - Multiple occurrences: returns the first one
+ *
+ * @param claudeMdPath - Path to CLAUDE.md file
+ * @returns The completion phrase (uppercase), or null if not found
+ */
+export declare function extractCompletionPhrase(claudeMdPath: string): string | null;
+/**
+ * Extract completion phrase from CLAUDE.md content string.
+ * Exported for testing.
+ *
+ * @param content - CLAUDE.md content to parse
+ * @returns The completion phrase (uppercase), or null if not found
+ */
+export declare function extractCompletionPhraseFromContent(content: string): string | null;
+//# sourceMappingURL=ralph-config.d.ts.map

package/dist/ralph-config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ralph-config.d.ts","sourceRoot":"","sources":["../src/ralph-config.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAeH;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,EAAE,MAAM,GAAG,IAAI,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,oBAAoB,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAY/E;AAED;;;;;;GAMG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAqCvF;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAU3E;AAED;;;;;;GAMG;AACH,wBAAgB,kCAAkC,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAUjF"}

package/dist/ralph-config.js

@@ -0,0 +1,134 @@
+/**
+ * @fileoverview Ralph Wiggum configuration parser
+ *
+ * Parses the official Ralph Wiggum plugin state file (.claude/ralph-loop.local.md)
+ * and extracts configuration for session tracking.
+ *
+ * @module ralph-config
+ */
+import { existsSync, readFileSync } from 'node:fs';
+import { join } from 'node:path';
+// Pattern to extract completion phrase from CLAUDE.md
+// Matches <promise>PHRASE</promise> with optional whitespace
+// Allows: letters, numbers, underscores, hyphens (e.g., TESTS-PASS, ALL_DONE)
+const CLAUDE_MD_PROMISE_PATTERN = /<promise>\s*([A-Z0-9_-]+)\s*<\/promise>/gi;
+// Pattern to parse YAML frontmatter from ralph-loop.local.md
+// Extracts key: value pairs from between --- markers
+const YAML_FRONTMATTER_PATTERN = /^---\s*\n([\s\S]*?)\n---/;
+const YAML_LINE_PATTERN = /^([a-zA-Z_-]+):\s*"?([^"\n]+)"?\s*$/gm;
+/**
+ * Parse Ralph Wiggum loop config from .claude/ralph-loop.local.md
+ *
+ * The official Ralph Wiggum plugin stores state in this file with YAML frontmatter:
+ * ```yaml
+ * ---
+ * enabled: true
+ * iteration: 5
+ * max-iterations: 50
+ * completion-promise: "COMPLETE"
+ * ---
+ * # Original Prompt
+ * ...
+ * ```
+ *
+ * @param workingDir - Working directory to search in
+ * @returns Parsed config or null if file doesn't exist or is invalid
+ */
+export function parseRalphLoopConfig(workingDir) {
+    const configPath = join(workingDir, '.claude', 'ralph-loop.local.md');
+    try {
+        if (!existsSync(configPath))
+            return null;
+        const content = readFileSync(configPath, 'utf-8');
+        return parseRalphLoopConfigFromContent(content);
+    }
+    catch (err) {
+        console.error(`[ralph-config] Error reading ralph-loop.local.md: ${err}`);
+        return null;
+    }
+}
+/**
+ * Parse Ralph Wiggum loop config from file content.
+ * Exported for testing.
+ *
+ * @param content - File content to parse
+ * @returns Parsed config or null if content is invalid
+ */
+export function parseRalphLoopConfigFromContent(content) {
+    // Extract YAML frontmatter
+    const frontmatterMatch = content.match(YAML_FRONTMATTER_PATTERN);
+    if (!frontmatterMatch)
+        return null;
+    const yaml = frontmatterMatch[1];
+    const config = {
+        enabled: false,
+        iteration: 0,
+        maxIterations: null,
+        completionPromise: null,
+    };
+    // Parse each YAML line
+    let match;
+    YAML_LINE_PATTERN.lastIndex = 0;
+    while ((match = YAML_LINE_PATTERN.exec(yaml)) !== null) {
+        const key = match[1].toLowerCase();
+        const value = match[2].trim();
+        switch (key) {
+            case 'enabled':
+                config.enabled = value.toLowerCase() === 'true' || value.toLowerCase() === 'yes';
+                break;
+            case 'iteration':
+                config.iteration = parseInt(value, 10) || 0;
+                break;
+            case 'max-iterations':
+                config.maxIterations = parseInt(value, 10) || null;
+                break;
+            case 'completion-promise':
+                config.completionPromise = value.toUpperCase();
+                break;
+        }
+    }
+    return config;
+}
+/**
+ * Extract completion phrase from CLAUDE.md content.
+ * Looks for <promise>PHRASE</promise> pattern.
+ *
+ * Handles multiple variations:
+ * - Raw text: <promise>PHRASE</promise>
+ * - In backticks: `<promise>PHRASE</promise>`
+ * - With whitespace: <promise> PHRASE </promise>
+ * - Multiple occurrences: returns the first one
+ *
+ * @param claudeMdPath - Path to CLAUDE.md file
+ * @returns The completion phrase (uppercase), or null if not found
+ */
+export function extractCompletionPhrase(claudeMdPath) {
+    try {
+        if (!existsSync(claudeMdPath))
+            return null;
+        const content = readFileSync(claudeMdPath, 'utf-8');
+        return extractCompletionPhraseFromContent(content);
+    }
+    catch (err) {
+        console.error(`[ralph-config] Error reading CLAUDE.md: ${err}`);
+        return null;
+    }
+}
+/**
+ * Extract completion phrase from CLAUDE.md content string.
+ * Exported for testing.
+ *
+ * @param content - CLAUDE.md content to parse
+ * @returns The completion phrase (uppercase), or null if not found
+ */
+export function extractCompletionPhraseFromContent(content) {
+    // Reset regex state (global flag)
+    CLAUDE_MD_PROMISE_PATTERN.lastIndex = 0;
+    // Find all matches and return the first one
+    const match = CLAUDE_MD_PROMISE_PATTERN.exec(content);
+    if (match && match[1]) {
+        return match[1].trim().toUpperCase();
+    }
+    return null;
+}
+//# sourceMappingURL=ralph-config.js.map

package/dist/ralph-config.js.map

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