@securecode-ai/mcp 0.5.5 → 0.5.7

package/dist/project-map/implementationResolver.js

@@ -0,0 +1,217 @@
+"use strict";
+/**
+ * Implementation resolver — generic interface-to-implementation redirection.
+ *
+ * When the agent scans an interface, type declaration, or service contract,
+ * the resolver finds the actual implementation files and symbols so the
+ * investigation can continue on real code, not signatures.
+ *
+ * Matching strategies (all generic, no project-specific logic):
+ *   - TypeScript interface → classes that implement it
+ *   - Effect service declaration → live layer implementations
+ *   - Abstract classes → subclasses
+ *   - Exported type → functions returning the type
+ *   - Route contracts → handler registrations
+ *   - Python protocols/abstract classes → implementations (when symbol data supports it)
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveImplementation = resolveImplementation;
+exports.formatImplementationResolution = formatImplementationResolution;
+exports.looksLikeContractOnly = looksLikeContractOnly;
+const searchCode_1 = require("../utils/searchCode");
+const symbolIndex_1 = require("./symbolIndex");
+/**
+ * Resolve implementations for a symbol in a contract/interface file.
+ *
+ * This is a generic search — it uses workspace-wide code search to find
+ * patterns that indicate implementation of the given symbol.
+ */
+async function resolveImplementation(workspaceRoot, filePath, symbol) {
+    const contractLocations = [];
+    const implementationLocations = [];
+    const callSites = [];
+    // Strategy 1: Search for the symbol as a class/interface name being
+    // implemented or extended (TypeScript: implements, extends)
+    const implPatterns = [
+        `implements\\s+${escapeRegex(symbol)}\\b`,
+        `extends\\s+${escapeRegex(symbol)}\\b`,
+        `:\\s+${escapeRegex(symbol)}\\s*\\{`,
+        `Layer\\.(effect|set)\\s*\\(\\s*["']${escapeRegex(symbol)}["']`,
+        `Context\\.(Function|Service)\\s*\\(\\s*["']${escapeRegex(symbol)}["']`,
+    ];
+    for (const pattern of implPatterns) {
+        const results = await (0, searchCode_1.searchCode)(workspaceRoot, pattern, '*.ts');
+        for (const hit of results.hits) {
+            implementationLocations.push({
+                filePath: hit.path,
+                line: hit.line,
+                symbol: extractSymbolFromLine(hit.text, symbol),
+            });
+        }
+    }
+    // Strategy 2: Search for "make" + symbol (common Effect pattern: makeServerAuth)
+    const makePattern = `make${escapeRegex(symbol)}`;
+    const makeResults = await (0, searchCode_1.searchCode)(workspaceRoot, makePattern, '*.ts');
+    for (const hit of makeResults.hits) {
+        // Avoid the contract file itself
+        if (!sameFile(hit.path, filePath)) {
+            implementationLocations.push({
+                filePath: hit.path,
+                line: hit.line,
+                symbol: `make${symbol}`,
+            });
+        }
+    }
+    // Strategy 3: Find references (call sites) using the symbol index
+    try {
+        const refsText = await (0, symbolIndex_1.findReferences)(workspaceRoot, filePath, symbol);
+        const refLines = refsText.split('\n');
+        for (const line of refLines) {
+            const match = line.match(/^\s+(\S+):(\d+)/);
+            if (match) {
+                callSites.push({
+                    filePath: match[1],
+                    line: parseInt(match[2], 10),
+                });
+            }
+        }
+    }
+    catch {
+        // Best effort — references are optional
+    }
+    // Strategy 4: Find the definition (contract location)
+    try {
+        const defText = await (0, symbolIndex_1.findDefinition)(workspaceRoot, filePath, symbol);
+        const defLines = defText.split('\n');
+        for (const line of defLines) {
+            const match = line.match(/^\s+(\S+):(\d+)/);
+            if (match) {
+                contractLocations.push({
+                    filePath: match[1],
+                    line: parseInt(match[2], 10),
+                    symbol,
+                });
+            }
+        }
+    }
+    catch {
+        // Best effort
+    }
+    // Deduplicate implementation locations
+    const unique = deduplicateLocations(implementationLocations);
+    return {
+        contractLocations,
+        implementationLocations: unique,
+        callSites: deduplicateLocations(callSites),
+        unresolved: unique.length === 0,
+        description: unique.length > 0
+            ? `Found ${unique.length} implementation(s) for ${symbol}`
+            : `No implementations found for ${symbol}`,
+    };
+}
+/**
+ * Format an implementation resolution for the agent transcript.
+ */
+function formatImplementationResolution(resolution) {
+    const lines = [];
+    if (resolution.unresolved) {
+        lines.push(`No implementations found. The target may be a contract-only file.`);
+        lines.push('');
+        lines.push('Consider:');
+        lines.push('  - Searching for functions that return or produce this type');
+        lines.push('  - Checking if the file is a type-only export');
+        lines.push('  - Looking for runtime registration or dependency injection');
+        return lines.join('\n');
+    }
+    lines.push(`Implementation resolution (${resolution.implementationLocations.length} location(s)):`);
+    for (const loc of resolution.implementationLocations) {
+        lines.push(`  ${loc.filePath}:${loc.line}${loc.symbol ? ` (${loc.symbol})` : ''}`);
+    }
+    if (resolution.callSites.length > 0) {
+        lines.push('');
+        lines.push(`Call sites (${resolution.callSites.length}):`);
+        for (const loc of resolution.callSites.slice(0, 10)) {
+            lines.push(`  ${loc.filePath}:${loc.line}`);
+        }
+        if (resolution.callSites.length > 10) {
+            lines.push(`  ... and ${resolution.callSites.length - 10} more`);
+        }
+    }
+    return lines.join('\n');
+}
+/**
+ * Check if a file looks like a contract/interface/type declaration only
+ * (has no runtime implementation). Generic heuristic, not project-specific.
+ */
+function looksLikeContractOnly(content) {
+    const lines = content.split('\n');
+    let typeDeclarations = 0;
+    let runtimeCode = 0;
+    for (const line of lines) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('//') || trimmed.startsWith('*'))
+            continue;
+        // Type/interface declarations
+        if (/^(export\s+)?(interface|type|abstract\s+class)\s/.test(trimmed)) {
+            typeDeclarations++;
+            continue;
+        }
+        // Effect service/context declarations (contract-like)
+        if (/^(export\s+)?(const|class)\s+\w+\s*=\s*(Context|Service)\.(Function|Service)\(/.test(trimmed)) {
+            typeDeclarations++;
+            continue;
+        }
+        // Function/class implementations (runtime code)
+        if (/^(export\s+)?(async\s+)?function\s+\w+/.test(trimmed) ||
+            /^(export\s+)?(const|let|var)\s+\w+\s*=\s*(async\s*)?\(/.test(trimmed) ||
+            /^(export\s+)?class\s+\w+\s*(implements|extends)/.test(trimmed)) {
+            // Exclude Effect service declarations (contract-like, not implementations)
+            if (/extends\s+Service\.Service/.test(trimmed)) {
+                typeDeclarations++;
+            }
+            else {
+                runtimeCode++;
+            }
+            continue;
+        }
+        // Layer implementations (runtime)
+        if (/^(export\s+)?const\s+\w+\s*=\s*Layer\.(effect|set|succeed|fail)/.test(trimmed)) {
+            runtimeCode++;
+            continue;
+        }
+    }
+    // Contract-only if there are type declarations but no runtime code
+    return typeDeclarations > 0 && runtimeCode === 0;
+}
+function escapeRegex(s) {
+    return s.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+}
+function sameFile(a, b) {
+    return a.replace(/\\/g, '/').toLowerCase() === b.replace(/\\/g, '/').toLowerCase();
+}
+function extractSymbolFromLine(text, contractSymbol) {
+    // Try to extract the implementing class/function name
+    const classMatch = text.match(/class\s+(\w+)/);
+    if (classMatch)
+        return classMatch[1];
+    const funcMatch = text.match(/function\s+(\w+)/);
+    if (funcMatch)
+        return funcMatch[1];
+    const constMatch = text.match(/(?:const|let|var)\s+(\w+)/);
+    if (constMatch)
+        return constMatch[1];
+    return undefined;
+}
+function deduplicateLocations(locs) {
+    const seen = new Set();
+    const result = [];
+    for (const loc of locs) {
+        const key = `${loc.filePath}:${loc.line}`;
+        if (!seen.has(key)) {
+            seen.add(key);
+            result.push(loc);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=implementationResolver.js.map

package/dist/project-map/implementationResolver.js.map

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

package/dist/project-map/mapContext.d.ts

@@ -1,4 +1,9 @@
-import { type EndpointContext, type RelatedFile } from './types';
+import { type EndpointContext, type ProjectMap, type RelatedFile } from './types';
+/**
+ * Get the project map — from cache if available, or build + cache if not.
+ * Returns null on any failure (best-effort).
+ */
+export declare function getMap(workspaceRoot: string): Promise<ProjectMap | null>;
 /**
  * Get the EndpointContext for every endpoint in the given file.
  * Returns [] if the file isn't in the map (no endpoints or map unavailable).

package/dist/project-map/mapContext.js

@@ -33,6 +33,7 @@ var __importStar = (this && this.__importStar) || (function () {
     };
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.getMap = getMap;
 exports.getEndpointContextForFile = getEndpointContextForFile;
 exports.getRelatedFilesForFile = getRelatedFilesForFile;
 /**

package/dist/project-map/mapContext.js.map

@@ -1 +1 @@
-{"version":3,"file":"mapContext.js","sourceRoot":"","sources":["../../src/project-map/mapContext.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAqCA,8DAYC;AAMD,wDAQC;AA/DD;;;;;;;;;GASG;AACH,2CAA6B;AAC7B,mCAAgD;AAChD,6CAA+C;AAC/C,iDAAqD;AACrD,mCAAqG;AAErG;;;GAGG;AACH,KAAK,UAAU,MAAM,CAAC,aAAqB;IACvC,IAAI,GAAG,GAAG,IAAA,iBAAS,EAAC,aAAa,CAAC,CAAC;IACnC,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAEpB,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAA,4BAAe,EAAC,EAAE,aAAa,EAAE,CAAC,CAAC;QACxD,IAAA,kBAAU,EAAC,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC,GAAG,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,yBAAyB,CAC3C,QAAgB,EAChB,aAAqB;IAErB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAE1B,OAAO,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,yBAAiB,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,sBAAsB,CACxC,QAAgB,EAChB,aAAqB;IAErB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,OAAO,IAAA,kCAAmB,EAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;AACjE,CAAC"}
+{"version":3,"file":"mapContext.js","sourceRoot":"","sources":["../../src/project-map/mapContext.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoBA,wBAWC;AAMD,8DAYC;AAMD,wDAQC;AA/DD;;;;;;;;;GASG;AACH,2CAA6B;AAC7B,mCAAgD;AAChD,6CAA+C;AAC/C,iDAAqD;AACrD,mCAAqG;AAErG;;;GAGG;AACI,KAAK,UAAU,MAAM,CAAC,aAAqB;IAC9C,IAAI,GAAG,GAAG,IAAA,iBAAS,EAAC,aAAa,CAAC,CAAC;IACnC,IAAI,GAAG;QAAE,OAAO,GAAG,CAAC;IAEpB,IAAI,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAA,4BAAe,EAAC,EAAE,aAAa,EAAE,CAAC,CAAC;QACxD,IAAA,kBAAU,EAAC,aAAa,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QACtC,OAAO,MAAM,CAAC,GAAG,CAAC;IACtB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,yBAAyB,CAC3C,QAAgB,EAChB,aAAqB;IAErB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,MAAM,GAAG,GAAG,IAAI,CAAC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjC,IAAI,CAAC,SAAS;QAAE,OAAO,EAAE,CAAC;IAE1B,OAAO,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,yBAAiB,CAAC,CAAC;AACtD,CAAC;AAED;;;GAGG;AACI,KAAK,UAAU,sBAAsB,CACxC,QAAgB,EAChB,aAAqB;IAErB,MAAM,GAAG,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IAEpB,OAAO,IAAA,kCAAmB,EAAC,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,CAAC,CAAC;AACjE,CAAC"}

package/dist/project-map/scanCache.d.ts

@@ -14,8 +14,16 @@
  * Bump this when the agent scan prompt or logic changes in a way that
  * would produce different findings for the same file. All cached entries
  * with an older version are invalidated.
+ *
+ * v22 → v23: Architecture scout context integration.
+ * v23 → v24: Added fix re-verification (fixVerification field, new fixStatus
+ * values) + human review queue (reviewStatus, reviewId fields). Cached
+ * findings from v23 lack these fields and must be re-scanned.
+ * v24 → v25: Precision evidence model — investigationNotes, coverageGaps,
+ * evidenceChain, rootCause, verificationLevel on findings. Cached results
+ * from v24 lack these fields and must be re-scanned.
  */
-export declare const AGENT_SCAN_CACHE_VERSION = 20;
+export declare const AGENT_SCAN_CACHE_VERSION = 31;
 export interface ScanCacheEntry {
     /** SHA-256 of the file content at scan time. */
     fileHash: string;
@@ -25,16 +33,30 @@ export interface ScanCacheEntry {
     timestamp: number;
     /** The findings from the scan. */
     findings: any[];
+    /** Investigated but unproven concerns. */
+    investigationNotes?: any[];
+    /** Areas that were not sufficiently investigated. */
+    coverageGaps?: any[];
     /** Scan status (completed, capped, etc.). */
     status: string;
     /** Summary from the agent. */
     summary?: string;
     /** Steps used by the agent. */
     stepsUsed: number;
-    /** Cost in USD. */
+    stepsGranted?: number;
+    extensionsGranted?: number;
     costSpentUsd: number;
     /** File path (for debugging). */
     filePath: string;
+    /**
+     * SHA-256 fingerprint of the agent-memory false-positive list at scan
+     * time. If the current memory fingerprint differs, the cache hit must
+     * be filtered through the current memory before returning (see
+     * filterCachedFindingsAgainstMemory). Pre-fix entries have no
+     * memoryHash and are treated as "memory state unknown" — filtered
+     * unconditionally with current memory.
+     */
+    memoryHash?: string;
 }
 export interface ScanCacheData {
     version: number;
@@ -55,11 +77,43 @@ export declare function getCachedScan(workspaceRoot: string, filePath: string, c
  */
 export declare function writeCachedScan(workspaceRoot: string, filePath: string, content: string, result: {
     findings: any[];
+    investigationNotes?: any[];
+    coverageGaps?: any[];
     status: string;
     summary?: string;
     stepsUsed: number;
+    stepsGranted?: number;
+    extensionsGranted?: number;
     costSpentUsd: number;
-}): void;
+}, memoryHash?: string): void;
+/**
+ * Compute a deterministic fingerprint of the agent-memory false-positive
+ * list. Used as part of the cache key so changes to dismissed findings
+ * invalidate (or filter) cached scan results.
+ *
+ * Only false positives are part of the fingerprint — known facts help the
+ * agent investigate faster but don't change which findings are legitimately
+ * reportable. The fingerprint is a sha256 over `findingType|evidenceHash`
+ * pairs, sorted for stability.
+ */
+export declare function computeMemoryFingerprint(falsePositives: Array<{
+    findingType: string;
+    evidenceHash: string;
+}>): string;
+/**
+ * Filter a list of cached findings against current agent memory.
+ * Drops any finding whose (findingType, evidence-hash-prefix) matches a
+ * dismissed false positive. The evidence hash here is a prefix of the
+ * full sha256 — we don't have the original evidence string in memory after
+ * a reload, only the stored hash, so we match on the hash alone (which is
+ * already content-derived).
+ *
+ * Returns the filtered list. Does NOT mutate the input.
+ */
+export declare function filterCachedFindingsAgainstMemory(findings: any[], falsePositives: Array<{
+    findingType: string;
+    evidenceHash: string;
+}>): any[];
 /**
  * Clear the scan cache for a workspace (e.g., when the user requests
  * a fresh scan with --no-cache).

package/dist/project-map/scanCache.js

@@ -49,6 +49,8 @@ exports.AGENT_SCAN_CACHE_VERSION = void 0;
 exports.readScanCache = readScanCache;
 exports.getCachedScan = getCachedScan;
 exports.writeCachedScan = writeCachedScan;
+exports.computeMemoryFingerprint = computeMemoryFingerprint;
+exports.filterCachedFindingsAgainstMemory = filterCachedFindingsAgainstMemory;
 exports.clearScanCache = clearScanCache;
 const fs = __importStar(require("fs"));
 const path = __importStar(require("path"));
@@ -59,8 +61,16 @@ const CACHE_FILE = 'scan-cache.json';
  * Bump this when the agent scan prompt or logic changes in a way that
  * would produce different findings for the same file. All cached entries
  * with an older version are invalidated.
+ *
+ * v22 → v23: Architecture scout context integration.
+ * v23 → v24: Added fix re-verification (fixVerification field, new fixStatus
+ * values) + human review queue (reviewStatus, reviewId fields). Cached
+ * findings from v23 lack these fields and must be re-scanned.
+ * v24 → v25: Precision evidence model — investigationNotes, coverageGaps,
+ * evidenceChain, rootCause, verificationLevel on findings. Cached results
+ * from v24 lack these fields and must be re-scanned.
  */
-exports.AGENT_SCAN_CACHE_VERSION = 20;
+exports.AGENT_SCAN_CACHE_VERSION = 31;
 /** Cache TTL: 7 days. Findings older than this are re-scanned. */
 const CACHE_TTL_MS = 7 * 24 * 60 * 60 * 1000;
 function cachePath(workspaceRoot) {
@@ -113,7 +123,7 @@ function getCachedScan(workspaceRoot, filePath, content) {
 /**
  * Write a scan result to the cache. Merges with existing entries.
  */
-function writeCachedScan(workspaceRoot, filePath, content, result) {
+function writeCachedScan(workspaceRoot, filePath, content, result, memoryHash) {
     const dir = path.join(workspaceRoot, CACHE_DIR);
     if (!fs.existsSync(dir)) {
         fs.mkdirSync(dir, { recursive: true });
@@ -142,11 +152,16 @@ function writeCachedScan(workspaceRoot, filePath, content, result) {
         version: exports.AGENT_SCAN_CACHE_VERSION,
         timestamp: now,
         findings: result.findings,
+        investigationNotes: result.investigationNotes,
+        coverageGaps: result.coverageGaps,
         status: result.status,
         summary: result.summary,
         stepsUsed: result.stepsUsed,
+        stepsGranted: result.stepsGranted,
+        extensionsGranted: result.extensionsGranted,
         costSpentUsd: result.costSpentUsd,
         filePath,
+        memoryHash,
     };
     // Atomic write
     const p = cachePath(workspaceRoot);
@@ -154,6 +169,50 @@ function writeCachedScan(workspaceRoot, filePath, content, result) {
     fs.writeFileSync(tmp, JSON.stringify(cache, null, 2), 'utf8');
     fs.renameSync(tmp, p);
 }
+/**
+ * Compute a deterministic fingerprint of the agent-memory false-positive
+ * list. Used as part of the cache key so changes to dismissed findings
+ * invalidate (or filter) cached scan results.
+ *
+ * Only false positives are part of the fingerprint — known facts help the
+ * agent investigate faster but don't change which findings are legitimately
+ * reportable. The fingerprint is a sha256 over `findingType|evidenceHash`
+ * pairs, sorted for stability.
+ */
+function computeMemoryFingerprint(falsePositives) {
+    if (!falsePositives || falsePositives.length === 0)
+        return '';
+    const lines = falsePositives
+        .map(fp => `${fp.findingType}|${fp.evidenceHash}`)
+        .sort()
+        .join('\n');
+    return crypto.createHash('sha256').update(lines).digest('hex').slice(0, 16);
+}
+/**
+ * Filter a list of cached findings against current agent memory.
+ * Drops any finding whose (findingType, evidence-hash-prefix) matches a
+ * dismissed false positive. The evidence hash here is a prefix of the
+ * full sha256 — we don't have the original evidence string in memory after
+ * a reload, only the stored hash, so we match on the hash alone (which is
+ * already content-derived).
+ *
+ * Returns the filtered list. Does NOT mutate the input.
+ */
+function filterCachedFindingsAgainstMemory(findings, falsePositives) {
+    if (!falsePositives || falsePositives.length === 0)
+        return findings;
+    // Index by (findingType, evidenceHash) for O(1) lookup.
+    const dismissed = new Set(falsePositives.map(fp => `${fp.findingType}|${fp.evidenceHash}`));
+    return findings.filter(f => {
+        // A finding is dismissed if both findingType and an evidence-derived
+        // hash match. The cached finding carries `evidence` (string), so we
+        // hash it the same way agentMemory does (sha256, 16 hex chars).
+        if (!f || !f.type || !f.evidence)
+            return true;
+        const evHash = crypto.createHash('sha256').update(String(f.evidence)).digest('hex').slice(0, 16);
+        return !dismissed.has(`${f.type}|${evHash}`);
+    });
+}
 /**
  * Clear the scan cache for a workspace (e.g., when the user requests
  * a fresh scan with --no-cache).

package/dist/project-map/scanCache.js.map

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

package/dist/project-map/symbolIndex.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Symbol index — structural find_definition and find_references across the
+ * workspace. Replaces regex-based search_code for "where is X defined?" and
+ * "who calls X?" questions.
+ *
+ * Two providers:
+ *   - TypeScriptProgramProvider: uses ts.createProgram for JS/TS/TSX —
+ *     accurate cross-file definition + references via the type system.
+ *   - TreeSitterProvider: uses tree-sitter AST for Python — intra-file
+ *     definition + workspace-wide reference search via identifier matching.
+ *
+ * Both return SymbolLocation[] with provider + confidence metadata.
+ */
+export interface SymbolQuery {
+    /** Workspace-relative file path where the symbol was referenced. */
+    filePath: string;
+    /** The symbol name to search for. */
+    symbol: string;
+    /** Optional 1-indexed line (for disambiguation). */
+    line?: number;
+    /** Optional 0-indexed column (for disambiguation). */
+    column?: number;
+}
+export interface SymbolLocation {
+    /** Workspace-relative file path. */
+    filePath: string;
+    /** 1-indexed line. */
+    line: number;
+    /** 1-indexed column (0 if unknown). */
+    column: number;
+    /** The provider that produced this result. */
+    provider: 'typescript' | 'tree-sitter';
+    /** Confidence: 1.0 for TypeScript, 0.8 for tree-sitter. */
+    confidence: number;
+    /** What this location represents. */
+    kind: 'definition' | 'reference';
+}
+export declare function findDefinition(workspaceRoot: string, filePath: string, symbol: string, line?: number): Promise<string>;
+export declare function findReferences(workspaceRoot: string, filePath: string, symbol: string, line?: number): Promise<string>;