@buoy-design/agents 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Buoy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/acceptance.d.ts

@@ -0,0 +1,30 @@
+import type { AcceptanceInput, AcceptanceResult, AgentResult } from './types.js';
+export declare class AcceptanceAgent {
+    private client;
+    constructor(apiKey?: string);
+    /**
+     * Predict likelihood of PR acceptance for a repo
+     */
+    predict(input: AcceptanceInput): Promise<AgentResult<AcceptanceResult>>;
+    /**
+     * Build the prediction prompt
+     */
+    private buildPrompt;
+    /**
+     * Calculate PR statistics
+     */
+    private calculatePRStats;
+    /**
+     * Parse Claude's response
+     */
+    private parseResponse;
+    /**
+     * Parse and validate contribution process from response
+     */
+    private parseContributionProcess;
+    /**
+     * Validate likelihood value
+     */
+    private validateLikelihood;
+}
+//# sourceMappingURL=acceptance.d.ts.map

package/dist/acceptance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"acceptance.d.ts","sourceRoot":"","sources":["../src/acceptance.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAEhB,WAAW,EAEZ,MAAM,YAAY,CAAC;AAIpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,CAAC,EAAE,MAAM;IAM3B;;OAEG;IACG,OAAO,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IA+B7E;;OAEG;IACH,OAAO,CAAC,WAAW;IA2DnB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;IACH,OAAO,CAAC,aAAa;IA0CrB;;OAEG;IACH,OAAO,CAAC,wBAAwB;IAuChC;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAM3B"}

package/dist/acceptance.js

@@ -0,0 +1,205 @@
+// packages/agents/src/acceptance.ts
+// Predicts likelihood of PR acceptance
+import Anthropic from '@anthropic-ai/sdk';
+const MODEL = 'claude-sonnet-4-20250514';
+export class AcceptanceAgent {
+    client;
+    constructor(apiKey) {
+        this.client = new Anthropic({
+            apiKey: apiKey ?? process.env.ANTHROPIC_API_KEY,
+        });
+    }
+    /**
+     * Predict likelihood of PR acceptance for a repo
+     */
+    async predict(input) {
+        try {
+            const prompt = this.buildPrompt(input);
+            const hasContributingMd = Boolean(input.contributingMd);
+            const response = await this.client.messages.create({
+                model: MODEL,
+                max_tokens: 2000,
+                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, hasContributingMd);
+            return {
+                success: true,
+                data: parsed,
+                confidence: parsed.score / 100,
+                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 prediction prompt
+     */
+    buildPrompt(input) {
+        const prStats = this.calculatePRStats(input.recentPRs);
+        return `You are predicting whether a design system consistency PR will be accepted.
+
+## Repository
+${input.repo.owner}/${input.repo.name}
+${input.repo.description ? `Description: ${input.repo.description}` : ''}
+
+## Maintainer Activity
+- Commits last month: ${input.maintainerActivity.commitsLastMonth}
+- PRs reviewed last month: ${input.maintainerActivity.prsReviewedLastMonth}
+- Avg review time: ${input.maintainerActivity.avgReviewTimeHours} hours
+
+## PR Statistics
+- Total PRs analyzed: ${input.recentPRs.length}
+- Merge rate: ${prStats.mergeRate}%
+- Avg days open: ${prStats.avgDaysOpen}
+- External contributor merge rate: ${prStats.externalMergeRate}%
+
+${input.contributingMd ? `## CONTRIBUTING.md\n${input.contributingMd.slice(0, 2000)}` : '## No CONTRIBUTING.md found'}
+
+${input.issueLabels?.length ? `## Issue Labels Used\n${input.issueLabels.join(', ')}` : ''}
+
+## Your Task
+
+Predict likelihood of accepting a PR that:
+- Fixes design system drift (hardcoded colors → tokens)
+- Is a small, focused change (1-5 files)
+- Has clear explanation of why the change matters
+- Comes from an external contributor
+
+**IMPORTANT**: Also extract the contribution process preference from CONTRIBUTING.md.
+Look for phrases like:
+- "open an issue first" / "please file an issue"
+- "submit a PR directly" / "PRs welcome"
+- "for small fixes, PRs are fine"
+- "discuss in an issue before implementing"
+- "RFC required for major changes"
+
+Respond with JSON:
+{
+  "likelihood": "high" | "medium" | "low",
+  "score": 0-100,
+  "reasoning": "2-3 sentences explaining your prediction",
+  "suggestedApproach": "How to frame the PR for best reception",
+  "redFlags": ["List of concerns"],
+  "greenFlags": ["List of positive signals"],
+  "contributionProcess": {
+    "issueRequired": true | false | "features-only" | "major-only",
+    "directPRsAllowed": "all" | "small-fixes" | "none",
+    "discussionFirst": true | false,
+    "preferredFlow": "issue-then-pr" | "pr-directly" | "discussion-first" | "depends-on-scope",
+    "evidence": "Direct quote from CONTRIBUTING.md (or 'No CONTRIBUTING.md found')",
+    "confidence": 0-100
+  }
+}`;
+    }
+    /**
+     * Calculate PR statistics
+     */
+    calculatePRStats(prs) {
+        if (prs.length === 0) {
+            return { mergeRate: 0, avgDaysOpen: 0, externalMergeRate: 0 };
+        }
+        const merged = prs.filter((pr) => pr.merged);
+        const mergeRate = Math.round((merged.length / prs.length) * 100);
+        const avgDaysOpen = Math.round(prs.reduce((sum, pr) => sum + pr.daysOpen, 0) / prs.length);
+        // Assume external if author is not in first 3 commits (rough heuristic)
+        // In real implementation, you'd check against maintainer list
+        const externalPRs = prs.filter((pr) => pr.reviewComments > 0);
+        const externalMerged = externalPRs.filter((pr) => pr.merged);
+        const externalMergeRate = externalPRs.length > 0
+            ? Math.round((externalMerged.length / externalPRs.length) * 100)
+            : mergeRate;
+        return { mergeRate, avgDaysOpen, externalMergeRate };
+    }
+    /**
+     * Parse Claude's response
+     */
+    parseResponse(response, hasContributingMd) {
+        try {
+            const jsonMatch = response.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                const parsed = JSON.parse(jsonMatch[0]);
+                const result = {
+                    likelihood: this.validateLikelihood(parsed.likelihood),
+                    score: Math.min(100, Math.max(0, Number(parsed.score) || 50)),
+                    reasoning: String(parsed.reasoning ?? ''),
+                    suggestedApproach: String(parsed.suggestedApproach ?? ''),
+                    redFlags: Array.isArray(parsed.redFlags)
+                        ? parsed.redFlags.map(String)
+                        : [],
+                    greenFlags: Array.isArray(parsed.greenFlags)
+                        ? parsed.greenFlags.map(String)
+                        : [],
+                };
+                // Parse contribution process if present
+                if (parsed.contributionProcess) {
+                    result.contributionProcess = this.parseContributionProcess(parsed.contributionProcess, hasContributingMd);
+                }
+                return result;
+            }
+        }
+        catch {
+            // Fall through
+        }
+        return {
+            likelihood: 'medium',
+            score: 50,
+            reasoning: 'Unable to analyze - defaulting to medium likelihood',
+            suggestedApproach: 'Follow standard contribution guidelines',
+            redFlags: [],
+            greenFlags: [],
+        };
+    }
+    /**
+     * Parse and validate contribution process from response
+     */
+    parseContributionProcess(raw, hasContributingMd) {
+        const obj = raw;
+        // Validate issueRequired
+        let issueRequired = false;
+        if (obj.issueRequired === true || obj.issueRequired === false) {
+            issueRequired = obj.issueRequired;
+        }
+        else if (obj.issueRequired === 'features-only' || obj.issueRequired === 'major-only') {
+            issueRequired = obj.issueRequired;
+        }
+        // Validate directPRsAllowed
+        let directPRsAllowed = 'all';
+        if (obj.directPRsAllowed === 'all' || obj.directPRsAllowed === 'small-fixes' || obj.directPRsAllowed === 'none') {
+            directPRsAllowed = obj.directPRsAllowed;
+        }
+        // Validate preferredFlow
+        let preferredFlow = 'depends-on-scope';
+        const validFlows = ['issue-then-pr', 'pr-directly', 'discussion-first', 'depends-on-scope'];
+        if (validFlows.includes(obj.preferredFlow)) {
+            preferredFlow = obj.preferredFlow;
+        }
+        return {
+            issueRequired,
+            directPRsAllowed,
+            discussionFirst: Boolean(obj.discussionFirst),
+            preferredFlow,
+            evidence: hasContributingMd
+                ? String(obj.evidence ?? 'Could not extract specific guidance')
+                : 'No CONTRIBUTING.md found',
+            confidence: Math.min(100, Math.max(0, Number(obj.confidence) || (hasContributingMd ? 70 : 30))),
+        };
+    }
+    /**
+     * Validate likelihood value
+     */
+    validateLikelihood(value) {
+        const valid = ['high', 'medium', 'low'];
+        return valid.includes(value)
+            ? value
+            : 'medium';
+    }
+}
+//# sourceMappingURL=acceptance.js.map

package/dist/acceptance.js.map

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

package/dist/fixability.d.ts

@@ -0,0 +1,30 @@
+import type { FixabilityInput, FixabilityResult, AgentResult } from './types.js';
+export declare class FixabilityAgent {
+    private client;
+    constructor(apiKey?: string);
+    /**
+     * Assess how fixable a drift signal is
+     */
+    assess(input: FixabilityInput): Promise<AgentResult<FixabilityResult>>;
+    /**
+     * Batch assess multiple signals (more efficient)
+     */
+    assessBatch(inputs: FixabilityInput[]): Promise<AgentResult<FixabilityResult>[]>;
+    /**
+     * Build the assessment prompt
+     */
+    private buildPrompt;
+    /**
+     * Parse Claude's response
+     */
+    private parseResponse;
+    /**
+     * Validate tier value
+     */
+    private validateTier;
+    /**
+     * Validate difficulty value
+     */
+    private validateDifficulty;
+}
+//# sourceMappingURL=fixability.d.ts.map

package/dist/fixability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixability.d.ts","sourceRoot":"","sources":["../src/fixability.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,eAAe,EACf,gBAAgB,EAGhB,WAAW,EACZ,MAAM,YAAY,CAAC;AAIpB,qBAAa,eAAe;IAC1B,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,CAAC,EAAE,MAAM;IAM3B;;OAEG;IACG,MAAM,CAAC,KAAK,EAAE,eAAe,GAAG,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,CAAC;IA8B5E;;OAEG;IACG,WAAW,CACf,MAAM,EAAE,eAAe,EAAE,GACxB,OAAO,CAAC,WAAW,CAAC,gBAAgB,CAAC,EAAE,CAAC;IAgB3C;;OAEG;IACH,OAAO,CAAC,WAAW;IA2EnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAiCrB;;OAEG;IACH,OAAO,CAAC,YAAY;IAKpB;;OAEG;IACH,OAAO,CAAC,kBAAkB;CAM3B"}

package/dist/fixability.js

@@ -0,0 +1,182 @@
+// packages/agents/src/fixability.ts
+// Assesses how fixable a drift signal is
+import Anthropic from '@anthropic-ai/sdk';
+const MODEL = 'claude-haiku-4-20250514'; // Use Haiku for speed on many signals
+export class FixabilityAgent {
+    client;
+    constructor(apiKey) {
+        this.client = new Anthropic({
+            apiKey: apiKey ?? process.env.ANTHROPIC_API_KEY,
+        });
+    }
+    /**
+     * Assess how fixable a drift signal is
+     */
+    async assess(input) {
+        try {
+            const prompt = this.buildPrompt(input);
+            const response = await this.client.messages.create({
+                model: MODEL,
+                max_tokens: 1000,
+                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);
+            return {
+                success: true,
+                data: parsed,
+                confidence: parsed.tier === 'slam-dunk' ? 0.9 : 0.7,
+                tokensUsed: response.usage.input_tokens + response.usage.output_tokens,
+            };
+        }
+        catch (error) {
+            return {
+                success: false,
+                error: error instanceof Error ? error.message : String(error),
+                confidence: 0,
+            };
+        }
+    }
+    /**
+     * Batch assess multiple signals (more efficient)
+     */
+    async assessBatch(inputs) {
+        // Process in parallel with concurrency limit
+        const concurrency = 5;
+        const results = [];
+        for (let i = 0; i < inputs.length; i += concurrency) {
+            const batch = inputs.slice(i, i + concurrency);
+            const batchResults = await Promise.all(batch.map((input) => this.assess(input)));
+            results.push(...batchResults);
+        }
+        return results;
+    }
+    /**
+     * Build the assessment prompt
+     */
+    buildPrompt(input) {
+        const historyContext = input.historyContext
+            ? `
+## Git History Context
+- Verdict: ${input.historyContext.verdict}
+- Last modified: ${input.historyContext.lastModified}
+- Authors: ${input.historyContext.authors.join(', ')}
+- Context: ${input.historyContext.context}
+`
+            : '';
+        const tokenContext = input.designTokens
+            ? `
+## Available Design Tokens
+${Object.entries(input.designTokens)
+                .slice(0, 20)
+                .map(([name, value]) => `- ${name}: ${value}`)
+                .join('\n')}
+`
+            : '';
+        return `You are assessing whether a drift signal is worth fixing in an open source contribution.
+
+## Drift Signal
+- Type: ${input.signal.type}
+- File: ${input.signal.file}${input.signal.line ? `:${input.signal.line}` : ''}
+- Severity: ${input.signal.severity}
+- Message: ${input.signal.message}
+
+## File Content (around the issue)
+\`\`\`
+${input.surroundingCode ?? input.fileContent.slice(0, 1000)}
+\`\`\`
+
+${historyContext}
+${tokenContext}
+
+## Your Task
+
+Assess this signal:
+
+1. **Tier**: Is this a slam-dunk fix, needs review, or should skip?
+   - slam-dunk: Clear mistake, safe to fix, token exists
+   - review: Probably fixable but needs human judgment
+   - skip: Intentional, risky, or too complex
+
+2. **Difficulty**: How hard is the fix?
+   - one-liner: Just replace one value
+   - moderate: Few lines, maybe a type change
+   - complex: Multiple files, logic changes
+
+3. **Intentional**: Is this drift intentional?
+   - Check for comments explaining the value
+   - Check if it's a special override
+   - Check git history context
+
+4. **Safe to Fix**: Could this break anything?
+
+Respond with JSON:
+{
+  "tier": "slam-dunk" | "review" | "skip",
+  "difficulty": "one-liner" | "moderate" | "complex",
+  "reasoning": "Brief explanation",
+  "intentional": true | false,
+  "safeToFix": true | false,
+  "suggestedFix": {
+    "before": "original code",
+    "after": "fixed code",
+    "explanation": "what changed"
+  }
+}
+
+The suggestedFix is optional - include only for slam-dunk tier.`;
+    }
+    /**
+     * Parse Claude's response
+     */
+    parseResponse(response) {
+        try {
+            const jsonMatch = response.match(/\{[\s\S]*\}/);
+            if (jsonMatch) {
+                const parsed = JSON.parse(jsonMatch[0]);
+                return {
+                    tier: this.validateTier(parsed.tier),
+                    difficulty: this.validateDifficulty(parsed.difficulty),
+                    reasoning: String(parsed.reasoning ?? ''),
+                    intentional: Boolean(parsed.intentional),
+                    safeToFix: Boolean(parsed.safeToFix),
+                    suggestedFix: parsed.suggestedFix
+                        ? {
+                            before: String(parsed.suggestedFix.before ?? ''),
+                            after: String(parsed.suggestedFix.after ?? ''),
+                            explanation: String(parsed.suggestedFix.explanation ?? ''),
+                        }
+                        : undefined,
+                };
+            }
+        }
+        catch {
+            // Fall through
+        }
+        return {
+            tier: 'skip',
+            difficulty: 'complex',
+            reasoning: 'Unable to analyze signal',
+            intentional: false,
+            safeToFix: false,
+        };
+    }
+    /**
+     * Validate tier value
+     */
+    validateTier(value) {
+        const valid = ['slam-dunk', 'review', 'skip'];
+        return valid.includes(value) ? value : 'skip';
+    }
+    /**
+     * Validate difficulty value
+     */
+    validateDifficulty(value) {
+        const valid = ['one-liner', 'moderate', 'complex'];
+        return valid.includes(value)
+            ? value
+            : 'complex';
+    }
+}
+//# sourceMappingURL=fixability.js.map

package/dist/fixability.js.map

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

package/dist/generator.d.ts

@@ -0,0 +1,26 @@
+import type { GeneratorInput, GeneratorResult, AgentResult } from './types.js';
+export declare class GeneratorAgent {
+    private client;
+    constructor(apiKey?: string);
+    /**
+     * Generate fixes and PR description
+     */
+    generate(input: GeneratorInput): Promise<AgentResult<GeneratorResult>>;
+    /**
+     * Build the generation prompt
+     */
+    private buildPrompt;
+    /**
+     * Parse Claude's response
+     */
+    private parseResponse;
+    /**
+     * Validate fixes array
+     */
+    private validateFixes;
+    /**
+     * Build fallback PR body if parsing fails
+     */
+    private buildFallbackPRBody;
+}
+//# sourceMappingURL=generator.d.ts.map

package/dist/generator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generator.d.ts","sourceRoot":"","sources":["../src/generator.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,cAAc,EACd,eAAe,EAEf,WAAW,EACZ,MAAM,YAAY,CAAC;AAIpB,qBAAa,cAAc;IACzB,OAAO,CAAC,MAAM,CAAY;gBAEd,MAAM,CAAC,EAAE,MAAM;IAM3B;;OAEG;IACG,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO,CAAC,WAAW,CAAC,eAAe,CAAC,CAAC;IA8B5E;;OAEG;IACH,OAAO,CAAC,WAAW;IAsEnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkCrB;;OAEG;IACH,OAAO,CAAC,aAAa;IAqBrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CA8B5B"}