codehere 0.2.1 → 0.3.0-rc.1

package/dist/context.js

@@ -1,187 +0,0 @@
-/**
- * Enhanced Context Understanding System
- * Senior-level codebase comprehension with file relationships
- */
-import { readFileSync, existsSync } from 'fs';
-import { join, dirname, extname } from 'path';
-import { searchSimilar } from './search.js';
-/**
- * Extract imports/exports from code
- */
-export function extractImports(content, filepath) {
-    const imports = [];
-    const lines = content.split('\n');
-    const ext = extname(filepath).toLowerCase();
-    // TypeScript/JavaScript imports
-    if (['.ts', '.tsx', '.js', '.jsx'].includes(ext)) {
-        for (const line of lines) {
-            // ES6 imports
-            const es6Match = line.match(/import\s+(?:.*\s+from\s+)?['"]([^'"]+)['"]/);
-            if (es6Match) {
-                imports.push(es6Match[1]);
-            }
-            // CommonJS requires
-            const requireMatch = line.match(/require\(['"]([^'"]+)['"]\)/);
-            if (requireMatch) {
-                imports.push(requireMatch[1]);
-            }
-        }
-    }
-    // Python imports
-    if (ext === '.py') {
-        for (const line of lines) {
-            const importMatch = line.match(/^(?:from\s+(\S+)\s+)?import\s+(\S+)/);
-            if (importMatch) {
-                imports.push(importMatch[1] || importMatch[2]);
-            }
-        }
-    }
-    return imports;
-}
-/**
- * Extract exports from code
- */
-export function extractExports(content, filepath) {
-    const exports = [];
-    const lines = content.split('\n');
-    const ext = extname(filepath).toLowerCase();
-    // TypeScript/JavaScript exports
-    if (['.ts', '.tsx', '.js', '.jsx'].includes(ext)) {
-        for (const line of lines) {
-            // Named exports
-            const namedExport = line.match(/export\s+(?:const|function|class|interface|type|enum)\s+(\w+)/);
-            if (namedExport) {
-                exports.push(namedExport[1]);
-            }
-            // Default export
-            if (line.includes('export default')) {
-                exports.push('default');
-            }
-        }
-    }
-    return exports;
-}
-/**
- * Build file relationship map
- */
-export async function buildFileRelationships(filepaths, baseDir) {
-    const relationships = new Map();
-    for (const filepath of filepaths) {
-        const fullPath = join(baseDir, filepath);
-        if (!existsSync(fullPath)) {
-            continue;
-        }
-        try {
-            const content = readFileSync(fullPath, 'utf-8');
-            const imports = extractImports(content, filepath);
-            const exports = extractExports(content, filepath);
-            relationships.set(filepath, {
-                filepath,
-                imports,
-                exports,
-                dependencies: [],
-                dependents: [],
-            });
-        }
-        catch (error) {
-            // Skip files that can't be read
-            continue;
-        }
-    }
-    // Build dependency graph
-    for (const [filepath, relationship] of relationships.entries()) {
-        for (const imp of relationship.imports) {
-            // Try to resolve import to actual file
-            // This is simplified - real implementation would resolve module paths
-            for (const [otherPath, otherRel] of relationships.entries()) {
-                if (otherPath !== filepath && (otherPath.includes(imp) || imp.includes(otherPath))) {
-                    relationship.dependencies.push(otherPath);
-                    if (!otherRel.dependents.includes(filepath)) {
-                        otherRel.dependents.push(filepath);
-                    }
-                }
-            }
-        }
-    }
-    return relationships;
-}
-/**
- * Get enhanced context with file relationships
- */
-export async function getEnhancedContext(query, options = {}) {
-    const { primaryChunks = 15, relatedChunks = 5, includeRelationships = true, } = options;
-    // Get primary search results
-    const primaryResults = await searchSimilar(query, primaryChunks);
-    // Get unique filepaths
-    const filepaths = [...new Set(primaryResults.map(r => r.filepath))];
-    // Build file relationships if requested
-    let fileRelationships = new Map();
-    let dependencyGraph = new Map();
-    if (includeRelationships && filepaths.length > 0) {
-        // Get base directory from first file
-        const baseDir = dirname(filepaths[0]);
-        fileRelationships = await buildFileRelationships(filepaths, baseDir);
-        // Build dependency graph
-        for (const [filepath, relationship] of fileRelationships.entries()) {
-            dependencyGraph.set(filepath, relationship.dependencies);
-        }
-        // Get related chunks from dependent files
-        const dependentFiles = new Set();
-        for (const relationship of fileRelationships.values()) {
-            relationship.dependents.forEach(dep => dependentFiles.add(dep));
-        }
-        // Search for related chunks in dependent files
-        const relatedQueries = Array.from(dependentFiles).slice(0, 3);
-        const relatedResults = [];
-        for (const relatedQuery of relatedQueries) {
-            const results = await searchSimilar(relatedQuery, Math.ceil(relatedChunks / relatedQueries.length));
-            relatedResults.push(...results);
-        }
-        // Combine and deduplicate
-        const allChunks = [...primaryResults, ...relatedResults];
-        const seen = new Set();
-        const uniqueChunks = allChunks.filter(chunk => {
-            const key = `${chunk.filepath}:${chunk.content.substring(0, 50)}`;
-            if (seen.has(key)) {
-                return false;
-            }
-            seen.add(key);
-            return true;
-        });
-        return {
-            primaryChunks: primaryResults,
-            relatedChunks: uniqueChunks.slice(primaryChunks),
-            fileRelationships,
-            dependencyGraph,
-            totalChunks: uniqueChunks.length,
-        };
-    }
-    return {
-        primaryChunks: primaryResults,
-        relatedChunks: [],
-        fileRelationships,
-        dependencyGraph,
-        totalChunks: primaryResults.length,
-    };
-}
-/**
- * Format context for display
- */
-export function formatContext(context) {
-    let output = `Found ${context.totalChunks} relevant chunks from ${context.primaryChunks.length} primary files.\n\n`;
-    if (context.fileRelationships.size > 0) {
-        output += 'File Relationships:\n';
-        for (const [filepath, relationship] of context.fileRelationships.entries()) {
-            output += `  ${filepath}:\n`;
-            if (relationship.dependencies.length > 0) {
-                output += `    Dependencies: ${relationship.dependencies.join(', ')}\n`;
-            }
-            if (relationship.dependents.length > 0) {
-                output += `    Dependents: ${relationship.dependents.join(', ')}\n`;
-            }
-        }
-        output += '\n';
-    }
-    return output;
-}
-//# sourceMappingURL=context.js.map

package/dist/docs.js

@@ -1,146 +0,0 @@
-/**
- * Documentation Generator
- * Auto-generate and maintain documentation
- */
-import { readFileSync, writeFileSync, existsSync, mkdirSync } from 'fs';
-import { join, dirname } from 'path';
-import { chatWithContext } from './chat.js';
-import { getEnhancedContext } from './context.js';
-/**
- * Generate documentation for a file
- */
-export async function generateFileDocs(filepath) {
-    const fullPath = join(process.cwd(), filepath);
-    if (!existsSync(fullPath)) {
-        throw new Error(`File not found: ${filepath}`);
-    }
-    const content = readFileSync(fullPath, 'utf-8');
-    const ext = filepath.split('.').pop()?.toLowerCase() || '';
-    // Get context
-    const context = await getEnhancedContext(`Generate documentation for ${filepath}`, {
-        primaryChunks: 10,
-        includeRelationships: true,
-    });
-    // Create documentation prompt
-    const docPrompt = `Generate comprehensive documentation for this code file:
-
-File: ${filepath}
-Code:
-\`\`\`${ext}
-${content}
-\`\`\`
-
-Provide:
-1. File overview and purpose
-2. Main functions/classes and their purposes
-3. Parameters and return values
-4. Usage examples
-5. Important notes or warnings
-
-Format as clear markdown documentation.`;
-    const contextResults = [{
-            filepath,
-            content,
-            score: 1.0,
-        }, ...context.primaryChunks];
-    const docs = await chatWithContext(docPrompt, contextResults);
-    return docs;
-}
-/**
- * Generate README for a project
- */
-export async function generateREADME(files) {
-    // Get project context
-    const context = await getEnhancedContext('Generate project README documentation', {
-        primaryChunks: 30,
-        includeRelationships: true,
-    });
-    const fileList = files || context.primaryChunks.map(c => c.filepath);
-    const fileContents = fileList
-        .slice(0, 10)
-        .map(f => {
-        try {
-            const content = readFileSync(join(process.cwd(), f), 'utf-8');
-            return `\n### ${f}\n\`\`\`\n${content.substring(0, 200)}...\n\`\`\``;
-        }
-        catch {
-            return '';
-        }
-    })
-        .join('\n');
-    const readmePrompt = `Generate a comprehensive README.md for this project:
-
-Key files:
-${fileList.slice(0, 20).map(f => `- ${f}`).join('\n')}
-
-${fileContents}
-
-Create a professional README with:
-1. Project title and description
-2. Features
-3. Installation instructions
-4. Usage examples
-5. Project structure
-6. Contributing guidelines
-7. License information
-
-Format as markdown.`;
-    const contextResults = context.primaryChunks;
-    const readme = await chatWithContext(readmePrompt, contextResults);
-    return readme;
-}
-/**
- * Update existing documentation
- */
-export async function updateDocs(filepath) {
-    const fullPath = join(process.cwd(), filepath);
-    if (!existsSync(fullPath)) {
-        throw new Error(`File not found: ${filepath}`);
-    }
-    const currentContent = readFileSync(fullPath, 'utf-8');
-    const codePath = filepath.replace(/\.md$/, '').replace(/docs\//, '');
-    // Get current code
-    let codeContent = '';
-    try {
-        const codeFile = join(process.cwd(), codePath);
-        if (existsSync(codeFile)) {
-            codeContent = readFileSync(codeFile, 'utf-8');
-        }
-    }
-    catch {
-        // Code file might not exist
-    }
-    const updatePrompt = `Update this documentation to match the current code:
-
-Documentation file: ${filepath}
-Current docs:
-\`\`\`
-${currentContent}
-\`\`\`
-
-Current code:
-\`\`\`
-${codeContent.substring(0, 1000)}
-\`\`\`
-
-Update the documentation to accurately reflect the current code implementation.`;
-    const contextResults = [{
-            filepath,
-            content: currentContent,
-            score: 1.0,
-        }];
-    const updatedDocs = await chatWithContext(updatePrompt, contextResults);
-    return updatedDocs;
-}
-/**
- * Save documentation to file
- */
-export function saveDocs(filepath, content) {
-    const fullPath = join(process.cwd(), filepath);
-    const dir = dirname(fullPath);
-    if (!existsSync(dir)) {
-        mkdirSync(dir, { recursive: true });
-    }
-    writeFileSync(fullPath, content, 'utf-8');
-}
-//# sourceMappingURL=docs.js.map

package/dist/domain/entities/code-chunk.js

@@ -1,6 +0,0 @@
-/**
- * Domain Entity: CodeChunk
- * Represents a code snippet with metadata
- */
-export {};
-//# sourceMappingURL=code-chunk.js.map

package/dist/domain/entities/decision.js

@@ -1,9 +0,0 @@
-/**
- * Domain Entity: Decision
- * Represents an architectural or design decision
- *
- * Clean Architecture: Domain Layer
- * Purpose: Capture decision rationale for organizational memory
- */
-export {};
-//# sourceMappingURL=decision.js.map

package/dist/domain/entities/edit.js

@@ -1,6 +0,0 @@
-/**
- * Domain Entity: Edit
- * Represents a code edit operation
- */
-export {};
-//# sourceMappingURL=edit.js.map

package/dist/domain/entities/knowledge-node.js

@@ -1,9 +0,0 @@
-/**
- * Domain Entity: KnowledgeNode
- * Represents a node in the knowledge graph
- *
- * Clean Architecture: Domain Layer
- * Purpose: Model knowledge entities and their relationships
- */
-export {};
-//# sourceMappingURL=knowledge-node.js.map

package/dist/domain/entities/knowledge-preservation.js

@@ -1,10 +0,0 @@
-/**
- * Domain Entity: Knowledge Preservation
- * Represents preserved knowledge extracted from codebases
- *
- * Part of Organizational Memory system - preserves institutional knowledge
- *
- * Clean Architecture: Domain Layer
- */
-export {};
-//# sourceMappingURL=knowledge-preservation.js.map

package/dist/domain/entities/memory.js

@@ -1,6 +0,0 @@
-/**
- * Domain Entity: Memory
- * Represents episodic memory entry (Observation, Reflection, or Plan)
- */
-export {};
-//# sourceMappingURL=memory.js.map

package/dist/domain/entities/pattern.js

@@ -1,7 +0,0 @@
-/**
- * Domain Entity: Pattern
- * Represents a code pattern extracted from a codebase
- * Patterns are reusable code structures, conventions, or architectural decisions
- */
-export {};
-//# sourceMappingURL=pattern.js.map

package/dist/domain/entities/plan.js

@@ -1,6 +0,0 @@
-/**
- * Domain Entity: Plan
- * Represents a hierarchical plan synthesized from memories
- */
-export {};
-//# sourceMappingURL=plan.js.map

package/dist/domain/entities/query.js

@@ -1,6 +0,0 @@
-/**
- * Domain Entity: Query
- * Represents a user query with intent and context
- */
-export {};
-//# sourceMappingURL=query.js.map

package/dist/domain/errors/embeddings-not-found-error.js

@@ -1,13 +0,0 @@
-/**
- * Domain Error: EmbeddingsNotFoundError
- * Thrown when embeddings database doesn't exist or is empty for a repository
- */
-export class EmbeddingsNotFoundError extends Error {
-    repoPath;
-    constructor(repoPath) {
-        super(`No embeddings found for this repository. Run 'codehere index' first.`);
-        this.repoPath = repoPath;
-        this.name = 'EmbeddingsNotFoundError';
-    }
-}
-//# sourceMappingURL=embeddings-not-found-error.js.map

package/dist/domain/index.js

@@ -1,19 +0,0 @@
-/**
- * Domain Layer - Public Exports
- * Core business logic with no external dependencies
- */
-// Entities
-export * from './entities/query.js';
-export * from './entities/code-chunk.js';
-export * from './entities/memory.js';
-export * from './entities/edit.js';
-// Interfaces
-export * from './interfaces/ai-service.interface.js';
-export * from './interfaces/embedding-repository.interface.js';
-export * from './interfaces/memory-repository.interface.js';
-export * from './interfaces/code-analyzer.interface.js';
-export * from './interfaces/verification-service.interface.js';
-// Services
-export * from './services/query-intent-classifier.js';
-export * from './services/memory-retriever.js';
-//# sourceMappingURL=index.js.map

package/dist/domain/interfaces/ai-service.interface.js

@@ -1,6 +0,0 @@
-/**
- * Domain Interface: IAIService
- * Abstraction for AI/LLM operations
- */
-export {};
-//# sourceMappingURL=ai-service.interface.js.map

package/dist/domain/interfaces/code-analyzer.interface.js

@@ -1,6 +0,0 @@
-/**
- * Domain Interface: ICodeAnalyzer
- * Abstraction for code analysis operations
- */
-export {};
-//# sourceMappingURL=code-analyzer.interface.js.map

package/dist/domain/interfaces/decision-repository.interface.js

@@ -1,9 +0,0 @@
-/**
- * Domain Interface: IDecisionRepository
- * Abstraction for decision storage
- *
- * Clean Architecture: Domain Layer
- * Pattern: Repository Pattern
- */
-export {};
-//# sourceMappingURL=decision-repository.interface.js.map

package/dist/domain/interfaces/embedding-repository.interface.js

@@ -1,6 +0,0 @@
-/**
- * Domain Interface: IEmbeddingRepository
- * Abstraction for embedding storage and retrieval
- */
-export {};
-//# sourceMappingURL=embedding-repository.interface.js.map

package/dist/domain/interfaces/knowledge-graph-repository.interface.js

@@ -1,9 +0,0 @@
-/**
- * Domain Interface: IKnowledgeGraphRepository
- * Abstraction for knowledge graph storage
- *
- * Clean Architecture: Domain Layer
- * Pattern: Repository Pattern
- */
-export {};
-//# sourceMappingURL=knowledge-graph-repository.interface.js.map

package/dist/domain/interfaces/knowledge-preservation-repository.interface.js

@@ -1,8 +0,0 @@
-/**
- * Domain Interface: IKnowledgePreservationRepository
- * Abstraction for storing and querying preserved knowledge
- *
- * Clean Architecture: Domain Layer
- */
-export {};
-//# sourceMappingURL=knowledge-preservation-repository.interface.js.map

package/dist/domain/interfaces/memory-repository.interface.js

@@ -1,6 +0,0 @@
-/**
- * Domain Interface: IMemoryRepository
- * Abstraction for episodic memory storage
- */
-export {};
-//# sourceMappingURL=memory-repository.interface.js.map

package/dist/domain/interfaces/pattern-repository.interface.js

@@ -1,6 +0,0 @@
-/**
- * Domain Interface: IPatternRepository
- * Abstraction for pattern storage
- */
-export {};
-//# sourceMappingURL=pattern-repository.interface.js.map

package/dist/domain/interfaces/verification-service.interface.js

@@ -1,6 +0,0 @@
-/**
- * Domain Interface: IVerificationService
- * Abstraction for code verification (compilation, tests)
- */
-export {};
-//# sourceMappingURL=verification-service.interface.js.map

package/dist/domain/services/cross-team-pattern-sharing.js

@@ -1,125 +0,0 @@
-/**
- * Domain Service: Cross-Team Pattern Sharing
- * Enables sharing patterns across teams (opt-in, anonymous)
- *
- * Clean Architecture: Domain Layer
- * Strategic: Foundation for Learning Network and Marketplace
- */
-import { randomUUID } from 'crypto';
-/**
- * Cross-Team Pattern Sharing Service
- * Handles opt-in pattern sharing across teams
- */
-export class CrossTeamPatternSharing {
-    patternRepository;
-    constructor(patternRepository) {
-        this.patternRepository = patternRepository;
-    }
-    /**
-     * Share a pattern (opt-in)
-     * Anonymizes if requested, prepares for sharing
-     */
-    async sharePattern(patternId, codebaseId, options) {
-        // Retrieve original pattern
-        const patterns = await this.patternRepository.findByCodebase(codebaseId);
-        const pattern = patterns.find(p => p.id === patternId);
-        if (!pattern) {
-            throw new Error(`Pattern not found: ${patternId}`);
-        }
-        // Create shared version
-        const sharedPattern = {
-            id: randomUUID(),
-            originalPatternId: patternId,
-            patternType: pattern.type,
-            name: this.anonymizeIfNeeded(pattern.name, options.anonymize),
-            description: this.anonymizeIfNeeded(pattern.description, options.anonymize),
-            codeExample: options.includeCodeExample ? this.anonymizeCodeExample(pattern.codeExample, options.anonymize) : undefined,
-            tags: [...(pattern.metadata?.tags || []), ...(options.tags || [])],
-            language: this.detectLanguage(pattern.filepath),
-            usageCount: pattern.usageCount || 0,
-            sharedAt: new Date(),
-            anonymized: options.anonymize,
-            metadata: {
-                complexity: pattern.metadata?.complexity,
-                confidence: pattern.metadata?.confidence,
-                rationale: pattern.metadata?.rationale,
-                alternatives: pattern.metadata?.alternatives,
-            },
-        };
-        // In future: Store in shared patterns repository/marketplace
-        // For now, return the shared pattern structure
-        return sharedPattern;
-    }
-    /**
-     * Find shared patterns that match query
-     * Future: Query from marketplace/shared repository
-     */
-    async findSharedPatterns(query, filters) {
-        // For now: Return empty array (marketplace not yet implemented)
-        // Future: Query shared patterns repository
-        return [];
-    }
-    /**
-     * Import shared pattern into codebase
-     */
-    async importSharedPattern(sharedPattern, targetCodebaseId, targetCodebasePath) {
-        // Create new pattern from shared pattern
-        const importedPattern = {
-            id: randomUUID(),
-            codebaseId: targetCodebaseId,
-            type: sharedPattern.patternType,
-            name: sharedPattern.name,
-            description: sharedPattern.description,
-            codeExample: sharedPattern.codeExample,
-            metadata: {
-                tags: sharedPattern.tags,
-                complexity: sharedPattern.metadata?.complexity,
-                confidence: sharedPattern.metadata?.confidence,
-                rationale: sharedPattern.metadata?.rationale,
-                alternatives: sharedPattern.metadata?.alternatives,
-                context: 'Imported from shared pattern marketplace',
-            },
-            createdAt: new Date(),
-            usageCount: 0,
-        };
-        // Store in target codebase
-        await this.patternRepository.store(importedPattern);
-        return importedPattern;
-    }
-    anonymizeIfNeeded(text, anonymize) {
-        if (!text)
-            return '';
-        if (!anonymize)
-            return text;
-        // Remove codebase-specific references
-        // Simple anonymization - remove file paths, project names, etc.
-        return text
-            .replace(/\/[^\s]+\/[^\s]+\.(ts|js|tsx|jsx)/g, 'file.ts')
-            .replace(/src\/[^\s]+/g, 'src/...')
-            .replace(/(project|codebase|app)[^\s]*/gi, '[project]');
-    }
-    anonymizeCodeExample(code, anonymize) {
-        if (!code || !anonymize)
-            return code;
-        // Remove codebase-specific paths, project names
-        return this.anonymizeIfNeeded(code, true);
-    }
-    detectLanguage(filepath) {
-        if (!filepath)
-            return undefined;
-        if (filepath.endsWith('.ts') || filepath.endsWith('.tsx'))
-            return 'TypeScript';
-        if (filepath.endsWith('.js') || filepath.endsWith('.jsx'))
-            return 'JavaScript';
-        if (filepath.endsWith('.py'))
-            return 'Python';
-        if (filepath.endsWith('.java'))
-            return 'Java';
-        if (filepath.endsWith('.go'))
-            return 'Go';
-        if (filepath.endsWith('.rs'))
-            return 'Rust';
-        return undefined;
-    }
-}
-//# sourceMappingURL=cross-team-pattern-sharing.js.map