feat(plugin): project filtering + native deps refactor + command syntax

[onlycastle]

Summary

• Project filtering: scan_sessions and extract_data tools now accept includeProjects parameter, letting users analyze specific projects instead of everything. Setup wizard adds a project selection step (Step 3).
• Native deps refactor: ensureNativeDeps() installs to pluginRoot/node_modules/ using standard Node module resolution, removing the NODE_PATH env var workaround from .mcp.json.
• Command syntax migration: All command references updated from /slash format to space-separated syntax (/bp-analyze → bp analyze) across docs, skills, hooks, and README.

Changes

1. refactor(plugin): use pluginRoot for native dependency resolution — native-deps.ts, server-entry.ts, session-start-handler.ts, .mcp.json
2. feat(plugin): add project filtering to scan and extract tools — scan-sessions.ts, extract-data.ts, server.ts, prefs.ts
3. docs: update skills and docs for command syntax + project selection — SKILL.md files, README, docs/
4. test: update and add tests for plugin refactoring — 3 updated + 1 new test suite

Test Plan

• All 452 tests pass (npm test)
• Manual: fresh plugin install → bp setup → project selection persists to prefs.json
• Manual: bp analyze with selectedProjects set filters correctly
• Manual: MCP server starts without NODE_PATH env var

---

Generated with Claude Code using /ship-it

[onlycastle]

Code Review

Found 1 issue:

1. JSDoc/commit message inconsistency with CLAUDE_PLUGIN_DATA fallback — The module-level JSDoc in native-deps.ts documents two strategies: primary (pluginRoot) and fallback (~/.betterprompt). The actual code has three: pluginRoot → CLAUDE_PLUGIN_DATA → ~/.betterprompt. The env var middle tier is undocumented in the JSDoc, and the commit message (e6f7a19) states it "removes CLAUDE_PLUGIN_DATA dependency" when the code still reads process.env.CLAUDE_PLUGIN_DATA as a fallback.
   

   BetterPrompt/packages/plugin/lib/native-deps.ts

   Lines 9 to 22 in 7f56dc2

   	* directory walking. Fallback: `~/.betterprompt/node_modules/` for
   	* callers that don't know the plugin root.
   	*
   	* Safe to call from multiple entry points (SessionStart hook, MCP
   	* server startup) — a marker file prevents redundant installs.
   	*/
   	import { existsSync } from 'node:fs';
   	import { execFileSync } from 'node:child_process';
   	import { join } from 'node:path';
   	import { homedir } from 'node:os';
   	export function ensureNativeDeps(opts?: { pluginRoot?: string; fatal?: boolean }): void {
   	const installDir = opts?.pluginRoot ?? process.env.CLAUDE_PLUGIN_DATA ?? join(homedir(), '.betterprompt');

Generated with Claude Code

_{If useful, react with a thumbs-up. Otherwise, thumbs-down.}