@lzehrung/codegraph 2.1.0

package/dist/cli/symbols.js

@@ -0,0 +1,59 @@
+import { formatWorkspaceSymbolsResponse, workspaceSymbols } from "../agent/workspaceSymbols.js";
+import { SymbolKind } from "../indexer/types.js";
+import { exitWithError } from "./context.js";
+import { SYMBOLS_HELP_TEXT } from "./help.js";
+import { parseBoundedIntegerOption } from "./options.js";
+const WORKSPACE_SYMBOL_KIND_VALUES = Object.values(SymbolKind);
+const WORKSPACE_SYMBOL_KIND_VALUE_SET = new Set(WORKSPACE_SYMBOL_KIND_VALUES);
+function isWorkspaceSymbolKind(value) {
+    return WORKSPACE_SYMBOL_KIND_VALUE_SET.has(value);
+}
+function parseWorkspaceSymbolKinds(rawValue) {
+    if (rawValue === undefined)
+        return undefined;
+    const values = rawValue
+        .split(",")
+        .map((value) => value.trim())
+        .filter(Boolean);
+    if (!values.length || values.some((value) => !isWorkspaceSymbolKind(value))) {
+        throw new Error(`Invalid --kind value "${rawValue}". Expected a comma-separated list of: ${WORKSPACE_SYMBOL_KIND_VALUES.join(", ")}.`);
+    }
+    return values.filter(isWorkspaceSymbolKind);
+}
+export async function handleSymbolsCommand(context) {
+    const query = context.positionals.join(" ").trim();
+    let kinds;
+    try {
+        kinds = parseWorkspaceSymbolKinds(context.getOpt("--kind"));
+    }
+    catch (error) {
+        exitWithError(context, error, 1);
+    }
+    const fileGlob = context.getOpt("--file-glob");
+    if (!query && !kinds?.length && !fileGlob) {
+        context.writeStderrLine(SYMBOLS_HELP_TEXT.trimEnd());
+        context.exit(2);
+    }
+    try {
+        const response = await workspaceSymbols({
+            root: context.root,
+            query,
+            ...(context.buildOptions ? { buildOptions: context.buildOptions } : {}),
+            ...(kinds ? { kinds } : {}),
+            ...(context.hasFlag("--exported") ? { exportedOnly: true } : {}),
+            ...(context.hasFlag("--include-imports") ? { includeImports: true } : {}),
+            ...(fileGlob !== undefined ? { fileGlob } : {}),
+            limit: parseBoundedIntegerOption(context.getOpt("--limit"), "--limit", 50, 0, 500),
+        });
+        if (context.hasFlag("--json")) {
+            context.writeJSONLine(response);
+        }
+        else {
+            context.writeStdoutLine(formatWorkspaceSymbolsResponse(response));
+        }
+    }
+    catch (error) {
+        exitWithError(context, error, 1);
+    }
+}
+//# sourceMappingURL=symbols.js.map

package/dist/cli/symbols.js.map

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

package/dist/cli/typeHierarchy.d.ts

@@ -0,0 +1,6 @@
+import { type CliAgentCommandContext } from "./context.js";
+export type TypeHierarchyCommandContext = CliAgentCommandContext;
+type HierarchyCommand = "supertypes" | "subtypes" | "implementations";
+export declare function handleTypeHierarchyCommand(command: HierarchyCommand, context: TypeHierarchyCommandContext): Promise<void>;
+export {};
+//# sourceMappingURL=typeHierarchy.d.ts.map

package/dist/cli/typeHierarchy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeHierarchy.d.ts","sourceRoot":"","sources":["../../src/cli/typeHierarchy.ts"],"names":[],"mappings":"AAQA,OAAO,EAAiB,KAAK,sBAAsB,EAAE,MAAM,cAAc,CAAC;AAI1E,MAAM,MAAM,2BAA2B,GAAG,sBAAsB,CAAC;AAOjE,KAAK,gBAAgB,GAAG,YAAY,GAAG,UAAU,GAAG,iBAAiB,CAAC;AAEtE,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,gBAAgB,EACzB,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,IAAI,CAAC,CA6Cf"}

package/dist/cli/typeHierarchy.js

@@ -0,0 +1,81 @@
+import { findImplementations, findSubtypes, findSupertypes, } from "../agent/typeHierarchy.js";
+import { exitWithError } from "./context.js";
+import { IMPLEMENTATIONS_HELP_TEXT, SUBTYPES_HELP_TEXT, SUPERTYPES_HELP_TEXT } from "./help.js";
+import { parseBoundedIntegerOption } from "./options.js";
+const DEFAULT_HIERARCHY_DEPTH = 1;
+const MAX_HIERARCHY_DEPTH = 10;
+const DEFAULT_HIERARCHY_LIMIT = 100;
+const MAX_HIERARCHY_LIMIT = 500;
+export async function handleTypeHierarchyCommand(command, context) {
+    const handle = context.positionals[0]?.trim();
+    if (!handle) {
+        context.writeStderrLine(helpText(command).trimEnd());
+        context.exit(2);
+    }
+    try {
+        const limit = parseBoundedIntegerOption(context.getOpt("--limit"), "--limit", DEFAULT_HIERARCHY_LIMIT, 0, MAX_HIERARCHY_LIMIT);
+        if (command === "implementations") {
+            const response = await findImplementations({
+                root: context.root,
+                handle,
+                ...(context.buildOptions ? { buildOptions: context.buildOptions } : {}),
+                limit,
+            });
+            writeResponse(context, response, formatImplementationsResponse);
+            return;
+        }
+        const depth = parseBoundedIntegerOption(context.getOpt("--depth"), "--depth", DEFAULT_HIERARCHY_DEPTH, 1, MAX_HIERARCHY_DEPTH);
+        const request = {
+            root: context.root,
+            handle,
+            ...(context.buildOptions ? { buildOptions: context.buildOptions } : {}),
+            depth,
+            limit,
+        };
+        const response = command === "supertypes" ? await findSupertypes(request) : await findSubtypes(request);
+        writeResponse(context, response, formatTypeHierarchyResponse);
+    }
+    catch (error) {
+        exitWithError(context, error, 1);
+    }
+}
+function writeResponse(context, response, format) {
+    if (context.hasFlag("--json")) {
+        context.writeJSONLine(response);
+        return;
+    }
+    context.writeStdoutLine(format(response));
+}
+function formatTypeHierarchyResponse(response) {
+    const label = response.direction === "super" ? "Supertypes" : "Subtypes";
+    const lines = [`Target: ${formatSymbol(response.target)}`, `${label}: ${response.relations.length}`];
+    for (const entry of response.relations) {
+        lines.push(`${entry.depth}. ${formatSymbol(entry.type)} [${entry.relation}]`);
+    }
+    appendOmitted(lines, response.omittedCounts.relations);
+    return lines.join("\n");
+}
+function formatImplementationsResponse(response) {
+    const lines = [`Target: ${formatSymbol(response.target)}`, `Implementations: ${response.implementations.length}`];
+    for (const entry of response.implementations) {
+        lines.push(formatSymbol(entry.symbol));
+    }
+    appendOmitted(lines, response.omittedCounts.relations);
+    return lines.join("\n");
+}
+function formatSymbol(symbol) {
+    const { file, range } = symbol.location;
+    return `${symbol.name} [${symbol.kind}] ${file}:${range.start.line}:${range.start.column}`;
+}
+function appendOmitted(lines, omitted) {
+    if (omitted)
+        lines.push(`Omitted: ${omitted}`);
+}
+function helpText(command) {
+    if (command === "supertypes")
+        return SUPERTYPES_HELP_TEXT;
+    if (command === "subtypes")
+        return SUBTYPES_HELP_TEXT;
+    return IMPLEMENTATIONS_HELP_TEXT;
+}
+//# sourceMappingURL=typeHierarchy.js.map

package/dist/cli/typeHierarchy.js.map

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

package/dist/cli/viewer.d.ts

@@ -0,0 +1,27 @@
+import http from "node:http";
+export type ViewerGraphProvider = () => Promise<string>;
+export type ViewerServerOptions = {
+    root: string;
+    graph?: string | undefined;
+    graphProvider?: ViewerGraphProvider | undefined;
+    host?: string | undefined;
+    port?: number | undefined;
+};
+export type ViewerCommandContext = {
+    getOpt: (name: string) => string | undefined;
+    hasFlag: (name: string) => boolean;
+    cwd: () => string;
+    writeStderrLine: (line: string) => void;
+    writeStdoutLine: (line: string) => void;
+    exit: (code: number) => never;
+};
+export declare function createViewerServer(options: ViewerServerOptions): http.Server;
+export declare function startViewerServer(options: ViewerServerOptions): Promise<{
+    server: http.Server;
+    url: string;
+}>;
+export declare function closeViewerServer(server: http.Server): Promise<void>;
+export declare function viewerUrl(host: string, port: number): string;
+export declare function openViewerUrl(url: string): void;
+export declare function handleViewerCommand(context: ViewerCommandContext): Promise<void>;
+//# sourceMappingURL=viewer.d.ts.map

package/dist/cli/viewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer.d.ts","sourceRoot":"","sources":["../../src/cli/viewer.ts"],"names":[],"mappings":"AAEA,OAAO,IAAI,MAAM,WAAW,CAAC;AAwC7B,MAAM,MAAM,mBAAmB,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;AAExD,MAAM,MAAM,mBAAmB,GAAG;IAChC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,aAAa,CAAC,EAAE,mBAAmB,GAAG,SAAS,CAAC;IAChD,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG;IACjC,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;IAC7C,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAC;IACnC,GAAG,EAAE,MAAM,MAAM,CAAC;IAClB,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,eAAe,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACxC,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,KAAK,CAAC;CAC/B,CAAC;AA6MF,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,IAAI,CAAC,MAAM,CA0B5E;AAED,wBAAsB,iBAAiB,CAAC,OAAO,EAAE,mBAAmB,GAAG,OAAO,CAAC;IAAE,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC,CAYnH;AAED,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAO1E;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAgB/C;AAED,wBAAsB,mBAAmB,CAAC,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC,CA8CtF"}

package/dist/cli/viewer.js

@@ -0,0 +1,313 @@
+import { spawn } from "node:child_process";
+import fs from "node:fs";
+import http from "node:http";
+import { buildCodegraphGraphJson } from "../agent/artifact.js";
+import { createAgentSession } from "../agent/session.js";
+import path from "node:path";
+import { getCodegraphPackageRoot, normalizePathForDisplay } from "../util/packageInfo.js";
+import { buildAllowedHostHeaders, closeHttpServer, formatHostForUrl, getHttpServerPort, isAllowedHostHeader, listenOnHttpServer, } from "../mcp/http.js";
+import { cacheRoot } from "../indexer/build-cache/module-cache.js";
+import { parseOptionalBoundedIntegerOption } from "./options.js";
+import { assertFilePathWithinRoot, resolveFilePathFromRoot } from "../util/paths.js";
+import { errorMessage } from "../util/errors.js";
+import { exitWithError } from "./context.js";
+const DEFAULT_VIEWER_HOST = "127.0.0.1";
+const DEFAULT_VIEWER_PORT = 4173;
+const VIEWER_ASSETS = {
+    "/": { file: "index.html", contentType: "text/html; charset=utf-8" },
+    "/index.html": { file: "index.html", contentType: "text/html; charset=utf-8" },
+    "/app.js": { file: "app.js", contentType: "text/javascript; charset=utf-8" },
+    "/styles.css": { file: "styles.css", contentType: "text/css; charset=utf-8" },
+    "/graph-builder.js": { file: "graph-builder.js", contentType: "text/javascript; charset=utf-8" },
+    "/file-tree-model.js": { file: "file-tree-model.js", contentType: "text/javascript; charset=utf-8" },
+    "/file-tree-filters.js": { file: "file-tree-filters.js", contentType: "text/javascript; charset=utf-8" },
+    "/vendor/graphology.js": { file: "vendor/graphology.js", contentType: "text/javascript; charset=utf-8" },
+    "/vendor/graphology-layout-forceatlas2.js": {
+        file: "vendor/graphology-layout-forceatlas2.js",
+        contentType: "text/javascript; charset=utf-8",
+    },
+    "/vendor/sigma.js": { file: "vendor/sigma.js", contentType: "text/javascript; charset=utf-8" },
+};
+const graphFileDescriptors = new WeakMap();
+function openGraphFile(lexicalRoot, root, graph) {
+    const lexicalGraphPath = assertFilePathWithinRoot(lexicalRoot, graph, "Graph");
+    const initialStats = fs.statSync(lexicalGraphPath);
+    const fileDescriptor = fs.openSync(lexicalGraphPath, "r");
+    try {
+        const openedStats = fs.fstatSync(fileDescriptor);
+        if (!openedStats.isFile()) {
+            throw new Error(`Graph must be a regular file: ${lexicalGraphPath}`);
+        }
+        const graphPath = assertFilePathWithinRoot(root, fs.realpathSync.native(lexicalGraphPath), "Graph");
+        const finalStats = fs.statSync(lexicalGraphPath);
+        const inodeAvailable = initialStats.ino !== 0 || openedStats.ino !== 0 || finalStats.ino !== 0;
+        const openedMatchesInitial = inodeAvailable
+            ? openedStats.ino === initialStats.ino
+            : openedStats.size === initialStats.size &&
+                openedStats.mtimeMs === initialStats.mtimeMs &&
+                openedStats.birthtimeMs === initialStats.birthtimeMs &&
+                openedStats.mode === initialStats.mode;
+        const openedMatchesFinal = inodeAvailable
+            ? openedStats.ino === finalStats.ino
+            : openedStats.size === finalStats.size &&
+                openedStats.mtimeMs === finalStats.mtimeMs &&
+                openedStats.birthtimeMs === finalStats.birthtimeMs &&
+                openedStats.mode === finalStats.mode;
+        if (!openedMatchesInitial || !openedMatchesFinal) {
+            throw new Error(`Graph changed during validation: ${lexicalGraphPath}`);
+        }
+        return { fileDescriptor, path: graphPath };
+    }
+    catch (error) {
+        fs.closeSync(fileDescriptor);
+        throw error;
+    }
+}
+function closeResolvedGraphFile(options) {
+    if (options.graphFile)
+        fs.closeSync(options.graphFile.fileDescriptor);
+}
+function resolveViewerOptions(options) {
+    const lexicalRoot = path.resolve(options.root);
+    const root = fs.realpathSync.native(lexicalRoot);
+    if (!fs.statSync(root).isDirectory()) {
+        throw new Error(`Viewer root is not a directory: ${root}`);
+    }
+    const packageRoot = getCodegraphPackageRoot();
+    const assetRoot = fs.realpathSync.native(path.join(packageRoot, "docs", "graph-visualization"));
+    if (!fs.statSync(assetRoot).isDirectory()) {
+        throw new Error(`Viewer assets directory is not a directory: ${assetRoot}`);
+    }
+    if (options.graph !== undefined && options.graphProvider) {
+        throw new Error("Viewer options cannot combine a graph file with a graph provider.");
+    }
+    const graphFile = options.graph === undefined ? undefined : openGraphFile(lexicalRoot, root, options.graph);
+    const graphProvider = graphFile ? undefined : (options.graphProvider ?? createProjectGraphProvider(root));
+    return { assetRoot, graphFile, graphProvider };
+}
+function createProjectGraphProvider(root) {
+    let inFlight;
+    return async () => {
+        const graphPromise = inFlight ??
+            createAgentSession({ root })
+                .loadProject()
+                .then((snapshot) => JSON.stringify(buildCodegraphGraphJson(snapshot)));
+        inFlight = graphPromise;
+        try {
+            return await graphPromise;
+        }
+        finally {
+            if (inFlight === graphPromise)
+                inFlight = undefined;
+        }
+    };
+}
+function writeFileResponse(request, response, filePath, contentType, fileDescriptor) {
+    const fileStats = fileDescriptor === undefined ? fs.statSync(filePath) : fs.fstatSync(fileDescriptor);
+    response.writeHead(200, {
+        "Content-Length": String(fileStats.size),
+        "Content-Type": contentType,
+        "X-Content-Type-Options": "nosniff",
+    });
+    if (request.method === "HEAD") {
+        response.end();
+        return;
+    }
+    const stream = fileDescriptor === undefined
+        ? fs.createReadStream(filePath)
+        : fs.createReadStream(filePath, { autoClose: false, fd: fileDescriptor, start: 0 });
+    stream.on("error", () => {
+        if (!response.headersSent)
+            response.writeHead(500);
+        response.end();
+    });
+    stream.pipe(response);
+}
+async function writeGeneratedGraphResponse(request, response, graphProvider) {
+    try {
+        const graphJson = await graphProvider();
+        response.writeHead(200, {
+            "Content-Length": String(Buffer.byteLength(graphJson)),
+            "Content-Type": "application/json; charset=utf-8",
+            "X-Content-Type-Options": "nosniff",
+        });
+        response.end(request.method === "HEAD" ? undefined : graphJson);
+    }
+    catch (error) {
+        const detail = errorMessage(error);
+        const message = `Unable to build the current project graph: ${detail}`;
+        response.writeHead(500, {
+            "Content-Length": String(Buffer.byteLength(message)),
+            "Content-Type": "text/plain; charset=utf-8",
+            "X-Content-Type-Options": "nosniff",
+        });
+        response.end(request.method === "HEAD" ? undefined : message);
+    }
+}
+function viewerRequestHandler(options, getAllowedHostHeaders) {
+    return (request, response) => {
+        if (!isAllowedHostHeader(request, getAllowedHostHeaders())) {
+            response.writeHead(403);
+            response.end();
+            return;
+        }
+        if (request.method !== "GET" && request.method !== "HEAD") {
+            response.writeHead(405, { Allow: "GET, HEAD" });
+            response.end();
+            return;
+        }
+        const rawPathname = (request.url ?? "/").split(/[?#]/, 1)[0] ?? "/";
+        try {
+            if (decodeURIComponent(rawPathname)
+                .split("/")
+                .some((segment) => segment === "..")) {
+                response.writeHead(404);
+                response.end();
+                return;
+            }
+        }
+        catch {
+            response.writeHead(404);
+            response.end();
+            return;
+        }
+        const pathname = new URL(request.url ?? "/", "http://viewer.local").pathname;
+        if (pathname === "/graph.json") {
+            if (options.graphFile) {
+                writeFileResponse(request, response, options.graphFile.path, "application/json; charset=utf-8", options.graphFile.fileDescriptor);
+                return;
+            }
+            if (options.graphProvider) {
+                void writeGeneratedGraphResponse(request, response, options.graphProvider);
+                return;
+            }
+        }
+        const asset = VIEWER_ASSETS[pathname];
+        if (!asset) {
+            response.writeHead(404);
+            response.end();
+            return;
+        }
+        writeFileResponse(request, response, path.join(options.assetRoot, asset.file), asset.contentType);
+    };
+}
+export function createViewerServer(options) {
+    const resolvedOptions = resolveViewerOptions(options);
+    const graphFileDescriptor = resolvedOptions.graphFile?.fileDescriptor;
+    try {
+        let allowedHostHeaders;
+        const host = options.host ?? DEFAULT_VIEWER_HOST;
+        const server = http.createServer();
+        const handler = viewerRequestHandler(resolvedOptions, () => {
+            allowedHostHeaders ??= buildAllowedHostHeaders(host, getHttpServerPort(server.address()));
+            return allowedHostHeaders;
+        });
+        server.on("request", handler);
+        if (graphFileDescriptor !== undefined) {
+            graphFileDescriptors.set(server, graphFileDescriptor);
+            server.once("close", () => {
+                const descriptor = graphFileDescriptors.get(server);
+                if (descriptor === undefined)
+                    return;
+                graphFileDescriptors.delete(server);
+                fs.closeSync(descriptor);
+            });
+        }
+        return server;
+    }
+    catch (error) {
+        closeResolvedGraphFile(resolvedOptions);
+        throw error;
+    }
+}
+export async function startViewerServer(options) {
+    const server = createViewerServer(options);
+    const host = options.host ?? DEFAULT_VIEWER_HOST;
+    const port = options.port ?? DEFAULT_VIEWER_PORT;
+    try {
+        await listenOnHttpServer(server, port, host);
+    }
+    catch (error) {
+        await closeViewerServer(server);
+        throw error;
+    }
+    const actualPort = getHttpServerPort(server.address());
+    return { server, url: viewerUrl(host, actualPort) };
+}
+export async function closeViewerServer(server) {
+    await closeHttpServer(server);
+    const graphFileDescriptor = graphFileDescriptors.get(server);
+    if (graphFileDescriptor !== undefined) {
+        graphFileDescriptors.delete(server);
+        fs.closeSync(graphFileDescriptor);
+    }
+}
+export function viewerUrl(host, port) {
+    return `http://${formatHostForUrl(host)}:${port}/`;
+}
+export function openViewerUrl(url) {
+    let command;
+    let args;
+    if (process.platform === "win32") {
+        command = "rundll32.exe";
+        args = ["url.dll,FileProtocolHandler", url];
+    }
+    else if (process.platform === "darwin") {
+        command = "open";
+        args = [url];
+    }
+    else {
+        command = "xdg-open";
+        args = [url];
+    }
+    const child = spawn(command, args, { detached: true, stdio: "ignore" });
+    child.once("error", () => { });
+    child.unref();
+}
+export async function handleViewerCommand(context) {
+    let options;
+    try {
+        const port = parseOptionalBoundedIntegerOption(context.getOpt("--port"), "--port", 0, 65535) ?? DEFAULT_VIEWER_PORT;
+        const host = context.getOpt("--host") ?? DEFAULT_VIEWER_HOST;
+        if (!host.trim()) {
+            throw new Error("Invalid --host value. Expected a non-empty host name or address.");
+        }
+        const preview = context.hasFlag("--print-url");
+        if (preview && context.hasFlag("--open")) {
+            throw new Error("--print-url cannot be used with --open.");
+        }
+        if (preview && port === 0) {
+            throw new Error("--print-url cannot use --port 0.");
+        }
+        const graph = context.getOpt("--graph");
+        const root = resolveFilePathFromRoot(context.cwd(), context.getOpt("--root") ?? ".");
+        if (preview) {
+            context.writeStdoutLine(viewerUrl(host, port));
+            return;
+        }
+        options = {
+            root,
+            ...(graph !== undefined ? { graph } : {}),
+            host,
+            port,
+        };
+        const resolvedOptions = resolveViewerOptions(options);
+        closeResolvedGraphFile(resolvedOptions);
+        if (graph === undefined) {
+            const diskCacheRoot = cacheRoot(root);
+            if (!fs.existsSync(diskCacheRoot)) {
+                context.writeStderrLine(`No disk cache found under ${normalizePathForDisplay(diskCacheRoot)}. Viewer will build the current project graph on first load; run codegraph init --root ${JSON.stringify(root)} to prewarm it.`);
+            }
+        }
+    }
+    catch (error) {
+        exitWithError(context, error, 2);
+    }
+    if (!options)
+        return;
+    const { url } = await startViewerServer(options);
+    context.writeStdoutLine(url);
+    if (context.hasFlag("--open"))
+        openViewerUrl(url);
+}
+//# sourceMappingURL=viewer.js.map

package/dist/cli/viewer.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,7 @@
+#!/usr/bin/env node
+import { type CliRuntime } from "./cli/context.js";
+export { isRelativePathInside as isCliDiscoveryRelativePathInside } from "./util/discoveryPath.js";
+export declare const CLI_DISPATCHABLE_COMMANDS: readonly ["apisurface", "affected", "artifact", "callees", "callers", "chunk", "cycles", "deps", "doctor", "drift", "dumpmod", "duplicates", "explain", "explore", "file", "goto", "graph", "graph-delta", "grep", "hotspots", "impact", "implementations", "index", "init", "inspect", "install", "links", "mcp", "orient", "packet", "path", "rdeps", "refactor-plan", "refs", "rename-preview", "review", "search", "skill", "sql", "status", "subtypes", "supertypes", "symbols", "sync", "uninit", "uninstall", "unresolved", "viewer", "version"];
+export declare function runCli(rawArgs?: string[], runtime?: Partial<CliRuntime>): Promise<void>;
+export declare function main(rawArgs?: string[]): Promise<void>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AAMA,OAAO,EASL,KAAK,UAAU,EAChB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAAE,oBAAoB,IAAI,gCAAgC,EAAE,MAAM,yBAAyB,CAAC;AACnG,eAAO,MAAM,yBAAyB,yhBAkD5B,CAAC;AA6GX,wBAAsB,MAAM,CAC1B,OAAO,GAAE,MAAM,EAA0B,EACzC,OAAO,GAAE,OAAO,CAAC,UAAU,CAAM,GAChC,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,IAAI,CAAC,OAAO,GAAE,MAAM,EAA0B,GAAG,OAAO,CAAC,IAAI,CAAC,CAWnF"}