@intentic/iq-engine 1.15.1

package/dist/indexer/languages.js

@@ -0,0 +1,87 @@
+import { Lang, parse, registerDynamicLanguage } from "@ast-grep/napi";
+import langGo from "@ast-grep/lang-go";
+import langJava from "@ast-grep/lang-java";
+import langPython from "@ast-grep/lang-python";
+import langRust from "@ast-grep/lang-rust";
+let registered = false;
+const ensureRegistered = () => {
+    if (registered) {
+        return;
+    }
+    registerDynamicLanguage({ python: langPython, go: langGo, rust: langRust, java: langJava });
+    registered = true;
+};
+export const LANGUAGES = {
+    ts: {
+        astLang: Lang.TypeScript,
+        rules: [
+            { kind: "function_declaration", symbolKind: "fn" },
+            { kind: "class_declaration", symbolKind: "class" },
+            { kind: "interface_declaration", symbolKind: "type" },
+            { kind: "type_alias_declaration", symbolKind: "type" },
+            { kind: "enum_declaration", symbolKind: "type" },
+            { kind: "method_definition", symbolKind: "method" },
+        ],
+    },
+    tsx: {
+        astLang: Lang.Tsx,
+        rules: [
+            { kind: "function_declaration", symbolKind: "fn" },
+            { kind: "class_declaration", symbolKind: "class" },
+            { kind: "interface_declaration", symbolKind: "type" },
+            { kind: "type_alias_declaration", symbolKind: "type" },
+            { kind: "method_definition", symbolKind: "method" },
+        ],
+    },
+    js: {
+        astLang: Lang.JavaScript,
+        rules: [
+            { kind: "function_declaration", symbolKind: "fn" },
+            { kind: "class_declaration", symbolKind: "class" },
+            { kind: "method_definition", symbolKind: "method" },
+        ],
+    },
+    python: {
+        astLang: "python",
+        rules: [
+            { kind: "function_definition", symbolKind: "fn" },
+            { kind: "class_definition", symbolKind: "class" },
+        ],
+    },
+    go: {
+        astLang: "go",
+        rules: [
+            { kind: "function_declaration", symbolKind: "fn" },
+            { kind: "method_declaration", symbolKind: "method" },
+            { kind: "type_spec", symbolKind: "type" },
+        ],
+    },
+    rust: {
+        astLang: "rust",
+        rules: [
+            { kind: "function_item", symbolKind: "fn" },
+            { kind: "struct_item", symbolKind: "type" },
+            { kind: "enum_item", symbolKind: "type" },
+            { kind: "trait_item", symbolKind: "type" },
+            { kind: "const_item", symbolKind: "const" },
+        ],
+    },
+    java: {
+        astLang: "java",
+        rules: [
+            { kind: "method_declaration", symbolKind: "method" },
+            { kind: "class_declaration", symbolKind: "class" },
+            { kind: "interface_declaration", symbolKind: "type" },
+            { kind: "enum_declaration", symbolKind: "type" },
+        ],
+    },
+};
+export const parseLang = (lang, content) => {
+    const config = LANGUAGES[lang];
+    if (config === undefined) {
+        return undefined;
+    }
+    ensureRegistered();
+    return parse(config.astLang, content);
+};
+//# sourceMappingURL=languages.js.map

package/dist/indexer/languages.js.map

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

package/dist/indexer/symbols.d.ts

@@ -0,0 +1,3 @@
+import type { SymbolRow } from "../types.js";
+export declare const extractSymbols: (path: string, lang: string | undefined, content: string) => SymbolRow[];
+//# sourceMappingURL=symbols.d.ts.map

package/dist/indexer/symbols.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.d.ts","sourceRoot":"","sources":["../../src/indexer/symbols.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAgG7C,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,MAAM,MAAM,GAAG,SAAS,EAAE,SAAS,MAAM,KAAG,SAAS,EAiCjG,CAAC"}

package/dist/indexer/symbols.js

@@ -0,0 +1,115 @@
+import { LANGUAGES, parseLang } from "./languages.js";
+const SIGNATURE_MAX = 160;
+const signatureOf = (node) => {
+    const first = node.text().split("\n", 1)[0].trim();
+    return first.length > SIGNATURE_MAX ? `${first.slice(0, SIGNATURE_MAX)}…` : first;
+};
+const isExported = (node, lang, name) => {
+    if (lang === "go") {
+        return /^[A-Z]/.test(name);
+    }
+    if (lang === "python") {
+        return !name.startsWith("_");
+    }
+    if (lang === "rust") {
+        return node.children().some((child) => child.kind() === "visibility_modifier");
+    }
+    for (let current = node, depth = 0; current !== null && depth < 4; current = current.parent(), depth++) {
+        if (current.kind() === "export_statement") {
+            return true;
+        }
+    }
+    return false;
+};
+const isTestPath = (path) => /(^|\/)((__tests__|tests?)\/|test_[^/]*$)|\.(test|spec)\.[^/.]+$/.test(path);
+const row = (path, lang, node, name, kind) => {
+    const range = node.range();
+    return {
+        name,
+        kind: isTestPath(path) && (kind === "fn" || kind === "const") ? "test" : kind,
+        line: range.start.line + 1,
+        endLine: range.end.line + 1,
+        signature: signatureOf(node),
+        exported: isExported(node, lang, name),
+        heuristic: false,
+    };
+};
+const declaratorRows = (path, lang, root) => {
+    const rows = [];
+    for (const declarator of root.findAll({ rule: { kind: "variable_declarator" } })) {
+        const statementParent = declarator.parent()?.parent()?.kind();
+        if (statementParent !== "program" && statementParent !== "export_statement") {
+            continue;
+        }
+        const name = declarator.field("name")?.text();
+        if (name === undefined) {
+            continue;
+        }
+        const value = declarator.field("value")?.kind();
+        const statement = statementParent === "export_statement" ? declarator.parent().parent() : declarator.parent();
+        rows.push(row(path, lang, statement, name, value === "arrow_function" || value === "function_expression" ? "fn" : "const"));
+    }
+    return rows;
+};
+const HEURISTIC_PATTERNS = [
+    { re: /^\s*(?:export\s+)?(?:default\s+)?(?:async\s+)?function\s+([A-Za-z_$][\w$]*)/, kind: "fn" },
+    { re: /^\s*(?:export\s+)?(?:abstract\s+)?class\s+([A-Za-z_$][\w$]*)/, kind: "class" },
+    { re: /^\s*(?:async\s+)?def\s+([A-Za-z_]\w*)/, kind: "fn" },
+    { re: /^\s*func\s+(?:\([^)]*\)\s*)?([A-Za-z_]\w*)/, kind: "fn" },
+];
+const heuristicSymbols = (path, content) => {
+    const rows = [];
+    content.split(/\r?\n/).forEach((text, i) => {
+        for (const { re, kind } of HEURISTIC_PATTERNS) {
+            const match = re.exec(text);
+            if (match !== null) {
+                rows.push({
+                    name: match[1],
+                    kind: isTestPath(path) && kind === "fn" ? "test" : kind,
+                    line: i + 1,
+                    endLine: i + 1,
+                    signature: text.trim().slice(0, SIGNATURE_MAX),
+                    exported: !match[1].startsWith("_"),
+                    heuristic: true,
+                });
+                return;
+            }
+        }
+    });
+    return rows;
+};
+const NON_CODE = /\.(md|mdx|rst|txt|json|jsonc|ya?ml|toml|ini|lock|csv|html|xml|svg|css|scss)$/i;
+export const extractSymbols = (path, lang, content) => {
+    if (NON_CODE.test(path)) {
+        return [];
+    }
+    const config = lang !== undefined ? LANGUAGES[lang] : undefined;
+    if (lang === undefined || config === undefined) {
+        return heuristicSymbols(path, content);
+    }
+    const root = parseLang(lang, content)?.root();
+    if (root === undefined) {
+        return heuristicSymbols(path, content);
+    }
+    const rows = [];
+    for (const rule of config.rules) {
+        for (const node of root.findAll({ rule: { kind: rule.kind } })) {
+            const name = node.field("name")?.text();
+            if (name !== undefined && name !== "") {
+                rows.push(row(path, lang, node, name, rule.symbolKind));
+            }
+        }
+    }
+    if (lang === "ts" || lang === "tsx" || lang === "js") {
+        rows.push(...declaratorRows(path, lang, root));
+    }
+    if (lang === "python") {
+        for (const item of rows) {
+            if (item.kind === "fn" && rows.some((other) => other.kind === "class" && other.line < item.line && other.endLine >= item.endLine)) {
+                rows[rows.indexOf(item)] = { ...item, kind: "method" };
+            }
+        }
+    }
+    return rows.toSorted((a, b) => a.line - b.line);
+};
+//# sourceMappingURL=symbols.js.map

package/dist/indexer/symbols.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"symbols.js","sourceRoot":"","sources":["../../src/indexer/symbols.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEtD,MAAM,aAAa,GAAG,GAAG,CAAC;AAE1B,MAAM,WAAW,GAAG,CAAC,IAAY,EAAU,EAAE;IACzC,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,EAAE,CAAC;IACpD,OAAO,KAAK,CAAC,MAAM,GAAG,aAAa,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC;AACtF,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,IAAY,EAAW,EAAE;IACrE,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QAChB,OAAO,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,qBAAqB,CAAC,CAAC;IACnF,CAAC;IACD,KAAK,IAAI,OAAO,GAAkB,IAAI,EAAE,KAAK,GAAG,CAAC,EAAE,OAAO,KAAK,IAAI,IAAI,KAAK,GAAG,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,EAAE,CAAC;QACpH,IAAI,OAAO,CAAC,IAAI,EAAE,KAAK,kBAAkB,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC;QAChB,CAAC;IACL,CAAC;IACD,OAAO,KAAK,CAAC;AACjB,CAAC,CAAC;AAEF,MAAM,UAAU,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,iEAAiE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAE3H,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,IAAY,EAAE,IAAY,EAAE,IAAuB,EAAa,EAAE;IACvG,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;IAC3B,OAAO;QACH,IAAI;QACJ,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;QAC7E,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC;QAC1B,OAAO,EAAE,KAAK,CAAC,GAAG,CAAC,IAAI,GAAG,CAAC;QAC3B,SAAS,EAAE,WAAW,CAAC,IAAI,CAAC;QAC5B,QAAQ,EAAE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC;QACtC,SAAS,EAAE,KAAK;KACnB,CAAC;AACN,CAAC,CAAC;AAGF,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,IAAY,EAAE,IAAY,EAAe,EAAE;IAC7E,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,KAAK,MAAM,UAAU,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,EAAE,CAAC,EAAE,CAAC;QAC/E,MAAM,eAAe,GAAG,UAAU,CAAC,MAAM,EAAE,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC;QAC9D,IAAI,eAAe,KAAK,SAAS,IAAI,eAAe,KAAK,kBAAkB,EAAE,CAAC;YAC1E,SAAS;QACb,CAAC;QACD,MAAM,IAAI,GAAG,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;QAC9C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;YACrB,SAAS;QACb,CAAC;QACD,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;QAEhD,MAAM,SAAS,GAAG,eAAe,KAAK,kBAAkB,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAG,CAAC,MAAM,EAAG,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAG,CAAC;QACjH,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,KAAK,gBAAgB,IAAI,KAAK,KAAK,qBAAqB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IAChI,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAEF,MAAM,kBAAkB,GAAuD;IAC3E,EAAE,EAAE,EAAE,6EAA6E,EAAE,IAAI,EAAE,IAAI,EAAE;IACjG,EAAE,EAAE,EAAE,8DAA8D,EAAE,IAAI,EAAE,OAAO,EAAE;IACrF,EAAE,EAAE,EAAE,uCAAuC,EAAE,IAAI,EAAE,IAAI,EAAE;IAC3D,EAAE,EAAE,EAAE,4CAA4C,EAAE,IAAI,EAAE,IAAI,EAAE;CACnE,CAAC;AAGF,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAE,OAAe,EAAe,EAAE;IACpE,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE;QACvC,KAAK,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,kBAAkB,EAAE,CAAC;YAC5C,MAAM,KAAK,GAAG,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC5B,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;gBACjB,IAAI,CAAC,IAAI,CAAC;oBACN,IAAI,EAAE,KAAK,CAAC,CAAC,CAAE;oBACf,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,IAAI,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI;oBACvD,IAAI,EAAE,CAAC,GAAG,CAAC;oBACX,OAAO,EAAE,CAAC,GAAG,CAAC;oBACd,SAAS,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,aAAa,CAAC;oBAC9C,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,CAAE,CAAC,UAAU,CAAC,GAAG,CAAC;oBACpC,SAAS,EAAE,IAAI;iBAClB,CAAC,CAAC;gBACH,OAAO;YACX,CAAC;QACL,CAAC;IACL,CAAC,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AAChB,CAAC,CAAC;AAGF,MAAM,QAAQ,GAAG,+EAA+E,CAAC;AAEjG,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,IAAwB,EAAE,OAAe,EAAe,EAAE;IACnG,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,CAAC;IACd,CAAC;IACD,MAAM,MAAM,GAAG,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,IAAI,IAAI,KAAK,SAAS,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;QAC7C,OAAO,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC;IAC9C,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACrB,OAAO,gBAAgB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC3C,CAAC;IACD,MAAM,IAAI,GAAgB,EAAE,CAAC;IAC7B,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QAC9B,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,CAAC;YAC7D,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC;YACxC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,EAAE,EAAE,CAAC;gBACpC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;YAC5D,CAAC;QACL,CAAC;IACL,CAAC;IACD,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,IAAI,EAAE,CAAC;QACnD,IAAI,CAAC,IAAI,CAAC,GAAG,cAAc,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpB,KAAK,MAAM,IAAI,IAAI,IAAI,EAAE,CAAC;YACtB,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,KAAK,OAAO,IAAI,KAAK,CAAC,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;gBAChI,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;YAC3D,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC;AACpD,CAAC,CAAC"}

package/dist/plan/classify.d.ts

@@ -0,0 +1,3 @@
+export type QueryKind = "path" | "identifier" | "regex" | "natural";
+export declare const classify: (query: string) => QueryKind;
+//# sourceMappingURL=classify.d.ts.map

package/dist/plan/classify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.d.ts","sourceRoot":"","sources":["../../src/plan/classify.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,YAAY,GAAG,OAAO,GAAG,SAAS,CAAC;AAepE,eAAO,MAAM,QAAQ,GAAI,OAAO,MAAM,KAAG,SAaxC,CAAC"}

package/dist/plan/classify.js

@@ -0,0 +1,24 @@
+const IDENTIFIER = /^[A-Za-z_$][\w$]*([.#][\w$]+)*$/;
+const REGEX_META = /[\\^$.|+()[\]{]/;
+const compiles = (pattern) => {
+    try {
+        return new RegExp(pattern) instanceof RegExp;
+    }
+    catch {
+        return false;
+    }
+};
+export const classify = (query) => {
+    const trimmed = query.trim();
+    if (!/\s/.test(trimmed) && (trimmed.includes("/") || /[*?]/.test(trimmed)) && !REGEX_META.test(trimmed.replace(/[*?.]/g, ""))) {
+        return "path";
+    }
+    if (IDENTIFIER.test(trimmed)) {
+        return "identifier";
+    }
+    if (!/\s/.test(trimmed) && REGEX_META.test(trimmed) && compiles(trimmed)) {
+        return "regex";
+    }
+    return "natural";
+};
+//# sourceMappingURL=classify.js.map

package/dist/plan/classify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classify.js","sourceRoot":"","sources":["../../src/plan/classify.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,GAAG,iCAAiC,CAAC;AACrD,MAAM,UAAU,GAAG,iBAAiB,CAAC;AAErC,MAAM,QAAQ,GAAG,CAAC,OAAe,EAAW,EAAE;IAC1C,IAAI,CAAC;QACD,OAAO,IAAI,MAAM,CAAC,OAAO,CAAC,YAAY,MAAM,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC,CAAC;AAIF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,KAAa,EAAa,EAAE;IACjD,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;QAC5H,OAAO,MAAM,CAAC;IAClB,CAAC;IACD,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,YAAY,CAAC;IACxB,CAAC;IACD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;QACvE,OAAO,OAAO,CAAC;IACnB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC,CAAC"}

package/dist/plan/fuse.d.ts

@@ -0,0 +1,10 @@
+import type { EngineResult, RankedGroup } from "../types.js";
+export interface FuseContext {
+    readonly queryTokens: readonly string[];
+    readonly mtimes: ReadonlyMap<string, number>;
+    readonly now: number;
+    readonly boosts: boolean;
+}
+export declare const fuse: (results: readonly EngineResult[], context: FuseContext) => RankedGroup[];
+export declare const queryTokens: (query: string) => string[];
+//# sourceMappingURL=fuse.d.ts.map

package/dist/plan/fuse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fuse.d.ts","sourceRoot":"","sources":["../../src/plan/fuse.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAOxE,MAAM,WAAW,WAAW;IAExB,QAAQ,CAAC,WAAW,EAAE,SAAS,MAAM,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7C,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IAErB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;CAC5B;AAkBD,eAAO,MAAM,IAAI,GAAI,SAAS,SAAS,YAAY,EAAE,EAAE,SAAS,WAAW,KAAG,WAAW,EAmExF,CAAC;AAEF,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,KAAG,MAAM,EAAsE,CAAC"}

package/dist/plan/fuse.js

@@ -0,0 +1,85 @@
+const RRF_K = 60;
+const DEF_BOOST = 1.5;
+const PATH_BOOST = 1.25;
+const RECENCY_HALF_LIFE_DAYS = 14;
+const TAG_ORDER = ["def", "path", "fuzzy", "rerank", "sem", "bm25", "import", "call", "type", "write", "text", "heuristic"];
+const dedupeTags = (tags) => {
+    const seen = new Map();
+    for (const tag of tags) {
+        const existing = seen.get(tag.kind);
+        if (existing === undefined || (tag.score ?? 0) > (existing.score ?? 0)) {
+            seen.set(tag.kind, tag);
+        }
+    }
+    return [...seen.values()].toSorted((a, b) => TAG_ORDER.indexOf(a.kind) - TAG_ORDER.indexOf(b.kind));
+};
+export const fuse = (results, context) => {
+    const byKey = new Map();
+    for (const result of results) {
+        result.hits.forEach((hit, rank) => {
+            const key = `${hit.path}:${hit.line}`;
+            const existing = byKey.get(key);
+            const contribution = 1 / (RRF_K + rank + 1);
+            if (existing === undefined) {
+                byKey.set(key, {
+                    path: hit.path,
+                    line: hit.line,
+                    text: hit.text,
+                    ...(hit.start !== undefined ? { start: hit.start } : {}),
+                    ...(hit.end !== undefined ? { end: hit.end } : {}),
+                    tags: [...hit.tags],
+                    score: contribution,
+                });
+                return;
+            }
+            existing.score += contribution;
+            existing.tags.push(...hit.tags);
+            if (existing.start === undefined && hit.start !== undefined) {
+                existing.text = hit.text;
+                existing.start = hit.start;
+                existing.end = hit.end ?? hit.start;
+            }
+        });
+    }
+    const hits = [];
+    for (const hit of byKey.values()) {
+        let score = hit.score;
+        if (context.boosts) {
+            if (hit.tags.some((tag) => tag.kind === "def")) {
+                score *= DEF_BOOST;
+            }
+            const pathLower = hit.path.toLowerCase();
+            if (context.queryTokens.some((token) => pathLower.includes(token))) {
+                score *= PATH_BOOST;
+            }
+            const mtime = context.mtimes.get(hit.path);
+            if (mtime !== undefined) {
+                const ageDays = Math.max(0, (context.now - mtime) / 86_400_000);
+                score *= 1 + 0.2 * 2 ** (-ageDays / RECENCY_HALF_LIFE_DAYS);
+            }
+        }
+        hits.push({ ...hit, tags: dedupeTags(hit.tags), score });
+    }
+    const byPath = new Map();
+    for (const hit of hits) {
+        const list = byPath.get(hit.path);
+        if (list === undefined) {
+            byPath.set(hit.path, [hit]);
+        }
+        else {
+            list.push(hit);
+        }
+    }
+    const groups = [];
+    for (const [path, groupHits] of byPath) {
+        const best = Math.max(...groupHits.map((hit) => hit.score));
+        groups.push({
+            path,
+            score: best * (1 + 0.05 * Math.log(groupHits.length)),
+            hits: groupHits.toSorted((a, b) => a.line - b.line),
+        });
+    }
+    return groups.toSorted((a, b) => b.score - a.score || (a.path < b.path ? -1 : 1));
+};
+export const queryTokens = (query) => [...new Set(query.toLowerCase().match(/[a-z0-9_$]{3,}/g) ?? [])];
+//# sourceMappingURL=fuse.js.map

package/dist/plan/fuse.js.map

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

package/dist/render/budget.d.ts

@@ -0,0 +1,2 @@
+export declare const estimateTokens: (text: string) => number;
+//# sourceMappingURL=budget.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"budget.d.ts","sourceRoot":"","sources":["../../src/render/budget.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,KAAG,MAAoC,CAAC"}

package/dist/render/budget.js

@@ -0,0 +1,2 @@
+export const estimateTokens = (text) => Math.ceil(text.length / 4);
+//# sourceMappingURL=budget.js.map

package/dist/render/budget.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"budget.js","sourceRoot":"","sources":["../../src/render/budget.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAU,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC"}

package/dist/render/cursor.d.ts

@@ -0,0 +1,19 @@
+import type { RankedGroup } from "../types.js";
+export interface Spool {
+    readonly generation: number;
+    readonly createdAt: number;
+    readonly echo: string;
+    readonly unit: string;
+    readonly style: "hits" | "paths" | "plain";
+    readonly showTags: boolean;
+    readonly groups: readonly RankedGroup[];
+}
+export declare const cursorId: (echo: string, scopeKey: string) => string;
+export declare const encodeCursor: (id: string, offset: number) => string;
+export declare const decodeCursor: (cursor: string) => {
+    id: string;
+    offset: number;
+} | undefined;
+export declare const writeSpool: (indexDir: string, id: string, spool: Spool) => void;
+export declare const readSpool: (indexDir: string, id: string) => Spool | undefined;
+//# sourceMappingURL=cursor.d.ts.map

package/dist/render/cursor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.d.ts","sourceRoot":"","sources":["../../src/render/cursor.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAK/C,MAAM,WAAW,KAAK;IAClB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;CAC3C;AAGD,eAAO,MAAM,QAAQ,GAAI,MAAM,MAAM,EAAE,UAAU,MAAM,KAAG,MAC+B,CAAC;AAE1F,eAAO,MAAM,YAAY,GAAI,IAAI,MAAM,EAAE,QAAQ,MAAM,KAAG,MAAuC,CAAC;AAElG,eAAO,MAAM,YAAY,GAAI,QAAQ,MAAM,KAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,SAK9E,CAAC;AAIF,eAAO,MAAM,UAAU,GAAI,UAAU,MAAM,EAAE,IAAI,MAAM,EAAE,OAAO,KAAK,KAAG,IAYvE,CAAC;AAEF,eAAO,MAAM,SAAS,GAAI,UAAU,MAAM,EAAE,IAAI,MAAM,KAAG,KAAK,GAAG,SAMhE,CAAC"}

package/dist/render/cursor.js

@@ -0,0 +1,35 @@
+import { createHash } from "node:crypto";
+import { mkdirSync, readdirSync, readFileSync, statSync, unlinkSync, writeFileSync } from "node:fs";
+import { join } from "node:path";
+const ID_LENGTH = 8;
+const SPOOL_MAX_AGE_MS = 24 * 60 * 60 * 1000;
+export const cursorId = (echo, scopeKey) => createHash("sha256").update(`${echo}\0${scopeKey}`).digest("hex").slice(0, ID_LENGTH);
+export const encodeCursor = (id, offset) => `${id}${offset.toString(36)}`;
+export const decodeCursor = (cursor) => {
+    if (cursor.length <= ID_LENGTH || !/^[0-9a-f]{8}[0-9a-z]+$/.test(cursor)) {
+        return undefined;
+    }
+    return { id: cursor.slice(0, ID_LENGTH), offset: parseInt(cursor.slice(ID_LENGTH), 36) };
+};
+const spoolDir = (indexDir) => join(indexDir, "spool");
+export const writeSpool = (indexDir, id, spool) => {
+    const dir = spoolDir(indexDir);
+    mkdirSync(dir, { recursive: true });
+    for (const name of readdirSync(dir)) {
+        const path = join(dir, name);
+        const age = Date.now() - (statSync(path, { throwIfNoEntry: false })?.mtimeMs ?? Date.now());
+        if (age > SPOOL_MAX_AGE_MS) {
+            unlinkSync(path);
+        }
+    }
+    writeFileSync(join(dir, `${id}.json`), JSON.stringify(spool));
+};
+export const readSpool = (indexDir, id) => {
+    try {
+        return JSON.parse(readFileSync(join(spoolDir(indexDir), `${id}.json`), "utf8"));
+    }
+    catch {
+        return undefined;
+    }
+};
+//# sourceMappingURL=cursor.js.map

package/dist/render/cursor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cursor.js","sourceRoot":"","sources":["../../src/render/cursor.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACpG,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,MAAM,SAAS,GAAG,CAAC,CAAC;AACpB,MAAM,gBAAgB,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,IAAI,CAAC;AAa7C,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,IAAY,EAAE,QAAgB,EAAU,EAAE,CAC/D,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,GAAG,IAAI,KAAK,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;AAE1F,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,EAAU,EAAE,MAAc,EAAU,EAAE,CAAC,GAAG,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,CAAC;AAElG,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,MAAc,EAA8C,EAAE;IACvF,IAAI,MAAM,CAAC,MAAM,IAAI,SAAS,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACvE,OAAO,SAAS,CAAC;IACrB,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;AAC7F,CAAC,CAAC;AAEF,MAAM,QAAQ,GAAG,CAAC,QAAgB,EAAU,EAAE,CAAC,IAAI,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;AAEvE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,QAAgB,EAAE,EAAU,EAAE,KAAY,EAAQ,EAAE;IAC3E,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;IAC/B,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEpC,KAAK,MAAM,IAAI,IAAI,WAAW,CAAC,GAAG,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC7B,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,cAAc,EAAE,KAAK,EAAE,CAAC,EAAE,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAC5F,IAAI,GAAG,GAAG,gBAAgB,EAAE,CAAC;YACzB,UAAU,CAAC,IAAI,CAAC,CAAC;QACrB,CAAC;IACL,CAAC;IACD,aAAa,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,QAAgB,EAAE,EAAU,EAAqB,EAAE;IACzE,IAAI,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,CAAU,CAAC;IAC7F,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,SAAS,CAAC;IACrB,CAAC;AACL,CAAC,CAAC"}

package/dist/render/text.d.ts

@@ -0,0 +1,31 @@
+import type { WorkspaceSearchFreshness } from "@intentic/sandbox-contract";
+import type { RankedGroup } from "../types.js";
+export interface RenderRequest {
+    readonly verb: string;
+    readonly echo: string;
+    readonly unit: string;
+    readonly style: "hits" | "paths" | "plain";
+    readonly showTags: boolean;
+    readonly groups: readonly RankedGroup[];
+    readonly offset: number;
+    readonly freshness: WorkspaceSearchFreshness;
+    readonly budget: number;
+    readonly limit?: number;
+    readonly filesOnly?: boolean;
+    readonly count?: boolean;
+    readonly headerNote?: string;
+    readonly hint?: string;
+    readonly related?: readonly string[];
+    readonly candidates?: readonly string[];
+    readonly cursorId: string;
+}
+export interface Rendered {
+    readonly text: string;
+    readonly shownGroups: number;
+    readonly shownHits: number;
+    readonly truncated: boolean;
+    readonly cursor?: string;
+    readonly exitCode: 0 | 1;
+}
+export declare const renderText: (request: RenderRequest) => Rendered;
+//# sourceMappingURL=text.d.ts.map

package/dist/render/text.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.d.ts","sourceRoot":"","sources":["../../src/render/text.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAsB,MAAM,4BAA4B,CAAC;AAC/F,OAAO,KAAK,EAAE,WAAW,EAAa,MAAM,aAAa,CAAC;AAI1D,MAAM,WAAW,aAAa;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAGtB,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,EAAE,SAAS,WAAW,EAAE,CAAC;IAExC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IAEvB,QAAQ,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAGrC,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAExC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,QAAQ;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;CAC5B;AA8BD,eAAO,MAAM,UAAU,GAAI,SAAS,aAAa,KAAG,QAuHnD,CAAC"}

package/dist/render/text.js

@@ -0,0 +1,134 @@
+import { estimateTokens } from "./budget.js";
+import { encodeCursor } from "./cursor.js";
+const tagText = (tags) => tags.map((tag) => (tag.score === undefined ? `[${tag.kind}]` : `[${tag.kind} ${tag.score.toFixed(2)}]`)).join(" ");
+const freshnessText = (freshness) => {
+    if (freshness.state === "building") {
+        return `index building ${Math.round((freshness.progress ?? 0) * 100)}%`;
+    }
+    if (freshness.state === "stale") {
+        return "index stale";
+    }
+    return `index fresh (${((freshness.ageMs ?? 0) / 1000).toFixed(1)}s)`;
+};
+const hitLine = (hit, showTags, plain) => {
+    const tags = showTags && hit.tags.length > 0 ? `    ${tagText(hit.tags)}` : "";
+    const context = hit.context !== undefined ? `  ⟨in ${hit.context}⟩` : "";
+    return plain ? `  ${hit.text}${tags}` : `  ${hit.line}: ${hit.text}${tags}${context}`;
+};
+const pathLine = (group, showTags) => {
+    const tags = showTags ? (group.hits[0]?.tags ?? []) : [];
+    const summary = group.hits[0] !== undefined && group.hits[0].text !== group.path ? `   ${group.hits[0].text}` : "";
+    return `  ${group.path}${summary}${tags.length > 0 ? `    ${tagText(tags)}` : ""}`;
+};
+export const renderText = (request) => {
+    const { groups, offset, unit, style } = request;
+    const totalHits = style === "paths" ? groups.length : groups.reduce((sum, group) => sum + group.hits.length, 0);
+    const totalFiles = groups.length;
+    const pending = groups.slice(offset, request.limit !== undefined ? offset + request.limit : undefined);
+    const header = (shown, note) => {
+        const scope = style === "paths" ? `${totalHits} ${unit}` : `${totalHits} ${unit} in ${totalFiles} files`;
+        const noteText = note !== undefined ? ` · ${note}` : "";
+        return `iq: ${request.echo} — ${scope} · ${freshnessText(request.freshness)}${noteText} · showing ${shown}/${totalHits}`;
+    };
+    const footer = (remainingHits, remainingFiles, cursor) => style === "paths"
+        ? `──── truncated: ${remainingHits} more ${unit} · next: iq ${request.echo} --after ${cursor} ────`
+        : `──── truncated: ${remainingHits} ${unit} in ${remainingFiles} more files · next: iq ${request.echo} --after ${cursor} ────`;
+    const worstCursor = encodeCursor(request.cursorId, offset + pending.length);
+    const relatedLines = (request.related ?? []).map((line) => `related: ${line}`);
+    const candidateLine = request.candidates !== undefined && request.candidates.length > 0 ? `candidates: ${request.candidates.join(" · ")}` : undefined;
+    let remaining = request.budget -
+        estimateTokens(header(totalHits, request.headerNote)) -
+        estimateTokens(footer(totalHits, totalFiles, worstCursor)) -
+        relatedLines.reduce((sum, line) => sum + estimateTokens(line), 0) -
+        (candidateLine !== undefined ? estimateTokens(candidateLine) : 0) -
+        (request.hint !== undefined ? estimateTokens(`hint: ${request.hint}`) : 0);
+    const groupCap = Math.max(200, Math.floor(request.budget / 6));
+    const bodyLines = [];
+    let shownGroups = 0;
+    let shownHits = 0;
+    for (const group of pending) {
+        const lines = [];
+        let groupTokens = 0;
+        if (style === "paths") {
+            const line = pathLine(group, request.showTags);
+            lines.push(line);
+            groupTokens = estimateTokens(line);
+        }
+        else if (request.filesOnly || request.count) {
+            const line = request.count ? `  ${group.path}: ${group.hits.length}` : `  ${group.path} (${group.hits.length})`;
+            lines.push(line);
+            groupTokens = estimateTokens(line);
+        }
+        else {
+            const head = `════ ${group.path} (${group.hits.length}) ════`;
+            lines.push(head);
+            groupTokens = estimateTokens(head);
+            for (let i = 0; i < group.hits.length; i++) {
+                const hit = group.hits[i];
+                const line = hitLine(hit, request.showTags, style === "plain");
+                const lineTokens = estimateTokens(line);
+                const elided = group.hits.length - i;
+                if (groupTokens + lineTokens > groupCap && i > 0) {
+                    const elision = `     … ${elided} more — iq context ${group.path}:${hit.line}`;
+                    lines.push(elision);
+                    groupTokens += estimateTokens(elision);
+                    break;
+                }
+                lines.push(line);
+                groupTokens += lineTokens;
+            }
+        }
+        if (groupTokens > remaining && shownGroups > 0) {
+            break;
+        }
+        if (groupTokens > remaining) {
+            const trimmed = [];
+            let used = 0;
+            for (const line of lines) {
+                const lineTokens = estimateTokens(line);
+                if (used + lineTokens > remaining) {
+                    break;
+                }
+                trimmed.push(line);
+                used += lineTokens;
+            }
+            if (trimmed.length === 0) {
+                break;
+            }
+            bodyLines.push(...trimmed);
+            remaining -= used;
+            shownGroups++;
+            shownHits += style === "paths" ? 1 : Math.max(0, trimmed.length - 1);
+            break;
+        }
+        bodyLines.push(...lines);
+        remaining -= groupTokens;
+        shownGroups++;
+        shownHits += style === "paths" ? 1 : Math.min(group.hits.length, lines.length - 1);
+    }
+    const truncated = offset + shownGroups < groups.length;
+    const cursor = truncated ? encodeCursor(request.cursorId, offset + shownGroups) : undefined;
+    const shownTotal = style === "paths" ? shownGroups : shownHits;
+    const parts = [header(shownTotal, request.headerNote), ...bodyLines];
+    if (truncated && cursor !== undefined) {
+        const remainingFiles = groups.length - offset - shownGroups;
+        const remainingHits = style === "paths" ? remainingFiles : groups.slice(offset + shownGroups).reduce((sum, group) => sum + group.hits.length, 0);
+        parts.push(footer(remainingHits, remainingFiles, cursor));
+    }
+    parts.push(...relatedLines);
+    if (candidateLine !== undefined) {
+        parts.push(candidateLine);
+    }
+    if (request.hint !== undefined) {
+        parts.push(`hint: ${request.hint}`);
+    }
+    return {
+        text: `${parts.join("\n")}\n`,
+        shownGroups,
+        shownHits: shownTotal,
+        truncated,
+        ...(cursor !== undefined ? { cursor } : {}),
+        exitCode: totalHits > 0 ? 0 : 1,
+    };
+};
+//# sourceMappingURL=text.js.map