codeguardian-mcp 1.0.0

package/dist/context/contextLineage.d.ts

@@ -0,0 +1,79 @@
+/**
+ * Context Lineage - Git History-Based Context
+ *
+ * Inspired by Augment Code's context lineage feature.
+ * Uses git history to understand code evolution and prioritize
+ * symbols from recently modified files.
+ *
+ * @format
+ */
+export interface FileHistory {
+    filePath: string;
+    lastModified: Date;
+    commitCount: number;
+    recentCommits: string[];
+    authors: Set<string>;
+    changeFrequency: number;
+}
+export interface LineageContext {
+    recentlyModifiedFiles: string[];
+    hotspotFiles: string[];
+    relatedFiles: Map<string, string[]>;
+    fileHistories: Map<string, FileHistory>;
+}
+declare class ContextLineageClass {
+    private git;
+    private projectPath;
+    private cache;
+    private pendingFetch;
+    private readonly CACHE_TTL_MS;
+    /**
+     * Initialize git for a project
+     */
+    initialize(projectPath: string): Promise<void>;
+    /**
+     * Get lineage context for a project
+     */
+    getLineageContext(projectPath: string, options?: {
+        commitDepth?: number;
+        minChangeFrequency?: number;
+    }): Promise<LineageContext | null>;
+    private fetchLineageContext;
+    /**
+     * Get relevance score for a file based on git history
+     */
+    getFileLineageScore(filePath: string, context: LineageContext | null): number;
+    /**
+     * Get symbols from files related to a given file
+     */
+    getRelatedFileSymbols(filePath: string, context: LineageContext | null): string[];
+    /**
+     * Clear all caches
+     */
+    clear(): void;
+    /**
+     * Fetch file lists for all commits ONCE. Reused by buildFileHistories,
+     * getRecentlyModifiedFiles, and findRelatedFiles to avoid spawning
+     * redundant git subprocesses (was ~110 subprocesses, now ~50).
+     */
+    private fetchCommitFiles;
+    /**
+     * Build file histories from pre-fetched commit data (no git subprocesses)
+     */
+    private buildFileHistoriesFromCache;
+    /**
+     * Get files modified in recent commits from pre-fetched data (no git subprocesses)
+     */
+    private getRecentlyModifiedFilesFromCache;
+    /**
+     * Identify hotspot files (frequently changed)
+     */
+    private identifyHotspots;
+    /**
+     * Find files that are often changed together from pre-fetched data (no git subprocesses)
+     */
+    private findRelatedFilesFromCache;
+}
+export declare const contextLineage: ContextLineageClass;
+export {};
+//# sourceMappingURL=contextLineage.d.ts.map

package/dist/context/contextLineage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextLineage.d.ts","sourceRoot":"","sources":["../../src/context/contextLineage.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,IAAI,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,cAAc;IAC7B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACpC,aAAa,EAAE,GAAG,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;CACzC;AAED,cAAM,mBAAmB;IACvB,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,KAAK,CAA0C;IACvD,OAAO,CAAC,YAAY,CAA0D;IAC9E,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAkB;IAE/C;;OAEG;IACG,UAAU,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD;;OAEG;IACG,iBAAiB,CACrB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE;QACP,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,kBAAkB,CAAC,EAAE,MAAM,CAAC;KACxB,GACL,OAAO,CAAC,cAAc,GAAG,IAAI,CAAC;YAuBnB,mBAAmB;IA+DjC;;OAEG;IACH,mBAAmB,CACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GAAG,IAAI,GAC7B,MAAM;IA0BT;;OAEG;IACH,qBAAqB,CACnB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,cAAc,GAAG,IAAI,GAC7B,MAAM,EAAE;IAOX;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;;;OAIG;YACW,gBAAgB;IA0B9B;;OAEG;IACH,OAAO,CAAC,2BAA2B;IAiDnC;;OAEG;IACH,OAAO,CAAC,iCAAiC;IAkBzC;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAWxB;;OAEG;IACH,OAAO,CAAC,yBAAyB;CAwClC;AAGD,eAAO,MAAM,cAAc,qBAA4B,CAAC"}

package/dist/context/contextLineage.js

@@ -0,0 +1,259 @@
+/**
+ * Context Lineage - Git History-Based Context
+ *
+ * Inspired by Augment Code's context lineage feature.
+ * Uses git history to understand code evolution and prioritize
+ * symbols from recently modified files.
+ *
+ * @format
+ */
+import { simpleGit } from "simple-git";
+import { logger } from "../utils/logger.js";
+class ContextLineageClass {
+    git = null;
+    projectPath = "";
+    cache = new Map();
+    pendingFetch = new Map();
+    CACHE_TTL_MS = 10 * 60 * 1000; // 10 minutes
+    /**
+     * Initialize git for a project
+     */
+    async initialize(projectPath) {
+        this.projectPath = projectPath;
+        this.git = simpleGit(projectPath);
+    }
+    /**
+     * Get lineage context for a project
+     */
+    async getLineageContext(projectPath, options = {}) {
+        const { commitDepth = 50, minChangeFrequency = 0.1 } = options;
+        // Check cache
+        const cacheKey = `${projectPath}:${commitDepth}`;
+        const cached = this.cache.get(cacheKey);
+        if (cached) {
+            return cached;
+        }
+        // Lock: if another call is already fetching this, wait for it instead
+        // of spawning another ~50+ git subprocesses in parallel
+        const pending = this.pendingFetch.get(cacheKey);
+        if (pending) {
+            return pending;
+        }
+        const fetchPromise = this.fetchLineageContext(projectPath, cacheKey, commitDepth, minChangeFrequency);
+        this.pendingFetch.set(cacheKey, fetchPromise);
+        fetchPromise.finally(() => this.pendingFetch.delete(cacheKey));
+        return fetchPromise;
+    }
+    async fetchLineageContext(projectPath, cacheKey, commitDepth, minChangeFrequency) {
+        try {
+            if (!this.git || this.projectPath !== projectPath) {
+                await this.initialize(projectPath);
+            }
+            if (!this.git) {
+                return null;
+            }
+            // Check if we're in a git repo
+            const isRepo = await this.git.checkIsRepo();
+            if (!isRepo) {
+                logger.debug("Not a git repository, skipping lineage context");
+                return null;
+            }
+            // Get recent commits
+            const log = await this.git.log({ maxCount: commitDepth });
+            // Fetch commit file lists ONCE and reuse across all analyses.
+            // Previously buildFileHistories, getRecentlyModifiedFiles, and findRelatedFiles
+            // each called `git show` per commit independently — tripling subprocess count.
+            const commitFilesMap = await this.fetchCommitFiles(log);
+            // Build file histories (reuses pre-fetched data)
+            const fileHistories = this.buildFileHistoriesFromCache(log, commitFilesMap);
+            // Identify recently modified files (reuses pre-fetched data)
+            const recentlyModifiedFiles = this.getRecentlyModifiedFilesFromCache(log, commitFilesMap, 10);
+            // Identify hotspot files (high change frequency)
+            const hotspotFiles = this.identifyHotspots(fileHistories, minChangeFrequency);
+            // Find files often changed together (reuses pre-fetched data)
+            const relatedFiles = this.findRelatedFilesFromCache(log, commitFilesMap);
+            const context = {
+                recentlyModifiedFiles,
+                hotspotFiles,
+                relatedFiles,
+                fileHistories,
+            };
+            // Cache the result
+            this.cache.set(cacheKey, context);
+            setTimeout(() => this.cache.delete(cacheKey), this.CACHE_TTL_MS);
+            return context;
+        }
+        catch (error) {
+            logger.debug("Failed to get lineage context:", error);
+            return null;
+        }
+    }
+    /**
+     * Get relevance score for a file based on git history
+     */
+    getFileLineageScore(filePath, context) {
+        if (!context)
+            return 0;
+        let score = 0;
+        // Recently modified files get high score
+        const recentIndex = context.recentlyModifiedFiles.indexOf(filePath);
+        if (recentIndex !== -1) {
+            score += 0.8 - recentIndex * 0.05; // Decay with position
+        }
+        // Hotspot files (frequently changed) get medium score
+        if (context.hotspotFiles.includes(filePath)) {
+            score += 0.4;
+        }
+        // Files with high commit count get small boost
+        const history = context.fileHistories.get(filePath);
+        if (history) {
+            const commitBoost = Math.min(0.2, history.commitCount / 100);
+            score += commitBoost;
+        }
+        return Math.min(1.0, score);
+    }
+    /**
+     * Get symbols from files related to a given file
+     */
+    getRelatedFileSymbols(filePath, context) {
+        if (!context)
+            return [];
+        const related = context.relatedFiles.get(filePath) || [];
+        return related;
+    }
+    /**
+     * Clear all caches
+     */
+    clear() {
+        this.cache.clear();
+    }
+    /**
+     * Fetch file lists for all commits ONCE. Reused by buildFileHistories,
+     * getRecentlyModifiedFiles, and findRelatedFiles to avoid spawning
+     * redundant git subprocesses (was ~110 subprocesses, now ~50).
+     */
+    async fetchCommitFiles(log) {
+        const commitFilesMap = new Map();
+        if (!this.git)
+            return commitFilesMap;
+        for (const commit of log.all) {
+            try {
+                const diff = await this.git.show([
+                    "--name-only",
+                    "--format=",
+                    commit.hash,
+                ]);
+                const files = diff
+                    .split("\n")
+                    .filter((f) => f.trim() && !f.startsWith("diff"));
+                commitFilesMap.set(commit.hash, files);
+            }
+            catch (error) {
+                commitFilesMap.set(commit.hash, []);
+            }
+        }
+        return commitFilesMap;
+    }
+    /**
+     * Build file histories from pre-fetched commit data (no git subprocesses)
+     */
+    buildFileHistoriesFromCache(log, commitFilesMap) {
+        const histories = new Map();
+        for (const commit of log.all) {
+            const files = commitFilesMap.get(commit.hash) || [];
+            for (const file of files) {
+                if (!histories.has(file)) {
+                    histories.set(file, {
+                        filePath: file,
+                        lastModified: new Date(commit.date),
+                        commitCount: 0,
+                        recentCommits: [],
+                        authors: new Set(),
+                        changeFrequency: 0,
+                    });
+                }
+                const history = histories.get(file);
+                history.commitCount++;
+                if (history.recentCommits.length < 5) {
+                    history.recentCommits.push(commit.hash);
+                }
+                history.authors.add(commit.author_name);
+                // Update last modified if this commit is more recent
+                const commitDate = new Date(commit.date);
+                if (commitDate > history.lastModified) {
+                    history.lastModified = commitDate;
+                }
+            }
+        }
+        // Calculate change frequency (commits per day)
+        const now = Date.now();
+        for (const history of histories.values()) {
+            const daysSinceLastModified = (now - history.lastModified.getTime()) / (1000 * 60 * 60 * 24);
+            if (daysSinceLastModified > 0) {
+                history.changeFrequency = history.commitCount / daysSinceLastModified;
+            }
+        }
+        return histories;
+    }
+    /**
+     * Get files modified in recent commits from pre-fetched data (no git subprocesses)
+     */
+    getRecentlyModifiedFilesFromCache(log, commitFilesMap, commitCount) {
+        const files = new Set();
+        const recentCommits = log.all.slice(0, commitCount);
+        for (const commit of recentCommits) {
+            const commitFiles = commitFilesMap.get(commit.hash) || [];
+            for (const file of commitFiles) {
+                files.add(file);
+            }
+        }
+        return Array.from(files);
+    }
+    /**
+     * Identify hotspot files (frequently changed)
+     */
+    identifyHotspots(histories, minFrequency) {
+        return Array.from(histories.entries())
+            .filter(([_, history]) => history.changeFrequency >= minFrequency)
+            .sort((a, b) => b[1].changeFrequency - a[1].changeFrequency)
+            .map(([file, _]) => file)
+            .slice(0, 20); // Top 20 hotspots
+    }
+    /**
+     * Find files that are often changed together from pre-fetched data (no git subprocesses)
+     */
+    findRelatedFilesFromCache(log, commitFilesMap) {
+        const relatedFiles = new Map();
+        const coChangeMatrix = new Map();
+        // Build co-change matrix from pre-fetched data
+        for (const commit of log.all) {
+            const files = commitFilesMap.get(commit.hash) || [];
+            // Record co-changes
+            for (const file1 of files) {
+                if (!coChangeMatrix.has(file1)) {
+                    coChangeMatrix.set(file1, new Map());
+                }
+                for (const file2 of files) {
+                    if (file1 !== file2) {
+                        const matrix = coChangeMatrix.get(file1);
+                        matrix.set(file2, (matrix.get(file2) || 0) + 1);
+                    }
+                }
+            }
+        }
+        // Extract top related files for each file
+        for (const [file, coChanges] of coChangeMatrix.entries()) {
+            const related = Array.from(coChanges.entries())
+                .sort((a, b) => b[1] - a[1])
+                .slice(0, 5) // Top 5 related files
+                .map(([f, _]) => f);
+            if (related.length > 0) {
+                relatedFiles.set(file, related);
+            }
+        }
+        return relatedFiles;
+    }
+}
+// Singleton instance
+export const contextLineage = new ContextLineageClass();
+//# sourceMappingURL=contextLineage.js.map

package/dist/context/contextLineage.js.map

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

package/dist/context/contextOrchestrator.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Context Orchestrator
+ *
+ * Coordinates all context features to work together seamlessly.
+ * Inspired by Augment Code's invisible, harmonious integration.
+ *
+ * @format
+ */
+import { type ProjectContext } from "./projectContext.js";
+import { type LineageContext } from "./contextLineage.js";
+import { type ApiContractIssue } from "../api-contract/validators/index.js";
+export interface OrchestrationContext {
+    projectContext: ProjectContext;
+    lineageContext: LineageContext | null;
+    relevantSymbols: string[];
+    useIncremental: boolean;
+    contextQuality: "excellent" | "good" | "fair" | "poor";
+    recommendations: string[];
+    apiContractIssues?: ApiContractIssue[];
+    apiContractSummary?: {
+        totalIssues: number;
+        critical: number;
+        high: number;
+        matchedEndpoints: number;
+        matchedTypes: number;
+    };
+}
+/**
+ * Orchestrate all context features to work together
+ */
+export declare function orchestrateContext(options: {
+    projectPath: string;
+    language: string;
+    newCode?: string;
+    imports?: string[];
+    useSmartContext?: boolean;
+    includeLineage?: boolean;
+    forceRebuild?: boolean;
+    includeTests?: boolean;
+    maxFiles?: number;
+    sessionId?: string;
+    currentFile?: string;
+    recentlyEditedFiles?: string[];
+}): Promise<OrchestrationContext>;
+/**
+ * Record validation event for future context
+ */
+export declare function recordValidationEvent(options: {
+    filePath?: string;
+    symbols: string[];
+    language: string;
+}): void;
+/**
+ * Get context quality explanation
+ */
+export declare function explainContextQuality(quality: "excellent" | "good" | "fair" | "poor"): string;
+//# sourceMappingURL=contextOrchestrator.d.ts.map

package/dist/context/contextOrchestrator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contextOrchestrator.d.ts","sourceRoot":"","sources":["../../src/context/contextOrchestrator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAqB,KAAK,cAAc,EAA2B,MAAM,qBAAqB,CAAC;AAEtG,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAG1E,OAAO,EAAmC,KAAK,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAE7G,MAAM,WAAW,oBAAoB;IACnC,cAAc,EAAE,cAAc,CAAC;IAC/B,cAAc,EAAE,cAAc,GAAG,IAAI,CAAC;IACtC,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,cAAc,EAAE,OAAO,CAAC;IACxB,cAAc,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;IACvD,eAAe,EAAE,MAAM,EAAE,CAAC;IAE1B,iBAAiB,CAAC,EAAE,gBAAgB,EAAE,CAAC;IACvC,kBAAkB,CAAC,EAAE;QACnB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,CAAC;QACjB,IAAI,EAAE,MAAM,CAAC;QACb,gBAAgB,EAAE,MAAM,CAAC;QACzB,YAAY,EAAE,MAAM,CAAC;KACtB,CAAC;CACH;AAED;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,EAAE;IAChD,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC;CAChC,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAiKhC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE;IAC7C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,IAAI,CAWP;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,GAC9C,MAAM,CAWR"}

package/dist/context/contextOrchestrator.js

@@ -0,0 +1,162 @@
+/**
+ * Context Orchestrator
+ *
+ * Coordinates all context features to work together seamlessly.
+ * Inspired by Augment Code's invisible, harmonious integration.
+ *
+ * @format
+ */
+import { getProjectContext } from "./projectContext.js";
+import { intentTracker } from "./intentTracker.js";
+import { contextLineage } from "./contextLineage.js";
+import { getRelevantSymbolsForValidation } from "../analyzers/relevanceScorer.js";
+import { logger } from "../utils/logger.js";
+import { validateApiContractsFromContext } from "../api-contract/validators/index.js";
+/**
+ * Orchestrate all context features to work together
+ */
+export async function orchestrateContext(options) {
+    const orchestrationStart = Date.now();
+    const { projectPath, language, newCode, imports = [], useSmartContext = true, includeLineage = false, forceRebuild = false, includeTests = true, maxFiles, sessionId, currentFile, recentlyEditedFiles = [], } = options;
+    const recommendations = [];
+    let contextQuality = "good";
+    // 1. Get project context (with branch-aware caching)
+    const contextStart = Date.now();
+    const projectContext = await getProjectContext(projectPath, {
+        language, // Use the requested language without overriding
+        forceRebuild,
+        includeTests,
+        ...(typeof maxFiles === "number" ? { maxFiles } : {}),
+    });
+    logger.debug(`Project context loaded in ${Date.now() - contextStart}ms`);
+    // 2. Get developer intent
+    const intent = intentTracker.getCurrentIntent();
+    if (intent.recentFiles.length > 0) {
+        logger.debug(`Developer intent: ${intent.recentFiles.length} recent files, focus: ${intent.focusArea || "none"}`);
+    }
+    // 3. Determine if we should use smart context (cheap checks only)
+    const shouldUseSmartContext = useSmartContext &&
+        projectContext.symbolGraph &&
+        projectContext.symbolIndex.size > 100 &&
+        (imports.length > 0 || intent.recentSymbols.size > 0);
+    // 4. Get git lineage context
+    let lineageContext = null;
+    // - for validate_code: only when smart context is enabled (performance)
+    // - for build_context: always when includeLineage is explicitly requested
+    if (includeLineage || shouldUseSmartContext) {
+        try {
+            lineageContext = await contextLineage.getLineageContext(projectPath, {
+                commitDepth: 20,
+            });
+            if (lineageContext) {
+                logger.debug(`Git lineage: ${lineageContext.recentlyModifiedFiles.length} recent files, ${lineageContext.hotspotFiles.length} hotspots`);
+            }
+        }
+        catch {
+            logger.debug("Git lineage not available");
+        }
+    }
+    // 5. Get relevant symbols using all available context
+    let relevantSymbols = [];
+    if (shouldUseSmartContext) {
+        relevantSymbols = getRelevantSymbolsForValidation(projectContext, {
+            importedSymbols: imports,
+            currentFile,
+            recentFiles: [...new Set([...intent.recentFiles, ...recentlyEditedFiles])],
+            lineageContext,
+        }, 0.3, // Min relevance score
+        200);
+        const reductionPercent = Math.round((1 - relevantSymbols.length / projectContext.symbolIndex.size) * 100);
+        logger.debug(`Smart context: ${relevantSymbols.length}/${projectContext.symbolIndex.size} symbols (${reductionPercent}% reduction)`);
+        if (reductionPercent > 70) {
+            contextQuality = "excellent";
+        }
+        else if (reductionPercent > 50) {
+            contextQuality = "good";
+        }
+        else {
+            contextQuality = "fair";
+        }
+    }
+    else {
+        contextQuality = "fair";
+        if (projectContext.symbolIndex.size > 100) {
+            recommendations.push(useSmartContext
+                ? "Consider providing imports or using sessionId for better context"
+                : "Smart context disabled; running full-context validation");
+        }
+    }
+    // 6. Determine if incremental validation is beneficial
+    const useIncremental = Boolean(sessionId && newCode && newCode.split("\n").length > 10);
+    // 7. Quality assessment
+    if (!projectContext.symbolGraph) {
+        contextQuality = "poor";
+        recommendations.push("Symbol graph not available - rebuild context");
+    }
+    if (intent.recentFiles.length === 0 && !lineageContext) {
+        recommendations.push("No session context - provide sessionId for better results");
+    }
+    // 8. API Contract validation (if context has API Contract info)
+    let apiContractIssues;
+    let apiContractSummary;
+    if (projectContext.apiContract) {
+        const validationResult = validateApiContractsFromContext(projectContext);
+        apiContractIssues = validationResult.issues;
+        apiContractSummary = {
+            totalIssues: validationResult.summary.totalIssues,
+            critical: validationResult.summary.critical,
+            high: validationResult.summary.high,
+            matchedEndpoints: validationResult.summary.matchedEndpoints,
+            matchedTypes: validationResult.summary.matchedTypes,
+        };
+        if (validationResult.summary.critical > 0) {
+            recommendations.push(`${validationResult.summary.critical} critical API contract issues detected - review recommended`);
+        }
+    }
+    const totalTime = Date.now() - orchestrationStart;
+    logger.info(`Context orchestration completed in ${totalTime}ms (quality: ${contextQuality})`);
+    // Performance warning
+    if (totalTime > 5000) {
+        logger.warn(`Slow orchestration detected (${totalTime}ms) - consider limiting project scope`);
+    }
+    return {
+        projectContext,
+        lineageContext,
+        relevantSymbols,
+        useIncremental,
+        contextQuality,
+        recommendations,
+        apiContractIssues,
+        apiContractSummary,
+    };
+}
+/**
+ * Record validation event for future context
+ */
+export function recordValidationEvent(options) {
+    const { filePath, symbols, language } = options;
+    if (filePath) {
+        intentTracker.recordEdit({
+            filePath,
+            timestamp: Date.now(),
+            symbols,
+            language,
+        });
+    }
+}
+/**
+ * Get context quality explanation
+ */
+export function explainContextQuality(quality) {
+    switch (quality) {
+        case "excellent":
+            return "All context features active: smart filtering (>70% reduction), git history, and session tracking";
+        case "good":
+            return "Most context features active: smart filtering (>50% reduction) with some history";
+        case "fair":
+            return "Basic context available: limited filtering or missing session data";
+        case "poor":
+            return "Minimal context: missing symbol graph or project data";
+    }
+}
+//# sourceMappingURL=contextOrchestrator.js.map

package/dist/context/contextOrchestrator.js.map

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

package/dist/context/intentTracker.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Intent Tracker - Understands Developer Intent from Edit History
+ *
+ * Inspired by Augment Code's intent-based context system.
+ * Tracks recent file edits to understand what the developer is working on
+ * and prioritizes related symbols in validation.
+ *
+ * @format
+ */
+export interface EditEvent {
+    filePath: string;
+    timestamp: number;
+    symbols: string[];
+    language: string;
+}
+export interface DeveloperIntent {
+    recentFiles: string[];
+    recentSymbols: Set<string>;
+    focusArea: string | null;
+    language: string | null;
+}
+declare class IntentTrackerClass {
+    private editHistory;
+    private readonly MAX_HISTORY;
+    private readonly INTENT_WINDOW_MS;
+    /**
+     * Record a file edit event
+     */
+    recordEdit(event: EditEvent): void;
+    /**
+     * Get current developer intent based on recent edits
+     */
+    getCurrentIntent(): DeveloperIntent;
+    /**
+     * Check if a file is in the current focus area
+     */
+    isInFocusArea(filePath: string): boolean;
+    /**
+     * Check if a symbol is recently used
+     */
+    isRecentlyUsed(symbol: string): boolean;
+    /**
+     * Get relevance score for a file based on intent
+     */
+    getFileRelevance(filePath: string): number;
+    /**
+     * Get relevance score for a symbol based on intent
+     */
+    getSymbolRelevance(symbol: string): number;
+    /**
+     * Clear all edit history
+     */
+    clear(): void;
+    /**
+     * Get recent edits within the intent window
+     */
+    private getRecentEdits;
+    /**
+     * Remove events older than the intent window
+     */
+    private cleanupOldEvents;
+    /**
+     * Determine the focus area from recent files
+     */
+    private determineFocusArea;
+    /**
+     * Determine primary language from recent edits
+     */
+    private determinePrimaryLanguage;
+}
+export declare const intentTracker: IntentTrackerClass;
+export {};
+//# sourceMappingURL=intentTracker.d.ts.map

package/dist/context/intentTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"intentTracker.d.ts","sourceRoot":"","sources":["../../src/context/intentTracker.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,eAAe;IAC9B,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,aAAa,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,cAAM,kBAAkB;IACtB,OAAO,CAAC,WAAW,CAAmB;IACtC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAM;IAClC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAiB;IAElD;;OAEG;IACH,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI;IAYlC;;OAEG;IACH,gBAAgB,IAAI,eAAe;IA6BnC;;OAEG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAOxC;;OAEG;IACH,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKvC;;OAEG;IACH,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM;IAmB1C;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM;IAU1C;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,OAAO,CAAC,cAAc;IAOtB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAOxB;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAsBjC;AAGD,eAAO,MAAM,aAAa,oBAA2B,CAAC"}