sdlc-agent-4-enterprise-server 1.0.0

package/dist/engine/context/budget-allocator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget-allocator.js","sourceRoot":"","sources":["../../../src/engine/context/budget-allocator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAUH,MAAM,OAAO,eAAe;IAClB,eAAe,GAAG,CAAC,CAAC;IAE5B,kFAAkF;IAClF,QAAQ,CAAC,OAAuB,EAAE,SAAiB;QACjD,MAAM,SAAS,GAAsB,EAAE,CAAC;QACxC,IAAI,UAAU,GAAG,GAAG,CAAC,CAAC,oBAAoB;QAE1C,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC;QACnE,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC;QAErD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACxC,IAAI,UAAU,IAAI,SAAS;gBAAE,MAAM;YAEnC,MAAM,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;YAC1B,IAAI,MAA0C,CAAC;YAC/C,IAAI,OAAe,CAAC;YACpB,IAAI,MAAc,CAAC;YAEnB,IAAI,CAAC,GAAG,aAAa,EAAE,CAAC;gBACtB,MAAM,GAAG,MAAM,CAAC;gBAChB,OAAO,GAAG,MAAM,CAAC,WAAW,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC;gBAClF,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YACxC,CAAC;iBAAM,IAAI,CAAC,GAAG,YAAY,EAAE,CAAC;gBAC5B,MAAM,GAAG,WAAW,CAAC;gBACrB,OAAO,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC;gBAC1C,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YACxC,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,WAAW,CAAC;gBACrB,OAAO,GAAG,GAAG,MAAM,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,IAAI,SAAS,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC;gBAC7E,MAAM,GAAG,EAAE,CAAC;YACd,CAAC;YAED,8BAA8B;YAC9B,IAAI,UAAU,GAAG,MAAM,GAAG,SAAS,IAAI,MAAM,KAAK,MAAM,EAAE,CAAC;gBACzD,MAAM,GAAG,WAAW,CAAC;gBACrB,OAAO,GAAG,MAAM,CAAC,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC;gBAC1C,MAAM,GAAG,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YACxC,CAAC;YAED,IAAI,UAAU,GAAG,MAAM,IAAI,SAAS,EAAE,CAAC;gBACrC,SAAS,CAAC,IAAI,CAAC,EAAE,GAAG,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC;gBACvD,UAAU,IAAI,MAAM,CAAC;YACvB,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAEO,cAAc,CAAC,IAAY;QACjC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,CAAC;IACvD,CAAC;CACF"}

package/dist/engine/context/curated-context-service.d.ts

@@ -0,0 +1,25 @@
+/**
+ * KSA-160: Curated Context Service — NL query → parallel search → RRF merge → budget allocation.
+ */
+import Database from 'better-sqlite3';
+import { SymbolResolver } from '../graph/symbol-resolver.js';
+import { GraphTraverser } from '../graph/traverser.js';
+import { QueryLayer } from '../query/query-layer.js';
+import { CuratedContextParams, CuratedContextResponse } from './types.js';
+export declare class CuratedContextService {
+    private analyzer;
+    private merger;
+    private allocator;
+    private db;
+    private queryLayer;
+    private traverser;
+    private resolver;
+    constructor(db: Database.Database, queryLayer: QueryLayer, traverser: GraphTraverser, resolver: SymbolResolver);
+    /** Execute curated context search with NL query. */
+    getContext(params: CuratedContextParams): Promise<CuratedContextResponse>;
+    private searchCode;
+    private searchMemory;
+    private expandGraph;
+    private miniRRF;
+    private formatSections;
+}

package/dist/engine/context/curated-context-service.js

@@ -0,0 +1,217 @@
+/**
+ * KSA-160: Curated Context Service — NL query → parallel search → RRF merge → budget allocation.
+ */
+import { QueryAnalyzer } from './query-analyzer.js';
+import { RRFMerger } from './rrf-merger.js';
+import { BudgetAllocator } from './budget-allocator.js';
+export class CuratedContextService {
+    analyzer;
+    merger;
+    allocator;
+    db;
+    queryLayer;
+    traverser;
+    resolver;
+    constructor(db, queryLayer, traverser, resolver) {
+        this.analyzer = new QueryAnalyzer();
+        this.merger = new RRFMerger();
+        this.allocator = new BudgetAllocator();
+        this.db = db;
+        this.queryLayer = queryLayer;
+        this.traverser = traverser;
+        this.resolver = resolver;
+    }
+    /** Execute curated context search with NL query. */
+    async getContext(params) {
+        const startTime = Date.now();
+        const { query, max_tokens = 4000, include_source = true, include_memory = true, include_graph = true, source_weights } = params;
+        // 1. Analyze query
+        const analysis = this.analyzer.analyze(query);
+        // 2. Parallel search
+        const [codeResults, memoryResults] = await Promise.all([
+            include_source ? this.searchCode(analysis) : Promise.resolve({ source: 'code', results: [] }),
+            include_memory ? this.searchMemory(analysis) : Promise.resolve({ source: 'memory', results: [] })
+        ]);
+        // 3. Graph expansion (depends on code results)
+        let graphResults = { source: 'graph', results: [] };
+        if (include_graph && codeResults.results.length > 0) {
+            graphResults = await this.expandGraph(codeResults.results.slice(0, 5));
+        }
+        // 4. Merge with RRF
+        const merged = this.merger.merge({ code: codeResults, memory: memoryResults, graph: graphResults }, source_weights);
+        // 5. Allocate token budget
+        const allocated = this.allocator.allocate(merged, max_tokens);
+        // 6. Format response
+        const sections = this.formatSections(allocated);
+        const tokensUsed = allocated.reduce((sum, r) => sum + r.tokens, 0) + 100;
+        return {
+            query,
+            sections,
+            metadata: {
+                tokens_used: tokensUsed,
+                tokens_budget: max_tokens,
+                sources_queried: [
+                    ...(include_source ? ['code'] : []),
+                    ...(include_memory ? ['memory'] : []),
+                    ...(include_graph ? ['graph'] : [])
+                ],
+                total_candidates: codeResults.results.length + memoryResults.results.length + graphResults.results.length,
+                results_returned: allocated.length,
+                execution_time_ms: Date.now() - startTime
+            }
+        };
+    }
+    async searchCode(analysis) {
+        try {
+            const ftsResults = this.queryLayer.searchCode(analysis.ftsQuery, 30);
+            // Also try direct symbol resolution for candidates
+            const symbolResults = [];
+            for (const candidate of analysis.symbolCandidates.slice(0, 5)) {
+                const resolved = this.resolver.resolve(candidate);
+                for (const sym of resolved.slice(0, 3)) {
+                    symbolResults.push({
+                        id: sym.id,
+                        name: sym.name,
+                        kind: sym.kind,
+                        file: sym.filePath,
+                        line: sym.line,
+                        signature: null
+                    });
+                }
+            }
+            // Combine FTS + symbol results (mini-RRF)
+            const combined = this.miniRRF(ftsResults.map(r => ({
+                id: undefined,
+                name: r.name,
+                kind: r.kind,
+                file: r.filePath,
+                line: r.startLine,
+                signature: r.signature,
+                source_code: null
+            })), symbolResults);
+            return { source: 'code', results: combined.slice(0, 20) };
+        }
+        catch {
+            return { source: 'code', results: [] };
+        }
+    }
+    async searchMemory(analysis) {
+        try {
+            // Search memory/KB using FTS on knowledge entries
+            const query = analysis.keywords.slice(0, 5).join(' ');
+            const rows = this.db.prepare(`
+        SELECT id, content, summary, type, tags, created_at
+        FROM knowledge_entries
+        WHERE id IN (
+          SELECT rowid FROM knowledge_fts WHERE knowledge_fts MATCH ?
+        )
+        ORDER BY created_at DESC
+        LIMIT 10
+      `).all(query);
+            return {
+                source: 'memory',
+                results: rows.map(r => ({
+                    id: r.id,
+                    name: r.summary || r.content?.substring(0, 50) || 'entry',
+                    kind: r.type || 'memory',
+                    content: r.summary || r.content?.substring(0, 200),
+                    file: undefined,
+                    line: undefined
+                }))
+            };
+        }
+        catch {
+            // KB tables may not exist
+            return { source: 'memory', results: [] };
+        }
+    }
+    async expandGraph(topSymbols) {
+        const expanded = [];
+        const seen = new Set();
+        for (const symbol of topSymbols) {
+            try {
+                const startNode = this.traverser.resolveNode(symbol.name);
+                if (!startNode)
+                    continue;
+                const results = this.traverser.traverse(startNode, {
+                    edgeTypes: ['calls', 'imports', 'inherits'],
+                    nodeTypes: [],
+                    direction: 'both',
+                    maxDepth: 1,
+                    maxResults: 5
+                });
+                for (const r of results) {
+                    const key = `${r.node.name}:${r.node.filePath}`;
+                    if (seen.has(key))
+                        continue;
+                    seen.add(key);
+                    expanded.push({
+                        id: r.node.id,
+                        name: r.node.name,
+                        kind: r.node.kind,
+                        file: r.node.filePath,
+                        line: r.node.startLine,
+                        relationship: `${r.edgeType} ${symbol.name}`
+                    });
+                }
+            }
+            catch {
+                // Skip if symbol not in graph
+            }
+        }
+        return { source: 'graph', results: expanded };
+    }
+    miniRRF(listA, listB) {
+        const k = 60;
+        const scores = new Map();
+        for (let i = 0; i < listA.length; i++) {
+            const key = listA[i].name + ':' + (listA[i].file || '');
+            scores.set(key, { score: 1 / (k + i), item: listA[i] });
+        }
+        for (let i = 0; i < listB.length; i++) {
+            const key = listB[i].name + ':' + (listB[i].file || '');
+            if (scores.has(key)) {
+                scores.get(key).score += 1 / (k + i);
+            }
+            else {
+                scores.set(key, { score: 1 / (k + i), item: listB[i] });
+            }
+        }
+        return Array.from(scores.values())
+            .sort((a, b) => b.score - a.score)
+            .map(e => e.item);
+    }
+    formatSections(allocated) {
+        const bySource = new Map();
+        for (const item of allocated) {
+            const source = (item.sources?.[0] || 'code');
+            if (!bySource.has(source))
+                bySource.set(source, []);
+            bySource.get(source).push({
+                name: item.name,
+                kind: item.kind,
+                file: item.file,
+                line: item.line,
+                relevance: item.relevance_score,
+                detail: item.detail,
+                content: item.content,
+                relationship: item.relationship
+            });
+        }
+        const sections = [];
+        const titleMap = {
+            code: 'Code Symbols',
+            memory: 'Knowledge Base',
+            graph: 'Related (Graph)'
+        };
+        for (const [source, items] of bySource) {
+            sections.push({
+                title: titleMap[source] || source,
+                source: source,
+                items
+            });
+        }
+        return sections;
+    }
+}
+//# sourceMappingURL=curated-context-service.js.map

package/dist/engine/context/curated-context-service.js.map

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

package/dist/engine/context/edit-context-service.d.ts

@@ -0,0 +1,32 @@
+/**
+ * KSA-159: Edit Context Service — source + callers + tests + git for editing.
+ * Gathers everything needed before modifying a symbol.
+ */
+import Database from 'better-sqlite3';
+import { SymbolResolver } from '../graph/symbol-resolver.js';
+import { CallGraphService } from '../graph/call-graph-service.js';
+import { TestDetector } from '../graph/test-detector.js';
+import { EditContextParams, EditContextResult } from './types.js';
+export declare class EditContextService {
+    private db;
+    private resolver;
+    private callGraph;
+    private testDetector;
+    private gitService;
+    private budgetManager;
+    private workspace;
+    constructor(db: Database.Database, resolver: SymbolResolver, callGraph: CallGraphService, testDetector: TestDetector, workspace: string);
+    /** Get full edit context for a symbol. */
+    getContext(params: EditContextParams): Promise<EditContextResult>;
+    private resolveSymbolInput;
+    private findSymbolAtLine;
+    private readSymbolSource;
+    private getSignature;
+    private getCallerContext;
+    private getLineContext;
+    private getTestContext;
+    private extractTestBlocks;
+    private getGitContext;
+    private getSiblingContext;
+    private symbolNotFoundResponse;
+}

package/dist/engine/context/edit-context-service.js

@@ -0,0 +1,232 @@
+/**
+ * KSA-159: Edit Context Service — source + callers + tests + git for editing.
+ * Gathers everything needed before modifying a symbol.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { TokenBudgetManager } from './token-budget-manager.js';
+import { GitService } from './git-service.js';
+export class EditContextService {
+    db;
+    resolver;
+    callGraph;
+    testDetector;
+    gitService;
+    budgetManager;
+    workspace;
+    constructor(db, resolver, callGraph, testDetector, workspace) {
+        this.db = db;
+        this.resolver = resolver;
+        this.callGraph = callGraph;
+        this.testDetector = testDetector;
+        this.gitService = new GitService(workspace);
+        this.budgetManager = new TokenBudgetManager(4000);
+        this.workspace = workspace;
+    }
+    /** Get full edit context for a symbol. */
+    async getContext(params) {
+        const startTime = Date.now();
+        const { symbol: symbolInput, include_callers = true, include_tests = true, include_memories = false, include_git = true, token_budget = 4000, caller_depth = 1 } = params;
+        // 1. Resolve symbol
+        const symbol = this.resolveSymbolInput(symbolInput);
+        if (!symbol) {
+            return this.symbolNotFoundResponse(symbolInput, token_budget, startTime);
+        }
+        // 2. Read source (always included)
+        const source = this.readSymbolSource(symbol);
+        const signature = this.getSignature(symbol);
+        // 3. Gather sections in parallel
+        const [callers, tests, gitHistory, siblings] = await Promise.all([
+            include_callers ? this.getCallerContext(symbol, caller_depth) : Promise.resolve(null),
+            include_tests ? this.getTestContext(symbol) : Promise.resolve(null),
+            include_git ? this.getGitContext(symbol) : Promise.resolve(null),
+            this.getSiblingContext(symbol)
+        ]);
+        // 4. Assemble within token budget
+        const sections = {
+            source: { content: source, priority: 1 },
+        };
+        if (callers && callers.length > 0)
+            sections.callers = { content: callers, priority: 2 };
+        if (tests && tests.length > 0)
+            sections.tests = { content: tests, priority: 3 };
+        if (gitHistory && gitHistory.length > 0)
+            sections.git_history = { content: gitHistory, priority: 5 };
+        if (siblings && siblings.length > 0)
+            sections.siblings = { content: siblings, priority: 6 };
+        const assembled = this.budgetManager.assemble(sections, token_budget);
+        const result = {
+            symbol: symbol.name,
+            file: symbol.filePath,
+            line: symbol.line,
+            kind: symbol.kind,
+            source: assembled.result.source || source,
+            signature,
+            metadata: {
+                tokenCount: assembled.tokenCount,
+                tokenBudget: token_budget,
+                sectionsIncluded: assembled.included,
+                sectionsExcluded: assembled.excluded,
+                queryTimeMs: Date.now() - startTime
+            }
+        };
+        if (assembled.result.callers)
+            result.callers = assembled.result.callers;
+        if (assembled.result.tests)
+            result.tests = assembled.result.tests;
+        if (assembled.result.git_history)
+            result.git_history = assembled.result.git_history;
+        if (assembled.result.siblings)
+            result.siblings = assembled.result.siblings;
+        return result;
+    }
+    resolveSymbolInput(input) {
+        // Try file:line format
+        if (input.includes(':') && /:\d+$/.test(input)) {
+            const colonIdx = input.lastIndexOf(':');
+            const file = input.substring(0, colonIdx);
+            const line = parseInt(input.substring(colonIdx + 1));
+            return this.findSymbolAtLine(file, line);
+        }
+        // Standard resolution
+        const resolved = this.resolver.resolve(input);
+        if (resolved.length === 0)
+            return null;
+        // Enrich with end_line and signature
+        const sym = resolved[0];
+        const extra = this.db.prepare(`
+      SELECT end_line as endLine, signature FROM symbols WHERE id = ?
+    `).get(sym.id);
+        return {
+            ...sym,
+            endLine: extra?.endLine,
+            signature: extra?.signature || undefined
+        };
+    }
+    findSymbolAtLine(file, line) {
+        const row = this.db.prepare(`
+      SELECT s.id, s.name, s.kind, f.relative_path as filePath, s.start_line as line,
+             s.end_line as endLine, s.signature, s.parent_symbol_id as parentSymbolId
+      FROM symbols s
+      JOIN files f ON s.file_id = f.id
+      WHERE f.relative_path LIKE ? AND s.start_line <= ? AND s.end_line >= ?
+      ORDER BY (s.end_line - s.start_line) ASC
+      LIMIT 1
+    `).get(`%${file}`, line, line);
+        return row || null;
+    }
+    readSymbolSource(symbol) {
+        try {
+            const fullPath = path.resolve(this.workspace, symbol.filePath);
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            const lines = content.split('\n');
+            const start = symbol.line - 1;
+            const end = symbol.endLine || start + 50;
+            return lines.slice(start, end).join('\n');
+        }
+        catch {
+            return '';
+        }
+    }
+    getSignature(symbol) {
+        if (symbol.signature)
+            return symbol.signature;
+        const row = this.db.prepare(`SELECT signature FROM symbols WHERE id = ?`).get(symbol.id);
+        return row?.signature || null;
+    }
+    async getCallerContext(symbol, depth) {
+        const result = this.callGraph.findCallers(symbol.name, depth, 10);
+        return result.results.map(caller => {
+            const context = this.getLineContext(caller.filePath, caller.callSiteLine, 2);
+            return {
+                symbol: caller.qualifiedName || caller.symbol,
+                file: caller.filePath,
+                line: caller.callSiteLine,
+                context
+            };
+        });
+    }
+    getLineContext(file, line, surroundingLines) {
+        try {
+            const fullPath = path.resolve(this.workspace, file);
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            const lines = content.split('\n');
+            const start = Math.max(0, line - 1 - surroundingLines);
+            const end = Math.min(lines.length, line + surroundingLines);
+            return lines.slice(start, end).join('\n');
+        }
+        catch {
+            return '';
+        }
+    }
+    async getTestContext(symbol) {
+        const testFiles = this.testDetector.findRelatedTests([symbol], []);
+        const results = [];
+        for (const tf of testFiles.slice(0, 3)) {
+            try {
+                const fullPath = path.resolve(this.workspace, tf.file);
+                const content = fs.readFileSync(fullPath, 'utf-8');
+                const testBlocks = this.extractTestBlocks(content, symbol.name);
+                for (const block of testBlocks.slice(0, 2)) {
+                    results.push({
+                        file: tf.file,
+                        testName: block.name,
+                        source: block.source
+                    });
+                }
+            }
+            catch { /* skip unreadable files */ }
+        }
+        return results;
+    }
+    extractTestBlocks(content, symbolName) {
+        const blocks = [];
+        const lines = content.split('\n');
+        const testPattern = /(?:it|test|describe)\s*\(\s*['"`]([^'"`]*?)['"`]/;
+        for (let i = 0; i < lines.length; i++) {
+            const match = lines[i].match(testPattern);
+            if (match && (lines[i].includes(symbolName) || (i + 10 < lines.length && lines.slice(i, i + 10).join('\n').includes(symbolName)))) {
+                const name = match[1];
+                const end = Math.min(i + 15, lines.length);
+                const source = lines.slice(i, end).join('\n');
+                blocks.push({ name, source });
+            }
+        }
+        return blocks;
+    }
+    async getGitContext(symbol) {
+        return this.gitService.getFileHistory(symbol.filePath, 5);
+    }
+    async getSiblingContext(symbol) {
+        const query = symbol.parentSymbolId
+            ? `SELECT name, kind, signature, start_line as line FROM symbols WHERE parent_symbol_id = ? AND id != ? ORDER BY start_line`
+            : `SELECT s.name, s.kind, s.signature, s.start_line as line FROM symbols s JOIN files f ON s.file_id = f.id WHERE f.relative_path = ? AND s.parent_symbol_id IS NULL AND s.id != ? ORDER BY s.start_line`;
+        const params = symbol.parentSymbolId
+            ? [symbol.parentSymbolId, symbol.id]
+            : [symbol.filePath, symbol.id];
+        return this.db.prepare(query).all(...params).map(r => ({
+            name: r.name,
+            kind: r.kind,
+            signature: r.signature,
+            line: r.line
+        }));
+    }
+    symbolNotFoundResponse(symbol, budget, startTime) {
+        return {
+            symbol,
+            file: '',
+            line: 0,
+            kind: 'unknown',
+            source: '',
+            signature: null,
+            metadata: {
+                tokenCount: 0,
+                tokenBudget: budget,
+                sectionsIncluded: [],
+                sectionsExcluded: ['error: symbol not found'],
+                queryTimeMs: Date.now() - startTime
+            }
+        };
+    }
+}
+//# sourceMappingURL=edit-context-service.js.map

package/dist/engine/context/edit-context-service.js.map

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

package/dist/engine/context/git-service.d.ts

@@ -0,0 +1,12 @@
+/**
+ * KSA-159: Git Service — wraps git log for file history.
+ */
+import { GitCommit } from './types.js';
+export declare class GitService {
+    private workspaceRoot;
+    constructor(workspaceRoot: string);
+    /** Get recent commit history for a file. */
+    getFileHistory(filePath: string, limit?: number): GitCommit[];
+    /** Check if git is available in the workspace. */
+    isAvailable(): boolean;
+}

package/dist/engine/context/git-service.js

@@ -0,0 +1,41 @@
+/**
+ * KSA-159: Git Service — wraps git log for file history.
+ */
+import { execSync } from 'child_process';
+export class GitService {
+    workspaceRoot;
+    constructor(workspaceRoot) {
+        this.workspaceRoot = workspaceRoot;
+    }
+    /** Get recent commit history for a file. */
+    getFileHistory(filePath, limit = 5) {
+        try {
+            const output = execSync(`git log --oneline --follow -n ${limit} -- "${filePath}"`, { cwd: this.workspaceRoot, encoding: 'utf-8', timeout: 5000 });
+            return output.trim().split('\n').filter(Boolean).map(line => {
+                const spaceIdx = line.indexOf(' ');
+                return {
+                    hash: line.substring(0, spaceIdx),
+                    message: line.substring(spaceIdx + 1)
+                };
+            });
+        }
+        catch {
+            return []; // Git not available or file not tracked
+        }
+    }
+    /** Check if git is available in the workspace. */
+    isAvailable() {
+        try {
+            execSync('git rev-parse --is-inside-work-tree', {
+                cwd: this.workspaceRoot,
+                encoding: 'utf-8',
+                timeout: 2000
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+//# sourceMappingURL=git-service.js.map

package/dist/engine/context/git-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"git-service.js","sourceRoot":"","sources":["../../../src/engine/context/git-service.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAGzC,MAAM,OAAO,UAAU;IACb,aAAa,CAAS;IAE9B,YAAY,aAAqB;QAC/B,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,4CAA4C;IAC5C,cAAc,CAAC,QAAgB,EAAE,QAAgB,CAAC;QAChD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CACrB,iCAAiC,KAAK,QAAQ,QAAQ,GAAG,EACzD,EAAE,GAAG,EAAE,IAAI,CAAC,aAAa,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAC9D,CAAC;YAEF,OAAO,MAAM,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE;gBAC1D,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBACnC,OAAO;oBACL,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,QAAQ,CAAC;oBACjC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,GAAG,CAAC,CAAC;iBACtC,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC,CAAC,wCAAwC;QACrD,CAAC;IACH,CAAC;IAED,kDAAkD;IAClD,WAAW;QACT,IAAI,CAAC;YACH,QAAQ,CAAC,qCAAqC,EAAE;gBAC9C,GAAG,EAAE,IAAI,CAAC,aAAa;gBACvB,QAAQ,EAAE,OAAO;gBACjB,OAAO,EAAE,IAAI;aACd,CAAC,CAAC;YACH,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF"}

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

@@ -0,0 +1,14 @@
+/**
+ * Context module barrel export.
+ * KSA-158: AI Context, KSA-159: Edit Context, KSA-160: Curated Context
+ */
+export { AIContextService } from './ai-context-service.js';
+export { EditContextService } from './edit-context-service.js';
+export { CuratedContextService } from './curated-context-service.js';
+export { TokenBudgetManager } from './token-budget-manager.js';
+export { QueryAnalyzer } from './query-analyzer.js';
+export { RRFMerger } from './rrf-merger.js';
+export { BudgetAllocator } from './budget-allocator.js';
+export { GitService } from './git-service.js';
+export { getStrategy, getSupportedIntents } from './intent-strategies.js';
+export * from './types.js';

package/dist/engine/context/index.js

@@ -0,0 +1,15 @@
+/**
+ * Context module barrel export.
+ * KSA-158: AI Context, KSA-159: Edit Context, KSA-160: Curated Context
+ */
+export { AIContextService } from './ai-context-service.js';
+export { EditContextService } from './edit-context-service.js';
+export { CuratedContextService } from './curated-context-service.js';
+export { TokenBudgetManager } from './token-budget-manager.js';
+export { QueryAnalyzer } from './query-analyzer.js';
+export { RRFMerger } from './rrf-merger.js';
+export { BudgetAllocator } from './budget-allocator.js';
+export { GitService } from './git-service.js';
+export { getStrategy, getSupportedIntents } from './intent-strategies.js';
+export * from './types.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/engine/context/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,wBAAwB,CAAC;AAC1E,cAAc,YAAY,CAAC"}

package/dist/engine/context/intent-strategies.d.ts

@@ -0,0 +1,16 @@
+/**
+ * KSA-158: Intent Strategies — maps intent to prioritized section list.
+ */
+export interface SectionDef {
+    name: string;
+    priority: number;
+    format: 'full' | 'summary' | 'signatures';
+}
+export interface IntentStrategy {
+    intent: string;
+    sections: SectionDef[];
+}
+/** Get the intent strategy (section priorities) for a given intent. Falls back to 'explain'. */
+export declare function getStrategy(intent: string): IntentStrategy;
+/** Get all supported intent names. */
+export declare function getSupportedIntents(): string[];