openlore 2.0.0

package/dist/core/services/mcp-handlers/semantic.js

@@ -0,0 +1,432 @@
+/**
+ * MCP tool handlers for semantic search and feature insertion:
+ * search_code, suggest_insertion_points, search_specs.
+ */
+import { join } from 'node:path';
+import { INSERTION_SEMANTIC_WEIGHT, INSERTION_STRUCTURAL_WEIGHT, INSERTION_ROLE_BONUS_ENTRY_POINT, INSERTION_ROLE_BONUS_ORCHESTRATOR, INSERTION_ROLE_BONUS_HUB, INSERTION_ROLE_BONUS_INTERNAL, INSERTION_ROLE_BONUS_UTILITY, INSERTION_ORCHESTRATOR_FAN_OUT_THRESHOLD, OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR, OPENSPEC_DIR, OPENSPEC_SPECS_SUBDIR, } from '../../../constants.js';
+import { fileExists } from '../../../utils/command-helpers.js';
+import { validateDirectory, loadMappingIndex, specsForFile, functionsForDomain } from './utils.js';
+import { readOpenLoreConfig } from '../config-manager.js';
+export function classifyRole(fanIn, fanOut, isHub, isEntryPoint) {
+    if (isEntryPoint)
+        return 'entry_point';
+    if (isHub)
+        return 'hub';
+    if (fanOut >= INSERTION_ORCHESTRATOR_FAN_OUT_THRESHOLD)
+        return 'orchestrator';
+    if (fanIn <= 1)
+        return 'utility';
+    return 'internal';
+}
+export function deriveStrategy(role) {
+    switch (role) {
+        case 'entry_point':
+            return 'extend_entry_point';
+        case 'orchestrator':
+            return 'add_orchestration_step';
+        case 'hub':
+            return 'cross_cutting_hook';
+        case 'utility':
+            return 'extract_shared_logic';
+        default:
+            return 'call_alongside';
+    }
+}
+export function buildReason(name, role, strategy, fanIn, fanOut) {
+    switch (strategy) {
+        case 'extend_entry_point':
+            return `${name} is an entry point (no internal callers). Add your feature here or create a sibling entry point that delegates to it.`;
+        case 'add_orchestration_step':
+            return `${name} orchestrates ${fanOut} downstream calls. Insert your feature as a new step in this pipeline.`;
+        case 'cross_cutting_hook':
+            return `${name} is called by ${fanIn} functions -- adding logic here affects the entire callsite surface.`;
+        case 'extract_shared_logic':
+            return `${name} is a low-traffic utility. Shared logic for your feature can live here or be extracted alongside it.`;
+        default:
+            return `${name} is semantically close to your feature and operates in the same domain. Extend or call alongside it.`;
+    }
+}
+/**
+ * Composite score = semanticRelevance * INSERTION_SEMANTIC_WEIGHT + structuralBonus * INSERTION_STRUCTURAL_WEIGHT.
+ *
+ * `semanticRelevance` must be in the 0-1 range (higher = more relevant).
+ * Callers using VectorIndex.search (hybrid/RRF or BM25) should normalise scores
+ * into [0, 1] before calling this function.
+ */
+export function compositeScore(semanticRelevance, role) {
+    const semantic = Math.max(0, Math.min(1, semanticRelevance));
+    const structuralBonus = {
+        entry_point: INSERTION_ROLE_BONUS_ENTRY_POINT,
+        orchestrator: INSERTION_ROLE_BONUS_ORCHESTRATOR,
+        hub: INSERTION_ROLE_BONUS_HUB,
+        internal: INSERTION_ROLE_BONUS_INTERNAL,
+        utility: INSERTION_ROLE_BONUS_UTILITY,
+    };
+    return semantic * INSERTION_SEMANTIC_WEIGHT + structuralBonus[role] * INSERTION_STRUCTURAL_WEIGHT;
+}
+// ============================================================================
+// HANDLERS
+// ============================================================================
+/**
+ * MCP retrieval strategy: semantic search → graph neighborhood enrichment.
+ *
+ * Returns the top-k semantic results, each enriched with:
+ * - callers / callees from the call graph (graph-first context)
+ * - linkedSpecs from mapping.json (bidirectional code↔spec linking)
+ */
+export async function handleSearchCode(directory, query, limit = 10, language, minFanIn) {
+    const absDir = await validateDirectory(directory);
+    const outputDir = join(absDir, OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR);
+    const { VectorIndex } = await import('../../analyzer/vector-index.js');
+    const { EmbeddingService } = await import('../../analyzer/embedding-service.js');
+    if (!VectorIndex.exists(outputDir)) {
+        return {
+            error: 'No vector index found. Run "openlore analyze --embed" first, ' +
+                'then configure EMBED_BASE_URL and EMBED_MODEL.',
+        };
+    }
+    // Resolve embedding service — fall back to BM25-only search if unavailable
+    let embedSvc = null;
+    let searchMode = 'hybrid';
+    try {
+        embedSvc = EmbeddingService.fromEnv();
+    }
+    catch {
+        const cfg = await readOpenLoreConfig(absDir);
+        const svcFromConfig = cfg ? EmbeddingService.fromConfig(cfg) : null;
+        if (svcFromConfig) {
+            embedSvc = svcFromConfig;
+        }
+        else {
+            searchMode = 'bm25_fallback';
+        }
+    }
+    limit = Math.max(1, Math.min(limit, 100));
+    const { readCachedContext } = await import('./utils.js');
+    const [results, mappingIdx, llmCtx] = await Promise.all([
+        VectorIndex.search(outputDir, query, embedSvc, { limit, language, minFanIn }),
+        loadMappingIndex(absDir),
+        readCachedContext(absDir),
+    ]);
+    const specPeers = [];
+    if (mappingIdx) {
+        const resultFileSet = new Set(results.map((r) => r.record.filePath));
+        const seedDomains = new Set();
+        for (const r of results) {
+            for (const spec of specsForFile(mappingIdx, r.record.filePath))
+                seedDomains.add(spec.domain);
+        }
+        const seen = new Set();
+        for (const domain of seedDomains) {
+            for (const fn of functionsForDomain(mappingIdx, domain)) {
+                const key = `${fn.name}::${fn.file}`;
+                if (seen.has(key) || resultFileSet.has(fn.file))
+                    continue;
+                seen.add(key);
+                specPeers.push({ name: fn.name, filePath: fn.file, domain, requirement: fn.requirement });
+            }
+        }
+    }
+    return {
+        query,
+        searchMode,
+        ...(searchMode === 'bm25_fallback'
+            ? {
+                note: 'Embedding server unavailable — results based on keyword matching only. Configure EMBED_BASE_URL + EMBED_MODEL for semantic search.',
+            }
+            : {}),
+        count: results.length,
+        results: results.map((r) => ({
+            score: r.score,
+            name: r.record.name,
+            filePath: r.record.filePath,
+            className: r.record.className || undefined,
+            language: r.record.language,
+            signature: r.record.signature || undefined,
+            docstring: r.record.docstring || undefined,
+            fanIn: r.record.fanIn,
+            fanOut: r.record.fanOut,
+            isHub: r.record.isHub,
+            isEntryPoint: r.record.isEntryPoint,
+            linkedSpecs: mappingIdx ? specsForFile(mappingIdx, r.record.filePath) : undefined,
+            callers: llmCtx?.edgeStore
+                ? llmCtx.edgeStore.getCallers(r.record.id)
+                    .map(e => { const n = llmCtx.edgeStore.getNode(e.callerId); return n && !n.isExternal ? { name: n.name, filePath: n.filePath } : null; })
+                    .filter((x) => x !== null)
+                : undefined,
+            callees: llmCtx?.edgeStore
+                ? llmCtx.edgeStore.getCallees(r.record.id)
+                    .map(e => { const n = llmCtx.edgeStore.getNode(e.calleeId); return n && !n.isExternal ? { name: n.name, filePath: n.filePath } : null; })
+                    .filter((x) => x !== null)
+                : undefined,
+        })),
+        ...(specPeers.length > 0 ? { specLinkedFunctions: specPeers } : {}),
+    };
+}
+/**
+ * Find the best places in the codebase to implement a new feature.
+ */
+export async function handleSuggestInsertionPoints(directory, description, limit = 5, language) {
+    const absDir = await validateDirectory(directory);
+    const outputDir = join(absDir, OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR);
+    const { VectorIndex } = await import('../../analyzer/vector-index.js');
+    const { EmbeddingService } = await import('../../analyzer/embedding-service.js');
+    if (!VectorIndex.exists(outputDir)) {
+        return {
+            error: 'No vector index found. Run "openlore analyze --embed" first, ' +
+                'then configure EMBED_BASE_URL and EMBED_MODEL.',
+        };
+    }
+    let embedSvc;
+    try {
+        embedSvc = EmbeddingService.fromEnv();
+    }
+    catch {
+        const cfg = await readOpenLoreConfig(absDir);
+        if (!cfg) {
+            return {
+                error: 'No embedding configuration found. Set EMBED_BASE_URL and EMBED_MODEL env vars, or add an "embedding" section to .openlore/config.json.',
+            };
+        }
+        const svcFromConfig = EmbeddingService.fromConfig(cfg);
+        if (!svcFromConfig) {
+            return {
+                error: 'No embedding configuration found. Set EMBED_BASE_URL and EMBED_MODEL env vars, or add an "embedding" section to .openlore/config.json.',
+            };
+        }
+        embedSvc = svcFromConfig;
+    }
+    limit = Math.max(1, Math.min(limit, 20));
+    const { readCachedContext } = await import('./utils.js');
+    const [rawResults, llmCtx] = await Promise.all([
+        VectorIndex.search(outputDir, description, embedSvc, { limit: limit * 4, language }),
+        readCachedContext(absDir),
+    ]);
+    // Normalise search scores to [0, 1] for compositeScore (scores are RRF/BM25: higher = better)
+    const maxScore = rawResults.length > 0 ? Math.max(...rawResults.map((r) => r.score)) : 1;
+    const normalise = (s) => (maxScore > 0 ? s / maxScore : 0);
+    const candidates = rawResults.map((r) => {
+        const role = classifyRole(r.record.fanIn, r.record.fanOut, r.record.isHub, r.record.isEntryPoint);
+        const strategy = deriveStrategy(role);
+        const score = compositeScore(normalise(r.score), role);
+        return {
+            rank: 0,
+            score,
+            semanticScore: r.score,
+            name: r.record.name,
+            filePath: r.record.filePath,
+            className: r.record.className || undefined,
+            language: r.record.language,
+            signature: r.record.signature || undefined,
+            docstring: r.record.docstring || undefined,
+            role,
+            insertionStrategy: strategy,
+            reason: buildReason(r.record.name, role, strategy, r.record.fanIn, r.record.fanOut),
+            fanIn: r.record.fanIn,
+            fanOut: r.record.fanOut,
+            isHub: r.record.isHub,
+            isEntryPoint: r.record.isEntryPoint,
+        };
+    });
+    // RIG-13 — Graph expansion: add depth-1 callers of semantic seed functions.
+    if (llmCtx?.edgeStore) {
+        const seedIds = new Set(rawResults.map((r) => r.record.id));
+        const existingIds = new Set(candidates.map((c) => `${c.filePath}::${c.name}`));
+        for (const seedResult of rawResults) {
+            const callerIds = llmCtx.edgeStore.getCallers(seedResult.record.id).map(e => e.callerId);
+            for (const callerId of callerIds) {
+                const callerNode = llmCtx.edgeStore.getNode(callerId);
+                if (!callerNode)
+                    continue;
+                const key = `${callerNode.filePath}::${callerNode.name}`;
+                if (existingIds.has(key) || seedIds.has(callerId))
+                    continue;
+                existingIds.add(key);
+                const role = classifyRole(callerNode.fanIn, callerNode.fanOut, false, false);
+                const strategy = deriveStrategy(role);
+                // Graph-expanded candidates score slightly lower than the semantic seed
+                const score = compositeScore(seedResult.score + 0.15, role) * 0.85;
+                candidates.push({
+                    rank: 0,
+                    score,
+                    semanticScore: seedResult.score + 0.15,
+                    name: callerNode.name,
+                    filePath: callerNode.filePath,
+                    className: callerNode.className,
+                    language: callerNode.language,
+                    signature: undefined,
+                    docstring: undefined,
+                    role,
+                    insertionStrategy: strategy,
+                    reason: `${callerNode.name} calls ${seedResult.record.name} (semantically close to your feature). Adding logic here propagates to the domain.`,
+                    fanIn: callerNode.fanIn,
+                    fanOut: callerNode.fanOut,
+                    isHub: false,
+                    isEntryPoint: false,
+                });
+            }
+        }
+    }
+    candidates.sort((a, b) => b.score - a.score);
+    const top = candidates.slice(0, limit).map((c, i) => ({ ...c, rank: i + 1 }));
+    return {
+        description,
+        count: top.length,
+        candidates: top,
+        nextSteps: top.length > 0
+            ? [
+                `Run get_function_skeleton on "${top[0].filePath}" to see the internal structure of ${top[0].name}`,
+                `Run get_subgraph on "${top[0].name}" to understand its call neighborhood`,
+                `After implementing, run check_spec_drift to verify the code matches the spec`,
+            ]
+            : [
+                'No candidates found. Try a broader description or run "openlore analyze --embed" to build the index.',
+            ],
+    };
+}
+/**
+ * Return the full content of a spec domain's spec.md plus its mapping entries.
+ */
+export async function handleGetSpec(directory, domain) {
+    const { existsSync } = await import('node:fs');
+    const { readFile } = await import('node:fs/promises');
+    const { join: pjoin } = await import('node:path');
+    const absDir = await validateDirectory(directory);
+    const specFile = pjoin(absDir, 'openspec', 'specs', domain, 'spec.md');
+    if (!existsSync(specFile)) {
+        return {
+            error: `No spec found for domain "${domain}". Run list_spec_domains to see available domains.`,
+        };
+    }
+    const [content, mappingIdx] = await Promise.all([
+        readFile(specFile, 'utf-8'),
+        loadMappingIndex(absDir),
+    ]);
+    const linkedFunctions = mappingIdx ? functionsForDomain(mappingIdx, domain) : undefined;
+    return {
+        domain,
+        specFile: `openspec/specs/${domain}/spec.md`,
+        content,
+        linkedFunctions,
+    };
+}
+/**
+ * List all spec domains available in the project (reads openspec/specs/ directory).
+ * Useful for the agent to discover what domains exist before doing a targeted search.
+ */
+export async function handleListSpecDomains(directory) {
+    const { readdir } = await import('node:fs/promises');
+    const { join: pjoin } = await import('node:path');
+    const absDir = await validateDirectory(directory);
+    const specsDir = pjoin(absDir, OPENSPEC_DIR, OPENSPEC_SPECS_SUBDIR);
+    if (!(await fileExists(specsDir))) {
+        return {
+            domains: [],
+            note: 'No openspec/specs/ directory found. Run "openlore generate" first.',
+        };
+    }
+    let entries;
+    try {
+        entries = await readdir(specsDir);
+    }
+    catch {
+        return { domains: [] };
+    }
+    const domainChecks = await Promise.all(entries.map((e) => fileExists(pjoin(specsDir, e, 'spec.md'))));
+    const domains = entries.filter((_, i) => domainChecks[i]);
+    return { domains, count: domains.length };
+}
+/**
+ * Semantic search over the spec index built by "openlore analyze --embed"
+ * or "openlore analyze --reindex-specs".
+ */
+export async function handleSearchSpecs(directory, query, limit = 10, domain, section) {
+    const absDir = await validateDirectory(directory);
+    const outputDir = join(absDir, OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR);
+    const { SpecVectorIndex } = await import('../../analyzer/spec-vector-index.js');
+    const { EmbeddingService } = await import('../../analyzer/embedding-service.js');
+    if (!SpecVectorIndex.exists(outputDir)) {
+        return {
+            error: 'No spec index found. Run "openlore analyze --embed" or "openlore analyze --reindex-specs" first, ' +
+                'then configure EMBED_BASE_URL and EMBED_MODEL.',
+        };
+    }
+    let embedSvc;
+    try {
+        embedSvc = EmbeddingService.fromEnv();
+    }
+    catch {
+        const cfg = await readOpenLoreConfig(absDir);
+        if (!cfg) {
+            return {
+                error: 'No embedding configuration found. Set EMBED_BASE_URL and EMBED_MODEL env vars, or add an "embedding" section to .openlore/config.json.',
+            };
+        }
+        const svcFromConfig = EmbeddingService.fromConfig(cfg);
+        if (!svcFromConfig) {
+            return {
+                error: 'No embedding configuration found. Set EMBED_BASE_URL and EMBED_MODEL env vars, or add an "embedding" section to .openlore/config.json.',
+            };
+        }
+        embedSvc = svcFromConfig;
+    }
+    limit = Math.max(1, Math.min(limit, 50));
+    const [results, mappingIdx] = await Promise.all([
+        SpecVectorIndex.search(outputDir, query, embedSvc, { limit, domain, section }),
+        loadMappingIndex(absDir),
+    ]);
+    return {
+        query,
+        count: results.length,
+        results: results.map((r) => ({
+            score: r.score,
+            id: r.record.id,
+            domain: r.record.domain,
+            section: r.record.section,
+            title: r.record.title,
+            text: r.record.text,
+            linkedFiles: r.record.linkedFiles,
+            linkedFunctions: mappingIdx ? functionsForDomain(mappingIdx, r.record.domain) : undefined,
+        })),
+    };
+}
+/**
+ * Unified search that combines code and spec indexes with cross-scoring
+ */
+export async function handleUnifiedSearch(directory, query, limit = 10, language, domain, section) {
+    const absDir = await validateDirectory(directory);
+    const outputDir = join(absDir, OPENLORE_DIR, OPENLORE_ANALYSIS_SUBDIR);
+    const { UnifiedSearch, unifiedSearchAvailable } = await import('../../analyzer/unified-search.js');
+    const { EmbeddingService } = await import('../../analyzer/embedding-service.js');
+    if (!(await unifiedSearchAvailable(outputDir))) {
+        return {
+            error: 'No unified search available. Run "openlore analyze --embed" first, ' +
+                'then configure EMBED_BASE_URL and EMBED_MODEL.',
+        };
+    }
+    // Resolve embedding service
+    let embedSvc = null;
+    try {
+        embedSvc = EmbeddingService.fromEnv();
+    }
+    catch {
+        const cfg = await readOpenLoreConfig(absDir);
+        const svcFromConfig = cfg ? EmbeddingService.fromConfig(cfg) : null;
+        if (svcFromConfig) {
+            embedSvc = svcFromConfig;
+        }
+    }
+    limit = Math.max(1, Math.min(limit, 50));
+    const results = await UnifiedSearch.unifiedSearch(outputDir, query, embedSvc, {
+        limit,
+        language,
+        domain,
+        section,
+    });
+    return {
+        query,
+        count: results.length,
+        results,
+    };
+}
+//# sourceMappingURL=semantic.js.map

package/dist/core/services/mcp-handlers/semantic.js.map

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

package/dist/core/services/mcp-handlers/utils.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Shared utilities for MCP tool handlers.
+ */
+import type { LLMContext } from '../../analyzer/artifact-generator.js';
+import { EdgeStore } from '../edge-store.js';
+/** LLMContext with optional SQLite edge store attached (present when call-graph.db exists). */
+export type CachedContext = LLMContext & {
+    edgeStore?: EdgeStore;
+};
+/**
+ * Resolve and validate a user-supplied directory path.
+ *
+ * Ensures the path resolves to an existing directory, which prevents path
+ * traversal attacks where a client supplies `"../../../../etc"` or a plain
+ * file path instead of a project directory.
+ */
+export declare function validateDirectory(directory: string, maxDepth?: number): Promise<string>;
+export declare function validateDirectoryImpl(directory: string, maxDepth?: number): Promise<string>;
+export declare function validateDirectoryDepth(absDir: string, maxDepth: number): void;
+/**
+ * Strip common API key and token patterns from an error message before
+ * returning it to MCP clients, to prevent secret leakage via error responses.
+ *
+ * @param err - The error to sanitize
+ * @param format - Output format: "string" (default) or "json"
+ * @returns Sanitized error as string or {message, code} object when format is "json"
+ */
+export declare function sanitizeMcpError(err: unknown, format?: 'string' | 'json'): string | {
+    message: string;
+    code: number;
+};
+/**
+ * Resolve a user-supplied relative file path against a validated project root
+ * and ensure the result stays within that root. Prevents path traversal via
+ * `../` sequences.
+ */
+export declare function safeJoin(absDir: string, filePath: string): string;
+export declare function readCachedContext(directory: string, timeout?: number): Promise<CachedContext | null>;
+/** Compute a SHA-256 fingerprint of all source file mtimes+sizes under rootDir. */
+export declare function computeProjectFingerprint(rootDir: string): Promise<string>;
+/**
+ * Returns true if the cached analysis matches the current source files.
+ * Uses content-hash fingerprint when available; falls back to TTL check.
+ */
+export declare function isCacheFresh(directory: string): Promise<boolean>;
+export interface MappingEntry {
+    requirement: string;
+    service: string;
+    domain: string;
+    specFile: string;
+    functions: Array<{
+        name: string;
+        file: string;
+        line: number;
+        kind: string;
+        confidence: string;
+    }>;
+}
+export interface MappingIndex {
+    /** filePath → list of mapping entries that reference it */
+    byFile: Map<string, MappingEntry[]>;
+    /** domain → list of mapping entries for that domain */
+    byDomain: Map<string, MappingEntry[]>;
+    entries: MappingEntry[];
+}
+/** Load and index mapping.json for bidirectional lookup. Returns null if not found. */
+export declare function loadMappingIndex(absDir: string, retryCount?: number): Promise<MappingIndex | null>;
+/** Clear the mapping cache. Useful for tests to reset state. */
+export declare function clearMappingCache(): void;
+/** Summarise which specs cover a given file path (for search_code enrichment). */
+export declare function specsForFile(index: MappingIndex, filePath: string): Array<{
+    requirement: string;
+    domain: string;
+    specFile: string;
+}>;
+/** Return functions that implement a given domain/specFile (for search_specs enrichment). */
+export declare function functionsForDomain(index: MappingIndex, domain: string): Array<{
+    name: string;
+    file: string;
+    line: number;
+    kind: string;
+    confidence: string;
+    requirement: string;
+}>;
+//# sourceMappingURL=utils.d.ts.map

package/dist/core/services/mcp-handlers/utils.d.ts.map

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