@milo4jo/contextkit 0.1.0

package/dist/indexer/index.js.map

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

package/dist/selector/budget.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Budget Fitting Module
+ *
+ * Selects chunks to fit within a token budget.
+ * Prefers keeping chunks from the same file together.
+ */
+import type { RankedChunk } from './scoring.js';
+/** Selection result */
+export interface BudgetResult {
+    /** Selected chunks */
+    chunks: RankedChunk[];
+    /** Total tokens used */
+    totalTokens: number;
+    /** Chunks that didn't fit */
+    excluded: number;
+}
+/**
+ * Select chunks that fit within budget
+ */
+export declare function fitToBudget(chunks: RankedChunk[], budget: number): BudgetResult;
+/**
+ * Merge adjacent chunks from the same file
+ * (Optional optimization for cleaner output)
+ */
+export declare function mergeAdjacentChunks(chunks: RankedChunk[]): RankedChunk[];
+//# sourceMappingURL=budget.d.ts.map

package/dist/selector/budget.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/selector/budget.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAEhD,uBAAuB;AACvB,MAAM,WAAW,YAAY;IAC3B,sBAAsB;IACtB,MAAM,EAAE,WAAW,EAAE,CAAC;IACtB,wBAAwB;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,6BAA6B;IAC7B,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,YAAY,CAsC/E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,WAAW,EAAE,CA8BxE"}

package/dist/selector/budget.js

@@ -0,0 +1,75 @@
+/**
+ * Budget Fitting Module
+ *
+ * Selects chunks to fit within a token budget.
+ * Prefers keeping chunks from the same file together.
+ */
+/**
+ * Select chunks that fit within budget
+ */
+export function fitToBudget(chunks, budget) {
+    const selected = [];
+    let totalTokens = 0;
+    let excluded = 0;
+    // Track which files we've started including
+    const includedFiles = new Set();
+    for (const chunk of chunks) {
+        const wouldExceed = totalTokens + chunk.tokens > budget;
+        if (wouldExceed) {
+            excluded++;
+            continue;
+        }
+        // Bonus: if we've already included chunks from this file,
+        // slightly prefer including more from the same file
+        // (This is handled implicitly by processing in score order,
+        // but we could add explicit grouping here later)
+        selected.push(chunk);
+        totalTokens += chunk.tokens;
+        includedFiles.add(chunk.filePath);
+    }
+    // Re-sort selected chunks by file, then by line number for output
+    selected.sort((a, b) => {
+        const fileCompare = a.filePath.localeCompare(b.filePath);
+        if (fileCompare !== 0)
+            return fileCompare;
+        return a.startLine - b.startLine;
+    });
+    return {
+        chunks: selected,
+        totalTokens,
+        excluded,
+    };
+}
+/**
+ * Merge adjacent chunks from the same file
+ * (Optional optimization for cleaner output)
+ */
+export function mergeAdjacentChunks(chunks) {
+    if (chunks.length <= 1)
+        return chunks;
+    const merged = [];
+    let current = { ...chunks[0] };
+    for (let i = 1; i < chunks.length; i++) {
+        const next = chunks[i];
+        // Check if adjacent (same file, consecutive lines)
+        const isAdjacent = current.filePath === next.filePath && current.endLine + 1 >= next.startLine;
+        if (isAdjacent) {
+            // Merge chunks
+            current = {
+                ...current,
+                content: current.content + '\n' + next.content,
+                endLine: next.endLine,
+                tokens: current.tokens + next.tokens,
+                score: Math.max(current.score, next.score),
+                similarity: Math.max(current.similarity, next.similarity),
+            };
+        }
+        else {
+            merged.push(current);
+            current = { ...next };
+        }
+    }
+    merged.push(current);
+    return merged;
+}
+//# sourceMappingURL=budget.js.map

package/dist/selector/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/selector/budget.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAcH;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,MAAqB,EAAE,MAAc;IAC/D,MAAM,QAAQ,GAAkB,EAAE,CAAC;IACnC,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,QAAQ,GAAG,CAAC,CAAC;IAEjB,4CAA4C;IAC5C,MAAM,aAAa,GAAG,IAAI,GAAG,EAAU,CAAC;IAExC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,WAAW,GAAG,WAAW,GAAG,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC;QAExD,IAAI,WAAW,EAAE,CAAC;YAChB,QAAQ,EAAE,CAAC;YACX,SAAS;QACX,CAAC;QAED,0DAA0D;QAC1D,oDAAoD;QACpD,4DAA4D;QAC5D,iDAAiD;QAEjD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,WAAW,IAAI,KAAK,CAAC,MAAM,CAAC;QAC5B,aAAa,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAED,kEAAkE;IAClE,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE;QACrB,MAAM,WAAW,GAAG,CAAC,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC;QACzD,IAAI,WAAW,KAAK,CAAC;YAAE,OAAO,WAAW,CAAC;QAC1C,OAAO,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;IACnC,CAAC,CAAC,CAAC;IAEH,OAAO;QACL,MAAM,EAAE,QAAQ;QAChB,WAAW;QACX,QAAQ;KACT,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAqB;IACvD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC;QAAE,OAAO,MAAM,CAAC;IAEtC,MAAM,MAAM,GAAkB,EAAE,CAAC;IACjC,IAAI,OAAO,GAAG,EAAE,GAAG,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC;IAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;QAEvB,mDAAmD;QACnD,MAAM,UAAU,GAAG,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,IAAI,OAAO,CAAC,OAAO,GAAG,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC;QAE/F,IAAI,UAAU,EAAE,CAAC;YACf,eAAe;YACf,OAAO,GAAG;gBACR,GAAG,OAAO;gBACV,OAAO,EAAE,OAAO,CAAC,OAAO,GAAG,IAAI,GAAG,IAAI,CAAC,OAAO;gBAC9C,OAAO,EAAE,IAAI,CAAC,OAAO;gBACrB,MAAM,EAAE,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM;gBACpC,KAAK,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC;gBAC1C,UAAU,EAAE,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC;aAC1D,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACrB,OAAO,GAAG,EAAE,GAAG,IAAI,EAAE,CAAC;QACxB,CAAC;IACH,CAAC;IAED,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACrB,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/selector/formatter.d.ts

@@ -0,0 +1,44 @@
+/**
+ * Output Formatter Module
+ *
+ * Formats selected chunks for display.
+ */
+import type { BudgetResult } from './budget.js';
+/** Formatted output */
+export interface FormattedOutput {
+    /** Human-readable text output */
+    text: string;
+    /** Structured data for JSON output */
+    data: SelectionData;
+}
+/** Structured selection data */
+export interface SelectionData {
+    query: string;
+    context: string;
+    chunks: ChunkInfo[];
+    stats: SelectionStats;
+}
+/** Chunk info for JSON output */
+export interface ChunkInfo {
+    file: string;
+    lines: [number, number];
+    tokens: number;
+    score: number;
+}
+/** Selection statistics */
+export interface SelectionStats {
+    totalTokens: number;
+    chunksConsidered: number;
+    chunksIncluded: number;
+    filesIncluded: number;
+    timeMs: number;
+}
+/**
+ * Format selection results for output
+ */
+export declare function formatOutput(query: string, result: BudgetResult, totalConsidered: number, timeMs: number): FormattedOutput;
+/**
+ * Format output with --explain details
+ */
+export declare function formatWithExplanation(query: string, result: BudgetResult, totalConsidered: number, timeMs: number): FormattedOutput;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/selector/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/selector/formatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,uBAAuB;AACvB,MAAM,WAAW,eAAe;IAC9B,iCAAiC;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,sCAAsC;IACtC,IAAI,EAAE,aAAa,CAAC;CACrB;AAED,gCAAgC;AAChC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,KAAK,EAAE,cAAc,CAAC;CACvB;AAED,iCAAiC;AACjC,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACf;AAED,2BAA2B;AAC3B,MAAM,WAAW,cAAc;IAC7B,WAAW,EAAE,MAAM,CAAC;IACpB,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAC1B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,EACpB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GACb,eAAe,CAqDjB;AA8CD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,EACpB,eAAe,EAAE,MAAM,EACvB,MAAM,EAAE,MAAM,GACb,eAAe,CAmBjB"}

package/dist/selector/formatter.js

@@ -0,0 +1,114 @@
+/**
+ * Output Formatter Module
+ *
+ * Formats selected chunks for display.
+ */
+/**
+ * Format selection results for output
+ */
+export function formatOutput(query, result, totalConsidered, timeMs) {
+    const { chunks, totalTokens } = result;
+    // Group chunks by file
+    const fileGroups = new Map();
+    for (const chunk of chunks) {
+        const existing = fileGroups.get(chunk.filePath) || [];
+        existing.push(chunk);
+        fileGroups.set(chunk.filePath, existing);
+    }
+    // Build text output
+    const textParts = [];
+    for (const [filePath, fileChunks] of fileGroups) {
+        // Sort chunks by line number within file
+        fileChunks.sort((a, b) => a.startLine - b.startLine);
+        for (const chunk of fileChunks) {
+            const header = `## ${filePath} (lines ${chunk.startLine}-${chunk.endLine})`;
+            const codeBlock = formatCodeBlock(chunk.content, filePath);
+            textParts.push(`${header}\n${codeBlock}`);
+        }
+    }
+    // Add stats footer
+    const filesCount = fileGroups.size;
+    const statsLine = `📊 ${totalTokens.toLocaleString()} tokens | ${chunks.length} chunks | ${filesCount} files`;
+    const text = textParts.join('\n\n') + '\n\n---\n' + statsLine;
+    // Build structured data
+    const chunkInfos = chunks.map((c) => ({
+        file: c.filePath,
+        lines: [c.startLine, c.endLine],
+        tokens: c.tokens,
+        score: Math.round(c.score * 1000) / 1000,
+    }));
+    const data = {
+        query,
+        context: textParts.join('\n\n'),
+        chunks: chunkInfos,
+        stats: {
+            totalTokens,
+            chunksConsidered: totalConsidered,
+            chunksIncluded: chunks.length,
+            filesIncluded: filesCount,
+            timeMs,
+        },
+    };
+    return { text, data };
+}
+/**
+ * Format content as a code block with language hint
+ */
+function formatCodeBlock(content, filePath) {
+    const lang = getLanguage(filePath);
+    return '```' + lang + '\n' + content + '\n```';
+}
+/**
+ * Get language hint from file extension
+ */
+function getLanguage(filePath) {
+    const ext = filePath.split('.').pop()?.toLowerCase() || '';
+    const langMap = {
+        ts: 'typescript',
+        tsx: 'tsx',
+        js: 'javascript',
+        jsx: 'jsx',
+        py: 'python',
+        rb: 'ruby',
+        go: 'go',
+        rs: 'rust',
+        java: 'java',
+        kt: 'kotlin',
+        cs: 'csharp',
+        cpp: 'cpp',
+        c: 'c',
+        h: 'c',
+        hpp: 'cpp',
+        md: 'markdown',
+        json: 'json',
+        yaml: 'yaml',
+        yml: 'yaml',
+        toml: 'toml',
+        sql: 'sql',
+        sh: 'bash',
+        bash: 'bash',
+        zsh: 'bash',
+    };
+    return langMap[ext] || '';
+}
+/**
+ * Format output with --explain details
+ */
+export function formatWithExplanation(query, result, totalConsidered, timeMs) {
+    const base = formatOutput(query, result, totalConsidered, timeMs);
+    // Add explanation section
+    const explanations = result.chunks.map((chunk) => {
+        const { similarity, recency, pathMatch } = chunk.scoreBreakdown;
+        return `  ${chunk.filePath}:${chunk.startLine}
+    similarity: ${(similarity * 100).toFixed(1)}%
+    recency:    ${(recency * 100).toFixed(1)}%
+    path_match: ${(pathMatch * 100).toFixed(1)}%
+    → score:    ${(chunk.score * 100).toFixed(1)}%`;
+    });
+    const explainSection = '\n\n## Scoring Details\n\n' + explanations.join('\n\n');
+    return {
+        text: base.text + explainSection,
+        data: base.data,
+    };
+}
+//# sourceMappingURL=formatter.js.map

package/dist/selector/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/selector/formatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAsCH;;GAEG;AACH,MAAM,UAAU,YAAY,CAC1B,KAAa,EACb,MAAoB,EACpB,eAAuB,EACvB,MAAc;IAEd,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,CAAC;IAEvC,uBAAuB;IACvB,MAAM,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;IACpD,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;QACtD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,UAAU,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,oBAAoB;IACpB,MAAM,SAAS,GAAa,EAAE,CAAC;IAE/B,KAAK,MAAM,CAAC,QAAQ,EAAE,UAAU,CAAC,IAAI,UAAU,EAAE,CAAC;QAChD,yCAAyC;QACzC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAErD,KAAK,MAAM,KAAK,IAAI,UAAU,EAAE,CAAC;YAC/B,MAAM,MAAM,GAAG,MAAM,QAAQ,WAAW,KAAK,CAAC,SAAS,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC;YAC5E,MAAM,SAAS,GAAG,eAAe,CAAC,KAAK,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC3D,SAAS,CAAC,IAAI,CAAC,GAAG,MAAM,KAAK,SAAS,EAAE,CAAC,CAAC;QAC5C,CAAC;IACH,CAAC;IAED,mBAAmB;IACnB,MAAM,UAAU,GAAG,UAAU,CAAC,IAAI,CAAC;IACnC,MAAM,SAAS,GAAG,MAAM,WAAW,CAAC,cAAc,EAAE,aAAa,MAAM,CAAC,MAAM,aAAa,UAAU,QAAQ,CAAC;IAE9G,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,WAAW,GAAG,SAAS,CAAC;IAE9D,wBAAwB;IACxB,MAAM,UAAU,GAAgB,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACjD,IAAI,EAAE,CAAC,CAAC,QAAQ;QAChB,KAAK,EAAE,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,OAAO,CAAC;QAC/B,MAAM,EAAE,CAAC,CAAC,MAAM;QAChB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI;KACzC,CAAC,CAAC,CAAC;IAEJ,MAAM,IAAI,GAAkB;QAC1B,KAAK;QACL,OAAO,EAAE,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC;QAC/B,MAAM,EAAE,UAAU;QAClB,KAAK,EAAE;YACL,WAAW;YACX,gBAAgB,EAAE,eAAe;YACjC,cAAc,EAAE,MAAM,CAAC,MAAM;YAC7B,aAAa,EAAE,UAAU;YACzB,MAAM;SACP;KACF,CAAC;IAEF,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,OAAe,EAAE,QAAgB;IACxD,MAAM,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC;IACnC,OAAO,KAAK,GAAG,IAAI,GAAG,IAAI,GAAG,OAAO,GAAG,OAAO,CAAC;AACjD,CAAC;AAED;;GAEG;AACH,SAAS,WAAW,CAAC,QAAgB;IACnC,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;IAE3D,MAAM,OAAO,GAA2B;QACtC,EAAE,EAAE,YAAY;QAChB,GAAG,EAAE,KAAK;QACV,EAAE,EAAE,YAAY;QAChB,GAAG,EAAE,KAAK;QACV,EAAE,EAAE,QAAQ;QACZ,EAAE,EAAE,MAAM;QACV,EAAE,EAAE,IAAI;QACR,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,MAAM;QACZ,EAAE,EAAE,QAAQ;QACZ,EAAE,EAAE,QAAQ;QACZ,GAAG,EAAE,KAAK;QACV,CAAC,EAAE,GAAG;QACN,CAAC,EAAE,GAAG;QACN,GAAG,EAAE,KAAK;QACV,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,MAAM;QACX,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,KAAK;QACV,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,MAAM;KACZ,CAAC;IAEF,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;AAC5B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,MAAoB,EACpB,eAAuB,EACvB,MAAc;IAEd,MAAM,IAAI,GAAG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IAElE,0BAA0B;IAC1B,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAC/C,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,KAAK,CAAC,cAAc,CAAC;QAChE,OAAO,KAAK,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,SAAS;kBAC/B,CAAC,UAAU,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;kBAC7B,CAAC,OAAO,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;kBAC1B,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;kBAC5B,CAAC,KAAK,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC;IAClD,CAAC,CAAC,CAAC;IAEH,MAAM,cAAc,GAAG,4BAA4B,GAAG,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAEhF,OAAO;QACL,IAAI,EAAE,IAAI,CAAC,IAAI,GAAG,cAAc;QAChC,IAAI,EAAE,IAAI,CAAC,IAAI;KAChB,CAAC;AACJ,CAAC"}

package/dist/selector/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Main Selector Module
+ *
+ * Orchestrates the selection pipeline:
+ * 1. Search for similar chunks
+ * 2. Score and rank
+ * 3. Fit to budget
+ * 4. Format output
+ */
+import Database from 'better-sqlite3';
+import { type FormattedOutput } from './formatter.js';
+/** Selection options */
+export interface SelectOptions {
+    /** Query to find context for */
+    query: string;
+    /** Maximum tokens to include */
+    budget: number;
+    /** Filter to specific sources */
+    sources?: string[];
+    /** Show scoring explanation */
+    explain?: boolean;
+}
+/** Selection result */
+export interface SelectResult {
+    /** Formatted output */
+    output: FormattedOutput;
+    /** Whether index is empty */
+    isEmpty: boolean;
+}
+/**
+ * Select optimal context for a query
+ */
+export declare function selectContext(db: Database.Database, options: SelectOptions): Promise<SelectResult>;
+export type { FormattedOutput, SelectionData, SelectionStats, ChunkInfo } from './formatter.js';
+export type { ScoredChunk } from './search.js';
+export type { RankedChunk } from './scoring.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/selector/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/selector/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAItC,OAAO,EAAuC,KAAK,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAE3F,wBAAwB;AACxB,MAAM,WAAW,aAAa;IAC5B,gCAAgC;IAChC,KAAK,EAAE,MAAM,CAAC;IACd,gCAAgC;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,uBAAuB;AACvB,MAAM,WAAW,YAAY;IAC3B,uBAAuB;IACvB,MAAM,EAAE,eAAe,CAAC;IACxB,6BAA6B;IAC7B,OAAO,EAAE,OAAO,CAAC;CAClB;AAED;;GAEG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,YAAY,CAAC,CAwDvB;AAGD,YAAY,EAAE,eAAe,EAAE,aAAa,EAAE,cAAc,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChG,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/selector/index.js

@@ -0,0 +1,67 @@
+/**
+ * Main Selector Module
+ *
+ * Orchestrates the selection pipeline:
+ * 1. Search for similar chunks
+ * 2. Score and rank
+ * 3. Fit to budget
+ * 4. Format output
+ */
+import { searchSimilar } from './search.js';
+import { rankChunks } from './scoring.js';
+import { fitToBudget, mergeAdjacentChunks } from './budget.js';
+import { formatOutput, formatWithExplanation } from './formatter.js';
+/**
+ * Select optimal context for a query
+ */
+export async function selectContext(db, options) {
+    const startTime = Date.now();
+    // Check if index has any chunks
+    const countResult = db.prepare('SELECT COUNT(*) as count FROM chunks').get();
+    if (countResult.count === 0) {
+        return {
+            output: {
+                text: '',
+                data: {
+                    query: options.query,
+                    context: '',
+                    chunks: [],
+                    stats: {
+                        totalTokens: 0,
+                        chunksConsidered: 0,
+                        chunksIncluded: 0,
+                        filesIncluded: 0,
+                        timeMs: 0,
+                    },
+                },
+            },
+            isEmpty: true,
+        };
+    }
+    // Step 1: Search for similar chunks
+    const searchOpts = {
+        limit: 50,
+        sources: options.sources,
+    };
+    const similarChunks = await searchSimilar(db, options.query, searchOpts);
+    // Step 2: Score and rank
+    const rankedChunks = rankChunks(similarChunks, options.query);
+    // Step 3: Fit to budget
+    const budgetResult = fitToBudget(rankedChunks, options.budget);
+    // Step 4: Merge adjacent chunks for cleaner output
+    const mergedChunks = mergeAdjacentChunks(budgetResult.chunks);
+    const mergedResult = {
+        ...budgetResult,
+        chunks: mergedChunks,
+    };
+    // Step 5: Format output
+    const timeMs = Date.now() - startTime;
+    const output = options.explain
+        ? formatWithExplanation(options.query, mergedResult, similarChunks.length, timeMs)
+        : formatOutput(options.query, mergedResult, similarChunks.length, timeMs);
+    return {
+        output,
+        isEmpty: false,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/selector/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/selector/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,aAAa,EAAsB,MAAM,aAAa,CAAC;AAChE,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,qBAAqB,EAAwB,MAAM,gBAAgB,CAAC;AAsB3F;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,EAAqB,EACrB,OAAsB;IAEtB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IAE7B,gCAAgC;IAChC,MAAM,WAAW,GAAG,EAAE,CAAC,OAAO,CAAC,sCAAsC,CAAC,CAAC,GAAG,EAAuB,CAAC;IAClG,IAAI,WAAW,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QAC5B,OAAO;YACL,MAAM,EAAE;gBACN,IAAI,EAAE,EAAE;gBACR,IAAI,EAAE;oBACJ,KAAK,EAAE,OAAO,CAAC,KAAK;oBACpB,OAAO,EAAE,EAAE;oBACX,MAAM,EAAE,EAAE;oBACV,KAAK,EAAE;wBACL,WAAW,EAAE,CAAC;wBACd,gBAAgB,EAAE,CAAC;wBACnB,cAAc,EAAE,CAAC;wBACjB,aAAa,EAAE,CAAC;wBAChB,MAAM,EAAE,CAAC;qBACV;iBACF;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;IAED,oCAAoC;IACpC,MAAM,UAAU,GAAkB;QAChC,KAAK,EAAE,EAAE;QACT,OAAO,EAAE,OAAO,CAAC,OAAO;KACzB,CAAC;IACF,MAAM,aAAa,GAAG,MAAM,aAAa,CAAC,EAAE,EAAE,OAAO,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;IAEzE,yBAAyB;IACzB,MAAM,YAAY,GAAG,UAAU,CAAC,aAAa,EAAE,OAAO,CAAC,KAAK,CAAC,CAAC;IAE9D,wBAAwB;IACxB,MAAM,YAAY,GAAG,WAAW,CAAC,YAAY,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;IAE/D,mDAAmD;IACnD,MAAM,YAAY,GAAG,mBAAmB,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC;IAC9D,MAAM,YAAY,GAAG;QACnB,GAAG,YAAY;QACf,MAAM,EAAE,YAAY;KACrB,CAAC;IAEF,wBAAwB;IACxB,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,SAAS,CAAC;IACtC,MAAM,MAAM,GAAG,OAAO,CAAC,OAAO;QAC5B,CAAC,CAAC,qBAAqB,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC;QAClF,CAAC,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,EAAE,YAAY,EAAE,aAAa,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAE5E,OAAO;QACL,MAAM;QACN,OAAO,EAAE,KAAK;KACf,CAAC;AACJ,CAAC"}

package/dist/selector/scoring.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Scoring Module
+ *
+ * Calculates final scores for chunks based on multiple signals.
+ *
+ * Score = 0.6 × semantic_similarity
+ *       + 0.2 × recency_bonus
+ *       + 0.2 × path_match_bonus
+ */
+import type { ScoredChunk } from './search.js';
+/** Chunk with final score */
+export interface RankedChunk extends ScoredChunk {
+    /** Final combined score */
+    score: number;
+    /** Individual score components for --explain */
+    scoreBreakdown: {
+        similarity: number;
+        recency: number;
+        pathMatch: number;
+    };
+}
+/**
+ * Calculate scores and rank chunks
+ */
+export declare function rankChunks(chunks: ScoredChunk[], query: string): RankedChunk[];
+//# sourceMappingURL=scoring.d.ts.map

package/dist/selector/scoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.d.ts","sourceRoot":"","sources":["../../src/selector/scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,6BAA6B;AAC7B,MAAM,WAAW,WAAY,SAAQ,WAAW;IAC9C,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,gDAAgD;IAChD,cAAc,EAAE;QACd,UAAU,EAAE,MAAM,CAAC;QACnB,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;KACnB,CAAC;CACH;AASD;;GAEG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,EAAE,CAqC9E"}

package/dist/selector/scoring.js

@@ -0,0 +1,113 @@
+/**
+ * Scoring Module
+ *
+ * Calculates final scores for chunks based on multiple signals.
+ *
+ * Score = 0.6 × semantic_similarity
+ *       + 0.2 × recency_bonus
+ *       + 0.2 × path_match_bonus
+ */
+/** Scoring weights */
+const WEIGHTS = {
+    similarity: 0.6,
+    recency: 0.2,
+    pathMatch: 0.2,
+};
+/**
+ * Calculate scores and rank chunks
+ */
+export function rankChunks(chunks, query) {
+    // Extract keywords from query for path matching
+    const queryKeywords = extractKeywords(query);
+    // Find max/min for normalization (recency not used yet since we don't track it)
+    const ranked = chunks.map((chunk) => {
+        // Semantic similarity (already 0-1)
+        const similarityScore = chunk.similarity;
+        // Recency bonus (placeholder - would use indexed_at if we tracked per-chunk)
+        // For now, give all chunks equal recency
+        const recencyScore = 0.5;
+        // Path match bonus
+        const pathMatchScore = calculatePathMatch(chunk.filePath, queryKeywords);
+        // Combined score
+        const score = WEIGHTS.similarity * similarityScore +
+            WEIGHTS.recency * recencyScore +
+            WEIGHTS.pathMatch * pathMatchScore;
+        return {
+            ...chunk,
+            score,
+            scoreBreakdown: {
+                similarity: similarityScore,
+                recency: recencyScore,
+                pathMatch: pathMatchScore,
+            },
+        };
+    });
+    // Sort by final score descending
+    ranked.sort((a, b) => b.score - a.score);
+    return ranked;
+}
+/**
+ * Extract keywords from query for path matching
+ */
+function extractKeywords(query) {
+    return query
+        .toLowerCase()
+        .split(/\s+/)
+        .filter((word) => word.length > 2)
+        .filter((word) => !STOP_WORDS.has(word));
+}
+/**
+ * Calculate path match score (0-1)
+ */
+function calculatePathMatch(filePath, keywords) {
+    if (keywords.length === 0)
+        return 0;
+    const pathLower = filePath.toLowerCase();
+    let matches = 0;
+    for (const keyword of keywords) {
+        if (pathLower.includes(keyword)) {
+            matches++;
+        }
+    }
+    return matches / keywords.length;
+}
+/** Common words to ignore in path matching */
+const STOP_WORDS = new Set([
+    'the',
+    'a',
+    'an',
+    'is',
+    'are',
+    'was',
+    'were',
+    'be',
+    'been',
+    'how',
+    'what',
+    'where',
+    'when',
+    'why',
+    'who',
+    'which',
+    'does',
+    'do',
+    'did',
+    'has',
+    'have',
+    'had',
+    'this',
+    'that',
+    'these',
+    'those',
+    'and',
+    'or',
+    'but',
+    'not',
+    'with',
+    'for',
+    'from',
+    'to',
+    'in',
+    'on',
+]);
+//# sourceMappingURL=scoring.js.map

package/dist/selector/scoring.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scoring.js","sourceRoot":"","sources":["../../src/selector/scoring.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAgBH,sBAAsB;AACtB,MAAM,OAAO,GAAG;IACd,UAAU,EAAE,GAAG;IACf,OAAO,EAAE,GAAG;IACZ,SAAS,EAAE,GAAG;CACf,CAAC;AAEF;;GAEG;AACH,MAAM,UAAU,UAAU,CAAC,MAAqB,EAAE,KAAa;IAC7D,gDAAgD;IAChD,MAAM,aAAa,GAAG,eAAe,CAAC,KAAK,CAAC,CAAC;IAE7C,gFAAgF;IAChF,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QAClC,oCAAoC;QACpC,MAAM,eAAe,GAAG,KAAK,CAAC,UAAU,CAAC;QAEzC,6EAA6E;QAC7E,yCAAyC;QACzC,MAAM,YAAY,GAAG,GAAG,CAAC;QAEzB,mBAAmB;QACnB,MAAM,cAAc,GAAG,kBAAkB,CAAC,KAAK,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;QAEzE,iBAAiB;QACjB,MAAM,KAAK,GACT,OAAO,CAAC,UAAU,GAAG,eAAe;YACpC,OAAO,CAAC,OAAO,GAAG,YAAY;YAC9B,OAAO,CAAC,SAAS,GAAG,cAAc,CAAC;QAErC,OAAO;YACL,GAAG,KAAK;YACR,KAAK;YACL,cAAc,EAAE;gBACd,UAAU,EAAE,eAAe;gBAC3B,OAAO,EAAE,YAAY;gBACrB,SAAS,EAAE,cAAc;aAC1B;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,iCAAiC;IACjC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;IAEzC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK;SACT,WAAW,EAAE;SACb,KAAK,CAAC,KAAK,CAAC;SACZ,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;SACjC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC;AAC7C,CAAC;AAED;;GAEG;AACH,SAAS,kBAAkB,CAAC,QAAgB,EAAE,QAAkB;IAC9D,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,EAAE,CAAC;IACzC,IAAI,OAAO,GAAG,CAAC,CAAC;IAEhB,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,IAAI,SAAS,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,OAAO,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC;AACnC,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC;IACzB,KAAK;IACL,GAAG;IACH,IAAI;IACJ,IAAI;IACJ,KAAK;IACL,KAAK;IACL,MAAM;IACN,IAAI;IACJ,MAAM;IACN,KAAK;IACL,MAAM;IACN,OAAO;IACP,MAAM;IACN,KAAK;IACL,KAAK;IACL,OAAO;IACP,MAAM;IACN,IAAI;IACJ,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,OAAO;IACP,KAAK;IACL,IAAI;IACJ,KAAK;IACL,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,IAAI;IACJ,IAAI;IACJ,IAAI;CACL,CAAC,CAAC"}

package/dist/selector/search.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Similarity Search Module
+ *
+ * Finds chunks most similar to a query using cosine similarity.
+ */
+import Database from 'better-sqlite3';
+/** Chunk from database with similarity score */
+export interface ScoredChunk {
+    id: string;
+    sourceId: string;
+    filePath: string;
+    content: string;
+    startLine: number;
+    endLine: number;
+    tokens: number;
+    similarity: number;
+}
+/** Search options */
+export interface SearchOptions {
+    /** Maximum chunks to retrieve */
+    limit?: number;
+    /** Filter to specific sources */
+    sources?: string[];
+}
+/**
+ * Search for chunks similar to a query
+ */
+export declare function searchSimilar(db: Database.Database, query: string, options?: SearchOptions): Promise<ScoredChunk[]>;
+//# sourceMappingURL=search.d.ts.map

package/dist/selector/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/selector/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,gBAAgB,CAAC;AAItC,gDAAgD;AAChD,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAqB;AACrB,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iCAAiC;IACjC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAID;;GAEG;AACH,wBAAsB,aAAa,CACjC,EAAE,EAAE,QAAQ,CAAC,QAAQ,EACrB,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,WAAW,EAAE,CAAC,CAqDxB"}

package/dist/selector/search.js

@@ -0,0 +1,48 @@
+/**
+ * Similarity Search Module
+ *
+ * Finds chunks most similar to a query using cosine similarity.
+ */
+import { embed, cosineSimilarity } from '../indexer/embeddings.js';
+import { readEmbedding } from '../indexer/index.js';
+const DEFAULT_LIMIT = 50;
+/**
+ * Search for chunks similar to a query
+ */
+export async function searchSimilar(db, query, options = {}) {
+    const limit = options.limit || DEFAULT_LIMIT;
+    // Embed the query
+    const queryEmbedding = await embed(query);
+    // Build SQL query
+    let sql = `
+    SELECT id, source_id, file_path, content, start_line, end_line, tokens, embedding
+    FROM chunks
+  `;
+    const params = [];
+    if (options.sources && options.sources.length > 0) {
+        const placeholders = options.sources.map(() => '?').join(', ');
+        sql += ` WHERE source_id IN (${placeholders})`;
+        params.push(...options.sources);
+    }
+    // Get all chunks (we'll sort in JS for cosine similarity)
+    const rows = db.prepare(sql).all(...params);
+    // Calculate similarity for each chunk
+    const scored = rows.map((row) => {
+        const chunkEmbedding = readEmbedding(row.embedding);
+        const similarity = cosineSimilarity(queryEmbedding, chunkEmbedding);
+        return {
+            id: row.id,
+            sourceId: row.source_id,
+            filePath: row.file_path,
+            content: row.content,
+            startLine: row.start_line,
+            endLine: row.end_line,
+            tokens: row.tokens,
+            similarity,
+        };
+    });
+    // Sort by similarity descending and take top N
+    scored.sort((a, b) => b.similarity - a.similarity);
+    return scored.slice(0, limit);
+}
+//# sourceMappingURL=search.js.map

package/dist/selector/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/selector/search.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,KAAK,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAsBpD,MAAM,aAAa,GAAG,EAAE,CAAC;AAEzB;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,EAAqB,EACrB,KAAa,EACb,UAAyB,EAAE;IAE3B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,aAAa,CAAC;IAE7C,kBAAkB;IAClB,MAAM,cAAc,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,CAAC;IAE1C,kBAAkB;IAClB,IAAI,GAAG,GAAG;;;GAGT,CAAC;IAEF,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,IAAI,OAAO,CAAC,OAAO,IAAI,OAAO,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAClD,MAAM,YAAY,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC/D,GAAG,IAAI,wBAAwB,YAAY,GAAG,CAAC;QAC/C,MAAM,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,CAAC;IAED,0DAA0D;IAC1D,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,GAAG,MAAM,CASxC,CAAC;IAEH,sCAAsC;IACtC,MAAM,MAAM,GAAkB,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;QAC7C,MAAM,cAAc,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACpD,MAAM,UAAU,GAAG,gBAAgB,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAEpE,OAAO;YACL,EAAE,EAAE,GAAG,CAAC,EAAE;YACV,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,QAAQ,EAAE,GAAG,CAAC,SAAS;YACvB,OAAO,EAAE,GAAG,CAAC,OAAO;YACpB,SAAS,EAAE,GAAG,CAAC,UAAU;YACzB,OAAO,EAAE,GAAG,CAAC,QAAQ;YACrB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,UAAU;SACX,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,+CAA+C;IAC/C,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC,UAAU,CAAC,CAAC;IAEnD,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;AAChC,CAAC"}