@buoy-design/agents 0.1.0

package/dist/generator.js

@@ -0,0 +1,194 @@
+// packages/agents/src/generator.ts
+// Generates code fixes and PR descriptions
+import Anthropic from '@anthropic-ai/sdk';
+const MODEL = 'claude-sonnet-4-20250514';
+export class GeneratorAgent {
+    client;
+    constructor(apiKey) {
+        this.client = new Anthropic({
+            apiKey: apiKey ?? process.env.ANTHROPIC_API_KEY,
+        });
+    }
+    /**
+     * Generate fixes and PR description
+     */
+    async generate(input) {
+        try {
+            const prompt = this.buildPrompt(input);
+            const response = await this.client.messages.create({
+                model: MODEL,
+                max_tokens: 4000,
+                messages: [{ role: 'user', content: prompt }],
+            });
+            const textContent = response.content.find((c) => c.type === 'text');
+            const responseText = textContent?.type === 'text' ? textContent.text : '';
+            const parsed = this.parseResponse(responseText, input);
+            return {
+                success: true,
+                data: parsed,
+                confidence: parsed.confidence,
+                tokensUsed: response.usage.input_tokens + response.usage.output_tokens,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                confidence: 0,
+            };
+        }
+    }
+    /**
+     * Build the generation prompt
+     */
+    buildPrompt(input) {
+        const signalSummary = input.signals
+            .filter((s) => s.fixability.tier !== 'skip')
+            .map((s) => {
+            const fix = s.fixability.suggestedFix;
+            return `- ${s.signal.file}:${s.signal.line ?? '?'} - ${s.signal.type}
+  Message: ${s.signal.message}
+  Difficulty: ${s.fixability.difficulty}
+  ${fix ? `Suggested: ${fix.before} → ${fix.after}` : ''}
+  ${s.history ? `History: ${s.history.verdict} - ${s.history.context}` : ''}`;
+        })
+            .join('\n\n');
+        const tokenList = input.designTokens
+            ? Object.entries(input.designTokens)
+                .slice(0, 30)
+                .map(([name, value]) => `${name}: ${value}`)
+                .join('\n')
+            : 'No tokens provided';
+        return `You are generating a PR to fix design system drift.
+
+## Repository
+${input.repo.owner}/${input.repo.name}
+${input.repo.description ?? ''}
+
+## Acceptance Context
+- Likelihood: ${input.acceptanceContext.likelihood} (${input.acceptanceContext.score}/100)
+- Approach: ${input.acceptanceContext.suggestedApproach}
+- Green flags: ${input.acceptanceContext.greenFlags.join(', ') || 'none'}
+- Red flags: ${input.acceptanceContext.redFlags.join(', ') || 'none'}
+
+## Signals to Fix
+${signalSummary}
+
+## Available Design Tokens
+${tokenList}
+
+## Your Task
+
+1. Generate the exact code fixes for each signal
+2. Write a compelling PR title and description
+
+For the PR description:
+- Explain WHY this matters (maintainability, consistency, theming)
+- Reference the git history if it shows these were accidental
+- Be respectful and helpful, not preachy
+- Mention Buoy subtly at the end
+- If many files, add a cherry-pick note
+
+Respond with JSON:
+{
+  "fixes": [
+    {
+      "file": "path/to/file.tsx",
+      "line": 23,
+      "before": "exact code to replace",
+      "after": "replacement code",
+      "explanation": "why this fix"
+    }
+  ],
+  "prTitle": "Short, clear title",
+  "prBody": "Full markdown PR description",
+  "confidence": 0.0-1.0,
+  "cherryPickNote": "Optional note if PR is large"
+}
+
+Be precise with the fixes - they will be applied directly.`;
+    }
+    /**
+     * Parse Claude's response
+     */
+    parseResponse(response, input) {
+        try {
+            const jsonMatch = response.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                const parsed = JSON.parse(jsonMatch[0]);
+                const fixes = this.validateFixes(parsed.fixes ?? []);
+                return {
+                    fixes,
+                    prTitle: String(parsed.prTitle ?? 'fix: Design system consistency'),
+                    prBody: String(parsed.prBody ?? this.buildFallbackPRBody(input, fixes)),
+                    confidence: Math.min(1, Math.max(0, Number(parsed.confidence) || 0.7)),
+                    cherryPickNote: parsed.cherryPickNote
+                        ? String(parsed.cherryPickNote)
+                        : undefined,
+                    filesChanged: new Set(fixes.map((f) => f.file)).size,
+                };
+            }
+        }
+        catch {
+            // Fall through
+        }
+        return {
+            fixes: [],
+            prTitle: 'fix: Design system consistency',
+            prBody: 'Unable to generate PR description',
+            confidence: 0,
+            filesChanged: 0,
+        };
+    }
+    /**
+     * Validate fixes array
+     */
+    validateFixes(fixes) {
+        const valid = [];
+        for (const f of fixes) {
+            if (!f || typeof f !== 'object')
+                continue;
+            const fix = f;
+            if (!fix['file'] || !fix['before'] || !fix['after'])
+                continue;
+            valid.push({
+                file: String(fix['file']),
+                line: Number(fix['line']) || 0,
+                before: String(fix['before']),
+                after: String(fix['after']),
+                explanation: String(fix['explanation'] ?? ''),
+            });
+        }
+        return valid;
+    }
+    /**
+     * Build fallback PR body if parsing fails
+     */
+    buildFallbackPRBody(input, fixes) {
+        const fileList = [...new Set(fixes.map((f) => f.file))];
+        return `## Summary
+
+This PR improves design system consistency by replacing hardcoded values with their corresponding design tokens.
+
+### Changes
+
+${fixes.map((f) => `- \`${f.file}:${f.line}\`: ${f.explanation || 'Use design token'}`).join('\n')}
+
+### Files Changed
+
+${fileList.map((f) => `- \`${f}\``).join('\n')}
+
+### Why This Matters
+
+Using design tokens instead of hardcoded values:
+- Makes the codebase more maintainable
+- Ensures consistency across the application
+- Makes theming and updates easier
+
+---
+
+*Found with [Buoy](https://github.com/buoy-design/buoy) - design drift detection for AI-generated code.*
+`;
+    }
+}
+//# sourceMappingURL=generator.js.map

package/dist/generator.js.map

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

package/dist/history.d.ts

@@ -0,0 +1,30 @@
+import type { HistoryInput, HistoryResult, AgentResult } from './types.js';
+export declare class HistoryAgent {
+    private client;
+    constructor(apiKey?: string);
+    /**
+     * Analyze git history for a file to understand why drift exists
+     */
+    analyze(input: HistoryInput): Promise<AgentResult<HistoryResult>>;
+    /**
+     * Extract PR number from commit message
+     */
+    private extractPRNumber;
+    /**
+     * Extract blame info for specific lines
+     */
+    private extractBlameForLines;
+    /**
+     * Build the analysis prompt
+     */
+    private buildPrompt;
+    /**
+     * Parse Claude's response
+     */
+    private parseResponse;
+    /**
+     * Validate verdict is a known value
+     */
+    private validateVerdict;
+}
+//# sourceMappingURL=history.d.ts.map

package/dist/history.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"history.d.ts","sourceRoot":"","sources":["../src/history.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,YAAY,EACZ,aAAa,EAGb,WAAW,EACZ,MAAM,YAAY,CAAC;AAIpB,qBAAa,YAAY;IACvB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,CAAC,EAAE,MAAM;IAM3B;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC,aAAa,CAAC,CAAC;IAgFvE;;OAEG;IACH,OAAO,CAAC,eAAe;IAKvB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,WAAW;IA4CnB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0BrB;;OAEG;IACH,OAAO,CAAC,eAAe;CAWxB"}

package/dist/history.js

@@ -0,0 +1,182 @@
+// packages/agents/src/history.ts
+// Analyzes git history to understand why drift exists
+import Anthropic from '@anthropic-ai/sdk';
+import { simpleGit } from 'simple-git';
+const MODEL = 'claude-sonnet-4-20250514';
+export class HistoryAgent {
+    client;
+    constructor(apiKey) {
+        this.client = new Anthropic({
+            apiKey: apiKey ?? process.env.ANTHROPIC_API_KEY,
+        });
+    }
+    /**
+     * Analyze git history for a file to understand why drift exists
+     */
+    async analyze(input) {
+        try {
+            const git = simpleGit(input.repoPath);
+            // Get git blame for the file
+            const blameRaw = await git.raw([
+                'blame',
+                '--line-porcelain',
+                input.filePath,
+            ]).catch(() => '');
+            // Get commit history for the file
+            const logResult = await git.log({
+                file: input.filePath,
+                maxCount: 20,
+            });
+            // Parse commits into our format
+            const timeline = logResult.all.map((commit) => ({
+                hash: commit.hash.slice(0, 7),
+                date: commit.date,
+                author: commit.author_name,
+                email: commit.author_email,
+                message: commit.message,
+                prNumber: this.extractPRNumber(commit.message),
+            }));
+            // Extract unique authors
+            const authors = [...new Set(timeline.map((c) => c.author))];
+            // Get last modified date
+            const lastModified = timeline[0]?.date ?? 'unknown';
+            // If we have line range, extract relevant blame info
+            let focusedBlame = '';
+            if (input.lineRange && blameRaw) {
+                focusedBlame = this.extractBlameForLines(blameRaw, input.lineRange[0], input.lineRange[1]);
+            }
+            // Use Claude to analyze the history
+            const prompt = this.buildPrompt(input, timeline, focusedBlame);
+            const response = await this.client.messages.create({
+                model: MODEL,
+                max_tokens: 1500,
+                messages: [{ role: 'user', content: prompt }],
+            });
+            const textContent = response.content.find((c) => c.type === 'text');
+            const responseText = textContent?.type === 'text' ? textContent.text : '';
+            // Parse the response
+            const parsed = this.parseResponse(responseText);
+            return {
+                success: true,
+                data: {
+                    verdict: parsed.verdict,
+                    timeline,
+                    context: parsed.context,
+                    confidence: parsed.confidence,
+                    lastModified,
+                    authors,
+                },
+                confidence: parsed.confidence,
+                tokensUsed: response.usage.input_tokens + response.usage.output_tokens,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                confidence: 0,
+            };
+        }
+    }
+    /**
+     * Extract PR number from commit message
+     */
+    extractPRNumber(message) {
+        const match = message.match(/#(\d+)/);
+        return match ? parseInt(match[1], 10) : undefined;
+    }
+    /**
+     * Extract blame info for specific lines
+     */
+    extractBlameForLines(blameRaw, startLine, endLine) {
+        const lines = blameRaw.split('\n');
+        const relevant = [];
+        let currentLine = 0;
+        for (const line of lines) {
+            if (line.match(/^[a-f0-9]{40}/)) {
+                currentLine++;
+                if (currentLine >= startLine && currentLine <= endLine) {
+                    relevant.push(line);
+                }
+            }
+        }
+        return relevant.join('\n');
+    }
+    /**
+     * Build the analysis prompt
+     */
+    buildPrompt(input, timeline, focusedBlame) {
+        const recentCommits = timeline
+            .slice(0, 10)
+            .map((c) => `- ${c.hash} (${c.date}) by ${c.author}: ${c.message.slice(0, 100)}`)
+            .join('\n');
+        return `You are analyzing git history to understand why a piece of code exists.
+
+## File
+${input.filePath}
+${input.lineRange ? `Lines ${input.lineRange[0]}-${input.lineRange[1]}` : ''}
+
+## Recent Commits
+${recentCommits}
+
+${focusedBlame ? `## Blame Info for Relevant Lines\n${focusedBlame}` : ''}
+
+## Your Task
+
+Determine if the code in question was:
+- **accidental**: Developer didn't know about existing patterns/tokens
+- **intentional**: Deliberate choice (override, special case, commented reason)
+- **ai-generated**: Looks like Copilot/Claude output (generic patterns, no context awareness)
+- **unknown**: Cannot determine from available information
+
+Analyze the commit messages, timing, and patterns to make your determination.
+
+Respond with JSON:
+{
+  "verdict": "accidental" | "intentional" | "ai-generated" | "unknown",
+  "context": "Explanation of your analysis (2-3 sentences)",
+  "confidence": 0.0-1.0
+}
+
+Be concise but specific. Reference actual commits or patterns you observed.`;
+    }
+    /**
+     * Parse Claude's response
+     */
+    parseResponse(response) {
+        try {
+            const jsonMatch = response.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                const parsed = JSON.parse(jsonMatch[0]);
+                return {
+                    verdict: this.validateVerdict(parsed.verdict),
+                    context: String(parsed.context ?? ''),
+                    confidence: Math.min(1, Math.max(0, Number(parsed.confidence) || 0.5)),
+                };
+            }
+        }
+        catch {
+            // Fall through to default
+        }
+        return {
+            verdict: 'unknown',
+            context: 'Unable to parse analysis response',
+            confidence: 0,
+        };
+    }
+    /**
+     * Validate verdict is a known value
+     */
+    validateVerdict(value) {
+        const valid = [
+            'accidental',
+            'intentional',
+            'ai-generated',
+            'unknown',
+        ];
+        return valid.includes(value)
+            ? value
+            : 'unknown';
+    }
+}
+//# sourceMappingURL=history.js.map

package/dist/history.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { HistoryAgent } from './history.js';
+export { ReviewAgent } from './review.js';
+export { AcceptanceAgent } from './acceptance.js';
+export { FixabilityAgent } from './fixability.js';
+export { GeneratorAgent } from './generator.js';
+export type { RepoContext, SampledFile, AgentResult, HistoryInput, HistoryResult, HistoryVerdict, CommitInfo, ReviewInput, ReviewResult, MissedPattern, MissedPatternCategory, BuoyImprovement, AcceptanceInput, AcceptanceResult, AcceptanceLikelihood, FixabilityInput, FixabilityResult, FixTier, FixDifficulty, GeneratorInput, GeneratorResult, GeneratedFix, ContributionState, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAGhD,YAAY,EAEV,WAAW,EACX,WAAW,EACX,WAAW,EAGX,YAAY,EACZ,aAAa,EACb,cAAc,EACd,UAAU,EAGV,WAAW,EACX,YAAY,EACZ,aAAa,EACb,qBAAqB,EACrB,eAAe,EAGf,eAAe,EACf,gBAAgB,EAChB,oBAAoB,EAGpB,eAAe,EACf,gBAAgB,EAChB,OAAO,EACP,aAAa,EAGb,cAAc,EACd,eAAe,EACf,YAAY,EAGZ,iBAAiB,GAClB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+// packages/agents/src/index.ts
+// Main entry point for @buoy-design/agents
+// Agents
+export { HistoryAgent } from './history.js';
+export { ReviewAgent } from './review.js';
+export { AcceptanceAgent } from './acceptance.js';
+export { FixabilityAgent } from './fixability.js';
+export { GeneratorAgent } from './generator.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,+BAA+B;AAC/B,2CAA2C;AAE3C,SAAS;AACT,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/review.d.ts

@@ -0,0 +1,34 @@
+import type { ReviewInput, ReviewResult, AgentResult } from './types.js';
+export declare class ReviewAgent {
+    private client;
+    constructor(apiKey?: string);
+    /**
+     * Review what Buoy found vs what's in the repo
+     */
+    analyze(input: ReviewInput): Promise<AgentResult<ReviewResult>>;
+    /**
+     * Build the analysis prompt
+     */
+    private buildPrompt;
+    /**
+     * Parse Claude's response
+     */
+    private parseResponse;
+    /**
+     * Validate missed patterns array
+     */
+    private validateMissedPatterns;
+    /**
+     * Validate improvements array
+     */
+    private validateImprovements;
+    /**
+     * Get file extension for syntax highlighting
+     */
+    private getFileExtension;
+    /**
+     * Truncate content to max lines
+     */
+    private truncateContent;
+}
+//# sourceMappingURL=review.d.ts.map

package/dist/review.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"review.d.ts","sourceRoot":"","sources":["../src/review.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EAGZ,WAAW,EACZ,MAAM,YAAY,CAAC;AAIpB,qBAAa,WAAW;IACtB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,CAAC,EAAE,MAAM;IAM3B;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC,YAAY,CAAC,CAAC;IA8BrE;;OAEG;IACH,OAAO,CAAC,WAAW;IAuFnB;;OAEG;IACH,OAAO,CAAC,aAAa;IA4BrB;;OAEG;IACH,OAAO,CAAC,sBAAsB;IA6B9B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAuB5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;OAEG;IACH,OAAO,CAAC,eAAe;CASxB"}