erosolar-cli 1.7.439 → 1.7.441

package/dist/core/memorySystem.js

@@ -0,0 +1,334 @@
+/**
+ * Memory System - Erosolar-CLI Style (EROSOLAR.md)
+ *
+ * Hierarchical memory files for persistent context and project-specific instructions.
+ * Similar to Erosolar-CLI's CLAUDE.md system.
+ *
+ * Memory Hierarchy (highest to lowest priority):
+ * 1. Enterprise policy (~/.erosolar/EROSOLAR.md at OS level)
+ * 2. User memory (~/.erosolar/EROSOLAR.md)
+ * 3. Project memory (./EROSOLAR.md or ./.erosolar/EROSOLAR.md)
+ * 4. Directory memory (./subdirectory/EROSOLAR.md - recursive discovery)
+ *
+ * Features:
+ * - Automatic loading on session start
+ * - Recursive discovery in file tree
+ * - Import syntax (@path/to/import) for referencing other files
+ * - Maximum 5-level import depth
+ * - Quick addition via # prefix input
+ * - Direct editing with /memory command
+ */
+import { existsSync, readFileSync, writeFileSync, mkdirSync, readdirSync, statSync } from 'node:fs';
+import { homedir } from 'node:os';
+import { join, dirname, resolve, isAbsolute } from 'node:path';
+const MEMORY_FILENAME = 'EROSOLAR.md';
+const MAX_IMPORT_DEPTH = 5;
+const MAX_MEMORY_SIZE = 100 * 1024; // 100KB max per file
+/**
+ * Get user memory directory
+ */
+function getUserMemoryDir() {
+    return join(homedir(), '.erosolar');
+}
+/**
+ * Get user memory file path
+ */
+function getUserMemoryPath() {
+    return join(getUserMemoryDir(), MEMORY_FILENAME);
+}
+/**
+ * Get project memory file path (tries both locations)
+ */
+function getProjectMemoryPath(workingDir) {
+    // Try root level first
+    const rootPath = join(workingDir, MEMORY_FILENAME);
+    if (existsSync(rootPath)) {
+        return rootPath;
+    }
+    // Try .erosolar directory
+    const dotPath = join(workingDir, '.erosolar', MEMORY_FILENAME);
+    if (existsSync(dotPath)) {
+        return dotPath;
+    }
+    // Return default path for creation
+    return rootPath;
+}
+/**
+ * Find all memory files in directory tree (recursive upward and downward)
+ */
+function findMemoryFiles(workingDir, searchDownward = true) {
+    const files = [];
+    // Search upward to find project root memory files
+    let currentDir = workingDir;
+    const visited = new Set();
+    while (currentDir && !visited.has(currentDir)) {
+        visited.add(currentDir);
+        const memoryPath = join(currentDir, MEMORY_FILENAME);
+        if (existsSync(memoryPath)) {
+            files.push(memoryPath);
+        }
+        const dotMemoryPath = join(currentDir, '.erosolar', MEMORY_FILENAME);
+        if (existsSync(dotMemoryPath)) {
+            files.push(dotMemoryPath);
+        }
+        const parentDir = dirname(currentDir);
+        if (parentDir === currentDir)
+            break;
+        currentDir = parentDir;
+    }
+    // Optionally search downward (only one level to avoid performance issues)
+    if (searchDownward) {
+        try {
+            const entries = readdirSync(workingDir, { withFileTypes: true });
+            for (const entry of entries) {
+                if (entry.isDirectory() && !entry.name.startsWith('.') && entry.name !== 'node_modules') {
+                    const subMemoryPath = join(workingDir, entry.name, MEMORY_FILENAME);
+                    if (existsSync(subMemoryPath)) {
+                        files.push(subMemoryPath);
+                    }
+                }
+            }
+        }
+        catch {
+            // Ignore directory read errors
+        }
+    }
+    return [...new Set(files)]; // Deduplicate
+}
+/**
+ * Read file content safely with size limit
+ */
+function readFileSafe(path, maxSize = MAX_MEMORY_SIZE) {
+    try {
+        if (!existsSync(path)) {
+            return null;
+        }
+        const stats = statSync(path);
+        if (stats.size > maxSize) {
+            // Return truncated content with warning
+            const content = readFileSync(path, 'utf8').slice(0, maxSize);
+            return content + '\n\n[Content truncated - file exceeds maximum size]';
+        }
+        return readFileSync(path, 'utf8');
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Resolve @import syntax in memory files
+ */
+function resolveImportsRecursive(content, basePath, depth, visited) {
+    if (depth > MAX_IMPORT_DEPTH) {
+        return content + '\n\n[Import depth limit reached]';
+    }
+    // Match @path/to/file or @./relative/path patterns
+    const importPattern = /@([^\s\n]+)/g;
+    let result = content;
+    let match;
+    while ((match = importPattern.exec(content)) !== null) {
+        const importPath = match[1];
+        const fullPath = isAbsolute(importPath)
+            ? importPath
+            : resolve(dirname(basePath), importPath);
+        if (visited.has(fullPath)) {
+            continue; // Prevent circular imports
+        }
+        const importedContent = readFileSafe(fullPath);
+        if (importedContent !== null) {
+            visited.add(fullPath);
+            const resolvedContent = resolveImportsRecursive(importedContent, fullPath, depth + 1, visited);
+            result = result.replace(match[0], resolvedContent);
+        }
+    }
+    return result;
+}
+/**
+ * Determine memory source type from path
+ */
+function getMemorySource(path, workingDir) {
+    const userDir = getUserMemoryDir();
+    if (path.startsWith(userDir)) {
+        return 'user';
+    }
+    if (path === join(workingDir, MEMORY_FILENAME) ||
+        path === join(workingDir, '.erosolar', MEMORY_FILENAME)) {
+        return 'project';
+    }
+    return 'directory';
+}
+/**
+ * Create the memory system
+ */
+export function createMemorySystem() {
+    return {
+        loadAllMemory(workingDir) {
+            const memoryFiles = [];
+            let priority = 0;
+            // Load user memory (highest priority)
+            const userMemoryPath = getUserMemoryPath();
+            const userContent = readFileSafe(userMemoryPath);
+            if (userContent) {
+                memoryFiles.push({
+                    path: userMemoryPath,
+                    content: userContent,
+                    source: 'user',
+                    priority: priority++,
+                });
+            }
+            // Load project and directory memory files
+            const projectFiles = findMemoryFiles(workingDir);
+            for (const filePath of projectFiles) {
+                const content = readFileSafe(filePath);
+                if (content) {
+                    memoryFiles.push({
+                        path: filePath,
+                        content,
+                        source: getMemorySource(filePath, workingDir),
+                        priority: priority++,
+                    });
+                }
+            }
+            return memoryFiles;
+        },
+        loadMemoryFile(path) {
+            const content = readFileSafe(path);
+            if (!content) {
+                return null;
+            }
+            return {
+                path,
+                content,
+                source: 'directory', // Will be overridden by caller if needed
+                priority: 0,
+            };
+        },
+        saveToProjectMemory(workingDir, content) {
+            const memoryPath = getProjectMemoryPath(workingDir) ?? join(workingDir, MEMORY_FILENAME);
+            try {
+                const dir = dirname(memoryPath);
+                mkdirSync(dir, { recursive: true });
+                writeFileSync(memoryPath, content, 'utf8');
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        saveToUserMemory(content) {
+            const memoryPath = getUserMemoryPath();
+            try {
+                mkdirSync(getUserMemoryDir(), { recursive: true });
+                writeFileSync(memoryPath, content, 'utf8');
+                return true;
+            }
+            catch {
+                return false;
+            }
+        },
+        appendToProjectMemory(workingDir, content) {
+            const memoryPath = getProjectMemoryPath(workingDir) ?? join(workingDir, MEMORY_FILENAME);
+            const existingContent = readFileSafe(memoryPath) ?? '';
+            const timestamp = new Date().toISOString().split('T')[0];
+            const newEntry = `\n\n## Added ${timestamp}\n\n${content}`;
+            return this.saveToProjectMemory(workingDir, existingContent + newEntry);
+        },
+        appendToUserMemory(content) {
+            const existingContent = readFileSafe(getUserMemoryPath()) ?? '';
+            const timestamp = new Date().toISOString().split('T')[0];
+            const newEntry = `\n\n## Added ${timestamp}\n\n${content}`;
+            return this.saveToUserMemory(existingContent + newEntry);
+        },
+        getMemoryPaths(workingDir) {
+            const paths = [];
+            const userPath = getUserMemoryPath();
+            if (existsSync(userPath)) {
+                paths.push(userPath);
+            }
+            paths.push(...findMemoryFiles(workingDir));
+            return [...new Set(paths)];
+        },
+        resolveImports(content, basePath, depth = 0) {
+            return resolveImportsRecursive(content, basePath, depth, new Set());
+        },
+        parseAtReferences(input, workingDir) {
+            const references = [];
+            // Match @path/to/file or @path/to/file:10-20 (with line range)
+            const refPattern = /@([^\s]+?)(?::(\d+)(?:-(\d+))?)?(?=\s|$)/g;
+            let cleanInput = input;
+            let match;
+            while ((match = refPattern.exec(input)) !== null) {
+                const refPath = match[1];
+                const startLine = match[2] ? parseInt(match[2], 10) : undefined;
+                const endLine = match[3] ? parseInt(match[3], 10) : startLine;
+                const fullPath = isAbsolute(refPath)
+                    ? refPath
+                    : resolve(workingDir, refPath);
+                const content = readFileSafe(fullPath, MAX_MEMORY_SIZE * 2);
+                if (content !== null) {
+                    let fileContent = content;
+                    // Extract line range if specified
+                    if (startLine !== undefined) {
+                        const lines = content.split('\n');
+                        const start = Math.max(0, startLine - 1);
+                        const end = endLine ? Math.min(lines.length, endLine) : start + 1;
+                        fileContent = lines.slice(start, end).join('\n');
+                    }
+                    references.push({
+                        path: refPath,
+                        content: fileContent,
+                        lineRange: startLine ? { start: startLine, end: endLine ?? startLine } : undefined,
+                    });
+                    cleanInput = cleanInput.replace(match[0], '');
+                }
+            }
+            return { cleanInput: cleanInput.trim(), references };
+        },
+    };
+}
+/**
+ * Format memory content for display in system prompt
+ */
+export function formatMemoryForPrompt(memoryFiles) {
+    if (memoryFiles.length === 0) {
+        return '';
+    }
+    const sections = [];
+    for (const memory of memoryFiles) {
+        const sourceLabel = {
+            'enterprise': 'Enterprise Policy',
+            'user': 'User Preferences',
+            'project': 'Project Memory',
+            'directory': 'Directory Context',
+        }[memory.source];
+        sections.push(`<memory source="${sourceLabel}" path="${memory.path}">\n${memory.content}\n</memory>`);
+    }
+    return `\n<project-memory>\n${sections.join('\n\n')}\n</project-memory>\n`;
+}
+/**
+ * Format referenced files for prompt context
+ */
+export function formatReferencesForPrompt(references) {
+    if (references.length === 0) {
+        return '';
+    }
+    const sections = [];
+    for (const ref of references) {
+        const rangeStr = ref.lineRange
+            ? ` lines ${ref.lineRange.start}-${ref.lineRange.end}`
+            : '';
+        sections.push(`<file path="${ref.path}"${rangeStr}>\n${ref.content}\n</file>`);
+    }
+    return `\n<referenced-files>\n${sections.join('\n\n')}\n</referenced-files>\n`;
+}
+/**
+ * Global memory system instance
+ */
+let globalMemorySystem = null;
+export function getMemorySystem() {
+    if (!globalMemorySystem) {
+        globalMemorySystem = createMemorySystem();
+    }
+    return globalMemorySystem;
+}
+//# sourceMappingURL=memorySystem.js.map

package/dist/core/memorySystem.js.map

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

package/dist/core/metricsTracker.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Performance Metrics Tracker
+ *
+ * Tracks session performance metrics for analytics and improvement suggestions.
+ * Integrated with AlphaZero engine for learning-based improvements.
+ */
+import type { ProviderUsage } from './types.js';
+import { type QualityScore, type ToolCallRecord } from './alphaZeroEngine.js';
+/**
+ * Performance metrics for an agent session.
+ */
+export interface AgentPerformanceMetrics {
+    sessionId: string;
+    totalMessages: number;
+    totalToolCalls: number;
+    totalTokensUsed: number;
+    totalTimeMs: number;
+    successfulToolCalls: number;
+    failedToolCalls: number;
+    codeBlocksGenerated: number;
+    avgResponseTimeMs: number;
+    avgCodeQuality: number;
+    avgAlgorithmEfficiency: number;
+    avgErrorHandling: number;
+}
+/**
+ * Code quality evaluation result.
+ */
+export interface CodeQualityMetrics {
+    codeQualityScore: number;
+    algorithmEfficiency: number;
+    errorHandlingScore: number;
+    documentationScore: number;
+    maintainabilityScore: number;
+    securityScore: number;
+}
+/**
+ * Execution trace for debugging and analysis.
+ */
+export interface ExecutionTrace {
+    traceId: string;
+    timestamp: string;
+    prompt: string;
+    response: string;
+    toolCalls: Array<{
+        name: string;
+        arguments: Record<string, unknown>;
+        result?: string;
+        error?: string;
+        durationMs: number;
+    }>;
+    totalDurationMs: number;
+    tokenUsage?: ProviderUsage;
+}
+/**
+ * Improvement suggestion from analysis.
+ */
+export interface ImprovementSuggestion {
+    category: 'performance' | 'quality' | 'efficiency' | 'error-handling';
+    severity: 'low' | 'medium' | 'high';
+    message: string;
+    suggestedAction?: string;
+}
+/**
+ * Creates default performance metrics.
+ */
+export declare function createDefaultMetrics(sessionId: string): AgentPerformanceMetrics;
+/**
+ * Tracks performance metrics for an agent session.
+ */
+export declare class MetricsTracker {
+    private metrics;
+    private responseTimes;
+    private codeQualityScores;
+    private efficiencyScores;
+    private errorHandlingScores;
+    private traces;
+    constructor(sessionId: string);
+    /**
+     * Record a message exchange.
+     */
+    recordMessage(elapsedMs: number, usage?: ProviderUsage | null): void;
+    /**
+     * Record a tool call.
+     */
+    recordToolCall(success: boolean): void;
+    /**
+     * Record code generation.
+     */
+    recordCodeGeneration(codeBlockCount: number): void;
+    /**
+     * Record code quality evaluation.
+     */
+    recordCodeQuality(quality: CodeQualityMetrics): void;
+    /**
+     * Add an execution trace.
+     */
+    addTrace(trace: ExecutionTrace): void;
+    /**
+     * Update running averages.
+     */
+    private updateAverages;
+    /**
+     * Get current metrics.
+     */
+    getMetrics(): AgentPerformanceMetrics;
+    /**
+     * Get execution traces.
+     */
+    getTraces(): ExecutionTrace[];
+    /**
+     * Get human-readable performance summary.
+     */
+    getPerformanceSummary(): string;
+    /**
+     * Get improvement suggestions based on metrics.
+     */
+    getImprovementSuggestions(): ImprovementSuggestion[];
+    /**
+     * Reset all metrics.
+     */
+    reset(): void;
+    /**
+     * Start tracking a new task with AlphaZero
+     */
+    startAlphaZeroTask(userQuery: string): void;
+    /**
+     * Record tool call with AlphaZero pattern learning
+     */
+    recordToolCallWithLearning(toolName: string, success: boolean, durationMs?: number): void;
+    /**
+     * Complete task and record pattern
+     */
+    completeAlphaZeroTask(success: boolean): void;
+    /**
+     * Get quick quality score for a response
+     */
+    getResponseQualityScore(response: string, toolCalls: ToolCallRecord[]): QualityScore;
+    /**
+     * Get recommended tools for a task type
+     */
+    getRecommendedTools(userQuery: string): string[] | null;
+    /**
+     * Get AlphaZero statistics
+     */
+    getAlphaZeroStats(): {
+        dualResponsesGenerated: number;
+        critiqueIterations: number;
+        improvementsApplied: number;
+        patternsLearned: number;
+    };
+    /**
+     * Get combined performance summary with AlphaZero stats
+     */
+    getEnhancedPerformanceSummary(): string;
+}
+//# sourceMappingURL=metricsTracker.d.ts.map

package/dist/core/metricsTracker.d.ts.map

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