ralph-starter 0.0.1 → 0.1.1-beta.1

package/dist/loop/semantic-analyzer.js

@@ -0,0 +1,153 @@
+/**
+ * Semantic Response Analyzer
+ * Analyzes agent output for natural language completion/stuck signals
+ */
+// Patterns indicating task completion
+const COMPLETION_PATTERNS = [
+    // Explicit completion signals
+    { pattern: /<promise>COMPLETE<\/promise>/i, weight: 1.0 },
+    { pattern: /EXIT_SIGNAL:\s*true/i, weight: 1.0 },
+    { pattern: /<TASK_DONE>/i, weight: 1.0 },
+    { pattern: /<TASK_COMPLETE>/i, weight: 1.0 },
+    // Strong completion indicators
+    { pattern: /all\s+tasks?\s+(are\s+)?completed?/i, weight: 0.9 },
+    { pattern: /implementation\s+(is\s+)?complete/i, weight: 0.9 },
+    { pattern: /feature\s+(is\s+)?ready/i, weight: 0.8 },
+    { pattern: /successfully\s+(implemented|completed|finished)/i, weight: 0.9 },
+    { pattern: /no\s+more\s+tasks?\s+(remaining|left)/i, weight: 0.9 },
+    // Medium completion indicators
+    { pattern: /everything\s+(is\s+)?(done|working|complete)/i, weight: 0.7 },
+    { pattern: /all\s+tests?\s+pass(ing|ed)?/i, weight: 0.6 },
+    { pattern: /build\s+succeed(s|ed)?/i, weight: 0.5 },
+    { pattern: /ready\s+(for|to)\s+(review|merge|deploy)/i, weight: 0.8 },
+    { pattern: /task\s+(has\s+been\s+)?completed/i, weight: 0.7 },
+    // Weaker indicators (might just be status updates)
+    { pattern: /finished\s+(implementing|coding|writing)/i, weight: 0.5 },
+    { pattern: /changes?\s+(have\s+been\s+)?committed/i, weight: 0.3 },
+    { pattern: /pushed\s+to\s+(remote|origin)/i, weight: 0.3 },
+];
+// Patterns indicating the agent is stuck or blocked
+const STUCK_PATTERNS = [
+    // Explicit blocked signals
+    { pattern: /<TASK_BLOCKED>/i, weight: 1.0 },
+    { pattern: /TASK\s+BLOCKED/i, weight: 1.0 },
+    // Strong stuck indicators
+    { pattern: /cannot\s+proceed/i, weight: 0.9 },
+    { pattern: /blocked\s+by/i, weight: 0.9 },
+    { pattern: /waiting\s+for\s+(human|user|manual)/i, weight: 0.9 },
+    { pattern: /need(s)?\s+(your\s+)?clarification/i, weight: 0.8 },
+    { pattern: /require(s)?\s+(human|manual)\s+intervention/i, weight: 0.9 },
+    // Medium stuck indicators
+    { pattern: /same\s+error\s+again/i, weight: 0.7 },
+    { pattern: /stuck\s+(on|at|in)/i, weight: 0.8 },
+    { pattern: /unable\s+to\s+(proceed|continue|resolve)/i, weight: 0.8 },
+    { pattern: /can'?t\s+(figure\s+out|solve|fix)/i, weight: 0.6 },
+    { pattern: /infinite\s+loop/i, weight: 0.9 },
+    // Weaker indicators
+    { pattern: /not\s+sure\s+(how|what)/i, weight: 0.4 },
+    { pattern: /need(s)?\s+more\s+(information|context)/i, weight: 0.5 },
+    { pattern: /missing\s+(dependency|file|configuration)/i, weight: 0.6 },
+    { pattern: /permission\s+denied/i, weight: 0.7 },
+    { pattern: /authentication\s+(failed|required)/i, weight: 0.7 },
+];
+// Patterns indicating progress is being made
+const PROGRESS_PATTERNS = [
+    { pattern: /working\s+on/i, weight: 0.3 },
+    { pattern: /implementing/i, weight: 0.3 },
+    { pattern: /creating/i, weight: 0.3 },
+    { pattern: /updating/i, weight: 0.3 },
+    { pattern: /fixing/i, weight: 0.3 },
+    { pattern: /next\s+(step|task)/i, weight: 0.2 },
+];
+function matchPatterns(text, patterns) {
+    let totalWeight = 0;
+    const matches = [];
+    for (const { pattern, weight } of patterns) {
+        const match = text.match(pattern);
+        if (match) {
+            totalWeight += weight;
+            matches.push(match[0]);
+        }
+    }
+    // Normalize score to 0-1 range, capped at 1
+    const score = Math.min(totalWeight, 1.0);
+    return { score, matches };
+}
+function determineConfidence(completionScore, stuckScore, _progressMatches) {
+    // High confidence: strong signal in one direction with no conflicting signals
+    if (completionScore >= 0.8 && stuckScore < 0.2) {
+        return 'high';
+    }
+    if (stuckScore >= 0.8 && completionScore < 0.2) {
+        return 'high';
+    }
+    // Low confidence: conflicting signals
+    if (completionScore >= 0.5 && stuckScore >= 0.5) {
+        return 'low';
+    }
+    // Low confidence: no strong signals
+    if (completionScore < 0.3 && stuckScore < 0.3) {
+        return 'low';
+    }
+    return 'medium';
+}
+/**
+ * Analyze agent output for completion/stuck signals
+ */
+export function analyzeResponse(output) {
+    const completion = matchPatterns(output, COMPLETION_PATTERNS);
+    const stuck = matchPatterns(output, STUCK_PATTERNS);
+    const progress = matchPatterns(output, PROGRESS_PATTERNS);
+    const confidence = determineConfidence(completion.score, stuck.score, progress.matches.length);
+    return {
+        completionScore: completion.score,
+        stuckScore: stuck.score,
+        confidence,
+        indicators: {
+            completion: completion.matches,
+            stuck: stuck.matches,
+        },
+    };
+}
+/**
+ * Determine loop status based on semantic analysis
+ */
+export function determineStatus(analysis, options = {}) {
+    const { requireExitSignal = false, minCompletionIndicators = 1 } = options;
+    // Check for blocked status first (higher priority)
+    if (analysis.stuckScore >= 0.7 && analysis.confidence !== 'low') {
+        return 'blocked';
+    }
+    // Check for explicit EXIT_SIGNAL if required
+    const hasExitSignal = analysis.indicators.completion.some((m) => /EXIT_SIGNAL:\s*true/i.test(m) || /<promise>COMPLETE<\/promise>/i.test(m));
+    // Check completion conditions
+    if (analysis.completionScore >= 0.7) {
+        // If exit signal is required, check for it
+        if (requireExitSignal && !hasExitSignal) {
+            return 'continue';
+        }
+        // Check minimum indicators
+        if (analysis.indicators.completion.length >= minCompletionIndicators) {
+            return 'done';
+        }
+    }
+    // Explicit exit signals always count
+    if (hasExitSignal) {
+        return 'done';
+    }
+    return 'continue';
+}
+/**
+ * Count completion indicators in output
+ */
+export function countCompletionIndicators(output) {
+    const analysis = analyzeResponse(output);
+    return analysis.indicators.completion.length;
+}
+/**
+ * Check if output contains explicit exit signal
+ */
+export function hasExitSignal(output) {
+    return /EXIT_SIGNAL:\s*true/i.test(output) || /<promise>COMPLETE<\/promise>/i.test(output);
+}
+//# sourceMappingURL=semantic-analyzer.js.map

package/dist/loop/semantic-analyzer.js.map

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

package/dist/loop/skills.d.ts

@@ -0,0 +1,29 @@
+export interface ClaudeSkill {
+    name: string;
+    path: string;
+    description?: string;
+    source: 'global' | 'project' | 'skills.sh';
+}
+/**
+ * Detect Claude Code skills from various sources
+ */
+export declare function detectClaudeSkills(cwd: string): ClaudeSkill[];
+/**
+ * Get skills relevant to a specific tech stack
+ */
+export declare function getRelevantSkills(skills: ClaudeSkill[], techStack: {
+    frontend?: string;
+    backend?: string;
+    database?: string;
+    styling?: string;
+    language?: string;
+}): ClaudeSkill[];
+/**
+ * Format skills for inclusion in agent prompt
+ */
+export declare function formatSkillsForPrompt(skills: ClaudeSkill[]): string;
+/**
+ * Check if any skills are available
+ */
+export declare function hasSkills(cwd: string): boolean;
+//# sourceMappingURL=skills.d.ts.map

package/dist/loop/skills.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"skills.d.ts","sourceRoot":"","sources":["../../src/loop/skills.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,CAAC;CAC5C;AAgCD;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,WAAW,EAAE,CA+E7D;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,MAAM,EAAE,WAAW,EAAE,EACrB,SAAS,EAAE;IACT,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GACA,WAAW,EAAE,CA0Cf;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAanE;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAE9C"}

package/dist/loop/skills.js

@@ -0,0 +1,174 @@
+import { existsSync, readdirSync, readFileSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join } from 'node:path';
+/**
+ * Extract skill description from markdown content
+ * Looks for first paragraph after title
+ */
+function extractDescription(content) {
+    const lines = content.split('\n');
+    let foundTitle = false;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        // Skip empty lines before title
+        if (!foundTitle && !trimmed)
+            continue;
+        // Found title (heading)
+        if (trimmed.startsWith('#')) {
+            foundTitle = true;
+            continue;
+        }
+        // After title, get first non-empty line as description
+        if (foundTitle && trimmed && !trimmed.startsWith('#')) {
+            // Clean up the description
+            return trimmed.slice(0, 100) + (trimmed.length > 100 ? '...' : '');
+        }
+    }
+    return undefined;
+}
+/**
+ * Detect Claude Code skills from various sources
+ */
+export function detectClaudeSkills(cwd) {
+    const skills = [];
+    // 1. Check global skills directory (~/.claude/skills/)
+    const globalSkillsDir = join(homedir(), '.claude', 'skills');
+    if (existsSync(globalSkillsDir)) {
+        try {
+            const files = readdirSync(globalSkillsDir);
+            for (const file of files) {
+                if (file.endsWith('.md')) {
+                    const skillPath = join(globalSkillsDir, file);
+                    const content = readFileSync(skillPath, 'utf-8');
+                    skills.push({
+                        name: file.replace('.md', ''),
+                        path: skillPath,
+                        description: extractDescription(content),
+                        source: 'global',
+                    });
+                }
+            }
+        }
+        catch {
+            // Directory not readable
+        }
+    }
+    // 2. Check project skills directory (.claude/skills/)
+    const projectSkillsDir = join(cwd, '.claude', 'skills');
+    if (existsSync(projectSkillsDir)) {
+        try {
+            const files = readdirSync(projectSkillsDir);
+            for (const file of files) {
+                if (file.endsWith('.md')) {
+                    const skillPath = join(projectSkillsDir, file);
+                    const content = readFileSync(skillPath, 'utf-8');
+                    skills.push({
+                        name: file.replace('.md', ''),
+                        path: skillPath,
+                        description: extractDescription(content),
+                        source: 'project',
+                    });
+                }
+            }
+        }
+        catch {
+            // Directory not readable
+        }
+    }
+    // 3. Check for skills.sh script (common pattern for skill installation)
+    const skillsShPaths = [
+        join(cwd, 'skills.sh'),
+        join(cwd, '.claude', 'skills.sh'),
+        join(homedir(), '.claude', 'skills.sh'),
+    ];
+    for (const skillsShPath of skillsShPaths) {
+        if (existsSync(skillsShPath)) {
+            try {
+                const content = readFileSync(skillsShPath, 'utf-8');
+                // Parse skills from skills.sh
+                // Common patterns: skill names in comments or install commands
+                const skillMatches = content.match(/# Skill: (.+)/gi);
+                if (skillMatches) {
+                    for (const match of skillMatches) {
+                        const name = match.replace(/# Skill: /i, '').trim();
+                        skills.push({
+                            name,
+                            path: skillsShPath,
+                            description: 'From skills.sh',
+                            source: 'skills.sh',
+                        });
+                    }
+                }
+            }
+            catch {
+                // File not readable
+            }
+        }
+    }
+    return skills;
+}
+/**
+ * Get skills relevant to a specific tech stack
+ */
+export function getRelevantSkills(skills, techStack) {
+    const relevantKeywords = [];
+    // Build list of relevant keywords from tech stack
+    if (techStack.frontend)
+        relevantKeywords.push(techStack.frontend.toLowerCase());
+    if (techStack.backend)
+        relevantKeywords.push(techStack.backend.toLowerCase());
+    if (techStack.database)
+        relevantKeywords.push(techStack.database.toLowerCase());
+    if (techStack.styling)
+        relevantKeywords.push(techStack.styling.toLowerCase());
+    if (techStack.language)
+        relevantKeywords.push(techStack.language.toLowerCase());
+    // Add related keywords
+    const expansions = {
+        react: ['jsx', 'component', 'hook'],
+        nextjs: ['react', 'ssr', 'app-router'],
+        astro: ['static', 'island'],
+        vue: ['composition', 'template'],
+        svelte: ['component', 'reactive'],
+        nodejs: ['node', 'npm', 'javascript'],
+        express: ['api', 'rest', 'middleware'],
+        fastify: ['api', 'rest'],
+        postgres: ['sql', 'database', 'pg'],
+        mongodb: ['nosql', 'document', 'mongo'],
+        tailwind: ['css', 'utility', 'style'],
+        typescript: ['ts', 'type', 'typed'],
+    };
+    for (const keyword of [...relevantKeywords]) {
+        const expanded = expansions[keyword];
+        if (expanded) {
+            relevantKeywords.push(...expanded);
+        }
+    }
+    // Filter skills by relevance
+    return skills.filter((skill) => {
+        const nameLower = skill.name.toLowerCase();
+        const descLower = (skill.description || '').toLowerCase();
+        return relevantKeywords.some((keyword) => nameLower.includes(keyword) || descLower.includes(keyword));
+    });
+}
+/**
+ * Format skills for inclusion in agent prompt
+ */
+export function formatSkillsForPrompt(skills) {
+    if (skills.length === 0)
+        return '';
+    const lines = ['## Available Claude Code Skills', ''];
+    for (const skill of skills) {
+        lines.push(`- **${skill.name}**: ${skill.description || 'No description'}`);
+    }
+    lines.push('');
+    lines.push('Use these skills when appropriate by invoking them with /skill-name.');
+    return lines.join('\n');
+}
+/**
+ * Check if any skills are available
+ */
+export function hasSkills(cwd) {
+    return detectClaudeSkills(cwd).length > 0;
+}
+//# sourceMappingURL=skills.js.map

package/dist/loop/skills.js.map

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

package/dist/loop/step-detector.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Step detector for Claude Code JSONL output
+ *
+ * Parses the stream-json output from Claude Code CLI and detects
+ * what step the agent is currently performing.
+ */
+/**
+ * Detect the current step from a JSON output line
+ * Returns human-readable step description or null if not detectable
+ */
+export declare function detectStepFromOutput(line: string): string | null;
+/**
+ * Extract text content from JSONL output
+ * Returns the human-readable text that should be shown to user
+ */
+export declare function extractTextFromOutput(line: string): string | null;
+//# sourceMappingURL=step-detector.d.ts.map

package/dist/loop/step-detector.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"step-detector.d.ts","sourceRoot":"","sources":["../../src/loop/step-detector.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAsBH;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAoQhE;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CA+BjE"}