@thebushidocollective/han 1.2.0 → 1.3.1

package/README.md

@@ -32,9 +32,15 @@ npx -y @thebushidocollective/han validate <command>
 Intelligently analyze your codebase and configure Claude Code with appropriate Han plugins using the Claude Agent SDK.
 
 ```bash
-npx @thebushidocollective/han install
+npx @thebushidocollective/han install [--scope <project|local>]
 ```
 
+**Options:**
+
+- `--scope <project|local>` - Installation scope (default: `project`)
+  - `project`: Install to `.claude/settings.json` (shared via git)
+  - `local`: Install to `.claude/settings.local.json` (git-ignored, machine-specific)
+
 **How it works:**
 
 - Spawns a Claude agent to analyze your codebase
@@ -42,7 +48,7 @@ npx @thebushidocollective/han install
 - Detects languages, frameworks, and testing tools
 - Recommends appropriate Han plugins based on actual code, not just file patterns
 - Displays real-time progress with a beautiful Ink-powered terminal UI
-- Configures `.claude/settings.json` automatically
+- Configures Claude Code settings automatically
 
 **What it detects:**
 
@@ -56,6 +62,59 @@ npx @thebushidocollective/han install
 **After installation:**
 Restart Claude Code to load the new plugins.
 
+**Examples:**
+
+```bash
+# Install to project settings (default, shared via git)
+npx @thebushidocollective/han install
+
+# Install to local settings (machine-specific, not shared)
+npx @thebushidocollective/han install --scope local
+```
+
+### align
+
+Continuously align your Han plugins with your evolving codebase. Automatically adds plugins for new technologies and removes plugins for technologies no longer in use.
+
+```bash
+npx @thebushidocollective/han align [--scope <project|local>]
+```
+
+**Options:**
+
+- `--scope <project|local>` - Alignment scope (default: `project`)
+  - `project`: Align plugins in `.claude/settings.json` (shared via git)
+  - `local`: Align plugins in `.claude/settings.local.json` (git-ignored, machine-specific)
+
+**How it works:**
+
+- Re-analyzes your codebase to detect current technologies
+- Compares detected plugins with currently installed plugins
+- **Adds** plugins for newly detected technologies
+- **Removes** plugins for technologies no longer found
+- Reports all changes clearly
+
+**When to use:**
+
+- After adding new dependencies or frameworks
+- After removing technologies from your project
+- Periodically to keep plugins in sync with your codebase
+- Automatically via a Stop hook (see below)
+
+**Automatic Alignment:**
+
+The bushido plugin includes a Stop hook that automatically runs `han align` at the end of each Claude Code session, ensuring your plugins stay synchronized with your codebase as it evolves.
+
+**Examples:**
+
+```bash
+# Align project settings (default)
+npx @thebushidocollective/han align
+
+# Align local settings
+npx @thebushidocollective/han align --scope local
+```
+
 ### uninstall
 
 Remove all Han plugins and marketplace configuration from Claude Code.

package/dist/lib/align-progress.d.ts

@@ -0,0 +1,9 @@
+import type { DetectPluginsCallbacks } from './align.js';
+interface AlignProgressProps {
+    detectPlugins: (callbacks: DetectPluginsCallbacks) => Promise<void>;
+    onAlignComplete: (plugins: string[]) => void;
+    onAlignError: (error: Error) => void;
+}
+export declare const AlignProgress: React.FC<AlignProgressProps>;
+export {};
+//# sourceMappingURL=align-progress.d.ts.map

package/dist/lib/align-progress.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"align-progress.d.ts","sourceRoot":"","sources":["../../lib/align-progress.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAe,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAGtE,UAAU,kBAAkB;IAC1B,aAAa,EAAE,CAAC,SAAS,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,eAAe,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC7C,YAAY,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACtC;AAED,eAAO,MAAM,aAAa,EAAE,KAAK,CAAC,EAAE,CAAC,kBAAkB,CA+MtD,CAAC"}

package/dist/lib/align-progress.js

@@ -0,0 +1,58 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Box, Text } from 'ink';
+import Spinner from 'ink-spinner';
+import { useEffect, useState } from 'react';
+import { MarkdownWrapper } from './markdown-wrapper.js';
+export const AlignProgress = ({ detectPlugins, onAlignComplete, onAlignError, }) => {
+    const [phase, setPhase] = useState('analyzing');
+    const [plugins, setPlugins] = useState([]);
+    const [fullText, setFullText] = useState('');
+    const [currentTool, setCurrentTool] = useState(null);
+    const [error, setError] = useState(null);
+    const [toolsUsed, setToolsUsed] = useState(new Set());
+    useEffect(() => {
+        const callbacks = {
+            onUpdate: (update) => {
+                if (update.type === 'text') {
+                    setFullText((prev) => prev + update.content);
+                }
+                else if (update.type === 'tool' && update.toolName) {
+                    setCurrentTool(update.toolName);
+                    setToolsUsed((prev) => new Set([...prev, update.toolName]));
+                }
+            },
+            onComplete: (detectedPlugins, analysisText) => {
+                setPlugins(detectedPlugins);
+                setFullText(analysisText);
+                setCurrentTool(null);
+                setPhase('analyzed');
+                setTimeout(() => {
+                    setPhase('aligning');
+                    setTimeout(() => {
+                        setPhase('complete');
+                        onAlignComplete(detectedPlugins);
+                    }, 500);
+                }, 1000);
+            },
+            onError: (err) => {
+                setError(err.message);
+                setPhase('error');
+                onAlignError(err);
+            },
+        };
+        detectPlugins(callbacks);
+    }, [detectPlugins, onAlignComplete, onAlignError]);
+    const getToolEmoji = (toolName) => {
+        const emojiMap = {
+            web_fetch: '🌐',
+            read_file: '📄',
+            glob: '🔍',
+            grep: '🔎',
+        };
+        return emojiMap[toolName] || '🔧';
+    };
+    return (_jsxs(Box, { flexDirection: "column", paddingY: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\uD83E\uDD16 Han Plugin Alignment" }) }), phase === 'analyzing' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "yellow", children: [_jsx(Spinner, { type: "dots" }), " Analyzing codebase..."] }) }), currentTool && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "blue", children: [getToolEmoji(currentTool), " ", currentTool] }) })), toolsUsed.size > 0 && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { dimColor: true, children: ["Tools used: ", Array.from(toolsUsed).join(', ')] }) })), fullText && (_jsxs(Box, { marginTop: 1, paddingX: 1, borderStyle: "round", borderColor: "gray", flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { dimColor: true, bold: true, children: [_jsx(Spinner, { type: "star" }), " Agent thinking:"] }) }), _jsx(MarkdownWrapper, { children: fullText })] }))] })), (phase === 'analyzed' ||
+                phase === 'aligning' ||
+                phase === 'complete') && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "green", children: "\u2705 Analysis complete" }) }), fullText && (_jsxs(Box, { marginBottom: 1, paddingX: 1, borderStyle: "round", borderColor: "cyan", flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\uD83D\uDCCB Agent Analysis:" }) }), _jsx(MarkdownWrapper, { children: fullText })] })), plugins.length > 0 && (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { bold: true, color: "green", children: "\u2728 Recommended plugins:" }), plugins.sort().map((plugin) => (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { children: ["\u2022 ", plugin] }) }, plugin)))] })), phase === 'aligning' && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "yellow", children: [_jsx(Spinner, { type: "dots" }), " Aligning plugins in Claude Code settings..."] }) })), phase === 'complete' && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "green", children: "\u2705 Updated Claude Code settings" }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "green", bold: true, children: "\u2705 Alignment complete!" }) }), _jsx(Box, { children: _jsx(Text, { color: "blue", children: "\uD83D\uDCA1 Restart Claude Code to load plugin changes." }) })] }))] })), phase === 'error' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "red", bold: true, children: "\u274C Error" }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "red", children: error }) }), fullText && (_jsxs(Box, { marginBottom: 1, paddingX: 1, borderStyle: "round", borderColor: "red", flexDirection: "column", children: [_jsx(Text, { bold: true, color: "red", children: "Partial Analysis:" }), _jsx(Box, { children: _jsx(MarkdownWrapper, { children: fullText }) })] })), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "yellow", children: "\u26A0\uFE0F Could not complete alignment, leaving plugins unchanged" }) })] }))] }));
+};
+//# sourceMappingURL=align-progress.js.map

package/dist/lib/align-progress.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"align-progress.js","sourceRoot":"","sources":["../../lib/align-progress.tsx"],"names":[],"mappings":"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"}

package/dist/lib/align.d.ts

@@ -0,0 +1,20 @@
+export interface AgentUpdate {
+    type: 'text' | 'tool';
+    content: string;
+    toolName?: string;
+}
+export interface AlignResult {
+    added: string[];
+    removed: string[];
+    unchanged: string[];
+}
+export interface DetectPluginsCallbacks {
+    onUpdate: (update: AgentUpdate) => void;
+    onComplete: (plugins: string[], fullText: string) => void;
+    onError: (error: Error) => void;
+}
+/**
+ * SDK-based align command with Ink UI
+ */
+export declare function align(scope?: 'project' | 'local'): Promise<void>;
+//# sourceMappingURL=align.d.ts.map

package/dist/lib/align.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"align.d.ts","sourceRoot":"","sources":["../../lib/align.ts"],"names":[],"mappings":"AAuBA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,EAAE,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;IACxC,UAAU,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1D,OAAO,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC;AAiLD;;GAEG;AACH,wBAAsB,KAAK,CAAC,KAAK,GAAE,SAAS,GAAG,OAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAqDjF"}

package/dist/lib/align.js

@@ -0,0 +1,208 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from 'node:fs';
+import { join } from 'node:path';
+import { query } from '@anthropic-ai/claude-agent-sdk';
+import { render } from 'ink';
+import React from 'react';
+import { detectPluginsPrompt } from './detect-plugins-prompt.js';
+const HAN_MARKETPLACE_REPO = 'thebushidocollective/han';
+function getClaudeSettingsPath(scope = 'project') {
+    const filename = scope === 'local' ? 'settings.local.json' : 'settings.json';
+    return join(process.cwd(), '.claude', filename);
+}
+function ensureClaudeDirectory() {
+    const settingsPath = getClaudeSettingsPath();
+    const claudeDir = join(settingsPath, '..');
+    if (!existsSync(claudeDir)) {
+        mkdirSync(claudeDir, { recursive: true });
+    }
+}
+function readOrCreateSettings(scope = 'project') {
+    const settingsPath = getClaudeSettingsPath(scope);
+    if (existsSync(settingsPath)) {
+        try {
+            return JSON.parse(readFileSync(settingsPath, 'utf8'));
+        }
+        catch (_error) {
+            console.error(`Error reading ${scope === 'local' ? 'settings.local.json' : 'settings.json'}, creating new one`);
+            return {};
+        }
+    }
+    return {};
+}
+function writeSettings(settings, scope = 'project') {
+    const settingsPath = getClaudeSettingsPath(scope);
+    writeFileSync(settingsPath, `${JSON.stringify(settings, null, 2)}\n`);
+}
+/**
+ * Get currently installed Han plugins
+ */
+function getInstalledPlugins(scope = 'project') {
+    const settings = readOrCreateSettings(scope);
+    const enabledPlugins = settings.enabledPlugins || {};
+    return Object.keys(enabledPlugins)
+        .filter((key) => key.endsWith('@han') && enabledPlugins[key])
+        .map((key) => key.replace('@han', ''));
+}
+/**
+ * Use Claude Agent SDK to intelligently analyze codebase and recommend plugins
+ */
+async function detectPluginsWithAgent(callbacks) {
+    // Define allowed tools - only read-only operations
+    const allowedTools = ['web_fetch', 'read_file', 'glob', 'grep'];
+    const agent = query({
+        prompt: detectPluginsPrompt,
+        options: {
+            model: 'claude-sonnet-4-5-20250929',
+            includePartialMessages: true,
+            allowedTools,
+            permissionMode: 'bypassPermissions',
+        },
+    });
+    let responseContent = '';
+    try {
+        // Collect all messages from the agent with live updates
+        for await (const sdkMessage of agent) {
+            if (sdkMessage.type === 'assistant' && sdkMessage.message.content) {
+                for (const block of sdkMessage.message.content) {
+                    if (block.type === 'text') {
+                        // Send text updates
+                        callbacks.onUpdate({ type: 'text', content: block.text });
+                        responseContent += block.text;
+                    }
+                    else if (block.type === 'tool_use') {
+                        // Send tool usage updates
+                        callbacks.onUpdate({
+                            type: 'tool',
+                            content: `Using ${block.name}`,
+                            toolName: block.name,
+                        });
+                    }
+                }
+            }
+        }
+        // Extract plugin recommendations from agent response
+        const plugins = parsePluginRecommendations(responseContent);
+        const finalPlugins = plugins.length > 0 ? plugins : ['bushido'];
+        callbacks.onComplete(finalPlugins, responseContent);
+    }
+    catch (error) {
+        callbacks.onError(error);
+    }
+}
+/**
+ * Parse plugin recommendations from agent response
+ */
+function parsePluginRecommendations(content) {
+    try {
+        // Try to find JSON array in the response
+        const jsonMatch = content.match(/\[[\s\S]*?\]/);
+        if (jsonMatch) {
+            const plugins = JSON.parse(jsonMatch[0]);
+            if (Array.isArray(plugins)) {
+                plugins.push('bushido');
+                return plugins.filter((p) => typeof p === 'string');
+            }
+        }
+        // Fallback: look for plugin names mentioned
+        const pluginPattern = /(buki-[\w-]+|do-[\w-]+|sensei-[\w-]+|bushido)/g;
+        const matches = content.match(pluginPattern);
+        if (matches) {
+            return [...new Set(matches)];
+        }
+        return [];
+    }
+    catch (_error) {
+        return [];
+    }
+}
+/**
+ * Compare current plugins with recommended plugins and update settings
+ */
+function alignPluginsInSettings(recommendedPlugins, scope = 'project') {
+    ensureClaudeDirectory();
+    const settings = readOrCreateSettings(scope);
+    const currentPlugins = getInstalledPlugins(scope);
+    // Calculate differences
+    const added = [];
+    const removed = [];
+    const unchanged = [];
+    // Add Han marketplace if not present
+    if (!settings?.extraKnownMarketplaces?.han) {
+        settings.extraKnownMarketplaces = {
+            ...settings.extraKnownMarketplaces,
+            han: { source: { source: 'github', repo: HAN_MARKETPLACE_REPO } },
+        };
+    }
+    // Initialize enabledPlugins if needed
+    if (!settings.enabledPlugins) {
+        settings.enabledPlugins = {};
+    }
+    // Find plugins to add (in recommended but not in current)
+    for (const plugin of recommendedPlugins) {
+        if (!currentPlugins.includes(plugin)) {
+            added.push(plugin);
+            settings.enabledPlugins[`${plugin}@han`] = true;
+        }
+        else {
+            unchanged.push(plugin);
+        }
+    }
+    // Find plugins to remove (in current but not in recommended)
+    for (const plugin of currentPlugins) {
+        if (!recommendedPlugins.includes(plugin)) {
+            removed.push(plugin);
+            delete settings.enabledPlugins[`${plugin}@han`];
+        }
+    }
+    writeSettings(settings, scope);
+    return { added, removed, unchanged };
+}
+/**
+ * SDK-based align command with Ink UI
+ */
+export async function align(scope = 'project') {
+    // Import Ink UI component dynamically
+    const { AlignProgress } = await import('./align-progress.js');
+    let resolveCompletion;
+    let rejectCompletion;
+    const completionPromise = new Promise((resolve, reject) => {
+        resolveCompletion = resolve;
+        rejectCompletion = reject;
+    });
+    const filename = scope === 'local' ? 'settings.local.json' : 'settings.json';
+    console.log(`Aligning plugins in ./.claude/${filename}...\n`);
+    const { unmount } = render(React.createElement(AlignProgress, {
+        detectPlugins: detectPluginsWithAgent,
+        onAlignComplete: (plugins) => {
+            const result = alignPluginsInSettings(plugins, scope);
+            // Report changes
+            if (result.added.length > 0) {
+                console.log(`\n✓ Added ${result.added.length} plugin(s): ${result.added.join(', ')}`);
+            }
+            if (result.removed.length > 0) {
+                console.log(`\n✓ Removed ${result.removed.length} plugin(s): ${result.removed.join(', ')}`);
+            }
+            if (result.added.length === 0 && result.removed.length === 0) {
+                console.log('\n✓ No changes needed - plugins are already aligned');
+            }
+            else {
+                console.log('\n⚠️  Please restart Claude Code to load the plugin changes');
+            }
+            if (resolveCompletion)
+                resolveCompletion();
+        },
+        onAlignError: (error) => {
+            if (rejectCompletion)
+                rejectCompletion(error);
+        },
+    }));
+    try {
+        await completionPromise;
+        // Wait a moment for the UI to show completion message
+        await new Promise((resolve) => setTimeout(resolve, 1500));
+    }
+    finally {
+        unmount();
+    }
+}
+//# sourceMappingURL=align.js.map

package/dist/lib/align.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"align.js","sourceRoot":"","sources":["../../lib/align.ts"],"names":[],"mappings":"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"}

package/dist/lib/detect-plugins-prompt.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Shared agent prompt for detecting and recommending Han plugins
+ */
+export declare const detectPluginsPrompt = "You are a Han plugin installer assistant. Your goal is to analyze the current codebase and recommend appropriate Claude Code plugins from the Han marketplace.\n\nCRITICAL FIRST STEP:\n1. Fetch the Han marketplace to see ALL available plugins:\n   https://raw.githubusercontent.com/TheBushidoCollective/han/refs/heads/main/.claude-plugin/marketplace.json\n2. Study the marketplace.json to understand:\n   - What plugins are available in each category\n   - What technologies and practices each plugin supports\n   - The keywords and descriptions for each plugin\n\nPlugin Categories:\n- buki-* (\u6B66\u5668 weapons): Skills for specific technologies and frameworks\n- do-* (\u9053 disciplines): Specialized agents for development practices and workflows\n- sensei-* (\u5148\u751F teachers): MCP servers for external integrations\n- bushido: Core quality principles (ALWAYS recommend this)\n\nYour Analysis Process:\n1. **Analyze the codebase structure**:\n   - Use Glob to discover directory structure and file types\n     * Example: glob(\"**/*.md\") to find markdown files\n     * Example: glob(\"**/blog/**\") to check for blog directories\n   - Use Grep to search for import statements and framework usage\n     * Example: grep(\"import.*react\") to find React usage\n     * Example: grep(\"^---\") to find frontmatter in markdown files\n   - Read configuration files (package.json, Cargo.toml, go.mod, requirements.txt, etc.)\n   - Use Read tool to examine specific files when patterns are found\n\n2. **Identify technologies used** (for buki-* recommendations):\n   - What programming languages are in use?\n   - What frameworks and libraries are imported?\n   - What testing frameworks are configured?\n   - What build tools and infrastructure are present?\n\n3. **Identify development practices** (for do-* recommendations):\n   Analyze the codebase for these specific patterns:\n\n   - **Content & Writing**: Look for blog posts, articles, or documentation:\n     * Directories: blog/, posts/, content/, articles/, docs/, _posts/\n     * Files: .md, .mdx with frontmatter (title, date, author, tags)\n     * CMS: contentlayer.config.js, sanity.config.ts, contentful\n     * If found \u2192 recommend do-content-creator\n\n   - **API Development**: Look for API/backend patterns:\n     * Directories: api/, routes/, controllers/, endpoints/\n     * Files: OpenAPI/Swagger specs, GraphQL schemas\n     * Frameworks: Express routes, tRPC, FastAPI, Rails controllers\n     * If found \u2192 recommend do-api-development\n\n   - **Testing Practices**: Look for test infrastructure:\n     * Directories: __tests__/, tests/, test/, spec/\n     * Files: *.test.*, *.spec.*, test configuration files\n     * If found \u2192 consider relevant testing do-* plugins\n\n   - **DevOps/Infrastructure**: Look for deployment configs:\n     * Files: Dockerfile, docker-compose.yml, kubernetes/, terraform/\n     * CI/CD: .github/workflows/, .gitlab-ci.yml, .circleci/\n     * If found \u2192 recommend do-devops or do-infrastructure\n\n   - **Accessibility**: Look for a11y patterns:\n     * Dependencies: @axe-core, pa11y, jest-axe\n     * Config files: .pa11yci, accessibility test files\n     * If found \u2192 recommend do-accessibility-engineering\n\n   - **Type of application**:\n     * Frontend-heavy (components/, pages/, views/) \u2192 do-frontend-development\n     * Mobile (android/, ios/, mobile/) \u2192 do-mobile-development\n     * Full-stack (both frontend & backend) \u2192 both frontend and backend do-*\n\n4. **Match findings to available plugins**:\n   - Cross-reference detected technologies with buki-* plugins in marketplace\n   - Cross-reference development practices with do-* plugins in marketplace\n   - Recommend 3-8 total plugins (both buki-* AND do-* types)\n\nReturn ONLY a JSON array of recommended plugin names, like:\n[\"bushido\", \"buki-typescript\", \"buki-react\", \"do-frontend-development\"]\n\nULTRATHINK and perform a thorough analysis. Fetch the marketplace first to know what's available, then analyze the codebase to recommend the most relevant plugins.";
+//# sourceMappingURL=detect-plugins-prompt.d.ts.map

package/dist/lib/detect-plugins-prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-plugins-prompt.d.ts","sourceRoot":"","sources":["../../lib/detect-plugins-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,eAAO,MAAM,mBAAmB,ggIA4EoI,CAAC"}

package/dist/lib/detect-plugins-prompt.js

@@ -0,0 +1,81 @@
+/**
+ * Shared agent prompt for detecting and recommending Han plugins
+ */
+export const detectPluginsPrompt = `You are a Han plugin installer assistant. Your goal is to analyze the current codebase and recommend appropriate Claude Code plugins from the Han marketplace.
+
+CRITICAL FIRST STEP:
+1. Fetch the Han marketplace to see ALL available plugins:
+   https://raw.githubusercontent.com/TheBushidoCollective/han/refs/heads/main/.claude-plugin/marketplace.json
+2. Study the marketplace.json to understand:
+   - What plugins are available in each category
+   - What technologies and practices each plugin supports
+   - The keywords and descriptions for each plugin
+
+Plugin Categories:
+- buki-* (武器 weapons): Skills for specific technologies and frameworks
+- do-* (道 disciplines): Specialized agents for development practices and workflows
+- sensei-* (先生 teachers): MCP servers for external integrations
+- bushido: Core quality principles (ALWAYS recommend this)
+
+Your Analysis Process:
+1. **Analyze the codebase structure**:
+   - Use Glob to discover directory structure and file types
+     * Example: glob("**/*.md") to find markdown files
+     * Example: glob("**/blog/**") to check for blog directories
+   - Use Grep to search for import statements and framework usage
+     * Example: grep("import.*react") to find React usage
+     * Example: grep("^---") to find frontmatter in markdown files
+   - Read configuration files (package.json, Cargo.toml, go.mod, requirements.txt, etc.)
+   - Use Read tool to examine specific files when patterns are found
+
+2. **Identify technologies used** (for buki-* recommendations):
+   - What programming languages are in use?
+   - What frameworks and libraries are imported?
+   - What testing frameworks are configured?
+   - What build tools and infrastructure are present?
+
+3. **Identify development practices** (for do-* recommendations):
+   Analyze the codebase for these specific patterns:
+
+   - **Content & Writing**: Look for blog posts, articles, or documentation:
+     * Directories: blog/, posts/, content/, articles/, docs/, _posts/
+     * Files: .md, .mdx with frontmatter (title, date, author, tags)
+     * CMS: contentlayer.config.js, sanity.config.ts, contentful
+     * If found → recommend do-content-creator
+
+   - **API Development**: Look for API/backend patterns:
+     * Directories: api/, routes/, controllers/, endpoints/
+     * Files: OpenAPI/Swagger specs, GraphQL schemas
+     * Frameworks: Express routes, tRPC, FastAPI, Rails controllers
+     * If found → recommend do-api-development
+
+   - **Testing Practices**: Look for test infrastructure:
+     * Directories: __tests__/, tests/, test/, spec/
+     * Files: *.test.*, *.spec.*, test configuration files
+     * If found → consider relevant testing do-* plugins
+
+   - **DevOps/Infrastructure**: Look for deployment configs:
+     * Files: Dockerfile, docker-compose.yml, kubernetes/, terraform/
+     * CI/CD: .github/workflows/, .gitlab-ci.yml, .circleci/
+     * If found → recommend do-devops or do-infrastructure
+
+   - **Accessibility**: Look for a11y patterns:
+     * Dependencies: @axe-core, pa11y, jest-axe
+     * Config files: .pa11yci, accessibility test files
+     * If found → recommend do-accessibility-engineering
+
+   - **Type of application**:
+     * Frontend-heavy (components/, pages/, views/) → do-frontend-development
+     * Mobile (android/, ios/, mobile/) → do-mobile-development
+     * Full-stack (both frontend & backend) → both frontend and backend do-*
+
+4. **Match findings to available plugins**:
+   - Cross-reference detected technologies with buki-* plugins in marketplace
+   - Cross-reference development practices with do-* plugins in marketplace
+   - Recommend 3-8 total plugins (both buki-* AND do-* types)
+
+Return ONLY a JSON array of recommended plugin names, like:
+["bushido", "buki-typescript", "buki-react", "do-frontend-development"]
+
+ULTRATHINK and perform a thorough analysis. Fetch the marketplace first to know what's available, then analyze the codebase to recommend the most relevant plugins.`;
+//# sourceMappingURL=detect-plugins-prompt.js.map

package/dist/lib/detect-plugins-prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-plugins-prompt.js","sourceRoot":"","sources":["../../lib/detect-plugins-prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;oKA4EiI,CAAC"}

package/dist/lib/install-progress.d.ts

@@ -1,4 +1,4 @@
-import type { DetectPluginsCallbacks } from "./install.js";
+import type { DetectPluginsCallbacks } from './install.js';
 interface InstallProgressProps {
     detectPlugins: (callbacks: DetectPluginsCallbacks) => Promise<void>;
     onInstallComplete: (plugins: string[]) => void;

package/dist/lib/install-progress.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"install-progress.d.ts","sourceRoot":"","sources":["../../lib/install-progress.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAe,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGxE,UAAU,oBAAoB;IAC7B,aAAa,EAAE,CAAC,SAAS,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/C,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACvC;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA8M1D,CAAC"}
+{"version":3,"file":"install-progress.d.ts","sourceRoot":"","sources":["../../lib/install-progress.tsx"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAe,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAGxE,UAAU,oBAAoB;IAC5B,aAAa,EAAE,CAAC,SAAS,EAAE,sBAAsB,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACpE,iBAAiB,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,IAAI,CAAC;IAC/C,cAAc,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACxC;AAED,eAAO,MAAM,eAAe,EAAE,KAAK,CAAC,EAAE,CAAC,oBAAoB,CA8M1D,CAAC"}

package/dist/lib/install-progress.js

@@ -1,22 +1,22 @@
 import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
-import { Box, Text } from "ink";
-import Spinner from "ink-spinner";
-import { useEffect, useState } from "react";
-import { MarkdownWrapper } from "./markdown-wrapper.js";
+import { Box, Text } from 'ink';
+import Spinner from 'ink-spinner';
+import { useEffect, useState } from 'react';
+import { MarkdownWrapper } from './markdown-wrapper.js';
 export const InstallProgress = ({ detectPlugins, onInstallComplete, onInstallError, }) => {
-    const [phase, setPhase] = useState("analyzing");
+    const [phase, setPhase] = useState('analyzing');
     const [plugins, setPlugins] = useState([]);
-    const [fullText, setFullText] = useState("");
+    const [fullText, setFullText] = useState('');
     const [currentTool, setCurrentTool] = useState(null);
     const [error, setError] = useState(null);
     const [toolsUsed, setToolsUsed] = useState(new Set());
     useEffect(() => {
         const callbacks = {
             onUpdate: (update) => {
-                if (update.type === "text") {
+                if (update.type === 'text') {
                     setFullText((prev) => prev + update.content);
                 }
-                else if (update.type === "tool" && update.toolName) {
+                else if (update.type === 'tool' && update.toolName) {
                     setCurrentTool(update.toolName);
                     setToolsUsed((prev) => new Set([...prev, update.toolName]));
                 }
@@ -25,18 +25,18 @@ export const InstallProgress = ({ detectPlugins, onInstallComplete, onInstallErr
                 setPlugins(detectedPlugins);
                 setFullText(analysisText);
                 setCurrentTool(null);
-                setPhase("analyzed");
+                setPhase('analyzed');
                 setTimeout(() => {
-                    setPhase("installing");
+                    setPhase('installing');
                     setTimeout(() => {
-                        setPhase("complete");
+                        setPhase('complete');
                         onInstallComplete(detectedPlugins);
                     }, 500);
                 }, 1000);
             },
             onError: (err) => {
                 setError(err.message);
-                setPhase("error");
+                setPhase('error');
                 onInstallError(err);
             },
         };
@@ -44,15 +44,15 @@ export const InstallProgress = ({ detectPlugins, onInstallComplete, onInstallErr
     }, [detectPlugins, onInstallComplete, onInstallError]);
     const getToolEmoji = (toolName) => {
         const emojiMap = {
-            web_fetch: "🌐",
-            read_file: "📄",
-            glob: "🔍",
-            grep: "🔎",
+            web_fetch: '🌐',
+            read_file: '📄',
+            glob: '🔍',
+            grep: '🔎',
         };
-        return emojiMap[toolName] || "🔧";
+        return emojiMap[toolName] || '🔧';
     };
-    return (_jsxs(Box, { flexDirection: "column", paddingY: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\uD83E\uDD16 Han Plugin Installer" }) }), phase === "analyzing" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "yellow", children: [_jsx(Spinner, { type: "dots" }), " Analyzing codebase..."] }) }), currentTool && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "blue", children: [getToolEmoji(currentTool), " ", currentTool] }) })), toolsUsed.size > 0 && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { dimColor: true, children: ["Tools used: ", Array.from(toolsUsed).join(", ")] }) })), fullText && (_jsxs(Box, { marginTop: 1, paddingX: 1, borderStyle: "round", borderColor: "gray", flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { dimColor: true, bold: true, children: [_jsx(Spinner, { type: "star" }), " Agent thinking:"] }) }), _jsx(MarkdownWrapper, { children: fullText })] }))] })), (phase === "analyzed" ||
-                phase === "installing" ||
-                phase === "complete") && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "green", children: "\u2705 Analysis complete" }) }), fullText && (_jsxs(Box, { marginBottom: 1, paddingX: 1, borderStyle: "round", borderColor: "cyan", flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\uD83D\uDCCB Agent Analysis:" }) }), _jsx(MarkdownWrapper, { children: fullText })] })), plugins.length > 0 && (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { bold: true, color: "green", children: "\u2728 Adding recommended plugins:" }), plugins.sort().map((plugin) => (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { children: ["\u2022 ", plugin] }) }, plugin)))] })), phase === "installing" && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "yellow", children: [_jsx(Spinner, { type: "dots" }), " Updating Claude Code settings..."] }) })), phase === "complete" && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "green", children: "\u2705 Updated Claude Code settings" }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "green", bold: true, children: "\u2705 Installation complete!" }) }), _jsx(Box, { children: _jsx(Text, { color: "blue", children: "\uD83D\uDCA1 Restart Claude Code to load the new plugins." }) })] }))] })), phase === "error" && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "red", bold: true, children: "\u274C Error" }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "red", children: error }) }), fullText && (_jsxs(Box, { marginBottom: 1, paddingX: 1, borderStyle: "round", borderColor: "red", flexDirection: "column", children: [_jsx(Text, { bold: true, color: "red", children: "Partial Analysis:" }), _jsx(Box, { children: _jsx(MarkdownWrapper, { children: fullText }) })] })), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "yellow", children: "\u26A0\uFE0F Falling back to installing core bushido plugin..." }) })] }))] }));
+    return (_jsxs(Box, { flexDirection: "column", paddingY: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\uD83E\uDD16 Han Plugin Installer" }) }), phase === 'analyzing' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "yellow", children: [_jsx(Spinner, { type: "dots" }), " Analyzing codebase..."] }) }), currentTool && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { color: "blue", children: [getToolEmoji(currentTool), " ", currentTool] }) })), toolsUsed.size > 0 && (_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { dimColor: true, children: ["Tools used: ", Array.from(toolsUsed).join(', ')] }) })), fullText && (_jsxs(Box, { marginTop: 1, paddingX: 1, borderStyle: "round", borderColor: "gray", flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsxs(Text, { dimColor: true, bold: true, children: [_jsx(Spinner, { type: "star" }), " Agent thinking:"] }) }), _jsx(MarkdownWrapper, { children: fullText })] }))] })), (phase === 'analyzed' ||
+                phase === 'installing' ||
+                phase === 'complete') && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "green", children: "\u2705 Analysis complete" }) }), fullText && (_jsxs(Box, { marginBottom: 1, paddingX: 1, borderStyle: "round", borderColor: "cyan", flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { bold: true, color: "cyan", children: "\uD83D\uDCCB Agent Analysis:" }) }), _jsx(MarkdownWrapper, { children: fullText })] })), plugins.length > 0 && (_jsxs(Box, { flexDirection: "column", marginBottom: 1, children: [_jsx(Text, { bold: true, color: "green", children: "\u2728 Adding recommended plugins:" }), plugins.sort().map((plugin) => (_jsx(Box, { marginLeft: 2, children: _jsxs(Text, { children: ["\u2022 ", plugin] }) }, plugin)))] })), phase === 'installing' && (_jsx(Box, { marginTop: 1, children: _jsxs(Text, { color: "yellow", children: [_jsx(Spinner, { type: "dots" }), " Updating Claude Code settings..."] }) })), phase === 'complete' && (_jsxs(Box, { flexDirection: "column", marginTop: 1, children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "green", children: "\u2705 Updated Claude Code settings" }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "green", bold: true, children: "\u2705 Installation complete!" }) }), _jsx(Box, { children: _jsx(Text, { color: "blue", children: "\uD83D\uDCA1 Restart Claude Code to load the new plugins." }) })] }))] })), phase === 'error' && (_jsxs(Box, { flexDirection: "column", children: [_jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "red", bold: true, children: "\u274C Error" }) }), _jsx(Box, { marginBottom: 1, children: _jsx(Text, { color: "red", children: error }) }), fullText && (_jsxs(Box, { marginBottom: 1, paddingX: 1, borderStyle: "round", borderColor: "red", flexDirection: "column", children: [_jsx(Text, { bold: true, color: "red", children: "Partial Analysis:" }), _jsx(Box, { children: _jsx(MarkdownWrapper, { children: fullText }) })] })), _jsx(Box, { marginTop: 1, children: _jsx(Text, { color: "yellow", children: "\u26A0\uFE0F Falling back to installing core bushido plugin..." }) })] }))] }));
 };
 //# sourceMappingURL=install-progress.js.map