@hivehub/rulebook 3.4.2 → 4.1.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (173) hide show
  1. package/.claude/commands/continue.md +33 -0
  2. package/.claude-plugin/marketplace.json +28 -29
  3. package/.claude-plugin/plugin.json +8 -8
  4. package/README.md +66 -144
  5. package/dist/agents/ralph-parser.d.ts +41 -1
  6. package/dist/agents/ralph-parser.d.ts.map +1 -1
  7. package/dist/agents/ralph-parser.js +202 -14
  8. package/dist/agents/ralph-parser.js.map +1 -1
  9. package/dist/cli/commands.d.ts +65 -0
  10. package/dist/cli/commands.d.ts.map +1 -1
  11. package/dist/cli/commands.js +837 -61
  12. package/dist/cli/commands.js.map +1 -1
  13. package/dist/core/agent-manager.d.ts +7 -0
  14. package/dist/core/agent-manager.d.ts.map +1 -1
  15. package/dist/core/agent-manager.js +150 -3
  16. package/dist/core/agent-manager.js.map +1 -1
  17. package/dist/core/claude-mcp.d.ts +17 -0
  18. package/dist/core/claude-mcp.d.ts.map +1 -1
  19. package/dist/core/claude-mcp.js +90 -6
  20. package/dist/core/claude-mcp.js.map +1 -1
  21. package/dist/core/config-manager.d.ts.map +1 -1
  22. package/dist/core/config-manager.js +40 -0
  23. package/dist/core/config-manager.js.map +1 -1
  24. package/dist/core/cursor-mdc-generator.d.ts +30 -0
  25. package/dist/core/cursor-mdc-generator.d.ts.map +1 -0
  26. package/dist/core/cursor-mdc-generator.js +98 -0
  27. package/dist/core/cursor-mdc-generator.js.map +1 -0
  28. package/dist/core/detector.d.ts +25 -1
  29. package/dist/core/detector.d.ts.map +1 -1
  30. package/dist/core/detector.js +321 -1
  31. package/dist/core/detector.js.map +1 -1
  32. package/dist/core/generator.d.ts +10 -0
  33. package/dist/core/generator.d.ts.map +1 -1
  34. package/dist/core/generator.js +177 -3
  35. package/dist/core/generator.js.map +1 -1
  36. package/dist/core/github-issues-importer.d.ts +82 -0
  37. package/dist/core/github-issues-importer.d.ts.map +1 -0
  38. package/dist/core/github-issues-importer.js +161 -0
  39. package/dist/core/github-issues-importer.js.map +1 -0
  40. package/dist/core/health-scorer.d.ts +39 -0
  41. package/dist/core/health-scorer.d.ts.map +1 -1
  42. package/dist/core/health-scorer.js +256 -13
  43. package/dist/core/health-scorer.js.map +1 -1
  44. package/dist/core/indexer/background-indexer.d.ts +27 -0
  45. package/dist/core/indexer/background-indexer.d.ts.map +1 -0
  46. package/dist/core/indexer/background-indexer.js +135 -0
  47. package/dist/core/indexer/background-indexer.js.map +1 -0
  48. package/dist/core/indexer/file-parser.d.ts +28 -0
  49. package/dist/core/indexer/file-parser.d.ts.map +1 -0
  50. package/dist/core/indexer/file-parser.js +171 -0
  51. package/dist/core/indexer/file-parser.js.map +1 -0
  52. package/dist/core/indexer/indexer-types.d.ts +35 -0
  53. package/dist/core/indexer/indexer-types.d.ts.map +1 -0
  54. package/dist/core/indexer/indexer-types.js +8 -0
  55. package/dist/core/indexer/indexer-types.js.map +1 -0
  56. package/dist/core/iteration-tracker.d.ts +28 -0
  57. package/dist/core/iteration-tracker.d.ts.map +1 -1
  58. package/dist/core/iteration-tracker.js +86 -0
  59. package/dist/core/iteration-tracker.js.map +1 -1
  60. package/dist/core/multi-tool-generator.d.ts +59 -0
  61. package/dist/core/multi-tool-generator.d.ts.map +1 -0
  62. package/dist/core/multi-tool-generator.js +157 -0
  63. package/dist/core/multi-tool-generator.js.map +1 -0
  64. package/dist/core/override-manager.d.ts +23 -0
  65. package/dist/core/override-manager.d.ts.map +1 -0
  66. package/dist/core/override-manager.js +82 -0
  67. package/dist/core/override-manager.js.map +1 -0
  68. package/dist/core/plans-manager.d.ts +46 -0
  69. package/dist/core/plans-manager.d.ts.map +1 -0
  70. package/dist/core/plans-manager.js +158 -0
  71. package/dist/core/plans-manager.js.map +1 -0
  72. package/dist/core/prd-generator.d.ts +12 -0
  73. package/dist/core/prd-generator.d.ts.map +1 -1
  74. package/dist/core/prd-generator.js +91 -2
  75. package/dist/core/prd-generator.js.map +1 -1
  76. package/dist/core/ralph-manager.d.ts +47 -1
  77. package/dist/core/ralph-manager.d.ts.map +1 -1
  78. package/dist/core/ralph-manager.js +107 -0
  79. package/dist/core/ralph-manager.js.map +1 -1
  80. package/dist/core/ralph-parallel.d.ts +55 -0
  81. package/dist/core/ralph-parallel.d.ts.map +1 -0
  82. package/dist/core/ralph-parallel.js +201 -0
  83. package/dist/core/ralph-parallel.js.map +1 -0
  84. package/dist/core/ralph-plan-checkpoint.d.ts +58 -0
  85. package/dist/core/ralph-plan-checkpoint.d.ts.map +1 -0
  86. package/dist/core/ralph-plan-checkpoint.js +154 -0
  87. package/dist/core/ralph-plan-checkpoint.js.map +1 -0
  88. package/dist/core/ralph-scripts.d.ts +12 -0
  89. package/dist/core/ralph-scripts.d.ts.map +1 -0
  90. package/dist/core/ralph-scripts.js +49 -0
  91. package/dist/core/ralph-scripts.js.map +1 -0
  92. package/dist/core/review-manager.d.ts +74 -0
  93. package/dist/core/review-manager.d.ts.map +1 -0
  94. package/dist/core/review-manager.js +371 -0
  95. package/dist/core/review-manager.js.map +1 -0
  96. package/dist/index.js +94 -2
  97. package/dist/index.js.map +1 -1
  98. package/dist/mcp/rulebook-server.d.ts.map +1 -1
  99. package/dist/mcp/rulebook-server.js +117 -8
  100. package/dist/mcp/rulebook-server.js.map +1 -1
  101. package/dist/memory/memory-manager.d.ts +4 -1
  102. package/dist/memory/memory-manager.d.ts.map +1 -1
  103. package/dist/memory/memory-manager.js +33 -4
  104. package/dist/memory/memory-manager.js.map +1 -1
  105. package/dist/memory/memory-search.d.ts +2 -2
  106. package/dist/memory/memory-search.d.ts.map +1 -1
  107. package/dist/memory/memory-search.js +19 -0
  108. package/dist/memory/memory-search.js.map +1 -1
  109. package/dist/memory/memory-store.d.ts +13 -0
  110. package/dist/memory/memory-store.d.ts.map +1 -1
  111. package/dist/memory/memory-store.js +92 -1
  112. package/dist/memory/memory-store.js.map +1 -1
  113. package/dist/memory/memory-types.d.ts +15 -0
  114. package/dist/memory/memory-types.d.ts.map +1 -1
  115. package/dist/types.d.ts +55 -2
  116. package/dist/types.d.ts.map +1 -1
  117. package/package.json +1 -1
  118. package/templates/agents/implementer.md +35 -0
  119. package/templates/agents/researcher.md +34 -0
  120. package/templates/agents/team-lead.md +34 -0
  121. package/templates/agents/tester.md +42 -0
  122. package/templates/ci/rulebook-review.yml +26 -0
  123. package/templates/commands/rulebook-task-archive.md +24 -0
  124. package/templates/core/AGENTS_LEAN.md +25 -0
  125. package/templates/core/AGENTS_OVERRIDE.md +16 -0
  126. package/templates/core/MULTI_AGENT.md +74 -0
  127. package/templates/core/PLANS.md +28 -0
  128. package/templates/core/RALPH.md +45 -4
  129. package/templates/core/RULEBOOK.md +42 -0
  130. package/templates/ides/CONTINUE_RULES.md +16 -0
  131. package/templates/ides/COPILOT_INSTRUCTIONS.md +23 -0
  132. package/templates/ides/GEMINI_RULES.md +17 -0
  133. package/templates/ides/WINDSURF_RULES.md +14 -0
  134. package/templates/ides/cursor-mdc/go.mdc +24 -0
  135. package/templates/ides/cursor-mdc/python.mdc +24 -0
  136. package/templates/ides/cursor-mdc/quality.mdc +25 -0
  137. package/templates/ides/cursor-mdc/ralph.mdc +39 -0
  138. package/templates/ides/cursor-mdc/rulebook.mdc +38 -0
  139. package/templates/ides/cursor-mdc/rust.mdc +24 -0
  140. package/templates/ides/cursor-mdc/typescript.mdc +25 -0
  141. package/templates/modules/sequential-thinking.md +42 -0
  142. package/templates/ralph/ralph-history.bat +4 -0
  143. package/templates/ralph/ralph-history.sh +5 -0
  144. package/templates/ralph/ralph-init.bat +5 -0
  145. package/templates/ralph/ralph-init.sh +5 -0
  146. package/templates/ralph/ralph-pause.bat +5 -0
  147. package/templates/ralph/ralph-pause.sh +5 -0
  148. package/templates/ralph/ralph-run.bat +5 -0
  149. package/templates/ralph/ralph-run.sh +5 -0
  150. package/templates/ralph/ralph-status.bat +4 -0
  151. package/templates/ralph/ralph-status.sh +5 -0
  152. package/templates/services/DATADOG.md +26 -0
  153. package/templates/services/DOCKER.md +124 -0
  154. package/templates/services/DOCKER_COMPOSE.md +168 -0
  155. package/templates/services/HELM.md +194 -0
  156. package/templates/services/KUBERNETES.md +208 -0
  157. package/templates/services/OPENTELEMETRY.md +25 -0
  158. package/templates/services/PINO.md +24 -0
  159. package/templates/services/PROMETHEUS.md +33 -0
  160. package/templates/services/SENTRY.md +23 -0
  161. package/templates/services/WINSTON.md +30 -0
  162. package/dist/core/openspec-manager.d.ts +0 -133
  163. package/dist/core/openspec-manager.d.ts.map +0 -1
  164. package/dist/core/openspec-manager.js +0 -596
  165. package/dist/core/openspec-manager.js.map +0 -1
  166. package/dist/core/openspec-migrator.d.ts +0 -27
  167. package/dist/core/openspec-migrator.d.ts.map +0 -1
  168. package/dist/core/openspec-migrator.js +0 -262
  169. package/dist/core/openspec-migrator.js.map +0 -1
  170. package/dist/core/test-task-manager.d.ts +0 -49
  171. package/dist/core/test-task-manager.d.ts.map +0 -1
  172. package/dist/core/test-task-manager.js +0 -121
  173. package/dist/core/test-task-manager.js.map +0 -1
@@ -0,0 +1,33 @@
1
+ ---
2
+ name: /continue
3
+ id: continue
4
+ category: Rulebook
5
+ description: Update tasks.md, archive completed tasks, and continue implementation.
6
+ ---
7
+ <!-- RULEBOOK:START -->
8
+ **Steps**
9
+
10
+ 1. **Update tasks.md for all active tasks**:
11
+ - Mark completed items as `[x]` in every active `tasks.md`
12
+ - Remove or update items that are no longer relevant
13
+
14
+ 2. **Archive fully completed tasks**:
15
+ For each task where ALL items are `[x]`:
16
+ ```bash
17
+ rulebook task archive <task-id>
18
+ ```
19
+
20
+ 3. **Get current session context**:
21
+ ```bash
22
+ rulebook continue
23
+ ```
24
+ Use this output to understand what's pending and what was done.
25
+
26
+ 4. **Continue implementation**:
27
+ - Pick the next pending task from the context above
28
+ - Work through its `tasks.md` checklist item by item
29
+ - Follow priority order: tests → coverage → update tasks.md → commit
30
+
31
+ **Reference**
32
+ - See `/.rulebook/specs/RULEBOOK.md` for complete task management guidelines
33
+ <!-- RULEBOOK:END -->
@@ -1,29 +1,28 @@
1
- {
2
- "name": "hivehub-marketplace",
3
- "owner": {
4
- "name": "HiveLLM Team",
5
- "email": "support@hivellm.com",
6
- "url": "https://github.com/hivellm"
7
- },
8
- "plugins": [
9
- {
10
- "name": "rulebook",
11
- "source": ".",
12
- "description": "Standardize AI-generated projects with skills, templates, persistent memory, and quality gates. Supports 28 languages, 17 frameworks, 13 MCP modules, and 20 services.",
13
- "version": "3.4.2",
14
- "repository": "https://github.com/hivellm/rulebook",
15
- "homepage": "https://github.com/hivellm/rulebook#readme",
16
- "keywords": [
17
- "ai",
18
- "automation",
19
- "templates",
20
- "standards",
21
- "skills",
22
- "mcp",
23
- "task-management",
24
- "quality-gates"
25
- ]
26
- }
27
- ]
28
- }
29
-
1
+ {
2
+ "name": "hivehub-marketplace",
3
+ "owner": {
4
+ "name": "HiveLLM Team",
5
+ "email": "support@hivellm.com",
6
+ "url": "https://github.com/hivellm"
7
+ },
8
+ "plugins": [
9
+ {
10
+ "name": "rulebook",
11
+ "source": ".",
12
+ "description": "Standardize AI-generated projects with skills, templates, persistent memory, and quality gates. Supports 28 languages, 17 frameworks, 13 MCP modules, and 20 services.",
13
+ "version": "4.0.0",
14
+ "repository": "https://github.com/hivellm/rulebook",
15
+ "homepage": "https://github.com/hivellm/rulebook#readme",
16
+ "keywords": [
17
+ "ai",
18
+ "automation",
19
+ "templates",
20
+ "standards",
21
+ "skills",
22
+ "mcp",
23
+ "task-management",
24
+ "quality-gates"
25
+ ]
26
+ }
27
+ ]
28
+ }
@@ -1,8 +1,8 @@
1
- {
2
- "name": "rulebook",
3
- "description": "Standardize AI-generated projects with Ralph autonomous loop, persistent memory, and quality gates. Supports 28 languages, 17 frameworks, 13 MCP modules, and 20 services.",
4
- "version": "3.4.2",
5
- "author": {
6
- "name": "HiveLLM"
7
- }
8
- }
1
+ {
2
+ "name": "rulebook",
3
+ "description": "Standardize AI-generated projects with Ralph autonomous loop, persistent memory, and quality gates. Supports 28 languages, 17 frameworks, 13 MCP modules, and 20 services.",
4
+ "version": "4.1.0",
5
+ "author": {
6
+ "name": "HiveLLM"
7
+ }
8
+ }
package/README.md CHANGED
@@ -35,14 +35,14 @@ By giving LLMs a clear "rulebook" to follow, you ensure that every piece of gene
35
35
  ## Quick Start
36
36
 
37
37
  ```bash
38
- # New project (interactive)
38
+ # New project — auto-detects languages, frameworks, services (no prompts)
39
39
  npx @hivehub/rulebook@latest init
40
40
 
41
41
  # Minimal setup (essentials only)
42
42
  npx @hivehub/rulebook@latest init --minimal
43
43
 
44
- # Light mode (prototypes without strict rules)
45
- npx @hivehub/rulebook@latest init --light
44
+ # Lean mode — AGENTS.md as <3KB index (fast AI loading)
45
+ npx @hivehub/rulebook@latest init --lean
46
46
 
47
47
  # Update existing project
48
48
  npx @hivehub/rulebook@latest update
@@ -50,148 +50,43 @@ npx @hivehub/rulebook@latest update
50
50
 
51
51
  ## What's New
52
52
 
53
- ### v3.1.0
53
+ See the full [CHANGELOG](CHANGELOG.md) for details.
54
54
 
55
- - 🤖 **Ralph Autonomous Loop Integration**: Multi-iteration AI agent task solving with fresh context per iteration
56
- - Autonomous iteration loop with configurable max iterations
57
- - Fresh context per iteration to avoid context window exhaustion
58
- - Quality gates: type-check, lint, tests, coverage verification
59
- - Detailed iteration tracking with history and metrics
60
- - PRD (Product Requirements Document) generation from rulebook tasks
61
- - 6 CLI commands: `rulebook ralph init|run|status|history|pause|resume`
62
- - 4 MCP tools: `rulebook_ralph_init|run|status|get_iteration_history`
63
- - Graceful pause/resume capabilities for long-running loops
64
- - Automatic directory migration from old structure to new `.rulebook/` layout
65
- - 📁 **Consolidated Directory Structure**: Single `.rulebook/` directory for all rulebook data
66
- - `memory/` subdirectory for persistent memory system
67
- - `ralph/` subdirectory for autonomous loop state and history
68
- - Automatic migration from `rulebook/`, `.rulebook-memory/`, and `.rulebook-ralph/` during `init` and `update`
69
- - 📖 **Comprehensive Ralph Documentation**: 450+ lines of guides, examples, and best practices
70
- - Complete Ralph usage guide with task sizing guidelines
71
- - Configuration reference and MCP integration examples
72
- - Real-world workflows and troubleshooting strategies
73
-
74
- ### v3.0.0
75
-
76
- - 🧠 **Persistent Memory System**: Zero-dependency persistent context across AI sessions
77
- - Hybrid search: BM25 keyword + HNSW vector with Reciprocal Rank Fusion
78
- - TF-IDF embeddings with FNV1a feature hashing (256-dim, pure TypeScript)
79
- - SQLite persistence via sql.js WASM (zero native compilation)
80
- - LRU cache eviction (500MB default, protects decision memories)
81
- - Privacy filter: auto-redacts `<private>...</private>` tags
82
- - 7 memory types: bugfix, feature, refactor, decision, discovery, change, observation
83
- - 6 MCP tools + 6 CLI commands for complete memory management
84
- - 🧩 **119 Skills with YAML Frontmatter**: All 106 legacy templates converted to proper SKILL.md format
85
- - 28 languages, 17 frameworks, 13 modules, 20 services, 8 IDEs, 15 CLI, 5 core + git/hooks
86
- - 🔌 **Claude Code Commands**: Memory + task commands auto-installed to `.claude/commands/`
87
- - 🔧 **Update Preserves Config**: `rulebook update` no longer resets custom `.rulebook` fields (memory, skills, timeouts, etc.)
88
- - 🛡️ **MCP Config Safety**: `.mcp.json` entry preserved if already configured (no more overwriting)
89
-
90
- ### v2.1.0
91
-
92
- - 🔒 **Claude Code Critical Directives**: New mandatory rules for Claude Code CLI
93
- - **Sequential File Editing**: Files must be edited one at a time to prevent failures from parallel edits
94
- - **Complete Test Implementation**: Strict rules against simplifying tests, placeholder assertions, or skipping test cases
95
- - Updated `CLAUDE.md` generation with comprehensive guidelines and examples
96
- - 🪟 **Windows Test Suite Fix**: Tests no longer hang on Windows (705 tests passing, 11x faster)
97
-
98
- ### v2.0.0
99
-
100
- - 🧩 **Skills System**: New modular skills architecture for AI-assisted development
101
- - Skills are YAML-frontmatter Markdown files with enable/disable functionality
102
- - 10 skill categories: languages, frameworks, modules, services, workflows, ides, core, cli, git, hooks
103
- - Auto-detection of skills based on project configuration
104
- - CLI commands: `rulebook skill list|add|remove|show|search`
105
- - MCP functions: `rulebook_skill_list|show|enable|disable|search|validate`
106
- - 🤖 **AI CLI Configuration Files**: Auto-generated files for AI CLI tools
107
- - `CLAUDE.md` - Claude Code CLI configuration
108
- - `CODEX.md` - OpenAI Codex CLI configuration
109
- - `GEMINI.md` - Google Gemini CLI configuration
110
- - `gemini-extension.json` - Gemini CLI extension manifest
111
- - 🔌 **Claude Code Plugin**: `marketplace.json` + `.claude-plugin/` structure for marketplace distribution
112
- - `marketplace.json` - Marketplace manifest for plugin discovery
113
- - Plugin manifest, MCP configuration, slash commands, and skills
114
-
115
- ### v1.1.5
116
-
117
- - 🗄️ **Service Integration Templates**: Added comprehensive service integration templates
118
- - 20 service templates: PostgreSQL, MySQL, MariaDB, SQL Server, Oracle, SQLite, MongoDB, Cassandra, DynamoDB, Redis, Memcached, Elasticsearch, Neo4j, InfluxDB, RabbitMQ, Kafka, S3, Azure Blob, GCS, MinIO
119
- - Automatic service detection from `package.json`, `.env`, and `docker-compose.yml`
120
- - Service-specific integration instructions with connection setup, operations, best practices, and configuration
121
- - Templates generated in `/rulebook/[SERVICE].md` with references in `AGENTS.md`
122
- - Interactive CLI prompt to select which services to include templates for
123
-
124
- ### v1.1.4
125
-
126
- - 🔧 **Cross-platform Git Hooks**: Git hooks now work on both Windows and Linux
127
- - Hooks are now generated as Node.js scripts with shell wrappers
128
- - Shell wrapper detects Node.js in common locations (Windows and Linux)
129
- - Node.js scripts use native `child_process.spawn` for cross-platform command execution
130
- - Pre-commit and pre-push hooks now function correctly on Windows (Git Bash) and Linux
131
- - 🔄 **Git Hooks Architecture**: Refactored hook generation system
132
- - Hooks are now generated as two files: shell wrapper + Node.js script
133
- - Shell templates (`.sh`) are automatically converted to Node.js scripts
134
- - Improved command parsing from shell templates to Node.js
135
- - Better error handling and cross-platform compatibility
136
-
137
- ### v1.1.3
138
-
139
- - 🗑️ **MCP Tool: `rulebook_task_delete`**: Delete tasks permanently
140
- - New tool to permanently delete tasks from the filesystem
141
- - Removes task directory recursively
142
- - Useful for cleaning up test tasks or removing unwanted tasks
143
- - Total of 7 MCP functions now available
144
-
145
- ### v1.1.2
146
-
147
- - 🔧 **ESLint v9 Migration**: Updated to ESLint flat config format
148
- - Migrated from `.eslintrc.json` to `eslint.config.js`
149
- - Updated to ESLint 9.37.0 with TypeScript ESLint 8.47.0
150
- - Added proper Node.js global type definitions
151
- - Linting now shows only errors (warnings suppressed with `--quiet`)
152
-
153
- ### v1.0.3
154
-
155
- - 🔧 **Zod v3 Compatibility**: Using Zod v3.25.76 for full MCP SDK compatibility
156
- - MCP SDK v1.22.0 requires Zod v3 (see [Issue #1429](https://github.com/modelcontextprotocol/modelcontextprotocol/issues/1429))
157
- - Will upgrade to Zod v4 when MCP SDK officially supports it
158
- - 🔄 **Dependency Updates**: All dependencies updated to latest versions
159
- - TypeScript tooling (ESLint 8.47.0, Vitest 4.0.13)
160
- - Node.js types updated to support Node.js 24.x
161
- - CLI tools and build utilities updated
162
- - 🐛 **Windows CI Fix**: Fixed PowerShell compatibility in GitHub Actions workflows
163
- - Removed bash-specific syntax from Windows runners
164
- - Cross-platform compatibility improved
165
-
166
- ### v1.0.2
167
-
168
- - 🔌 **MCP Server for Task Management**: New MCP server enables AI models to manage tasks programmatically
169
- - 7 MCP functions: create, list, show, update, validate, archive, delete tasks
170
- - Available via `npx @hivellm/rulebook@latest mcp-server` or `npx rulebook-mcp`
171
- - Better integration with MCP-compatible AI assistants
172
- - ⚡ **Faster Pre-commit Hooks**: Tests removed from pre-commit for faster backup commits
173
- - Pre-commit now runs only: format check, lint, type-check
174
- - Tests moved to pre-push hook for comprehensive validation
175
- - 🏗️ **Build Verification**: Build check now mandatory before push (runs first)
176
- - 📦 **pnpm Recommendation**: Added pnpm as preferred package manager with `.npmrc` configuration
177
- - 🚀 **Rust Build Optimization**: Comprehensive guide for faster Rust builds
178
- - sccache configuration, incremental compilation, lld linker
179
- - Anti-pattern documentation for `pub use big_crate::*;`
180
- - 📋 **Enhanced Task Management**: Strengthened OpenSpec format compliance and archiving rules
181
- - 📁 **Strict Markdown Organization**: UPPERCASE naming and `/docs` directory requirements
182
-
183
- ### v1.0.0
184
-
185
- - 🎉 **First Stable Release**: Production-ready with comprehensive features
186
- - 🔒 **Apache 2.0 License**: Changed from MIT to Apache License 2.0 for better compatibility
187
- - 🛡️ **Git Hooks Enforcement**: Pre-commit and pre-push hooks now block commits with lint/test errors
188
- - 📋 **Task File Structure Rules**: Enhanced directives in AGENTS.md about correct task structure
189
- - 🎯 **Built-in Task Management**: OpenSpec deprecated and integrated into Rulebook's native task system
190
- - 📋 **RULEBOOK.md Template**: Core template with task management directives and Context7 MCP requirements
191
- - 🚫 **Automatic .gitignore**: `npx @hivellm/rulebook@latest init` now creates/updates `.gitignore` automatically for 28 languages
192
- - 🔄 **Migration Support**: Existing OpenSpec tasks automatically migrated to `/.rulebook/tasks/` format
193
-
194
- > **Breaking Change**: OpenSpec module removed. Use `npx @hivellm/rulebook@latest task` commands instead. See [Migration Guide](docs/guides/OPENSPEC_MIGRATION.md).
55
+ ### v4.1.0 Background Indexer & Codebase Intelligence
56
+
57
+ - 🔍 **Background Indexer**: Autonomous daemon that continuously indexes your codebase into a searchable vector + graph database
58
+ - 🧠 **3 New MCP Tools**: `rulebook_codebase_search` (semantic code search), `rulebook_codebase_graph` (import/export relationships), `rulebook_indexer_status` (daemon status)
59
+ - 📋 **Deferred Items Protocol**: New mandatory directive ensuring deferred task items always get tracked as new Rulebook tasks before archiving
60
+ - 📚 **22 MCP Functions** total (was 19)
61
+
62
+ ### v4.0.0 — AI-first DX & Ralph maturity
63
+
64
+ - 🚀 **Zero-prompt `init`**: auto-configures from detection, no questionnaires
65
+ - 🛡️ **AGENTS.override.md**: project rules that survive every update
66
+ - 📊 **Health Scorer v2**: 9-category scoring with letter grade A–F
67
+ - 🤖 **Ralph v2**: parallel execution, plan checkpoint, context compression, security gate, GitHub Issues import
68
+ - 🐳 **Container + Observability**: Docker, K8s, Helm, Sentry, OTel, Datadog, Pino, Winston, Prometheus
69
+ - 🛠️ **Multi-tool**: Gemini CLI, Continue.dev, Windsurf, Copilot configs auto-generated
70
+ - 🔍 **AI Code Review**: `rulebook review` + GitHub Actions workflow
71
+ - 👥 **Multi-agent teams**: Claude Code agent definitions + team auto-configuration
72
+
73
+ ### v3.0.0 — Persistent Memory & Skills
74
+
75
+ - 🧠 **Persistent Memory**: zero-dependency BM25+HNSW hybrid search, SQLite/WASM, 7 memory types
76
+ - 🧩 **Skills System**: 244 skills across 10 categories with auto-detection and YAML frontmatter
77
+ - 🤖 **Ralph Autonomous Loop**: multi-iteration AI agent with quality gates, PRD, pause/resume
78
+
79
+ ### v2.0.0 Multi-tool & MCP
80
+
81
+ - 🔌 **MCP Server**: 19 functions for task management, skills, and memory
82
+ - 🤖 **AI CLI configs**: CLAUDE.md, CODEX.md, GEMINI.md auto-generated
83
+ - 🧩 **Skills**: modular enable/disable architecture
84
+
85
+ ### v1.0.0 Foundation
86
+
87
+ - 📋 **Task management**: OpenSpec-compatible format with full lifecycle
88
+ - 🛡️ **Git hooks**: pre-commit (format, lint, type-check) + pre-push (build, tests)
89
+ - 🌍 **28 languages, 17 frameworks**, auto-detection with confidence scores
195
90
 
196
91
  ---
197
92
 
@@ -299,6 +194,33 @@ Memory is enabled in `.rulebook`:
299
194
  - 📦 **Publication Ready**: CI/CD pipelines for npm, crates.io, PyPI, Maven Central, and more
300
195
  - 🔄 **Automatic Migration**: Existing projects automatically migrated to modular structure
301
196
 
197
+ ## VSCode Extension
198
+
199
+ The **Rulebook Dashboard** extension brings full visibility into your AI-powered workflow directly inside VSCode.
200
+
201
+ ```bash
202
+ # Install from .vsix (local)
203
+ code --install-extension vscode-extension/rulebook-dashboard-*.vsix
204
+
205
+ # Or build from source
206
+ cd vscode-extension && npm install && npm run compile
207
+ # Press F5 to launch Extension Development Host
208
+ ```
209
+
210
+ | Tab | What it shows |
211
+ |-----|---------------|
212
+ | 🤖 **Agents** | All Claude agent team members with real-time status (active/idle), memory state, last activity |
213
+ | 📋 **Tasks** | Project tasks with progress bars, expandable details, Archive & Update via AI buttons |
214
+ | 🔄 **Ralph** | Autonomous loop status, current iteration, progress tracking |
215
+ | 🧠 **Memory** | Memory stats (count, DB size, types), full-text search, clear/reprocess |
216
+ | 🔍 **Indexer** | Background indexer status, files processed, queue size, reindex button |
217
+
218
+ **Multi-root workspace support** — scans all open workspace folders for `.claude/agents/`, `.rulebook/tasks/`, and more.
219
+
220
+ **Status Bar** — `📖 Rulebook` button (opens dashboard), indexer indicator, Ralph running state.
221
+
222
+ > See [`vscode-extension/README.md`](vscode-extension/README.md) for full documentation.
223
+
302
224
  ## What It Does
303
225
 
304
226
  **For New Projects:**
@@ -10,11 +10,28 @@ export declare class RalphParser {
10
10
  static parseAgentOutput(agentOutput: string, iterationNum: number, taskId: string, taskTitle: string, tool: 'claude' | 'amp' | 'gemini'): IterationResult;
11
11
  /**
12
12
  * Extract quality check results from agent output.
13
- * Uses line-level matching to avoid false positives from global keyword presence.
13
+ * Uses structured count-based detection to avoid false positives.
14
+ * "0 errors" / "no errors" are treated as success, not failure.
14
15
  * Note: In MCP ralph_run, real quality gates are determined by actual command exit codes,
15
16
  * not this parser. This is a best-effort extraction for standalone parsing.
16
17
  */
17
18
  private static extractQualityChecks;
19
+ /**
20
+ * Parse lint error count from ESLint output.
21
+ * Returns 0 if no error count found (treat as passing).
22
+ */
23
+ private static parseLintErrorCount;
24
+ /**
25
+ * Parse test failure count from vitest/jest output.
26
+ * Returns 0 if no failure count found (treat as passing).
27
+ */
28
+ private static parseTestFailCount;
29
+ /**
30
+ * Parse real coverage percentage from test runner output.
31
+ * Supports vitest table format and jest/c8 line format.
32
+ * Returns null if coverage cannot be determined.
33
+ */
34
+ static parseCoveragePercentage(output: string): number | null;
18
35
  /**
19
36
  * Helper: Check if a single line contains percentage >= threshold
20
37
  */
@@ -47,5 +64,28 @@ export declare class RalphParser {
47
64
  * Check if iteration completion is detected
48
65
  */
49
66
  private static isCompletionDetected;
67
+ /**
68
+ * Parse `npm audit --json` output.
69
+ * Returns the highest severity found: 'critical' | 'high' | 'moderate' | 'low' | 'none'
70
+ */
71
+ static parseNpmAuditSeverity(jsonOutput: string): 'critical' | 'high' | 'moderate' | 'low' | 'none';
72
+ /**
73
+ * Parse text-based security tool output (trivy, semgrep, or npm audit without --json).
74
+ * Returns the highest severity found: 'critical' | 'high' | 'moderate' | 'low' | 'none'
75
+ */
76
+ static parseSecurityOutputText(output: string): 'critical' | 'high' | 'moderate' | 'low' | 'none';
77
+ /**
78
+ * Parse trivy JSON output (`trivy fs --format json`) for the highest severity found.
79
+ */
80
+ static parseTrivySeverity(jsonOutput: string): 'critical' | 'high' | 'moderate' | 'low' | 'none';
81
+ /**
82
+ * Parse semgrep JSON output (`semgrep --json`) for the highest severity found.
83
+ */
84
+ static parseSemgrepSeverity(jsonOutput: string): 'critical' | 'high' | 'moderate' | 'low' | 'none';
85
+ /**
86
+ * Determine if a security gate passes given the found severity and the configured failOn threshold.
87
+ * Severity order: none < low < moderate < high < critical
88
+ */
89
+ static securityGatePasses(foundSeverity: 'critical' | 'high' | 'moderate' | 'low' | 'none', failOn: 'critical' | 'high' | 'moderate' | 'low'): boolean;
50
90
  }
51
91
  //# sourceMappingURL=ralph-parser.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"ralph-parser.d.ts","sourceRoot":"","sources":["../../src/agents/ralph-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAChC,eAAe;IA4ClB;;;;;OAKG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAmDnC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAYrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAwB9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA4B/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IA4B5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAa/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAiB9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAiB/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;CAcpC"}
1
+ {"version":3,"file":"ralph-parser.d.ts","sourceRoot":"","sources":["../../src/agents/ralph-parser.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C;;;GAGG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,MAAM,CAAC,gBAAgB,CACrB,WAAW,EAAE,MAAM,EACnB,YAAY,EAAE,MAAM,EACpB,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,QAAQ,GAAG,KAAK,GAAG,QAAQ,GAChC,eAAe;IA4ClB;;;;;;OAMG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IA2EnC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,mBAAmB;IAgBlC;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,kBAAkB;IAgBjC;;;;OAIG;IACH,MAAM,CAAC,uBAAuB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI;IA4B7D;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,sBAAsB;IAYrC;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAwB9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IA4B/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,aAAa;IA4B5B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAa/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,eAAe;IAiB9B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,gBAAgB;IAiB/B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAenC;;;OAGG;IACH,MAAM,CAAC,qBAAqB,CAC1B,UAAU,EAAE,MAAM,GACjB,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM;IAoBpD;;;OAGG;IACH,MAAM,CAAC,uBAAuB,CAC5B,MAAM,EAAE,MAAM,GACb,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM;IASpD;;OAEG;IACH,MAAM,CAAC,kBAAkB,CAAC,UAAU,EAAE,MAAM,GAAG,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM;IAoBhG;;OAEG;IACH,MAAM,CAAC,oBAAoB,CACzB,UAAU,EAAE,MAAM,GACjB,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM;IAyBpD;;;OAGG;IACH,MAAM,CAAC,kBAAkB,CACvB,aAAa,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAAG,MAAM,EAChE,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,UAAU,GAAG,KAAK,GAC/C,OAAO;CAMX"}