@hivehub/rulebook 5.4.0 → 5.4.1

package/templates/skills/workflows/ralph/install.sh

@@ -1,87 +1,87 @@
-#!/bin/bash
-# Ralph Autonomous Loop Skill Installation
-# This script is executed when users run: rulebook init or rulebook skill enable ralph
-
-set -e
-
-echo "🔧 Installing Ralph Autonomous Loop Skill..."
-
-# Check if rulebook is installed
-if ! command -v rulebook &> /dev/null; then
-  echo "❌ Error: @hivehub/rulebook not found"
-  echo "   Install with: npm install -g @hivehub/rulebook"
-  exit 1
-fi
-
-# Check if .rulebook config exists
-if [ ! -f ".rulebook" ]; then
-  echo "❌ Error: .rulebook config not found"
-  echo "   Run: rulebook init"
-  exit 1
-fi
-
-# Enable Ralph in .rulebook config
-echo "📝 Enabling Ralph in .rulebook..."
-if grep -q '"ralph"' .rulebook; then
-  # Ralph section exists, update enabled flag
-  sed -i.bak 's/"enabled": false/"enabled": true/g' .rulebook && rm -f .rulebook.bak
-else
-  # Add Ralph section to config
-  # Insert before closing }
-  sed -i.bak '$ s/}/,\n  "ralph": {\n    "enabled": true,\n    "maxIterations": 10,\n    "tool": "claude",\n    "maxContextLoss": 3\n  }\n}/' .rulebook && rm -f .rulebook.bak
-fi
-
-# Create Ralph directories
-echo "📁 Creating Ralph directories..."
-mkdir -p .rulebook-ralph/history
-
-# Create initial PRD if tasks exist
-if [ -d ".rulebook/tasks" ] && [ "$(ls -A .rulebook/tasks)" ]; then
-  echo "📋 Generating PRD from existing tasks..."
-  rulebook ralph init || echo "⚠️  Could not auto-generate PRD. Run: rulebook ralph init"
-else
-  echo "💡 No tasks found. Create tasks first: rulebook task create <task-id>"
-fi
-
-# Create .cursorrules entry for Ralph if working with Claude Code
-if [ -f ".cursorrules" ]; then
-  echo "🔗 Updating .cursorrules for Ralph..."
-  cat >> .cursorrules << 'EOF'
-
-## Ralph Autonomous Loop
-
-When working with Ralph autonomous loop:
-
-1. **Before each iteration**:
-   - Read .rulebook-ralph/prd.json for task specifications
-   - Read .rulebook-ralph/progress.txt for past learnings
-   - Reference recent git commits for architectural context
-
-2. **During implementation**:
-   - Focus on ONE task from PRD
-   - Apply patterns from progress.txt
-   - Write tests first (95%+ coverage required)
-
-3. **After implementation**:
-   - Run quality gates: type-check, lint, tests, coverage
-   - Commit with clear message including iteration number
-   - Ralph will update progress.txt with learnings
-
-4. **Commands**:
-   - Check status: rulebook ralph status
-   - View history: rulebook ralph history
-   - Pause loop: rulebook ralph pause (Ctrl+C)
-   - Resume: rulebook ralph resume
-EOF
-fi
-
-echo ""
-echo "✅ Ralph Autonomous Loop Skill Installed!"
-echo ""
-echo "📖 Next steps:"
-echo "   1. Create tasks: rulebook task create <task-id>"
-echo "   2. Initialize Ralph: rulebook ralph init"
-echo "   3. Start loop: rulebook ralph run [--max-iterations N] [--tool claude]"
-echo "   4. Monitor: rulebook ralph status"
-echo ""
-echo "📚 For more info: rulebook ralph --help"
+#!/bin/bash
+# Ralph Autonomous Loop Skill Installation
+# This script is executed when users run: rulebook init or rulebook skill enable ralph
+
+set -e
+
+echo "🔧 Installing Ralph Autonomous Loop Skill..."
+
+# Check if rulebook is installed
+if ! command -v rulebook &> /dev/null; then
+  echo "❌ Error: @hivehub/rulebook not found"
+  echo "   Install with: npm install -g @hivehub/rulebook"
+  exit 1
+fi
+
+# Check if .rulebook config exists
+if [ ! -f ".rulebook" ]; then
+  echo "❌ Error: .rulebook config not found"
+  echo "   Run: rulebook init"
+  exit 1
+fi
+
+# Enable Ralph in .rulebook config
+echo "📝 Enabling Ralph in .rulebook..."
+if grep -q '"ralph"' .rulebook; then
+  # Ralph section exists, update enabled flag
+  sed -i.bak 's/"enabled": false/"enabled": true/g' .rulebook && rm -f .rulebook.bak
+else
+  # Add Ralph section to config
+  # Insert before closing }
+  sed -i.bak '$ s/}/,\n  "ralph": {\n    "enabled": true,\n    "maxIterations": 10,\n    "tool": "claude",\n    "maxContextLoss": 3\n  }\n}/' .rulebook && rm -f .rulebook.bak
+fi
+
+# Create Ralph directories
+echo "📁 Creating Ralph directories..."
+mkdir -p .rulebook-ralph/history
+
+# Create initial PRD if tasks exist
+if [ -d ".rulebook/tasks" ] && [ "$(ls -A .rulebook/tasks)" ]; then
+  echo "📋 Generating PRD from existing tasks..."
+  rulebook ralph init || echo "⚠️  Could not auto-generate PRD. Run: rulebook ralph init"
+else
+  echo "💡 No tasks found. Create tasks first: rulebook task create <task-id>"
+fi
+
+# Create .cursorrules entry for Ralph if working with Claude Code
+if [ -f ".cursorrules" ]; then
+  echo "🔗 Updating .cursorrules for Ralph..."
+  cat >> .cursorrules << 'EOF'
+
+## Ralph Autonomous Loop
+
+When working with Ralph autonomous loop:
+
+1. **Before each iteration**:
+   - Read .rulebook-ralph/prd.json for task specifications
+   - Read .rulebook-ralph/progress.txt for past learnings
+   - Reference recent git commits for architectural context
+
+2. **During implementation**:
+   - Focus on ONE task from PRD
+   - Apply patterns from progress.txt
+   - Write tests first (95%+ coverage required)
+
+3. **After implementation**:
+   - Run quality gates: type-check, lint, tests, coverage
+   - Commit with clear message including iteration number
+   - Ralph will update progress.txt with learnings
+
+4. **Commands**:
+   - Check status: rulebook ralph status
+   - View history: rulebook ralph history
+   - Pause loop: rulebook ralph pause (Ctrl+C)
+   - Resume: rulebook ralph resume
+EOF
+fi
+
+echo ""
+echo "✅ Ralph Autonomous Loop Skill Installed!"
+echo ""
+echo "📖 Next steps:"
+echo "   1. Create tasks: rulebook task create <task-id>"
+echo "   2. Initialize Ralph: rulebook ralph init"
+echo "   3. Start loop: rulebook ralph run [--max-iterations N] [--tool claude]"
+echo "   4. Monitor: rulebook ralph status"
+echo ""
+echo "📚 For more info: rulebook ralph --help"

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

@@ -1,158 +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"
-      ]
-    }
-  }
-}
+{
+  "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/templates/workflows/codespell.yml

@@ -1,31 +1,31 @@
-name: Codespell
-
-on:
-  push:
-    branches: [ master, main, develop ]
-  pull_request:
-    branches: [ master, main, develop ]
-
-permissions:
-  contents: read
-
-jobs:
-  codespell:
-    name: Check for spelling errors
-    runs-on: ubuntu-latest
-
-    steps:
-      - name: Checkout
-        uses: actions/checkout@v5
-
-      - name: Install Codespell
-        run: python -m pip install --upgrade 'codespell[toml]'
-
-      - name: Run Codespell
-        run: |
-          codespell \
-            --skip="*.lock,*.json,*.map,*.yaml,*.yml,*.csv,*.bib,target,node_modules,.git,dist,venv,build,benchmarks,coverage" \
-            --ignore-words-list="crate,ser,deser,upToDate,optIn,shouldBe,Bloc"
-          # MONOREPO NOTE: Add multilingual stopwords to ignore-words-list if needed
-          # Example: --ignore-words-list="crate,ser,deser,meu,oder,ist,alle" (Portuguese,German,etc)
-
+name: Codespell
+
+on:
+  push:
+    branches: [ master, main, develop ]
+  pull_request:
+    branches: [ master, main, develop ]
+
+permissions:
+  contents: read
+
+jobs:
+  codespell:
+    name: Check for spelling errors
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v5
+
+      - name: Install Codespell
+        run: python -m pip install --upgrade 'codespell[toml]'
+
+      - name: Run Codespell
+        run: |
+          codespell \
+            --skip="*.lock,*.json,*.map,*.yaml,*.yml,*.csv,*.bib,target,node_modules,.git,dist,venv,build,benchmarks,coverage" \
+            --ignore-words-list="crate,ser,deser,upToDate,optIn,shouldBe,Bloc"
+          # MONOREPO NOTE: Add multilingual stopwords to ignore-words-list if needed
+          # Example: --ignore-words-list="crate,ser,deser,meu,oder,ist,alle" (Portuguese,German,etc)
+

package/templates/workflows/cpp-lint.yml

@@ -1,47 +1,47 @@
-name: C++ Lint
-
-on:
-  push:
-    branches: [ master, main, develop ]
-  pull_request:
-    branches: [ '**' ]
-
-jobs:
-  lint:
-    runs-on: ubuntu-latest
-    
-    steps:
-    - uses: actions/checkout@v5
-    
-    - name: Install dependencies
-      run: |
-        sudo apt-get update
-        sudo apt-get install -y clang-format-15 clang-tidy-15 cppcheck cmake ninja-build
-    
-    - name: Check formatting
-      run: |
-        find src include tests -name '*.cpp' -o -name '*.hpp' -o -name '*.h' | \
-        xargs clang-format-15 --dry-run --Werror
-    
-    - name: Configure CMake (for compile commands)
-      run: cmake -B build -G Ninja -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
-    
-    - name: Run clang-tidy
-      run: |
-        find src -name '*.cpp' | \
-        xargs clang-tidy-15 -p build --warnings-as-errors='*'
-    
-    - name: Run cppcheck
-      run: |
-        cppcheck --enable=all --error-exitcode=1 \
-          --suppress=missingIncludeSystem \
-          --suppress=unmatchedSuppression \
-          --inline-suppr \
-          -I include \
-          src/ tests/
-    
-    - name: Build with warnings as errors
-      run: |
-        cmake -B build -G Ninja -DCMAKE_CXX_FLAGS="-Wall -Wextra -Wpedantic -Werror"
-        cmake --build build
-
+name: C++ Lint
+
+on:
+  push:
+    branches: [ master, main, develop ]
+  pull_request:
+    branches: [ '**' ]
+
+jobs:
+  lint:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v5
+    
+    - name: Install dependencies
+      run: |
+        sudo apt-get update
+        sudo apt-get install -y clang-format-15 clang-tidy-15 cppcheck cmake ninja-build
+    
+    - name: Check formatting
+      run: |
+        find src include tests -name '*.cpp' -o -name '*.hpp' -o -name '*.h' | \
+        xargs clang-format-15 --dry-run --Werror
+    
+    - name: Configure CMake (for compile commands)
+      run: cmake -B build -G Ninja -DCMAKE_EXPORT_COMPILE_COMMANDS=ON
+    
+    - name: Run clang-tidy
+      run: |
+        find src -name '*.cpp' | \
+        xargs clang-tidy-15 -p build --warnings-as-errors='*'
+    
+    - name: Run cppcheck
+      run: |
+        cppcheck --enable=all --error-exitcode=1 \
+          --suppress=missingIncludeSystem \
+          --suppress=unmatchedSuppression \
+          --inline-suppr \
+          -I include \
+          src/ tests/
+    
+    - name: Build with warnings as errors
+      run: |
+        cmake -B build -G Ninja -DCMAKE_CXX_FLAGS="-Wall -Wextra -Wpedantic -Werror"
+        cmake --build build
+