@hivehub/rulebook 3.0.0 → 3.2.0

package/package.json

@@ -1,107 +1,108 @@
-{
-  "name": "@hivehub/rulebook",
-  "version": "3.0.0",
-  "description": "Standardize AI-generated projects with automated templates, quality gates, persistent memory, and framework detection for 28 languages, 17 frameworks, 13 MCP modules, and 20 services",
-  "type": "module",
-  "main": "dist/index.js",
-  "bin": {
-    "rulebook": "./dist/index.js",
-    "rulebook-mcp": "./dist/mcp/rulebook-server.js"
-  },
-  "scripts": {
-    "build": "tsc",
-    "dev": "tsx src/index.ts",
-    "test": "vitest run --no-watch",
-    "test:watch": "vitest",
-    "test:coverage": "vitest run --coverage --no-watch",
-    "test:agent": "node scripts/test-agent-simple.mjs",
-    "test:agent:quick": "node scripts/test-agent-simple.mjs",
-    "test:agent:full": "node scripts/test-agent-manager.js all",
-    "test:agent:comprehensive": "npx vitest run tests/agent-manager-comprehensive.test.ts",
-    "setup:mcp": "node scripts/setup-mcp-config.js",
-    "lint": "npx eslint src/**/*.ts --quiet",
-    "lint:fix": "npx eslint src/**/*.ts --fix --quiet",
-    "format": "npx prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
-    "type-check": "tsc --noEmit",
-    "prepublishOnly": "npm run build",
-    "publish:wsl": "export BROWSER=wslview && npm publish",
-    "mcp-server": "node dist/mcp/rulebook-server.js"
-  },
-  "keywords": [
-    "ai",
-    "automation",
-    "templates",
-    "rules",
-    "standards",
-    "cli",
-    "npx",
-    "agents",
-    "cursor",
-    "windsurf",
-    "git-hooks",
-    "frameworks",
-    "nestjs",
-    "django",
-    "nextjs",
-    "mcp",
-    "typescript",
-    "rust",
-    "python"
-  ],
-  "author": "HiveLLM Team",
-  "license": "Apache-2.0",
-  "engines": {
-    "node": ">=20.0.0"
-  },
-  "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.22.0",
-    "@types/blessed": "^0.1.26",
-    "ansi-escapes": "^7.2.0",
-    "blessed": "^0.1.81",
-    "chalk": "^5.3.0",
-    "cli-cursor": "^5.0.0",
-    "commander": "^14.0.2",
-    "execa": "^9.6.0",
-    "glob": "^13.0.0",
-    "inquirer": "^13.0.1",
-    "js-yaml": "^4.1.1",
-    "node-notifier": "^10.0.1",
-    "ora": "^9.0.0",
-    "picocolors": "^1.0.0",
-    "sql.js": "^1.14.0",
-    "uuid": "^13.0.0",
-    "zod": "^3.25.76"
-  },
-  "devDependencies": {
-    "@eslint/js": "^9.37.0",
-    "@types/inquirer": "^9.0.0",
-    "@types/js-yaml": "^4.0.0",
-    "@types/node": "^24.10.1",
-    "@types/node-notifier": "^8.0.5",
-    "@types/uuid": "^10.0.0",
-    "@typescript-eslint/eslint-plugin": "^8.47.0",
-    "@typescript-eslint/parser": "^8.47.0",
-    "@vitest/coverage-v8": "^4.0.13",
-    "eslint": "^9.37.0",
-    "globals": "^15.11.0",
-    "prettier": "^3.2.0",
-    "tsx": "^4.7.0",
-    "typescript": "^5.3.3",
-    "vitest": "^4.0.13"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "files": [
-    "dist",
-    "templates"
-  ],
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/hivellm/rulebook.git"
-  },
-  "bugs": {
-    "url": "https://github.com/hivellm/rulebook/issues"
-  },
-  "homepage": "https://github.com/hivellm/rulebook#readme"
-}
+{
+  "name": "@hivehub/rulebook",
+  "version": "3.2.0",
+  "description": "Standardize AI-generated projects with automated templates, quality gates, persistent memory, and framework detection for 28 languages, 17 frameworks, 13 MCP modules, and 20 services",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "rulebook": "./dist/index.js",
+    "rulebook-mcp": "./dist/mcp/rulebook-server.js"
+  },
+  "keywords": [
+    "ai",
+    "automation",
+    "templates",
+    "rules",
+    "standards",
+    "cli",
+    "npx",
+    "agents",
+    "cursor",
+    "windsurf",
+    "git-hooks",
+    "frameworks",
+    "nestjs",
+    "django",
+    "nextjs",
+    "mcp",
+    "typescript",
+    "rust",
+    "python"
+  ],
+  "author": "HiveLLM Team",
+  "license": "Apache-2.0",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.22.0",
+    "@types/blessed": "^0.1.26",
+    "ansi-escapes": "^7.2.0",
+    "blessed": "^0.1.81",
+    "chalk": "^5.3.0",
+    "cli-cursor": "^5.0.0",
+    "commander": "^14.0.2",
+    "execa": "^9.6.0",
+    "glob": "^13.0.0",
+    "inquirer": "^13.0.1",
+    "js-yaml": "^4.1.1",
+    "node-notifier": "^10.0.1",
+    "ora": "^9.0.0",
+    "picocolors": "^1.0.0",
+    "sql.js": "^1.14.0",
+    "uuid": "^13.0.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.37.0",
+    "@types/inquirer": "^9.0.0",
+    "@types/js-yaml": "^4.0.0",
+    "@types/node": "^24.10.1",
+    "@types/node-notifier": "^8.0.5",
+    "@types/uuid": "^10.0.0",
+    "@typescript-eslint/eslint-plugin": "^8.47.0",
+    "@typescript-eslint/parser": "^8.47.0",
+    "@vitest/coverage-v8": "^4.0.13",
+    "eslint": "^9.37.0",
+    "globals": "^15.11.0",
+    "prettier": "^3.2.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.3.3",
+    "vitest": "^4.0.13"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "templates",
+    ".claude-plugin",
+    ".claude/commands"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hivellm/rulebook.git"
+  },
+  "bugs": {
+    "url": "https://github.com/hivellm/rulebook/issues"
+  },
+  "homepage": "https://github.com/hivellm/rulebook#readme",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run --no-watch",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage --no-watch",
+    "test:agent": "node scripts/test-agent-simple.mjs",
+    "test:agent:quick": "node scripts/test-agent-simple.mjs",
+    "test:agent:full": "node scripts/test-agent-manager.js all",
+    "test:agent:comprehensive": "npx vitest run tests/agent-manager-comprehensive.test.ts",
+    "setup:mcp": "node scripts/setup-mcp-config.js",
+    "lint": "npx eslint src/**/*.ts --quiet",
+    "lint:fix": "npx eslint src/**/*.ts --fix --quiet",
+    "format": "npx prettier --write \"src/**/*.ts\" \"tests/**/*.ts\"",
+    "type-check": "tsc --noEmit",
+    "publish:wsl": "export BROWSER=wslview && npm publish",
+    "mcp-server": "node dist/mcp/rulebook-server.js"
+  }
+}

package/templates/cli/CLAUDE.md

@@ -26,7 +26,92 @@ Implement [feature] with tests first (95%+ coverage)."
 2. Request features with standards reference
 3. Review generated code
 4. Run quality checks
+5. Save learnings to persistent memory
 
 **Critical**: Claude has 200K context - paste full AGENTS.md for best results.
 
+## ⚠️ Token Optimization (CRITICAL)
+
+**MINIMIZE unnecessary output to reduce token consumption:**
+
+### DO ✅
+- Output code directly without explanations
+- Use code comments for complex logic instead of markdown
+- Return results concisely: "✅ Done" or "❌ Error: reason"
+- Use tables only when absolutely necessary
+- Combine multiple small outputs into single response
+
+### DON'T ❌
+- **NEVER generate markdown reports or summaries** unless explicitly requested
+- **NEVER use excessive heading levels** (#, ##, ###, etc.)
+- **NEVER create "Quality Checks" sections** with status boxes
+- **NEVER output commit messages verbatim** - just say "committed"
+- **NEVER explain what you did** - assume user knows project structure
+- **NEVER use emoji status lines** (✅ Type check: Passed) - too verbose
+- **NEVER generate "Next Steps" sections** - just do the work
+- **NEVER output implementation details in plain text** - put in code comments
+
+### Example: BAD (Wastes Tokens)
+```
+✅ Implementation Complete
+
+📝 Changes:
+- Added UserService class
+- Added authentication middleware
+- Updated routes configuration
+
+🧪 Quality Checks:
+- ✅ Type check: Passed
+- ✅ Linting: Passed (0 warnings)
+- ✅ Tests: 45/45 passed (100%)
+- ✅ Coverage: 96% (threshold: 95%)
+
+📊 Summary:
+This implementation adds...
+
+Next Steps:
+1. Review the code
+2. Deploy to production
+```
+
+### Example: GOOD (Efficient)
+```
+✅ Done. UserService added with auth middleware.
+```
+
+Put details in code comments, not markdown.
+
+## Persistent Memory Integration
+
+### Search for Past Context
+Before implementing a feature, search memory for similar past work:
+
+```bash
+# Search for past implementations
+rulebook memory search "feature name" --mode hybrid --type feature
+
+# View timeline of related work
+rulebook memory timeline --memoryId <id>
+```
+
+### Save Implementation Insights
+After completing implementation, capture key learnings:
+
+```bash
+# Save feature implementation
+rulebook memory save "Implemented [feature] with [approach]. Key decision: [why]. Gotcha: [edge case]. Pattern: [reusable solution]" --type feature --title "[Feature name]" --tags tag1,tag2
+
+# Save bugfix insights
+rulebook memory save "Fixed [bug] by [solution]. Root cause: [why it happened]. Test case: [added validation]" --type bugfix --title "[Bug description]" --tags bugfix,area
+
+# Save architectural decisions
+rulebook memory save "Chose [approach] over [alternative] because [reasoning]. Tradeoffs: [what was sacrificed]. Future implications: [impact on architecture]" --type decision --title "[Decision name]" --tags architecture,decision
+```
+
+### Use Context from Memory
+When Claude Code returns, your memory system auto-captures learnings. Review and augment:
+1. Search relevant memories: `rulebook memory search "your topic"`
+2. Review 3-layer search results: compact → timeline → full details
+3. Reference past patterns in new implementations
+
 <!-- CLAUDE:END -->

package/templates/cli/CLINE.md

@@ -24,9 +24,76 @@ Install Cline extension in VS Code or use CLI mode.
 
 1. Keep AGENTS.md open in workspace
 2. Request features with "Follow @AGENTS.md" prefix
-3. Review proposed changes before approval
-4. Verify tests pass after implementation
+3. Search memory for similar past implementations before starting
+4. Review proposed changes before approval
+5. Verify tests pass after implementation
+6. Save learnings to persistent memory
 
 **Critical**: Reference @AGENTS.md in every prompt for consistent output.
 
+## ⚠️ Token Optimization (CRITICAL)
+
+**Minimize output to reduce token consumption:**
+
+### DO ✅
+- Output code directly
+- Use code comments for explanations
+- Return concise results: "✅ Done" instead of reports
+- Combine multiple small outputs
+
+### DON'T ❌
+- **NEVER generate markdown reports** unless explicitly requested
+- **NEVER use emoji status lines** (✅ Type check: Passed)
+- **NEVER create "Quality Checks" sections** with status boxes
+- **NEVER explain implementation details** in plain text
+- **NEVER add "Next Steps" sections**
+
+**Example**:
+- ❌ BAD: "✅ Type check: Passed. ✅ Linting: 0 warnings. ✅ Tests: 45/45..." (500+ tokens)
+- ✅ GOOD: "✅ Checks pass. Tests: 45/45." (~50 tokens)
+
+## Persistent Memory Integration
+
+### Before Implementation
+Always search for past similar work:
+
+```bash
+# Search for feature implementations
+rulebook memory search "your feature" --mode hybrid
+
+# View specific implementation details
+rulebook memory get <memory-id>
+```
+
+### Prompt Template with Memory
+When requesting a feature, include memory context:
+
+```
+Follow @AGENTS.md and @.rulebook/memory.md.
+
+Similar past implementations from memory:
+[paste relevant memory summaries]
+
+Implement [feature]...
+```
+
+### After Implementation
+Cline's auto-capture may save learnings. Augment with additional context:
+
+```bash
+# Verify auto-captured memory
+rulebook memory search "feature name" --type feature
+
+# Add additional context if needed
+rulebook memory save "Implementation details and patterns..." --type feature --title "Feature name"
+```
+
+## Memory-Aware Development
+
+The memory system provides:
+- **Pattern discovery**: Find reusable solutions from past work
+- **Gotcha avoidance**: Learn from past edge cases
+- **Decision context**: Understand architectural choices
+- **Faster iteration**: Reference proven approaches
+
 <!-- CLINE:END -->

package/templates/cli/CURSOR_CLI.md

@@ -19,10 +19,44 @@ Cursor automatically references:
 ## Workflow
 
 1. Use `@AGENTS.md` in chat to reference standards
-2. Request: "Follow @AGENTS.md. Implement [feature] with tests."
-3. Cursor respects .cursorrules and AGENTS.md automatically
-4. Review and accept changes
+2. Check past implementations in memory before starting
+3. Request: "Follow @AGENTS.md. Implement [feature] with tests."
+4. Cursor respects .cursorrules and AGENTS.md automatically
+5. Save implementation learnings to memory
+6. Review and accept changes
 
 **Critical**: Generated `.cursorrules` points to AGENTS.md. Use @ mentions for explicit references.
 
+## Persistent Memory Integration
+
+### Using Memory in Cursor
+When requesting features, include memory context:
+
+```
+@AGENTS.md
+@.rulebook/memory.md (if available)
+
+Search memory for similar implementations and include in your reasoning before implementing.
+Implement [feature]...
+```
+
+### Capturing Implementation Learnings
+After Cursor completes work:
+
+```bash
+# Review auto-captured memories
+rulebook memory search "feature name"
+
+# Augment with additional insights
+rulebook memory save "Implementation approach, patterns discovered, edge cases handled..." --type feature --title "Feature name" --tags relevant,tags
+```
+
+### Memory-Enhanced Development
+Cursor + Memory workflow:
+1. **Search**: Find past implementations with similar patterns
+2. **Reference**: Include relevant memories in prompts for context
+3. **Implement**: Cursor generates code informed by past solutions
+4. **Capture**: Save learnings for future sessions
+5. **Search Again**: Next session finds and leverages the work
+
 <!-- CURSOR_CLI:END -->