ai-first-cli 1.3.6 → 1.3.8

package/tests/v1.3.8-integration.test.ts

@@ -0,0 +1,361 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { loadConfig, getPreset, listPresets } from '../src/config/configLoader.js';
+import { processContent, classifyFile } from '../src/core/content/contentProcessor.js';
+import { getGitBlame, formatGitBlame } from '../src/core/gitAnalyzer.js';
+import { createVectorIndex, semanticSearch } from '../src/core/rag/vectorIndex.js';
+import { scanMultiRepo, generateMultiRepoReport } from '../src/core/multiRepo/multiRepoScanner.js';
+import { detectTechStack } from '../src/analyzers/techStack.js';
+import type { FileInfo } from '../src/core/repoScanner.js';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+describe('v1.3.8 Features Integration Tests', () => {
+  const testDir = path.join(__dirname, 'test-temp-v138');
+
+  beforeEach(() => {
+    if (!fs.existsSync(testDir)) {
+      fs.mkdirSync(testDir, { recursive: true });
+    }
+  });
+
+  afterEach(() => {
+    if (fs.existsSync(testDir)) {
+      fs.rmSync(testDir, { recursive: true, force: true });
+    }
+  });
+
+  describe('Config System', () => {
+    it('should load default config when file does not exist', () => {
+      const result = loadConfig({ configPath: path.join(testDir, 'non-existent.json') });
+      expect(result.config).toBeDefined();
+      expect(result.source).toBe('default');
+    });
+
+    it('should load config from file', () => {
+      const configPath = path.join(testDir, 'ai-first.config.json');
+      fs.writeFileSync(configPath, JSON.stringify({
+        version: '1.0',
+        output: { directory: 'custom-ai' }
+      }));
+
+      const result = loadConfig({ configPath });
+      expect(result.source).toBe('file');
+      expect(result.config.output?.directory).toBe('custom-ai');
+    });
+
+    it('should apply preset configuration', () => {
+      const result = loadConfig({
+        configPath: path.join(testDir, 'non-existent.json'),
+        preset: 'quick'
+      });
+      expect(result.source).toBe('preset');
+    });
+
+    it('should override config with overrides', () => {
+      const configPath = path.join(testDir, 'ai-first.config.json');
+      fs.writeFileSync(configPath, JSON.stringify({
+        version: '1.0',
+        output: { directory: 'from-file', formats: ['md'], prettyPrint: false }
+      }));
+
+      const result = loadConfig({
+        configPath,
+        overrides: {
+          output: { directory: 'override', formats: ['md'], prettyPrint: true }
+        }
+      });
+
+      expect(result.config.output?.directory).toBe('override');
+      expect(result.config.output?.prettyPrint).toBe(true);
+    });
+
+    it('should list all 4 builtin presets', () => {
+      const presets = listPresets();
+      expect(presets.length).toBeGreaterThanOrEqual(4);
+      expect(presets.some(p => p.name === 'full')).toBe(true);
+      expect(presets.some(p => p.name === 'quick')).toBe(true);
+      expect(presets.some(p => p.name === 'api')).toBe(true);
+      expect(presets.some(p => p.name === 'docs')).toBe(true);
+    });
+
+    it('should get preset by name', () => {
+      const preset = getPreset('quick');
+      expect(preset).toBeDefined();
+      expect(preset?.name).toBe('quick');
+    });
+  });
+
+  describe('Content Processing', () => {
+    it('should compress code with signatures mode', () => {
+      const code = `
+/**
+ * Test function
+ */
+export function test(x: number): number {
+  const result = x * 2;
+  return result;
+}
+`;
+      const result = processContent(code, { detailLevel: 'signatures' });
+      expect(result.compressionRatio).toBeGreaterThan(0);
+      expect(result.tokens).toBeLessThan(code.length / 4);
+    });
+
+    it('should not compress with full mode', () => {
+      const code = 'function test() { return 42; }';
+      const result = processContent(code, { detailLevel: 'full' });
+      expect(result.compressionRatio).toBe(0);
+      expect(result.processedLength).toBe(code.length);
+    });
+
+    it('should extract signatures from TypeScript', () => {
+      const code = `
+export function calculateTotal(items: CartItem[]): number {
+  return items.reduce((sum, item) => sum + item.price, 0);
+}
+
+export interface CartItem {
+  price: number;
+  quantity: number;
+}
+`;
+      const result = processContent(code, { detailLevel: 'signatures' });
+      expect(result.content).toContain('calculateTotal');
+      expect(result.content).toContain('interface CartItem');
+      expect(result.compressionRatio).toBeGreaterThan(40);
+    });
+
+    it('should classify files correctly', () => {
+      expect(classifyFile('test.spec.js', ['src/**/*'], [], [], ['**/*.spec.js'])).toBe('exclude');
+      expect(classifyFile('node_modules/lodash/index.js', ['src/**/*'], ['node_modules/**/*'], [], [])).toBe('compress');
+    });
+  });
+
+  describe('Git Blame', () => {
+    it('should return blame info for a file', () => {
+      const result = getGitBlame('.', 'package.json');
+      expect(result.filePath).toBe('package.json');
+      expect(result.lines).toBeDefined();
+      expect(result.lines.length).toBeGreaterThan(0);
+    });
+
+    it('should return authors map', () => {
+      const result = getGitBlame('.', 'package.json');
+      expect(result.authors).toBeInstanceOf(Map);
+      expect(result.authors.size).toBeGreaterThan(0);
+    });
+
+    it('should format blame as inline', () => {
+      const blame = getGitBlame('.', 'package.json');
+      const formatted = formatGitBlame(blame, 'inline');
+      expect(formatted).toContain('[');
+      expect(formatted).toContain(']');
+      expect(formatted.split('\n').length).toBeGreaterThan(1);
+    });
+
+    it('should format blame as block', () => {
+      const blame = getGitBlame('.', 'package.json');
+      const formatted = formatGitBlame(blame, 'block');
+      expect(formatted).toContain('//');
+    });
+  });
+
+  describe('RAG Vector Search', () => {
+    it('should create vector index', () => {
+      const indexPath = path.join(testDir, 'vector-index.json');
+      const index = createVectorIndex(indexPath);
+      expect(index).toBeDefined();
+      expect(typeof index.addDocument).toBe('function');
+    });
+
+    it('should add and search documents', () => {
+      const indexPath = path.join(testDir, 'vector-index.json');
+      const index = createVectorIndex(indexPath);
+
+      index.addDocument({
+        id: '1',
+        content: 'function authenticateUser() { }',
+        embedding: Array(100).fill(0).map((_, i) => Math.sin(i * 0.1)),
+        metadata: { filePath: 'auth.js', type: 'function' }
+      });
+
+      index.addDocument({
+        id: '2',
+        content: 'function processPayment() { }',
+        embedding: Array(100).fill(0).map((_, i) => Math.cos(i * 0.1)),
+        metadata: { filePath: 'payment.js', type: 'function' }
+      });
+
+      const results = semanticSearch(index, 'user authentication', 2);
+      expect(results).toHaveLength(2);
+      expect(results[0].score).toBeGreaterThan(0);
+      expect(results[0].document).toBeDefined();
+    });
+
+    it('should save and load index', () => {
+      const indexPath = path.join(testDir, 'vector-index.json');
+      const index = createVectorIndex(indexPath);
+
+      index.addDocument({
+        id: '1',
+        content: 'test',
+        embedding: Array(100).fill(0.5),
+        metadata: { filePath: 'test.js' }
+      });
+
+      index.save();
+      expect(fs.existsSync(indexPath)).toBe(true);
+
+      const index2 = createVectorIndex(indexPath);
+      const results = semanticSearch(index2, 'test', 1);
+      expect(results).toHaveLength(1);
+    });
+  });
+
+  describe('Multi-Repository', () => {
+    it('should scan current repository', () => {
+      const context = scanMultiRepo({ repositories: ['.'] });
+      expect(context.repositories).toHaveLength(1);
+      expect(context.totalFiles).toBeGreaterThan(0);
+      expect(context.repositories[0].files.length).toBeGreaterThan(0);
+    });
+
+    it('should generate markdown report', () => {
+      const context = scanMultiRepo({ repositories: ['.'] });
+      const report = generateMultiRepoReport(context);
+      expect(report).toContain('# Multi-Repository Context');
+      expect(report).toContain('## Summary');
+      expect(report).toContain('## Repositories');
+    });
+
+    it('should detect multiple repositories', () => {
+      const repo1 = path.join(testDir, 'repo1');
+      const repo2 = path.join(testDir, 'repo2');
+      fs.mkdirSync(repo1, { recursive: true });
+      fs.mkdirSync(repo2, { recursive: true });
+      fs.writeFileSync(path.join(repo1, 'file1.js'), '');
+      fs.writeFileSync(path.join(repo2, 'file2.js'), '');
+
+      const context = scanMultiRepo({ repositories: [repo1, repo2] });
+      expect(context.repositories).toHaveLength(2);
+      expect(context.totalFiles).toBe(2);
+    });
+  });
+
+  describe('Django Detection (v1.3.8)', () => {
+    const DJANGO_PROJECT = path.join(__dirname, '..', 'test-projects', 'django-app');
+
+    it('should detect Django framework from Python project', () => {
+      const files: FileInfo[] = [
+        { path: 'blog/models.py', relativePath: 'blog/models.py', name: 'models.py', extension: 'py' },
+        { path: 'blog/views.py', relativePath: 'blog/views.py', name: 'views.py', extension: 'py' },
+        { path: 'users/models.py', relativePath: 'users/models.py', name: 'models.py', extension: 'py' }
+      ];
+      const techStack = detectTechStack(files, DJANGO_PROJECT);
+      expect(techStack.frameworks).toContain('Django');
+    });
+
+    it('should detect Django from requirements.txt', () => {
+      const techStackPath = path.join(DJANGO_PROJECT, 'ai-context', 'tech_stack.md');
+      expect(fs.existsSync(techStackPath)).toBe(true);
+      
+      const content = fs.readFileSync(techStackPath, 'utf-8').toLowerCase();
+      expect(content).toContain('django');
+    });
+
+    it('should include Django in tech_stack.md frameworks section', () => {
+      const techStackPath = path.join(DJANGO_PROJECT, 'ai-context', 'tech_stack.md');
+      const content = fs.readFileSync(techStackPath, 'utf-8');
+      expect(content).toMatch(/## Frameworks\n[\s\S]*- Django/);
+    });
+
+    it('should generate ai_context.md with Django context', () => {
+      const aiContextPath = path.join(DJANGO_PROJECT, 'ai-context', 'ai_context.md');
+      expect(fs.existsSync(aiContextPath)).toBe(true);
+      
+      const content = fs.readFileSync(aiContextPath, 'utf-8').toLowerCase();
+      expect(content).toContain('django');
+    });
+  });
+
+  // MCP Integration tests removed - MCP command does not exist yet
+  // TODO(julian): Add MCP tests when the feature is implemented
+
+  describe('Config Presets (v1.3.8)', () => {
+    it('should have preset available: full', () => {
+      const preset = getPreset('full');
+      expect(preset).toBeDefined();
+      expect(preset?.name).toBe('full');
+    });
+
+    it('should have preset available: quick', () => {
+      const preset = getPreset('quick');
+      expect(preset).toBeDefined();
+      expect(preset?.name).toBe('quick');
+    });
+
+    it('should have preset available: api', () => {
+      const preset = getPreset('api');
+      expect(preset).toBeDefined();
+      expect(preset?.name).toBe('api');
+    });
+
+    it('should have preset available: docs', () => {
+      const preset = getPreset('docs');
+      expect(preset).toBeDefined();
+      expect(preset?.name).toBe('docs');
+    });
+
+    it('should list at least 4 presets', () => {
+      const presets = listPresets();
+      expect(presets.length).toBeGreaterThanOrEqual(4);
+    });
+
+    it('should apply preset to config', () => {
+      const result = loadConfig({
+        configPath: path.join(testDir, 'non-existent.json'),
+        preset: 'full'
+      });
+      expect(result.source).toBe('preset');
+      expect(result.config).toBeDefined();
+    });
+  });
+
+  describe('Git Blame Integration (v1.3.8)', () => {
+    it('should return blame info for a file', () => {
+      const result = getGitBlame('.', 'package.json');
+      expect(result.filePath).toBe('package.json');
+      expect(result.lines).toBeDefined();
+      expect(result.lines.length).toBeGreaterThan(0);
+    });
+
+    it('should return authors with contributions', () => {
+      const result = getGitBlame('.', 'package.json');
+      expect(result.authors).toBeInstanceOf(Map);
+      expect(result.authors.size).toBeGreaterThan(0);
+    });
+
+    it('should format blame as inline', () => {
+      const blame = getGitBlame('.', 'package.json');
+      const formatted = formatGitBlame(blame, 'inline');
+      expect(formatted).toContain('[');
+      expect(formatted).toContain(']');
+    });
+
+    it('should format blame as block', () => {
+      const blame = getGitBlame('.', 'package.json');
+      const formatted = formatGitBlame(blame, 'block');
+      expect(formatted).toContain('//');
+    });
+
+    it('should include blame info in summary', () => {
+      const blame = getGitBlame('.', 'package.json');
+      const formatted = formatGitBlame(blame, 'inline');
+      expect(formatted).toContain('\n');
+    });
+  });
+});

package/ai-context-evaluation-report-1774223059505.md

@@ -1,206 +0,0 @@
-# AI-Context Evaluation Report
-
-Generated: 2026-03-22T23:44:19.504Z
-
-## Summary
-
-| Project | Type | Index DB | Avg Score | Key Issue |
-|---------|------|----------|-----------|-----------|
-| salesforce-cli | priority | ✅ | 2.0 | Fix tech_stack.md to recognize Apex/Sale... |
-| ai-first-cli | supported | ❌ | 2.9 | Refactor architecture.md to group src/ i... |
-| express-api | supported | ✅ | 2.9 | Fix critical inaccuracies: remove 'Conta... |
-| nestjs-backend | supported | ✅ | 2.8 | Correct framework detection to NestJS wi... |
-| python-cli | supported | ✅ | 2.3 | Fix critical architecture classification... |
-| spring-boot-app | supported | ✅ | 2.6 | Fix Spring Boot framework detection and ... |
-| android-kotlin-app | unsupported | ❌ | 2.3 | Detect and index standard Android projec... |
-| ios-swift-app | unsupported | ❌ | 2.7 | Validate dependencies against actual rep... |
-| go-microservice | unsupported | ❌ | 2.0 | Extract and document actual code content... |
-| rust-cli | unsupported | ❌ | 2.1 | Parse and include main.rs content (funct... |
-| php-vanilla | unsupported | ❌ | 2.5 | Include actual source code content or de... |
-
-## Detailed Findings
-
-### salesforce-cli
-
-- **Type:** priority
-- **Index DB:** Yes
-- **Model Scores:**
-  - Kimi K2.5: 1.75/5
-  - GLM 5: 2.25/5
-  - MiniMax 2.7: 2/5
-- **Top Improvements:**
-  - Fix tech_stack.md to recognize Apex/Salesforce platform and add Salesforce-specific patterns (Trigger framework, SOQL, Governor Limits)
-  - Populate entrypoints.md with actual class methods, trigger events, and API endpoints
-  - Add business logic context describing what AccountController and OpportunityController do functionally (CRUD operations, integrations, validation logic)
-  - Detect and list Apex as the primary language in tech_stack.md
-  - Identify Apex classes and triggers as entrypoints in entrypoints.md
-
-### ai-first-cli
-
-- **Type:** supported
-- **Index DB:** No
-- **Model Scores:**
-  - Kimi K2.5: 2.25/5
-  - GLM 5: 3.25/5
-  - MiniMax 2.7: 3.25/5
-- **Top Improvements:**
-  - Refactor architecture.md to group src/ into functional modules (Commands, Adapters, Parsers, Indexer) instead of listing every file as a module
-  - Add explicit 'What This Project Does' overview explaining the AI context generation pipeline
-  - Separate test-projects fixtures from source analysis to prevent 684 fixture files from obscuring 63 actual source files
-  - Fix architecture detection to ignore root-level documentation files and focus on actual source directories.
-  - Implement dependency parsing to correctly identify and list key libraries and testing frameworks.
-
-### express-api
-
-- **Type:** supported
-- **Index DB:** Yes
-- **Model Scores:**
-  - Kimi K2.5: 2.8/5
-  - GLM 5: 3.5/5
-  - MiniMax 2.7: 2.5/5
-- **Top Improvements:**
-  - Fix critical inaccuracies: remove 'Contains 0 files' entries and correct architecture pattern (remove Microservices)
-  - Add API contract specifications including endpoints, methods, and data models/schemas
-  - Include actual code interfaces or summaries for key files (controllers/services) rather than just directory listings
-  - Fix 'Contains 0 files' entries to describe actual file responsibilities (index.js is main entry point, package.json defines dependencies and scripts)
-  - Add missing conventions.md and ai_rules.md files that are referenced in ai_context.md
-
-### nestjs-backend
-
-- **Type:** supported
-- **Index DB:** Yes
-- **Model Scores:**
-  - Kimi K2.5: 2.8/5
-  - GLM 5: 2.75/5
-  - MiniMax 2.7: 2.7/5
-- **Top Improvements:**
-  - Correct framework detection to NestJS with Modular architecture pattern
-  - Document API endpoints and authentication flows from the indexed controller files
-  - Add separation between AI metadata (ai/) and source code analysis in architectural descriptions
-  - Fix framework detection to properly identify NestJS and include its patterns/decorators in documentation
-  - Replace vague 'Contains X files' module descriptions with actual responsibilities and key exports
-
-### python-cli
-
-- **Type:** supported
-- **Index DB:** Yes
-- **Model Scores:**
-  - Kimi K2.5: 2.25/5
-  - GLM 5: 2.75/5
-  - MiniMax 2.7: 2/5
-- **Top Improvements:**
-  - Fix critical architecture classification: distinguish files from directories and map MVC pattern to actual codebase components (cli commands as controllers)
-  - Populate entrypoints.md with actual function signatures, CLI command names, and registration patterns from main.py
-  - Add project-specific AI instructions: exact steps to add commands, extend Task model, and use the repository pattern
-  - Populate entrypoints.md with the main execution path and CLI usage examples.
-  - Enhance tech_stack.md to detect imported libraries (e.g., argparse, json) instead of reporting 'None detected'.
-
-### spring-boot-app
-
-- **Type:** supported
-- **Index DB:** Yes
-- **Model Scores:**
-  - Kimi K2.5: 2.25/5
-  - GLM 5: 3/5
-  - MiniMax 2.7: 2.5/5
-- **Top Improvements:**
-  - Fix Spring Boot framework detection and correct architecture to Layered pattern
-  - Populate entrypoints.md with DemoApplication main class and all REST controller endpoints
-  - Analyze and document JPA entities (Post, User, Comment) and their relationships in features/
-  - Detect Spring Boot framework to ensure correct code generation
-  - Populate entrypoints.md with the main application class and controllers
-
-### android-kotlin-app
-
-- **Type:** unsupported
-- **Index DB:** No
-- **Model Scores:**
-  - Kimi K2.5: 2.5/5
-  - GLM 5: 3/5
-  - MiniMax 2.7: 1.5/5
-- **Top Improvements:**
-  - Detect and index standard Android project files (manifest, build configs, resources) that appear to be missing
-  - Populate entrypoints with actual Android components and their intents/lifecycles
-  - Consolidate redundant descriptions and remove empty sections to optimize token usage for actionable technical details
-  - Detect Android framework and Gradle build system to populate tech_stack.md.
-  - Populate entrypoints.md with the main Activity and Application class.
-
-### ios-swift-app
-
-- **Type:** unsupported
-- **Index DB:** No
-- **Model Scores:**
-  - Kimi K2.5: 2.3/5
-  - GLM 5: 3/5
-  - MiniMax 2.7: 2.75/5
-- **Top Improvements:**
-  - Validate dependencies against actual repo contents (remove phantom service/model/util layers)
-  - Include actual source code snippets or struct definitions from ContentView.swift
-  - Consolidate 6 fragmented files into 2-3 focused documents (overview, architecture, conventions)
-  - Remove hallucinated dependencies (service, model, util) from architecture.md as they do not exist in the repo map
-  - Detect and list SwiftUI as the framework (inferred from ContentView.swift) instead of 'None detected'
-
-### go-microservice
-
-- **Type:** unsupported
-- **Index DB:** No
-- **Model Scores:**
-  - Kimi K2.5: 1.75/5
-  - GLM 5: 2.75/5
-  - MiniMax 2.7: 1.5/5
-- **Top Improvements:**
-  - Extract and document actual code content (functions, types, imports) from main.go instead of just counting it
-  - Fix factual errors: correct Go naming conventions (snake_case), remove semicolon requirement, fix 'contains 0 files' logic
-  - Populate entrypoints.md with service endpoints, ports, and request handlers, or analyze go.mod to detect actual frameworks used
-  - Populate entrypoints.md with specific run/build commands for the Go application.
-  - Fix architecture.md to correctly identify main.go as a file, not a container, and remove confusing '0 files' descriptions.
-
-### rust-cli
-
-- **Type:** unsupported
-- **Index DB:** No
-- **Model Scores:**
-  - Kimi K2.5: 1.8/5
-  - GLM 5: 3/5
-  - MiniMax 2.7: 1.5/5
-- **Top Improvements:**
-  - Parse and include main.rs content (functions, structs, CLI args) to enable code generation
-  - Add Cargo.toml analysis with dependencies and feature flags critical for Rust development
-  - Consolidate fragmented files and remove empty placeholders to reduce context window waste
-  - Fix incorrect file naming convention (camelCase -> snake_case)
-  - Detect and include Cargo.toml and cargo package manager
-
-### php-vanilla
-
-- **Type:** unsupported
-- **Index DB:** No
-- **Model Scores:**
-  - Kimi K2.5: 2.2/5
-  - GLM 5: 3.75/5
-  - MiniMax 2.7: 1.5/5
-- **Top Improvements:**
-  - Include actual source code content or detailed API summary of index.php
-  - Remove incorrect statements about file contents and empty generic sections
-  - Add functional description of application purpose and behavior
-  - Populate entrypoints.md to identify index.php as the primary entry point.
-  - Refine architecture.md to describe file responsibilities rather than stating 'Contains 0 files'.
-
-## Cross-Project Analysis
-
-### 🎯 Priority Projects (Salesforce)
-- Average score: 2.0
-- Key findings: See detailed section above
-- Salesforce-specific insights: Apex classes, triggers, and SObject metadata handling
-
-### Supported Projects
-- Average score: 2.7
-- Common issues: None
-
-### Unsupported Projects
-- Average score: 2.3
-- Common issues: None
-
-### Key Insights
-1. **Salesforce Priority**: Detailed analysis of Apex, triggers, and metadata
-2. Index DB impact on quality: Projects with Index DB show...
-3. Unsupported projects: Generic analysis provides value but lacks framework-specific insights