agentic-loop 3.12.3 → 3.14.1

package/dist/loopgram/index.js

@@ -0,0 +1,246 @@
+#!/usr/bin/env tsx
+import { Telegraf } from 'telegraf';
+import { readFileSync, existsSync } from 'fs';
+import { join } from 'path';
+import { handleMessage, handleSaveCommand, handleClearCommand, handleProjectsCommand, handleStatusCommand, setConversationContext, getConversationContext, getHistory, clearConversation, } from './conversation.js';
+import { parseProgressFile, formatLoopStatus } from './loop-monitor.js';
+import { getTopicContext } from './context-search.js';
+import { generateStories, appendToPRD } from './prd-generator.js';
+import { startLoop, stopLoop } from './loop-runner.js';
+// Load configuration
+function loadConfig() {
+    const configPath = join(process.env.HOME || '', '.config/ralph/loopgram.json');
+    if (!existsSync(configPath)) {
+        console.error(`Config file not found: ${configPath}`);
+        console.error('Create it with your Telegram user ID and project mappings.');
+        console.error('See setup instructions in the README.');
+        process.exit(1);
+    }
+    try {
+        const content = readFileSync(configPath, 'utf-8');
+        return JSON.parse(content);
+    }
+    catch (error) {
+        console.error(`Error reading config: ${error}`);
+        process.exit(1);
+    }
+}
+// Get project config for a chat ID
+function getProject(chatId, config) {
+    return config.projects[chatId] || null;
+}
+// Get project path for a chat ID
+function getProjectPath(chatId, config) {
+    const project = config.projects[chatId];
+    return project?.path || null;
+}
+// Main entry point
+async function main() {
+    // Check for bot token
+    const token = process.env.TELEGRAM_BOT_TOKEN;
+    if (!token) {
+        console.error('TELEGRAM_BOT_TOKEN environment variable is required');
+        console.error('Set it in ~/.config/ralph/secrets and source the file');
+        process.exit(1);
+    }
+    // Check for Anthropic API key
+    if (!process.env.ANTHROPIC_API_KEY) {
+        console.error('ANTHROPIC_API_KEY environment variable is required');
+        console.error('Set it in ~/.config/ralph/secrets and source the file');
+        process.exit(1);
+    }
+    const config = loadConfig();
+    const bot = new Telegraf(token);
+    // Security middleware: only respond to allowed users
+    bot.use((ctx, next) => {
+        const userId = ctx.from?.id.toString();
+        if (!userId || !config.telegram.allowedUserIds.includes(userId)) {
+            // Silently ignore messages from unauthorized users
+            return;
+        }
+        return next();
+    });
+    // Logging middleware: log unknown group IDs for easy config setup
+    bot.use((ctx, next) => {
+        const chatId = ctx.chat?.id.toString();
+        if (chatId && !config.projects[chatId]) {
+            console.log(`Unknown chat ID: ${chatId} - add to config to enable`);
+        }
+        return next();
+    });
+    // Command handlers
+    bot.command('save', (ctx) => {
+        const chatId = ctx.chat?.id.toString();
+        const projectPath = chatId ? getProjectPath(chatId, config) : null;
+        return handleSaveCommand(ctx, projectPath, config);
+    });
+    bot.command('clear', handleClearCommand);
+    bot.command('projects', (ctx) => handleProjectsCommand(ctx, config));
+    bot.command('status', (ctx) => {
+        const chatId = ctx.chat?.id.toString();
+        const projectPath = chatId ? getProjectPath(chatId, config) : null;
+        return handleStatusCommand(ctx, projectPath, config);
+    });
+    bot.command('help', (ctx) => {
+        ctx.reply(`📱 **Loopgram**\n\n` +
+            `Your mobile connection to agentic-loop.\n\n` +
+            `**Workflow:**\n` +
+            `/context <topic> - Load codebase context\n` +
+            `(chat about your idea)\n` +
+            `/prd - Generate stories from conversation\n` +
+            `/start-loop - Start Ralph to execute stories\n` +
+            `/loop - Check Ralph progress\n` +
+            `/stop-loop - Stop Ralph loop\n\n` +
+            `**Other:**\n` +
+            `/save - Save conversation as idea file\n` +
+            `/clear - Clear conversation history\n` +
+            `/status - Show current session info\n` +
+            `/projects - List configured projects\n` +
+            `/help - Show this message`);
+    });
+    // /loop command - check Ralph loop status
+    bot.command('loop', (ctx) => {
+        const chatId = ctx.chat?.id.toString();
+        const project = chatId ? getProject(chatId, config) : null;
+        if (!project) {
+            ctx.reply('This chat is not configured for a project.');
+            return;
+        }
+        const status = parseProgressFile(project.path);
+        if (!status) {
+            ctx.reply(`No Ralph loop running in ${project.name}. Start one with /start-loop`);
+            return;
+        }
+        ctx.reply(formatLoopStatus(status, project.name));
+    });
+    // /prd command - generate stories from conversation
+    bot.command('prd', async (ctx) => {
+        const chatId = ctx.chat?.id;
+        const chatIdStr = chatId?.toString();
+        const project = chatIdStr ? getProject(chatIdStr, config) : null;
+        if (!project || !chatId) {
+            ctx.reply('This chat is not configured for a project.');
+            return;
+        }
+        const history = getHistory(chatId);
+        if (history.length < 2) {
+            ctx.reply('Nothing to generate. Start a conversation first!');
+            return;
+        }
+        await ctx.reply('🔄 Generating stories from conversation...');
+        try {
+            const context = getConversationContext(chatId);
+            const { featureName, featureDescription, stories } = await generateStories(history, context, config.anthropic.model);
+            const { added, total } = appendToPRD(project.path, featureName, featureDescription, stories);
+            // Format story list
+            const storyList = stories.map((s) => `• ${s.title}`).join('\n');
+            await ctx.reply(`✅ Added ${added} stories to PRD (${total} total)\n\n` +
+                `**${featureName}**\n${storyList}\n\n` +
+                `Use /start-loop to execute.`);
+            // Clear conversation after generating PRD
+            clearConversation(chatId);
+        }
+        catch (error) {
+            console.error('PRD generation error:', error);
+            await ctx.reply('Error generating stories. Check the logs.');
+        }
+    });
+    // /start-loop command - start Ralph loop
+    bot.command('start_loop', (ctx) => {
+        const chatId = ctx.chat?.id.toString();
+        const project = chatId ? getProject(chatId, config) : null;
+        if (!project) {
+            ctx.reply('This chat is not configured for a project.');
+            return;
+        }
+        const result = startLoop(project.path);
+        if (result.success) {
+            ctx.reply(`🚀 ${result.message}`);
+        }
+        else {
+            ctx.reply(`❌ ${result.message}`);
+        }
+    });
+    // /stop-loop command - stop Ralph loop
+    bot.command('stop_loop', (ctx) => {
+        const chatId = ctx.chat?.id.toString();
+        const project = chatId ? getProject(chatId, config) : null;
+        if (!project) {
+            ctx.reply('This chat is not configured for a project.');
+            return;
+        }
+        const result = stopLoop(project.path);
+        if (result.success) {
+            ctx.reply(`✅ ${result.message}`);
+        }
+        else {
+            ctx.reply(`❌ ${result.message}`);
+        }
+    });
+    // /context command - search codebase for a topic
+    bot.command('context', async (ctx) => {
+        const chatId = ctx.chat?.id.toString();
+        const project = chatId ? getProject(chatId, config) : null;
+        if (!project) {
+            ctx.reply('This chat is not configured for a project.');
+            return;
+        }
+        // Extract topic from command
+        const text = ctx.message?.text || '';
+        const topic = text.replace(/^\/context\s*/i, '').trim();
+        if (!topic) {
+            ctx.reply('Usage: /context <topic>\nExample: /context authentication');
+            return;
+        }
+        await ctx.reply(`🔍 Searching ${project.name} for "${topic}"...`);
+        try {
+            const { summary, filesFound, searchTerms } = await getTopicContext(project.path, project.name, topic, config.anthropic.model);
+            // Store this context for the conversation
+            if (chatId) {
+                setConversationContext(parseInt(chatId), summary);
+            }
+            let response = `🔍 Searched for: ${searchTerms.join(', ')}\n\n`;
+            response += `📁 Found ${filesFound.length} files:\n`;
+            response += filesFound.slice(0, 5).map(f => `• ${f}`).join('\n');
+            if (filesFound.length > 5) {
+                response += `\n...and ${filesFound.length - 5} more`;
+            }
+            response += `\n\n${summary}`;
+            response += `\n\n💡 Context loaded! Now brainstorm away.`;
+            await ctx.reply(response);
+        }
+        catch (error) {
+            console.error('Context search error:', error);
+            await ctx.reply('Error searching codebase. Check the logs.');
+        }
+    });
+    // Handle regular text messages
+    bot.on('text', (ctx) => {
+        const chatId = ctx.chat?.id.toString();
+        const project = chatId ? getProject(chatId, config) : null;
+        return handleMessage(ctx, config, project);
+    });
+    // Start the bot
+    console.log('📱 Loopgram starting...');
+    console.log(`Model: ${config.anthropic.model}`);
+    console.log(`Configured projects: ${Object.values(config.projects)
+        .map((p) => p.name)
+        .join(', ') || 'none'}`);
+    console.log(`Allowed users: ${config.telegram.allowedUserIds.length} configured`);
+    await bot.launch();
+    console.log('✅ Loopgram running! Send messages in Telegram.');
+    // Graceful shutdown
+    process.once('SIGINT', () => {
+        console.log('\nShutting down...');
+        bot.stop('SIGINT');
+    });
+    process.once('SIGTERM', () => {
+        console.log('\nShutting down...');
+        bot.stop('SIGTERM');
+    });
+}
+main().catch((error) => {
+    console.error('Fatal error:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/loopgram/index.js.map

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

package/dist/loopgram/loop-monitor.d.ts

@@ -0,0 +1,16 @@
+import type { LoopStatus } from './types.js';
+/**
+ * Parse the Ralph progress file to get loop status
+ * Format: [ISO-timestamp] STATUS story_id message
+ * Statuses: COMPLETED, FAILED, CLI_CRASH, TIMEOUT, BLOCKED
+ */
+export declare function parseProgressFile(projectPath: string): LoopStatus | null;
+/**
+ * Format loop status for Telegram message
+ */
+export declare function formatLoopStatus(status: LoopStatus, projectName: string): string;
+/**
+ * Watch a project's progress file for changes
+ */
+export declare function watchProgress(projectPath: string, _projectName: string, onUpdate: (status: LoopStatus, changeType: 'started' | 'completed' | 'error' | 'update') => void): () => void;
+//# sourceMappingURL=loop-monitor.d.ts.map

package/dist/loopgram/loop-monitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-monitor.d.ts","sourceRoot":"","sources":["../../src/loopgram/loop-monitor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C;;;;GAIG;AACH,wBAAgB,iBAAiB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA6ExE;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,CAyBhF;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,QAAQ,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,QAAQ,KAAK,IAAI,GAC/F,MAAM,IAAI,CAiDZ"}

package/dist/loopgram/loop-monitor.js

@@ -0,0 +1,149 @@
+import { readFileSync, existsSync, watchFile, unwatchFile } from 'fs';
+import { join } from 'path';
+// Track last known state per project to detect changes
+const lastState = new Map();
+/**
+ * Parse the Ralph progress file to get loop status
+ * Format: [ISO-timestamp] STATUS story_id message
+ * Statuses: COMPLETED, FAILED, CLI_CRASH, TIMEOUT, BLOCKED
+ */
+export function parseProgressFile(projectPath) {
+    const progressPath = join(projectPath, '.ralph/progress.txt');
+    if (!existsSync(progressPath)) {
+        return null;
+    }
+    try {
+        const content = readFileSync(progressPath, 'utf-8');
+        const lines = content.split('\n').filter(Boolean);
+        // Only look at recent lines (last 50)
+        const recentLines = lines.slice(-50);
+        const errors = [];
+        const completedStoryIds = new Set();
+        let currentStory = null;
+        let lastUpdate = '';
+        let isRunning = false;
+        let hasRalphActivity = false;
+        // Ralph log format: [timestamp] STATUS story_id message
+        const logPattern = /^\[([^\]]+)\]\s+(COMPLETED|FAILED|CLI_CRASH|TIMEOUT|BLOCKED)\s+(\S+)(.*)$/;
+        for (const line of recentLines) {
+            const match = line.match(logPattern);
+            if (match) {
+                hasRalphActivity = true;
+                const [, timestamp, status, storyId, message] = match;
+                lastUpdate = timestamp;
+                if (status === 'COMPLETED') {
+                    completedStoryIds.add(storyId);
+                    if (currentStory === storyId) {
+                        currentStory = null;
+                    }
+                }
+                else if (status === 'FAILED' || status === 'CLI_CRASH' || status === 'TIMEOUT') {
+                    errors.push(`${status} ${storyId}${message}`.trim());
+                    currentStory = storyId; // Still working on this story
+                    isRunning = true;
+                }
+            }
+            // Check for loop start/end markers
+            if (line.includes('Loop starting') || line.includes('Starting loop')) {
+                isRunning = true;
+                hasRalphActivity = true;
+            }
+            if (line.includes('Loop complete') || line.includes('All stories done')) {
+                isRunning = false;
+            }
+            // Try to get total stories
+            const totalMatch = line.match(/(\d+)\s*(?:stories|story)/i);
+            if (totalMatch) {
+                // Don't overwrite with smaller numbers
+            }
+        }
+        // If no Ralph activity found, return null
+        if (!hasRalphActivity) {
+            return null;
+        }
+        return {
+            isRunning,
+            currentStory,
+            completedStories: completedStoryIds.size,
+            totalStories: 0, // Would need to read PRD to know this
+            lastUpdate,
+            errors: errors.slice(-3),
+        };
+    }
+    catch (error) {
+        console.error('Error parsing progress file:', error);
+        return null;
+    }
+}
+/**
+ * Format loop status for Telegram message
+ */
+export function formatLoopStatus(status, projectName) {
+    const statusEmoji = status.isRunning ? '🔄' : '✅';
+    const progress = status.totalStories > 0
+        ? `${status.completedStories}/${status.totalStories}`
+        : `${status.completedStories} done`;
+    let message = `${statusEmoji} **${projectName}**\n`;
+    message += `Progress: ${progress}\n`;
+    if (status.currentStory) {
+        message += `Current: ${status.currentStory}\n`;
+    }
+    if (status.lastUpdate) {
+        message += `Updated: ${status.lastUpdate}\n`;
+    }
+    if (status.errors.length > 0) {
+        message += `\n⚠️ Recent errors:\n`;
+        for (const err of status.errors) {
+            message += `• ${err.substring(0, 100)}...\n`;
+        }
+    }
+    return message;
+}
+/**
+ * Watch a project's progress file for changes
+ */
+export function watchProgress(projectPath, _projectName, onUpdate) {
+    const progressPath = join(projectPath, '.ralph/progress.txt');
+    if (!existsSync(progressPath)) {
+        return () => { }; // No-op cleanup
+    }
+    // Store initial state
+    const initialContent = readFileSync(progressPath, 'utf-8');
+    lastState.set(projectPath, initialContent);
+    const checkForChanges = () => {
+        try {
+            const currentContent = readFileSync(progressPath, 'utf-8');
+            const previousContent = lastState.get(projectPath) || '';
+            if (currentContent !== previousContent) {
+                lastState.set(projectPath, currentContent);
+                const status = parseProgressFile(projectPath);
+                if (!status)
+                    return;
+                // Determine change type
+                let changeType = 'update';
+                const newLines = currentContent.substring(previousContent.length);
+                if (newLines.includes('✓') || newLines.includes('completed')) {
+                    changeType = 'completed';
+                }
+                else if (newLines.includes('✗') || newLines.includes('ERROR')) {
+                    changeType = 'error';
+                }
+                else if (newLines.includes('Starting') || newLines.includes('▶')) {
+                    changeType = 'started';
+                }
+                onUpdate(status, changeType);
+            }
+        }
+        catch (error) {
+            // File might be temporarily unavailable during write
+        }
+    };
+    // Watch for changes
+    watchFile(progressPath, { interval: 5000 }, checkForChanges);
+    // Return cleanup function
+    return () => {
+        unwatchFile(progressPath);
+        lastState.delete(projectPath);
+    };
+}
+//# sourceMappingURL=loop-monitor.js.map

package/dist/loopgram/loop-monitor.js.map

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

package/dist/loopgram/loop-runner.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Check if a Ralph loop is currently running for a project
+ */
+export declare function isLoopRunning(projectPath: string): boolean;
+/**
+ * Start a Ralph loop for a project
+ */
+export declare function startLoop(projectPath: string): {
+    success: boolean;
+    message: string;
+    pid?: number;
+};
+/**
+ * Stop a running Ralph loop
+ */
+export declare function stopLoop(projectPath: string): {
+    success: boolean;
+    message: string;
+};
+/**
+ * Get loop process info
+ */
+export declare function getLoopInfo(projectPath: string): {
+    running: boolean;
+    pid?: number;
+    logTail?: string;
+};
+//# sourceMappingURL=loop-runner.d.ts.map

package/dist/loopgram/loop-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop-runner.d.ts","sourceRoot":"","sources":["../../src/loopgram/loop-runner.ts"],"names":[],"mappings":"AAMA;;GAEG;AACH,wBAAgB,aAAa,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAsB1D;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAyDA;AAED;;GAEG;AACH,wBAAgB,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG;IAC7C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CA0CA;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG;IAChD,OAAO,EAAE,OAAO,CAAC;IACjB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CA2BA"}

package/dist/loopgram/loop-runner.js

@@ -0,0 +1,157 @@
+import { spawn } from 'child_process';
+import { existsSync, writeFileSync, readFileSync, unlinkSync } from 'fs';
+import { join } from 'path';
+const PID_FILE = '.ralph/loop.pid';
+/**
+ * Check if a Ralph loop is currently running for a project
+ */
+export function isLoopRunning(projectPath) {
+    const pidFile = join(projectPath, PID_FILE);
+    if (!existsSync(pidFile)) {
+        return false;
+    }
+    try {
+        const pid = parseInt(readFileSync(pidFile, 'utf-8').trim());
+        // Check if process is still running
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        // Process not running, clean up stale PID file
+        try {
+            unlinkSync(pidFile);
+        }
+        catch {
+            // Ignore cleanup errors
+        }
+        return false;
+    }
+}
+/**
+ * Start a Ralph loop for a project
+ */
+export function startLoop(projectPath) {
+    // Check if PRD exists
+    const prdPath = join(projectPath, '.ralph/prd.json');
+    if (!existsSync(prdPath)) {
+        return {
+            success: false,
+            message: 'No PRD found. Use /prd to create stories first.',
+        };
+    }
+    // Check if already running
+    if (isLoopRunning(projectPath)) {
+        return {
+            success: false,
+            message: 'Loop already running. Use /loop to check status.',
+        };
+    }
+    try {
+        // Start Ralph loop in background
+        const logFile = join(projectPath, '.ralph/loop.log');
+        // Use npx agentic-loop run
+        const child = spawn('npx', ['agentic-loop', 'run'], {
+            cwd: projectPath,
+            detached: true,
+            stdio: ['ignore', 'pipe', 'pipe'],
+            env: {
+                ...process.env,
+                // Ensure Claude runs non-interactively
+                CLAUDE_CODE_ENTRYPOINT: 'cli',
+            },
+        });
+        // Write output to log file
+        const logStream = require('fs').createWriteStream(logFile, { flags: 'a' });
+        child.stdout?.pipe(logStream);
+        child.stderr?.pipe(logStream);
+        // Save PID
+        const pidFile = join(projectPath, PID_FILE);
+        writeFileSync(pidFile, child.pid.toString());
+        // Detach child process
+        child.unref();
+        return {
+            success: true,
+            message: `Loop started (PID: ${child.pid}). Use /loop to check progress.`,
+            pid: child.pid,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            message: `Failed to start loop: ${error}`,
+        };
+    }
+}
+/**
+ * Stop a running Ralph loop
+ */
+export function stopLoop(projectPath) {
+    const pidFile = join(projectPath, PID_FILE);
+    if (!existsSync(pidFile)) {
+        return {
+            success: false,
+            message: 'No loop running.',
+        };
+    }
+    try {
+        const pid = parseInt(readFileSync(pidFile, 'utf-8').trim());
+        // Kill the process and its children
+        try {
+            // Kill process group (negative PID)
+            process.kill(-pid, 'SIGTERM');
+        }
+        catch {
+            // Try killing just the process
+            process.kill(pid, 'SIGTERM');
+        }
+        // Clean up PID file
+        unlinkSync(pidFile);
+        return {
+            success: true,
+            message: 'Loop stopped.',
+        };
+    }
+    catch (error) {
+        // Clean up PID file even if kill failed
+        try {
+            unlinkSync(pidFile);
+        }
+        catch {
+            // Ignore
+        }
+        return {
+            success: false,
+            message: `Error stopping loop: ${error}`,
+        };
+    }
+}
+/**
+ * Get loop process info
+ */
+export function getLoopInfo(projectPath) {
+    const pidFile = join(projectPath, PID_FILE);
+    const logFile = join(projectPath, '.ralph/loop.log');
+    const running = isLoopRunning(projectPath);
+    let pid;
+    let logTail;
+    if (existsSync(pidFile)) {
+        try {
+            pid = parseInt(readFileSync(pidFile, 'utf-8').trim());
+        }
+        catch {
+            // Ignore
+        }
+    }
+    if (existsSync(logFile)) {
+        try {
+            // Get last 500 chars of log
+            const content = readFileSync(logFile, 'utf-8');
+            logTail = content.slice(-500);
+        }
+        catch {
+            // Ignore
+        }
+    }
+    return { running, pid, logTail };
+}
+//# sourceMappingURL=loop-runner.js.map

package/dist/loopgram/loop-runner.js.map

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