@lzehrung/codegraph 2.1.0

package/dist/agent/orient.js

@@ -0,0 +1,307 @@
+import path from "node:path";
+import { findDuplicates } from "../duplicates.js";
+import { findDetailedCycles } from "../graphs/cycles.js";
+import { getHotspots } from "../graphs/hotspots.js";
+import { getUnresolvedImports } from "../graphs/unresolved.js";
+import { isGitRepo } from "../util/git.js";
+import { isPathUnderIncludeRoots, normalizeIncludeRootsRelative } from "../util/includeRoots.js";
+import { normalizePath } from "../util/paths.js";
+import { createAgentSession } from "./session.js";
+import { quoteShellArg } from "./shell.js";
+import { formatAgentFollowUpAsCli, toolFollowUp } from "./followUps.js";
+const ORIENT_BUDGETS = {
+    small: { treeDepth: 2, maxTreeEntries: 25, maxFocusTargets: 5, maxHotspots: 5, includeHealth: false },
+    medium: { treeDepth: 3, maxTreeEntries: 80, maxFocusTargets: 10, maxHotspots: 10, includeHealth: true },
+    large: { treeDepth: 4, maxTreeEntries: 160, maxFocusTargets: 15, maxHotspots: 15, includeHealth: true },
+};
+export async function orientCodegraph(request) {
+    const root = path.resolve(request.root);
+    const session = createAgentSession({
+        root,
+        ...(request.buildOptions ? { buildOptions: request.buildOptions } : {}),
+        freshness: { policy: "manual" },
+    });
+    return await orientCodegraphWithSession(session, { ...request, root });
+}
+export async function orientCodegraphWithSession(session, request) {
+    const budget = request.budget ?? "small";
+    const limits = ORIENT_BUDGETS[budget];
+    const snapshot = await session.loadProject({ symbolGraph: "skip" });
+    const root = snapshot.root;
+    const includeRoots = normalizeIncludeRootsRelative(root, request.includeRoots ?? []);
+    const projectFiles = snapshot.files.map((file) => normalizeRelativePath(root, file));
+    const scopedFiles = projectFiles.filter((file) => isPathUnderIncludeRoots(file, includeRoots));
+    const scopedFileSet = new Set(scopedFiles);
+    const scopedAbsoluteFiles = snapshot.files.filter((file) => scopedFileSet.has(normalizeRelativePath(root, file)));
+    const scopedFileGraph = buildScopedGraph(snapshot.fileGraph, root, scopedFileSet);
+    const tree = buildTree(scopedFiles, limits.treeDepth);
+    const boundedTree = tree.slice(0, limits.maxTreeEntries);
+    const hotspots = getHotspots(scopedFileGraph);
+    const scopedHotspots = hotspots
+        .map((hotspot) => ({ ...hotspot, file: normalizeRelativePath(root, hotspot.file) }))
+        .filter((hotspot) => scopedFileSet.has(hotspot.file) && hotspot.score);
+    const boundedHotspots = scopedHotspots.slice(0, limits.maxHotspots);
+    const modules = boundedHotspots.map((hotspot) => ({
+        file: hotspot.file,
+        fanIn: hotspot.fanIn,
+        fanOut: hotspot.fanOut,
+        score: hotspot.score,
+    }));
+    const reviewFocusSlots = request.review ? 1 : 0;
+    const maxFileFocusTargets = Math.max(0, limits.maxFocusTargets - reviewFocusSlots);
+    const packets = buildFilePackets(scopedFiles, modules.map((module) => module.file), maxFileFocusTargets);
+    const focus = buildFocusTargets(modules, packets, request.review);
+    const healthMode = request.health ?? (limits.includeHealth ? "summary" : "skip");
+    const [health, hasGitRepo] = await Promise.all([
+        buildHealth(root, snapshot.index, scopedAbsoluteFiles, scopedFileGraph, healthMode),
+        isGitRepo(root),
+    ]);
+    const recommendedNext = buildRecommendedNext(includeRoots, focus, hasGitRepo);
+    const healthSummary = formatHealthSummary(health);
+    return {
+        schemaVersion: 2,
+        root,
+        budget,
+        summary: [
+            `${scopedFiles.length} file(s) in scope.`,
+            `${modules.length} graph-central module(s) ranked for first follow-up.`,
+            healthSummary,
+        ],
+        focus,
+        tree: boundedTree,
+        health: {
+            cycles: health.cycles,
+            unresolved: health.unresolved,
+            duplicateGroups: health.duplicateGroups,
+        },
+        recommendedNext,
+        omittedCounts: {
+            treeEntries: Math.max(0, tree.length - boundedTree.length),
+            focusTargets: Math.max(0, scopedFiles.length - packets.length),
+            healthAnalyses: health.omittedAnalyses,
+        },
+    };
+}
+async function buildHealth(root, index, files, graph, healthMode) {
+    if (healthMode === "skip") {
+        return {
+            cycles: null,
+            unresolved: null,
+            duplicateGroups: null,
+            omittedAnalyses: 3,
+        };
+    }
+    const cycles = findDetailedCycles(graph);
+    const unresolved = getUnresolvedImports(graph, { projectRoot: root });
+    if (healthMode === "summary") {
+        return {
+            cycles: cycles.length,
+            unresolved: unresolved.length,
+            duplicateGroups: null,
+            omittedAnalyses: 1,
+        };
+    }
+    const duplicateResult = await findDuplicates(index, {
+        projectRoot: root,
+        files,
+        limit: 0,
+        minConfidence: "high",
+    });
+    return {
+        cycles: cycles.length,
+        unresolved: unresolved.length,
+        duplicateGroups: duplicateResult.groups.length + duplicateResult.omittedCounts.groups,
+        omittedAnalyses: 0,
+    };
+}
+function formatHealthSummary(health) {
+    if (health.cycles === null || health.unresolved === null) {
+        return "Health analysis skipped for small budget.";
+    }
+    if (health.duplicateGroups === null) {
+        return `${health.cycles} cycle(s), ${health.unresolved} unresolved import group(s); duplicate health skipped.`;
+    }
+    return `${health.cycles} cycle(s), ${health.unresolved} unresolved import group(s), ${health.duplicateGroups} duplicate group(s).`;
+}
+function buildReviewFocus(base, head) {
+    return {
+        kind: "review",
+        label: `${base}..${head}`,
+        why: "review range requested by the caller",
+        followUps: [toolFollowUp("review", { base, head }), toolFollowUp("impact", { base, head })],
+    };
+}
+function normalizeRelativePath(root, file) {
+    const relative = path.isAbsolute(file) ? path.relative(root, file) : file;
+    return normalizePath(relative);
+}
+function buildScopedGraph(graph, root, scopedFiles) {
+    const nodes = new Set();
+    for (const node of graph.nodes) {
+        if (scopedFiles.has(normalizeRelativePath(root, node))) {
+            nodes.add(node);
+        }
+    }
+    const edges = graph.edges.filter((edge) => {
+        if (!nodes.has(edge.from))
+            return false;
+        return edge.to.type !== "file" || nodes.has(edge.to.path);
+    });
+    return { nodes, edges };
+}
+function buildTree(files, maxDepth) {
+    const entries = new Map();
+    for (const file of files) {
+        const parts = file.split("/").filter(Boolean);
+        const fileDepth = parts.length;
+        for (let index = 1; index < fileDepth; index++) {
+            if (index > maxDepth)
+                break;
+            const directory = parts.slice(0, index).join("/");
+            entries.set(directory, { path: directory, kind: "directory", depth: index });
+        }
+        if (fileDepth <= maxDepth) {
+            entries.set(file, { path: file, kind: "file", depth: fileDepth });
+        }
+    }
+    return Array.from(entries.values()).sort(compareTreeEntries);
+}
+function compareTreeEntries(left, right) {
+    const leftParent = parentPath(left.path);
+    const rightParent = parentPath(right.path);
+    if (leftParent !== rightParent) {
+        if (leftParent < rightParent)
+            return -1;
+        return 1;
+    }
+    if (left.kind !== right.kind) {
+        return left.kind === "directory" ? -1 : 1;
+    }
+    if (left.path < right.path)
+        return -1;
+    if (left.path > right.path)
+        return 1;
+    return 0;
+}
+function parentPath(file) {
+    const separator = file.lastIndexOf("/");
+    if (separator < 0)
+        return "";
+    return file.slice(0, separator);
+}
+function buildFilePackets(scopedFiles, priorityFiles, maxPackets) {
+    if (!maxPackets)
+        return [];
+    const scopedFileSet = new Set(scopedFiles);
+    const seen = new Set();
+    const orderedFiles = [];
+    for (const file of priorityFiles) {
+        if (!scopedFileSet.has(file) || seen.has(file))
+            continue;
+        seen.add(file);
+        orderedFiles.push(file);
+    }
+    for (const file of scopedFiles) {
+        if (seen.has(file))
+            continue;
+        seen.add(file);
+        orderedFiles.push(file);
+    }
+    return orderedFiles.slice(0, maxPackets).map((file, index) => ({
+        id: index + 1,
+        kind: "file",
+        file,
+    }));
+}
+function buildFocusTargets(modules, packets, review) {
+    const focus = [];
+    if (review) {
+        focus.push(buildReviewFocus(review.base, review.head));
+    }
+    const modulesByFile = new Map(modules.map((module) => [module.file, module]));
+    for (const packet of packets) {
+        const module = modulesByFile.get(packet.file);
+        if (module) {
+            focus.push({
+                id: packet.id,
+                kind: "hotspot",
+                file: module.file,
+                why: `graph-central module: fan-in ${module.fanIn}, fan-out ${module.fanOut}, score ${module.score}`,
+                followUps: [
+                    toolFollowUp("packet_get", { target: packet.file }),
+                    toolFollowUp("packet_get", { target: module.file }),
+                ],
+            });
+            continue;
+        }
+        focus.push({
+            id: packet.id,
+            kind: "file",
+            file: packet.file,
+            why: "bounded file packet candidate inside the requested scope",
+            followUps: [toolFollowUp("packet_get", { target: packet.file })],
+        });
+    }
+    return focus;
+}
+function buildRecommendedNext(includeRoots, focus, hasGitRepo) {
+    const commands = [];
+    const firstFocus = focus[0];
+    if (firstFocus) {
+        for (const followUp of firstFocus.followUps) {
+            commands.push({
+                label: labelForFollowUp(firstFocus, followUp),
+                command: formatAgentFollowUpAsCli(followUp),
+            });
+        }
+    }
+    const firstRoot = includeRoots[0] ?? ".";
+    commands.push({
+        label: "Rank scoped hotspots",
+        command: `codegraph hotspots ${quoteShellArg(firstRoot)} --limit 20`,
+    });
+    if (hasGitRepo) {
+        commands.push({
+            label: "Map current worktree impact",
+            command: "codegraph impact --base HEAD --head WORKTREE",
+        });
+        commands.push({
+            label: "Review current worktree",
+            command: "codegraph review --base HEAD --head WORKTREE",
+        });
+    }
+    commands.push({
+        label: "Search for a task-specific anchor",
+        command: "codegraph search <query> --json",
+    });
+    return commands;
+}
+function formatPacketCommand(file) {
+    return `codegraph packet get ${formatFileTargetCommandArg(file)}`;
+}
+function formatFileTargetCommandArg(file) {
+    const target = fileNeedsRelativePrefix(file) ? `./${file}` : file;
+    return quoteShellArg(target);
+}
+function fileNeedsRelativePrefix(file) {
+    return (file.startsWith("-") ||
+        file.startsWith("file:") ||
+        file.startsWith("symbol:") ||
+        file.startsWith("chunk:") ||
+        file.startsWith("sql:") ||
+        file.startsWith("graph:") ||
+        file.startsWith("review:"));
+}
+function labelForFollowUp(focus, followUp) {
+    const label = focus.file ?? focus.label ?? "focus target";
+    if (followUp.tool === "packet_get")
+        return `Get packet for ${label}`;
+    if (followUp.tool === "get_symbol")
+        return `Explain ${label}`;
+    if (followUp.tool === "review")
+        return `Review ${label}`;
+    if (followUp.tool === "impact")
+        return `Map impact for ${label}`;
+    return label;
+}
+//# sourceMappingURL=orient.js.map

package/dist/agent/orient.js.map

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

package/dist/agent/packet.d.ts

@@ -0,0 +1,28 @@
+import { type ReviewReport } from "../review.js";
+import type { BuildOptions } from "../indexer/types.js";
+import { type AgentExplanation } from "./explain.js";
+import { type AgentFollowUp } from "./followUps.js";
+import { type AgentSession } from "./session.js";
+export type AgentPacketKind = "file" | "symbol" | "chunk" | "sql_object" | "graph" | "review";
+export type AgentPacketRequest = {
+    root: string;
+    target: string;
+    buildOptions?: BuildOptions;
+    maxSymbols?: number;
+    maxSnippets?: number;
+    maxDuplicates?: number;
+};
+export type AgentPacketPayload = AgentExplanation | ReviewReport;
+export type AgentPacketResponse = {
+    schemaVersion: 2;
+    root: string;
+    target: string;
+    kind: AgentPacketKind;
+    packet: AgentPacketPayload;
+    limits: Record<string, number>;
+    omittedCounts: Record<string, number>;
+    followUps: AgentFollowUp[];
+};
+export declare function getCodegraphPacket(request: AgentPacketRequest): Promise<AgentPacketResponse>;
+export declare function getCodegraphPacketWithSession(session: AgentSession, request: AgentPacketRequest): Promise<AgentPacketResponse>;
+//# sourceMappingURL=packet.d.ts.map

package/dist/agent/packet.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"packet.d.ts","sourceRoot":"","sources":["../../src/agent/packet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAqB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAA8D,KAAK,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACjH,OAAO,EAAE,KAAK,aAAa,EAAgB,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAsB,KAAK,YAAY,EAAE,MAAM,cAAc,CAAC;AAErE,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE9F,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,YAAY,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG,gBAAgB,GAAG,YAAY,CAAC;AAEjE,MAAM,MAAM,mBAAmB,GAAG;IAChC,aAAa,EAAE,CAAC,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,eAAe,CAAC;IACtB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACtC,SAAS,EAAE,aAAa,EAAE,CAAC;CAC5B,CAAC;AAEF,wBAAsB,kBAAkB,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAWlG;AAED,wBAAsB,6BAA6B,CACjD,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,mBAAmB,CAAC,CAO9B"}

package/dist/agent/packet.js

@@ -0,0 +1,138 @@
+import { buildReviewReport } from "../review.js";
+import { explainCodegraphTargetWithSession } from "./explain.js";
+import { toolFollowUp } from "./followUps.js";
+import { createAgentSession } from "./session.js";
+export async function getCodegraphPacket(request) {
+    const kind = inferPacketKind(request.target);
+    if (kind === "review") {
+        return await buildReviewPacket(request);
+    }
+    const session = createAgentSession({
+        root: request.root,
+        ...(request.buildOptions ? { buildOptions: request.buildOptions } : {}),
+    });
+    return await buildExplainPacket(session, request, kind);
+}
+export async function getCodegraphPacketWithSession(session, request) {
+    const kind = inferPacketKind(request.target);
+    if (kind === "review") {
+        return await buildReviewPacket(request);
+    }
+    return await buildExplainPacket(session, request, kind);
+}
+async function buildExplainPacket(session, request, kind) {
+    const explainRequest = {
+        root: request.root,
+        target: request.target,
+    };
+    if (request.maxSymbols !== undefined) {
+        explainRequest.maxSymbols = request.maxSymbols;
+    }
+    if (request.maxSnippets !== undefined) {
+        explainRequest.maxSnippets = request.maxSnippets;
+    }
+    if (request.maxDuplicates !== undefined) {
+        explainRequest.maxDuplicates = request.maxDuplicates;
+    }
+    const explanation = await explainCodegraphTargetWithSession(session, explainRequest);
+    if (explanation.target.kind === "not_found") {
+        throw new Error(`Packet target did not resolve: ${request.target}`);
+    }
+    return {
+        schemaVersion: 2,
+        root: explanation.root,
+        target: request.target,
+        kind: kind ?? packetKindForResolvedTarget(explanation.target.kind),
+        packet: explanation,
+        limits: explanation.limits,
+        omittedCounts: explanation.omittedCounts,
+        followUps: explanation.followUps,
+    };
+}
+function inferPacketKind(target) {
+    return kindForHandle(target);
+}
+function packetKindForResolvedTarget(kind) {
+    if (kind === "sql_object")
+        return "sql_object";
+    if (kind === "symbol")
+        return "symbol";
+    return "file";
+}
+async function buildReviewPacket(request) {
+    const range = parseReviewHandle(request.target);
+    if (!range) {
+        throw new Error("Invalid review packet target. Expected review:base=<encoded-ref>;head=<encoded-ref>.");
+    }
+    const report = await buildReviewReport(request.root, {
+        gitBase: range.base,
+        gitHead: range.head,
+        reviewDepth: "minimal",
+    });
+    return {
+        schemaVersion: 2,
+        root: request.root,
+        target: request.target,
+        kind: "review",
+        packet: report,
+        limits: {
+            changedFiles: report.changedFiles.length,
+            candidateTests: report.candidateTests.length,
+            reviewTasks: report.reviewTasks.length,
+        },
+        omittedCounts: {
+            changedFiles: 0,
+            candidateTests: 0,
+            reviewTasks: 0,
+        },
+        followUps: [
+            toolFollowUp("impact", { provider: "git", base: range.base, head: range.head }),
+            toolFollowUp("review", { base: range.base, head: range.head }),
+        ],
+    };
+}
+function parseReviewHandle(target) {
+    if (!target.startsWith("review:"))
+        return null;
+    const fields = new Map();
+    for (const part of target.slice("review:".length).split(";")) {
+        const separator = part.indexOf("=");
+        if (separator < 0)
+            continue;
+        const key = part.slice(0, separator);
+        const value = part.slice(separator + 1);
+        const decodedValue = decodeReviewHandleField(value);
+        if (decodedValue === null)
+            return null;
+        fields.set(key, decodedValue);
+    }
+    const base = fields.get("base");
+    const head = fields.get("head");
+    if (!base || !head)
+        return null;
+    return { base, head };
+}
+function decodeReviewHandleField(value) {
+    try {
+        return decodeURIComponent(value);
+    }
+    catch {
+        return null;
+    }
+}
+function kindForHandle(handle) {
+    if (handle.startsWith("file:"))
+        return "file";
+    if (handle.startsWith("symbol:"))
+        return "symbol";
+    if (handle.startsWith("chunk:"))
+        return "chunk";
+    if (handle.startsWith("sql:"))
+        return "sql_object";
+    if (handle.startsWith("graph:"))
+        return "graph";
+    if (handle.startsWith("review:"))
+        return "review";
+    return null;
+}
+//# sourceMappingURL=packet.js.map

package/dist/agent/packet.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"packet.js","sourceRoot":"","sources":["../../src/agent/packet.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAqB,MAAM,cAAc,CAAC;AAEpE,OAAO,EAAE,iCAAiC,EAAkD,MAAM,cAAc,CAAC;AACjH,OAAO,EAAsB,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAqB,MAAM,cAAc,CAAC;AA0BrE,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,OAA2B;IAClE,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,MAAM,OAAO,GAAG,kBAAkB,CAAC;QACjC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,GAAG,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACxE,CAAC,CAAC;IACH,OAAO,MAAM,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,OAAqB,EACrB,OAA2B;IAE3B,MAAM,IAAI,GAAG,eAAe,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAC7C,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QACtB,OAAO,MAAM,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,CAAC;IAED,OAAO,MAAM,kBAAkB,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;AAC1D,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,OAAqB,EACrB,OAA2B,EAC3B,IAA4B;IAE5B,MAAM,cAAc,GAAuB;QACzC,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;KACvB,CAAC;IACF,IAAI,OAAO,CAAC,UAAU,KAAK,SAAS,EAAE,CAAC;QACrC,cAAc,CAAC,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IACjD,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;QACtC,cAAc,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,CAAC;IACnD,CAAC;IACD,IAAI,OAAO,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;QACxC,cAAc,CAAC,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;IACvD,CAAC;IAED,MAAM,WAAW,GAAG,MAAM,iCAAiC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACrF,IAAI,WAAW,CAAC,MAAM,CAAC,IAAI,KAAK,WAAW,EAAE,CAAC;QAC5C,MAAM,IAAI,KAAK,CAAC,kCAAkC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,IAAI,EAAE,WAAW,CAAC,IAAI;QACtB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,IAAI,IAAI,2BAA2B,CAAC,WAAW,CAAC,MAAM,CAAC,IAAI,CAAC;QAClE,MAAM,EAAE,WAAW;QACnB,MAAM,EAAE,WAAW,CAAC,MAAM;QAC1B,aAAa,EAAE,WAAW,CAAC,aAAa;QACxC,SAAS,EAAE,WAAW,CAAC,SAAS;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,MAAc;IACrC,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC;AAED,SAAS,2BAA2B,CAAC,IAAwC;IAC3E,IAAI,IAAI,KAAK,YAAY;QAAE,OAAO,YAAY,CAAC;IAC/C,IAAI,IAAI,KAAK,QAAQ;QAAE,OAAO,QAAQ,CAAC;IACvC,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,OAA2B;IAC1D,MAAM,KAAK,GAAG,iBAAiB,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IAChD,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,sFAAsF,CAAC,CAAC;IAC1G,CAAC;IACD,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,IAAI,EAAE;QACnD,OAAO,EAAE,KAAK,CAAC,IAAI;QACnB,OAAO,EAAE,KAAK,CAAC,IAAI;QACnB,WAAW,EAAE,SAAS;KACvB,CAAC,CAAC;IACH,OAAO;QACL,aAAa,EAAE,CAAC;QAChB,IAAI,EAAE,OAAO,CAAC,IAAI;QAClB,MAAM,EAAE,OAAO,CAAC,MAAM;QACtB,IAAI,EAAE,QAAQ;QACd,MAAM,EAAE,MAAM;QACd,MAAM,EAAE;YACN,YAAY,EAAE,MAAM,CAAC,YAAY,CAAC,MAAM;YACxC,cAAc,EAAE,MAAM,CAAC,cAAc,CAAC,MAAM;YAC5C,WAAW,EAAE,MAAM,CAAC,WAAW,CAAC,MAAM;SACvC;QACD,aAAa,EAAE;YACb,YAAY,EAAE,CAAC;YACf,cAAc,EAAE,CAAC;YACjB,WAAW,EAAE,CAAC;SACf;QACD,SAAS,EAAE;YACT,YAAY,CAAC,QAAQ,EAAE,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;YAC/E,YAAY,CAAC,QAAQ,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC;SAC/D;KACF,CAAC;AACJ,CAAC;AAED,SAAS,iBAAiB,CAAC,MAAc;IACvC,IAAI,CAAC,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,IAAI,CAAC;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QAC7D,MAAM,SAAS,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACpC,IAAI,SAAS,GAAG,CAAC;YAAE,SAAS;QAC5B,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC;QACxC,MAAM,YAAY,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;QACpD,IAAI,YAAY,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,YAAY,CAAC,CAAC;IAChC,CAAC;IACD,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,MAAM,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI;QAAE,OAAO,IAAI,CAAC;IAChC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAa;IAC5C,IAAI,CAAC;QACH,OAAO,kBAAkB,CAAC,KAAK,CAAC,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,MAAc;IACnC,IAAI,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QAAE,OAAO,YAAY,CAAC;IACnD,IAAI,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC;QAAE,OAAO,OAAO,CAAC;IAChD,IAAI,MAAM,CAAC,UAAU,CAAC,SAAS,CAAC;QAAE,OAAO,QAAQ,CAAC;IAClD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/agent/query-index/candidates.d.ts

@@ -0,0 +1,4 @@
+import { type QueryIndexStore, type StoredQueryIndexChunk } from "./store.js";
+export declare const QUERY_INDEX_CANDIDATE_VERSION = 5;
+export declare function findQueryIndexChunkCandidates(store: QueryIndexStore, rankTerms: readonly string[]): StoredQueryIndexChunk[];
+//# sourceMappingURL=candidates.d.ts.map

package/dist/agent/query-index/candidates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"candidates.d.ts","sourceRoot":"","sources":["../../../src/agent/query-index/candidates.ts"],"names":[],"mappings":"AAAA,OAAO,EAIL,KAAK,eAAe,EACpB,KAAK,qBAAqB,EAC3B,MAAM,YAAY,CAAC;AAEpB,eAAO,MAAM,6BAA6B,IAAI,CAAC;AAoE/C,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,eAAe,EACtB,SAAS,EAAE,SAAS,MAAM,EAAE,GAC3B,qBAAqB,EAAE,CA4BzB"}

package/dist/agent/query-index/candidates.js

@@ -0,0 +1,89 @@
+import { codePointLength, escapeFtsTrigramTerm, QUERY_INDEX_CANDIDATE_ROW_LIMIT, } from "./store.js";
+export const QUERY_INDEX_CANDIDATE_VERSION = 5;
+function scoreCandidateChunk(normalizedText, rankTerms) {
+    if (!normalizedText.length || !rankTerms.length) {
+        return { score: 0, exactPhrase: false, proximity: false, matchedTerms: 0 };
+    }
+    const words = new Set(normalizedText.split(/\s+/).filter(Boolean));
+    const compact = normalizedText.replace(/\s+/g, "");
+    let score = 0;
+    let matchedTerms = 0;
+    for (const term of rankTerms) {
+        if (words.has(term)) {
+            score += 10;
+            matchedTerms += 1;
+        }
+        else if (compact.includes(term)) {
+            score += 7;
+            matchedTerms += 1;
+        }
+        else if (normalizedText.includes(term)) {
+            score += 4;
+            matchedTerms += 1;
+        }
+    }
+    let exactPhrase = false;
+    let proximity = false;
+    if (matchedTerms === rankTerms.length && rankTerms.length > 1) {
+        score += 12;
+        const normalizedPhrase = rankTerms.join(" ");
+        if (normalizedText.includes(normalizedPhrase)) {
+            score += 30;
+            exactPhrase = true;
+        }
+        else {
+            let fromIndex = 0;
+            proximity = true;
+            for (const term of rankTerms) {
+                const termIndex = normalizedText.indexOf(term, fromIndex);
+                if (termIndex < 0) {
+                    proximity = false;
+                    break;
+                }
+                fromIndex = termIndex + term.length;
+            }
+            if (proximity)
+                score += 10;
+        }
+    }
+    return { score, exactPhrase, proximity, matchedTerms };
+}
+function compareCandidateChunks(left, right) {
+    return (right.score.score - left.score.score ||
+        Number(right.score.exactPhrase) - Number(left.score.exactPhrase) ||
+        Number(right.score.proximity) - Number(left.score.proximity) ||
+        right.score.matchedTerms - left.score.matchedTerms ||
+        left.chunk.path.localeCompare(right.chunk.path) ||
+        left.chunk.ordinal - right.chunk.ordinal);
+}
+export function findQueryIndexChunkCandidates(store, rankTerms) {
+    const directCandidates = new Map();
+    const terms = rankTerms.filter((term) => term.length);
+    const eligiblePaths = store.eligibleFilePaths(terms);
+    const eligiblePathSet = new Set(eligiblePaths);
+    for (const term of terms) {
+        let chunks;
+        if (codePointLength(term) >= 3) {
+            chunks = store.ftsChunkCandidates(escapeFtsTrigramTerm(term));
+        }
+        else {
+            chunks = store.substringChunkCandidates(term, eligiblePaths);
+        }
+        for (const chunk of chunks) {
+            if (eligiblePathSet.has(chunk.path))
+                directCandidates.set(`${chunk.path}\0${chunk.ordinal}`, chunk);
+        }
+    }
+    for (const term of terms) {
+        for (const chunk of store.compactChunkCandidates(term, eligiblePaths)) {
+            directCandidates.set(`${chunk.path}\0${chunk.ordinal}`, chunk);
+        }
+    }
+    return [...directCandidates.values()]
+        .map((chunk) => ({ chunk, score: scoreCandidateChunk(chunk.normalizedText, terms) }))
+        .filter((candidate) => candidate.score.score > 0)
+        .sort(compareCandidateChunks)
+        .slice(0, QUERY_INDEX_CANDIDATE_ROW_LIMIT)
+        .map((candidate) => candidate.chunk);
+}
+//# sourceMappingURL=candidates.js.map

package/dist/agent/query-index/candidates.js.map

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

package/dist/agent/query-index/content.d.ts

@@ -0,0 +1,36 @@
+export declare const MAX_QUERY_INDEX_TEXT_BYTES = 300000;
+export declare const QUERY_INDEX_NORMALIZER_VERSION = 1;
+export declare const QUERY_INDEX_CHUNKER_VERSION = 2;
+export type QueryTextChunk = {
+    ordinal: number;
+    kind: string;
+    name?: string;
+    text: string;
+    normalizedText: string;
+    startLine: number;
+    endLine: number;
+};
+export type PreparedQueryTextChunk = Omit<QueryTextChunk, "text"> & {
+    text: Uint8Array;
+};
+export type QueryIndexFileInput = {
+    absolutePath: string;
+    path: string;
+    sourceIdentity: string;
+};
+export type PreparedQueryIndexFile = {
+    path: string;
+    sourceIdentity: string;
+    surface: "code" | "docs" | "config";
+    language?: string;
+    byteLength: number;
+    lineCount: number;
+    normalizedText: Uint8Array;
+    chunks: PreparedQueryTextChunk[];
+    sourceRead: boolean;
+};
+export declare function normalizeQuerySearchText(input: string): string;
+export declare function detectQueryIndexSurface(relativePath: string): "code" | "docs" | "config";
+export declare function buildQueryTextChunks(file: string, text: string): QueryTextChunk[];
+export declare function prepareQueryIndexFile(input: QueryIndexFileInput): Promise<PreparedQueryIndexFile | null>;
+//# sourceMappingURL=content.d.ts.map

package/dist/agent/query-index/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/agent/query-index/content.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,0BAA0B,SAAU,CAAC;AAClD,eAAO,MAAM,8BAA8B,IAAI,CAAC;AAChD,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAY7C,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG,IAAI,CAAC,cAAc,EAAE,MAAM,CAAC,GAAG;IAClE,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAAG;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACpC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,UAAU,CAAC;IAC3B,MAAM,EAAE,sBAAsB,EAAE,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;CACrB,CAAC;AAEF,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAO9D;AAED,wBAAgB,uBAAuB,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CA0BxF;AAED,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,EAAE,CAqCjF;AAED,wBAAsB,qBAAqB,CAAC,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,sBAAsB,GAAG,IAAI,CAAC,CAoC9G"}