sdlc-agent-4-enterprise-server 1.0.0

package/dist/engine/context/intent-strategies.js

@@ -0,0 +1,62 @@
+/**
+ * KSA-158: Intent Strategies — maps intent to prioritized section list.
+ */
+const STRATEGIES = {
+    explain: {
+        intent: 'explain',
+        sections: [
+            { name: 'source', priority: 1, format: 'full' },
+            { name: 'doc_comment', priority: 2, format: 'full' },
+            { name: 'siblings', priority: 3, format: 'signatures' },
+            { name: 'imports', priority: 4, format: 'full' },
+            { name: 'callers', priority: 5, format: 'summary' },
+            { name: 'callees', priority: 6, format: 'summary' },
+            { name: 'type_definitions', priority: 7, format: 'full' },
+        ]
+    },
+    modify: {
+        intent: 'modify',
+        sections: [
+            { name: 'source', priority: 1, format: 'full' },
+            { name: 'callers', priority: 2, format: 'full' },
+            { name: 'callees', priority: 3, format: 'full' },
+            { name: 'tests', priority: 4, format: 'full' },
+            { name: 'imports', priority: 5, format: 'full' },
+            { name: 'type_definitions', priority: 6, format: 'full' },
+            { name: 'siblings', priority: 7, format: 'signatures' },
+        ]
+    },
+    debug: {
+        intent: 'debug',
+        sections: [
+            { name: 'source', priority: 1, format: 'full' },
+            { name: 'callers', priority: 2, format: 'full' },
+            { name: 'error_patterns', priority: 3, format: 'full' },
+            { name: 'recent_changes', priority: 4, format: 'full' },
+            { name: 'imports', priority: 5, format: 'full' },
+            { name: 'siblings', priority: 6, format: 'signatures' },
+            { name: 'callees', priority: 7, format: 'summary' },
+        ]
+    },
+    test: {
+        intent: 'test',
+        sections: [
+            { name: 'source', priority: 1, format: 'full' },
+            { name: 'tests', priority: 2, format: 'full' },
+            { name: 'test_patterns', priority: 3, format: 'full' },
+            { name: 'callees', priority: 4, format: 'full' },
+            { name: 'type_definitions', priority: 5, format: 'full' },
+            { name: 'mocks_needed', priority: 6, format: 'full' },
+            { name: 'siblings', priority: 7, format: 'signatures' },
+        ]
+    }
+};
+/** Get the intent strategy (section priorities) for a given intent. Falls back to 'explain'. */
+export function getStrategy(intent) {
+    return STRATEGIES[intent] || STRATEGIES.explain;
+}
+/** Get all supported intent names. */
+export function getSupportedIntents() {
+    return Object.keys(STRATEGIES);
+}
+//# sourceMappingURL=intent-strategies.js.map

package/dist/engine/context/intent-strategies.js.map

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

package/dist/engine/context/query-analyzer.d.ts

@@ -0,0 +1,8 @@
+/**
+ * KSA-160: Query Analyzer — extracts keywords, symbol candidates, and phrases from NL queries.
+ */
+import { QueryAnalysis } from './types.js';
+export declare class QueryAnalyzer {
+    /** Analyze a natural language query into search components. */
+    analyze(query: string): QueryAnalysis;
+}

package/dist/engine/context/query-analyzer.js

@@ -0,0 +1,40 @@
+/**
+ * KSA-160: Query Analyzer — extracts keywords, symbol candidates, and phrases from NL queries.
+ */
+const STOP_WORDS = new Set([
+    'how', 'does', 'the', 'is', 'what', 'where', 'when', 'a', 'an', 'in',
+    'for', 'to', 'of', 'and', 'or', 'not', 'this', 'that', 'with', 'from',
+    'are', 'was', 'were', 'been', 'being', 'have', 'has', 'had', 'do', 'did',
+    'will', 'would', 'could', 'should', 'may', 'might', 'can', 'shall',
+    'its', 'it', 'they', 'them', 'their', 'we', 'our', 'you', 'your',
+    'all', 'each', 'every', 'both', 'few', 'more', 'most', 'other', 'some',
+    'such', 'than', 'too', 'very', 'just', 'but', 'about', 'above', 'after',
+    'before', 'between', 'into', 'through', 'during', 'until', 'while'
+]);
+export class QueryAnalyzer {
+    /** Analyze a natural language query into search components. */
+    analyze(query) {
+        // Tokenize: lowercase, remove special chars, split
+        const tokens = query.toLowerCase()
+            .replace(/[^\w\s.\-_]/g, ' ')
+            .split(/\s+/)
+            .filter(t => t.length > 2 && !STOP_WORDS.has(t));
+        // Identify symbol candidates (camelCase, PascalCase, snake_case, dot.notation)
+        const symbolCandidates = query.match(/[A-Z][a-zA-Z0-9]*(?:\.[a-zA-Z][a-zA-Z0-9]*)?|[a-z]+(?:_[a-z_]+)+|[a-z]+[A-Z][a-zA-Z0-9]*/g) || [];
+        // Extract bigrams for phrase search
+        const phrases = [];
+        for (let i = 0; i < tokens.length - 1; i++) {
+            phrases.push(`${tokens[i]} ${tokens[i + 1]}`);
+        }
+        // Build FTS query (OR-joined keywords)
+        const ftsQuery = tokens.length > 0 ? tokens.join(' OR ') : query;
+        return {
+            originalQuery: query,
+            keywords: tokens,
+            symbolCandidates,
+            phrases,
+            ftsQuery
+        };
+    }
+}
+//# sourceMappingURL=query-analyzer.js.map

package/dist/engine/context/query-analyzer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-analyzer.js","sourceRoot":"","sources":["../../../src/engine/context/query-analyzer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI;IACpE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IACrE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK;IACxE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO;IAClE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM;IAChE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IACtE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO;IACvE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO;CACnE,CAAC,CAAC;AAEH,MAAM,OAAO,aAAa;IACxB,+DAA+D;IAC/D,OAAO,CAAC,KAAa;QACnB,mDAAmD;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,WAAW,EAAE;aAC/B,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC;aAC5B,KAAK,CAAC,KAAK,CAAC;aACZ,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAEnD,+EAA+E;QAC/E,MAAM,gBAAgB,GAAG,KAAK,CAAC,KAAK,CAClC,2FAA2F,CAC5F,IAAI,EAAE,CAAC;QAER,oCAAoC;QACpC,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YAC3C,OAAO,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC;QAChD,CAAC;QAED,uCAAuC;QACvC,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QAEjE,OAAO;YACL,aAAa,EAAE,KAAK;YACpB,QAAQ,EAAE,MAAM;YAChB,gBAAgB;YAChB,OAAO;YACP,QAAQ;SACT,CAAC;IACJ,CAAC;CACF"}

package/dist/engine/context/rrf-merger.d.ts

@@ -0,0 +1,20 @@
+/**
+ * KSA-160: RRF Merger — Reciprocal Rank Fusion for merging multi-source results.
+ */
+import { SourceWeights, MergedResult } from './types.js';
+interface SourceResults {
+    source: string;
+    results: any[];
+}
+export declare class RRFMerger {
+    private k;
+    /** Merge results from multiple sources using Reciprocal Rank Fusion. */
+    merge(sources: {
+        code: SourceResults;
+        memory: SourceResults;
+        graph: SourceResults;
+    }, weights?: SourceWeights): MergedResult[];
+    private addScores;
+    private getKey;
+}
+export {};

package/dist/engine/context/rrf-merger.js

@@ -0,0 +1,46 @@
+/**
+ * KSA-160: RRF Merger — Reciprocal Rank Fusion for merging multi-source results.
+ */
+export class RRFMerger {
+    k = 60; // RRF constant
+    /** Merge results from multiple sources using Reciprocal Rank Fusion. */
+    merge(sources, weights) {
+        const w = weights || { code: 0.5, memory: 0.3, graph: 0.2 };
+        const scores = new Map();
+        this.addScores(scores, sources.code.results, w.code, 'code');
+        this.addScores(scores, sources.memory.results, w.memory, 'memory');
+        this.addScores(scores, sources.graph.results, w.graph, 'graph');
+        return Array.from(scores.values())
+            .sort((a, b) => b.score - a.score)
+            .map(entry => ({
+            ...entry.item,
+            relevance_score: entry.score,
+            sources: entry.sources
+        }));
+    }
+    addScores(scores, results, weight, source) {
+        for (let rank = 0; rank < results.length; rank++) {
+            const item = results[rank];
+            const key = this.getKey(item);
+            const rrfScore = weight * (1 / (this.k + rank));
+            if (scores.has(key)) {
+                const existing = scores.get(key);
+                existing.score += rrfScore;
+                existing.sources.push(source);
+            }
+            else {
+                scores.set(key, { score: rrfScore, item, sources: [source] });
+            }
+        }
+    }
+    getKey(item) {
+        if (item.id)
+            return String(item.id);
+        if (item.name && item.file)
+            return `${item.name}:${item.file}`;
+        if (item.name)
+            return item.name;
+        return JSON.stringify(item).substring(0, 100);
+    }
+}
+//# sourceMappingURL=rrf-merger.js.map

package/dist/engine/context/rrf-merger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rrf-merger.js","sourceRoot":"","sources":["../../../src/engine/context/rrf-merger.ts"],"names":[],"mappings":"AAAA;;GAEG;AASH,MAAM,OAAO,SAAS;IACZ,CAAC,GAAG,EAAE,CAAC,CAAC,eAAe;IAE/B,wEAAwE;IACxE,KAAK,CACH,OAA6E,EAC7E,OAAuB;QAEvB,MAAM,CAAC,GAAG,OAAO,IAAI,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,GAAG,EAA2D,CAAC;QAElF,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC7D,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;QACnE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;QAEhE,OAAO,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;aAC/B,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;aACjC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;YACb,GAAG,KAAK,CAAC,IAAI;YACb,eAAe,EAAE,KAAK,CAAC,KAAK;YAC5B,OAAO,EAAE,KAAK,CAAC,OAAO;SACvB,CAAC,CAAC,CAAC;IACR,CAAC;IAEO,SAAS,CACf,MAAoE,EACpE,OAAc,EACd,MAAc,EACd,MAAc;QAEd,KAAK,IAAI,IAAI,GAAG,CAAC,EAAE,IAAI,GAAG,OAAO,CAAC,MAAM,EAAE,IAAI,EAAE,EAAE,CAAC;YACjD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;YAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC9B,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;YAEhD,IAAI,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAE,CAAC;gBAClC,QAAQ,CAAC,KAAK,IAAI,QAAQ,CAAC;gBAC3B,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAChC,CAAC;iBAAM,CAAC;gBACN,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;IACH,CAAC;IAEO,MAAM,CAAC,IAAS;QACtB,IAAI,IAAI,CAAC,EAAE;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpC,IAAI,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,GAAG,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QAC/D,IAAI,IAAI,CAAC,IAAI;YAAE,OAAO,IAAI,CAAC,IAAI,CAAC;QAChC,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAChD,CAAC;CACF"}

package/dist/engine/context/token-budget-manager.d.ts

@@ -0,0 +1,38 @@
+/**
+ * KSA-158/159: Token Budget Manager — estimates tokens and assembles context within budget.
+ */
+export declare class TokenBudgetManager {
+    private budget;
+    private consumed;
+    constructor(budget: number);
+    /** Estimate token count for content (~4 chars per token). */
+    estimateTokens(content: any): number;
+    /** Check if tokens can fit within remaining budget. */
+    canFit(tokens: number): boolean;
+    /** Consume tokens from budget. */
+    consume(tokens: number): void;
+    /** Mark budget as fully consumed. */
+    consumeAll(): void;
+    /** Get remaining token budget. */
+    remaining(): number;
+    /** Get total tokens consumed. */
+    used(): number;
+    /** Check if budget is effectively exhausted (<50 tokens remaining). */
+    isExhausted(): boolean;
+    /** Truncate content to fit remaining budget. */
+    truncateToFit(content: any): any;
+    /**
+     * Assemble multiple sections into a result within token budget.
+     * Sections are sorted by priority (lower = higher priority).
+     */
+    assemble(sections: Record<string, {
+        content: any;
+        priority: number;
+    }>, budget: number): {
+        result: Record<string, any>;
+        tokenCount: number;
+        included: string[];
+        excluded: string[];
+    };
+    private truncateArray;
+}

package/dist/engine/context/token-budget-manager.js

@@ -0,0 +1,114 @@
+/**
+ * KSA-158/159: Token Budget Manager — estimates tokens and assembles context within budget.
+ */
+export class TokenBudgetManager {
+    budget;
+    consumed = 0;
+    constructor(budget) {
+        this.budget = Math.max(budget, 500); // Minimum 500 tokens
+    }
+    /** Estimate token count for content (~4 chars per token). */
+    estimateTokens(content) {
+        const text = typeof content === 'string' ? content : JSON.stringify(content);
+        return Math.ceil(text.length / 4);
+    }
+    /** Check if tokens can fit within remaining budget. */
+    canFit(tokens) {
+        return this.consumed + tokens <= this.budget;
+    }
+    /** Consume tokens from budget. */
+    consume(tokens) {
+        this.consumed += tokens;
+    }
+    /** Mark budget as fully consumed. */
+    consumeAll() {
+        this.consumed = this.budget;
+    }
+    /** Get remaining token budget. */
+    remaining() {
+        return Math.max(0, this.budget - this.consumed);
+    }
+    /** Get total tokens consumed. */
+    used() {
+        return this.consumed;
+    }
+    /** Check if budget is effectively exhausted (<50 tokens remaining). */
+    isExhausted() {
+        return this.remaining() < 50;
+    }
+    /** Truncate content to fit remaining budget. */
+    truncateToFit(content) {
+        const maxChars = this.remaining() * 4;
+        if (typeof content === 'string') {
+            if (content.length <= maxChars)
+                return content;
+            return content.substring(0, maxChars) + '\n... (truncated)';
+        }
+        if (Array.isArray(content)) {
+            let chars = 0;
+            const result = [];
+            for (const item of content) {
+                const itemStr = JSON.stringify(item);
+                if (chars + itemStr.length > maxChars)
+                    break;
+                result.push(item);
+                chars += itemStr.length;
+            }
+            return result;
+        }
+        const text = JSON.stringify(content);
+        if (text.length <= maxChars)
+            return content;
+        return text.substring(0, maxChars);
+    }
+    /**
+     * Assemble multiple sections into a result within token budget.
+     * Sections are sorted by priority (lower = higher priority).
+     */
+    assemble(sections, budget) {
+        const sorted = Object.entries(sections)
+            .filter(([_, v]) => v.content != null)
+            .sort(([_, a], [__, b]) => a.priority - b.priority);
+        const result = {};
+        let usedTokens = 0;
+        const included = [];
+        const excluded = [];
+        for (const [key, { content }] of sorted) {
+            const tokens = this.estimateTokens(content);
+            if (usedTokens + tokens <= budget) {
+                result[key] = content;
+                usedTokens += tokens;
+                included.push(key);
+            }
+            else if (Array.isArray(content) && content.length > 0) {
+                // Try truncation for arrays
+                const remaining = budget - usedTokens;
+                const truncated = this.truncateArray(content, remaining);
+                if (truncated.length > 0) {
+                    result[key] = truncated;
+                    usedTokens += this.estimateTokens(truncated);
+                    included.push(`${key} (truncated: ${truncated.length}/${content.length})`);
+                    continue;
+                }
+                excluded.push(key);
+            }
+            else {
+                excluded.push(key);
+            }
+        }
+        return { result, tokenCount: usedTokens, included, excluded };
+    }
+    truncateArray(arr, tokenBudget) {
+        const result = [];
+        let used = 0;
+        for (const item of arr) {
+            const tokens = this.estimateTokens(item);
+            if (used + tokens > tokenBudget)
+                break;
+            result.push(item);
+            used += tokens;
+        }
+        return result;
+    }
+}
+//# sourceMappingURL=token-budget-manager.js.map

package/dist/engine/context/token-budget-manager.js.map

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

package/dist/engine/context/types.d.ts

@@ -0,0 +1,147 @@
+/**
+ * KSA-158/159/160: Shared types for AI Context tools.
+ */
+export interface AIContextParams {
+    symbol: string;
+    intent?: string;
+    token_budget?: number;
+    caller_depth?: number;
+}
+export interface AIContextResponse {
+    symbol: string;
+    file_path: string;
+    kind: string;
+    intent: string;
+    context: Record<string, any>;
+    metadata: {
+        budget_used: number;
+        budget_total: number;
+        sections_included: string[];
+        sections_omitted: string[];
+        query_time_ms: number;
+    };
+}
+export interface EditContextParams {
+    symbol: string;
+    include_callers?: boolean;
+    include_tests?: boolean;
+    include_memories?: boolean;
+    include_git?: boolean;
+    token_budget?: number;
+    caller_depth?: number;
+}
+export interface EditContextResult {
+    symbol: string;
+    file: string;
+    line: number;
+    kind: string;
+    source: string;
+    signature: string | null;
+    callers?: CallerContext[];
+    tests?: TestContext[];
+    dependencies?: DependencyContext[];
+    memories?: MemoryContext[];
+    git_history?: GitCommit[];
+    siblings?: SiblingContext[];
+    metadata: {
+        tokenCount: number;
+        tokenBudget: number;
+        sectionsIncluded: string[];
+        sectionsExcluded: string[];
+        queryTimeMs: number;
+    };
+}
+export interface CallerContext {
+    symbol: string;
+    file: string;
+    line: number;
+    context: string;
+}
+export interface TestContext {
+    file: string;
+    testName: string;
+    source: string;
+}
+export interface DependencyContext {
+    file: string;
+    symbols: string[];
+    direction: 'imports' | 'imported_by';
+}
+export interface MemoryContext {
+    id: number;
+    type: string;
+    summary: string;
+}
+export interface GitCommit {
+    hash: string;
+    message: string;
+}
+export interface SiblingContext {
+    name: string;
+    kind: string;
+    signature: string | null;
+    line: number;
+}
+export interface CuratedContextParams {
+    query: string;
+    max_tokens?: number;
+    scope?: string;
+    modules?: string[];
+    languages?: string[];
+    include_source?: boolean;
+    include_memory?: boolean;
+    include_graph?: boolean;
+    source_weights?: SourceWeights;
+}
+export interface SourceWeights {
+    code: number;
+    memory: number;
+    graph: number;
+}
+export interface CuratedContextResponse {
+    query: string;
+    sections: ContextSection[];
+    metadata: {
+        tokens_used: number;
+        tokens_budget: number;
+        sources_queried: string[];
+        total_candidates: number;
+        results_returned: number;
+        execution_time_ms: number;
+    };
+}
+export interface ContextSection {
+    title: string;
+    source: 'code' | 'memory' | 'graph';
+    items: ContextItem[];
+}
+export interface ContextItem {
+    name: string;
+    kind?: string;
+    file?: string;
+    line?: number;
+    relevance: number;
+    detail: 'full' | 'signature' | 'reference';
+    content: string;
+    relationship?: string;
+}
+export interface QueryAnalysis {
+    originalQuery: string;
+    keywords: string[];
+    symbolCandidates: string[];
+    phrases: string[];
+    ftsQuery: string;
+}
+export interface MergedResult {
+    id?: number;
+    name: string;
+    kind?: string;
+    file?: string;
+    line?: number;
+    signature?: string;
+    source_code?: string;
+    content?: string;
+    relevance_score: number;
+    sources: string[];
+    relationship?: string;
+}

package/dist/engine/context/types.js

@@ -0,0 +1,5 @@
+/**
+ * KSA-158/159/160: Shared types for AI Context tools.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/engine/context/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engine/context/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/engine/database/graph-repository.d.ts

@@ -0,0 +1,55 @@
+/**
+ * KSA-153: Graph Repository — CRUD operations for the code relationship graph.
+ * Provides prepared-statement-based access to the relationships table.
+ */
+import Database from 'better-sqlite3';
+export interface CallerResult {
+    name: string;
+    kind: string;
+    file_path: string;
+    def_line: number;
+    call_line: number;
+    parameters: string | null;
+    is_async: number;
+    id: number;
+}
+export interface CalleeResult {
+    name: string;
+    call_line: number;
+    metadata: string | null;
+    kind: string | null;
+    file_path: string | null;
+    def_line: number | null;
+}
+export interface RelationshipInput {
+    sourceSymbolId: number;
+    targetSymbol: string;
+    targetSymbolId?: number | null;
+    kind: string;
+    filePath: string;
+    line: number;
+    metadata?: Record<string, unknown> | null;
+}
+export declare class GraphRepository {
+    private db;
+    private stmts;
+    constructor(db: Database.Database);
+    /** Insert a batch of relationships within a transaction. */
+    insertRelationships(relationships: RelationshipInput[]): void;
+    /** Delete all relationships originating from a file. */
+    deleteFileRelationships(filePath: string): void;
+    /** Find direct callers of a symbol by name. */
+    findCallers(symbolName: string, kind?: string, limit?: number): CallerResult[];
+    /** Find direct callees of a symbol by ID. */
+    findCallees(symbolId: number, kind?: string, limit?: number): CalleeResult[];
+    /** Resolve target_symbol_id for unresolved relationships (batch). */
+    resolveTargets(batchSize?: number): number;
+    /** Get total relationship count. */
+    getRelationshipCount(): number;
+    /** Get relationship statistics by kind. */
+    getStats(): {
+        kind: string;
+        count: number;
+    }[];
+    private prepareStatements;
+}