bluera-knowledge 0.9.31 → 0.9.34

package/.claude/commands/code-review.md

@@ -0,0 +1,15 @@
+# Code Review
+
+Review the local codebase using multi-agent analysis. See @.claude/skills/code-review-repo/skill.md for process details.
+
+## Context
+
+!`echo "---PROJECT---" && ls -la && echo "---CLAUDE.md FILES---" && find . -name CLAUDE.md 2>/dev/null`
+
+## Workflow
+
+1. **Gather context**: Find all CLAUDE.md files and source files
+2. **Multi-agent review**: Launch 5 parallel agents (CLAUDE.md compliance, bug scan, git history, PR comments, code comments)
+3. **Score issues**: Haiku agents score each issue 0-100 for confidence
+4. **Filter**: Only report issues with confidence >= 80
+5. **Output**: Print formatted results to console

package/.claude/hooks/post-edit-check.sh

@@ -29,9 +29,11 @@ if [ -n "$TYPE_OUTPUT" ]; then
   exit 2
 fi
 
-# Check for anti-patterns in code files
-if git diff -- ':!.claude/' | grep -E '\b(fallback|deprecated|backward compatibility)\b' | grep -v '^-' | grep -qE '^\+'; then
-  echo 'Anti-pattern detected (fallback/deprecated/backward compatibility). Review CLAUDE.md.' >&2
+# Check for anti-patterns in code files only (not docs/markdown)
+ANTI_PATTERN=$(git diff -- '*.ts' '*.tsx' '*.js' '*.jsx' ':!dist/' | grep -E '\b(fallback|deprecated|backward compatibility|legacy)\b' | grep -v '^-' | grep -E '^\+' || true)
+if [ -n "$ANTI_PATTERN" ]; then
+  echo 'Anti-pattern detected (fallback/deprecated/backward compatibility/legacy). Review CLAUDE.md.' >&2
+  echo "$ANTI_PATTERN" >&2
   exit 2
 fi
 

package/.claude/skills/atomic-commits/SKILL.md

@@ -56,4 +56,6 @@ Identify logical features by grouping related files:
 <type>(<scope>): <description>
 ```
 
-Types: `feat`, `fix`, `docs`, `chore`, `refactor`, `test`, `style`
+Types: `feat`, `fix`, `docs`, `chore`, `refactor`, `test`, `style`, `build`, `ci`, `perf`
+
+**Note:** Commit messages are validated by commitlint (conventional commits format).

package/.claude/skills/code-review-repo/skill.md

@@ -0,0 +1,62 @@
+---
+name: code-review-repo
+description: Review local codebase for bugs and CLAUDE.md compliance using multi-agent analysis
+version: 1.0.0
+---
+
+# Local Code Review
+
+Review the entire local codebase for bugs, issues, and CLAUDE.md compliance.
+
+## Process
+
+1. **Gather CLAUDE.md files**: Use a Haiku agent to find all CLAUDE.md files in the repository (root and subdirectories)
+
+2. **Identify source files**: Determine which files to review:
+   - Include: `.ts`, `.tsx`, `.js`, `.jsx`, `.py`, `.rs`, `.go` and similar source files
+   - Exclude: `node_modules/`, `dist/`, `.git/`, vendor directories, generated files
+
+3. **Multi-agent review**: Launch 5 parallel Sonnet agents to independently review the codebase. Each agent returns a list of issues with reasons:
+   - **Agent #1**: Audit for CLAUDE.md compliance. Check that code follows guidelines in all relevant CLAUDE.md files.
+   - **Agent #2**: Shallow bug scan. Look for obvious bugs, error handling issues, and logic errors. Focus on significant bugs, not nitpicks.
+   - **Agent #3**: Git history context. Use git blame and history to identify patterns, recent changes, and potential issues in light of historical context.
+   - **Agent #4**: Previous PR comments. Check closed PRs that touched these files for any feedback that might apply.
+   - **Agent #5**: Code comment compliance. Ensure code follows any guidance in TODO, FIXME, NOTE, or other code comments.
+
+4. **Confidence scoring**: For each issue found, launch a parallel Haiku agent to score confidence (0-100):
+   - **0**: False positive, doesn't hold up to scrutiny
+   - **25**: Might be real, but unverified. Stylistic issues not in CLAUDE.md
+   - **50**: Real but minor, rarely hit in practice
+   - **75**: Verified real issue, important, directly impacts functionality or mentioned in CLAUDE.md
+   - **100**: Definitely real, frequently hit, evidence confirms
+
+5. **Filter**: Only report issues with score >= 80
+
+## False Positive Examples
+
+Avoid flagging:
+- Issues that linters/typecheckers catch (imports, types, formatting)
+- General quality issues unless in CLAUDE.md
+- Code with lint-ignore comments for that specific issue
+- Pre-existing issues unrelated to recent changes
+- Pedantic nitpicks a senior engineer wouldn't mention
+
+## Output Format
+
+### Code review
+
+Found N issues:
+
+1. Brief description (CLAUDE.md says "...")
+   `file/path.ts:42`
+
+2. Brief description (bug due to missing error handling)
+   `file/path.ts:88-95`
+
+---
+
+Or if no issues:
+
+### Code review
+
+No issues found. Checked for bugs and CLAUDE.md compliance.

package/.husky/pre-commit

@@ -6,7 +6,7 @@ STAGED_FILES=$(git diff --cached --name-only --diff-filter=ACM)
 # Categorize changes
 HAS_SRC_CHANGES=$(echo "$STAGED_FILES" | grep -E '^src/.*\.(ts|js)$' || true)
 HAS_TEST_CHANGES=$(echo "$STAGED_FILES" | grep -E '\.(test|spec)\.(ts|js)$' || true)
-HAS_CONFIG_CHANGES=$(echo "$STAGED_FILES" | grep -E '^(package\.json|tsconfig\.json|tsup\.config\.ts|\.eslintrc|knip\.json)' || true)
+HAS_CONFIG_CHANGES=$(echo "$STAGED_FILES" | grep -E '^(package\.json|tsconfig\.json|tsup\.config\.ts|vitest\.config\.ts|\.eslintrc|knip\.json|\.prettierrc|commitlint\.config\.js)' || true)
 HAS_DOC_CHANGES=$(echo "$STAGED_FILES" | grep -E '\.(md|txt)$|^LICENSE|^NOTICE' || true)
 HAS_DIST_CHANGES=$(echo "$STAGED_FILES" | grep -E '^dist/' || true)
 
@@ -25,8 +25,9 @@ fi
 # Run checks based on what changed
 echo "🔍 Running validation checks..."
 
-# Always run lint and typecheck for code/config changes
+# Always run format check, lint and typecheck for code/config changes
 if [ -n "$HAS_SRC_CHANGES" ] || [ -n "$HAS_TEST_CHANGES" ] || [ -n "$HAS_CONFIG_CHANGES" ]; then
+  bun run format:check:quiet || exit 1
   bun run lint:quiet || exit 1
   bun run lint:deadcode:quiet || exit 1
   bun run typecheck:quiet || exit 1

package/.prettierrc

@@ -0,0 +1,9 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "trailingComma": "es5",
+  "tabWidth": 2,
+  "useTabs": false,
+  "printWidth": 100,
+  "endOfLine": "lf"
+}

package/.versionrc.json

@@ -11,7 +11,7 @@
       "type": "json"
     },
     {
-      "filename": ".claude-plugin/plugin.json",
+      "filename": "plugin.json",
       "type": "json"
     }
   ],

package/CHANGELOG.md

@@ -2,6 +2,41 @@
 
 All notable changes to this project will be documented in this file. See [commit-and-tag-version](https://github.com/absolute-version/commit-and-tag-version) for commit guidelines.
 
+## [0.9.34](https://github.com/blueraai/bluera-knowledge/compare/v0.9.32...v0.9.34) (2026-01-08)
+
+
+### Bug Fixes
+
+* **bridge:** kill Python process before nullifying to prevent zombie ([393dab3](https://github.com/blueraai/bluera-knowledge/commit/393dab3e45c75fd87c9ecfc1ca92e67b14526e79))
+* **bridge:** mock kill() emits exit event & attach rejection handlers before stop ([d73c6ca](https://github.com/blueraai/bluera-knowledge/commit/d73c6ca6d640c3d15bd82756cabcda832f9ae245))
+* **bridge:** stop() now waits for process to actually exit ([a92de41](https://github.com/blueraai/bluera-knowledge/commit/a92de41c89318fc106f996568ed88505352d5159))
+* **cli:** ensure destroyServices runs before process.exit ([22e4267](https://github.com/blueraai/bluera-knowledge/commit/22e4267b7b9f698de3985a89b9c2b10759cfd49c))
+* **code-unit:** brace counting now handles strings and comments ([1e857bb](https://github.com/blueraai/bluera-knowledge/commit/1e857bb297f357b97a6c067950e62495b3c8fc99))
+* **code-unit:** support complex return types in signature extraction ([3bd2467](https://github.com/blueraai/bluera-knowledge/commit/3bd24675a67e73cc74a0c718f4b5a9e86cd826fb))
+* **job:** validate PID before process.kill to prevent process group kill ([67c540f](https://github.com/blueraai/bluera-knowledge/commit/67c540fef6f2c55c5dca2c824104a91fe19aeff1))
+* **services:** fail fast on corrupted config/registry files ([030f63c](https://github.com/blueraai/bluera-knowledge/commit/030f63c10b0a30bddcd8e9b27b291ab0f53263f1))
+* **tests:** increase timeout for flaky store delete test ([738fb49](https://github.com/blueraai/bluera-knowledge/commit/738fb4975653703d800dee802730dedfdf9e85ba))
+* **watch:** clear pending timeouts on unwatch to prevent timer leak ([4dcafc1](https://github.com/blueraai/bluera-knowledge/commit/4dcafc14417442f6eeed0257cf185e04ae9de12b))
+* **worker:** prevent division by zero and improve cancellation handling ([b7b40ab](https://github.com/blueraai/bluera-knowledge/commit/b7b40ab950b7ad0fbbe84af243be3138b1072a72))
+
+## [0.9.33](https://github.com/blueraai/bluera-knowledge/compare/v0.9.32...v0.9.33) (2026-01-08)
+
+
+### Bug Fixes
+
+* **bridge:** kill Python process before nullifying to prevent zombie ([393dab3](https://github.com/blueraai/bluera-knowledge/commit/393dab3e45c75fd87c9ecfc1ca92e67b14526e79))
+* **bridge:** mock kill() emits exit event & attach rejection handlers before stop ([d73c6ca](https://github.com/blueraai/bluera-knowledge/commit/d73c6ca6d640c3d15bd82756cabcda832f9ae245))
+* **bridge:** stop() now waits for process to actually exit ([a92de41](https://github.com/blueraai/bluera-knowledge/commit/a92de41c89318fc106f996568ed88505352d5159))
+* **cli:** ensure destroyServices runs before process.exit ([22e4267](https://github.com/blueraai/bluera-knowledge/commit/22e4267b7b9f698de3985a89b9c2b10759cfd49c))
+* **code-unit:** brace counting now handles strings and comments ([1e857bb](https://github.com/blueraai/bluera-knowledge/commit/1e857bb297f357b97a6c067950e62495b3c8fc99))
+* **code-unit:** support complex return types in signature extraction ([3bd2467](https://github.com/blueraai/bluera-knowledge/commit/3bd24675a67e73cc74a0c718f4b5a9e86cd826fb))
+* **job:** validate PID before process.kill to prevent process group kill ([67c540f](https://github.com/blueraai/bluera-knowledge/commit/67c540fef6f2c55c5dca2c824104a91fe19aeff1))
+* **services:** fail fast on corrupted config/registry files ([030f63c](https://github.com/blueraai/bluera-knowledge/commit/030f63c10b0a30bddcd8e9b27b291ab0f53263f1))
+* **watch:** clear pending timeouts on unwatch to prevent timer leak ([4dcafc1](https://github.com/blueraai/bluera-knowledge/commit/4dcafc14417442f6eeed0257cf185e04ae9de12b))
+* **worker:** prevent division by zero and improve cancellation handling ([b7b40ab](https://github.com/blueraai/bluera-knowledge/commit/b7b40ab950b7ad0fbbe84af243be3138b1072a72))
+
+## [0.9.32](https://github.com/blueraai/bluera-knowledge/compare/v0.9.31...v0.9.32) (2026-01-06)
+
 ## [0.9.31](https://github.com/blueraai/bluera-knowledge/compare/v0.9.30...v0.9.31) (2026-01-06)
 
 

package/CLAUDE.md

@@ -22,6 +22,12 @@ This file is YOUR (Claude's) project memory. It is NOT user documentation. It is
 
 ---
 
+## Package Manager
+
+**Use `bun`** - not npm or yarn. All scripts should be run with `bun run <script>`.
+
+---
+
 ## Scripts
 
 **Development:**

package/README.md

@@ -1365,24 +1365,39 @@ The validation is intelligent - it only runs checks for TypeScript/JavaScript fi
 
 > **Note:** The `.claude/settings.local.json` file is gitignored (local to your machine). The example file is checked in for reference.
 
-### 🔌 MCP Server
+### 🐕 Dogfooding
 
-**`mcp.plugin.json`** (Plugin distribution)
-- Located at plugin root, referenced from `plugin.json`
-- Uses `${CLAUDE_PLUGIN_ROOT}` and points to compiled `dist/mcp/server.js`
-- Only loaded when directory is loaded as a plugin (no project/plugin conflict)
-- Committed to git and distributed with the plugin
+Develop this plugin while using it with Claude Code:
 
-**For local development/dogfooding:**
+```bash
+claude --plugin-dir /path/to/bluera-knowledge
+```
+
+This loads the plugin directly from source. Changes take effect on Claude Code restart (no reinstall needed).
+
+| What to test | Approach |
+|--------------|----------|
+| **Commands** (`/search`, `/add-repo`) | `--plugin-dir` (changes need restart) |
+| **Hooks** (job status, dependencies) | `--plugin-dir` (changes need restart) |
+| **MCP tools** (compiled) | `--plugin-dir` (run `bun run build` first) |
+| **MCP tools** (live TypeScript) | `~/.claude.json` dev server (see below) |
+
+### 🔌 MCP Server Development
+
+**Production mode** (`mcp.plugin.json`):
+- Uses `${CLAUDE_PLUGIN_ROOT}/dist/mcp/server.js` (compiled)
+- Distributed with plugin, no extra setup needed
+
+**Development mode** (live TypeScript):
 
-To enable live development without rebuilding, add a user-level MCP server config to `~/.claude.json`:
+For instant feedback when editing MCP server code, add a dev server to `~/.claude.json`:
 
 ```json
 {
   "mcpServers": {
     "bluera-knowledge-dev": {
       "command": "npx",
-      "args": ["tsx", "/Users/yourname/repos/bluera-knowledge/src/mcp/server.ts"],
+      "args": ["tsx", "/path/to/bluera-knowledge/src/mcp/server.ts"],
       "env": {
         "PWD": "${PWD}",
         "DATA_DIR": "${PWD}/.bluera/bluera-knowledge/data",
@@ -1393,10 +1408,7 @@ To enable live development without rebuilding, add a user-level MCP server confi
 }
 ```
 
-Replace the path with your actual repo location. This creates a separate `bluera-knowledge-dev` MCP server that:
-- Runs the source TypeScript directly via `tsx`
-- Updates immediately when you modify MCP server code
-- Doesn't interfere with the production plugin version
+This creates a separate `bluera-knowledge-dev` MCP server that runs source TypeScript directly via `tsx` - no rebuild needed for MCP changes
 
 ### 📜 Commands