codegraph-java 0.1.0

package/dist/ui-server/api/respond.js

@@ -0,0 +1,186 @@
+"use strict";
+/**
+ * How the JSON API answers — success, refusal, and every failure in between.
+ *
+ * The viewer is the only client, and it runs on the same machine as the index,
+ * so an error here is a message to a developer looking at their own project,
+ * not information to withhold from a prober. Every failure therefore says what
+ * went wrong and — where there is one — what to do about it, exactly the way
+ * the CLI and the MCP tools do. What it never does is leak a stack trace.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_QUERY_LENGTH = exports.MAX_BODY_BYTES = exports.ApiError = void 0;
+exports.badRequest = badRequest;
+exports.notFound = notFound;
+exports.ok = ok;
+exports.fail = fail;
+exports.readJsonBody = readJsonBody;
+exports.requiredParam = requiredParam;
+exports.intParam = intParam;
+exports.textParam = textParam;
+exports.optionalTextParam = optionalTextParam;
+const static_1 = require("../static");
+const STATUS = {
+    'bad-request': 400,
+    'not-found': 404,
+    // A path refusal, not an authentication failure — the request asked for
+    // something outside the project (traversal, an absolute path, a sensitive
+    // directory) and there is no version of it we would serve.
+    refused: 403,
+    // The index is missing or unusable. 503 rather than 404: the endpoint is
+    // real, the data behind it is not there *yet* — `cg init` fixes it.
+    'no-index': 503,
+    'index-unusable': 503,
+    internal: 500,
+};
+/** An error that already carries a user-facing message and a status. */
+class ApiError extends Error {
+    code;
+    /** Optional second line: what the user can do about it. */
+    hint;
+    constructor(code, message, hint) {
+        super(message);
+        this.name = 'ApiError';
+        this.code = code;
+        this.hint = hint;
+    }
+}
+exports.ApiError = ApiError;
+function badRequest(message, hint) {
+    return new ApiError('bad-request', message, hint);
+}
+function notFound(message, hint) {
+    return new ApiError('not-found', message, hint);
+}
+/** Send a successful payload. */
+function ok(res, payload, method) {
+    (0, static_1.sendJson)(res, 200, payload, method);
+    return true;
+}
+/** Send a failure. Anything that is not an {@link ApiError} becomes a 500. */
+function fail(res, err, method) {
+    if (err instanceof ApiError) {
+        const body = {
+            error: err.message,
+            code: err.code,
+        };
+        if (err.hint)
+            body.hint = err.hint;
+        (0, static_1.sendJson)(res, STATUS[err.code], body, method);
+        return true;
+    }
+    (0, static_1.sendJson)(res, 500, {
+        error: err instanceof Error ? err.message : String(err),
+        code: 'internal',
+    }, method);
+    return true;
+}
+// =============================================================================
+// Request bodies
+// =============================================================================
+/**
+ * Bytes a request body may carry.
+ *
+ * The only body this server reads is a saved trail: a name and up to 64 node
+ * ids. 64 KB is generous for that and small enough that a runaway client cannot
+ * make the process hold a megabyte per socket.
+ */
+exports.MAX_BODY_BYTES = 64 * 1024;
+/**
+ * Read a request body as JSON.
+ *
+ * Counts BYTES, not characters, and stops at the cap by destroying the socket
+ * rather than draining a body nobody is going to parse — a `Content-Length`
+ * header is a claim, and the only limit that holds is the one applied to what
+ * actually arrives.
+ *
+ * @throws {ApiError} `bad-request` for a body that is too large or is not JSON.
+ */
+async function readJsonBody(req) {
+    const chunks = [];
+    let size = 0;
+    try {
+        for await (const chunk of req) {
+            const buf = chunk;
+            size += buf.length;
+            if (size > exports.MAX_BODY_BYTES) {
+                req.destroy();
+                throw badRequest(`That request body is too large (max ${exports.MAX_BODY_BYTES} bytes).`);
+            }
+            chunks.push(buf);
+        }
+    }
+    catch (err) {
+        if (err instanceof ApiError)
+            throw err;
+        throw badRequest('That request body could not be read.');
+    }
+    if (size === 0)
+        throw badRequest('That request needs a JSON body.');
+    try {
+        return JSON.parse(Buffer.concat(chunks).toString('utf-8'));
+    }
+    catch {
+        throw badRequest('That request body is not valid JSON.');
+    }
+}
+// =============================================================================
+// Query parameters
+// =============================================================================
+/** A required, non-empty string parameter. */
+function requiredParam(query, name) {
+    const raw = query.get(name);
+    if (raw === null || raw.trim() === '') {
+        throw badRequest(`Missing required parameter "${name}".`);
+    }
+    return raw;
+}
+/**
+ * A bounded integer parameter.
+ *
+ * Out-of-range values are an error rather than silently clamped: a viewer
+ * asking for line 10 000 000 of a 200-line file has a bug, and answering it
+ * with line 200 would hide that.
+ */
+function intParam(query, name, opts) {
+    const raw = query.get(name);
+    if (raw === null || raw.trim() === '') {
+        if (opts.default !== undefined)
+            return opts.default;
+        throw badRequest(`Missing required parameter "${name}".`);
+    }
+    const value = Number(raw);
+    if (!Number.isInteger(value) || value < opts.min || value > opts.max) {
+        throw badRequest(`Parameter "${name}" must be a whole number between ${opts.min} and ${opts.max} (got "${raw}").`);
+    }
+    return value;
+}
+/**
+ * Free-form text input, bounded.
+ *
+ * The same reasoning as the MCP tools' input ceiling: a huge string is never a
+ * real query, and letting one through means a full-table LIKE scan or an FTS5
+ * parse over megabytes.
+ */
+exports.MAX_QUERY_LENGTH = 2_000;
+function textParam(query, name) {
+    const raw = requiredParam(query, name);
+    return boundLength(raw, name);
+}
+/**
+ * Text that must be PRESENT but may be empty — a search box the user has
+ * cleared. Absent is still an error; empty is a legitimate state.
+ */
+function optionalTextParam(query, name) {
+    const raw = query.get(name);
+    if (raw === null)
+        throw badRequest(`Missing required parameter "${name}".`);
+    return boundLength(raw, name);
+}
+function boundLength(raw, name) {
+    if (raw.length > exports.MAX_QUERY_LENGTH) {
+        throw badRequest(`Parameter "${name}" is too long (max ${exports.MAX_QUERY_LENGTH} characters).`);
+    }
+    return raw;
+}
+//# sourceMappingURL=respond.js.map

package/dist/ui-server/api/respond.js.map

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

package/dist/ui-server/api/route-roots.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Where a route's code starts — the symbol that runs when a request arrives
+ * at `POST /users`, or when a navigation lands on `/capture/review`.
+ *
+ * Every framework resolver binds a route node to what serves it, but not with
+ * the same edge: Expo Router and the React page routers draw a `calls` edge
+ * to the component the screen file exports; Express (named handler), NestJS,
+ * Spring, FastAPI / Flask / Django, ASP.NET, Vapor, Gin and the React Router
+ * draw a `references` edge to the handler; an Express route whose handler is
+ * an inline arrow has no handler node at all — the resolver attributes the
+ * body's calls to the route itself. The Steps and Screens pictures need ONE
+ * answer per route, so this is it, in order of evidence:
+ *
+ * 1. the target of a `references` edge that is a function, a method, or a
+ *    class (a DRF ViewSet, a class-based view) — the handler the resolver
+ *    named at the registration site;
+ * 2. the target of a `calls` / `instantiates` edge that is a component — the
+ *    page a file-routed screen exports;
+ * 3. the route itself, when it carries `calls` edges and nothing else — the
+ *    inline handler, walked as if the route were the function;
+ * 4. nothing: the route is drawn alone, and the picture says so.
+ *
+ * A route whose handler is a DIFFERENT symbol from what the routing manifest
+ * names would be a resolver bug, not a case to arbitrate here — both read the
+ * same edges.
+ */
+import type CodeGraph from '../../index';
+import type { Node } from '../../types';
+export interface RouteRoot {
+    /** The symbol a walk from the route starts at; the route itself for an inline handler. */
+    node: Node;
+    /** The route's handler is an anonymous function at the registration site — the route node stands in for it. */
+    inline: boolean;
+}
+/** A React component, by the convention that names one: a PascalCase function in a JS-family file. */
+export declare function looksLikeComponent(node: Node): boolean;
+/** Route id → where its code starts, for every route that has an answer. */
+export declare function routeRoots(cg: CodeGraph, routes: readonly Node[]): Map<string, RouteRoot>;
+//# sourceMappingURL=route-roots.d.ts.map

package/dist/ui-server/api/route-roots.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-roots.d.ts","sourceRoot":"","sources":["../../../src/ui-server/api/route-roots.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,WAAW,SAAS;IACxB,0FAA0F;IAC1F,IAAI,EAAE,IAAI,CAAC;IACX,+GAA+G;IAC/G,MAAM,EAAE,OAAO,CAAC;CACjB;AAYD,sGAAsG;AACtG,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,IAAI,GAAG,OAAO,CAItD;AAED,4EAA4E;AAC5E,wBAAgB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,SAAS,IAAI,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,SAAS,CAAC,CA2CzF"}

package/dist/ui-server/api/route-roots.js

@@ -0,0 +1,96 @@
+"use strict";
+/**
+ * Where a route's code starts — the symbol that runs when a request arrives
+ * at `POST /users`, or when a navigation lands on `/capture/review`.
+ *
+ * Every framework resolver binds a route node to what serves it, but not with
+ * the same edge: Expo Router and the React page routers draw a `calls` edge
+ * to the component the screen file exports; Express (named handler), NestJS,
+ * Spring, FastAPI / Flask / Django, ASP.NET, Vapor, Gin and the React Router
+ * draw a `references` edge to the handler; an Express route whose handler is
+ * an inline arrow has no handler node at all — the resolver attributes the
+ * body's calls to the route itself. The Steps and Screens pictures need ONE
+ * answer per route, so this is it, in order of evidence:
+ *
+ * 1. the target of a `references` edge that is a function, a method, or a
+ *    class (a DRF ViewSet, a class-based view) — the handler the resolver
+ *    named at the registration site;
+ * 2. the target of a `calls` / `instantiates` edge that is a component — the
+ *    page a file-routed screen exports;
+ * 3. the route itself, when it carries `calls` edges and nothing else — the
+ *    inline handler, walked as if the route were the function;
+ * 4. nothing: the route is drawn alone, and the picture says so.
+ *
+ * A route whose handler is a DIFFERENT symbol from what the routing manifest
+ * names would be a resolver bug, not a case to arbitrate here — both read the
+ * same edges.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.looksLikeComponent = looksLikeComponent;
+exports.routeRoots = routeRoots;
+/**
+ * What a resolver's `references` edge may name as the handler. A constant or
+ * a variable counts: `const authUser = asyncHandler(async (req, res) => …)` is
+ * how an Express handler is written with a wrapper, and the registration site
+ * named it — the arrow inside has no node of its own, so the binding is the
+ * handler, and the walk lends it the file-scope calls within its lines.
+ */
+const HANDLER_KINDS = new Set(['function', 'method', 'class', 'component', 'constant', 'variable']);
+const JS_FAMILY = new Set(['javascript', 'typescript', 'tsx', 'jsx']);
+/** A React component, by the convention that names one: a PascalCase function in a JS-family file. */
+function looksLikeComponent(node) {
+    if (node.kind === 'component')
+        return true;
+    if (node.kind !== 'function')
+        return false;
+    return JS_FAMILY.has(node.language) && /^[A-Z]/.test(node.name);
+}
+/** Route id → where its code starts, for every route that has an answer. */
+function routeRoots(cg, routes) {
+    const out = new Map();
+    if (routes.length === 0)
+        return out;
+    const ids = routes.map((r) => r.id);
+    const edges = cg.getOutgoingEdgesFrom(ids, ['references', 'calls', 'instantiates']);
+    if (edges.length === 0)
+        return out;
+    const targets = cg.getNodesByIds(edges.map((e) => e.target));
+    const byRoute = new Map();
+    for (const e of edges) {
+        const list = byRoute.get(e.source) ?? [];
+        list.push(e);
+        byRoute.set(e.source, list);
+    }
+    const rank = (n) => (n.kind === 'function' || n.kind === 'method' ? 0 : n.kind === 'component' ? 1 : n.kind === 'class' ? 2 : 3);
+    for (const route of routes) {
+        const list = byRoute.get(route.id);
+        if (!list || list.length === 0)
+            continue;
+        // 1. The handler the resolver named.
+        const named = list
+            .filter((e) => e.kind === 'references')
+            .map((e) => targets.get(e.target))
+            .filter((n) => !!n && HANDLER_KINDS.has(n.kind) && n.id !== route.id)
+            .sort((a, b) => rank(a) - rank(b) || a.startLine - b.startLine);
+        if (named[0]) {
+            out.set(route.id, { node: named[0], inline: false });
+            continue;
+        }
+        // 2. The component a screen file exports.
+        const rendered = list
+            .filter((e) => e.kind === 'calls' || e.kind === 'instantiates')
+            .map((e) => targets.get(e.target))
+            .filter((n) => !!n && looksLikeComponent(n) && n.id !== route.id)
+            .sort((a, b) => a.startLine - b.startLine);
+        if (rendered[0]) {
+            out.set(route.id, { node: rendered[0], inline: false });
+            continue;
+        }
+        // 3. The inline handler: the route's own calls are the body's.
+        if (list.some((e) => e.kind === 'calls' && targets.get(e.target)?.kind !== 'file')) {
+            out.set(route.id, { node: route, inline: true });
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=route-roots.js.map

package/dist/ui-server/api/route-roots.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-roots.js","sourceRoot":"","sources":["../../../src/ui-server/api/route-roots.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;AAuBH,gDAIC;AAGD,gCA2CC;AA7DD;;;;;;GAMG;AACH,MAAM,aAAa,GAA8B,IAAI,GAAG,CAAC,CAAC,UAAU,EAAE,QAAQ,EAAE,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC;AAC/H,MAAM,SAAS,GAAwB,IAAI,GAAG,CAAC,CAAC,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAE3F,sGAAsG;AACtG,SAAgB,kBAAkB,CAAC,IAAU;IAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW;QAAE,OAAO,IAAI,CAAC;IAC3C,IAAI,IAAI,CAAC,IAAI,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAC3C,OAAO,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAClE,CAAC;AAED,4EAA4E;AAC5E,SAAgB,UAAU,CAAC,EAAa,EAAE,MAAuB;IAC/D,MAAM,GAAG,GAAG,IAAI,GAAG,EAAqB,CAAC;IACzC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACpC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IACpC,MAAM,KAAK,GAAG,EAAE,CAAC,oBAAoB,CAAC,GAAG,EAAE,CAAC,YAAY,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC;IACpF,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC;IACnC,MAAM,OAAO,GAAG,EAAE,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAC7D,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;IAChD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACb,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9B,CAAC;IACD,MAAM,IAAI,GAAG,CAAC,CAAO,EAAU,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/I,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,SAAS;QACzC,qCAAqC;QACrC,MAAM,KAAK,GAAG,IAAI;aACf,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC;aACtC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;aACjC,MAAM,CAAC,CAAC,CAAC,EAAa,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;aAC/E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAClE,IAAI,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YACb,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACrD,SAAS;QACX,CAAC;QACD,0CAA0C;QAC1C,MAAM,QAAQ,GAAG,IAAI;aAClB,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,cAAc,CAAC;aAC9D,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;aACjC,MAAM,CAAC,CAAC,CAAC,EAAa,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,EAAE,CAAC;aAC3E,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;QAC7C,IAAI,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC;YAChB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;YACxD,SAAS;QACX,CAAC;QACD,+DAA+D;QAC/D,IAAI,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,KAAK,MAAM,CAAC,EAAE,CAAC;YACnF,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QACnD,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/ui-server/api/routes.d.ts

@@ -0,0 +1,59 @@
+/**
+ * `GET /api/routes` — the URL to handler map, when the project has one.
+ *
+ * The engine's routing manifest is a flat list of (url, handler, file, line)
+ * rows; it deliberately carries no node ids, because its own consumer (the MCP
+ * context builder) renders text. A reader needs to *navigate*, so each entry is
+ * matched back to its handler's node id here — batched by file, never a lookup
+ * per route.
+ *
+ * `null` from the engine means "fewer than three real routes", i.e. this
+ * project is not a routed app. That is reported as an empty manifest with
+ * `routed: false` rather than as an error: "this isn't a web app" is an
+ * answer, not a failure.
+ *
+ * Two things about the manifest shape the numbers here have to work around.
+ * Its `limit` is applied in SQL *before* the three-route test, so asking for
+ * fewer than three would make every routed project look unrouted — hence the
+ * floor on the parameter. And its own `totalRoutes` counts only the rows inside
+ * that window, so the headline count comes from the graph's `route` nodes
+ * instead, which is the number a reader means by "how many routes are there".
+ */
+import type { CodeGraph } from '../../index';
+/** One row of the URL → handler map. */
+export interface WireRoute {
+    /** The route node's name, verbatim: "POST /v1/users/{id}". */
+    url: string;
+    /** The verb, when the name leads with one. Null for file-routed pages. */
+    method: string | null;
+    /** The URL without the verb — the same string as `url` when there is none. */
+    path: string;
+    handler: string;
+    handlerKind: string;
+    /** Where the request is SERVED. */
+    file: string;
+    line: number;
+    handlerId: string | null;
+    /** Where the URL is REGISTERED — the router file, which is how routes group. */
+    routeFile: string;
+    routeLine: number;
+    routeId: string;
+}
+export interface WireRoutes {
+    routed: boolean;
+    /** Every URL the index holds, whether or not its handler resolved. */
+    routeCount: number;
+    /** Rows in `entries` — the ones whose handler the manifest could name. */
+    shown: number;
+    truncated: boolean;
+    topHandlerFile: string | null;
+    topHandlerFileCount: number;
+    entries: WireRoute[];
+}
+/** "POST /v1/users" -> { method: 'POST', path: '/v1/users' }. */
+export declare function splitRouteName(url: string): {
+    method: string | null;
+    path: string;
+};
+export declare function buildRoutes(cg: CodeGraph, query: URLSearchParams): WireRoutes;
+//# sourceMappingURL=routes.d.ts.map

package/dist/ui-server/api/routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routes.d.ts","sourceRoot":"","sources":["../../../src/ui-server/api/routes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAkB7C,wCAAwC;AACxC,MAAM,WAAW,SAAS;IACxB,8DAA8D;IAC9D,GAAG,EAAE,MAAM,CAAC;IACZ,0EAA0E;IAC1E,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,mCAAmC;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,gFAAgF;IAChF,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,sEAAsE;IACtE,UAAU,EAAE,MAAM,CAAC;IACnB,0EAA0E;IAC1E,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,CAAC;IACnB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,mBAAmB,EAAE,MAAM,CAAC;IAC5B,OAAO,EAAE,SAAS,EAAE,CAAC;CACtB;AAED,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAMnF;AAYD,wBAAgB,WAAW,CAAC,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,eAAe,GAAG,UAAU,CA2D7E"}

package/dist/ui-server/api/routes.js

@@ -0,0 +1,112 @@
+"use strict";
+/**
+ * `GET /api/routes` — the URL to handler map, when the project has one.
+ *
+ * The engine's routing manifest is a flat list of (url, handler, file, line)
+ * rows; it deliberately carries no node ids, because its own consumer (the MCP
+ * context builder) renders text. A reader needs to *navigate*, so each entry is
+ * matched back to its handler's node id here — batched by file, never a lookup
+ * per route.
+ *
+ * `null` from the engine means "fewer than three real routes", i.e. this
+ * project is not a routed app. That is reported as an empty manifest with
+ * `routed: false` rather than as an error: "this isn't a web app" is an
+ * answer, not a failure.
+ *
+ * Two things about the manifest shape the numbers here have to work around.
+ * Its `limit` is applied in SQL *before* the three-route test, so asking for
+ * fewer than three would make every routed project look unrouted — hence the
+ * floor on the parameter. And its own `totalRoutes` counts only the rows inside
+ * that window, so the headline count comes from the graph's `route` nodes
+ * instead, which is the number a reader means by "how many routes are there".
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.splitRouteName = splitRouteName;
+exports.buildRoutes = buildRoutes;
+const respond_1 = require("./respond");
+const wire_1 = require("./wire");
+/**
+ * HTTP verbs a route name may lead with, plus the two stand-ins the resolvers
+ * emit when the registration names no verb (`mux.Handle`, `app.use`).
+ *
+ * The split is done against this list rather than against "the first word" so
+ * a file-routed page (`/blog/[slug]`) or a message-bus subscription keeps its
+ * whole name in the URL column instead of losing its first segment to a
+ * method column that was never there.
+ */
+const HTTP_METHODS = new Set([
+    'GET', 'POST', 'PUT', 'PATCH', 'DELETE', 'HEAD', 'OPTIONS', 'TRACE', 'CONNECT',
+    'ANY', 'ALL', 'USE',
+]);
+/** "POST /v1/users" -> { method: 'POST', path: '/v1/users' }. */
+function splitRouteName(url) {
+    const space = url.indexOf(' ');
+    if (space <= 0)
+        return { method: null, path: url };
+    const head = url.slice(0, space);
+    if (!HTTP_METHODS.has(head.toUpperCase()))
+        return { method: null, path: url };
+    return { method: head.toUpperCase(), path: url.slice(space + 1).trimStart() };
+}
+/** Distinct handler files we will resolve node ids for. */
+const MAX_HANDLER_FILES = 60;
+/**
+ * The engine needs three surviving rows to call a project routed, and applies
+ * `limit` before that test — so anything below three is a question that cannot
+ * be answered truthfully rather than a small page.
+ */
+const MIN_LIMIT = 3;
+function buildRoutes(cg, query) {
+    const limit = (0, respond_1.intParam)(query, 'limit', { min: MIN_LIMIT, max: 500, default: 200 });
+    // One row over the limit, purely to learn whether there were more.
+    const manifest = cg.getRoutingManifest(limit + 1);
+    const routeCount = cg.getStats().nodesByKind.route ?? 0;
+    if (!manifest) {
+        return {
+            routed: false,
+            routeCount,
+            shown: 0,
+            truncated: false,
+            topHandlerFile: null,
+            topHandlerFileCount: 0,
+            entries: [],
+        };
+    }
+    const truncated = manifest.entries.length > limit;
+    const rows = manifest.entries.slice(0, limit);
+    // One `getNodesInFile` per distinct handler file — typically one or two, and
+    // capped so a project that scatters handlers across hundreds of files cannot
+    // turn one request into hundreds of queries.
+    const handlerFiles = [...new Set(rows.map((e) => e.handlerFile))].slice(0, MAX_HANDLER_FILES);
+    const byFileLineName = new Map();
+    for (const file of handlerFiles) {
+        for (const node of cg.getNodesInFile(file)) {
+            // Keyed on what the manifest actually knows: file, line and name. Two
+            // symbols can share a line (a decorator and its method); the name breaks
+            // the tie, and a miss simply leaves that entry unlinked.
+            byFileLineName.set(`${node.filePath} ${node.startLine} ${node.name}`, node.id);
+        }
+    }
+    const entries = rows.map((entry) => ({
+        url: entry.url,
+        ...splitRouteName(entry.url),
+        handler: entry.handler,
+        handlerKind: entry.handlerKind,
+        file: (0, wire_1.toPosixPath)(entry.handlerFile),
+        line: entry.handlerLine,
+        handlerId: byFileLineName.get(`${entry.handlerFile} ${entry.handlerLine} ${entry.handler}`) ?? null,
+        routeFile: (0, wire_1.toPosixPath)(entry.routeFile),
+        routeLine: entry.routeLine,
+        routeId: entry.routeId,
+    }));
+    return {
+        routed: true,
+        routeCount,
+        shown: entries.length,
+        truncated,
+        topHandlerFile: manifest.topHandlerFile ? (0, wire_1.toPosixPath)(manifest.topHandlerFile) : null,
+        topHandlerFileCount: manifest.topHandlerFileCount,
+        entries,
+    };
+}
+//# sourceMappingURL=routes.js.map

package/dist/ui-server/api/routes.js.map

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

package/dist/ui-server/api/screens.d.ts

@@ -0,0 +1,117 @@
+/**
+ * `GET /api/screens` — the app as a reader experiences it: screens, and the
+ * transitions between them, each labelled with what has to be true for it to
+ * happen.
+ *
+ * The graph already holds the pieces: a `route` node per screen file (Expo
+ * Router, and any framework that binds a route to the component that renders
+ * it), and a `navigates` edge from the function that pushes a path to the
+ * route it names. What a reader wants is neither of those nodes — it is
+ * "from the Home screen, tapping an object card opens Object Detail, but only
+ * for a collected object". That sentence is three hops away from the edge:
+ *
+ *   HomeScreen ─renders→ ItemsGrid ─renders→ ItemCard ─calls→ openObjectDetail ─navigates→ /object-detail
+ *
+ * So for every `navigates` edge this walks BACKWARDS from its source through
+ * `calls` edges (the JSX-render synthesizer's edges among them) until it
+ * reaches a component that a route renders. That component's screen is where
+ * the transition starts; the nodes passed on the way are the `via` chain, and
+ * the branch conditions at each call site along it (`graph/branch-guards.ts`)
+ * are joined into the link's `when`. A navigation whose walk reaches no screen
+ * within the hop cap — a store action, a service that runs after login — is
+ * kept as an `origin` rather than dropped: it is a real transition with a real
+ * trigger, just not a screen.
+ *
+ * Read from the graph at request time, never cached: the `when` labels are
+ * read from the source as it stands. Seventy-odd transitions and a few
+ * hundred guarded call sites resolve in tens of milliseconds.
+ */
+import type CodeGraph from '../../index';
+import { type WireNodeRef } from './wire';
+export interface WireScreen {
+    /** The route node's id — what a link's `from`/`to` name. */
+    id: string;
+    /** The screen's path: `/object-detail`, `/item/[id]`. */
+    path: string;
+    file: string;
+    line: number;
+    /** The component the route renders, when the graph bound one. */
+    component: WireNodeRef | null;
+    /** Transitions into and out of this screen. */
+    incoming: number;
+    outgoing: number;
+}
+/**
+ * A navigation whose start is not one screen: a function no screen reaches
+ * (a store action after login), or a component so many screens render (a
+ * top bar) that attributing its navigation to each of them would draw the
+ * same three arrows from every box.
+ */
+export interface WireScreenOrigin {
+    id: string;
+    node: WireNodeRef;
+    outgoing: number;
+    /** For shared chrome: how many screens render it. */
+    sharedBy?: number;
+}
+export interface WireScreenSite {
+    file: string;
+    line: number;
+    /** The href as written at the call, `${…}` for interpolations. */
+    href: string;
+    /** `push`, `replace`, `navigate`, or `return` for a helper's return value. */
+    method: string;
+    /**
+     * The conditions THIS site runs under — the whole chain's plus its own,
+     * joined; '' when unconditional. A link with several sites is several
+     * scenarios; the link's `when` is only their summary.
+     */
+    when: string;
+}
+export interface WireScreenLink {
+    id: string;
+    /** A screen id, or an origin id. */
+    from: string;
+    /** Always a screen id. */
+    to: string;
+    /** True when `from` is an origin, not a screen. */
+    fromOrigin: boolean;
+    /**
+     * The symbols the transition passes through, from just below the screen's
+     * component down to the one that holds the navigation call. Empty when the
+     * screen's own component navigates.
+     */
+    via: WireNodeRef[];
+    /** Conditions along the whole chain, joined; '' when unconditional. */
+    when: string;
+    /** Every call site behind this link (same screen, same chain end). */
+    sites: WireScreenSite[];
+    /**
+     * The destination was inferred, not written at the call: it came back from
+     * a helper's return value. (A synthesized render hop on the way — every
+     * parent → child component step is one — does not count: that would dash
+     * nearly every arrow.)
+     */
+    synthesized: boolean;
+}
+export interface WireScreensPayload {
+    /** False when the graph holds no screen navigation at all. */
+    routed: boolean;
+    /** The route named `/`, when there is one. */
+    entry: string | null;
+    screens: WireScreen[];
+    origins: WireScreenOrigin[];
+    links: WireScreenLink[];
+    /** Navigations dropped because the backwards walk hit a cap. */
+    dropped: number;
+    index: {
+        lastIndexedAt: number | null;
+        edges: number;
+        files: number;
+    };
+    timing: {
+        elapsedMs: number;
+    };
+}
+export declare function buildScreens(cg: CodeGraph, projectRoot: string): Promise<WireScreensPayload>;
+//# sourceMappingURL=screens.d.ts.map

package/dist/ui-server/api/screens.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"screens.d.ts","sourceRoot":"","sources":["../../../src/ui-server/api/screens.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAGH,OAAO,KAAK,SAAS,MAAM,aAAa,CAAC;AAMzC,OAAO,EAAa,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAMrD,MAAM,WAAW,UAAU;IACzB,4DAA4D;IAC5D,EAAE,EAAE,MAAM,CAAC;IACX,yDAAyD;IACzD,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,iEAAiE;IACjE,SAAS,EAAE,WAAW,GAAG,IAAI,CAAC;IAC9B,+CAA+C;IAC/C,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,WAAW,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,MAAM,EAAE,MAAM,CAAC;IACf;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,mDAAmD;IACnD,UAAU,EAAE,OAAO,CAAC;IACpB;;;;OAIG;IACH,GAAG,EAAE,WAAW,EAAE,CAAC;IACnB,uEAAuE;IACvE,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB;;;;;OAKG;IACH,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,kBAAkB;IACjC,8DAA8D;IAC9D,MAAM,EAAE,OAAO,CAAC;IAChB,8CAA8C;IAC9C,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,gBAAgB,EAAE,CAAC;IAC5B,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,gEAAgE;IAChE,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE;QAAE,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IACtE,MAAM,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/B;AAgGD,wBAAsB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAoMlG"}