dsh-gitnexus-plus 0.1.3 → 0.1.5

package/lib/gitnexus/graph.js

@@ -0,0 +1,474 @@
+/**
+ * Bounded graph projection for the panel's graph view.
+ *
+ * WHY A PROJECTION AND NOT CYPHER OVER HTTP
+ * -----------------------------------------
+ * The graph itself is the product here: it answers "what is in this index" better than
+ * any table. But a view that accepts Cypher from a browser turns a read-only panel into
+ * an arbitrary query endpoint over the user's code graph — and the roadmap's rule is a
+ * whitelist of projections, never raw forwarding. So this module exposes exactly two
+ * shapes:
+ *
+ *   `communities`  every community as a node, with aggregated cross-community edges
+ *   `community`    one community's member symbols and the relations among them
+ *
+ * Both are bounded by a node budget and an edge budget, and both report what they left
+ * out. A 93k-node repository must not be able to freeze the panel, and a view that
+ * silently drops half the graph is worse than one that says it did.
+ *
+ * WHERE THIS RUNS
+ * ---------------
+ * `projectGraph` talks to LadybugDB, so it can only run on the system Node — the host
+ * is Electron's Node and cannot load the native addon (see `search.ts`). The host calls
+ * `projectViaHelper`, which starts `lib/bin/graph-helper.js` and parses one JSON object,
+ * exactly like the search path. Keeping the query code in the helper process also means
+ * a query that crashes the native engine takes down a short-lived child, not the panel.
+ */
+import { existsSync, statSync } from 'node:fs';
+import path from 'node:path';
+import { isProjectRoot, readIndexMeta } from './index-meta.js';
+import { loadAdapter } from './search.js';
+export const GRAPH_VIEWS = ['communities', 'community'];
+export class GraphError extends Error {
+    code;
+    status;
+    constructor(code, status, message) {
+        super(message);
+        this.name = 'GraphError';
+        this.code = code;
+        this.status = status;
+    }
+}
+const DEFAULT_NODE_BUDGET = 220;
+const DEFAULT_EDGE_BUDGET = 800;
+/** The character set a node/community id is allowed to contain. */
+const ID_PATTERN = /^[\p{L}\p{N}_.:@/#+\-~ ]{1,200}$/u;
+/**
+ * Reduce a caller-supplied id to something safe inside a single-quoted Cypher literal.
+ *
+ * The id is interpolated rather than bound because LadybugDB's prepare path does not
+ * accept a parameter in every position this query needs (the same limitation `search.ts`
+ * documents for `CONTAINS`). Safety comes from **refusing** anything outside a known
+ * alphabet — quotes and backslashes cannot appear — rather than from escaping.
+ *
+ * @returns the id, or null when it is not acceptable
+ */
+export function sanitizeGraphId(raw) {
+    if (typeof raw !== 'string')
+        return null;
+    const trimmed = raw.trim();
+    if (trimmed === '')
+        return null;
+    return ID_PATTERN.test(trimmed) ? trimmed : null;
+}
+/** Whether a value names a projection this module implements. */
+export function isGraphView(value) {
+    return value === 'communities' || value === 'community';
+}
+function clampBudget(value, fallback, max) {
+    if (value === undefined || !Number.isFinite(value))
+        return fallback;
+    return Math.max(1, Math.min(max, Math.floor(value)));
+}
+function toLine(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return Math.trunc(value);
+    if (typeof value === 'bigint')
+        return Number(value);
+    return null;
+}
+function asString(value) {
+    return typeof value === 'string' ? value : '';
+}
+/** Rows from `executePrepared` are the driver's objects; narrow them field by field. */
+function rowsOf(value) {
+    return Array.isArray(value)
+        ? value.filter((row) => row !== null && typeof row === 'object')
+        : [];
+}
+/** One scalar `count(*)` result, defaulting to 0 when the shape is unexpected. */
+function countOf(value) {
+    const [first] = rowsOf(value);
+    const total = first === undefined ? undefined : first.total ?? first.count ?? Object.values(first)[0];
+    return typeof total === 'number' && Number.isFinite(total) ? total : 0;
+}
+/**
+ * Read one projection.
+ *
+ * @param repoPath absolute repository root
+ */
+export async function projectGraph(repoPath, options = {}) {
+    const absRepo = path.resolve(repoPath);
+    const view = options.view ?? 'communities';
+    if (!isGraphView(view)) {
+        throw new GraphError('invalid-view', 400, `未知的图视图：${String(options.view)}`);
+    }
+    const nodeBudget = clampBudget(options.nodeBudget, DEFAULT_NODE_BUDGET, 1000);
+    const edgeBudget = clampBudget(options.edgeBudget, DEFAULT_EDGE_BUDGET, 4000);
+    if (!(await isProjectRoot(absRepo))) {
+        throw new GraphError('not-a-project', 404, '目录不是 GitNexus 索引，也不是 git 项目根。');
+    }
+    const meta = await readIndexMeta(absRepo);
+    if (meta === null) {
+        throw new GraphError('no-index', 409, '该项目还没有 GitNexus 索引；初始化后才能看图。');
+    }
+    const lbugPath = path.join(absRepo, '.gitnexus', 'lbug');
+    if (!existsSync(lbugPath)) {
+        throw new GraphError('no-index-store', 409, '索引缺少 .gitnexus/lbug 图存储，无法读图。');
+    }
+    let scope = null;
+    const notes = [];
+    if (view === 'community') {
+        scope = sanitizeGraphId(options.id);
+        if (scope === null) {
+            throw new GraphError('invalid-id', 400, 'community 视图需要合法的 id 参数。');
+        }
+    }
+    // One adapter load per projection, and one connection for both the page of rows and
+    // its total. Reopening the store per query would double the cost of every drill-down.
+    let adapter;
+    try {
+        adapter = await loadAdapter({ env: options.env, managedPrefix: options.managedPrefix });
+    }
+    catch (cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        throw new GraphError('graph-unavailable', 503, `图数据库适配器不可用：${message}`);
+    }
+    const runQuery = async (cypher) => {
+        try {
+            return await adapter.withLbugDb(lbugPath, async () => adapter.executePrepared(cypher, {}), {
+                readOnly: true,
+                skipFts: true,
+            });
+        }
+        catch (cause) {
+            const message = cause instanceof Error ? cause.message : String(cause);
+            if (/busy|locked|lock held|another process|timeout/i.test(message)) {
+                throw new GraphError('index-busy', 503, '索引正被另一个 GitNexus 操作占用，稍后重试。');
+            }
+            throw new GraphError('graph-failed', 500, `图查询失败：${message}`);
+        }
+    };
+    const nodes = [];
+    const edges = [];
+    let total = 0;
+    if (view === 'communities') {
+        const communityRows = rowsOf(await runQuery(`MATCH (c:Community)
+         RETURN c.id AS id, c.label AS label, c.symbolCount AS symbolCount
+         ORDER BY symbolCount DESC
+         LIMIT ${nodeBudget}`));
+        total = countOf(await runQuery('MATCH (c:Community) RETURN count(*) AS total'));
+        for (const row of communityRows) {
+            const id = asString(row.id);
+            if (id === '')
+                continue;
+            const label = asString(row.label);
+            nodes.push({
+                id,
+                kind: 'Community',
+                name: label === '' ? id : label,
+                filePath: null,
+                startLine: null,
+                symbolCount: typeof row.symbolCount === 'number' ? row.symbolCount : 0,
+            });
+        }
+        // Cross-community edges are aggregated from the member-to-member relations: one
+        // edge per pair of communities per relation type. Two directions are collapsed
+        // (`ca.id < cb.id`) so the view does not draw every link twice.
+        const edgeRows = rowsOf(await runQuery(`MATCH (a)-[r:CodeRelation]->(b)
+         MATCH (a)-[:CodeRelation {type:'MEMBER_OF'}]->(ca:Community)
+         MATCH (b)-[:CodeRelation {type:'MEMBER_OF'}]->(cb:Community)
+         WHERE ca.id < cb.id
+         RETURN ca.id AS source, cb.id AS target, r.type AS type, count(*) AS weight
+         ORDER BY weight DESC
+         LIMIT ${edgeBudget}`));
+        for (const row of edgeRows) {
+            const source = asString(row.source);
+            const target = asString(row.target);
+            if (source === '' || target === '')
+                continue;
+            edges.push({
+                source,
+                target,
+                type: asString(row.type),
+                weight: typeof row.weight === 'number' ? row.weight : 1,
+            });
+        }
+    }
+    else {
+        const scopeLiteral = scope;
+        const memberRows = rowsOf(await runQuery(`MATCH (s)-[:CodeRelation {type:'MEMBER_OF'}]->(c:Community {id:'${scopeLiteral}'})
+         RETURN s.id AS id, label(s) AS kind, s.name AS name,
+                s.filePath AS filePath, s.startLine AS startLine
+         ORDER BY name
+         LIMIT ${nodeBudget}`));
+        total = countOf(await runQuery(`MATCH (s)-[:CodeRelation {type:'MEMBER_OF'}]->(c:Community {id:'${scopeLiteral}'})
+         RETURN count(*) AS total`));
+        for (const row of memberRows) {
+            const id = asString(row.id);
+            if (id === '')
+                continue;
+            const { name, filePath, startLine, kind } = row;
+            nodes.push({
+                id,
+                kind: asString(kind),
+                name: asString(name) === '' ? id : asString(name),
+                filePath: typeof filePath === 'string' && filePath !== '' ? filePath : null,
+                startLine: toLine(startLine),
+            });
+        }
+        const edgeRows = rowsOf(await runQuery(`MATCH (a)-[r:CodeRelation]->(b)
+         MATCH (a)-[:CodeRelation {type:'MEMBER_OF'}]->(c:Community {id:'${scopeLiteral}'})
+         MATCH (b)-[:CodeRelation {type:'MEMBER_OF'}]->(c)
+         RETURN a.id AS source, b.id AS target, r.type AS type, count(*) AS weight
+         ORDER BY weight DESC
+         LIMIT ${edgeBudget}`));
+        for (const row of edgeRows) {
+            const source = asString(row.source);
+            const target = asString(row.target);
+            if (source === '' || target === '')
+                continue;
+            edges.push({
+                source,
+                target,
+                type: asString(row.type),
+                weight: typeof row.weight === 'number' ? row.weight : 1,
+            });
+        }
+        if (total === 0 && nodes.length === 0) {
+            notes.push('该社区没有成员符号；索引可能是旧版本，或社区已被重新划分。');
+        }
+    }
+    // An edge whose endpoint fell outside the node budget cannot be drawn. Dropping it
+    // here keeps the client from having to special-case dangling ids, and the count is
+    // reported rather than silently swallowed.
+    const present = new Set(nodes.map((node) => node.id));
+    const kept = edges.filter((edge) => present.has(edge.source) && present.has(edge.target));
+    const droppedEdges = edges.length - kept.length;
+    if (droppedEdges > 0) {
+        notes.push(`${droppedEdges} 条边因端点超出节点预算未显示`);
+    }
+    const truncated = total > nodes.length || edges.length >= edgeBudget;
+    if (total > nodes.length) {
+        notes.push(view === 'communities'
+            ? `共 ${total} 个社区，显示符号数最多的 ${nodes.length} 个`
+            : `该社区共 ${total} 个符号，显示前 ${nodes.length} 个`);
+    }
+    if (edges.length >= edgeBudget) {
+        notes.push(`边达到上限 ${edgeBudget}，只保留了权重最高的部分`);
+    }
+    return {
+        view,
+        scope,
+        nodes,
+        edges: kept,
+        total,
+        truncated,
+        budget: { nodes: nodeBudget, edges: edgeBudget },
+        notes,
+        readAt: new Date().toISOString(),
+    };
+}
+function quoteFor(value) {
+    return process.platform === 'win32'
+        ? `'${value.replace(/'/g, "''")}'`
+        : `'${value.replace(/'/g, "'\\''")}'`;
+}
+function parseHelperOutput(text) {
+    const start = text.indexOf('{');
+    const end = text.lastIndexOf('}');
+    if (start < 0 || end <= start)
+        return null;
+    try {
+        const parsed = JSON.parse(text.slice(start, end + 1));
+        return parsed !== null && typeof parsed === 'object' ? parsed : null;
+    }
+    catch {
+        return null;
+    }
+}
+function graphErrorCode(value) {
+    switch (value) {
+        case 'invalid-view':
+        case 'invalid-id':
+        case 'not-a-project':
+        case 'no-index':
+        case 'no-index-store':
+        case 'graph-unavailable':
+        case 'index-busy':
+        case 'graph-failed':
+            return value;
+        default:
+            return 'graph-failed';
+    }
+}
+function asProjection(value) {
+    if (value === null || typeof value !== 'object')
+        return null;
+    const raw = value;
+    if (!Array.isArray(raw.nodes) || !Array.isArray(raw.edges))
+        return null;
+    if (!isGraphView(raw.view))
+        return null;
+    const nodes = [];
+    for (const item of raw.nodes) {
+        if (item === null || typeof item !== 'object')
+            continue;
+        const row = item;
+        if (typeof row.id !== 'string' || row.id === '')
+            continue;
+        nodes.push({
+            id: row.id,
+            kind: typeof row.kind === 'string' ? row.kind : 'Unknown',
+            name: typeof row.name === 'string' && row.name !== '' ? row.name : row.id,
+            filePath: typeof row.filePath === 'string' && row.filePath !== '' ? row.filePath : null,
+            startLine: toLine(row.startLine),
+            ...(typeof row.symbolCount === 'number' ? { symbolCount: row.symbolCount } : {}),
+        });
+    }
+    const edges = [];
+    for (const item of raw.edges) {
+        if (item === null || typeof item !== 'object')
+            continue;
+        const row = item;
+        if (typeof row.source !== 'string' || typeof row.target !== 'string')
+            continue;
+        edges.push({
+            source: row.source,
+            target: row.target,
+            type: typeof row.type === 'string' ? row.type : 'Related',
+            weight: typeof row.weight === 'number' && Number.isFinite(row.weight) ? row.weight : 1,
+        });
+    }
+    const budget = (raw.budget ?? {});
+    return {
+        view: raw.view,
+        scope: typeof raw.scope === 'string' ? raw.scope : null,
+        nodes,
+        edges,
+        total: typeof raw.total === 'number' ? raw.total : nodes.length,
+        truncated: raw.truncated === true,
+        budget: {
+            nodes: typeof budget.nodes === 'number' ? budget.nodes : nodes.length,
+            edges: typeof budget.edges === 'number' ? budget.edges : edges.length,
+        },
+        notes: Array.isArray(raw.notes) ? raw.notes.filter((note) => typeof note === 'string') : [],
+        readAt: typeof raw.readAt === 'string' ? raw.readAt : new Date().toISOString(),
+    };
+}
+/**
+ * Read a projection in a child Node process.
+ *
+ * Same execution boundary as `searchViaHelper`, for the same measured reason: the host
+ * cannot load `lbugjs.node`. A failure to start the child is reported as
+ * `graph-unavailable`, and this plugin never widens the sandbox to make it work.
+ */
+export async function projectViaHelper(repoPath, view, id, options) {
+    const absRepo = path.resolve(repoPath);
+    if (!(await isProjectRoot(absRepo))) {
+        throw new GraphError('not-a-project', 404, '目录不是 GitNexus 索引，也不是 git 项目根。');
+    }
+    const meta = await readIndexMeta(absRepo);
+    if (meta === null) {
+        throw new GraphError('no-index', 409, '该项目还没有 GitNexus 索引；初始化后才能看图。');
+    }
+    if (!existsSync(path.join(absRepo, '.gitnexus', 'lbug'))) {
+        throw new GraphError('no-index-store', 409, '索引缺少 .gitnexus/lbug 图存储，无法读图。');
+    }
+    if (options.shell === null) {
+        throw new GraphError('graph-unavailable', 503, '当前部署没有 shell 执行器，无法启动图投影子进程；读图需要系统 Node 加载 GitNexus 原生模块。');
+    }
+    const budgetNodes = clampBudget(options.nodeBudget, DEFAULT_NODE_BUDGET, 1000);
+    const budgetEdges = clampBudget(options.edgeBudget, DEFAULT_EDGE_BUDGET, 4000);
+    // A projection is a pure function of the index, the view, the id and the budgets, and
+    // producing it costs a Node cold start plus the native open. Switching communities and
+    // pressing re-read are common; the index mtime is part of the key, so a refresh
+    // invalidates without any cross-module wiring.
+    const cacheKey = projectionCacheKey(absRepo, view, id, budgetNodes, budgetEdges);
+    const cached = cacheKey === null ? undefined : projectionCache.get(cacheKey);
+    if (cached !== undefined && Date.now() - cached.at < PROJECTION_CACHE_TTL_MS) {
+        return cached.value;
+    }
+    const args = [
+        options.helperPath,
+        absRepo,
+        view,
+        id ?? '',
+        options.managedPrefix ?? '',
+        String(budgetNodes),
+        String(budgetEdges),
+    ]
+        .map(quoteFor)
+        .join(' ');
+    const command = `node ${args}`;
+    const sandboxPolicy = options.sandboxPolicy?.(path.join(absRepo, '.gitnexus'));
+    let result;
+    try {
+        const spec = options.shell.resolve({
+            command,
+            workdir: absRepo,
+            timeoutMs: 25_000,
+            onExpiry: 'kill',
+            stdoutMaxBytes: 4 * 1024 * 1024,
+            ...(sandboxPolicy === undefined ? {} : { sandboxPolicy }),
+        });
+        const execution = await options.shell.execute(spec);
+        result = await execution.result();
+    }
+    catch (cause) {
+        throw new GraphError('graph-unavailable', 503, `无法启动图投影子进程：${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+    if (result.timedOut === true) {
+        throw new GraphError('graph-failed', 504, '图投影子进程超时（25 秒）。');
+    }
+    const stdout = typeof result.stdout?.text === 'string' ? result.stdout.text : '';
+    const stderr = typeof result.stderr?.text === 'string' ? result.stderr.text : '';
+    const parsed = parseHelperOutput(stdout);
+    if (parsed === null) {
+        const tail = stderr.trim().slice(-600);
+        throw new GraphError('graph-failed', 500, `图投影子进程没有返回可解析结果${result.exitCode === undefined ? '' : ` (exit ${String(result.exitCode)})`}` + (tail === '' ? '' : `：${tail}`));
+    }
+    if (parsed.ok !== true) {
+        const status = typeof parsed.status === 'number' ? parsed.status : 500;
+        const message = typeof parsed.message === 'string' ? parsed.message : '读取图失败。';
+        throw new GraphError(graphErrorCode(parsed.code), status, message);
+    }
+    const projection = asProjection(parsed.projection);
+    if (projection === null) {
+        throw new GraphError('graph-failed', 500, '图投影子进程返回了无法识别的结果形状。');
+    }
+    if (cacheKey !== null)
+        rememberProjection(cacheKey, projection);
+    return projection;
+}
+/** How many projections to keep; each is bounded by the budgets, so this is small. */
+const PROJECTION_CACHE_MAX = 8;
+const PROJECTION_CACHE_TTL_MS = 60_000;
+const projectionCache = new Map();
+function rememberProjection(key, value) {
+    projectionCache.delete(key);
+    projectionCache.set(key, { at: Date.now(), value });
+    while (projectionCache.size > PROJECTION_CACHE_MAX) {
+        const oldest = projectionCache.keys().next().value;
+        if (oldest === undefined)
+            break;
+        projectionCache.delete(oldest);
+    }
+}
+/**
+ * Cache key for one projection, or `null` when the index cannot be statted.
+ *
+ * The index file's mtime is in the key: a refresh rewrites it, so a cached projection
+ * from before the refresh can never be served after it.
+ */
+function projectionCacheKey(repoPath, view, id, nodes, edges) {
+    try {
+        const metaFile = path.join(repoPath, '.gitnexus', 'gitnexus.json');
+        const mtime = statSync(metaFile).mtimeMs;
+        return [repoPath, view, id ?? '', nodes, edges, mtime].join('\u0000');
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=graph.js.map

package/lib/gitnexus/graph.js.map

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

package/lib/gitnexus/index-meta.d.ts

@@ -61,21 +61,49 @@ export declare function findRegistryEntry(target: string, options?: RegistryOpti
  * registry at all — and a plugin that refused to describe the user's own working
  * directory because a global file elsewhere had not heard of it would be wrong.
  * This is not by itself the route bound any more: a git project with no index still
- * has a readable working tree, so the routes use {@link isProjectRoot}, which
- * accepts either an index or a `.git` marker.
+ * has a readable working tree, so the routes that need a graph use
+ * {@link isProjectRoot}, which accepts either an index or a `.git` marker, and the
+ * scan/delta routes use {@link isExistingDirectory}, which also accepts a plain
+ * folder that GitNexus could index with `--skip-git`.
  */
 export declare function hasIndex(repoPath: string): Promise<boolean>;
 /**
- * Whether a directory is a project the routes may describe.
+ * Whether a directory carries a `.git` marker.
+ *
+ * `.git` may be a directory or a file (worktrees and submodules), so this checks
+ * existence rather than type. The distinction matters to the maintenance commands:
+ * GitNexus refuses to analyze a folder without a `.git` unless `--skip-git` is
+ * passed, and it reports the resulting index as having no commit baseline.
+ */
+export declare function hasGitMarker(repoPath: string): boolean;
+/**
+ * Whether a directory is a project the read routes may describe.
  *
  * Deliberately wider than {@link hasIndex}: a git repository with no index still has
  * a readable working tree, and both the scan-only coverage report and the initialize
  * action are for exactly that state. A directory with neither an index nor a `.git`
- * marker is refused, which is what keeps these routes from becoming a filesystem
- * probe. `.git` may be a directory or a file (worktrees and submodules), so this
- * checks existence rather than type.
+ * marker is refused by the routes that need git or a graph (search, graph, file
+ * history); the coverage and delta routes use {@link isExistingDirectory} instead,
+ * because GitNexus can index a plain folder with `--skip-git`.
  */
 export declare function isProjectRoot(repoPath: string): Promise<boolean>;
+/**
+ * Whether a path is an existing directory.
+ *
+ * This is the bound for the scan-only coverage report and the delta gate. The panel
+ * reports the working directory the operator is *in*, and that directory need not be
+ * a git repository: GitNexus indexes any folder with `--skip-git`, and the scan and
+ * the language breakdown need neither git nor an index. Refusing such a directory
+ * left the panel with a raw 404 and no numbers at all — the reported bug.
+ *
+ * This is still not a directory listing: the route describes exactly the path it is
+ * given and offers no way to browse a parent or a sibling. Filesystem roots are
+ * excluded by {@link isFilesystemRoot}, because scanning a whole drive is not a
+ * project report.
+ */
+export declare function isExistingDirectory(candidate: string): Promise<boolean>;
+/** Whether a path is a filesystem root (`D:\`, `/`, a UNC share root). */
+export declare function isFilesystemRoot(candidate: string): boolean;
 /** `indexCoverage` as the `analyze` that produced the index wrote it. */
 export interface RawIndexCoverage {
     maxFileSizeBytes?: unknown;

package/lib/gitnexus/index-meta.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index-meta.d.ts","sourceRoot":"","sources":["../../src/gitnexus/index-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAItE;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAa1F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAY/B;AAED;;;;;;;;;GASG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWjE;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAOtE;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,aAAa,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,uBAAuB,CAAC,EAAE,OAAO,EAAE,CAAC;IACpC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,mDAAmD;IACnD,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,iDAAiD;IACjD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,+BAA+B;IAC/B,GAAG,EAAE,gBAAgB,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA2C/E"}
+{"version":3,"file":"index-meta.d.ts","sourceRoot":"","sources":["../../src/gitnexus/index-meta.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAOH,+EAA+E;AAC/E,wBAAgB,SAAS,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAItE;AAED,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAED,8DAA8D;AAC9D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;CACnB;AAED;;;;;;;GAOG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,eAAoB,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAa1F;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAGlD;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,eAAoB,GAC5B,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAY/B;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAWjE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAMtD;AAED;;;;;;;;;GASG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAGtE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAsB,mBAAmB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAM7E;AAED,0EAA0E;AAC1E,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAG3D;AAED,yEAAyE;AACzE,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,gBAAgB;IAC/B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,UAAU,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC5C,aAAa,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACxC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACvC,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,gBAAgB,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACjC,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC1C,uBAAuB,CAAC,EAAE,OAAO,EAAE,CAAC;IACpC,yBAAyB,CAAC,EAAE,OAAO,CAAC;IACpC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,SAAS;IACxB,2DAA2D;IAC3D,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;IAClB,mCAAmC;IACnC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACnC,mDAAmD;IACnD,wBAAwB,EAAE,MAAM,GAAG,IAAI,CAAC;IACxC,iDAAiD;IACjD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,cAAc,CAAC;IAChC,+BAA+B;IAC/B,GAAG,EAAE,gBAAgB,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAsB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CA2C/E"}

package/lib/gitnexus/index-meta.js

@@ -74,8 +74,10 @@ export async function findRegistryEntry(target, options = {}) {
  * registry at all — and a plugin that refused to describe the user's own working
  * directory because a global file elsewhere had not heard of it would be wrong.
  * This is not by itself the route bound any more: a git project with no index still
- * has a readable working tree, so the routes use {@link isProjectRoot}, which
- * accepts either an index or a `.git` marker.
+ * has a readable working tree, so the routes that need a graph use
+ * {@link isProjectRoot}, which accepts either an index or a `.git` marker, and the
+ * scan/delta routes use {@link isExistingDirectory}, which also accepts a plain
+ * folder that GitNexus could index with `--skip-git`.
  */
 export async function hasIndex(repoPath) {
     const dir = path.join(repoPath, '.gitnexus');
@@ -91,25 +93,63 @@ export async function hasIndex(repoPath) {
     return false;
 }
 /**
- * Whether a directory is a project the routes may describe.
+ * Whether a directory carries a `.git` marker.
+ *
+ * `.git` may be a directory or a file (worktrees and submodules), so this checks
+ * existence rather than type. The distinction matters to the maintenance commands:
+ * GitNexus refuses to analyze a folder without a `.git` unless `--skip-git` is
+ * passed, and it reports the resulting index as having no commit baseline.
+ */
+export function hasGitMarker(repoPath) {
+    try {
+        return existsSync(path.join(repoPath, '.git'));
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Whether a directory is a project the read routes may describe.
  *
  * Deliberately wider than {@link hasIndex}: a git repository with no index still has
  * a readable working tree, and both the scan-only coverage report and the initialize
  * action are for exactly that state. A directory with neither an index nor a `.git`
- * marker is refused, which is what keeps these routes from becoming a filesystem
- * probe. `.git` may be a directory or a file (worktrees and submodules), so this
- * checks existence rather than type.
+ * marker is refused by the routes that need git or a graph (search, graph, file
+ * history); the coverage and delta routes use {@link isExistingDirectory} instead,
+ * because GitNexus can index a plain folder with `--skip-git`.
  */
 export async function isProjectRoot(repoPath) {
     if (await hasIndex(repoPath))
         return true;
+    return hasGitMarker(repoPath);
+}
+/**
+ * Whether a path is an existing directory.
+ *
+ * This is the bound for the scan-only coverage report and the delta gate. The panel
+ * reports the working directory the operator is *in*, and that directory need not be
+ * a git repository: GitNexus indexes any folder with `--skip-git`, and the scan and
+ * the language breakdown need neither git nor an index. Refusing such a directory
+ * left the panel with a raw 404 and no numbers at all — the reported bug.
+ *
+ * This is still not a directory listing: the route describes exactly the path it is
+ * given and offers no way to browse a parent or a sibling. Filesystem roots are
+ * excluded by {@link isFilesystemRoot}, because scanning a whole drive is not a
+ * project report.
+ */
+export async function isExistingDirectory(candidate) {
     try {
-        return existsSync(path.join(repoPath, '.git'));
+        return (await fs.stat(candidate)).isDirectory();
     }
     catch {
         return false;
     }
 }
+/** Whether a path is a filesystem root (`D:\`, `/`, a UNC share root). */
+export function isFilesystemRoot(candidate) {
+    const resolved = path.resolve(candidate);
+    return path.dirname(resolved) === resolved;
+}
 /**
  * Read the index manifest for a repository.
  *