@hivehub/rulebook 5.5.2 → 5.8.0

package/dist/memory/memory-vectorizer.js

@@ -1,199 +0,0 @@
-/**
- * TF-IDF Vectorizer with Feature Hashing (FNV1a)
- *
- * Generates fixed-dimension text embeddings using TF-IDF weighting
- * with feature hashing (hashing trick). Zero external dependencies.
- */
-const DEFAULT_DIMENSIONS = 256;
-const STOP_WORDS = new Set([
-    'a',
-    'an',
-    'the',
-    'and',
-    'or',
-    'but',
-    'in',
-    'on',
-    'at',
-    'to',
-    'for',
-    'of',
-    'with',
-    'by',
-    'from',
-    'is',
-    'it',
-    'as',
-    'be',
-    'was',
-    'were',
-    'been',
-    'are',
-    'am',
-    'do',
-    'does',
-    'did',
-    'have',
-    'has',
-    'had',
-    'will',
-    'would',
-    'could',
-    'should',
-    'may',
-    'might',
-    'shall',
-    'can',
-    'not',
-    'no',
-    'nor',
-    'so',
-    'if',
-    'then',
-    'than',
-    'that',
-    'this',
-    'these',
-    'those',
-    'what',
-    'which',
-    'who',
-    'whom',
-    'when',
-    'where',
-    'why',
-    'how',
-    'all',
-    'each',
-    'every',
-    'both',
-    'few',
-    'more',
-    'most',
-    'some',
-    'any',
-    'such',
-    'only',
-    'own',
-    'same',
-    'too',
-    'very',
-    'just',
-    'about',
-    'above',
-    'after',
-    'again',
-    'also',
-    'because',
-    'before',
-    'between',
-    'during',
-    'into',
-    'out',
-    'over',
-    'under',
-    'up',
-    'down',
-    'here',
-    'there',
-    'other',
-    'its',
-    'my',
-    'your',
-    'his',
-    'her',
-    'our',
-    'their',
-    'i',
-    'you',
-    'he',
-    'she',
-    'we',
-    'they',
-    'me',
-    'him',
-    'us',
-    'them',
-]);
-/**
- * FNV-1a hash function - fast, simple, good distribution
- */
-export function fnv1a(str) {
-    let hash = 0x811c9dc5; // FNV offset basis (32-bit)
-    for (let i = 0; i < str.length; i++) {
-        hash ^= str.charCodeAt(i);
-        hash = (hash * 0x01000193) | 0; // FNV prime, force 32-bit
-    }
-    return hash >>> 0; // unsigned
-}
-/**
- * Tokenize text: lowercase, split on non-word chars, remove stop words
- */
-export function tokenize(text) {
-    return text
-        .toLowerCase()
-        .split(/\W+/)
-        .filter((token) => token.length > 1 && !STOP_WORDS.has(token));
-}
-/**
- * Vectorize text using TF-IDF with feature hashing
- *
- * 1. Tokenize and compute term frequencies
- * 2. Hash each token to a bucket via FNV1a
- * 3. Apply TF weight (1 + log(tf)) to bucket
- * 4. L2-normalize the result
- */
-export function vectorize(text, dimensions = DEFAULT_DIMENSIONS) {
-    const vector = new Float32Array(dimensions);
-    const tokens = tokenize(text);
-    if (tokens.length === 0) {
-        return vector;
-    }
-    // Compute term frequencies
-    const tf = new Map();
-    for (const token of tokens) {
-        tf.set(token, (tf.get(token) || 0) + 1);
-    }
-    // Hash tokens to buckets with TF-IDF weight
-    for (const [token, count] of tf) {
-        const bucket = fnv1a(token) % dimensions;
-        const weight = 1 + Math.log(count); // TF weight: 1 + log(tf)
-        // Use sign hashing to reduce collision bias
-        const sign = fnv1a(token + '_sign') % 2 === 0 ? 1 : -1;
-        vector[bucket] += sign * weight;
-    }
-    // L2 normalize
-    let magnitude = 0;
-    for (let i = 0; i < dimensions; i++) {
-        magnitude += vector[i] * vector[i];
-    }
-    magnitude = Math.sqrt(magnitude);
-    if (magnitude > 0) {
-        for (let i = 0; i < dimensions; i++) {
-            vector[i] /= magnitude;
-        }
-    }
-    return vector;
-}
-/**
- * Cosine similarity between two vectors
- * Returns value between -1 and 1 (1 = identical, 0 = orthogonal)
- */
-export function cosineSimilarity(a, b) {
-    if (a.length !== b.length) {
-        throw new Error(`Vector dimensions mismatch: ${a.length} vs ${b.length}`);
-    }
-    let dot = 0;
-    let magA = 0;
-    let magB = 0;
-    for (let i = 0; i < a.length; i++) {
-        dot += a[i] * b[i];
-        magA += a[i] * a[i];
-        magB += b[i] * b[i];
-    }
-    const denominator = Math.sqrt(magA) * Math.sqrt(magB);
-    if (denominator === 0)
-        return 0;
-    return dot / denominator;
-}
-//# sourceMappingURL=memory-vectorizer.js.map

package/dist/memory/memory-vectorizer.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"memory-vectorizer.js","sourceRoot":"","sources":["../../src/memory/memory-vectorizer.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,GAAG;IACH,IAAI;IACJ,KAAK;IACL,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,KAAK;IACL,MAAM;IACN,OAAO;IACP,OAAO;IACP,QAAQ;IACR,KAAK;IACL,OAAO;IACP,OAAO;IACP,KAAK;IACL,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,IAAI;IACJ,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,MAAM;IACN,OAAO;IACP,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,KAAK;IACL,KAAK;IACL,KAAK;IACL,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,OAAO;IACP,OAAO;IACP,MAAM;IACN,SAAS;IACT,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,MAAM;IACN,KAAK;IACL,MAAM;IACN,OAAO;IACP,IAAI;IACJ,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,KAAK;IACL,IAAI;IACJ,MAAM;IACN,KAAK;IACL,KAAK;IACL,KAAK;IACL,OAAO;IACP,GAAG;IACH,KAAK;IACL,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,MAAM;IACN,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,MAAM;CACP,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,IAAI,IAAI,GAAG,UAAU,CAAC,CAAC,4BAA4B;IACnD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,GAAG,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,GAAG,CAAC,IAAI,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,0BAA0B;IAC5D,CAAC;IACD,OAAO,IAAI,KAAK,CAAC,CAAC,CAAC,WAAW;AAChC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY;IACnC,OAAO,IAAI;SACR,WAAW,EAAE;SACb,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC;AACnE,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,SAAS,CAAC,IAAY,EAAE,aAAqB,kBAAkB;IAC7E,MAAM,MAAM,GAAG,IAAI,YAAY,CAAC,UAAU,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAE9B,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxB,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,2BAA2B;IAC3B,MAAM,EAAE,GAAG,IAAI,GAAG,EAAkB,CAAC;IACrC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,EAAE,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1C,CAAC;IAED,4CAA4C;IAC5C,KAAK,MAAM,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,EAAE,EAAE,CAAC;QAChC,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,UAAU,CAAC;QACzC,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,yBAAyB;QAC7D,4CAA4C;QAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACvD,MAAM,CAAC,MAAM,CAAC,IAAI,IAAI,GAAG,MAAM,CAAC;IAClC,CAAC;IAED,eAAe;IACf,IAAI,SAAS,GAAG,CAAC,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;QACpC,SAAS,IAAI,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;IACrC,CAAC;IACD,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAEjC,IAAI,SAAS,GAAG,CAAC,EAAE,CAAC;QAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,UAAU,EAAE,CAAC,EAAE,EAAE,CAAC;YACpC,MAAM,CAAC,CAAC,CAAC,IAAI,SAAS,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,CAAe,EAAE,CAAe;IAC/D,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC;QAC1B,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC,MAAM,OAAO,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC;IAC5E,CAAC;IAED,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,IAAI,IAAI,GAAG,CAAC,CAAC;IAEb,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QAClC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACnB,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpB,IAAI,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,IAAI,WAAW,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEhC,OAAO,GAAG,GAAG,WAAW,CAAC;AAC3B,CAAC"}

package/templates/core/RALPH.md

@@ -1,471 +0,0 @@
-<!-- RALPH:START -->
-# Ralph Autonomous Loop Integration
-
-Ralph is an autonomous AI agent loop that iteratively solves tasks with fresh context for each iteration. This document explains how to use Ralph with your Rulebook project.
-
-## Overview
-
-Ralph enables:
-- **Autonomous Multi-Iteration Development**: AI agents solve tasks across multiple iterations
-- **Quality Gates**: Automatic checks for type-safety, linting, testing, and coverage
-- **Progress Tracking**: Detailed history of each iteration with metrics and learnings
-- **Fresh Context per Iteration**: Each iteration starts with clean context, avoiding context window exhaustion
-- **Graceful Interruption**: Pause and resume capabilities for long-running tasks
-
-## Quick Start
-
-### Initialize Ralph
-```bash
-rulebook ralph init
-```
-This creates:
-- `.rulebook/ralph/prd.json` - Product Requirements Document from rulebook tasks
-- `.rulebook/ralph/state.json` - Current loop state and progress
-- `.rulebook/ralph/history/` - Per-iteration metadata and results
-
-### Run Ralph Loop
-```bash
-rulebook ralph run --max-iterations 10 --tool claude
-```
-Flags:
-- `--max-iterations N` - Maximum iterations before stopping (default: 10)
-- `--tool TOOL` - AI tool to use: `claude`, `amp`, or `gemini` (default: claude)
-
-### Check Status
-```bash
-rulebook ralph status
-```
-Shows:
-- Current iteration count
-- Completed vs. pending tasks
-- Success rate and quality metrics
-
-### View History
-```bash
-rulebook ralph history --limit 5
-```
-Displays:
-- Last 5 iterations with status and duration
-- Task completions and failures
-- Quality gate results
-
-### Pause/Resume
-```bash
-rulebook ralph pause    # Gracefully pause the loop
-rulebook ralph resume   # Continue from where it paused
-```
-
-## How Ralph Works
-
-### Iteration Loop
-```
-┌─────────────────────────────────────────┐
-│ 1. Load Next Pending Task from PRD      │
-├─────────────────────────────────────────┤
-│ 2. Execute Agent with Task Context      │
-│    - Fresh context per iteration        │
-│    - Task description and acceptance    │
-│      criteria from rulebook             │
-│    - Previous iteration learnings       │
-├─────────────────────────────────────────┤
-│ 3. Parse Agent Output                   │
-│    - Extract quality gate results       │
-│    - Extract learnings and errors       │
-│    - Extract git commit hash            │
-├─────────────────────────────────────────┤
-│ 4. Record Iteration Results             │
-│    - Save to history/.iteration-N.json  │
-│    - Update task status in PRD          │
-│    - Log progress to progress.txt       │
-├─────────────────────────────────────────┤
-│ 5. Check Loop Continuation              │
-│    - All tasks completed?    → Stop     │
-│    - Max iterations reached? → Stop     │
-│    - Otherwise              → Loop      │
-└─────────────────────────────────────────┘
-```
-
-### Quality Gates
-Ralph automatically checks these gates after each iteration:
-
-| Gate | Description | Pass Criteria |
-|------|-------------|---------------|
-| **type-check** | TypeScript compilation | No errors |
-| **lint** | ESLint code quality | No errors |
-| **tests** | Unit tests | All passing |
-| **coverage** | Code coverage | ≥95% |
-| **security** | Vulnerability scan | No findings above `failOn` severity |
-
-**Security Gate** scans for vulnerabilities using the first available tool:
-1. **trivy** — container and filesystem scanning (`trivy fs --format json`)
-2. **semgrep** — static analysis (`semgrep --config auto --json`)
-3. **npm audit** — Node.js dependency audit (always available in Node projects)
-
-Configure via `.rulebook` file:
-```json
-{
-  "ralph": {
-    "securityGate": {
-      "enabled": true,
-      "failOn": "high",
-      "tool": "auto"
-    }
-  }
-}
-```
-
-| Setting | Default | Options | Description |
-|---------|---------|---------|-------------|
-| `enabled` | `true` | `true`/`false` | Enable/disable security gate |
-| `failOn` | `"high"` | `critical`/`high`/`moderate`/`low` | Minimum severity to fail |
-| `tool` | `"auto"` | `auto`/`npm-audit`/`trivy`/`semgrep` | Scanner to use |
-
-**Iteration Status:**
-- ✅ **success** - All 5 gates pass
-- ⚠️ **partial** - 2-4 gates pass
-- ❌ **failed** - 0-1 gates pass
-
-### Fresh Context Strategy
-Each iteration provides context to the agent:
-1. **Task Description** - What to implement
-2. **Acceptance Criteria** - How to verify success
-3. **Quality Requirements** - Type-check, lint, tests, coverage
-4. **Previous Learnings** - Lessons from prior iterations
-5. **Project Context** - Recent git commits, file structure
-6. **Git Status** - Current diff and uncommitted changes
-
-This allows agents to make progress without exhausting context window.
-
-## Task Sizing for Ralph
-
-### Good Task Sizes
-✅ **Small Tasks** (1-2 iterations)
-- Add single feature (button, form field)
-- Fix localized bug
-- Refactor single function/component
-- Add utility function
-
-Example:
-```markdown
-## Task: Add Dark Mode Toggle
-
-What Changes: Add UI toggle for theme switching
-
-Acceptance Criteria:
-- [ ] Toggle button visible in settings
-- [ ] Click toggles theme immediately
-- [ ] Selection persists in localStorage
-- [ ] All tests passing
-```
-
-✅ **Medium Tasks** (3-5 iterations)
-- Implement new API endpoint
-- Refactor component with dependencies
-- Add authentication system
-- Build complex feature with multiple parts
-
-Example:
-```markdown
-## Task: Implement User Authentication
-
-What Changes: Add JWT-based user auth
-
-Acceptance Criteria:
-- [ ] Login endpoint working
-- [ ] Token generation and validation
-- [ ] Protected routes enforced
-- [ ] Refresh token rotation
-- [ ] Error handling comprehensive
-```
-
-### Poor Task Sizes
-❌ **Too Large** (>5 iterations)
-- Build entire new module
-- Major architectural redesign
-- Complete feature system
-
-→ Break into smaller, focused tasks
-
-❌ **Too Vague** (unclear acceptance criteria)
-- "Improve performance"
-- "Make code better"
-- "Add tests"
-
-→ Define specific, measurable criteria
-
-## Configuration
-
-### .rulebook File
-```json
-{
-  "ralph": {
-    "enabled": true,
-    "maxIterations": 10,
-    "tool": "claude",
-    "maxContextLoss": 3,
-    "securityGate": {
-      "enabled": true,
-      "failOn": "high",
-      "tool": "auto"
-    },
-    "contextCompression": {
-      "enabled": true,
-      "recentCount": 3,
-      "threshold": 5
-    }
-  }
-}
-```
-
-| Setting | Default | Description |
-|---------|---------|-------------|
-| `enabled` | `true` | Enable Ralph features |
-| `maxIterations` | `10` | Max iterations per run |
-| `tool` | `claude` | Default AI tool: `claude`, `amp`, `gemini` |
-| `maxContextLoss` | `3` | Allow 3 context loss events before stopping |
-| `securityGate.enabled` | `true` | Enable 5th quality gate (vulnerability scan) |
-| `securityGate.failOn` | `"high"` | Fail on: `critical`, `high`, `moderate`, `low` |
-| `securityGate.tool` | `"auto"` | Scanner: `auto`, `npm-audit`, `trivy`, `semgrep` |
-| `contextCompression.enabled` | `true` | Compress old iteration history in prompts |
-| `contextCompression.recentCount` | `3` | Iterations shown in full detail |
-| `contextCompression.threshold` | `5` | Min iterations before compression activates |
-
-## MCP Integration
-
-Ralph provides 4 MCP tools for programmatic access:
-
-### rulebook_ralph_init
-Initialize Ralph and generate PRD from tasks
-```json
-{
-  "type": "resource",
-  "name": "rulebook_ralph_init",
-  "description": "Initialize Ralph autonomous loop"
-}
-```
-
-### rulebook_ralph_run
-Execute autonomous iteration loop
-```json
-{
-  "type": "resource",
-  "name": "rulebook_ralph_run",
-  "description": "Run Ralph iteration loop"
-}
-```
-
-### rulebook_ralph_status
-Get current loop state and progress
-```json
-{
-  "type": "resource",
-  "name": "rulebook_ralph_status",
-  "description": "Get Ralph loop status"
-}
-```
-
-### rulebook_ralph_get_iteration_history
-Retrieve iteration metadata and statistics
-```json
-{
-  "type": "resource",
-  "name": "rulebook_ralph_get_iteration_history",
-  "description": "Get Ralph iteration history"
-}
-```
-
-## Directory Structure
-
-Ralph stores all data in `.rulebook/ralph/`:
-```
-.rulebook/ralph/
-├── prd.json              # Product Requirements Document
-├── state.json            # Current loop state
-├── progress.txt          # Append-only progress log
-└── history/
-    ├── iteration-1.json  # Metadata from iteration 1
-    ├── iteration-2.json  # Metadata from iteration 2
-    └── ...
-```
-
-### prd.json Structure
-```json
-{
-  "version": "1.0",
-  "generated_at": "2026-02-26T12:00:00Z",
-  "project_name": "my-project",
-  "total_tasks": 5,
-  "tasks": [
-    {
-      "id": "task-1",
-      "title": "Task Title",
-      "description": "Task description",
-      "status": "pending|in_iteration|completed|blocked",
-      "priority": 1,
-      "acceptance_criteria": ["Criterion 1", "Criterion 2"],
-      "estimated_iterations": 2,
-      "created_at": "2026-02-26T12:00:00Z",
-      "updated_at": "2026-02-26T12:00:00Z"
-    }
-  ]
-}
-```
-
-### iteration-N.json Structure
-```json
-{
-  "iteration": 1,
-  "started_at": "2026-02-26T12:00:00Z",
-  "completed_at": "2026-02-26T12:05:00Z",
-  "task_id": "task-1",
-  "task_title": "Task Title",
-  "duration_ms": 300000,
-  "status": "success|partial|failed",
-  "git_commit": "abc1234",
-  "quality_checks": {
-    "type_check": true,
-    "lint": true,
-    "tests": true,
-    "coverage_met": true
-  }
-}
-```
-
-## Best Practices
-
-### 1. Clear Acceptance Criteria
-❌ Bad: "Make it work"
-✅ Good: "User can click button and see modal dialog with form"
-
-### 2. Limit to 1 Task per Run
-Run Ralph on single focused task for best results
-```bash
-# Focus on one task at a time
-rulebook ralph run --max-iterations 5
-```
-
-### 3. Review Iteration Results
-Check quality gates and learnings between runs
-```bash
-rulebook ralph history --limit 1  # See latest iteration
-```
-
-### 4. Break Large Features
-Don't try to implement entire systems in one run
-- Task 1: API endpoint with basic validation
-- Task 2: Database models and migrations
-- Task 3: Error handling and edge cases
-- Task 4: Tests and documentation
-
-### 5. Inspect Failed Iterations
-If status is "failed", examine what went wrong:
-```bash
-cat .rulebook/ralph/history/iteration-N.json
-cat .rulebook/ralph/progress.txt
-```
-
-### 6. Use Learnings from History
-Ralph extracts and stores learnings from iterations. Review these to understand what strategies worked.
-
-## Troubleshooting
-
-### Iteration Loop Stops Early
-**Cause**: Hit max iterations or all tasks completed
-
-**Solution**:
-- Check status: `rulebook ralph status`
-- View history: `rulebook ralph history`
-- Increase max iterations: `rulebook ralph run --max-iterations 20`
-
-### Quality Gates Failing
-**Cause**: Type-check, lint, tests, or coverage not meeting standards
-
-**Solution**:
-- Review failing gate in iteration history
-- Check PRD acceptance criteria match quality gates
-- Ensure task is small enough for single iteration
-
-### Context Loss Events
-**Cause**: Agent ran out of context window during iteration
-
-**Solution**:
-- Break task into smaller pieces
-- Reduce task description complexity
-- Increase agent context window if possible
-
-### Ralph State Gets Stuck
-**Cause**: Invalid state.json or corrupted PRD
-
-**Solution**:
-```bash
-rm .rulebook/ralph/state.json      # Reset state
-rulebook ralph init                # Regenerate PRD
-rulebook ralph run                 # Restart loop
-```
-
-## Examples
-
-### Example 1: Simple Feature Implementation
-Task: Add dark mode toggle button
-
-```bash
-# Initialize Ralph
-rulebook ralph init
-
-# Run for up to 3 iterations
-rulebook ralph run --max-iterations 3
-
-# Check results
-rulebook ralph history
-
-# Review final output
-cat .rulebook/ralph/history/iteration-*.json
-```
-
-### Example 2: Multiple Task Execution
-Tasks: Several small features to implement
-
-```bash
-# Run multiple tasks with generous iteration limit
-rulebook ralph run --max-iterations 20
-
-# Monitor progress
-watch -n 5 'rulebook ralph status'
-
-# Pause if needed
-rulebook ralph pause
-
-# Review and resume
-rulebook ralph history
-rulebook ralph resume
-```
-
-### Example 3: Debugging Failed Iteration
-```bash
-# Run into failure
-rulebook ralph run --max-iterations 3
-
-# See what failed
-cat .rulebook/ralph/history/iteration-3.json
-
-# View full progress log
-tail -50 .rulebook/ralph/progress.txt
-
-# Manual fix and resume
-rulebook ralph resume
-```
-
-## Limitations
-
-- **Single Sequential Loop**: Ralph processes one task at a time sequentially
-- **No Parallel Execution**: Tasks don't run in parallel (by design)
-- **No Task Dependencies**: No automatic dependency resolution between tasks
-- **Manual Task Ordering**: You order tasks by priority in PRD
-
-## Related Documentation
-
-- See `/.rulebook/specs/RULEBOOK.md` for task structure
-- See `/.rulebook/specs/QUALITY_ENFORCEMENT.md` for quality gates
-- See `/rulebook/AGENTS.md` for AI agent integration
-
-<!-- RALPH:END -->

package/templates/frameworks/ANGULAR.md

@@ -1,36 +0,0 @@
-<!-- ANGULAR:START -->
-# Angular Framework Rules
-
-**CRITICAL**: Angular projects must meet these standards before delivery.
-
-## Quality Commands
-- Lint: `npm run lint`
-- Unit tests: `npm run test -- --watch=false --code-coverage`
-- e2e tests: `npm run e2e`
-- Build: `npm run build -- --configuration production`
-
-## Project Structure
-- Colocate features inside `src/app/<feature>/`
-- Keep shared modules in `src/app/shared`
-- Avoid `providedIn: 'root'` unless service truly global
-- Leverage `OnPush` change detection for performance-critical components
-
-## Implementation Guidelines
-- Define interfaces for component inputs/outputs
-- Use `HttpClient` interceptors for auth/logging
-- Isolate environment variables in `src/environments/`
-- Prefer Reactive Forms and RxJS operators over manual subscriptions
-
-## Pre-Commit Sequence
-```bash
-npm run lint
-npm run test -- --watch=false
-npm run build -- --configuration production
-```
-
-## Documentation
-- Update `/docs/angular-architecture.md` with new modules and routes
-- Record shared component APIs in Storybook or `/docs/ui-components.md`
-- Version major route changes in `/docs/roadmap.md`
-
-<!-- ANGULAR:END -->