sdlc-agent-4-enterprise-server 1.0.0

package/dist/engine/analyzers/similarity/SimilarityTools.js.map

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

package/dist/engine/analyzers/similarity/types.d.ts

@@ -0,0 +1,67 @@
+/**
+ * KSA-168: Similarity & Mining — Type definitions.
+ * Duplicate detection, dead code analysis, and git history mining.
+ */
+export interface SimilarityPair {
+    symbolIdA: number;
+    symbolIdB: number;
+    nameA: string;
+    nameB: string;
+    filePathA: string;
+    filePathB: string;
+    similarity: number;
+}
+export interface DuplicateCluster {
+    id: string;
+    members: ClusterMember[];
+    avgSimilarity: number;
+    suggestion: string;
+}
+export interface ClusterMember {
+    symbolId: number;
+    name: string;
+    filePath: string;
+    startLine: number;
+    endLine: number;
+    tokenCount: number;
+}
+export interface DuplicateReport {
+    clusters: DuplicateCluster[];
+    totalPairsScanned: number;
+    totalDuplicates: number;
+    scanDurationMs: number;
+}
+export interface DeadCodeCandidate {
+    symbolId: number;
+    name: string;
+    kind: string;
+    filePath: string;
+    startLine: number;
+    confidence: number;
+    reasons: string[];
+}
+export interface DeadCodeReport {
+    candidates: DeadCodeCandidate[];
+    totalFunctions: number;
+    reachableCount: number;
+    unreachableCount: number;
+    scanDurationMs: number;
+}
+export interface GitCommit {
+    hash: string;
+    author: string;
+    date: string;
+    message: string;
+    filesChanged: string[];
+    insertions: number;
+    deletions: number;
+}
+export interface GitCommitResult extends GitCommit {
+    score: number;
+}
+export interface GitIndexSummary {
+    totalCommits: number;
+    indexed: number;
+    lastHash: string | null;
+    lastIndexedAt: string | null;
+}

package/dist/engine/analyzers/similarity/types.js

@@ -0,0 +1,6 @@
+/**
+ * KSA-168: Similarity & Mining — Type definitions.
+ * Duplicate detection, dead code analysis, and git history mining.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/engine/analyzers/similarity/types.js.map

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

package/dist/engine/config.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Configuration loading — environment variables and config file.
+ * Workspace resolution priority:
+ * 1. --workspace CLI arg (highest — Kiro resolves ${workspaceFolder})
+ * 2. CODE_INTEL_WORKSPACE env var
+ * 3. initialize.roots[0].uri (MCP protocol)
+ * 4. cwd() (lowest fallback)
+ */
+export interface AppConfig {
+    workspace: string;
+    viewerPort: number;
+    dbPath: string;
+    configPath: string;
+    watchEnabled: boolean;
+    watchDebounceMs: number;
+    ollamaUrl: string | null;
+    ollamaModel: string;
+    excludePatterns: string[];
+    includeExtensions: string[];
+    maxFileSize: number;
+}
+/** Create initial config — checks CLI args, env, then cwd. */
+export declare function loadConfig(): AppConfig;
+/** Set workspace from MCP initialize roots (only if CLI/env not already set). */
+export declare function setWorkspace(config: AppConfig, rootUri: string | null): AppConfig;
+/** Convert a file:// URI to a local filesystem path. */
+export declare function fileUriToPath(uri: string): string;
+/** Resolve orchestration config path from --config CLI arg. Null = use default workspace path. */
+export declare function resolveOrchestrationConfigPath(): string | null;

package/dist/engine/config.js

@@ -0,0 +1,133 @@
+/**
+ * Configuration loading — environment variables and config file.
+ * Workspace resolution priority:
+ * 1. --workspace CLI arg (highest — Kiro resolves ${workspaceFolder})
+ * 2. CODE_INTEL_WORKSPACE env var
+ * 3. initialize.roots[0].uri (MCP protocol)
+ * 4. cwd() (lowest fallback)
+ */
+import * as path from 'path';
+import * as fs from 'fs';
+import { fileURLToPath } from 'url';
+const DEFAULT_EXCLUDE = [
+    'node_modules', '.git', 'dist', 'build', '.gradle',
+    '.idea', '.vscode', '__pycache__', '.venv', 'target',
+    '.code-intel', 'coverage', '.next', '.nuxt',
+];
+const DEFAULT_EXTENSIONS = [
+    '.ts', '.tsx', '.js', '.jsx', '.kt', '.java', '.py',
+    '.go', '.rs', '.c', '.cpp', '.h', '.hpp', '.cs',
+    '.rb', '.php', '.swift', '.scala', '.sql', '.sh',
+    '.yaml', '.yml', '.json', '.toml', '.gradle.kts',
+    '.cls', '.trigger', // Salesforce Apex
+];
+/** Create initial config — checks CLI args, env, then cwd. */
+export function loadConfig() {
+    const workspace = resolveWorkspaceFromCli() ?? resolveWorkspaceFromEnv();
+    return buildConfig(workspace);
+}
+/** Set workspace from MCP initialize roots (only if CLI/env not already set). */
+export function setWorkspace(config, rootUri) {
+    // CLI arg and env var take priority over initialize roots
+    if (resolveWorkspaceFromCli() || process.env['CODE_INTEL_WORKSPACE']) {
+        return config;
+    }
+    const workspace = resolveWorkspaceFromRoots(rootUri);
+    return buildConfig(workspace);
+}
+/** Convert a file:// URI to a local filesystem path. */
+export function fileUriToPath(uri) {
+    try {
+        return fileURLToPath(uri);
+    }
+    catch {
+        // Fallback: manual strip for edge cases
+        return uri.replace(/^file:\/\/\//, process.platform === 'win32' ? '' : '/');
+    }
+}
+function resolveWorkspaceFromEnv() {
+    const envWs = process.env['CODE_INTEL_WORKSPACE'];
+    if (envWs)
+        return path.resolve(envWs);
+    return process.cwd();
+}
+function resolveWorkspaceFromCli() {
+    const args = process.argv.slice(2);
+    const idx = args.indexOf('--workspace');
+    if (idx >= 0 && args[idx + 1])
+        return path.resolve(args[idx + 1]);
+    return null;
+}
+function resolveViewerPort() {
+    const args = process.argv.slice(2);
+    const idx = args.indexOf('--viewer-port');
+    if (idx >= 0 && args[idx + 1])
+        return parseInt(args[idx + 1], 10);
+    const envPort = process.env['CODE_INTEL_VIEWER_PORT'];
+    if (envPort)
+        return parseInt(envPort, 10);
+    return 3202;
+}
+/** Resolve orchestration config path from --config CLI arg. Null = use default workspace path. */
+export function resolveOrchestrationConfigPath() {
+    const args = process.argv.slice(2);
+    const idx = args.indexOf('--config');
+    if (idx >= 0 && args[idx + 1])
+        return path.resolve(args[idx + 1]);
+    return null;
+}
+function resolveWorkspaceFromRoots(rootUri) {
+    // Env var always takes priority (backward compat)
+    const envWs = process.env['CODE_INTEL_WORKSPACE'];
+    if (envWs)
+        return path.resolve(envWs);
+    if (rootUri)
+        return path.resolve(fileUriToPath(rootUri));
+    return process.cwd();
+}
+function buildConfig(workspace) {
+    const envDataDir = process.env['CODE_INTEL_DATA_DIR'] || '.code-intel';
+    const codeIntelDir = path.isAbsolute(envDataDir) ? envDataDir : path.join(workspace, envDataDir);
+    const configPath = path.join(codeIntelDir, 'config.json');
+    const fileConfig = loadFileConfig(configPath);
+    const envDb = process.env['CODE_INTEL_DB'] || 'index.db';
+    const dbPath = path.isAbsolute(envDb) ? envDb : path.join(codeIntelDir, envDb);
+    return {
+        workspace,
+        viewerPort: resolveViewerPort(),
+        dbPath,
+        configPath,
+        watchEnabled: envBool('CODE_INTEL_WATCH', fileConfig.watchEnabled ?? true),
+        watchDebounceMs: envInt('CODE_INTEL_DEBOUNCE', fileConfig.watchDebounceMs ?? 500),
+        ollamaUrl: process.env['OLLAMA_URL'] ?? fileConfig.ollamaUrl ?? null,
+        ollamaModel: process.env['OLLAMA_MODEL'] ?? fileConfig.ollamaModel ?? 'nomic-embed-text',
+        excludePatterns: fileConfig.excludePatterns ?? DEFAULT_EXCLUDE,
+        includeExtensions: fileConfig.includeExtensions ?? DEFAULT_EXTENSIONS,
+        maxFileSize: fileConfig.maxFileSize ?? 512_000,
+    };
+}
+function loadFileConfig(configPath) {
+    try {
+        if (fs.existsSync(configPath)) {
+            return JSON.parse(fs.readFileSync(configPath, 'utf-8'));
+        }
+    }
+    catch (err) {
+        console.error(`[config] Failed to read ${configPath}:`, err);
+    }
+    return {};
+}
+function envBool(key, fallback) {
+    const val = process.env[key];
+    if (val === undefined)
+        return fallback;
+    return val === '1' || val.toLowerCase() === 'true';
+}
+function envInt(key, fallback) {
+    const val = process.env[key];
+    if (val === undefined)
+        return fallback;
+    const parsed = parseInt(val, 10);
+    return isNaN(parsed) ? fallback : parsed;
+}
+//# sourceMappingURL=config.js.map

package/dist/engine/config.js.map

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

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

@@ -0,0 +1,33 @@
+/**
+ * KSA-158: AI Context Service — intent-aware context assembly with token budgeting.
+ * Orchestrates symbol resolution, section fetching, and budget management.
+ */
+import Database from 'better-sqlite3';
+import { SymbolResolver } from '../graph/symbol-resolver.js';
+import { CallGraphService } from '../graph/call-graph-service.js';
+import { AIContextParams, AIContextResponse } from './types.js';
+export declare class AIContextService {
+    private db;
+    private resolver;
+    private callGraph;
+    private gitService;
+    private workspace;
+    constructor(db: Database.Database, resolver: SymbolResolver, callGraph: CallGraphService, workspace: string);
+    /** Get intent-aware context for a symbol within token budget. */
+    getContext(params: AIContextParams): Promise<AIContextResponse>;
+    private fetchSection;
+    private fetchSource;
+    private fetchCallers;
+    private fetchCallees;
+    private fetchSiblings;
+    private fetchImports;
+    private fetchRelatedTests;
+    private fetchTypeDefinitions;
+    private fetchDocComment;
+    private fetchErrorPatterns;
+    private fetchRecentChanges;
+    private fetchTestPatterns;
+    private fetchMocksNeeded;
+    private getSymbolEndLine;
+    private notFoundResponse;
+}

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

@@ -0,0 +1,277 @@
+/**
+ * KSA-158: AI Context Service — intent-aware context assembly with token budgeting.
+ * Orchestrates symbol resolution, section fetching, and budget management.
+ */
+import * as fs from 'fs';
+import * as path from 'path';
+import { TokenBudgetManager } from './token-budget-manager.js';
+import { getStrategy } from './intent-strategies.js';
+import { GitService } from './git-service.js';
+export class AIContextService {
+    db;
+    resolver;
+    callGraph;
+    gitService;
+    workspace;
+    constructor(db, resolver, callGraph, workspace) {
+        this.db = db;
+        this.resolver = resolver;
+        this.callGraph = callGraph;
+        this.gitService = new GitService(workspace);
+        this.workspace = workspace;
+    }
+    /** Get intent-aware context for a symbol within token budget. */
+    async getContext(params) {
+        const startTime = Date.now();
+        const { symbol, intent = 'explain', token_budget = 4000, caller_depth = 1 } = params;
+        // 1. Resolve symbol
+        const resolved = this.resolver.resolve(symbol);
+        if (resolved.length === 0) {
+            return this.notFoundResponse(symbol, intent, token_budget, startTime);
+        }
+        const targetSymbol = resolved[0];
+        // 2. Get intent strategy
+        const strategy = getStrategy(intent);
+        // 3. Assemble context with budget
+        const budgetManager = new TokenBudgetManager(token_budget);
+        const context = {};
+        const sectionsIncluded = [];
+        const sectionsOmitted = [];
+        for (const section of strategy.sections) {
+            if (budgetManager.isExhausted()) {
+                sectionsOmitted.push(section.name);
+                continue;
+            }
+            const content = this.fetchSection(section, targetSymbol, caller_depth);
+            if (content == null) {
+                continue; // Section not available
+            }
+            const tokens = budgetManager.estimateTokens(content);
+            if (budgetManager.canFit(tokens)) {
+                context[section.name] = content;
+                budgetManager.consume(tokens);
+                sectionsIncluded.push(section.name);
+            }
+            else if (budgetManager.remaining() > 100) {
+                // Partial fit
+                const truncated = budgetManager.truncateToFit(content);
+                context[section.name] = truncated;
+                context[`${section.name}_truncated`] = true;
+                budgetManager.consumeAll();
+                sectionsIncluded.push(section.name);
+            }
+            else {
+                sectionsOmitted.push(section.name);
+            }
+        }
+        return {
+            symbol: targetSymbol.name,
+            file_path: targetSymbol.filePath,
+            kind: targetSymbol.kind,
+            intent,
+            context,
+            metadata: {
+                budget_used: budgetManager.used(),
+                budget_total: token_budget,
+                sections_included: sectionsIncluded,
+                sections_omitted: sectionsOmitted,
+                query_time_ms: Date.now() - startTime
+            }
+        };
+    }
+    fetchSection(section, symbol, callerDepth) {
+        try {
+            switch (section.name) {
+                case 'source':
+                    return this.fetchSource(symbol);
+                case 'callers':
+                    return this.fetchCallers(symbol, callerDepth, section.format);
+                case 'callees':
+                    return this.fetchCallees(symbol, callerDepth);
+                case 'siblings':
+                    return this.fetchSiblings(symbol);
+                case 'imports':
+                    return this.fetchImports(symbol);
+                case 'tests':
+                    return this.fetchRelatedTests(symbol);
+                case 'type_definitions':
+                    return this.fetchTypeDefinitions(symbol);
+                case 'doc_comment':
+                    return this.fetchDocComment(symbol);
+                case 'error_patterns':
+                    return this.fetchErrorPatterns(symbol);
+                case 'recent_changes':
+                    return this.fetchRecentChanges(symbol);
+                case 'test_patterns':
+                    return this.fetchTestPatterns(symbol);
+                case 'mocks_needed':
+                    return this.fetchMocksNeeded(symbol);
+                default:
+                    return null;
+            }
+        }
+        catch {
+            return null; // Section fetch failed, skip gracefully
+        }
+    }
+    fetchSource(symbol) {
+        try {
+            const fullPath = path.resolve(this.workspace, symbol.filePath);
+            if (!fs.existsSync(fullPath))
+                return null;
+            const content = fs.readFileSync(fullPath, 'utf-8');
+            const lines = content.split('\n');
+            const startLine = symbol.line - 1;
+            const endLine = this.getSymbolEndLine(symbol) || startLine + 50;
+            return lines.slice(startLine, endLine).join('\n');
+        }
+        catch {
+            return null;
+        }
+    }
+    fetchCallers(symbol, depth, format) {
+        const result = this.callGraph.findCallers(symbol.name, depth, 10);
+        if (result.results.length === 0)
+            return null;
+        if (format === 'summary') {
+            return result.results.map(r => `${r.symbol} (${r.filePath}:${r.callSiteLine})`);
+        }
+        return result.results.map(r => ({
+            symbol: r.symbol,
+            file: r.filePath,
+            line: r.callSiteLine,
+            kind: r.kind
+        }));
+    }
+    fetchCallees(symbol, depth) {
+        const result = this.callGraph.findCallees(symbol.name, depth, 10);
+        if (result.results.length === 0)
+            return null;
+        return result.results.map(r => ({
+            symbol: r.symbol,
+            file: r.filePath,
+            line: r.callSiteLine,
+            kind: r.kind
+        }));
+    }
+    fetchSiblings(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];
+        const rows = this.db.prepare(query).all(...params);
+        if (rows.length === 0)
+            return null;
+        return rows.map(r => ({ name: r.name, kind: r.kind, signature: r.signature, line: r.line }));
+    }
+    fetchImports(symbol) {
+        const rows = this.db.prepare(`
+      SELECT DISTINCT r.target_symbol as name, r.file_path
+      FROM relationships r
+      WHERE r.source_symbol_id = ? AND r.kind = 'imports'
+    `).all(symbol.id);
+        if (rows.length === 0)
+            return null;
+        return rows.map(r => r.name);
+    }
+    fetchRelatedTests(symbol) {
+        const rows = this.db.prepare(`
+      SELECT DISTINCT f.relative_path as file_path
+      FROM relationships r
+      JOIN files f ON r.file_path = f.relative_path
+      WHERE r.target_symbol LIKE ?
+      AND (f.relative_path LIKE '%test%' OR f.relative_path LIKE '%spec%')
+      LIMIT 5
+    `).all(`%${symbol.name}%`);
+        if (rows.length === 0)
+            return null;
+        return rows.map(r => r.file_path);
+    }
+    fetchTypeDefinitions(symbol) {
+        const rows = this.db.prepare(`
+      SELECT DISTINCT s.name, s.kind, s.signature, f.relative_path as file
+      FROM relationships r
+      JOIN symbols s ON s.id = r.target_symbol_id
+      JOIN files f ON s.file_id = f.id
+      WHERE r.source_symbol_id = ? AND s.kind IN ('interface', 'type_alias', 'enum', 'class')
+      LIMIT 10
+    `).all(symbol.id);
+        if (rows.length === 0)
+            return null;
+        return rows;
+    }
+    fetchDocComment(symbol) {
+        const row = this.db.prepare(`
+      SELECT doc_comment FROM symbols WHERE id = ?
+    `).get(symbol.id);
+        return row?.doc_comment || null;
+    }
+    fetchErrorPatterns(symbol) {
+        const source = this.fetchSource(symbol);
+        if (!source)
+            return null;
+        const patterns = [];
+        const lines = source.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            if (line.startsWith('throw '))
+                patterns.push({ type: 'throw', line: i + 1, text: line });
+            if (line.startsWith('catch'))
+                patterns.push({ type: 'catch', line: i + 1, text: line });
+            if (line.includes('.catch('))
+                patterns.push({ type: 'promise-catch', line: i + 1, text: line });
+        }
+        return patterns.length > 0 ? patterns : null;
+    }
+    fetchRecentChanges(symbol) {
+        const commits = this.gitService.getFileHistory(symbol.filePath, 5);
+        return commits.length > 0 ? commits : null;
+    }
+    fetchTestPatterns(symbol) {
+        const rows = this.db.prepare(`
+      SELECT DISTINCT s.name, s.signature
+      FROM symbols s
+      JOIN files f ON s.file_id = f.id
+      WHERE (f.relative_path LIKE '%test%' OR f.relative_path LIKE '%spec%')
+      AND s.kind = 'function'
+      AND f.module = (SELECT module FROM files WHERE relative_path = ?)
+      LIMIT 10
+    `).all(symbol.filePath);
+        if (rows.length === 0)
+            return null;
+        return rows.map(r => r.name);
+    }
+    fetchMocksNeeded(symbol) {
+        const result = this.callGraph.findCallees(symbol.name, 1, 20);
+        if (result.results.length === 0)
+            return null;
+        const externalDeps = result.results
+            .filter(r => r.filePath !== symbol.filePath && r.filePath !== '(external)')
+            .map(r => ({ symbol: r.symbol, file: r.filePath }));
+        return externalDeps.length > 0 ? externalDeps : null;
+    }
+    getSymbolEndLine(symbol) {
+        const row = this.db.prepare(`SELECT end_line FROM symbols WHERE id = ?`).get(symbol.id);
+        return row?.end_line || null;
+    }
+    notFoundResponse(symbol, intent, budget, startTime) {
+        const suggestions = this.resolver.suggest(symbol);
+        return {
+            symbol,
+            file_path: '',
+            kind: 'unknown',
+            intent,
+            context: { error: `Symbol "${symbol}" not found`, suggestions },
+            metadata: {
+                budget_used: 0,
+                budget_total: budget,
+                sections_included: [],
+                sections_omitted: [],
+                query_time_ms: Date.now() - startTime
+            }
+        };
+    }
+}
+//# sourceMappingURL=ai-context-service.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ai-context-service.js","sourceRoot":"","sources":["../../../src/engine/context/ai-context-service.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,MAAM,IAAI,CAAC;AACzB,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAI7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,WAAW,EAAc,MAAM,wBAAwB,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAG9C,MAAM,OAAO,gBAAgB;IACnB,EAAE,CAAoB;IACtB,QAAQ,CAAiB;IACzB,SAAS,CAAmB;IAC5B,UAAU,CAAa;IACvB,SAAS,CAAS;IAE1B,YACE,EAAqB,EACrB,QAAwB,EACxB,SAA2B,EAC3B,SAAiB;QAEjB,IAAI,CAAC,EAAE,GAAG,EAAE,CAAC;QACb,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,UAAU,GAAG,IAAI,UAAU,CAAC,SAAS,CAAC,CAAC;QAC5C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED,iEAAiE;IACjE,KAAK,CAAC,UAAU,CAAC,MAAuB;QACtC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC7B,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,GAAG,IAAI,EAAE,YAAY,GAAG,CAAC,EAAE,GAAG,MAAM,CAAC;QAErF,oBAAoB;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,EAAE,SAAS,CAAC,CAAC;QACxE,CAAC;QAED,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAEjC,yBAAyB;QACzB,MAAM,QAAQ,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC;QAErC,kCAAkC;QAClC,MAAM,aAAa,GAAG,IAAI,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAC3D,MAAM,OAAO,GAAwB,EAAE,CAAC;QACxC,MAAM,gBAAgB,GAAa,EAAE,CAAC;QACtC,MAAM,eAAe,GAAa,EAAE,CAAC;QAErC,KAAK,MAAM,OAAO,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YACxC,IAAI,aAAa,CAAC,WAAW,EAAE,EAAE,CAAC;gBAChC,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;gBACnC,SAAS;YACX,CAAC;YAED,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,EAAE,YAAY,CAAC,CAAC;YACvE,IAAI,OAAO,IAAI,IAAI,EAAE,CAAC;gBACpB,SAAS,CAAC,wBAAwB;YACpC,CAAC;YAED,MAAM,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;YAErD,IAAI,aAAa,CAAC,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;gBACjC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC;gBAChC,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;gBAC9B,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;iBAAM,IAAI,aAAa,CAAC,SAAS,EAAE,GAAG,GAAG,EAAE,CAAC;gBAC3C,cAAc;gBACd,MAAM,SAAS,GAAG,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,CAAC;gBACvD,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC;gBAClC,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,YAAY,CAAC,GAAG,IAAI,CAAC;gBAC5C,aAAa,CAAC,UAAU,EAAE,CAAC;gBAC3B,gBAAgB,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtC,CAAC;iBAAM,CAAC;gBACN,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACrC,CAAC;QACH,CAAC;QAED,OAAO;YACL,MAAM,EAAE,YAAY,CAAC,IAAI;YACzB,SAAS,EAAE,YAAY,CAAC,QAAQ;YAChC,IAAI,EAAE,YAAY,CAAC,IAAI;YACvB,MAAM;YACN,OAAO;YACP,QAAQ,EAAE;gBACR,WAAW,EAAE,aAAa,CAAC,IAAI,EAAE;gBACjC,YAAY,EAAE,YAAY;gBAC1B,iBAAiB,EAAE,gBAAgB;gBACnC,gBAAgB,EAAE,eAAe;gBACjC,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACtC;SACF,CAAC;IACJ,CAAC;IAEO,YAAY,CAAC,OAAmB,EAAE,MAAsB,EAAE,WAAmB;QACnF,IAAI,CAAC;YACH,QAAQ,OAAO,CAAC,IAAI,EAAE,CAAC;gBACrB,KAAK,QAAQ;oBACX,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;gBAClC,KAAK,SAAS;oBACZ,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;gBAChE,KAAK,SAAS;oBACZ,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;gBAChD,KAAK,UAAU;oBACb,OAAO,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;gBACpC,KAAK,SAAS;oBACZ,OAAO,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;gBACnC,KAAK,OAAO;oBACV,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBACxC,KAAK,kBAAkB;oBACrB,OAAO,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC;gBAC3C,KAAK,aAAa;oBAChB,OAAO,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,CAAC;gBACtC,KAAK,gBAAgB;oBACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;gBACzC,KAAK,gBAAgB;oBACnB,OAAO,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAC;gBACzC,KAAK,eAAe;oBAClB,OAAO,IAAI,CAAC,iBAAiB,CAAC,MAAM,CAAC,CAAC;gBACxC,KAAK,cAAc;oBACjB,OAAO,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC;gBACvC;oBACE,OAAO,IAAI,CAAC;YAChB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC,CAAC,wCAAwC;QACvD,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,MAAsB;QACxC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;YAC/D,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,OAAO,IAAI,CAAC;YAC1C,MAAM,OAAO,GAAG,EAAE,CAAC,YAAY,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;YACnD,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAClC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,GAAG,CAAC,CAAC;YAClC,MAAM,OAAO,GAAG,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,IAAI,SAAS,GAAG,EAAE,CAAC;YAChE,OAAO,KAAK,CAAC,KAAK,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;IACH,CAAC;IAEO,YAAY,CAAC,MAAsB,EAAE,KAAa,EAAE,MAAc;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAE7C,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,YAAY,GAAG,CAAC,CAAC;QAClF,CAAC;QACD,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC9B,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,IAAI,EAAE,CAAC,CAAC,QAAQ;YAChB,IAAI,EAAE,CAAC,CAAC,YAAY;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,YAAY,CAAC,MAAsB,EAAE,KAAa;QACxD,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAClE,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAC7C,OAAO,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YAC9B,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,IAAI,EAAE,CAAC,CAAC,QAAQ;YAChB,IAAI,EAAE,CAAC,CAAC,YAAY;YACpB,IAAI,EAAE,CAAC,CAAC,IAAI;SACb,CAAC,CAAC,CAAC;IACN,CAAC;IAEO,aAAa,CAAC,MAAsB;QAC1C,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc;YACjC,CAAC,CAAC,0HAA0H;YAC5H,CAAC,CAAC,uMAAuM,CAAC;QAE5M,MAAM,MAAM,GAAG,MAAM,CAAC,cAAc;YAClC,CAAC,CAAC,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,EAAE,CAAC;YACpC,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC,CAAC;QAEjC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CAAU,CAAC;QAC5D,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;IAC/F,CAAC;IAEO,YAAY,CAAC,MAAsB;QACzC,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;KAI5B,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAU,CAAC;QAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAEO,iBAAiB,CAAC,MAAsB;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;KAO5B,CAAC,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,GAAG,CAAU,CAAC;QACpC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IACpC,CAAC;IAEO,oBAAoB,CAAC,MAAsB;QACjD,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;KAO5B,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAU,CAAC;QAC3B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAEO,eAAe,CAAC,MAAsB;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;KAE3B,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAA+C,CAAC;QAChE,OAAO,GAAG,EAAE,WAAW,IAAI,IAAI,CAAC;IAClC,CAAC;IAEO,kBAAkB,CAAC,MAAsB;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM;YAAE,OAAO,IAAI,CAAC;QAEzB,MAAM,QAAQ,GAAU,EAAE,CAAC;QAC3B,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACjC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;YAC7B,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACzF,IAAI,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YACxF,IAAI,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAClG,CAAC;QACD,OAAO,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC;IAC/C,CAAC;IAEO,kBAAkB,CAAC,MAAsB;QAC/C,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,cAAc,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QACnE,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC7C,CAAC;IAEO,iBAAiB,CAAC,MAAsB;QAC9C,MAAM,IAAI,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC;;;;;;;;KAQ5B,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAU,CAAC;QACjC,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACnC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAEO,gBAAgB,CAAC,MAAsB;QAC7C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9D,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QAE7C,MAAM,YAAY,GAAG,MAAM,CAAC,OAAO;aAChC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,QAAQ,KAAK,YAAY,CAAC;aAC1E,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAEtD,OAAO,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,IAAI,CAAC;IACvD,CAAC;IAEO,gBAAgB,CAAC,MAAsB;QAC7C,MAAM,GAAG,GAAG,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,2CAA2C,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAqC,CAAC;QAC5H,OAAO,GAAG,EAAE,QAAQ,IAAI,IAAI,CAAC;IAC/B,CAAC;IAEO,gBAAgB,CAAC,MAAc,EAAE,MAAc,EAAE,MAAc,EAAE,SAAiB;QACxF,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO;YACL,MAAM;YACN,SAAS,EAAE,EAAE;YACb,IAAI,EAAE,SAAS;YACf,MAAM;YACN,OAAO,EAAE,EAAE,KAAK,EAAE,WAAW,MAAM,aAAa,EAAE,WAAW,EAAE;YAC/D,QAAQ,EAAE;gBACR,WAAW,EAAE,CAAC;gBACd,YAAY,EAAE,MAAM;gBACpB,iBAAiB,EAAE,EAAE;gBACrB,gBAAgB,EAAE,EAAE;gBACpB,aAAa,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS;aACtC;SACF,CAAC;IACJ,CAAC;CACF"}

package/dist/engine/context/budget-allocator.d.ts

@@ -0,0 +1,16 @@
+/**
+ * KSA-160: Budget Allocator — allocates token budget across ranked results.
+ * Top results get full source, middle get signatures, bottom get references.
+ */
+import { MergedResult } from './types.js';
+export interface AllocatedResult extends MergedResult {
+    detail: 'full' | 'signature' | 'reference';
+    content: string;
+    tokens: number;
+}
+export declare class BudgetAllocator {
+    private CHARS_PER_TOKEN;
+    /** Allocate token budget across merged results with progressive detail levels. */
+    allocate(results: MergedResult[], maxTokens: number): AllocatedResult[];
+    private estimateTokens;
+}

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

@@ -0,0 +1,52 @@
+/**
+ * KSA-160: Budget Allocator — allocates token budget across ranked results.
+ * Top results get full source, middle get signatures, bottom get references.
+ */
+export class BudgetAllocator {
+    CHARS_PER_TOKEN = 4;
+    /** Allocate token budget across merged results with progressive detail levels. */
+    allocate(results, maxTokens) {
+        const allocated = [];
+        let tokensUsed = 100; // Response overhead
+        const highThreshold = Math.max(1, Math.ceil(results.length * 0.2));
+        const medThreshold = Math.ceil(results.length * 0.6);
+        for (let i = 0; i < results.length; i++) {
+            if (tokensUsed >= maxTokens)
+                break;
+            const result = results[i];
+            let detail;
+            let content;
+            let tokens;
+            if (i < highThreshold) {
+                detail = 'full';
+                content = result.source_code || result.content || result.signature || result.name;
+                tokens = this.estimateTokens(content);
+            }
+            else if (i < medThreshold) {
+                detail = 'signature';
+                content = result.signature || result.name;
+                tokens = this.estimateTokens(content);
+            }
+            else {
+                detail = 'reference';
+                content = `${result.name} (${result.file || 'unknown'}:${result.line || 0})`;
+                tokens = 15;
+            }
+            // Downgrade if exceeds budget
+            if (tokensUsed + tokens > maxTokens && detail === 'full') {
+                detail = 'signature';
+                content = result.signature || result.name;
+                tokens = this.estimateTokens(content);
+            }
+            if (tokensUsed + tokens <= maxTokens) {
+                allocated.push({ ...result, detail, content, tokens });
+                tokensUsed += tokens;
+            }
+        }
+        return allocated;
+    }
+    estimateTokens(text) {
+        return Math.ceil(text.length / this.CHARS_PER_TOKEN);
+    }
+}
+//# sourceMappingURL=budget-allocator.js.map