attocode 0.2.4 → 0.2.5

package/dist/src/integrations/mcp/mcp-tool-search.js

@@ -0,0 +1,220 @@
+/**
+ * MCP Tool Search
+ *
+ * Provides a meta-tool for searching and dynamically loading MCP tools.
+ * Enables lazy loading of tool schemas to reduce context window usage.
+ *
+ * Token Savings:
+ * - 50 tools with full schemas: ~15,000 tokens
+ * - 50 tools as summaries: ~2,500 tokens
+ * - Savings: ~83% reduction in MCP tool context
+ */
+// =============================================================================
+// TOOL SEARCH TOOL
+// =============================================================================
+/**
+ * Create the mcp_tool_search tool.
+ *
+ * This tool allows the agent to search for MCP tools by name or description,
+ * then automatically loads matching tools so they become available for use.
+ *
+ * @example
+ * // Search for browser tools
+ * mcp_tool_search({ query: "browser click" })
+ *
+ * // Search with regex
+ * mcp_tool_search({ query: "browser_(click|hover)", regex: true })
+ *
+ * // Limit results
+ * mcp_tool_search({ query: "screenshot", limit: 3 })
+ */
+export function createMCPToolSearchTool(mcpClient, options = {}) {
+    const { autoLoad = true, defaultLimit = 5, onToolsLoaded, } = options;
+    return {
+        name: 'mcp_tool_search',
+        description: `Search for MCP tools by name or description.
+Found tools are automatically loaded and become available for use.
+
+Examples:
+- "browser click" - find click-related browser tools
+- "screenshot" - find screenshot tools
+- "file read" - find file reading tools
+
+Use this when you need an MCP tool but don't see it in your available tools.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                query: {
+                    type: 'string',
+                    description: 'Search keywords (e.g., "browser click", "file read")',
+                },
+                regex: {
+                    type: 'boolean',
+                    description: 'Use regex matching instead of keyword search',
+                },
+                limit: {
+                    type: 'number',
+                    description: `Max results to return (default: ${defaultLimit})`,
+                },
+            },
+            required: ['query'],
+        },
+        execute: async (args) => {
+            const query = String(args.query || '');
+            const regex = Boolean(args.regex);
+            const limit = typeof args.limit === 'number' ? args.limit : defaultLimit;
+            // Search for matching tools
+            const matches = mcpClient.searchTools(query, { limit, regex });
+            // Get total count for context
+            const allSummaries = mcpClient.getAllToolSummaries();
+            const totalAvailable = allSummaries.length;
+            // Auto-load found tools if enabled
+            let loadedTools = [];
+            if (autoLoad && matches.length > 0) {
+                loadedTools = mcpClient.loadTools(matches.map(m => m.name));
+                // Notify callback if provided
+                if (onToolsLoaded && loadedTools.length > 0) {
+                    onToolsLoaded(loadedTools);
+                }
+            }
+            // Build result message
+            let message;
+            if (matches.length === 0) {
+                message = `No tools found matching "${query}". Try different keywords.`;
+            }
+            else if (autoLoad) {
+                message = `Found and loaded ${matches.length} tool(s) matching "${query}". They are now available for use.`;
+            }
+            else {
+                message = `Found ${matches.length} tool(s) matching "${query}".`;
+            }
+            return {
+                tools: matches,
+                totalAvailable,
+                autoLoaded: autoLoad && matches.length > 0,
+                message,
+            };
+        },
+    };
+}
+/**
+ * Create a tool that lists all available MCP tools as summaries.
+ * Useful when the agent needs to understand what tools are available.
+ */
+export function createMCPToolListTool(mcpClient) {
+    return {
+        name: 'mcp_tool_list',
+        description: `List all available MCP tools with brief descriptions.
+Use this to see what tools are available before searching for specific ones.`,
+        parameters: {
+            type: 'object',
+            properties: {
+                server: {
+                    type: 'string',
+                    description: 'Filter by server name (optional)',
+                },
+            },
+        },
+        execute: async (args) => {
+            const serverFilter = args.server ? String(args.server) : undefined;
+            let summaries = mcpClient.getAllToolSummaries();
+            if (serverFilter) {
+                summaries = summaries.filter(s => s.serverName === serverFilter);
+            }
+            return {
+                tools: summaries,
+                count: summaries.length,
+            };
+        },
+    };
+}
+/**
+ * Create a tool that shows MCP context usage statistics.
+ * Useful for monitoring token usage with lazy loading.
+ */
+export function createMCPContextStatsTool(mcpClient) {
+    return {
+        name: 'mcp_context_stats',
+        description: `Show MCP tool context usage statistics.
+Reports token usage for tool summaries vs full definitions.`,
+        parameters: {
+            type: 'object',
+            properties: {},
+        },
+        execute: async () => {
+            const stats = mcpClient.getContextStats();
+            // Calculate savings
+            const fullLoadTokens = stats.totalTools * 200; // Estimate: ~200 tokens per full tool
+            const currentTokens = stats.summaryTokens + stats.definitionTokens;
+            const savingsPercent = fullLoadTokens > 0
+                ? Math.round((1 - currentTokens / fullLoadTokens) * 100)
+                : 0;
+            // Generate recommendation
+            let recommendation;
+            if (stats.loadedCount > 20) {
+                recommendation = 'Consider using lazy loading more aggressively - many tools are fully loaded.';
+            }
+            else if (stats.loadedCount === 0) {
+                recommendation = 'All tools are summaries. Use mcp_tool_search to load specific tools when needed.';
+            }
+            else {
+                recommendation = `Good balance: ${stats.loadedCount} tools loaded, ${stats.summaryCount} as summaries.`;
+            }
+            return {
+                stats,
+                savings: `${savingsPercent}% token savings vs loading all full schemas`,
+                recommendation,
+            };
+        },
+    };
+}
+// =============================================================================
+// FACTORY
+// =============================================================================
+/**
+ * Create all MCP meta-tools for dynamic tool discovery.
+ */
+export function createMCPMetaTools(mcpClient, options = {}) {
+    return [
+        createMCPToolSearchTool(mcpClient, options),
+        createMCPToolListTool(mcpClient),
+        createMCPContextStatsTool(mcpClient),
+    ];
+}
+// =============================================================================
+// UTILITIES
+// =============================================================================
+/**
+ * Format tool summaries for display.
+ */
+export function formatToolSummaries(summaries) {
+    if (summaries.length === 0) {
+        return 'No tools available.';
+    }
+    const lines = ['MCP Tools:'];
+    // Group by server
+    const byServer = new Map();
+    for (const s of summaries) {
+        const existing = byServer.get(s.serverName) || [];
+        existing.push(s);
+        byServer.set(s.serverName, existing);
+    }
+    for (const [server, tools] of byServer) {
+        lines.push(`\n  ${server}:`);
+        for (const tool of tools) {
+            lines.push(`    - ${tool.originalName}: ${tool.description}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Format context stats for display.
+ */
+export function formatContextStats(stats) {
+    const total = stats.summaryTokens + stats.definitionTokens;
+    return `MCP Tool Context:
+  Tool summaries:    ${stats.summaryCount} tools (~${stats.summaryTokens.toLocaleString()} tokens)
+  Full definitions:  ${stats.loadedCount} tools (~${stats.definitionTokens.toLocaleString()} tokens)
+  Total:             ${stats.totalTools} tools (~${total.toLocaleString()} tokens)`;
+}
+//# sourceMappingURL=mcp-tool-search.js.map

package/dist/src/integrations/mcp/mcp-tool-search.js.map

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

package/dist/src/integrations/mcp/mcp-tool-validator.d.ts

@@ -0,0 +1,60 @@
+/**
+ * MCP Tool Description Validator
+ *
+ * Validates MCP tool descriptions for quality, helping ensure
+ * that LLMs can understand and correctly use the tools.
+ *
+ * Quality checks:
+ * 1. Description length (minimum useful length)
+ * 2. Input schema has property descriptions
+ * 3. Required parameters are marked
+ * 4. Description contains usage patterns
+ * 5. Naming conventions (snake_case, prefixed)
+ */
+export interface ToolValidationResult {
+    /** Tool name */
+    toolName: string;
+    /** Quality score (0-100) */
+    score: number;
+    /** Specific problems found */
+    issues: string[];
+    /** Improvement suggestions */
+    suggestions: string[];
+}
+export interface ToolValidationConfig {
+    /** Minimum description length (default: 20) */
+    minDescriptionLength: number;
+    /** Require input schema property descriptions (default: true) */
+    requirePropertyDescriptions: boolean;
+    /** Require at least one example in description (default: false) */
+    requireExamples: boolean;
+    /** Minimum quality score to pass (default: 40) */
+    minimumPassScore: number;
+}
+interface ValidatableToolInfo {
+    name: string;
+    description?: string;
+    inputSchema?: Record<string, unknown>;
+}
+/**
+ * Validate a single tool's description quality.
+ */
+export declare function validateToolDescription(tool: ValidatableToolInfo, config?: Partial<ToolValidationConfig>): ToolValidationResult;
+/**
+ * Validate all tools and return results sorted by score (worst first).
+ */
+export declare function validateAllTools(tools: ValidatableToolInfo[], config?: Partial<ToolValidationConfig>): ToolValidationResult[];
+/**
+ * Get a summary of validation results.
+ */
+export declare function formatValidationSummary(results: ToolValidationResult[]): string;
+/**
+ * Create a tool validator.
+ */
+export declare function createToolValidator(config?: Partial<ToolValidationConfig>): {
+    validate: (tool: ValidatableToolInfo) => ToolValidationResult;
+    validateAll: (tools: ValidatableToolInfo[]) => ToolValidationResult[];
+    formatSummary: typeof formatValidationSummary;
+};
+export {};
+//# sourceMappingURL=mcp-tool-validator.d.ts.map

package/dist/src/integrations/mcp/mcp-tool-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-tool-validator.d.ts","sourceRoot":"","sources":["../../../../src/integrations/mcp/mcp-tool-validator.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAMH,MAAM,WAAW,oBAAoB;IACnC,gBAAgB;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,8BAA8B;IAC9B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,8BAA8B;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,MAAM,WAAW,oBAAoB;IACnC,+CAA+C;IAC/C,oBAAoB,EAAE,MAAM,CAAC;IAC7B,iEAAiE;IACjE,2BAA2B,EAAE,OAAO,CAAC;IACrC,mEAAmE;IACnE,eAAe,EAAE,OAAO,CAAC;IACzB,kDAAkD;IAClD,gBAAgB,EAAE,MAAM,CAAC;CAC1B;AAED,UAAU,mBAAmB;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACvC;AAiBD;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,mBAAmB,EACzB,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,oBAAoB,CAmFtB;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,mBAAmB,EAAE,EAC5B,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,GACrC,oBAAoB,EAAE,CAIxB;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,oBAAoB,EAAE,GAAG,MAAM,CAgB/E;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC;qBAErD,mBAAmB;yBACf,mBAAmB,EAAE;;EAG7C"}

package/dist/src/integrations/mcp/mcp-tool-validator.js

@@ -0,0 +1,141 @@
+/**
+ * MCP Tool Description Validator
+ *
+ * Validates MCP tool descriptions for quality, helping ensure
+ * that LLMs can understand and correctly use the tools.
+ *
+ * Quality checks:
+ * 1. Description length (minimum useful length)
+ * 2. Input schema has property descriptions
+ * 3. Required parameters are marked
+ * 4. Description contains usage patterns
+ * 5. Naming conventions (snake_case, prefixed)
+ */
+// =============================================================================
+// CONSTANTS
+// =============================================================================
+const DEFAULT_CONFIG = {
+    minDescriptionLength: 20,
+    requirePropertyDescriptions: true,
+    requireExamples: false,
+    minimumPassScore: 40,
+};
+// =============================================================================
+// VALIDATOR
+// =============================================================================
+/**
+ * Validate a single tool's description quality.
+ */
+export function validateToolDescription(tool, config) {
+    const cfg = { ...DEFAULT_CONFIG, ...config };
+    const issues = [];
+    const suggestions = [];
+    let score = 100;
+    const description = tool.description || '';
+    // Check 1: Description exists and has minimum length
+    if (!description) {
+        issues.push('No description provided');
+        score -= 40;
+    }
+    else if (description.length < cfg.minDescriptionLength) {
+        issues.push(`Description too short (${description.length} chars, min: ${cfg.minDescriptionLength})`);
+        suggestions.push('Add more detail about what this tool does and when to use it');
+        score -= 20;
+    }
+    // Check 2: Description is informative (not just tool name restated)
+    if (description && tool.name) {
+        const nameWords = tool.name.replace(/[_-]/g, ' ').toLowerCase().split(/\s+/);
+        const descWords = description.toLowerCase().split(/\s+/);
+        const overlap = nameWords.filter(w => descWords.includes(w)).length;
+        if (overlap === nameWords.length && description.split(/\s+/).length < 5) {
+            issues.push('Description merely restates the tool name');
+            suggestions.push('Explain what the tool does, its purpose, and any important behavior');
+            score -= 15;
+        }
+    }
+    // Check 3: Input schema has property descriptions
+    if (cfg.requirePropertyDescriptions && tool.inputSchema) {
+        const properties = tool.inputSchema.properties;
+        if (properties) {
+            const undocumented = [];
+            for (const [propName, propSchema] of Object.entries(properties)) {
+                if (!propSchema.description) {
+                    undocumented.push(propName);
+                }
+            }
+            if (undocumented.length > 0) {
+                issues.push(`Properties missing descriptions: ${undocumented.join(', ')}`);
+                suggestions.push('Add "description" to each property in the input schema');
+                score -= Math.min(undocumented.length * 5, 20);
+            }
+        }
+    }
+    // Check 4: Required parameters are specified
+    if (tool.inputSchema) {
+        const required = tool.inputSchema.required;
+        const properties = tool.inputSchema.properties;
+        if (properties && Object.keys(properties).length > 0 && (!required || required.length === 0)) {
+            suggestions.push('Consider marking required parameters in the schema');
+            score -= 5;
+        }
+    }
+    // Check 5: Description mentions examples or usage patterns
+    if (cfg.requireExamples && description) {
+        const hasExample = /example|e\.g\.|for instance|usage:|such as/i.test(description);
+        if (!hasExample) {
+            suggestions.push('Add a usage example to the description');
+            score -= 10;
+        }
+    }
+    // Check 6: Naming conventions
+    if (tool.name) {
+        const isSnakeCase = /^[a-z][a-z0-9_]*$/.test(tool.name);
+        const hasMCPPrefix = tool.name.startsWith('mcp_');
+        if (!isSnakeCase && !hasMCPPrefix) {
+            suggestions.push('Consider using snake_case for tool names');
+            score -= 5;
+        }
+    }
+    return {
+        toolName: tool.name,
+        score: Math.max(0, score),
+        issues,
+        suggestions,
+    };
+}
+/**
+ * Validate all tools and return results sorted by score (worst first).
+ */
+export function validateAllTools(tools, config) {
+    return tools
+        .map(tool => validateToolDescription(tool, config))
+        .sort((a, b) => a.score - b.score);
+}
+/**
+ * Get a summary of validation results.
+ */
+export function formatValidationSummary(results) {
+    const passed = results.filter(r => r.score >= (DEFAULT_CONFIG.minimumPassScore));
+    const failed = results.filter(r => r.score < (DEFAULT_CONFIG.minimumPassScore));
+    const lines = [
+        `Tool Description Quality: ${passed.length}/${results.length} passed`,
+    ];
+    if (failed.length > 0) {
+        lines.push('', 'Failed:');
+        for (const r of failed) {
+            lines.push(`  ${r.toolName} (score: ${r.score}): ${r.issues.join('; ')}`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Create a tool validator.
+ */
+export function createToolValidator(config) {
+    return {
+        validate: (tool) => validateToolDescription(tool, config),
+        validateAll: (tools) => validateAllTools(tools, config),
+        formatSummary: formatValidationSummary,
+    };
+}
+//# sourceMappingURL=mcp-tool-validator.js.map

package/dist/src/integrations/mcp/mcp-tool-validator.js.map

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

package/dist/src/integrations/persistence/codebase-repository.d.ts

@@ -0,0 +1,45 @@
+/**
+ * Codebase Repository
+ *
+ * Persistence layer for codebase analysis results.
+ * Stores/loads chunk metadata and dependency graph to/from SQLite
+ * for warm startup across sessions.
+ */
+import type { SQLiteStoreDeps } from './sqlite-store.js';
+export interface SavedChunk {
+    filePath: string;
+    contentHash: string;
+    symbolsJson: string;
+    dependenciesJson: string;
+    importance: number;
+    chunkType: string;
+    tokenCount: number;
+    analyzedAt: number;
+}
+export interface SavedCodebaseAnalysis {
+    chunks: Map<string, SavedChunk>;
+    deps: Map<string, Set<string>>;
+}
+/**
+ * Save codebase analysis to SQLite for persistence across sessions.
+ */
+export declare function saveCodebaseAnalysis(deps: SQLiteStoreDeps, root: string, chunks: Iterable<{
+    filePath: string;
+    content: string;
+    symbolDetails: Array<{
+        name: string;
+        kind: string;
+        exported: boolean;
+        line: number;
+    }>;
+    dependencies: string[];
+    importance: number;
+    type: string;
+    tokenCount: number;
+}>, dependencyGraph: Map<string, Set<string>>): void;
+/**
+ * Load persisted codebase analysis from SQLite.
+ * Returns null if no analysis exists for the given workspace root.
+ */
+export declare function loadCodebaseAnalysis(deps: SQLiteStoreDeps, root: string): SavedCodebaseAnalysis | null;
+//# sourceMappingURL=codebase-repository.d.ts.map

package/dist/src/integrations/persistence/codebase-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codebase-repository.d.ts","sourceRoot":"","sources":["../../../../src/integrations/persistence/codebase-repository.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAOzD,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,qBAAqB;IACpC,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAChC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;CAChC;AAMD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,QAAQ,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACtF,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;CACpB,CAAC,EACF,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC,GACxC,IAAI,CAkCN;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,MAAM,GACX,qBAAqB,GAAG,IAAI,CA8C9B"}

package/dist/src/integrations/persistence/codebase-repository.js

@@ -0,0 +1,81 @@
+/**
+ * Codebase Repository
+ *
+ * Persistence layer for codebase analysis results.
+ * Stores/loads chunk metadata and dependency graph to/from SQLite
+ * for warm startup across sessions.
+ */
+import { djb2Hash } from '../context/codebase-ast.js';
+// =============================================================================
+// SAVE
+// =============================================================================
+/**
+ * Save codebase analysis to SQLite for persistence across sessions.
+ */
+export function saveCodebaseAnalysis(deps, root, chunks, dependencyGraph) {
+    if (!deps.features.codebaseAnalysis)
+        return;
+    const { db } = deps;
+    const deleteChunks = db.prepare('DELETE FROM codebase_chunks WHERE workspace_root = ?');
+    const deleteDeps = db.prepare('DELETE FROM codebase_deps WHERE workspace_root = ?');
+    const insertChunk = db.prepare(`
+    INSERT INTO codebase_chunks (file_path, workspace_root, content_hash, symbols_json,
+      dependencies_json, importance, chunk_type, token_count, analyzed_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?)
+  `);
+    const insertDep = db.prepare(`
+    INSERT INTO codebase_deps (workspace_root, source_file, target_file) VALUES (?, ?, ?)
+  `);
+    const transaction = db.transaction(() => {
+        deleteChunks.run(root);
+        deleteDeps.run(root);
+        for (const chunk of chunks) {
+            const contentHash = djb2Hash(chunk.content).toString(36);
+            insertChunk.run(chunk.filePath, root, contentHash, JSON.stringify(chunk.symbolDetails), JSON.stringify(chunk.dependencies), chunk.importance, chunk.type, chunk.tokenCount, Date.now());
+        }
+        for (const [source, targets] of dependencyGraph) {
+            for (const target of targets) {
+                insertDep.run(root, source, target);
+            }
+        }
+    });
+    transaction();
+}
+// =============================================================================
+// LOAD
+// =============================================================================
+/**
+ * Load persisted codebase analysis from SQLite.
+ * Returns null if no analysis exists for the given workspace root.
+ */
+export function loadCodebaseAnalysis(deps, root) {
+    if (!deps.features.codebaseAnalysis)
+        return null;
+    const { db } = deps;
+    const rows = db.prepare('SELECT * FROM codebase_chunks WHERE workspace_root = ?').all(root);
+    if (rows.length === 0)
+        return null;
+    const chunks = new Map();
+    for (const row of rows) {
+        chunks.set(row.file_path, {
+            filePath: row.file_path,
+            contentHash: row.content_hash,
+            symbolsJson: row.symbols_json,
+            dependenciesJson: row.dependencies_json,
+            importance: row.importance,
+            chunkType: row.chunk_type,
+            tokenCount: row.token_count,
+            analyzedAt: row.analyzed_at,
+        });
+    }
+    const depRows = db.prepare('SELECT source_file, target_file FROM codebase_deps WHERE workspace_root = ?').all(root);
+    const depsMap = new Map();
+    for (const row of depRows) {
+        if (!depsMap.has(row.source_file)) {
+            depsMap.set(row.source_file, new Set());
+        }
+        depsMap.get(row.source_file).add(row.target_file);
+    }
+    return { chunks, deps: depsMap };
+}
+//# sourceMappingURL=codebase-repository.js.map

package/dist/src/integrations/persistence/codebase-repository.js.map

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

package/dist/src/integrations/persistence/goal-repository.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Goal Repository
+ *
+ * Goal CRUD operations and critical juncture tracking.
+ * Goals persist outside of context and survive compaction.
+ *
+ * Extracted from sqlite-store.ts as part of Phase 3c restructuring.
+ */
+import type { Goal, GoalStatus, Juncture, JunctureType, SQLiteStoreDeps } from './sqlite-store.js';
+/**
+ * Create a new goal for the current session.
+ * Goals persist outside of context and survive compaction.
+ * Returns undefined if goals feature is not available.
+ */
+export declare function createGoal(deps: SQLiteStoreDeps, goalText: string, options?: {
+    priority?: number;
+    parentGoalId?: string;
+    progressTotal?: number;
+    metadata?: Record<string, unknown>;
+}): string | undefined;
+/**
+ * Update a goal's status or progress.
+ */
+export declare function updateGoal(deps: SQLiteStoreDeps, goalId: string, updates: {
+    goalText?: string;
+    status?: GoalStatus;
+    priority?: number;
+    progressCurrent?: number;
+    progressTotal?: number;
+    metadata?: Record<string, unknown>;
+}): void;
+/**
+ * Mark a goal as completed.
+ */
+export declare function completeGoal(deps: SQLiteStoreDeps, goalId: string): void;
+/**
+ * Get a goal by ID.
+ */
+export declare function getGoal(deps: SQLiteStoreDeps, goalId: string): Goal | undefined;
+/**
+ * List all goals for a session.
+ */
+export declare function listGoals(deps: SQLiteStoreDeps, sessionId?: string): Goal[];
+/**
+ * List active goals for a session.
+ */
+export declare function listActiveGoals(deps: SQLiteStoreDeps, sessionId?: string): Goal[];
+/**
+ * Get a summary of the current goals for context injection.
+ * This is what gets recited to maintain goal awareness.
+ */
+export declare function getGoalsSummary(deps: SQLiteStoreDeps, sessionId?: string): string;
+/**
+ * Log a critical juncture (decision, failure, breakthrough, pivot).
+ * Returns -1 if goals feature is not available.
+ */
+export declare function logJuncture(deps: SQLiteStoreDeps, type: JunctureType, description: string, options?: {
+    goalId?: string;
+    outcome?: string;
+    importance?: number;
+    context?: Record<string, unknown>;
+}): number;
+/**
+ * List junctures for a session.
+ */
+export declare function listJunctures(deps: SQLiteStoreDeps, sessionId?: string, limit?: number): Juncture[];
+/**
+ * Get recent critical junctures for context.
+ */
+export declare function getJuncturesSummary(deps: SQLiteStoreDeps, sessionId?: string, limit?: number): string;
+//# sourceMappingURL=goal-repository.d.ts.map

package/dist/src/integrations/persistence/goal-repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"goal-repository.d.ts","sourceRoot":"","sources":["../../../../src/integrations/persistence/goal-repository.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EACV,IAAI,EACJ,UAAU,EACV,QAAQ,EACR,YAAY,EACZ,eAAe,EAChB,MAAM,mBAAmB,CAAC;AAM3B;;;;GAIG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,eAAe,EACrB,QAAQ,EAAE,MAAM,EAChB,OAAO,GAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC/B,GACL,MAAM,GAAG,SAAS,CA4BpB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,IAAI,EAAE,eAAe,EACrB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE;IACP,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,UAAU,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC,GACA,IAAI,CAkBN;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAExE;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAK/E;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAO3E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,EAAE,CAOjF;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAmBjF;AAMD;;;GAGG;AACH,wBAAgB,WAAW,CACzB,IAAI,EAAE,eAAe,EACrB,IAAI,EAAE,YAAY,EAClB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;IACP,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAC9B,GACL,MAAM,CAqBR;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,EAAE,CAUnG;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,MAAM,CAoBxG"}