codexia 0.2.0 → 0.3.0

package/CHANGELOG.md

@@ -1,70 +1,74 @@
 # Changelog
 
-## [v0.2.0] - 2026-01-17
-
-### What's Changed
-
-- chore: release v0.1.0 (2dabe28)
-- fix: fix version bump step with logging for better visibility (46e0351)
-- chore: release v0.1.0 (e6456e4)
-- feat: enhance release workflow with separate push for version bump and tag (0a1f061)
-- chore: release v0.3.0 (3075ea2)
-- chore: add release workflow for automated versioning and publishing (#11) (d8846d4)
-- feat: add interactive wizard for command selection and execution (#6) (37610b2)
-- feat: Add 12 new analysis modules and MCP server (#4) (d02f673)
-- feat: Add new commands and features to Codexia CLI (#1) (900702f)
-- chore: Add GitHub Actions CI workflow for testing and building (#2) (3370888)
-- Initial commit (02b3f9a)
-
-
-## [v0.1.0] - 2026-01-17
-
-### What's Changed
-
-- fix: fix version bump step with logging for better visibility (46e0351)
-
-
-## [v0.1.0] - 2026-01-17
-
-### What's Changed
-
-
+All notable changes to Codexia will be documented in this file.
 
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
-## [v0.3.0] - 2026-01-17
 
-### What's Changed
+## [0.3.0] - 2026-01-18
 
-- chore: add release workflow for automated versioning and publishing (#11) (d8846d4)
-- feat: add interactive wizard for command selection and execution (#6) (37610b2)
-- feat: Add 12 new analysis modules and MCP server (#4) (d02f673)
-- feat: Add new commands and features to Codexia CLI (#1) (900702f)
-- chore: Add GitHub Actions CI workflow for testing and building (#2) (3370888)
-- Initial commit (02b3f9a)
+### Added
 
+#### 📊 Web Dashboard
+- **Real-time Dashboard** (`codexia dashboard`) — Beautiful, modern web interface for repository visualization
+  - Repository health score with interactive breakdown
+  - Complexity heatmap with clickable file details
+  - Code signals list with severity filtering
+  - Hot paths visualization
+  - Team leaderboard with contributor statistics
+  - GitHub-style commit activity heatmap
+  - Code ownership and bus factor analysis
+  - Branch overview with stale branch detection
+  - Interactive modals with detailed information for all items
+- **Modern Dark Theme** — Vercel-inspired design with smooth animations
+  - Pure black background with subtle neutral accents
+  - Inter + JetBrains Mono typography
+  - Smooth modal open/close animations
+  - Hover effects and micro-interactions
+
+#### 🤖 AI Integration
+- **Multi-Provider AI Support** — Optional AI-powered features with graceful fallback
+  - OpenAI integration (GPT-4, GPT-3.5)
+  - Anthropic integration (Claude)
+  - Ollama integration (local models, free)
+  - Automatic provider detection from environment variables
+  - Graceful fallback when no API keys configured
+
+#### 🌍 Multi-Language Support
+- **Python** — Full symbol extraction, import analysis, complexity metrics
+- **Ruby** — Class, method, and module detection with gem dependencies
+- **Java** — Package imports, class hierarchy, and annotation support
+- **Go** — Package analysis, struct/interface extraction, import detection
+- **Rust** — Mod/use statements, struct/enum/trait/impl detection
 
-All notable changes to Codexia will be documented in this file.
+### Changed
+- Dashboard REST API now includes git statistics endpoints
+- Improved error handling across all API endpoints
+- Enhanced type definitions for multi-language support
 
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+### Technical
+- Added `src/ai/` module with provider abstraction
+- Added `src/languages/` with 6 language providers
+- Added `src/dashboard/` with React + Vite + Tailwind client
+- Native Node.js HTTP server (no Express dependency)
+- Comprehensive TypeScript types for all features
 
-## [Unreleased]
+## [v0.2.0] - 2026-01-17
 
 ### Added
-
-- **Interactive Wizard Mode** — Run `codexia` without arguments to launch an interactive menu-driven experience
-  - 5 command categories: Analyze, Reports, Quality, Testing, Setup
-  - Guided prompts for paths, options, and output formats
-  - Built with `@inquirer/prompts` for a modern CLI experience
+- Interactive wizard mode with guided prompts
+- 12 new analysis modules
+- MCP server for AI assistant integration
 
 ### Fixed
+- Graph command data transformation
+- Changelog auto-detection for repos without tags
+- Hot paths graceful error handling
 
-- **Graph command** — Fixed data transformation to properly generate dependency visualizations
-- **Changelog command** — Auto-detects repository root commit when no tags exist; fixed formatter to handle actual engine output structure
-- **Hot paths command** — Gracefully handles missing entry points and paths data
-- **History command** — Fixed undefined values in summary output with proper fallbacks
+---
 
-## [0.2.0] - 2026-01-13
+## [v0.2.0] - 2026-01-13
 
 ### Added
 

package/README.md

@@ -185,6 +185,72 @@ codexia mcp-server                # Start stdio server (for Claude)
 codexia mcp-server --port 3000    # Start HTTP server
 ```
 
+### 📊 **Web Dashboard**
+
+Beautiful, real-time visualization of your repository health.
+
+```bash
+codexia dashboard                 # Start dashboard server
+codexia dashboard --port 3200     # Custom port
+codexia dashboard --open          # Auto-open in browser
+```
+
+The dashboard provides:
+- **Repository Health Score** — Overall health with breakdown
+- **Complexity Heatmap** — Visual file complexity overview
+- **Code Signals** — Issues ranked by severity
+- **Hot Paths** — Critical areas needing attention
+- **Team Leaderboard** — Contributor stats and activity
+- **Commit Activity** — GitHub-style contribution heatmap
+- **Code Ownership** — Bus factor and knowledge silo risks
+- **Branch Overview** — Active and stale branches
+
+---
+
+## AI Integration
+
+Codexia includes optional AI-powered features for enhanced analysis:
+
+### Configuration
+
+Set your preferred AI provider via environment variables:
+
+```bash
+# OpenAI
+export OPENAI_API_KEY=sk-...
+
+# Anthropic
+export ANTHROPIC_API_KEY=sk-ant-...
+
+# Ollama (local, free)
+export OLLAMA_HOST=http://localhost:11434
+```
+
+### Features
+
+AI integration enables:
+- **Smart commit message generation**
+- **Enhanced code explanations**
+- **Intelligent refactoring suggestions**
+- **Natural language queries** about your codebase
+
+The system gracefully falls back if no API keys are configured—all core analysis features work without AI.
+
+---
+
+## Multi-Language Support
+
+Codexia supports analysis across multiple programming languages:
+
+| Language | Symbols | Dependencies | Complexity |
+|----------|---------|--------------|------------|
+| TypeScript/JavaScript | ✅ | ✅ | ✅ |
+| Python | ✅ | ✅ | ✅ |
+| Ruby | ✅ | ✅ | ✅ |
+| Java | ✅ | ✅ | ✅ |
+| Go | ✅ | ✅ | ✅ |
+| Rust | ✅ | ✅ | ✅ |
+
 ---
 
 ## Installation
@@ -337,6 +403,7 @@ Commands:
   changelog           Generate semantic changelog
   monorepo            Analyze monorepo structure
   mcp-server          Start MCP server for AI tools
+  dashboard           Start web dashboard
 
 Options:
   --json              Output as JSON

package/dist/ai/config.d.ts

@@ -0,0 +1,11 @@
+import type { AIConfig } from './types.js';
+/**
+ * Load AI configuration from environment variables.
+ * Returns null if AI is not configured - this signals graceful fallback.
+ */
+export declare function getAIConfig(): AIConfig | null;
+/**
+ * Check if AI is enabled (has valid configuration)
+ */
+export declare function isAIEnabled(): boolean;
+//# sourceMappingURL=config.d.ts.map

package/dist/ai/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/ai/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C;;;GAGG;AACH,wBAAgB,WAAW,IAAI,QAAQ,GAAG,IAAI,CA+B7C;AAeD;;GAEG;AACH,wBAAgB,WAAW,IAAI,OAAO,CAErC"}

package/dist/ai/config.js

@@ -0,0 +1,51 @@
+/**
+ * Load AI configuration from environment variables.
+ * Returns null if AI is not configured - this signals graceful fallback.
+ */
+export function getAIConfig() {
+    const provider = process.env.CODEXIA_AI_PROVIDER;
+    const apiKey = process.env.CODEXIA_AI_API_KEY;
+    const baseUrl = process.env.CODEXIA_AI_BASE_URL;
+    const model = process.env.CODEXIA_AI_MODEL;
+    // For OpenAI/Anthropic, require API key
+    // For Ollama, just require provider to be set (local, no key needed)
+    if (!provider) {
+        return null;
+    }
+    if (provider === 'ollama') {
+        return {
+            provider,
+            baseUrl: baseUrl || 'http://localhost:11434',
+            model: model || 'llama3',
+        };
+    }
+    // OpenAI and Anthropic require API key
+    if (!apiKey) {
+        return null;
+    }
+    return {
+        provider,
+        apiKey,
+        baseUrl,
+        model: model || getDefaultModel(provider),
+    };
+}
+function getDefaultModel(provider) {
+    switch (provider) {
+        case 'openai':
+            return 'gpt-4o';
+        case 'anthropic':
+            return 'claude-3-5-sonnet-20241022';
+        case 'ollama':
+            return 'llama3';
+        default:
+            return 'gpt-4o';
+    }
+}
+/**
+ * Check if AI is enabled (has valid configuration)
+ */
+export function isAIEnabled() {
+    return getAIConfig() !== null;
+}
+//# sourceMappingURL=config.js.map

package/dist/ai/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/ai/config.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,WAAW;IACzB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAuD,CAAC;IACrF,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC;IAC9C,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAE3C,wCAAwC;IACxC,qEAAqE;IACrE,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,OAAO,IAAI,CAAC;IACd,CAAC;IAED,IAAI,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAC1B,OAAO;YACL,QAAQ;YACR,OAAO,EAAE,OAAO,IAAI,wBAAwB;YAC5C,KAAK,EAAE,KAAK,IAAI,QAAQ;SACzB,CAAC;IACJ,CAAC;IAED,uCAAuC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,QAAQ;QACR,MAAM;QACN,OAAO;QACP,KAAK,EAAE,KAAK,IAAI,eAAe,CAAC,QAAQ,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,QAA8B;IACrD,QAAQ,QAAQ,EAAE,CAAC;QACjB,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB,KAAK,WAAW;YACd,OAAO,4BAA4B,CAAC;QACtC,KAAK,QAAQ;YACX,OAAO,QAAQ,CAAC;QAClB;YACE,OAAO,QAAQ,CAAC;IACpB,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW;IACzB,OAAO,WAAW,EAAE,KAAK,IAAI,CAAC;AAChC,CAAC"}

package/dist/ai/explainer.d.ts

@@ -0,0 +1,32 @@
+import type { AIProvider, AIExplanation } from './types.js';
+import type { ImpactResult } from '../core/types.js';
+import { type PrReportData } from './prompts/pr-review.js';
+import { type PrDescribeData } from './prompts/pr-describe.js';
+/**
+ * AI Explainer - generates natural language explanations for analysis results
+ */
+export declare class AIExplainer {
+    private provider;
+    constructor(provider: AIProvider);
+    /**
+     * Explain impact analysis results in natural language
+     */
+    explainImpact(impact: ImpactResult): Promise<AIExplanation>;
+    /**
+     * Generate AI-powered PR review summary
+     */
+    reviewPr(data: PrReportData): Promise<AIExplanation>;
+    /**
+     * Generate a PR description from commits and impact analysis
+     */
+    describePr(data: PrDescribeData): Promise<string>;
+    /**
+     * Answer a question about the codebase
+     */
+    askQuestion(question: string, context: {
+        architecture?: string;
+        fileContext?: string;
+        dependencies?: string;
+    }): Promise<string>;
+}
+//# sourceMappingURL=explainer.d.ts.map

package/dist/ai/explainer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explainer.d.ts","sourceRoot":"","sources":["../../src/ai/explainer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAErD,OAAO,EAAuB,KAAK,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAChF,OAAO,EAA4B,KAAK,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAEzF;;GAEG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ;gBAAR,QAAQ,EAAE,UAAU;IAExC;;OAEG;IACG,aAAa,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAqBjE;;OAEG;IACG,QAAQ,CAAC,IAAI,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAoB1D;;OAEG;IACG,UAAU,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IA4BvD;;OAEG;IACG,WAAW,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE;QACP,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;KACvB,GACA,OAAO,CAAC,MAAM,CAAC;CAiCnB"}

package/dist/ai/explainer.js

@@ -0,0 +1,118 @@
+import { buildImpactExplanationPrompt } from './prompts/impact-explain.js';
+import { buildPrReviewPrompt } from './prompts/pr-review.js';
+import { buildPrDescriptionPrompt } from './prompts/pr-describe.js';
+/**
+ * AI Explainer - generates natural language explanations for analysis results
+ */
+export class AIExplainer {
+    provider;
+    constructor(provider) {
+        this.provider = provider;
+    }
+    /**
+     * Explain impact analysis results in natural language
+     */
+    async explainImpact(impact) {
+        const prompt = buildImpactExplanationPrompt(impact);
+        try {
+            const summary = await this.provider.complete(prompt, {
+                maxTokens: 500,
+                temperature: 0.3,
+            });
+            return {
+                summary: summary.trim(),
+            };
+        }
+        catch (error) {
+            // Graceful fallback - return empty explanation on error
+            return {
+                summary: '',
+                details: `AI explanation unavailable: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            };
+        }
+    }
+    /**
+     * Generate AI-powered PR review summary
+     */
+    async reviewPr(data) {
+        const prompt = buildPrReviewPrompt(data);
+        try {
+            const summary = await this.provider.complete(prompt, {
+                maxTokens: 800,
+                temperature: 0.4,
+            });
+            return {
+                summary: summary.trim(),
+            };
+        }
+        catch (error) {
+            return {
+                summary: '',
+                details: `AI review unavailable: ${error instanceof Error ? error.message : 'Unknown error'}`,
+            };
+        }
+    }
+    /**
+     * Generate a PR description from commits and impact analysis
+     */
+    async describePr(data) {
+        const prompt = buildPrDescriptionPrompt(data);
+        try {
+            const description = await this.provider.complete(prompt, {
+                maxTokens: 1500,
+                temperature: 0.5,
+            });
+            return description.trim();
+        }
+        catch (error) {
+            // Return a template on error
+            return `## What
+<!-- Describe what this PR does -->
+
+## Why
+<!-- Explain the motivation -->
+
+## How
+<!-- Technical implementation details -->
+
+## Testing
+<!-- How was this tested -->
+
+_AI description generation failed: ${error instanceof Error ? error.message : 'Unknown error'}_`;
+        }
+    }
+    /**
+     * Answer a question about the codebase
+     */
+    async askQuestion(question, context) {
+        const contextParts = [];
+        if (context.architecture) {
+            contextParts.push(`## Project Architecture\n${context.architecture}`);
+        }
+        if (context.fileContext) {
+            contextParts.push(`## Relevant Code\n${context.fileContext}`);
+        }
+        if (context.dependencies) {
+            contextParts.push(`## Dependencies\n${context.dependencies}`);
+        }
+        const prompt = `You are an expert software engineer helping answer questions about a codebase.
+
+${contextParts.join('\n\n')}
+
+## Question
+${question}
+
+Provide a clear, helpful answer based on the context provided. If you don't have enough information to answer accurately, say so.`;
+        try {
+            const answer = await this.provider.complete(prompt, {
+                maxTokens: 1000,
+                temperature: 0.4,
+            });
+            return answer.trim();
+        }
+        catch (error) {
+            return `Unable to answer: ${error instanceof Error ? error.message : 'Unknown error'}`;
+        }
+    }
+}
+//# sourceMappingURL=explainer.js.map

package/dist/ai/explainer.js.map

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

package/dist/ai/index.d.ts

@@ -0,0 +1,23 @@
+export * from './types.js';
+export * from './config.js';
+export * from './provider.js';
+export * from './explainer.js';
+import { isAIEnabled } from './config.js';
+import { AIExplainer } from './explainer.js';
+import type { AIProvider } from './types.js';
+/**
+ * Get the AI provider (singleton, lazy-initialized)
+ * Returns null if AI is not configured
+ */
+export declare function getAIProvider(): AIProvider | null;
+/**
+ * Get the AI explainer (singleton, lazy-initialized)
+ * Returns null if AI is not configured
+ */
+export declare function getAIExplainer(): AIExplainer | null;
+/**
+ * Reset cached provider/explainer (useful for testing)
+ */
+export declare function resetAI(): void;
+export { isAIEnabled };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAGA,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EAAe,WAAW,EAAE,MAAM,aAAa,CAAC;AAEvD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAK7C;;;GAGG;AACH,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAQjD;AAED;;;GAGG;AACH,wBAAgB,cAAc,IAAI,WAAW,GAAG,IAAI,CAQnD;AAED;;GAEG;AACH,wBAAgB,OAAO,IAAI,IAAI,CAG9B;AAGD,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/ai/index.js

@@ -0,0 +1,47 @@
+// AI Module - Graceful AI integration for Codexia
+// If AI is not configured, all functions silently return without errors
+export * from './types.js';
+export * from './config.js';
+export * from './provider.js';
+export * from './explainer.js';
+import { getAIConfig, isAIEnabled } from './config.js';
+import { createProvider } from './provider.js';
+import { AIExplainer } from './explainer.js';
+let cachedProvider = null;
+let cachedExplainer = null;
+/**
+ * Get the AI provider (singleton, lazy-initialized)
+ * Returns null if AI is not configured
+ */
+export function getAIProvider() {
+    if (cachedProvider)
+        return cachedProvider;
+    const config = getAIConfig();
+    if (!config)
+        return null;
+    cachedProvider = createProvider(config);
+    return cachedProvider;
+}
+/**
+ * Get the AI explainer (singleton, lazy-initialized)
+ * Returns null if AI is not configured
+ */
+export function getAIExplainer() {
+    if (cachedExplainer)
+        return cachedExplainer;
+    const provider = getAIProvider();
+    if (!provider)
+        return null;
+    cachedExplainer = new AIExplainer(provider);
+    return cachedExplainer;
+}
+/**
+ * Reset cached provider/explainer (useful for testing)
+ */
+export function resetAI() {
+    cachedProvider = null;
+    cachedExplainer = null;
+}
+// Re-export for convenience
+export { isAIEnabled };
+//# sourceMappingURL=index.js.map

package/dist/ai/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ai/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,wEAAwE;AAExE,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAE/B,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C,IAAI,cAAc,GAAsB,IAAI,CAAC;AAC7C,IAAI,eAAe,GAAuB,IAAI,CAAC;AAE/C;;;GAGG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,cAAc;QAAE,OAAO,cAAc,CAAC;IAE1C,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;IAC7B,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,cAAc,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACxC,OAAO,cAAc,CAAC;AACxB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,cAAc;IAC5B,IAAI,eAAe;QAAE,OAAO,eAAe,CAAC;IAE5C,MAAM,QAAQ,GAAG,aAAa,EAAE,CAAC;IACjC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAE3B,eAAe,GAAG,IAAI,WAAW,CAAC,QAAQ,CAAC,CAAC;IAC5C,OAAO,eAAe,CAAC;AACzB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,OAAO;IACrB,cAAc,GAAG,IAAI,CAAC;IACtB,eAAe,GAAG,IAAI,CAAC;AACzB,CAAC;AAED,4BAA4B;AAC5B,OAAO,EAAE,WAAW,EAAE,CAAC"}

package/dist/ai/prompts/impact-explain.d.ts

@@ -0,0 +1,6 @@
+import type { ImpactResult } from '../../core/types.js';
+/**
+ * Build a prompt for explaining impact analysis results
+ */
+export declare function buildImpactExplanationPrompt(impact: ImpactResult): string;
+//# sourceMappingURL=impact-explain.d.ts.map

package/dist/ai/prompts/impact-explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-explain.d.ts","sourceRoot":"","sources":["../../../src/ai/prompts/impact-explain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAExD;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,YAAY,GAAG,MAAM,CAiDzE"}

package/dist/ai/prompts/impact-explain.js

@@ -0,0 +1,50 @@
+/**
+ * Build a prompt for explaining impact analysis results
+ */
+export function buildImpactExplanationPrompt(impact) {
+    const changedSymbols = impact.directlyChanged
+        .slice(0, 15)
+        .map(c => `- ${c.changeType.toUpperCase()}: ${c.symbol.kind} \`${c.symbol.name}\` in ${c.symbol.filePath}`)
+        .join('\n');
+    const affectedModules = impact.affectedModules
+        .slice(0, 10)
+        .map(m => `- ${m.path} (${m.reason}, distance: ${m.distance})`)
+        .join('\n');
+    const breakingChanges = impact.publicApiChanges
+        .filter(c => c.changeType === 'breaking')
+        .slice(0, 5)
+        .map(c => `- ${c.symbol}: ${c.description}`)
+        .join('\n');
+    const riskFactors = impact.riskScore.factors
+        .slice(0, 5)
+        .map(f => `- ${f.name} (+${f.weight}): ${f.reason}`)
+        .join('\n');
+    return `You are a senior software engineer helping explain code change impact to a development team.
+
+## Analysis Results
+
+**Risk Score:** ${impact.riskScore.overall}/100
+
+### Changed Symbols
+${changedSymbols || 'None detected'}
+
+### Affected Modules (Transitive Impact)
+${affectedModules || 'None - changes are isolated'}
+
+### Breaking API Changes
+${breakingChanges || 'None'}
+
+### Risk Factors
+${riskFactors || 'Low risk change'}
+
+## Your Task
+
+Write a clear, concise explanation (3-5 sentences) that:
+1. Summarizes what was changed and its scope
+2. Highlights the most significant downstream impacts
+3. Notes any breaking changes or high-risk areas
+4. Provides one actionable recommendation
+
+Use plain language that both senior and junior developers can understand. Be specific about file names and module boundaries.`;
+}
+//# sourceMappingURL=impact-explain.js.map

package/dist/ai/prompts/impact-explain.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"impact-explain.js","sourceRoot":"","sources":["../../../src/ai/prompts/impact-explain.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,4BAA4B,CAAC,MAAoB;IAC/D,MAAM,cAAc,GAAG,MAAM,CAAC,eAAe;SAC1C,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,CAAC,IAAI,SAAS,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;SAC1G,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,eAAe,GAAG,MAAM,CAAC,eAAe;SAC3C,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC;SACZ,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,MAAM,eAAe,CAAC,CAAC,QAAQ,GAAG,CAAC;SAC9D,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,eAAe,GAAG,MAAM,CAAC,gBAAgB;SAC5C,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,UAAU,KAAK,UAAU,CAAC;SACxC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,WAAW,EAAE,CAAC;SAC3C,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,MAAM,WAAW,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO;SACzC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC;SACX,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,MAAM,MAAM,CAAC,CAAC,MAAM,EAAE,CAAC;SACnD,IAAI,CAAC,IAAI,CAAC,CAAC;IAEd,OAAO;;;;kBAIS,MAAM,CAAC,SAAS,CAAC,OAAO;;;EAGxC,cAAc,IAAI,eAAe;;;EAGjC,eAAe,IAAI,6BAA6B;;;EAGhD,eAAe,IAAI,MAAM;;;EAGzB,WAAW,IAAI,iBAAiB;;;;;;;;;;8HAU4F,CAAC;AAC/H,CAAC"}

package/dist/ai/prompts/pr-describe.d.ts

@@ -0,0 +1,13 @@
+import type { ImpactResult, CommitInfo } from '../../core/types.js';
+export interface PrDescribeData {
+    commits: CommitInfo[];
+    impact: ImpactResult;
+    filesChanged: number;
+    additions: number;
+    deletions: number;
+}
+/**
+ * Build a prompt for generating a PR description
+ */
+export declare function buildPrDescriptionPrompt(data: PrDescribeData): string;
+//# sourceMappingURL=pr-describe.d.ts.map

package/dist/ai/prompts/pr-describe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pr-describe.d.ts","sourceRoot":"","sources":["../../../src/ai/prompts/pr-describe.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAEpE,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,MAAM,EAAE,YAAY,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,cAAc,GAAG,MAAM,CAgErE"}

package/dist/ai/prompts/pr-describe.js

@@ -0,0 +1,65 @@
+/**
+ * Build a prompt for generating a PR description
+ */
+export function buildPrDescriptionPrompt(data) {
+    const commitMessages = data.commits
+        .slice(0, 20)
+        .map(c => `- ${c.message}`)
+        .join('\n');
+    const changedSymbols = data.impact.directlyChanged
+        .slice(0, 15)
+        .map(c => `- ${c.changeType} ${c.symbol.kind} \`${c.symbol.name}\` in ${c.symbol.filePath}`)
+        .join('\n');
+    const affectedModules = data.impact.affectedModules
+        .slice(0, 10)
+        .map(m => `- ${m.path}: ${m.reason}`)
+        .join('\n');
+    const breakingChanges = data.impact.publicApiChanges
+        .filter(c => c.changeType === 'breaking')
+        .map(c => `- ${c.symbol}: ${c.description}`)
+        .join('\n');
+    return `You are helping a developer write a professional pull request description.
+
+## Commits in this PR
+${commitMessages || 'No commits yet'}
+
+## Code Statistics
+- **Files Changed:** ${data.filesChanged}
+- **Lines:** +${data.additions} / -${data.deletions}
+
+## Symbols Changed
+${changedSymbols || 'No significant symbol changes'}
+
+## Affected Modules
+${affectedModules || 'Changes are self-contained'}
+
+## Breaking Changes
+${breakingChanges || 'None'}
+
+## Your Task
+
+Generate a well-structured PR description in Markdown with these sections:
+
+## What
+A brief 1-2 sentence summary of what this PR does.
+
+## Why
+The motivation and context for these changes (infer from commit messages and code changes).
+
+## How
+A technical explanation of the implementation approach.
+
+## Testing
+What testing was done or should be done (infer from file patterns).
+
+## Breaking Changes
+List any breaking changes, or state "None" if there are none.
+
+## Checklist
+- [ ] Tests added/updated
+- [ ] Documentation updated
+- [ ] No breaking changes (or documented above)
+
+Be specific and technical. Use bullet points where appropriate.`;
+}
+//# sourceMappingURL=pr-describe.js.map