@hivehub/rulebook 5.8.2 → 6.0.0

package/templates/compact-context/python.md

@@ -1,26 +1,26 @@
-# Post-compaction cheat sheet (Python project)
-
-Re-injected after every compaction. Keep ≤50 lines. Edit freely.
-
-## Critical reminders
-
-- Read `AGENTS.md` and `AGENTS.override.md` before changes.
-- Type-check (`mypy` / `pyright`) before `pytest`.
-- `ruff check` before committing.
-- Edit files sequentially, not in parallel.
-- Never revert uncommitted work; fix forward.
-- If a fix fails twice, stop and escalate.
-
-## Build & test quick reference
-
-- **Install**: `pip install -e .` or `poetry install` or `uv sync`
-- **Type-check**: `mypy .` or `pyright`
-- **Lint**: `ruff check .`
-- **Format**: `ruff format .` or `black .`
-- **Test**: `pytest`
-
-## Forbidden
-
-- No bare `except:` — catch specific exceptions.
-- No new dependencies without authorization.
-- No `rm -rf` in this repo.
+# Post-compaction cheat sheet (Python project)
+
+Re-injected after every compaction. Keep ≤50 lines. Edit freely.
+
+## Critical reminders
+
+- Read `AGENTS.md` and `AGENTS.override.md` before changes.
+- Type-check (`mypy` / `pyright`) before `pytest`.
+- `ruff check` before committing.
+- Edit files sequentially, not in parallel.
+- Never revert uncommitted work; fix forward.
+- If a fix fails twice, stop and escalate.
+
+## Build & test quick reference
+
+- **Install**: `pip install -e .` or `poetry install` or `uv sync`
+- **Type-check**: `mypy .` or `pyright`
+- **Lint**: `ruff check .`
+- **Format**: `ruff format .` or `black .`
+- **Test**: `pytest`
+
+## Forbidden
+
+- No bare `except:` — catch specific exceptions.
+- No new dependencies without authorization.
+- No `rm -rf` in this repo.

package/templates/compact-context/rust.md

@@ -1,28 +1,28 @@
-# Post-compaction cheat sheet (Rust project)
-
-Re-injected after every compaction. Keep ≤50 lines. Edit freely.
-
-## Critical reminders
-
-- Read `AGENTS.md` and `AGENTS.override.md` before changes.
-- `cargo check` before `cargo test` — check is 5–10x faster.
-- `cargo clippy -- -D warnings` must pass.
-- `cargo fmt` before committing — no style debates.
-- Edit files sequentially, not in parallel.
-- Never revert uncommitted work; fix forward.
-- If a fix fails twice, stop and escalate.
-
-## Build & test quick reference
-
-- **Check**: `cargo check --all-targets`
-- **Build**: `cargo build`
-- **Test**: `cargo test --all-features`
-- **Lint**: `cargo clippy -- -D warnings`
-- **Format**: `cargo fmt`
-- **Run**: `cargo run`
-
-## Forbidden
-
-- No `unwrap()`/`expect()` in non-test code without a safety comment.
-- No `unsafe` without a `// SAFETY:` comment.
-- No new crates without authorization.
+# Post-compaction cheat sheet (Rust project)
+
+Re-injected after every compaction. Keep ≤50 lines. Edit freely.
+
+## Critical reminders
+
+- Read `AGENTS.md` and `AGENTS.override.md` before changes.
+- `cargo check` before `cargo test` — check is 5–10x faster.
+- `cargo clippy -- -D warnings` must pass.
+- `cargo fmt` before committing — no style debates.
+- Edit files sequentially, not in parallel.
+- Never revert uncommitted work; fix forward.
+- If a fix fails twice, stop and escalate.
+
+## Build & test quick reference
+
+- **Check**: `cargo check --all-targets`
+- **Build**: `cargo build`
+- **Test**: `cargo test --all-features`
+- **Lint**: `cargo clippy -- -D warnings`
+- **Format**: `cargo fmt`
+- **Run**: `cargo run`
+
+## Forbidden
+
+- No `unwrap()`/`expect()` in non-test code without a safety comment.
+- No `unsafe` without a `// SAFETY:` comment.
+- No new crates without authorization.

package/templates/compact-context/typescript.md

@@ -1,29 +1,29 @@
-# Post-compaction cheat sheet (TypeScript project)
-
-Re-injected after every compaction. Keep ≤50 lines. Edit freely.
-
-## Critical reminders
-
-- Read `AGENTS.md` and `AGENTS.override.md` before changes.
-- `npm run type-check` before `npm test` — type errors are cheaper.
-- `npm run lint` must pass with zero warnings.
-- Edit files sequentially, not in parallel.
-- Never revert uncommitted work; fix forward.
-- If a fix fails twice, stop and escalate.
-- Use MCP tools (`mcp__rulebook__*`) over shell where available.
-
-## Build & test quick reference
-
-- **Install**: `npm install`
-- **Build**: `npm run build` (TypeScript → `dist/`)
-- **Type-check**: `npm run type-check`
-- **Lint**: `npm run lint`
-- **Test**: `npm test` (or `npx vitest run <file>` for single file)
-- **Dev**: `npm run dev`
-
-## Forbidden
-
-- No `any` without justification.
-- No `// @ts-ignore` without a one-line reason.
-- No new dependencies without explicit authorization.
-- No `rm -rf` in this repo.
+# Post-compaction cheat sheet (TypeScript project)
+
+Re-injected after every compaction. Keep ≤50 lines. Edit freely.
+
+## Critical reminders
+
+- Read `AGENTS.md` and `AGENTS.override.md` before changes.
+- `npm run type-check` before `npm test` — type errors are cheaper.
+- `npm run lint` must pass with zero warnings.
+- Edit files sequentially, not in parallel.
+- Never revert uncommitted work; fix forward.
+- If a fix fails twice, stop and escalate.
+- Use MCP tools (`mcp__rulebook__*`) over shell where available.
+
+## Build & test quick reference
+
+- **Install**: `npm install`
+- **Build**: `npm run build` (TypeScript → `dist/`)
+- **Type-check**: `npm run type-check`
+- **Lint**: `npm run lint`
+- **Test**: `npm test` (or `npx vitest run <file>` for single file)
+- **Dev**: `npm run dev`
+
+## Forbidden
+
+- No `any` without justification.
+- No `// @ts-ignore` without a one-line reason.
+- No new dependencies without explicit authorization.
+- No `rm -rf` in this repo.

package/templates/core/AGENTS_LEAN.md

@@ -82,7 +82,7 @@ If you must defer an item before archiving, you MUST create a follow-up rulebook
 After ANY implementation, execute in order:
 
 1. **Quality checks** (all must pass): type-check → lint (0 warnings) → format → tests (100%) → coverage (≥95%). Stop and fix on any failure.
-2. **Capture to memory**: `rulebook_memory_save` for decisions, patterns, gotchas, bug fixes.
+2. **Capture learnings**: `rulebook_knowledge_add` / `rulebook_learn_capture` for patterns, gotchas, and decisions.
 3. **Security audit**: `npm audit --production` (or language equivalent).
 4. **Update task**: `rulebook_task_update` + mark items `[x]`.
 5. **Update docs**: CHANGELOG (conventional commits), README if public API changed.
@@ -91,15 +91,10 @@ After ANY implementation, execute in order:
 
 **Skip steps only with explicit user permission.**
 
-## Persistent Memory
+## Session continuity
 
-Backed by Rulebook MCP server (BM25 + HNSW hybrid search). Memory persists across sessions.
-
-- **Start of session**: `rulebook_memory_search` for relevant past context.
-- **During work**: `rulebook_memory_save` for decisions, bugs, discoveries, user preferences.
-- **End of session**: `rulebook_session_end` writes a summary.
-
-3-layer search pattern: `rulebook_memory_search` (compact) → `rulebook_memory_timeline` (window) → `rulebook_memory_get` (full details).
+- **Start of session**: read `.rulebook/PLANS.md`; `rulebook_session_start` loads prior context.
+- **End of session**: `rulebook_session_end` writes a summary to `.rulebook/PLANS.md`.
 
 ## Knowledge Base
 

package/templates/core/AGENTS_OVERRIDE.md

@@ -1,16 +1,16 @@
-<!-- OVERRIDE:START -->
-# Project-Specific Overrides
-
-This file contains project-specific directives that take precedence over the generated AGENTS.md.
-
-Add your custom rules, team conventions, or project-specific context here.
-This file is NEVER overwritten by `rulebook init` or `rulebook update`.
-
-## Example Overrides
-
-- **Preferred patterns**: Always use X pattern for Y
-- **Team conventions**: Code reviews require 2 approvals
-- **Project context**: This project targets Node.js 20+ only
-- **Custom quality gates**: Run `npm run e2e` before merging
-
-<!-- OVERRIDE:END -->
+<!-- OVERRIDE:START -->
+# Project-Specific Overrides
+
+This file contains project-specific directives that take precedence over the generated AGENTS.md.
+
+Add your custom rules, team conventions, or project-specific context here.
+This file is NEVER overwritten by `rulebook init` or `rulebook update`.
+
+## Example Overrides
+
+- **Preferred patterns**: Always use X pattern for Y
+- **Team conventions**: Code reviews require 2 approvals
+- **Project context**: This project targets Node.js 20+ only
+- **Custom quality gates**: Run `npm run e2e` before merging
+
+<!-- OVERRIDE:END -->