@hivehub/rulebook 4.0.0 → 4.2.0

package/templates/modules/VECTORIZER.md

@@ -1,63 +1,63 @@
-<!-- VECTORIZER:START -->
-# Vectorizer Instructions
-
-**CRITICAL**: Use MCP Vectorizer as primary data source for project information instead of file reading.
-
-## Core Functions
-
-### Search
-```
-mcp_vectorizer_search - Multiple strategies:
-  - intelligent: AI-powered with query expansion
-  - semantic: Advanced with reranking  
-  - contextual: Context-aware with filtering
-  - multi_collection: Cross-project search
-  - batch: Parallel queries
-  - by_file_type: Filter by extension (.rs, .ts, .py)
-```
-
-### File Operations
-```
-get_content - Retrieve file without disk I/O
-list_files - List indexed files with metadata
-get_summary - File summaries (extractive/structural)
-get_chunks - Progressive reading of large files
-get_outline - Project structure overview
-get_related - Find semantically related files
-```
-
-### Discovery
-```
-full_pipeline - Complete discovery with scoring
-broad_discovery - Multi-query with deduplication
-semantic_focus - Deep semantic search
-expand_queries - Generate query variations
-```
-
-## When to Use
-
-| Task | Tool |
-|------|------|
-| Explore unfamiliar code | intelligent search |
-| Read file | get_content |
-| Understand structure | get_outline |
-| Find related files | get_related |
-| Read large file | get_chunks |
-| Complex question | full_pipeline |
-
-## Best Practices
-
-✅ **DO:**
-- Start with intelligent search for exploration
-- Use file_operations to avoid disk I/O
-- Batch queries for related items
-- Set similarity thresholds (0.6-0.8)
-- Use specific collections when known
-
-❌ **DON'T:**
-- Read files from disk when available in vectorizer
-- Use sequential searches (batch instead)
-- Skip similarity thresholds
-- Search entire codebase when collection is known
-
-<!-- VECTORIZER:END -->
+<!-- VECTORIZER:START -->
+# Vectorizer Instructions
+
+**CRITICAL**: Use MCP Vectorizer as primary data source for project information instead of file reading.
+
+## Core Functions
+
+### Search
+```
+mcp_vectorizer_search - Multiple strategies:
+  - intelligent: AI-powered with query expansion
+  - semantic: Advanced with reranking  
+  - contextual: Context-aware with filtering
+  - multi_collection: Cross-project search
+  - batch: Parallel queries
+  - by_file_type: Filter by extension (.rs, .ts, .py)
+```
+
+### File Operations
+```
+get_content - Retrieve file without disk I/O
+list_files - List indexed files with metadata
+get_summary - File summaries (extractive/structural)
+get_chunks - Progressive reading of large files
+get_outline - Project structure overview
+get_related - Find semantically related files
+```
+
+### Discovery
+```
+full_pipeline - Complete discovery with scoring
+broad_discovery - Multi-query with deduplication
+semantic_focus - Deep semantic search
+expand_queries - Generate query variations
+```
+
+## When to Use
+
+| Task | Tool |
+|------|------|
+| Explore unfamiliar code | intelligent search |
+| Read file | get_content |
+| Understand structure | get_outline |
+| Find related files | get_related |
+| Read large file | get_chunks |
+| Complex question | full_pipeline |
+
+## Best Practices
+
+✅ **DO:**
+- Start with intelligent search for exploration
+- Use file_operations to avoid disk I/O
+- Batch queries for related items
+- Set similarity thresholds (0.6-0.8)
+- Use specific collections when known
+
+❌ **DON'T:**
+- Read files from disk when available in vectorizer
+- Use sequential searches (batch instead)
+- Skip similarity thresholds
+- Search entire codebase when collection is known
+
+<!-- VECTORIZER:END -->

package/templates/modules/sequential-thinking.md

@@ -1,42 +1,42 @@
-<!-- SEQUENTIAL_THINKING:START -->
-# Sequential Thinking MCP
-
-Sequential thinking MCP enables structured, step-by-step problem solving for complex tasks.
-
-## When to Use
-
-Use sequential thinking for:
-- Complex architectural decisions requiring multiple trade-off analyses
-- Debugging hard-to-reproduce issues
-- Planning multi-step implementations before writing code
-- Tasks where mistakes are costly (data migrations, API changes)
-
-## Usage Pattern
-
-```
-mcp__sequential-thinking__sequentialthinking
-```
-
-Call with a thought/problem to explore it step by step before committing to an implementation.
-
-## Integration
-
-When sequential thinking MCP is available:
-1. Start complex tasks with a thinking step to plan the approach
-2. Use it to validate assumptions before writing code
-3. Record key decisions from the thinking process in task spec files
-
-## Install (if not configured)
-
-```bash
-# Add to .mcp.json
-{
-  "mcpServers": {
-    "sequential-thinking": {
-      "command": "npx",
-      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
-    }
-  }
-}
-```
-<!-- SEQUENTIAL_THINKING:END -->
+<!-- SEQUENTIAL_THINKING:START -->
+# Sequential Thinking MCP
+
+Sequential thinking MCP enables structured, step-by-step problem solving for complex tasks.
+
+## When to Use
+
+Use sequential thinking for:
+- Complex architectural decisions requiring multiple trade-off analyses
+- Debugging hard-to-reproduce issues
+- Planning multi-step implementations before writing code
+- Tasks where mistakes are costly (data migrations, API changes)
+
+## Usage Pattern
+
+```
+mcp__sequential-thinking__sequentialthinking
+```
+
+Call with a thought/problem to explore it step by step before committing to an implementation.
+
+## Integration
+
+When sequential thinking MCP is available:
+1. Start complex tasks with a thinking step to plan the approach
+2. Use it to validate assumptions before writing code
+3. Record key decisions from the thinking process in task spec files
+
+## Install (if not configured)
+
+```bash
+# Add to .mcp.json
+{
+  "mcpServers": {
+    "sequential-thinking": {
+      "command": "npx",
+      "args": ["-y", "@modelcontextprotocol/server-sequential-thinking"]
+    }
+  }
+}
+```
+<!-- SEQUENTIAL_THINKING:END -->

package/templates/ralph/ralph-history.bat

@@ -1,4 +1,4 @@
-@echo off
-REM Ralph History — View iteration history
-REM Generated by @hivehub/rulebook
-npx @hivehub/rulebook@latest ralph history %*
+@echo off
+REM Ralph History — View iteration history
+REM Generated by @hivehub/rulebook
+npx @hivehub/rulebook@latest ralph history %*

package/templates/ralph/ralph-history.sh

@@ -1,5 +1,5 @@
-#!/bin/sh
-# Ralph History — View iteration history
-# Generated by @hivehub/rulebook
-echo "Loading Ralph history..."
-npx @hivehub/rulebook@latest ralph history "$@"
+#!/bin/sh
+# Ralph History — View iteration history
+# Generated by @hivehub/rulebook
+echo "Loading Ralph history..."
+npx @hivehub/rulebook@latest ralph history "$@"

package/templates/ralph/ralph-init.bat

@@ -1,5 +1,5 @@
-@echo off
-REM Ralph Init — Initialize autonomous loop
-REM Generated by @hivehub/rulebook
-echo Initializing Ralph autonomous loop...
-npx @hivehub/rulebook@latest ralph init %*
+@echo off
+REM Ralph Init — Initialize autonomous loop
+REM Generated by @hivehub/rulebook
+echo Initializing Ralph autonomous loop...
+npx @hivehub/rulebook@latest ralph init %*

package/templates/ralph/ralph-init.sh

@@ -1,5 +1,5 @@
-#!/bin/sh
-# Ralph Init — Initialize autonomous loop
-# Generated by @hivehub/rulebook
-echo "Initializing Ralph autonomous loop..."
-npx @hivehub/rulebook@latest ralph init "$@"
+#!/bin/sh
+# Ralph Init — Initialize autonomous loop
+# Generated by @hivehub/rulebook
+echo "Initializing Ralph autonomous loop..."
+npx @hivehub/rulebook@latest ralph init "$@"

package/templates/ralph/ralph-pause.bat

@@ -1,5 +1,5 @@
-@echo off
-REM Ralph Pause — Pause autonomous loop
-REM Generated by @hivehub/rulebook
-echo Pausing Ralph autonomous loop...
-npx @hivehub/rulebook@latest ralph pause %*
+@echo off
+REM Ralph Pause — Pause autonomous loop
+REM Generated by @hivehub/rulebook
+echo Pausing Ralph autonomous loop...
+npx @hivehub/rulebook@latest ralph pause %*

package/templates/ralph/ralph-pause.sh

@@ -1,5 +1,5 @@
-#!/bin/sh
-# Ralph Pause — Pause autonomous loop
-# Generated by @hivehub/rulebook
-echo "Pausing Ralph autonomous loop..."
-npx @hivehub/rulebook@latest ralph pause "$@"
+#!/bin/sh
+# Ralph Pause — Pause autonomous loop
+# Generated by @hivehub/rulebook
+echo "Pausing Ralph autonomous loop..."
+npx @hivehub/rulebook@latest ralph pause "$@"

package/templates/ralph/ralph-run.bat

@@ -1,5 +1,5 @@
-@echo off
-REM Ralph Run — Start autonomous loop
-REM Generated by @hivehub/rulebook
-echo Starting Ralph autonomous loop...
-npx @hivehub/rulebook@latest ralph run %*
+@echo off
+REM Ralph Run — Start autonomous loop
+REM Generated by @hivehub/rulebook
+echo Starting Ralph autonomous loop...
+npx @hivehub/rulebook@latest ralph run %*

package/templates/ralph/ralph-run.sh

@@ -1,5 +1,5 @@
-#!/bin/sh
-# Ralph Run — Start autonomous loop
-# Generated by @hivehub/rulebook
-echo "Starting Ralph autonomous loop..."
-npx @hivehub/rulebook@latest ralph run "$@"
+#!/bin/sh
+# Ralph Run — Start autonomous loop
+# Generated by @hivehub/rulebook
+echo "Starting Ralph autonomous loop..."
+npx @hivehub/rulebook@latest ralph run "$@"

package/templates/ralph/ralph-status.bat

@@ -1,4 +1,4 @@
-@echo off
-REM Ralph Status — Check loop status
-REM Generated by @hivehub/rulebook
-npx @hivehub/rulebook@latest ralph status %*
+@echo off
+REM Ralph Status — Check loop status
+REM Generated by @hivehub/rulebook
+npx @hivehub/rulebook@latest ralph status %*

package/templates/ralph/ralph-status.sh

@@ -1,5 +1,5 @@
-#!/bin/sh
-# Ralph Status — Check loop status
-# Generated by @hivehub/rulebook
-echo "Checking Ralph status..."
-npx @hivehub/rulebook@latest ralph status "$@"
+#!/bin/sh
+# Ralph Status — Check loop status
+# Generated by @hivehub/rulebook
+echo "Checking Ralph status..."
+npx @hivehub/rulebook@latest ralph status "$@"