codegraph-java 0.1.0

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

@@ -0,0 +1,81 @@
+/**
+ * The type hierarchy block on `/api/node` — ancestors up, subtypes down, and
+ * the fan an interface call dispatches into (design spec §3.10).
+ *
+ * The walk itself is `src/graph/type-hierarchy.ts`, shared with
+ * `codegraph_explore`'s interface-dispatch announcement so the two can never
+ * print different implementation counts for the same interface. This module is
+ * the renderer: it flattens the tree into rows the viewer can draw without
+ * measuring anything, and caps the fan while keeping the true totals.
+ *
+ * It rides on `/api/node` rather than sitting behind its own endpoint for the
+ * same reason `highlight` rides on `/api/source`: the block is part of the
+ * Symbol view's first paint, and a second round-trip would let the screen
+ * settle and then grow a tree above the code the reader had already started
+ * reading. The cost of carrying it is gated to types — `canHaveHierarchy` is a
+ * kind test, and the overwhelming majority of symbols a reader opens are
+ * functions.
+ */
+import type { CodeGraph } from '../../index';
+import type { Node } from '../../types';
+import { type HierarchyRelation } from '../../graph/type-hierarchy';
+import { type WireList, type WireNodeRef } from './wire';
+/** Subtype rows carried on the payload. The viewer folds long fans again at 12. */
+export declare const MAX_HIERARCHY_DESCENDANTS = 240;
+/** Supertype rows carried on the payload. A chain longer than this is generated code. */
+export declare const MAX_HIERARCHY_ANCESTORS = 24;
+/** One type in the tree: the ref, its place, and how it got there. */
+export interface WireHierarchyNode extends WireNodeRef {
+    /** Steps from the focus, in whichever direction the row sits. 1 = direct. */
+    depth: number;
+    /** The row this one hangs off — the focus's id at depth 1. */
+    parentId: string;
+    relation: HierarchyRelation;
+    /**
+     * The edge was synthesized rather than parsed — Go's implicit interface
+     * satisfaction is the common case. Drawn dashed, with `registeredAt` naming
+     * the wiring site, exactly as the Flow strip draws a synthesized hop.
+     */
+    synthesized: boolean;
+    via?: string;
+    registeredAt?: string;
+    /** Direct subtypes of this row that are NOT in the payload. */
+    hiddenSubtypes: number;
+}
+/** Everything the type-hierarchy block draws. */
+export interface WireHierarchy {
+    /** Supertypes, nearest first. */
+    ancestors: WireList<WireHierarchyNode>;
+    /** Subtypes, breadth-first: depth 1 is complete before depth 2 starts. */
+    descendants: WireList<WireHierarchyNode>;
+    /** True number of DIRECT subtypes, whatever `descendants` was capped to. */
+    direct: number;
+    /** Of `direct`, the ones tied by `implements` — what a call through the type reaches. */
+    implementers: number;
+    /** Subtypes exist below what the walk returned. */
+    bounded: boolean;
+    /** A call through this type dispatches at runtime rather than to one target. */
+    polymorphic: boolean;
+}
+/** A member of the focus that redeclares an ancestor's member. */
+export interface WireOverride {
+    /** The member it redeclares — open it to read what is being replaced. */
+    baseId: string;
+    baseTypeId: string;
+    baseTypeName: string;
+    /** `implements` reads as "satisfies", `extends` as "overrides". */
+    relation: HierarchyRelation;
+}
+/**
+ * Build the block, or `null` when there is nothing to draw.
+ *
+ * `null` is the answer for every function, and for a class that neither
+ * extends nor is extended — the viewer draws no empty tree and no "no
+ * hierarchy" note, because a class with no subtypes is the normal case and
+ * saying so on every screen is noise.
+ */
+export declare function buildHierarchy(cg: CodeGraph, node: Node): {
+    wire: WireHierarchy;
+    overrides: Map<string, WireOverride>;
+} | null;
+//# sourceMappingURL=hierarchy.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.d.ts","sourceRoot":"","sources":["../../../src/ui-server/api/hierarchy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAIL,KAAK,iBAAiB,EAEvB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAuB,KAAK,QAAQ,EAAE,KAAK,WAAW,EAAE,MAAM,QAAQ,CAAC;AAE9E,mFAAmF;AACnF,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAE7C,yFAAyF;AACzF,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,sEAAsE;AACtE,MAAM,WAAW,iBAAkB,SAAQ,WAAW;IACpD,6EAA6E;IAC7E,KAAK,EAAE,MAAM,CAAC;IACd,8DAA8D;IAC9D,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B;;;;OAIG;IACH,WAAW,EAAE,OAAO,CAAC;IACrB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+DAA+D;IAC/D,cAAc,EAAE,MAAM,CAAC;CACxB;AAED,iDAAiD;AACjD,MAAM,WAAW,aAAa;IAC5B,iCAAiC;IACjC,SAAS,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACvC,0EAA0E;IAC1E,WAAW,EAAE,QAAQ,CAAC,iBAAiB,CAAC,CAAC;IACzC,4EAA4E;IAC5E,MAAM,EAAE,MAAM,CAAC;IACf,yFAAyF;IACzF,YAAY,EAAE,MAAM,CAAC;IACrB,mDAAmD;IACnD,OAAO,EAAE,OAAO,CAAC;IACjB,gFAAgF;IAChF,WAAW,EAAE,OAAO,CAAC;CACtB;AAED,kEAAkE;AAClE,MAAM,WAAW,YAAY;IAC3B,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;IACrB,mEAAmE;IACnE,QAAQ,EAAE,iBAAiB,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,EAAE,EAAE,SAAS,EACb,IAAI,EAAE,IAAI,GACT;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,YAAY,CAAC,CAAA;CAAE,GAAG,IAAI,CAoCtE"}

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

@@ -0,0 +1,92 @@
+"use strict";
+/**
+ * The type hierarchy block on `/api/node` — ancestors up, subtypes down, and
+ * the fan an interface call dispatches into (design spec §3.10).
+ *
+ * The walk itself is `src/graph/type-hierarchy.ts`, shared with
+ * `codegraph_explore`'s interface-dispatch announcement so the two can never
+ * print different implementation counts for the same interface. This module is
+ * the renderer: it flattens the tree into rows the viewer can draw without
+ * measuring anything, and caps the fan while keeping the true totals.
+ *
+ * It rides on `/api/node` rather than sitting behind its own endpoint for the
+ * same reason `highlight` rides on `/api/source`: the block is part of the
+ * Symbol view's first paint, and a second round-trip would let the screen
+ * settle and then grow a tree above the code the reader had already started
+ * reading. The cost of carrying it is gated to types — `canHaveHierarchy` is a
+ * kind test, and the overwhelming majority of symbols a reader opens are
+ * functions.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_HIERARCHY_ANCESTORS = exports.MAX_HIERARCHY_DESCENDANTS = void 0;
+exports.buildHierarchy = buildHierarchy;
+const type_hierarchy_1 = require("../../graph/type-hierarchy");
+const wire_1 = require("./wire");
+/** Subtype rows carried on the payload. The viewer folds long fans again at 12. */
+exports.MAX_HIERARCHY_DESCENDANTS = 240;
+/** Supertype rows carried on the payload. A chain longer than this is generated code. */
+exports.MAX_HIERARCHY_ANCESTORS = 24;
+/**
+ * Build the block, or `null` when there is nothing to draw.
+ *
+ * `null` is the answer for every function, and for a class that neither
+ * extends nor is extended — the viewer draws no empty tree and no "no
+ * hierarchy" note, because a class with no subtypes is the normal case and
+ * saying so on every screen is noise.
+ */
+function buildHierarchy(cg, node) {
+    if (!(0, type_hierarchy_1.canHaveHierarchy)(node))
+        return null;
+    let hierarchy;
+    try {
+        hierarchy = (0, type_hierarchy_1.buildTypeHierarchy)(cg, node);
+    }
+    catch {
+        return null;
+    }
+    if (!hierarchy)
+        return null;
+    const ancestors = hierarchy.ancestors.slice(0, exports.MAX_HIERARCHY_ANCESTORS).map(toWireHierarchyNode);
+    const descendants = hierarchy.descendants
+        .slice(0, exports.MAX_HIERARCHY_DESCENDANTS)
+        .map(toWireHierarchyNode);
+    const overrides = new Map();
+    for (const [memberId, match] of hierarchy.overrides) {
+        overrides.set(memberId, {
+            baseId: match.baseId,
+            baseTypeId: match.baseTypeId,
+            baseTypeName: match.baseTypeName,
+            relation: match.relation,
+        });
+    }
+    return {
+        wire: {
+            ancestors: (0, wire_1.wireList)(ancestors, hierarchy.ancestors.length),
+            descendants: (0, wire_1.wireList)(descendants, hierarchy.descendants.length),
+            direct: hierarchy.directSubtypes,
+            implementers: hierarchy.directImplementers,
+            bounded: hierarchy.bounded,
+            polymorphic: hierarchy.polymorphic,
+        },
+        overrides,
+    };
+}
+function toWireHierarchyNode(entry) {
+    const meta = (entry.edge.metadata ?? {});
+    const wire = {
+        ...(0, wire_1.toNodeRef)(entry.node),
+        depth: entry.depth,
+        parentId: entry.parentId,
+        relation: entry.relation,
+        synthesized: entry.synthesized,
+        hiddenSubtypes: entry.hiddenSubtypes,
+    };
+    if (typeof meta.synthesizedBy === 'string')
+        wire.via = meta.synthesizedBy;
+    else if (typeof meta.via === 'string')
+        wire.via = meta.via;
+    if (typeof meta.registeredAt === 'string')
+        wire.registeredAt = meta.registeredAt;
+    return wire;
+}
+//# sourceMappingURL=hierarchy.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"hierarchy.js","sourceRoot":"","sources":["../../../src/ui-server/api/hierarchy.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAwEH,wCAuCC;AA3GD,+DAMoC;AACpC,iCAA8E;AAE9E,mFAAmF;AACtE,QAAA,yBAAyB,GAAG,GAAG,CAAC;AAE7C,yFAAyF;AAC5E,QAAA,uBAAuB,GAAG,EAAE,CAAC;AA+C1C;;;;;;;GAOG;AACH,SAAgB,cAAc,CAC5B,EAAa,EACb,IAAU;IAEV,IAAI,CAAC,IAAA,iCAAgB,EAAC,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC;IACzC,IAAI,SAA+B,CAAC;IACpC,IAAI,CAAC;QACH,SAAS,GAAG,IAAA,mCAAkB,EAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAC3C,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;IACD,IAAI,CAAC,SAAS;QAAE,OAAO,IAAI,CAAC;IAE5B,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,EAAE,+BAAuB,CAAC,CAAC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IACjG,MAAM,WAAW,GAAG,SAAS,CAAC,WAAW;SACtC,KAAK,CAAC,CAAC,EAAE,iCAAyB,CAAC;SACnC,GAAG,CAAC,mBAAmB,CAAC,CAAC;IAE5B,MAAM,SAAS,GAAG,IAAI,GAAG,EAAwB,CAAC;IAClD,KAAK,MAAM,CAAC,QAAQ,EAAE,KAAK,CAAC,IAAI,SAAS,CAAC,SAAS,EAAE,CAAC;QACpD,SAAS,CAAC,GAAG,CAAC,QAAQ,EAAE;YACtB,MAAM,EAAE,KAAK,CAAC,MAAM;YACpB,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,YAAY,EAAE,KAAK,CAAC,YAAY;YAChC,QAAQ,EAAE,KAAK,CAAC,QAAQ;SACzB,CAAC,CAAC;IACL,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,SAAS,EAAE,IAAA,eAAQ,EAAC,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,MAAM,CAAC;YAC1D,WAAW,EAAE,IAAA,eAAQ,EAAC,WAAW,EAAE,SAAS,CAAC,WAAW,CAAC,MAAM,CAAC;YAChE,MAAM,EAAE,SAAS,CAAC,cAAc;YAChC,YAAY,EAAE,SAAS,CAAC,kBAAkB;YAC1C,OAAO,EAAE,SAAS,CAAC,OAAO;YAC1B,WAAW,EAAE,SAAS,CAAC,WAAW;SACnC;QACD,SAAS;KACV,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAAC,KAAqB;IAChD,MAAM,IAAI,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,IAAI,EAAE,CAA4B,CAAC;IACpE,MAAM,IAAI,GAAsB;QAC9B,GAAG,IAAA,gBAAS,EAAC,KAAK,CAAC,IAAI,CAAC;QACxB,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,QAAQ,EAAE,KAAK,CAAC,QAAQ;QACxB,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,cAAc,EAAE,KAAK,CAAC,cAAc;KACrC,CAAC;IACF,IAAI,OAAO,IAAI,CAAC,aAAa,KAAK,QAAQ;QAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,aAAa,CAAC;SACrE,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ;QAAE,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC;IAC3D,IAAI,OAAO,IAAI,CAAC,YAAY,KAAK,QAAQ;QAAE,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACjF,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -0,0 +1,90 @@
+/**
+ * The read-only JSON API the viewer reads its screens from.
+ *
+ * Thirteen endpoints, one per screen, each answering in a single round-trip —
+ * the same principle as `codegraph_explore`: return enough that the caller does
+ * not have to ask a follow-up question — plus one that does not answer at all
+ * and stays open instead (`/api/events`), so a screen learns that its answer
+ * went stale rather than waiting to be asked again.
+ *
+ * All but one are *readers* of the existing schema; nothing here indexes or
+ * resolves. The exception is `/api/trails`, which saves the reader's own named
+ * walks as JSON under `.codegraph/ui/trails/` — the only write the viewer makes,
+ * to the only directory it may write to, and refused outright under
+ * `--read-only`. See `./trail-store.ts`.
+ *
+ * ```
+ * GET /api/stats                     what this index is and how much to trust it
+ * GET /api/search?q=                 the search palette
+ * GET /api/node/<id>                 the Symbol view: rails, members, hierarchy, tests, blast
+ * GET /api/nodes?id=&id=             names for ids you already have (the trail)
+ * GET /api/source?file=&from=&to=    verbatim source, with a drift verdict
+ * GET /api/file/<path>               the File view: outline and import rails
+ * GET /api/filecode/<path>           the whole-file view: ports, arcs, callee rail
+ * GET /api/routes                    the URL to handler map, when there is one
+ * GET /api/entrypoints               where to start reading: routes, roots, tests, hubs
+ * GET /api/map?root=&depth=          the module map: modules, links, cycles
+ * GET /api/deadcode                  symbols nothing reaches, and what was excluded
+ * GET /api/flow?from=&to=            the flow strip: one card per hop
+ * GET /api/events                    the live channel (SSE): drift and refresh
+ * GET /api/trails                    saved trails, re-resolved against the index
+ * POST /api/trails                   save one   (refused under --read-only)
+ * DELETE /api/trails/<id>            remove one (refused under --read-only)
+ * ```
+ *
+ * It mounts on the `api` seam of `startUiServer`, which means it sits *behind*
+ * the loopback boundary in `security.ts`: the `Host` allowlist, the absence of
+ * CORS headers and the method restriction are already enforced by the time a
+ * handler here runs — including the extra shape a write has to have. The one
+ * obligation that remains ours is the path chokepoint, `resolveProjectFile` for
+ * anything that touches the repository. Two modules here reach the filesystem
+ * and no others: `source.ts` reads the project's code, and `trail-store.ts`
+ * reads and writes `.codegraph/ui/trails/`.
+ */
+import type { UiApiHandler } from '../index';
+export { GraphSession } from './session';
+export { ApiError } from './respond';
+export * from './wire';
+export type { WireEntryPoints, WireEntryFile, WireEntryTest, WireEntryHub, } from './entrypoints';
+export type { WireRoute, WireRoutes } from './routes';
+export type { WireHierarchy, WireHierarchyNode, WireOverride } from './hierarchy';
+export { MAX_HIERARCHY_ANCESTORS, MAX_HIERARCHY_DESCENDANTS } from './hierarchy';
+export type { WireNodeRefs } from './nodes';
+export type { WireFlowPayload, WireFlow, WireFlowHop, WireFlowEdge, WireFlowSource, WireFlowCallRef, WireFlowAmbiguity, } from './flow';
+export type { WireFileCodePayload, WireFileCall, WireFileOutsideRef, } from './filecode';
+export { EventHub, MAX_EVENT_FILES, HEARTBEAT_MS } from './events';
+export type { WireEvent, WireEventHello, WireEventChanged, WireEventIndex, WireEventDegraded, WireIndexRevision, } from './events';
+export type { WireMapPayload, WireMapModule, WireMapLink, WireMapCycle, } from './map';
+export type { WireDeadCode, WireDeadCodeExclusion, WireDeadCodeGroup, WireDeadCodeRow, } from './deadcode';
+export { MAX_DEAD_CODE_MEMBERS, MAX_DEAD_CODE_ROWS } from './deadcode';
+export type { WireTrail, WireTrailHop, WireTrailHopStatus, WireTrails, SaveTrailRequest, TrailsOptions, } from './trails';
+export { buildTrails, encodeResolvedRun, resolveHop, resolveTrail } from './trails';
+export type { StoredHop, StoredTrail } from './trail-store';
+export { MAX_TRAILS, MAX_TRAIL_HOPS, MAX_TRAIL_NAME, MAX_TRAIL_NOTE, TRAILS_RELATIVE_DIR, TRAIL_FORMAT_VERSION, isTrailId, listStoredTrails, parseTrail, slugify, } from './trail-store';
+/**
+ * A mounted API, plus the handle it holds open.
+ *
+ * `close()` releases the index; the CLI calls it on Ctrl-C so the process does
+ * not exit with a live SQLite connection.
+ */
+export interface GraphApi {
+    handler: UiApiHandler;
+    close(): void;
+}
+export interface GraphApiOptions {
+    /** Absolute path of the indexed project to read. */
+    projectRoot: string;
+    /**
+     * Refuse every write, so the viewer is a pure reader again.
+     *
+     * The one thing it would otherwise write is a saved trail into
+     * `.codegraph/ui/trails/`. Turning this on is for a checkout that must not
+     * change (a review sandbox, a read-only mount, a shared machine); the viewer
+     * still lists trails that are already there, and says why Save is gone.
+     */
+    readOnly?: boolean;
+    /** The sentence shown in place of Save. Defaults to a generic one. */
+    readOnlyReason?: string;
+}
+export declare function createGraphApi(options: GraphApiOptions): GraphApi;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui-server/api/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAoB,MAAM,UAAU,CAAC;AAqB/D,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,cAAc,QAAQ,CAAC;AACvB,YAAY,EACV,eAAe,EACf,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,eAAe,CAAC;AACvB,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtD,YAAY,EAAE,aAAa,EAAE,iBAAiB,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,yBAAyB,EAAE,MAAM,aAAa,CAAC;AACjF,YAAY,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EACV,eAAe,EACf,QAAQ,EACR,WAAW,EACX,YAAY,EACZ,cAAc,EACd,eAAe,EACf,iBAAiB,GAClB,MAAM,QAAQ,CAAC;AAChB,YAAY,EACV,mBAAmB,EACnB,YAAY,EACZ,kBAAkB,GACnB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACnE,YAAY,EACV,SAAS,EACT,cAAc,EACd,gBAAgB,EAChB,cAAc,EACd,iBAAiB,EACjB,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAClB,YAAY,EACV,cAAc,EACd,aAAa,EACb,WAAW,EACX,YAAY,GACb,MAAM,OAAO,CAAC;AACf,YAAY,EACV,YAAY,EACZ,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,GAChB,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,qBAAqB,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AACvE,YAAY,EACV,SAAS,EACT,YAAY,EACZ,kBAAkB,EAClB,UAAU,EACV,gBAAgB,EAChB,aAAa,GACd,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AACpF,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,UAAU,EACV,cAAc,EACd,cAAc,EACd,cAAc,EACd,mBAAmB,EACnB,oBAAoB,EACpB,SAAS,EACT,gBAAgB,EAChB,UAAU,EACV,OAAO,GACR,MAAM,eAAe,CAAC;AAEvB;;;;;GAKG;AACH,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,IAAI,IAAI,CAAC;CACf;AAED,MAAM,WAAW,eAAe;IAC9B,oDAAoD;IACpD,WAAW,EAAE,MAAM,CAAC;IACpB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sEAAsE;IACtE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AA+ED,wBAAgB,cAAc,CAAC,OAAO,EAAE,eAAe,GAAG,QAAQ,CA8EjE"}

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

@@ -0,0 +1,332 @@
+"use strict";
+/**
+ * The read-only JSON API the viewer reads its screens from.
+ *
+ * Thirteen endpoints, one per screen, each answering in a single round-trip —
+ * the same principle as `codegraph_explore`: return enough that the caller does
+ * not have to ask a follow-up question — plus one that does not answer at all
+ * and stays open instead (`/api/events`), so a screen learns that its answer
+ * went stale rather than waiting to be asked again.
+ *
+ * All but one are *readers* of the existing schema; nothing here indexes or
+ * resolves. The exception is `/api/trails`, which saves the reader's own named
+ * walks as JSON under `.codegraph/ui/trails/` — the only write the viewer makes,
+ * to the only directory it may write to, and refused outright under
+ * `--read-only`. See `./trail-store.ts`.
+ *
+ * ```
+ * GET /api/stats                     what this index is and how much to trust it
+ * GET /api/search?q=                 the search palette
+ * GET /api/node/<id>                 the Symbol view: rails, members, hierarchy, tests, blast
+ * GET /api/nodes?id=&id=             names for ids you already have (the trail)
+ * GET /api/source?file=&from=&to=    verbatim source, with a drift verdict
+ * GET /api/file/<path>               the File view: outline and import rails
+ * GET /api/filecode/<path>           the whole-file view: ports, arcs, callee rail
+ * GET /api/routes                    the URL to handler map, when there is one
+ * GET /api/entrypoints               where to start reading: routes, roots, tests, hubs
+ * GET /api/map?root=&depth=          the module map: modules, links, cycles
+ * GET /api/deadcode                  symbols nothing reaches, and what was excluded
+ * GET /api/flow?from=&to=            the flow strip: one card per hop
+ * GET /api/events                    the live channel (SSE): drift and refresh
+ * GET /api/trails                    saved trails, re-resolved against the index
+ * POST /api/trails                   save one   (refused under --read-only)
+ * DELETE /api/trails/<id>            remove one (refused under --read-only)
+ * ```
+ *
+ * It mounts on the `api` seam of `startUiServer`, which means it sits *behind*
+ * the loopback boundary in `security.ts`: the `Host` allowlist, the absence of
+ * CORS headers and the method restriction are already enforced by the time a
+ * handler here runs — including the extra shape a write has to have. The one
+ * obligation that remains ours is the path chokepoint, `resolveProjectFile` for
+ * anything that touches the repository. Two modules here reach the filesystem
+ * and no others: `source.ts` reads the project's code, and `trail-store.ts`
+ * reads and writes `.codegraph/ui/trails/`.
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slugify = exports.parseTrail = exports.listStoredTrails = exports.isTrailId = exports.TRAIL_FORMAT_VERSION = exports.TRAILS_RELATIVE_DIR = exports.MAX_TRAIL_NOTE = exports.MAX_TRAIL_NAME = exports.MAX_TRAIL_HOPS = exports.MAX_TRAILS = exports.resolveTrail = exports.resolveHop = exports.encodeResolvedRun = exports.buildTrails = exports.MAX_DEAD_CODE_ROWS = exports.MAX_DEAD_CODE_MEMBERS = exports.HEARTBEAT_MS = exports.MAX_EVENT_FILES = exports.EventHub = exports.MAX_HIERARCHY_DESCENDANTS = exports.MAX_HIERARCHY_ANCESTORS = exports.ApiError = exports.GraphSession = void 0;
+exports.createGraphApi = createGraphApi;
+const security_1 = require("../security");
+const session_1 = require("./session");
+const respond_1 = require("./respond");
+const stats_1 = require("./stats");
+const search_1 = require("./search");
+const node_1 = require("./node");
+const source_1 = require("./source");
+const file_1 = require("./file");
+const filecode_1 = require("./filecode");
+const routes_1 = require("./routes");
+const entrypoints_1 = require("./entrypoints");
+const nodes_1 = require("./nodes");
+const map_1 = require("./map");
+const screens_1 = require("./screens");
+const steps_1 = require("./steps");
+const deadcode_1 = require("./deadcode");
+const flow_1 = require("./flow");
+const trails_1 = require("./trails");
+const events_1 = require("./events");
+var session_2 = require("./session");
+Object.defineProperty(exports, "GraphSession", { enumerable: true, get: function () { return session_2.GraphSession; } });
+var respond_2 = require("./respond");
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return respond_2.ApiError; } });
+__exportStar(require("./wire"), exports);
+var hierarchy_1 = require("./hierarchy");
+Object.defineProperty(exports, "MAX_HIERARCHY_ANCESTORS", { enumerable: true, get: function () { return hierarchy_1.MAX_HIERARCHY_ANCESTORS; } });
+Object.defineProperty(exports, "MAX_HIERARCHY_DESCENDANTS", { enumerable: true, get: function () { return hierarchy_1.MAX_HIERARCHY_DESCENDANTS; } });
+var events_2 = require("./events");
+Object.defineProperty(exports, "EventHub", { enumerable: true, get: function () { return events_2.EventHub; } });
+Object.defineProperty(exports, "MAX_EVENT_FILES", { enumerable: true, get: function () { return events_2.MAX_EVENT_FILES; } });
+Object.defineProperty(exports, "HEARTBEAT_MS", { enumerable: true, get: function () { return events_2.HEARTBEAT_MS; } });
+var deadcode_2 = require("./deadcode");
+Object.defineProperty(exports, "MAX_DEAD_CODE_MEMBERS", { enumerable: true, get: function () { return deadcode_2.MAX_DEAD_CODE_MEMBERS; } });
+Object.defineProperty(exports, "MAX_DEAD_CODE_ROWS", { enumerable: true, get: function () { return deadcode_2.MAX_DEAD_CODE_ROWS; } });
+var trails_2 = require("./trails");
+Object.defineProperty(exports, "buildTrails", { enumerable: true, get: function () { return trails_2.buildTrails; } });
+Object.defineProperty(exports, "encodeResolvedRun", { enumerable: true, get: function () { return trails_2.encodeResolvedRun; } });
+Object.defineProperty(exports, "resolveHop", { enumerable: true, get: function () { return trails_2.resolveHop; } });
+Object.defineProperty(exports, "resolveTrail", { enumerable: true, get: function () { return trails_2.resolveTrail; } });
+var trail_store_1 = require("./trail-store");
+Object.defineProperty(exports, "MAX_TRAILS", { enumerable: true, get: function () { return trail_store_1.MAX_TRAILS; } });
+Object.defineProperty(exports, "MAX_TRAIL_HOPS", { enumerable: true, get: function () { return trail_store_1.MAX_TRAIL_HOPS; } });
+Object.defineProperty(exports, "MAX_TRAIL_NAME", { enumerable: true, get: function () { return trail_store_1.MAX_TRAIL_NAME; } });
+Object.defineProperty(exports, "MAX_TRAIL_NOTE", { enumerable: true, get: function () { return trail_store_1.MAX_TRAIL_NOTE; } });
+Object.defineProperty(exports, "TRAILS_RELATIVE_DIR", { enumerable: true, get: function () { return trail_store_1.TRAILS_RELATIVE_DIR; } });
+Object.defineProperty(exports, "TRAIL_FORMAT_VERSION", { enumerable: true, get: function () { return trail_store_1.TRAIL_FORMAT_VERSION; } });
+Object.defineProperty(exports, "isTrailId", { enumerable: true, get: function () { return trail_store_1.isTrailId; } });
+Object.defineProperty(exports, "listStoredTrails", { enumerable: true, get: function () { return trail_store_1.listStoredTrails; } });
+Object.defineProperty(exports, "parseTrail", { enumerable: true, get: function () { return trail_store_1.parseTrail; } });
+Object.defineProperty(exports, "slugify", { enumerable: true, get: function () { return trail_store_1.slugify; } });
+/** What `GET /api` answers: the endpoint list, for anyone poking at it by hand. */
+const API_INDEX = {
+    name: 'cg ui',
+    /**
+     * Every endpoint but `/api/trails` is a pure read. Kept as a field rather
+     * than dropped, because it was `true` and something may be reading it; it is
+     * now the honest, narrower claim.
+     */
+    readOnly: false,
+    writes: ['POST /api/trails', 'DELETE /api/trails/<id>'],
+    endpoints: [
+        { path: '/api/stats', description: 'Index state, graph counts, detected frameworks.' },
+        { path: '/api/search', description: 'Ranked symbol search.', params: ['q', 'limit'] },
+        {
+            path: '/api/node/<id>',
+            description: 'One symbol: callers, callees, members, type hierarchy, tests, blast radius.',
+        },
+        { path: '/api/nodes', description: 'Names and locations for ids you already have.', params: ['id'] },
+        {
+            path: '/api/source',
+            description: 'Verbatim source for an indexed file, omitted when it has drifted on disk.',
+            params: ['file', 'from', 'to'],
+        },
+        { path: '/api/file/<path>', description: 'One file: outline and import rails.' },
+        {
+            path: '/api/filecode/<path>',
+            description: 'One file, line by line: call sites, unresolved references and the calls that stay inside it.',
+        },
+        { path: '/api/routes', description: 'URL to handler map, when the project is a routed app.', params: ['limit'] },
+        {
+            path: '/api/map',
+            description: 'The repository at module granularity: modules, cross-module links, cycles.',
+            params: ['root', 'depth'],
+        },
+        {
+            path: '/api/screens',
+            description: 'The app as screens and the transitions between them, each with the conditions it runs under.',
+            params: [],
+        },
+        {
+            path: '/api/steps',
+            description: 'What happens from a screen or a symbol: screens, handlers, native bridge calls and events, store writes and calls that leave the index, as typed steps with the conditions between them.',
+            params: ['anchor', 'symbol', 'depth', 'limit'],
+        },
+        {
+            path: '/api/flow',
+            description: 'The call path between symbols: one hop per card, opened at the calling line.',
+            params: ['from', 'to', 'symbols', 'hop', 'limit'],
+        },
+        {
+            path: '/api/events',
+            description: 'Live channel (server-sent events): source files that changed on disk, and the index moving.',
+        },
+        {
+            path: '/api/deadcode',
+            description: 'Symbols nothing in the index reaches, grouped by file, with every reason a candidate was excluded.',
+            params: ['limit', 'kinds', 'exported', 'tests', 'generated'],
+        },
+        {
+            path: '/api/entrypoints',
+            description: 'Where to start reading: routes, files that run something, and hubs.',
+            params: ['limit'],
+        },
+        {
+            path: '/api/trails',
+            description: 'Saved trails, each hop re-resolved against the current index. POST saves one, ' +
+                'DELETE /api/trails/<id> removes it. The only endpoint that writes.',
+        },
+    ],
+};
+function createGraphApi(options) {
+    const session = new session_1.GraphSession(options.projectRoot);
+    // Watches nothing until a browser subscribes, and stops again when the last
+    // one goes away — mounting the API costs no watch descriptors.
+    const events = new events_1.EventHub(options.projectRoot, session);
+    const trails = {
+        readOnly: options.readOnly === true,
+        readOnlyReason: options.readOnly === true
+            ? options.readOnlyReason ?? 'This viewer is running read-only, so trails cannot be saved.'
+            : null,
+    };
+    // Async because `/api/source` highlights: everything else answers straight
+    // out of SQLite and resolves on the same tick.
+    const handler = async (req, res, ctx) => {
+        const route = normalize(ctx.pathname);
+        try {
+            // Writes first: they are the only requests that carry a body, and
+            // routing them beside the readers would put a `case` that mutates in a
+            // switch every other arm of which is a query.
+            if (ctx.method === 'POST' || ctx.method === 'DELETE') {
+                return await dispatchWrite(route, req, res, ctx, session, trails);
+            }
+            switch (route) {
+                case '/api':
+                    return (0, respond_1.ok)(res, API_INDEX, ctx.method);
+                case '/api/stats':
+                    return (0, respond_1.ok)(res, (0, stats_1.buildStats)(session.acquire(), ctx.projectRoot), ctx.method);
+                case '/api/search':
+                    return (0, respond_1.ok)(res, (0, search_1.buildSearch)(session.acquire(), ctx.query), ctx.method);
+                case '/api/routes':
+                    return (0, respond_1.ok)(res, (0, routes_1.buildRoutes)(session.acquire(), ctx.query), ctx.method);
+                case '/api/map':
+                    return (0, respond_1.ok)(res, (0, map_1.buildMap)(session.acquire(), ctx.projectRoot, ctx.query), ctx.method);
+                case '/api/screens':
+                    return (0, respond_1.ok)(res, await (0, screens_1.buildScreens)(session.acquire(), ctx.projectRoot), ctx.method);
+                case '/api/steps':
+                    return (0, respond_1.ok)(res, await (0, steps_1.buildSteps)(session.acquire(), ctx.projectRoot, ctx.query), ctx.method);
+                case '/api/deadcode':
+                    return (0, respond_1.ok)(res, (0, deadcode_1.buildDeadCode)(session.acquire(), ctx.projectRoot, ctx.query), ctx.method);
+                case '/api/entrypoints':
+                    return (0, respond_1.ok)(res, (0, entrypoints_1.buildEntryPoints)(session.acquire(), ctx.query), ctx.method);
+                case '/api/trails':
+                    return (0, respond_1.ok)(res, (0, trails_1.buildTrails)(session.acquire(), ctx.projectRoot, trails), ctx.method);
+                case '/api/nodes':
+                    return (0, respond_1.ok)(res, (0, nodes_1.buildNodeRefs)(session.acquire(), ctx.query), ctx.method);
+                case '/api/source':
+                    return (0, respond_1.ok)(res, await (0, source_1.buildSource)(session.acquire(), ctx.projectRoot, ctx.query), ctx.method);
+                case '/api/flow':
+                    return (0, respond_1.ok)(res, await (0, flow_1.buildFlow)(session.acquire(), ctx.projectRoot, ctx.query), ctx.method);
+                case '/api/events':
+                    // Streams instead of answering: it writes its own headers and keeps
+                    // the socket open, so it never goes through `ok()`.
+                    return events.subscribe(req, res, ctx.method);
+                default:
+                    return await dispatchPathRoutes(route, res, ctx, session);
+            }
+        }
+        catch (err) {
+            // A refusal from the read chokepoint is a 403 with the reason attached —
+            // the request asked for something outside the project, and there is no
+            // version of it we would serve.
+            if (err instanceof security_1.PathRefusalError) {
+                return (0, respond_1.fail)(res, new respond_1.ApiError('refused', err.message), ctx.method);
+            }
+            return (0, respond_1.fail)(res, err, ctx.method);
+        }
+    };
+    return {
+        handler,
+        close: () => {
+            // Streams first: a client still attached would hold the socket open
+            // against the server's own close.
+            events.close();
+            session.close();
+        },
+    };
+}
+/**
+ * The write half: `/api/trails` and nothing else.
+ *
+ * Kept to one function so the answer to "what can this server change?" is one
+ * place a reviewer can read in full. Anything else that arrives with a write
+ * method is a 405 naming the endpoint that does accept one — by the time this
+ * runs, `isWriteRequest` has already established the request could not have
+ * been forged from another origin, so an unhelpfully vague refusal here would
+ * only confuse the person poking at their own API.
+ */
+async function dispatchWrite(route, req, res, ctx, session, trails) {
+    if (ctx.method === 'POST' && route === '/api/trails') {
+        const body = await (0, respond_1.readJsonBody)(req);
+        return (0, respond_1.ok)(res, (0, trails_1.saveTrail)(session.acquire(), ctx.projectRoot, body, trails), ctx.method);
+    }
+    if (ctx.method === 'DELETE') {
+        const id = suffixAfter(route, '/api/trails/');
+        if (id !== null && id !== '') {
+            return (0, respond_1.ok)(res, (0, trails_1.removeTrail)(session.acquire(), ctx.projectRoot, id, trails), ctx.method);
+        }
+        if (route === '/api/trails') {
+            throw (0, respond_1.badRequest)('Deleting a trail needs its id: DELETE /api/trails/<id>.');
+        }
+    }
+    res.setHeader('Allow', 'GET, HEAD');
+    throw new respond_1.ApiError('bad-request', `${ctx.method} ${route} is not something this server changes.`, 'The only endpoint that writes is /api/trails (POST to save, DELETE /api/trails/<id> to remove).');
+}
+/**
+ * The two endpoints that carry their argument in the path.
+ *
+ * `ctx.pathname` is already percent-decoded, so a node id or a file path
+ * containing `/` (`file:src/a.ts`) arrives whole — the remainder after the
+ * prefix IS the argument, slashes and all. Node ids are opaque: they go
+ * straight to an exact lookup, and anything that names nothing is a 404. File
+ * paths go through the read chokepoint before anything is opened.
+ */
+async function dispatchPathRoutes(route, res, ctx, session) {
+    const nodeId = suffixAfter(route, '/api/node/');
+    if (nodeId !== null) {
+        if (nodeId === '')
+            throw (0, respond_1.badRequest)('No symbol id was given. Use /api/node/<id>.');
+        return (0, respond_1.ok)(res, await (0, node_1.buildNode)(session.acquire(), ctx.projectRoot, nodeId), ctx.method);
+    }
+    // Before `/api/file/`: that prefix is not a prefix of this route, but keeping
+    // the more specific one first means adding another `/api/file…` sibling later
+    // cannot silently start matching the shorter one.
+    const codePath = suffixAfter(route, '/api/filecode/');
+    if (codePath !== null) {
+        return (0, respond_1.ok)(res, (0, filecode_1.buildFileCode)(session.acquire(), ctx.projectRoot, codePath), ctx.method);
+    }
+    const filePath = suffixAfter(route, '/api/file/');
+    if (filePath !== null) {
+        if (filePath === '')
+            throw (0, respond_1.badRequest)('No file path was given. Use /api/file/<path>.');
+        return (0, respond_1.ok)(res, (0, file_1.buildFile)(session.acquire(), ctx.projectRoot, filePath), ctx.method);
+    }
+    // `/api/node` and `/api/file` with no argument at all, so the message can say
+    // what the endpoint wants instead of falling through to a bare 404.
+    if (route === '/api/filecode') {
+        throw (0, respond_1.badRequest)('/api/filecode needs an argument: /api/filecode/<path>.');
+    }
+    if (route === '/api/node' || route === '/api/file') {
+        throw (0, respond_1.badRequest)(`${route} needs an argument: ${route}/<${route.endsWith('node') ? 'id' : 'path'}>.`);
+    }
+    throw (0, respond_1.notFound)(`No such endpoint: ${route}`, 'GET /api lists everything this server answers.');
+}
+/** Drop a single trailing slash, so `/api/stats/` and `/api/stats` are one route. */
+function normalize(pathname) {
+    return pathname.length > 4 && pathname.endsWith('/') ? pathname.slice(0, -1) : pathname;
+}
+function suffixAfter(route, prefix) {
+    return route.startsWith(prefix) ? route.slice(prefix.length) : null;
+}
+//# sourceMappingURL=index.js.map

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

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