@hivehub/rulebook 2.1.0 → 3.1.0

package/templates/skills/workflows/ralph/manifest.json

@@ -0,0 +1,158 @@
+{
+  "name": "Ralph Autonomous Loop",
+  "id": "ralph-autonomous-loop",
+  "version": "1.0.0",
+  "category": "workflow",
+  "description": "Autonomous AI agent loop for iterative task implementation using fresh context per iteration",
+  "author": "Rulebook",
+  "license": "Apache-2.0",
+  "homepage": "https://github.com/snarktank/ralph",
+  "tags": ["autonomous", "workflow", "iterative", "ai-agent", "task-management"],
+  "dependencies": {
+    "@hivehub/rulebook": ">=3.0.0"
+  },
+  "provides": {
+    "commands": [
+      {
+        "name": "ralph init",
+        "description": "Initialize Ralph configuration and create PRD from rulebook tasks",
+        "usage": "rulebook ralph init [--force]"
+      },
+      {
+        "name": "ralph run",
+        "description": "Execute autonomous iteration loop",
+        "usage": "rulebook ralph run [--max-iterations N] [--tool claude|amp|gemini]"
+      },
+      {
+        "name": "ralph status",
+        "description": "Show loop progress, completed tasks, and current iteration",
+        "usage": "rulebook ralph status"
+      },
+      {
+        "name": "ralph history",
+        "description": "Display iteration history and learnings",
+        "usage": "rulebook ralph history [--learnings]"
+      },
+      {
+        "name": "ralph pause",
+        "description": "Gracefully pause autonomous loop",
+        "usage": "rulebook ralph pause"
+      },
+      {
+        "name": "ralph resume",
+        "description": "Resume from paused state",
+        "usage": "rulebook ralph resume"
+      }
+    ],
+    "mcpTools": [
+      {
+        "name": "rulebook_ralph_init",
+        "description": "Initialize Ralph via MCP"
+      },
+      {
+        "name": "rulebook_ralph_run",
+        "description": "Start autonomous loop via MCP"
+      },
+      {
+        "name": "rulebook_ralph_status",
+        "description": "Query loop status via MCP"
+      },
+      {
+        "name": "rulebook_ralph_get_iteration_history",
+        "description": "Retrieve iteration history via MCP"
+      }
+    ]
+  },
+  "installation": {
+    "type": "bash",
+    "script": "install.sh",
+    "instructions": [
+      "Ralph will be enabled in your .rulebook configuration",
+      "Create rulebook tasks with: rulebook task create <task-id>",
+      "Initialize Ralph with: rulebook ralph init",
+      "Run autonomous loop with: rulebook ralph run"
+    ]
+  },
+  "configuration": {
+    "defaults": {
+      "ralph": {
+        "enabled": false,
+        "maxIterations": 10,
+        "tool": "claude",
+        "maxContextLoss": 3
+      }
+    },
+    "schema": {
+      "ralph.enabled": {
+        "type": "boolean",
+        "description": "Enable Ralph autonomous loop"
+      },
+      "ralph.maxIterations": {
+        "type": "integer",
+        "description": "Maximum iterations before stopping",
+        "minimum": 1,
+        "maximum": 1000
+      },
+      "ralph.tool": {
+        "type": "string",
+        "description": "AI CLI tool to use (claude, amp, gemini)",
+        "enum": ["claude", "amp", "gemini"]
+      },
+      "ralph.maxContextLoss": {
+        "type": "integer",
+        "description": "Tolerance for incomplete agent outputs",
+        "minimum": 1,
+        "maximum": 10
+      }
+    }
+  },
+  "requiredCapabilities": [
+    "task-management",
+    "git-integration",
+    "quality-gates"
+  ],
+  "relatedSkills": [
+    "claude-code",
+    "cline",
+    "cursor-cli",
+    "persistent-memory"
+  ],
+  "documentation": {
+    "readme": "SKILL.md",
+    "examples": [
+      {
+        "title": "Initialize Ralph",
+        "command": "rulebook ralph init"
+      },
+      {
+        "title": "Run autonomous loop with 10 iterations",
+        "command": "rulebook ralph run --max-iterations 10"
+      },
+      {
+        "title": "Check loop status",
+        "command": "rulebook ralph status"
+      },
+      {
+        "title": "View iteration history and learnings",
+        "command": "rulebook ralph history --learnings"
+      },
+      {
+        "title": "Pause and resume loop",
+        "command": "rulebook ralph pause && rulebook ralph resume"
+      }
+    ]
+  },
+  "changelog": {
+    "1.0.0": {
+      "date": "2026-02-26",
+      "changes": [
+        "Initial release of Ralph Autonomous Loop skill",
+        "Support for Claude Code, Amp, and Gemini CLI tools",
+        "Fresh context per iteration with memory persistence via git, PRD, and progress log",
+        "Quality gates enforcement (type-check, lint, tests)",
+        "Pause/resume capability",
+        "MCP server integration for programmatic access"
+      ]
+    }
+  }
+}

package/dist/core/modern-console-new.d.ts

@@ -1,81 +0,0 @@
-export interface ModernConsoleOptions {
-    projectRoot: string;
-    refreshInterval?: number;
-}
-interface ActivityLogEntry {
-    timestamp: Date;
-    type: 'info' | 'success' | 'warning' | 'error' | 'tool';
-    message: string;
-}
-/**
- * Simplified Progress-Focused Modern Console
- * New UI: Active Tasks + Progress Bar + Activity Logs
- */
-export declare class ModernConsole {
-    private screen;
-    private openspecManager;
-    private options;
-    private isRunning;
-    private refreshTimer?;
-    private animationFrame;
-    private headerBox;
-    private activeTasksBox;
-    private progressBox;
-    private logsBox;
-    private statusBar;
-    private tasks;
-    private activityLogs;
-    constructor(options: ModernConsoleOptions);
-    private setupUI;
-    private setupEventHandlers;
-    /**
-     * Get loading spinner frame
-     */
-    private getLoadingFrame;
-    /**
-     * Format duration in HH:MM:SS
-     */
-    private formatDuration;
-    /**
-     * Render active tasks (max 5, auto-remove completed)
-     */
-    private renderActiveTasks;
-    /**
-     * Render progress bar
-     */
-    private renderProgressBar;
-    /**
-     * Render activity logs (last 10 entries)
-     */
-    private renderActivityLogs;
-    /**
-     * Log activity
-     */
-    logActivity(type: ActivityLogEntry['type'], message: string): void;
-    /**
-     * Mark task as completed and remove from list
-     */
-    markTaskCompleted(taskId: string): void;
-    /**
-     * Mark task as in progress
-     */
-    markTaskInProgress(taskId: string): void;
-    /**
-     * Render all components
-     */
-    private render;
-    /**
-     * Start watching
-     */
-    start(): Promise<void>;
-    /**
-     * Stop watching
-     */
-    stop(): void;
-}
-/**
- * Factory function
- */
-export declare function createModernConsole(options: ModernConsoleOptions): ModernConsole;
-export {};
-//# sourceMappingURL=modern-console-new.d.ts.map

package/dist/core/modern-console-new.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"modern-console-new.d.ts","sourceRoot":"","sources":["../../src/core/modern-console-new.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,oBAAoB;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,gBAAgB;IACxB,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,CAAC;IACxD,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAyB;IACvC,OAAO,CAAC,eAAe,CAA2C;IAClE,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,cAAc,CAAK;IAG3B,OAAO,CAAC,SAAS,CAA8B;IAC/C,OAAO,CAAC,cAAc,CAA8B;IACpD,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,OAAO,CAA8B;IAC7C,OAAO,CAAC,SAAS,CAA8B;IAG/C,OAAO,CAAC,KAAK,CAAsB;IACnC,OAAO,CAAC,YAAY,CAA0B;gBAElC,OAAO,EAAE,oBAAoB;IAqBzC,OAAO,CAAC,OAAO;IA2Gf,OAAO,CAAC,kBAAkB;IAU1B;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAYtB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IA2BzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAuBzB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IA4B1B;;OAEG;IACI,WAAW,CAAC,IAAI,EAAE,gBAAgB,CAAC,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAezE;;OAEG;IACI,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAa9C;;OAEG;IACI,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAY/C;;OAEG;IACH,OAAO,CAAC,MAAM;IAOd;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAgC5B;;OAEG;IACH,IAAI,IAAI,IAAI;CAeb;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,aAAa,CAEhF"}

package/dist/core/modern-console-new.js

@@ -1,340 +0,0 @@
-import blessed from 'blessed';
-import { createOpenSpecManager } from './openspec-manager.js';
-/**
- * Simplified Progress-Focused Modern Console
- * New UI: Active Tasks + Progress Bar + Activity Logs
- */
-export class ModernConsole {
-    screen;
-    openspecManager;
-    options;
-    isRunning = false;
-    refreshTimer;
-    animationFrame = 0;
-    // UI Components
-    headerBox;
-    activeTasksBox;
-    progressBox;
-    logsBox;
-    statusBar;
-    // Data
-    tasks = [];
-    activityLogs = [];
-    constructor(options) {
-        this.options = {
-            refreshInterval: 100, // 100ms for smooth animations
-            ...options,
-        };
-        this.openspecManager = createOpenSpecManager(options.projectRoot);
-        this.screen = blessed.screen({
-            smartCSR: true,
-            title: 'Rulebook Watcher',
-            fullUnicode: true,
-            dockBorders: true,
-            autoPadding: true,
-            warnings: false,
-        });
-        this.setupUI();
-        this.setupEventHandlers();
-    }
-    setupUI() {
-        // Header (3 lines)
-        this.headerBox = blessed.box({
-            top: 0,
-            left: 0,
-            width: '100%',
-            height: 3,
-            content: '{center}{bold}{blue-fg}🤖 RULEBOOK WATCHER{/blue-fg}{/bold}                          {gray-fg}[F10 Exit]{/gray-fg}{/center}',
-            tags: true,
-            style: {
-                bg: 'blue',
-                fg: 'white',
-                bold: true,
-            },
-            border: {
-                type: 'line',
-                fg: 'blue',
-            },
-        });
-        // Active Tasks (25% of remaining space, ~6-8 lines)
-        this.activeTasksBox = blessed.box({
-            top: 3,
-            left: 0,
-            width: '100%',
-            height: '25%-3',
-            label: ' {bold}📋 ACTIVE TASKS{/bold} ',
-            tags: true,
-            scrollable: false,
-            style: {
-                fg: 'white',
-            },
-            border: {
-                type: 'line',
-                fg: 'cyan',
-            },
-        });
-        // Progress Bar (3 lines fixed)
-        this.progressBox = blessed.box({
-            top: '25%',
-            left: 0,
-            width: '100%',
-            height: 5,
-            label: ' {bold}📊 PROGRESS{/bold} ',
-            tags: true,
-            style: {
-                fg: 'white',
-            },
-            border: {
-                type: 'line',
-                fg: 'green',
-            },
-        });
-        // Activity Logs (remaining space, ~65%)
-        this.logsBox = blessed.box({
-            top: '30%',
-            left: 0,
-            width: '100%',
-            height: '68%-3',
-            label: ' {bold}📝 ACTIVITY LOGS{/bold} ',
-            tags: true,
-            scrollable: true,
-            alwaysScroll: true,
-            scrollbar: {
-                ch: ' ',
-                track: {
-                    bg: 'cyan',
-                },
-                style: {
-                    inverse: true,
-                },
-            },
-            style: {
-                fg: 'white',
-            },
-            border: {
-                type: 'line',
-                fg: 'yellow',
-            },
-        });
-        // Status Bar (1 line)
-        this.statusBar = blessed.box({
-            bottom: 0,
-            left: 0,
-            width: '100%',
-            height: 1,
-            content: ' Press F10 or Ctrl+C to exit',
-            tags: true,
-            style: {
-                bg: 'blue',
-                fg: 'white',
-            },
-        });
-        // Add to screen
-        this.screen.append(this.headerBox);
-        this.screen.append(this.activeTasksBox);
-        this.screen.append(this.progressBox);
-        this.screen.append(this.logsBox);
-        this.screen.append(this.statusBar);
-        this.screen.render();
-    }
-    setupEventHandlers() {
-        // Exit on F10 or Ctrl+C
-        this.screen.key(['f10', 'C-c'], () => {
-            this.stop();
-        });
-        // Focus logs box for scrolling
-        this.logsBox.focus();
-    }
-    /**
-     * Get loading spinner frame
-     */
-    getLoadingFrame() {
-        const frames = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
-        return frames[this.animationFrame % frames.length];
-    }
-    /**
-     * Format duration in HH:MM:SS
-     */
-    formatDuration(ms) {
-        const seconds = Math.floor(ms / 1000);
-        const minutes = Math.floor(seconds / 60);
-        const hours = Math.floor(minutes / 60);
-        const h = String(hours).padStart(2, '0');
-        const m = String(minutes % 60).padStart(2, '0');
-        const s = String(seconds % 60).padStart(2, '0');
-        return `${h}:${m}:${s}`;
-    }
-    /**
-     * Render active tasks (max 5, auto-remove completed)
-     */
-    renderActiveTasks() {
-        const activeTasks = this.tasks.filter(t => t.status !== 'completed').slice(0, 5);
-        if (activeTasks.length === 0) {
-            this.activeTasksBox.setContent('\n  {gray-fg}No active tasks{/gray-fg}');
-            return;
-        }
-        const lines = ['\n'];
-        for (const task of activeTasks) {
-            const icon = task.status === 'in-progress'
-                ? `{cyan-fg}${this.getLoadingFrame()}{/cyan-fg}`
-                : '{gray-fg}⏸ {/gray-fg}';
-            const status = task.status === 'in-progress' ? 'In Progress' : 'Pending';
-            const duration = task.status === 'in-progress' && task.metadata?.startedAt
-                ? ` | Duration: ${this.formatDuration(Date.now() - new Date(task.metadata.startedAt).getTime())}`
-                : '';
-            lines.push(`  ${icon} {bold}${task.title}{/bold}`);
-            lines.push(`     Status: ${status}${duration}\n`);
-        }
-        this.activeTasksBox.setContent(lines.join('\n'));
-    }
-    /**
-     * Render progress bar
-     */
-    renderProgressBar() {
-        const completed = this.tasks.filter(t => t.status === 'completed').length;
-        const total = this.tasks.length;
-        const percentage = total > 0 ? Math.round((completed / total) * 100) : 0;
-        // Calculate bar width (screen width - borders - padding)
-        const barWidth = Math.max(40, this.screen.width - 20);
-        const filledWidth = Math.round((percentage / 100) * barWidth);
-        const emptyWidth = barWidth - filledWidth;
-        const filled = '█'.repeat(filledWidth);
-        const empty = '░'.repeat(emptyWidth);
-        // Color based on progress
-        let color = 'green';
-        if (percentage < 50)
-            color = 'red';
-        else if (percentage < 75)
-            color = 'yellow';
-        const bar = `\n  {${color}-fg}${filled}{/}${empty} {bold}{white-fg}${percentage}%{/} {gray-fg}(${completed}/${total}){/}\n`;
-        this.progressBox.setContent(bar);
-    }
-    /**
-     * Render activity logs (last 10 entries)
-     */
-    renderActivityLogs() {
-        if (this.activityLogs.length === 0) {
-            this.logsBox.setContent('\n  {gray-fg}No activity yet{/gray-fg}');
-            return;
-        }
-        const LOG_ICONS = {
-            success: '{green-fg}✅{/}',
-            info: '{blue-fg}ℹ️ {/}',
-            warning: '{yellow-fg}⚠️ {/}',
-            error: '{red-fg}❌{/}',
-            tool: '{cyan-fg}🔧{/}',
-        };
-        const lines = this.activityLogs
-            .slice(-20) // Last 20 entries
-            .map(entry => {
-            const time = entry.timestamp.toLocaleTimeString('en-US', { hour12: false });
-            const icon = LOG_ICONS[entry.type];
-            return `{gray-fg}[${time}]{/} ${icon} ${entry.message}`;
-        });
-        this.logsBox.setContent('\n' + lines.join('\n') + '\n');
-        // Auto-scroll to bottom
-        this.logsBox.setScrollPerc(100);
-    }
-    /**
-     * Log activity
-     */
-    logActivity(type, message) {
-        this.activityLogs.push({
-            timestamp: new Date(),
-            type,
-            message,
-        });
-        // Keep only last 100 entries in memory
-        if (this.activityLogs.length > 100) {
-            this.activityLogs = this.activityLogs.slice(-100);
-        }
-        this.render();
-    }
-    /**
-     * Mark task as completed and remove from list
-     */
-    markTaskCompleted(taskId) {
-        const task = this.tasks.find(t => t.id === taskId);
-        if (task) {
-            task.status = 'completed';
-            this.logActivity('success', `Task completed: ${task.title}`);
-            // Remove from active tasks
-            this.tasks = this.tasks.filter(t => t.id !== taskId);
-            this.render();
-        }
-    }
-    /**
-     * Mark task as in progress
-     */
-    markTaskInProgress(taskId) {
-        const task = this.tasks.find(t => t.id === taskId);
-        if (task) {
-            task.status = 'in-progress';
-            if (!task.metadata)
-                task.metadata = {};
-            task.metadata.startedAt = new Date().toISOString();
-            this.logActivity('info', `Task started: ${task.title}`);
-            this.render();
-        }
-    }
-    /**
-     * Render all components
-     */
-    render() {
-        this.renderActiveTasks();
-        this.renderProgressBar();
-        this.renderActivityLogs();
-        this.screen.render();
-    }
-    /**
-     * Start watching
-     */
-    async start() {
-        if (this.isRunning) {
-            return;
-        }
-        this.isRunning = true;
-        try {
-            await this.openspecManager.initialize();
-            const data = await this.openspecManager.loadOpenSpec();
-            this.tasks = data.tasks;
-            this.logActivity('info', 'Watcher started');
-            this.render();
-            // Animation timer (for loading spinner)
-            this.refreshTimer = setInterval(() => {
-                this.animationFrame++;
-                // Only render if there are in-progress tasks (to show spinner)
-                const hasInProgress = this.tasks.some(t => t.status === 'in-progress');
-                if (hasInProgress) {
-                    this.render();
-                }
-            }, this.options.refreshInterval);
-        }
-        catch (error) {
-            this.logActivity('error', `Failed to start: ${error}`);
-            throw error;
-        }
-    }
-    /**
-     * Stop watching
-     */
-    stop() {
-        if (!this.isRunning) {
-            return;
-        }
-        this.isRunning = false;
-        if (this.refreshTimer) {
-            clearInterval(this.refreshTimer);
-            this.refreshTimer = undefined;
-        }
-        this.screen.destroy();
-        process.exit(0);
-    }
-}
-/**
- * Factory function
- */
-export function createModernConsole(options) {
-    return new ModernConsole(options);
-}
-//# sourceMappingURL=modern-console-new.js.map