codegraph-java 0.1.0

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

@@ -0,0 +1,163 @@
+/**
+ * `GET/POST/DELETE /api/trails` — saved trails, the reader's own tours through
+ * the graph (design spec §3.12).
+ *
+ * A trail is the path of symbols someone walked to explain something: "how a
+ * request is served", "everything the token expiry touches". The viewer already
+ * carries one in the URL; this is the same walk given a name and kept, so the
+ * next person — or the same person next week — starts at the explanation rather
+ * than at the search box.
+ *
+ * ## The one thing this feature has to get right
+ *
+ * **A trail must survive a re-index.** A node's id contains its start line, so
+ * inserting an import at the top of a file renames every symbol below it. A
+ * trail keyed on ids would break the first time anybody edited the code it
+ * describes — which is exactly when it matters. So a hop is stored as what it
+ * *is* — qualified name, kind, file — with the id kept only as a fast path, and
+ * every hop is re-resolved against the current index on the way out:
+ *
+ * - the recorded id still names the same symbol → `ok`
+ * - the qualified name resolves somewhere else → `moved`, and the row says
+ *   where from
+ * - the name is now carried by several symbols and none is in the recorded
+ *   file → `ambiguous`, best guess offered and labelled as one
+ * - nothing answers to it → `missing`, and the row says "moved or renamed"
+ *
+ * Nothing is silently dropped and nothing is silently guessed: a trail that has
+ * decayed says so on its own row, which is the point at which its author can
+ * fix it.
+ *
+ * ## What it opens
+ *
+ * A trail with a hole in it cannot be handed to the viewer whole — the `t`
+ * param is a PATH, and stitching hop 2 to hop 4 would draw an adjacency that
+ * does not exist. So the payload carries the longest run of consecutive
+ * resolved hops, and the row says when that is less than the whole trail.
+ *
+ * Storage — the only write `cg ui` makes — is `./trail-store.ts`.
+ */
+import type { CodeGraph } from '../../index';
+import { type StoredHop, type StoredHopDirection, type StoredTrail } from './trail-store';
+/** How a saved hop fared against the current index. */
+export type WireTrailHopStatus = 'ok' | 'moved' | 'ambiguous' | 'missing';
+export interface WireTrailHop {
+    dir: StoredHopDirection;
+    /** The name as it was when the trail was saved. */
+    name: string;
+    qualifiedName: string;
+    kind: string;
+    /** Where the symbol was when the trail was saved. */
+    savedFile: string;
+    savedLine: number;
+    status: WireTrailHopStatus;
+    /** The symbol's id NOW. Null when nothing answers to it any more. */
+    id: string | null;
+    file: string | null;
+    line: number | null;
+    /** Finished screen wording for a status that is not `ok`; null when it is. */
+    note: string | null;
+}
+export interface WireTrail {
+    id: string;
+    name: string;
+    note: string;
+    author: string;
+    createdAt: string;
+    updatedAt: string;
+    hops: WireTrailHop[];
+    /** Hops that still resolve to a symbol in this index. */
+    resolved: number;
+    /** Every hop resolved, and none of them moved. */
+    intact: boolean;
+    /**
+     * The longest run of CONSECUTIVE resolved hops, encoded as the `t` param.
+     * Null when nothing in the trail resolves. Never stitched across a hole: the
+     * trail is a path, and a fabricated adjacency is worse than a short one.
+     */
+    encoded: string | null;
+    /** 1-based index of the first hop `encoded` carries. */
+    openFrom: number;
+    /** How many hops `encoded` carries. */
+    openCount: number;
+    /** The symbol the trail opens at — the last hop of that run. */
+    openId: string | null;
+}
+export interface WireTrails {
+    trails: WireTrail[];
+    /** Writes are off. The viewer hides Save and Delete, and says why. */
+    readOnly: boolean;
+    readOnlyReason: string | null;
+    /** Project-relative directory the files live in. The screen names it. */
+    directory: string;
+    /** Files in that directory that were not readable trails. */
+    skipped: number;
+    /** The list stopped at {@link MAX_TRAILS}. */
+    bounded: boolean;
+    /** The id just written, on the answer to a POST. */
+    saved?: string;
+    /** That POST replaced a trail of the same name. */
+    replaced?: boolean;
+    /** The id just removed, on the answer to a DELETE. */
+    deleted?: string;
+}
+/**
+ * Re-resolve one saved hop against the index as it is now.
+ *
+ * Order matters: the recorded id first, because in the common case (nothing
+ * above the symbol changed) it is one lookup and exactly right. It is still
+ * verified against the qualified name — an id is a hash of position as well as
+ * identity, and a recycled one pointing at a different symbol would put a
+ * stranger in the middle of somebody's explanation.
+ */
+export declare function resolveHop(cg: CodeGraph, hop: StoredHop): WireTrailHop;
+/**
+ * Turn resolved hops into something the viewer can open.
+ *
+ * The longest CONSECUTIVE run, not every resolved hop: skipping a missing hop
+ * would encode a step from A to C that no edge supports, and the Flow strip
+ * reads a trail as exactly that sequence of edges. The first hop of the run is
+ * always written as `start`, because a run beginning mid-trail arrived from
+ * nothing the viewer can draw.
+ */
+export declare function encodeResolvedRun(hops: readonly WireTrailHop[]): {
+    encoded: string | null;
+    openFrom: number;
+    openCount: number;
+    openId: string | null;
+};
+export declare function resolveTrail(cg: CodeGraph, stored: StoredTrail): WireTrail;
+export interface TrailsOptions {
+    /** Writes refused, and the sentence saying why. */
+    readOnly: boolean;
+    readOnlyReason: string | null;
+}
+export declare function buildTrails(cg: CodeGraph, projectRoot: string, options: TrailsOptions): WireTrails;
+/** What a POST body has to be. Everything else about a hop comes from the graph. */
+export interface SaveTrailRequest {
+    name: string;
+    note?: string;
+    hops: Array<{
+        dir?: string;
+        id: string;
+    }>;
+}
+/**
+ * Save a trail.
+ *
+ * The client sends ids and directions and nothing else: the name, kind, file
+ * and line of every hop are read out of the index here. A client that supplied
+ * its own metadata could save a trail describing symbols that are not in the
+ * graph, and the whole value of the feature is that a trail is a claim the
+ * index can re-check.
+ *
+ * A save under a name that already exists REPLACES that trail, keeping its
+ * `createdAt`. That is what pressing Save with the same name means, and the
+ * answer says `replaced` so the screen can too.
+ */
+export declare function saveTrail(cg: CodeGraph, projectRoot: string, body: unknown, options: TrailsOptions): WireTrails;
+export declare function removeTrail(cg: CodeGraph, projectRoot: string, id: string, options: TrailsOptions): WireTrails;
+export declare function trailAuthor(projectRoot: string): string;
+/** Test seam: forget the cached author. */
+export declare function resetTrailAuthor(): void;
+//# sourceMappingURL=trails.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"trails.d.ts","sourceRoot":"","sources":["../../../src/ui-server/api/trails.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAIH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,OAAO,EAYL,KAAK,SAAS,EACd,KAAK,kBAAkB,EACvB,KAAK,WAAW,EACjB,MAAM,eAAe,CAAC;AAKvB,uDAAuD;AACvD,MAAM,MAAM,kBAAkB,GAAG,IAAI,GAAG,OAAO,GAAG,WAAW,GAAG,SAAS,CAAC;AAE1E,MAAM,WAAW,YAAY;IAC3B,GAAG,EAAE,kBAAkB,CAAC;IACxB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,qDAAqD;IACrD,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,qEAAqE;IACrE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;IAClB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,8EAA8E;IAC9E,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,YAAY,EAAE,CAAC;IACrB,yDAAyD;IACzD,QAAQ,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,MAAM,EAAE,OAAO,CAAC;IAChB;;;;OAIG;IACH,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,wDAAwD;IACxD,QAAQ,EAAE,MAAM,CAAC;IACjB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,gEAAgE;IAChE,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,SAAS,EAAE,CAAC;IACpB,sEAAsE;IACtE,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;IAC9B,yEAAyE;IACzE,SAAS,EAAE,MAAM,CAAC;IAClB,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC;IAChB,8CAA8C;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,oDAAoD;IACpD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,mDAAmD;IACnD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,sDAAsD;IACtD,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAID;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,GAAG,EAAE,SAAS,GAAG,YAAY,CA4DtE;AAUD;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,SAAS,YAAY,EAAE,GAAG;IAChE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB,CA4BA;AAED,wBAAgB,YAAY,CAAC,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,WAAW,GAAG,SAAS,CAe1E;AAID,MAAM,WAAW,aAAa;IAC5B,mDAAmD;IACnD,QAAQ,EAAE,OAAO,CAAC;IAClB,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B;AAED,wBAAgB,WAAW,CACzB,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,aAAa,GACrB,UAAU,CAUZ;AAID,oFAAoF;AACpF,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,KAAK,CAAC;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3C;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,SAAS,CACvB,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,IAAI,EAAE,OAAO,EACb,OAAO,EAAE,aAAa,GACrB,UAAU,CA+CZ;AAED,wBAAgB,WAAW,CACzB,EAAE,EAAE,SAAS,EACb,WAAW,EAAE,MAAM,EACnB,EAAE,EAAE,MAAM,EACV,OAAO,EAAE,aAAa,GACrB,UAAU,CAMZ;AA0DD,wBAAgB,WAAW,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,2CAA2C;AAC3C,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC"}

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

@@ -0,0 +1,369 @@
+"use strict";
+/**
+ * `GET/POST/DELETE /api/trails` — saved trails, the reader's own tours through
+ * the graph (design spec §3.12).
+ *
+ * A trail is the path of symbols someone walked to explain something: "how a
+ * request is served", "everything the token expiry touches". The viewer already
+ * carries one in the URL; this is the same walk given a name and kept, so the
+ * next person — or the same person next week — starts at the explanation rather
+ * than at the search box.
+ *
+ * ## The one thing this feature has to get right
+ *
+ * **A trail must survive a re-index.** A node's id contains its start line, so
+ * inserting an import at the top of a file renames every symbol below it. A
+ * trail keyed on ids would break the first time anybody edited the code it
+ * describes — which is exactly when it matters. So a hop is stored as what it
+ * *is* — qualified name, kind, file — with the id kept only as a fast path, and
+ * every hop is re-resolved against the current index on the way out:
+ *
+ * - the recorded id still names the same symbol → `ok`
+ * - the qualified name resolves somewhere else → `moved`, and the row says
+ *   where from
+ * - the name is now carried by several symbols and none is in the recorded
+ *   file → `ambiguous`, best guess offered and labelled as one
+ * - nothing answers to it → `missing`, and the row says "moved or renamed"
+ *
+ * Nothing is silently dropped and nothing is silently guessed: a trail that has
+ * decayed says so on its own row, which is the point at which its author can
+ * fix it.
+ *
+ * ## What it opens
+ *
+ * A trail with a hole in it cannot be handed to the viewer whole — the `t`
+ * param is a PATH, and stitching hop 2 to hop 4 would draw an adjacency that
+ * does not exist. So the payload carries the longest run of consecutive
+ * resolved hops, and the row says when that is less than the whole trail.
+ *
+ * Storage — the only write `cg ui` makes — is `./trail-store.ts`.
+ */
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveHop = resolveHop;
+exports.encodeResolvedRun = encodeResolvedRun;
+exports.resolveTrail = resolveTrail;
+exports.buildTrails = buildTrails;
+exports.saveTrail = saveTrail;
+exports.removeTrail = removeTrail;
+exports.trailAuthor = trailAuthor;
+exports.resetTrailAuthor = resetTrailAuthor;
+const child_process_1 = require("child_process");
+const os = __importStar(require("os"));
+const respond_1 = require("./respond");
+const trail_store_1 = require("./trail-store");
+const wire_1 = require("./wire");
+/* -------------------------------------------------------------- resolution -- */
+/**
+ * Re-resolve one saved hop against the index as it is now.
+ *
+ * Order matters: the recorded id first, because in the common case (nothing
+ * above the symbol changed) it is one lookup and exactly right. It is still
+ * verified against the qualified name — an id is a hash of position as well as
+ * identity, and a recycled one pointing at a different symbol would put a
+ * stranger in the middle of somebody's explanation.
+ */
+function resolveHop(cg, hop) {
+    const base = {
+        dir: hop.dir,
+        name: hop.name,
+        qualifiedName: hop.qualifiedName,
+        kind: hop.kind,
+        savedFile: hop.file,
+        savedLine: hop.line,
+    };
+    const byId = hop.id ? cg.getNode(hop.id) : null;
+    if (byId && matches(byId, hop)) {
+        return { ...base, status: 'ok', id: byId.id, file: byId.filePath, line: byId.startLine, note: null };
+    }
+    const candidates = cg
+        .getNodesByQualifiedName(hop.qualifiedName)
+        .filter((node) => hop.kind === '' || node.kind === hop.kind);
+    if (candidates.length === 0) {
+        return {
+            ...base,
+            status: 'missing',
+            id: null,
+            file: null,
+            line: null,
+            note: `no longer in the index — moved or renamed since this trail was saved`,
+        };
+    }
+    const sameFile = candidates.filter((node) => node.filePath === hop.file);
+    if (sameFile.length === 1) {
+        const node = sameFile[0];
+        return { ...base, status: 'ok', id: node.id, file: node.filePath, line: node.startLine, note: null };
+    }
+    if (candidates.length === 1) {
+        const node = candidates[0];
+        return {
+            ...base,
+            status: 'moved',
+            id: node.id,
+            file: node.filePath,
+            line: node.startLine,
+            note: `moved from ${hop.file || 'an unrecorded file'} to ${node.filePath}`,
+        };
+    }
+    // Several symbols carry this name and none of them is where it used to be.
+    // The best guess is offered — a row nobody can open is not more honest, it
+    // is just less useful — but it is labelled as a guess.
+    const pick = (sameFile[0] ?? candidates[0]);
+    return {
+        ...base,
+        status: 'ambiguous',
+        id: pick.id,
+        file: pick.filePath,
+        line: pick.startLine,
+        note: `${candidates.length} symbols now carry this name — showing the one in ${pick.filePath}`,
+    };
+}
+function matches(node, hop) {
+    if (hop.kind !== '' && node.kind !== hop.kind)
+        return false;
+    return node.qualifiedName === hop.qualifiedName || node.name === hop.name;
+}
+/** The `t` param's own encoding — kept identical to `ui/src/lib/trail-codec.ts`. */
+const DIR_CHAR = { start: 's', down: 'd', up: 'u' };
+/**
+ * Turn resolved hops into something the viewer can open.
+ *
+ * The longest CONSECUTIVE run, not every resolved hop: skipping a missing hop
+ * would encode a step from A to C that no edge supports, and the Flow strip
+ * reads a trail as exactly that sequence of edges. The first hop of the run is
+ * always written as `start`, because a run beginning mid-trail arrived from
+ * nothing the viewer can draw.
+ */
+function encodeResolvedRun(hops) {
+    let bestStart = -1;
+    let bestLength = 0;
+    let start = -1;
+    for (let i = 0; i <= hops.length; i += 1) {
+        const resolved = i < hops.length && hops[i].id !== null;
+        if (resolved) {
+            if (start < 0)
+                start = i;
+            continue;
+        }
+        if (start >= 0 && i - start > bestLength) {
+            bestStart = start;
+            bestLength = i - start;
+        }
+        start = -1;
+    }
+    if (bestLength === 0)
+        return { encoded: null, openFrom: 0, openCount: 0, openId: null };
+    const run = hops.slice(bestStart, bestStart + bestLength);
+    const encoded = run
+        .map((hop, index) => `${index === 0 ? 's' : DIR_CHAR[hop.dir]}${encodeURIComponent(hop.id)}`)
+        .join(',');
+    return {
+        encoded,
+        openFrom: bestStart + 1,
+        openCount: bestLength,
+        openId: run[run.length - 1].id,
+    };
+}
+function resolveTrail(cg, stored) {
+    const hops = stored.hops.map((hop) => resolveHop(cg, hop));
+    const run = encodeResolvedRun(hops);
+    return {
+        id: stored.id,
+        name: stored.name,
+        note: stored.note,
+        author: stored.author,
+        createdAt: stored.createdAt,
+        updatedAt: stored.updatedAt,
+        hops,
+        resolved: hops.filter((hop) => hop.id !== null).length,
+        intact: hops.every((hop) => hop.status === 'ok'),
+        ...run,
+    };
+}
+function buildTrails(cg, projectRoot, options) {
+    const { trails, skipped } = (0, trail_store_1.listStoredTrails)(projectRoot);
+    return {
+        trails: trails.map((stored) => resolveTrail(cg, stored)),
+        readOnly: options.readOnly,
+        readOnlyReason: options.readOnlyReason,
+        directory: trail_store_1.TRAILS_RELATIVE_DIR,
+        skipped,
+        bounded: trails.length >= trail_store_1.MAX_TRAILS,
+    };
+}
+/**
+ * Save a trail.
+ *
+ * The client sends ids and directions and nothing else: the name, kind, file
+ * and line of every hop are read out of the index here. A client that supplied
+ * its own metadata could save a trail describing symbols that are not in the
+ * graph, and the whole value of the feature is that a trail is a claim the
+ * index can re-check.
+ *
+ * A save under a name that already exists REPLACES that trail, keeping its
+ * `createdAt`. That is what pressing Save with the same name means, and the
+ * answer says `replaced` so the screen can too.
+ */
+function saveTrail(cg, projectRoot, body, options) {
+    if (options.readOnly)
+        throw readOnlyRefusal(options.readOnlyReason);
+    const request = parseSaveRequest(body);
+    const hops = [];
+    request.hops.forEach((hop, index) => {
+        const node = cg.getNode(hop.id);
+        if (!node) {
+            throw (0, respond_1.badRequest)(`Hop ${index + 1} is not in the index: ${hop.id}`, 'Trails are saved from symbols the index holds. Reload the page and walk the trail again.');
+        }
+        const ref = (0, wire_1.toNodeRef)(node);
+        hops.push({
+            dir: hop.dir === 'up' || hop.dir === 'down' ? hop.dir : 'start',
+            name: ref.name,
+            qualifiedName: ref.qualifiedName,
+            kind: ref.kind,
+            file: ref.file,
+            line: ref.line,
+            id: ref.id,
+        });
+    });
+    // The first hop is where the walk began, whatever the client called it.
+    if (hops[0])
+        hops[0].dir = 'start';
+    const existing = (0, trail_store_1.listStoredTrails)(projectRoot).trails;
+    const sameName = existing.find((trail) => trail.name === request.name);
+    const takenByOthers = new Set(existing.filter((trail) => trail.name !== request.name).map((trail) => trail.id));
+    const id = sameName ? sameName.id : (0, trail_store_1.uniqueTrailId)((0, trail_store_1.slugify)(request.name), takenByOthers);
+    const now = new Date().toISOString();
+    (0, trail_store_1.writeStoredTrail)(projectRoot, {
+        version: trail_store_1.TRAIL_FORMAT_VERSION,
+        id,
+        name: request.name,
+        note: request.note,
+        author: trailAuthor(projectRoot),
+        createdAt: sameName?.createdAt || now,
+        updatedAt: now,
+        hops,
+    });
+    return { ...buildTrails(cg, projectRoot, options), saved: id, replaced: sameName !== undefined };
+}
+function removeTrail(cg, projectRoot, id, options) {
+    if (options.readOnly)
+        throw readOnlyRefusal(options.readOnlyReason);
+    if (!(0, trail_store_1.deleteStoredTrail)(projectRoot, id)) {
+        throw (0, respond_1.notFound)(`There is no saved trail called "${id}".`);
+    }
+    return { ...buildTrails(cg, projectRoot, options), deleted: id };
+}
+function readOnlyRefusal(reason) {
+    return new respond_1.ApiError('refused', reason ?? 'This viewer is running read-only, so trails cannot be saved.', `Restart without --read-only to let the viewer write trails into ${trail_store_1.TRAILS_RELATIVE_DIR}.`);
+}
+function parseSaveRequest(body) {
+    if (typeof body !== 'object' || body === null || Array.isArray(body)) {
+        throw (0, respond_1.badRequest)('A trail is saved from a JSON object: { name, hops }.');
+    }
+    const value = body;
+    const name = typeof value.name === 'string' ? value.name.trim().replace(/\s+/g, ' ') : '';
+    if (name === '')
+        throw (0, respond_1.badRequest)('A saved trail needs a name.');
+    if (name.length > trail_store_1.MAX_TRAIL_NAME) {
+        throw (0, respond_1.badRequest)(`That name is too long (max ${trail_store_1.MAX_TRAIL_NAME} characters).`);
+    }
+    const note = typeof value.note === 'string' ? value.note.trim() : '';
+    if (note.length > trail_store_1.MAX_TRAIL_NOTE) {
+        throw (0, respond_1.badRequest)(`That note is too long (max ${trail_store_1.MAX_TRAIL_NOTE} characters).`);
+    }
+    if (!Array.isArray(value.hops) || value.hops.length === 0) {
+        throw (0, respond_1.badRequest)('A saved trail needs at least one hop.');
+    }
+    if (value.hops.length > trail_store_1.MAX_TRAIL_HOPS) {
+        throw (0, respond_1.badRequest)(`A saved trail can hold at most ${trail_store_1.MAX_TRAIL_HOPS} hops.`);
+    }
+    const hops = [];
+    for (const entry of value.hops) {
+        if (typeof entry !== 'object' || entry === null)
+            throw (0, respond_1.badRequest)('Each hop is { dir, id }.');
+        const hop = entry;
+        if (typeof hop.id !== 'string' || hop.id === '')
+            throw (0, respond_1.badRequest)('Each hop needs an id.');
+        hops.push({ id: hop.id, ...(typeof hop.dir === 'string' ? { dir: hop.dir } : {}) });
+    }
+    return { name, note, hops };
+}
+/* ---------------------------------------------------------------- author -- */
+/**
+ * Who to record as the author.
+ *
+ * Git's `user.name` first, because a trail is a thing one person wrote for
+ * others to read and that is the name they already sign work with in this
+ * project; the OS user is the fallback. Read ONCE per process — `git config` is
+ * a subprocess, and a save should not pay for it twice — and never sent
+ * anywhere: it goes into a file inside the user's own `.codegraph/`.
+ */
+let cachedAuthor = null;
+function trailAuthor(projectRoot) {
+    if (cachedAuthor !== null)
+        return cachedAuthor;
+    cachedAuthor = gitUserName(projectRoot) ?? osUserName() ?? '';
+    return cachedAuthor;
+}
+/** Test seam: forget the cached author. */
+function resetTrailAuthor() {
+    cachedAuthor = null;
+}
+function gitUserName(projectRoot) {
+    try {
+        const out = (0, child_process_1.execFileSync)('git', ['config', 'user.name'], {
+            cwd: projectRoot,
+            encoding: 'utf-8',
+            timeout: 2_000,
+            stdio: ['ignore', 'pipe', 'ignore'],
+        });
+        const name = out.trim();
+        return name === '' ? null : name.slice(0, 120);
+    }
+    catch {
+        // No git, no config, not a repository — all ordinary. Fall through.
+        return null;
+    }
+}
+function osUserName() {
+    try {
+        const name = os.userInfo().username.trim();
+        return name === '' ? null : name.slice(0, 120);
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=trails.js.map

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

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