@buoy-design/cli 0.1.0 → 0.1.2

package/dist/explain/agents.js

@@ -0,0 +1,507 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { basename, resolve } from "node:path";
+/**
+ * Resolve the target from user input
+ * Returns null if no input and not --all (meaning run scan mode)
+ */
+export function resolveTarget(input, all) {
+    if (all) {
+        return {
+            type: "all",
+            path: process.cwd(),
+            name: "design-system",
+        };
+    }
+    if (!input) {
+        // No input = scan mode, handled separately
+        return null;
+    }
+    // Drift signal reference
+    if (input.startsWith("drift:")) {
+        const driftId = input.slice(6);
+        return {
+            type: "drift",
+            path: driftId,
+            name: `drift-${driftId}`,
+        };
+    }
+    // File or directory
+    const resolved = resolve(input);
+    if (!existsSync(resolved)) {
+        throw new Error(`Target not found: ${input}`);
+    }
+    const stats = require("fs").statSync(resolved);
+    return {
+        type: stats.isDirectory() ? "directory" : "file",
+        path: resolved,
+        name: basename(resolved),
+    };
+}
+/**
+ * Build quick/high-level prompts for --all or --quick mode
+ */
+function buildQuickPrompt(agent, targetDesc) {
+    const prompts = {
+        "git-archaeologist": `Analyze ${targetDesc}. Quick git history overview:
+1. Check recent commits (last 20) for patterns
+2. Who are the main contributors?
+3. Any recent major changes?
+Keep response under 300 words. Focus on key insights only.`,
+        "structure-analyst": `Analyze ${targetDesc}. Quick architecture overview:
+1. What's the high-level structure?
+2. Key directories and their purposes?
+3. Main patterns or frameworks used?
+Keep response under 300 words. Focus on architecture insights only.`,
+        "code-reader": `Analyze ${targetDesc}. Quick code overview:
+1. What are the main technologies?
+2. Any obvious TODOs or FIXMEs?
+3. Code quality observations?
+Keep response under 300 words. Focus on key observations only.`,
+        "convention-detective": `Analyze ${targetDesc}. Quick conventions check:
+1. What frameworks/patterns are used?
+2. Are conventions consistent?
+3. Any obvious anti-patterns?
+Keep response under 300 words. Focus on pattern insights only.`,
+    };
+    return prompts[agent] || "";
+}
+/**
+ * Build the prompt for each investigation agent
+ */
+function buildAgentPrompt(agent, target, quick) {
+    // Special handling for scan results
+    if (target.type === "scan" && target.scanData) {
+        return buildScanAgentPrompt(agent, target.scanData);
+    }
+    const targetDesc = target.type === "all"
+        ? "the design system in this codebase"
+        : target.type === "drift"
+            ? `drift signal ${target.path}`
+            : `${target.path}`;
+    // Quick mode uses shorter, more focused prompts
+    if (quick || target.type === "all") {
+        return buildQuickPrompt(agent, targetDesc);
+    }
+    const prompts = {
+        "git-archaeologist": `You are investigating: ${targetDesc}
+
+Your mission: Uncover the history of this code through git forensics.
+
+Tasks:
+1. Run git log to see the history of changes to this target
+2. Run git blame on relevant files to see line-by-line attribution
+3. Find the original commits that introduced this code
+4. Look for refactoring commits (messages with "refactor", "move", "rename")
+5. Check for PR/issue references in commit messages (#123 patterns)
+6. Identify the author(s) and time periods of major changes
+
+Focus your output on:
+- When and why this was originally created
+- Key evolutionary moments (major refactors, ownership changes)
+- Any PR/issue discussions that reveal intent
+- Clues from commit messages about constraints or decisions
+
+Be concise. Focus on insights that explain WHY things are the way they are.`,
+        "structure-analyst": `You are investigating: ${targetDesc}
+
+Your mission: Understand how this fits into the codebase architecture.
+
+Tasks:
+1. Find what imports or depends on this (search for import statements)
+2. Find what this imports or depends on
+3. Examine the directory structure - why is it located here?
+4. Look for related files (tests, stories, types, styles)
+5. Check if this is part of a larger pattern (similar files nearby)
+6. Identify the architectural "layer" this belongs to
+
+Focus your output on:
+- The dependency graph (what uses this, what this uses)
+- Why the current location makes sense (or doesn't)
+- Related files that provide context
+- The architectural role this plays
+
+Be concise. Focus on structural insights that explain the design.`,
+        "code-reader": `You are investigating: ${targetDesc}
+
+Your mission: Read the actual code for clues about purpose and constraints.
+
+Tasks:
+1. Read the file(s) carefully
+2. Extract all comments, especially TODO, HACK, FIXME, NOTE, WARNING
+3. Analyze naming conventions - what do names reveal?
+4. Look for defensive code, error handling, edge cases
+5. Identify hardcoded values and speculate why they exist
+6. Note unusual patterns that might have backstory
+
+Focus your output on:
+- The core purpose (1-2 sentences)
+- Revealing comments (quote them verbatim)
+- What the code structure tells us about constraints
+- Oddities that suggest workarounds or history
+
+Be concise. Focus on what the code itself reveals about intent.`,
+        "convention-detective": `You are investigating: ${targetDesc}
+
+Your mission: Compare against known patterns and project conventions.
+
+Tasks:
+1. Identify the framework/library being used (React, Vue, Tailwind, etc.)
+2. Check if this follows standard patterns for that ecosystem
+3. Look for deviations from conventions - intentional or accidental?
+4. Compare to similar code elsewhere in this project
+5. Identify potential workarounds for known limitations
+6. Note anti-patterns that might indicate tech debt
+
+Focus your output on:
+- What conventions/patterns this should follow
+- Where it deviates and possible reasons why
+- How it compares to similar code in the same repo
+- Signs of workarounds or intentional divergence
+
+Be concise. Focus on pattern analysis that explains design choices.`,
+    };
+    return prompts[agent] || "";
+}
+/**
+ * Build prompts for explaining scan results (drift signals)
+ */
+function buildScanAgentPrompt(agent, scanData) {
+    const prompts = {
+        "drift-analyst": `You are analyzing Buoy scan results for this codebase.
+
+Here are the scan results:
+
+${scanData}
+
+Your mission: Analyze the PATTERNS in these drift signals.
+
+Tasks:
+1. Group related drift signals (same component, same type, same root cause)
+2. Identify the most impactful issues (what affects the most code)
+3. Look for systemic problems vs one-off issues
+4. Note which components or areas have the most drift
+
+Focus your output on:
+- Patterns you see across multiple signals
+- The severity distribution and what it means
+- Components or areas that need the most attention
+- Whether this looks like gradual drift or sudden changes
+
+Be concise. Focus on insights that help prioritize fixes.`,
+        "root-cause-investigator": `You are analyzing Buoy scan results for this codebase.
+
+Here are the scan results:
+
+${scanData}
+
+Your mission: Investigate the ROOT CAUSES of drift.
+
+Tasks:
+1. For hardcoded values: Why might developers be bypassing tokens?
+2. For naming issues: What convention conflicts exist?
+3. For orphaned components: Why aren't these in the design system?
+4. For deprecated patterns: What's blocking migration?
+
+Focus your output on:
+- The likely reasons behind each type of drift
+- Whether issues stem from tooling, process, or knowledge gaps
+- Common root causes that explain multiple signals
+- What's intentional vs accidental
+
+Be concise. Focus on WHY drift is happening, not just WHAT drifted.`,
+        "impact-assessor": `You are analyzing Buoy scan results for this codebase.
+
+Here are the scan results:
+
+${scanData}
+
+Your mission: Assess the IMPACT and RISK of this drift.
+
+Tasks:
+1. Which drift signals pose the highest risk?
+2. What's the blast radius of each issue?
+3. Which fixes would have the most positive impact?
+4. What happens if this drift continues unchecked?
+
+Focus your output on:
+- Risk assessment for the critical and warning signals
+- Which components are most heavily affected
+- The cumulative effect of the drift patterns
+- Priority order for addressing issues
+
+Be concise. Focus on impact and risk, not just listing issues.`,
+        "fix-strategist": `You are analyzing Buoy scan results for this codebase.
+
+Here are the scan results:
+
+${scanData}
+
+Your mission: Develop a FIX STRATEGY for the drift.
+
+Tasks:
+1. Group fixes that can be done together (same root cause)
+2. Identify quick wins vs larger refactors
+3. Suggest the order of operations for fixes
+4. Note any fixes that might have dependencies
+
+Focus your output on:
+- Concrete fix strategies, not vague suggestions
+- Which fixes can be automated vs need manual work
+- The logical order for addressing drift
+- Potential risks or gotchas with fixes
+
+Be concise. Focus on actionable fix strategies.`,
+    };
+    return prompts[agent] || "";
+}
+/**
+ * Build the synthesis prompt for scan results
+ */
+function buildScanSynthesisPrompt(scanData, findings) {
+    const findingsText = findings
+        .filter((f) => f.success)
+        .map((f) => `## ${f.agent}\n\n${f.output}`)
+        .join("\n\n---\n\n");
+    return `You are synthesizing an analysis of Buoy scan results.
+
+Original scan data:
+${scanData}
+
+Four agents have analyzed these results. Here are their findings:
+
+${findingsText}
+
+---
+
+Your mission: Create a clear, ACTIONABLE summary for the developer.
+
+Create a response with this EXACT structure:
+
+# Design System Health Report
+
+## Summary
+
+[2-3 sentences: How healthy is this codebase? What's the overall drift situation?]
+
+## Key Findings
+
+[3-5 bullet points of the most important insights from the analysis]
+
+## Recommendations
+
+[Numbered list of 3-5 specific, actionable recommendations. Each should have:]
+- A clear action title
+- Confidence level: (High Confidence), (Medium Confidence), or (Low Confidence)
+- 2-3 sentences explaining the fix and its impact
+- Specific files or components affected if known
+
+Order by priority - most impactful fixes first.
+
+## Quick Wins
+
+[2-3 small fixes that can be done immediately with high confidence]
+
+## Open Questions
+
+[2-3 things that need human judgment or more investigation]
+
+Be direct. Be specific. Make the recommendations genuinely useful.
+Focus on what the developer should DO, not just what's wrong.`;
+}
+/**
+ * Build the synthesis prompt that combines all findings
+ */
+function buildSynthesisPrompt(target, findings) {
+    const findingsText = findings
+        .filter((f) => f.success)
+        .map((f) => `## ${f.agent}\n\n${f.output}`)
+        .join("\n\n---\n\n");
+    return `You are synthesizing an investigation about: ${target.name}
+
+Four agents have investigated this target. Here are their findings:
+
+${findingsText}
+
+---
+
+Your mission: Build a coherent, ACTIONABLE explanation.
+
+Create a response with this EXACT structure:
+
+# ${target.name}
+
+## What We Found
+
+[2-3 paragraphs explaining the history and context. Why does this exist?
+How did it evolve? What constraints shaped it?]
+
+## Recommendations
+
+[Numbered list of 2-4 specific, actionable recommendations. Each should have:]
+- A clear action title
+- Confidence level: (High Confidence), (Medium Confidence), or (Low Confidence)
+- 2-3 sentences explaining WHY this action makes sense based on the evidence
+- Code example if applicable (use diff format for changes)
+
+Focus on recommendations that are:
+- Grounded in evidence from the investigation
+- Actually useful (not just "consider refactoring")
+- Prioritized by confidence and impact
+
+## Open Questions
+
+[2-3 bullet points of things that remain unclear and might need human input]
+
+Be direct. Be specific. Make the recommendations genuinely useful.`;
+}
+/**
+ * Run a single agent using the Claude CLI
+ */
+async function runAgent(agent, prompt, options = {}) {
+    const timeout = options.timeout || 60000;
+    return new Promise((resolve) => {
+        // Use --print flag for non-interactive mode, disable MCP to speed up
+        const args = ["-p", prompt, "--output-format", "text", "--no-mcp"];
+        const child = spawn("claude", args, {
+            cwd: process.cwd(),
+            stdio: ["pipe", "pipe", "pipe"],
+            env: {
+                PATH: process.env.PATH,
+                HOME: process.env.HOME,
+                ANTHROPIC_API_KEY: process.env.ANTHROPIC_API_KEY,
+                // Skip project detection to speed up
+                CLAUDE_CODE_SKIP_PROJECT_DETECTION: "1",
+            },
+        });
+        let stdout = "";
+        let stderr = "";
+        const timer = setTimeout(() => {
+            child.kill("SIGTERM");
+            const partialInfo = stdout.length > 0 ? ` (got ${stdout.length} chars)` : "";
+            const stderrInfo = stderr.length > 0 ? ` stderr: ${stderr.slice(0, 100)}` : "";
+            resolve({
+                agent,
+                success: false,
+                output: stdout,
+                error: `Agent timed out after ${timeout / 1000}s${partialInfo}${stderrInfo}`,
+            });
+        }, timeout);
+        child.stdout.on("data", (data) => {
+            stdout += data.toString();
+        });
+        child.stderr.on("data", (data) => {
+            stderr += data.toString();
+        });
+        child.on("close", (code) => {
+            clearTimeout(timer);
+            if (code === 0) {
+                resolve({ agent, success: true, output: stdout.trim() });
+            }
+            else {
+                resolve({
+                    agent,
+                    success: false,
+                    output: stdout.trim(),
+                    error: stderr.trim() || `Agent exited with code ${code}`,
+                });
+            }
+        });
+        child.on("error", (err) => {
+            clearTimeout(timer);
+            resolve({
+                agent,
+                success: false,
+                output: "",
+                error: `Failed to spawn claude: ${err.message}`,
+            });
+        });
+    });
+}
+/**
+ * Run all investigation agents in parallel, then synthesize
+ */
+export async function runExplainAgents(target, options = {}) {
+    // Use different agents for scan mode vs file/directory mode
+    const agents = target.type === "scan"
+        ? ["drift-analyst", "root-cause-investigator", "impact-assessor", "fix-strategist"]
+        : ["git-archaeologist", "structure-analyst", "code-reader", "convention-detective"];
+    // Timeouts depend on scope and quick mode
+    // --all on large codebases needs more time
+    const agentTimeout = options.quick ? 60000 : (target.type === "all" ? 180000 : 120000);
+    const synthesizerTimeout = options.quick ? 90000 : 300000;
+    // Run investigation agents in parallel
+    const investigationPromises = agents.map(async (agent) => {
+        options.onProgress?.(agent, "started");
+        const prompt = buildAgentPrompt(agent, target, options.quick);
+        const result = await runAgent(agent, prompt, { timeout: agentTimeout, verbose: options.verbose });
+        options.onProgress?.(agent, result.success ? "completed" : "failed");
+        return result;
+    });
+    const findings = await Promise.all(investigationPromises);
+    // Run synthesizer with all findings (longer timeout since it processes everything)
+    options.onProgress?.("synthesizer", "started");
+    const synthesisPrompt = target.type === "scan" && target.scanData
+        ? buildScanSynthesisPrompt(target.scanData, findings)
+        : buildSynthesisPrompt(target, findings);
+    const synthesisResult = await runAgent("synthesizer", synthesisPrompt, {
+        timeout: synthesizerTimeout,
+        verbose: options.verbose,
+    });
+    options.onProgress?.("synthesizer", synthesisResult.success ? "completed" : "failed");
+    // If synthesis failed, build a fallback from the findings
+    let synthesis;
+    if (synthesisResult.success) {
+        synthesis = synthesisResult.output;
+    }
+    else if (synthesisResult.output && synthesisResult.output.length > 100) {
+        // Partial output is available - use it
+        synthesis = `${synthesisResult.output}\n\n---\n*Note: Synthesis was interrupted but partial analysis above may be useful.*`;
+    }
+    else {
+        // Build manual summary from individual findings
+        synthesis = buildFallbackSynthesis(target, findings);
+    }
+    return {
+        target,
+        findings,
+        synthesis,
+    };
+}
+/**
+ * Build a fallback synthesis when the synthesizer agent fails
+ */
+function buildFallbackSynthesis(target, findings) {
+    const successfulFindings = findings.filter((f) => f.success);
+    if (successfulFindings.length === 0) {
+        return `# Analysis Failed
+
+Unable to complete analysis of ${target.name}. All investigation agents failed.
+
+Please try again or check your network connection.`;
+    }
+    let output = `# ${target.name}
+
+*Note: Full synthesis unavailable. Showing individual agent findings.*
+
+`;
+    for (const finding of successfulFindings) {
+        const agentTitle = finding.agent
+            .split("-")
+            .map((w) => w.charAt(0).toUpperCase() + w.slice(1))
+            .join(" ");
+        output += `## ${agentTitle}\n\n`;
+        output += finding.output;
+        output += "\n\n---\n\n";
+    }
+    output += `## Next Steps
+
+Review the findings above and look for:
+- Patterns that appear in multiple agent reports
+- High-confidence observations vs speculation
+- Actionable items you can address immediately
+
+Run with \`--verbose\` for full agent output.`;
+    return output;
+}
+//# sourceMappingURL=agents.js.map

package/dist/explain/agents.js.map

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

package/dist/hooks/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * lint-staged configuration for package.json
+ */
+export declare const LINT_STAGED_CONFIG: {
+    "*.{tsx,jsx,ts,js,vue,svelte}": string[];
+};
+export type HookSystem = "git" | "husky" | "pre-commit" | "lint-staged";
+/**
+ * Detect which hook system is in use
+ */
+export declare function detectHookSystem(projectRoot: string): HookSystem | null;
+export interface SetupHooksResult {
+    success: boolean;
+    hookSystem: HookSystem | null;
+    message: string;
+    filePath?: string;
+}
+/**
+ * Setup pre-commit hooks for the project
+ */
+export declare function setupHooks(projectRoot: string): SetupHooksResult;
+/**
+ * Generate a standalone pre-commit hook script for .buoy/hooks/
+ */
+export declare function generateStandaloneHook(projectRoot: string): SetupHooksResult;
+//# sourceMappingURL=index.d.ts.map

package/dist/hooks/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/hooks/index.ts"],"names":[],"mappings":"AAuCA;;GAEG;AACH,eAAO,MAAM,kBAAkB;;CAE9B,CAAC;AAmBF,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,OAAO,GAAG,YAAY,GAAG,aAAa,CAAC;AAExE;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,WAAW,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CA8BvE;AAED,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,OAAO,CAAC;IACjB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CA2BhE;AAgLD;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,GAAG,gBAAgB,CAoB5E"}