@lzehrung/codegraph 2.1.0

package/dist/agent/refactorPlan.js

@@ -0,0 +1,234 @@
+import { findCallHierarchy } from "../indexer/call-hierarchy.js";
+import { findReferences } from "../indexer/navigation.js";
+import { findImplementations as queryImplementations, findTypeHierarchy, } from "../indexer/type-hierarchy.js";
+import { listCandidateTestFiles } from "../impact/context.js";
+import { classifySensitiveFile } from "./fileView.js";
+import { normalizeAgentFilePath } from "./normalize.js";
+import { previewRenameInSnapshot } from "./renamePreview.js";
+import { requireSemanticSymbol, semanticSymbolFromDef } from "./semanticSymbols.js";
+import { createAgentSession, } from "./session.js";
+import { buildSymbolLookup } from "./symbolLookup.js";
+import { toolFollowUp } from "./followUps.js";
+const DEFAULT_REFACTOR_REFERENCE_LIMIT = 200;
+const DEFAULT_REFACTOR_RELATION_LIMIT = 100;
+const MAX_REFACTOR_SECTION_LIMIT = 500;
+export async function buildRefactorPlan(request) {
+    const session = createAgentSession({
+        root: request.root,
+        ...(request.buildOptions ? { buildOptions: request.buildOptions } : {}),
+    });
+    return await buildRefactorPlanWithSession(session, request);
+}
+export async function buildRefactorPlanWithSession(session, request) {
+    const freshness = session.checkFreshness ? await session.checkFreshness() : { state: "fresh" };
+    const snapshot = await session.loadProject();
+    return await buildRefactorPlanInSnapshot(snapshot, request, freshness);
+}
+export async function buildRefactorPlanInSnapshot(snapshot, request, freshness = { state: "fresh" }) {
+    const resolved = requireSemanticSymbol(snapshot, request.handle);
+    const referenceLimit = boundedSectionLimit(request.maxReferences, DEFAULT_REFACTOR_REFERENCE_LIMIT, "maxReferences");
+    const callerLimit = boundedSectionLimit(request.maxCallers, DEFAULT_REFACTOR_RELATION_LIMIT, "maxCallers");
+    const hierarchyLimit = boundedSectionLimit(request.maxHierarchy, DEFAULT_REFACTOR_RELATION_LIMIT, "maxHierarchy");
+    const provenance = relationshipProvenance(snapshot);
+    const lookup = buildSymbolLookup(snapshot);
+    const referenceResult = await findReferences(snapshot.index, { def: resolved.def }, {
+        maxReferences: referenceLimit + 1,
+        ...(request.includeSource ? { context: "line" } : {}),
+    });
+    if (referenceResult.status !== "ok")
+        throw new Error(referenceResult.reason);
+    const referenceOmitted = Math.max(0, referenceResult.references.length - referenceLimit);
+    const references = referenceResult.references.slice(0, referenceLimit).map((reference) => {
+        const file = normalizeAgentFilePath(snapshot.root, reference.file);
+        const includeContext = request.includeSource && !classifySensitiveFile(file) && !classifySensitiveFile(reference.file);
+        return {
+            file,
+            range: reference.range,
+            ...(includeContext && reference.context ? { context: reference.context } : {}),
+        };
+    });
+    const callersResult = findCallHierarchy(snapshot.symbolGraph, resolved.id, "incoming", {
+        depth: 1,
+        limit: callerLimit,
+    });
+    const calleesResult = findCallHierarchy(snapshot.symbolGraph, resolved.id, "outgoing", {
+        depth: 1,
+        limit: callerLimit,
+    });
+    const callers = normalizeCallSection(snapshot, lookup, callersResult, "incoming", provenance);
+    const callees = normalizeCallSection(snapshot, lookup, calleesResult, "outgoing", provenance);
+    const supertypesResult = findTypeHierarchy(snapshot.symbolGraph, resolved.id, "super", {
+        depth: 10,
+        limit: hierarchyLimit,
+    });
+    const subtypesResult = findTypeHierarchy(snapshot.symbolGraph, resolved.id, "sub", {
+        depth: 10,
+        limit: hierarchyLimit,
+    });
+    const supertypes = normalizeHierarchySection(snapshot, lookup, supertypesResult, "super", provenance);
+    const subtypes = normalizeHierarchySection(snapshot, lookup, subtypesResult, "sub", provenance);
+    const implementationResult = queryImplementations(snapshot.index, snapshot.symbolGraph, resolved.id, {
+        limit: hierarchyLimit,
+    });
+    const implementations = [];
+    const sectionIssues = [];
+    if (implementationResult.status === "ok") {
+        for (const entry of implementationResult.implementations) {
+            const def = lookup.defById.get(entry.symbolId);
+            if (!def)
+                continue;
+            implementations.push({
+                symbol: semanticSymbolFromDef(snapshot, def),
+                ...(entry.site
+                    ? {
+                        relationSite: {
+                            file: normalizeAgentFilePath(snapshot.root, entry.site.file),
+                            range: entry.site.range,
+                        },
+                    }
+                    : {}),
+                provenance,
+            });
+        }
+    }
+    else {
+        sectionIssues.push({
+            section: "implementations",
+            status: implementationResult.status,
+            reason: implementationResult.reason,
+        });
+    }
+    const allCandidateTests = listCandidateTestFiles(snapshot.index, [resolved.def.file], [resolved.id], {
+        maxCandidates: 101,
+        projectRoot: snapshot.root,
+    });
+    const omittedCandidateTests = Math.max(0, allCandidateTests.length - 100);
+    const candidateTests = allCandidateTests.slice(0, 100).map((candidate) => ({
+        file: normalizeAgentFilePath(snapshot.root, candidate.file),
+        confidence: candidate.confidence,
+        reason: candidate.reason,
+    }));
+    const target = semanticSymbolFromDef(snapshot, resolved.def);
+    const rename = request.renameTo
+        ? await previewRenameInSnapshot(snapshot, {
+            root: request.root,
+            handle: target.handle,
+            newName: request.renameTo,
+        }, freshness)
+        : undefined;
+    const followUps = [
+        toolFollowUp("refs", {
+            file: target.location.file,
+            line: target.location.range.start.line,
+            column: target.location.range.start.column,
+        }),
+        toolFollowUp("calls", { handle: target.handle, direction: "callers", depth: 1 }),
+        toolFollowUp("calls", { handle: target.handle, direction: "callees", depth: 1 }),
+        toolFollowUp("implementations", { handle: target.handle }),
+    ];
+    if (!request.renameTo) {
+        followUps.push(toolFollowUp("rename_preview", { handle: target.handle, newName: "<new-name>" }));
+    }
+    return {
+        schemaVersion: 1,
+        root: snapshot.root,
+        analysis: snapshot.analysis,
+        freshness,
+        limits: {
+            references: referenceLimit,
+            callers: callerLimit,
+            callees: callerLimit,
+            hierarchy: hierarchyLimit,
+            candidateTests: 100,
+        },
+        omittedCounts: {
+            references: referenceOmitted,
+            callers: callOmitted(callersResult),
+            callees: callOmitted(calleesResult),
+            supertypes: hierarchyOmitted(supertypesResult),
+            subtypes: hierarchyOmitted(subtypesResult),
+            implementations: implementationResult.status === "ok" ? implementationResult.omitted : 1,
+            candidateTests: omittedCandidateTests,
+        },
+        target,
+        definition: target.location,
+        references,
+        callers,
+        callees,
+        supertypes,
+        subtypes,
+        implementations,
+        sectionIssues,
+        ...(rename ? { rename } : {}),
+        candidateTests,
+        followUps,
+    };
+}
+function normalizeCallSection(snapshot, lookup, result, direction, provenance) {
+    if (result.status !== "ok" || result.direction !== direction)
+        return [];
+    return result.entries.flatMap((entry) => {
+        const def = lookup.defById.get(entry.symbolId);
+        if (!def)
+            return [];
+        return [
+            {
+                symbol: semanticSymbolFromDef(snapshot, def),
+                callsites: entry.callsites.map((site) => ({
+                    file: normalizeAgentFilePath(snapshot.root, site.file),
+                    range: site.range,
+                })),
+                depth: entry.depth,
+                provenance,
+            },
+        ];
+    });
+}
+function normalizeHierarchySection(snapshot, lookup, result, direction, provenance) {
+    if (result.status !== "ok" || result.direction !== direction)
+        return [];
+    return result.relations.flatMap((relation) => {
+        const def = lookup.defById.get(relation.targetId);
+        if (!def)
+            return [];
+        return [
+            {
+                type: semanticSymbolFromDef(snapshot, def),
+                relation: relation.relation,
+                ...(relation.site
+                    ? {
+                        declarationSite: {
+                            file: normalizeAgentFilePath(snapshot.root, relation.site.file),
+                            range: relation.site.range,
+                        },
+                    }
+                    : {}),
+                depth: relation.depth,
+                provenance,
+            },
+        ];
+    });
+}
+function callOmitted(result) {
+    return result.status === "ok" ? result.omittedSymbols : 0;
+}
+function hierarchyOmitted(result) {
+    return result.status === "ok" ? result.omitted : 0;
+}
+function relationshipProvenance(snapshot) {
+    const reduced = snapshot.analysis.mode === "reduced";
+    return {
+        capability: reduced ? "graph" : "semantic",
+        backend: snapshot.analysis.backend,
+        confidence: reduced ? "medium" : "high",
+        ...(reduced ? { reason: snapshot.analysis.label } : {}),
+    };
+}
+function boundedSectionLimit(value, defaultValue, name) {
+    if (value === undefined)
+        return defaultValue;
+    if (!Number.isInteger(value) || value < 0)
+        throw new Error(`${name} must be a non-negative integer.`);
+    return Math.min(value, MAX_REFACTOR_SECTION_LIMIT);
+}
+//# sourceMappingURL=refactorPlan.js.map

package/dist/agent/refactorPlan.js.map

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

package/dist/agent/renamePreview.d.ts

@@ -0,0 +1,60 @@
+import { type BuildOptions } from "../indexer/types.js";
+import type { Range } from "../types.js";
+import type { SemanticLocation, SemanticProvenance, SemanticResponseEnvelope, SemanticSymbol } from "./semantic.js";
+import { type AgentFreshnessResult, type AgentProjectSnapshot, type AgentSession } from "./session.js";
+export type RenamePreviewRequest = {
+    root: string;
+    handle: string;
+    newName: string;
+    includeComments?: boolean;
+    includeStrings?: boolean;
+    includeFilenames?: boolean;
+    maxEdits?: number;
+    buildOptions?: BuildOptions;
+};
+export type RenameEditKind = "definition" | "reference" | "import" | "export" | "comment" | "string";
+export type RenameEdit = {
+    file: string;
+    range: Range;
+    oldText: string;
+    newText: string;
+    kind: RenameEditKind;
+    provenance: SemanticProvenance;
+};
+export type RenameUnsafeSite = {
+    location: SemanticLocation;
+    text: string;
+    reason: "ambiguous_target" | "unresolved_reference" | "dynamic_access" | "unsupported_syntax" | "parse_degraded" | "generated_file" | "sensitive_file" | "outside_root" | "limit_exceeded";
+    provenance: SemanticProvenance;
+};
+export type RenameConflict = {
+    file: string;
+    location?: SemanticLocation;
+    reason: "name_collision" | "shadowing" | "duplicate_export" | "invalid_identifier" | "case_only_filesystem_risk";
+    existingHandle?: string;
+    message: string;
+};
+export type RenameFilenameSuggestion = {
+    from: string;
+    to: string;
+    caseOnlyRisk: boolean;
+};
+export type RenameCandidateTest = {
+    file: string;
+    confidence: "high" | "medium" | "low";
+    reason: string;
+};
+export type RenamePreviewResponse = SemanticResponseEnvelope & {
+    target: SemanticSymbol;
+    newName: string;
+    safe: boolean;
+    edits: RenameEdit[];
+    unsafeSites: RenameUnsafeSite[];
+    conflicts: RenameConflict[];
+    filenameSuggestions: RenameFilenameSuggestion[];
+    candidateTests: RenameCandidateTest[];
+};
+export declare function previewRename(request: RenamePreviewRequest): Promise<RenamePreviewResponse>;
+export declare function previewRenameWithSession(session: AgentSession, request: RenamePreviewRequest): Promise<RenamePreviewResponse>;
+export declare function previewRenameInSnapshot(snapshot: AgentProjectSnapshot, request: Omit<RenamePreviewRequest, "buildOptions">, freshness?: AgentFreshnessResult): Promise<RenamePreviewResponse>;
+//# sourceMappingURL=renamePreview.d.ts.map

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

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