dsh-gitnexus-plus 0.1.1 → 0.1.2

package/lib/gitnexus/search.js

@@ -0,0 +1,517 @@
+/**
+ * Keyword search over the graph GitNexus already indexed.
+ *
+ * WHY THIS DOES NOT USE FTS
+ * -------------------------
+ * GitNexus's keyword surface is its BM25/FTS extension. On this machine that
+ * extension fails to load (`libfts.lbug_extension` is missing), and the existing
+ * index was built with `--skip-fts`, so there are no FTS tables to query even if the
+ * extension were present. Reporting "search unavailable" would be honest, but it
+ * would also be the end of the feature for the state most users are in.
+ *
+ * The graph itself still contains every symbol's name and file path, and a Cypher
+ * `CONTAINS` over those columns answers the question the user is actually asking
+ * when they type a symbol name. This module therefore searches **names and paths**,
+ * not source text or descriptions. That distinction is deliberate and surfaced to
+ * the panel: an FTS repair can add content search later without this module
+ * pretending it already has it.
+ *
+ * READ-ONLY, AND REUSING GITNEXUS'S OWN ADAPTER
+ * ---------------------------------------------
+ * The database is opened through GitNexus's `withLbugDb(..., { readOnly: true,
+ * skipFts: true })`, so it takes no write lock, cannot mutate the index, and does not
+ * attempt the FTS load that is known to fail here. The adapter is deep-imported from
+ * the installed package, matching the plugin's existing "reuse, don't reimplement"
+ * stance; if the package or its native engine is unavailable, search reports that
+ * state rather than falling back to a filesystem scan with different semantics.
+ */
+import { existsSync } from 'node:fs';
+import fs from 'node:fs/promises';
+import path from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { findGitnexusRoot } from './root.js';
+import { isProjectRoot, readIndexMeta } from './index-meta.js';
+import { readCapabilities } from './coverage.js';
+export class SearchError extends Error {
+    code;
+    status;
+    constructor(code, status, message) {
+        super(message);
+        this.name = 'SearchError';
+        this.code = code;
+        this.status = status;
+    }
+}
+const adapters = new Map();
+/**
+ * Load GitNexus's LadybugDB adapter from the installed package.
+ *
+ * A missing package, a missing native engine, or a reshaped adapter all become the
+ * same reported state: search is unavailable here, and the reason is carried in the
+ * message rather than hidden behind an empty result list.
+ */
+async function loadAdapter(options) {
+    const root = findGitnexusRoot({ env: options.env, managedPrefix: options.managedPrefix });
+    if (root === null) {
+        throw new SearchError('search-unavailable', 503, '找不到 GitNexus 包，无法打开图数据库。安装或指向 GitNexus 后重试。');
+    }
+    const cached = adapters.get(root);
+    if (cached !== undefined)
+        return cached;
+    try {
+        const mod = (await import(pathToFileURL(path.join(root, 'dist', 'core', 'lbug', 'lbug-adapter.js')).href));
+        if (typeof mod.withLbugDb !== 'function' || typeof mod.executePrepared !== 'function') {
+            throw new Error('adapter does not export withLbugDb/executePrepared');
+        }
+        const adapter = {
+            withLbugDb: mod.withLbugDb,
+            executePrepared: mod.executePrepared,
+        };
+        adapters.set(root, adapter);
+        return adapter;
+    }
+    catch (cause) {
+        throw new SearchError('search-unavailable', 503, `GitNexus 的图数据库适配器不可用：${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+}
+/**
+ * Normalize a user keyword into a safe Cypher string literal body.
+ *
+ * The query is interpolated as a single-quoted literal because LadybugDB's prepare
+ * path does not accept a bound parameter in this `CONTAINS` position (measured:
+ * `lower(n.name) CONTAINS $q` fails at parse time, while the same query with a
+ * literal works). Safety therefore comes from **removing** every character that
+ * could terminate or escape the literal — quotes, backslashes and control
+ * characters — rather than from escaping them. The allowed set is what a code
+ * identifier or path search needs; everything else becomes a space.
+ *
+ * Case is lowered here to match `lower(n.name)` on the other side. The length cap
+ * keeps a pathological paste from turning into an expensive graph scan.
+ */
+export function sanitizeSearchQuery(raw) {
+    return raw
+        .normalize('NFC')
+        .toLowerCase()
+        .replace(/[^\p{L}\p{N}\s_./:@#+-]/gu, ' ')
+        .replace(/\s+/g, ' ')
+        .trim()
+        .slice(0, 80);
+}
+function clampLimit(value) {
+    const n = value === undefined || !Number.isFinite(value) ? 20 : Math.floor(value);
+    return Math.max(1, Math.min(50, n));
+}
+function toLine(value) {
+    if (typeof value === 'number' && Number.isFinite(value))
+        return Math.trunc(value);
+    if (typeof value === 'bigint')
+        return Number(value);
+    return null;
+}
+function buildCypher(query, limit) {
+    // `query` has already been reduced to the safe literal alphabet by
+    // sanitizeSearchQuery; the limit is a clamped integer. Neither is user-arbitrary
+    // syntax at this point.
+    return `
+MATCH (n)
+WHERE (lower(n.name) CONTAINS '${query}'
+       OR (label(n) = 'File' AND lower(n.filePath) CONTAINS '${query}'))
+RETURN label(n) AS kind, n.name AS name, n.filePath AS filePath,
+       n.startLine AS startLine, n.endLine AS endLine,
+       CASE WHEN lower(n.name) = '${query}' THEN 0
+            WHEN lower(n.name) STARTS WITH '${query}' THEN 1
+            WHEN label(n) = 'File' THEN 2
+            ELSE 3 END AS rank
+ORDER BY rank, name
+LIMIT ${limit}
+`;
+}
+function mapRows(rows) {
+    const results = [];
+    for (const value of rows) {
+        if (value === null || typeof value !== 'object')
+            continue;
+        const row = value;
+        const name = typeof row.name === 'string' ? row.name : '';
+        const filePath = typeof row.filePath === 'string' ? row.filePath : '';
+        if (name === '' || filePath === '')
+            continue;
+        results.push({
+            kind: typeof row.kind === 'string' && row.kind !== '' ? row.kind : 'Unknown',
+            name,
+            filePath,
+            startLine: toLine(row.startLine),
+            endLine: toLine(row.endLine),
+        });
+    }
+    return results;
+}
+function isBusyMessage(message) {
+    return /busy|locked|lock held|another process|timeout/i.test(message);
+}
+/**
+ * Search symbol names and file paths in one repository's index.
+ *
+ * @throws {SearchError} for states the route should report as status + code.
+ */
+export async function searchSymbols(repoPath, rawQuery, options = {}) {
+    const query = sanitizeSearchQuery(rawQuery);
+    if (query === '') {
+        throw new SearchError('invalid-query', 400, '搜索词不能为空，且至少包含一个字母或数字。');
+    }
+    const absRepo = path.resolve(repoPath);
+    if (!(await isProjectRoot(absRepo))) {
+        throw new SearchError('not-a-project', 404, '目录不是 GitNexus 索引，也不是 git 项目根。');
+    }
+    const meta = await readIndexMeta(absRepo);
+    if (meta === null) {
+        throw new SearchError('no-index', 409, '该项目还没有 GitNexus 索引；初始化后才能搜索。');
+    }
+    const lbugPath = path.join(absRepo, '.gitnexus', 'lbug');
+    if (!existsSync(lbugPath)) {
+        throw new SearchError('no-index-store', 409, '索引缺少 .gitnexus/lbug 图存储，无法搜索。');
+    }
+    const adapter = await loadAdapter(options);
+    const limit = clampLimit(options.limit);
+    const cypher = buildCypher(query, limit);
+    let rows;
+    try {
+        // `skipFts` avoids the extension load that is known to fail on this machine;
+        // `readOnly` keeps the search from taking a writer lock or creating anything.
+        rows = (await adapter.withLbugDb(lbugPath, async () => adapter.executePrepared(cypher, {}), { readOnly: true, skipFts: true }));
+    }
+    catch (cause) {
+        const message = cause instanceof Error ? cause.message : String(cause);
+        if (isBusyMessage(message)) {
+            throw new SearchError('index-busy', 503, '索引正被另一个 GitNexus 操作占用，稍后重试。');
+        }
+        throw new SearchError('search-failed', 500, `图查询失败：${message}`);
+    }
+    const results = mapRows(rows);
+    const capabilities = readCapabilities(meta.raw ?? null);
+    const ftsAvailable = capabilities.fts?.status === 'available';
+    return {
+        query,
+        mode: 'graph',
+        ftsAvailable,
+        results,
+        total: results.length,
+        truncated: results.length >= limit,
+        warning: ftsAvailable
+            ? null
+            : 'FTS 内容检索不可用；本次按符号名与文件路径匹配，不搜索正文。',
+    };
+}
+function quoteFor(value) {
+    return process.platform === 'win32'
+        ? `'${value.replace(/'/g, "''")}'`
+        : `'${value.replace(/'/g, "'\\''")}'`;
+}
+/**
+ * Parse the helper's one-object stdout without assuming it is the very first byte.
+ *
+ * GitNexus or Node can write a warning to stdout before our payload. Taking the
+ * first `{` to the last `}` is deliberately forgiving of that, while a missing
+ * object still becomes a typed failure rather than an empty result.
+ */
+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 searchErrorCode(value) {
+    switch (value) {
+        case 'invalid-query':
+        case 'not-a-project':
+        case 'no-index':
+        case 'no-index-store':
+        case 'search-unavailable':
+        case 'index-busy':
+        case 'search-failed':
+            return value;
+        default:
+            return 'search-failed';
+    }
+}
+function asReport(value) {
+    if (value === null || typeof value !== 'object')
+        return null;
+    const raw = value;
+    if (!Array.isArray(raw.results))
+        return null;
+    const results = [];
+    for (const item of raw.results) {
+        if (item === null || typeof item !== 'object')
+            continue;
+        const row = item;
+        if (typeof row.name !== 'string' || typeof row.filePath !== 'string')
+            continue;
+        results.push({
+            kind: typeof row.kind === 'string' ? row.kind : 'Unknown',
+            name: row.name,
+            filePath: row.filePath,
+            startLine: toLine(row.startLine),
+            endLine: toLine(row.endLine),
+        });
+    }
+    return {
+        query: typeof raw.query === 'string' ? raw.query : '',
+        mode: raw.mode === 'text' ? 'text' : 'graph',
+        ftsAvailable: raw.ftsAvailable === true,
+        results,
+        total: typeof raw.total === 'number' ? raw.total : results.length,
+        truncated: raw.truncated === true,
+        warning: typeof raw.warning === 'string' ? raw.warning : null,
+    };
+}
+/**
+ * Run the search in a child Node process.
+ *
+ * WHY A SUBPROCESS IS NOT OPTIONAL
+ * --------------------------------
+ * The DSH host runs on Electron's Node, and GitNexus's LadybugDB addon is built for
+ * the system Node ABI. Loading it in the host fails with
+ *
+ *   A dynamic link library (DLL) initialization routine failed. …\lbugjs.node
+ *
+ * while the very same addon loads under the system Node 24 that the CLI uses. The
+ * host therefore cannot own the native connection; it starts `node <helper>` and
+ * parses one JSON object. That is the same execution boundary the analyze runner
+ * already uses, and it keeps the panel process free of native state it cannot load.
+ *
+ * The command has no environment prefix: a short-lived helper does not need the
+ * heap respawn guard, and avoiding `$env:` syntax keeps the command portable across
+ * PowerShell, Git Bash and POSIX shells.
+ */
+export async function searchViaHelper(repoPath, rawQuery, options) {
+    const query = sanitizeSearchQuery(rawQuery);
+    if (query === '') {
+        throw new SearchError('invalid-query', 400, '搜索词不能为空，且至少包含一个字母或数字。');
+    }
+    const absRepo = path.resolve(repoPath);
+    if (!(await isProjectRoot(absRepo))) {
+        throw new SearchError('not-a-project', 404, '目录不是 GitNexus 索引，也不是 git 项目根。');
+    }
+    const meta = await readIndexMeta(absRepo);
+    if (meta === null) {
+        throw new SearchError('no-index', 409, '该项目还没有 GitNexus 索引；初始化后才能搜索。');
+    }
+    if (!existsSync(path.join(absRepo, '.gitnexus', 'lbug'))) {
+        throw new SearchError('no-index-store', 409, '索引缺少 .gitnexus/lbug 图存储，无法搜索。');
+    }
+    if (options.shell === null) {
+        throw new SearchError('search-unavailable', 503, '当前部署没有 shell 执行器，无法启动搜索子进程；搜索需要系统 Node 24 加载 GitNexus 原生模块。');
+    }
+    const limit = clampLimit(options.limit);
+    const args = [options.helperPath, absRepo, query, String(limit), options.managedPrefix ?? '']
+        .map(quoteFor)
+        .join(' ');
+    const command = `node ${args}`;
+    let result;
+    try {
+        const spec = options.shell.resolve({
+            command,
+            workdir: absRepo,
+            timeoutMs: 20_000,
+            onExpiry: 'kill',
+            stdoutMaxBytes: 2 * 1024 * 1024,
+        });
+        const execution = await options.shell.execute(spec);
+        result = await execution.result();
+    }
+    catch (cause) {
+        throw new SearchError('search-unavailable', 503, `无法启动搜索子进程：${cause instanceof Error ? cause.message : String(cause)}`);
+    }
+    if (result.timedOut === true) {
+        throw new SearchError('search-failed', 504, '搜索子进程超时（20 秒）。');
+    }
+    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 SearchError('search-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 SearchError(searchErrorCode(parsed.code), status, message);
+    }
+    const report = asReport(parsed.report);
+    if (report === null) {
+        throw new SearchError('search-failed', 500, '搜索子进程返回了无法识别的结果形状。');
+    }
+    return report;
+}
+const DEFAULT_TEXT_MAX_FILES = 2_000;
+const DEFAULT_TEXT_MAX_BYTES = 16 * 1024 * 1024;
+const DEFAULT_TEXT_MAX_FILE_BYTES = 1024 * 1024;
+/**
+ * Bounded keyword search over the source files listed by the index.
+ *
+ * This exists for one concrete state: the host cannot start the native query path
+ * (Electron ABI, no usable shell sandbox, busy database). In that state the index
+ * manifest still names every file the index covers, and reading those files is
+ * ordinary filesystem access the host already has. It is deliberately **not** a
+ * hidden replacement for the graph search:
+ *
+ *   - it searches line text, so `mode` is `text` and the panel says so;
+ *   - it only looks at files the index lists, so a brand-new untracked file is
+ *     still absent until the index is refreshed;
+ *   - every dimension is capped and `truncated` reports when a cap bit, because a
+ *     silent partial result is the failure mode this whole project exists to avoid.
+ *
+ * It performs no spawn, no native load and no write.
+ */
+export async function searchText(repoPath, rawQuery, options = {}) {
+    const query = rawQuery.normalize('NFC').trim().slice(0, 200);
+    if (query === '') {
+        throw new SearchError('invalid-query', 400, '搜索词不能为空。');
+    }
+    const absRepo = path.resolve(repoPath);
+    if (!(await isProjectRoot(absRepo))) {
+        throw new SearchError('not-a-project', 404, '目录不是 GitNexus 索引，也不是 git 项目根。');
+    }
+    const meta = await readIndexMeta(absRepo);
+    if (meta === null) {
+        throw new SearchError('no-index', 409, '该项目还没有 GitNexus 索引；初始化后才能搜索。');
+    }
+    const limit = clampLimit(options.limit);
+    const maxFiles = Math.max(1, Math.min(5_000, Math.floor(options.maxFiles ?? DEFAULT_TEXT_MAX_FILES)));
+    const maxBytes = Math.max(64 * 1024, Math.min(256 * 1024 * 1024, Math.floor(options.maxBytes ?? DEFAULT_TEXT_MAX_BYTES)));
+    const maxFileBytes = Math.max(8 * 1024, Math.min(16 * 1024 * 1024, Math.floor(options.maxFileBytes ?? DEFAULT_TEXT_MAX_FILE_BYTES)));
+    const requested = Object.keys(meta.fileHashes ?? {});
+    const warning = `图查询不可用${options.reason === undefined || options.reason.trim() === ''
+        ? ''
+        : `（${options.reason.trim().slice(0, 120)}）`}；已回退到索引文件的源码关键词搜索。结果来自文本，不是图谱。`;
+    if (requested.length === 0) {
+        return {
+            query,
+            mode: 'text',
+            ftsAvailable: false,
+            results: [],
+            total: 0,
+            truncated: false,
+            warning: `图查询不可用；索引清单没有文件列表，无法回退到源码搜索。`,
+        };
+    }
+    const lower = query.toLowerCase();
+    const results = [];
+    let bytesRead = 0;
+    let truncated = requested.length > maxFiles;
+    const prefix = absRepo.endsWith(path.sep) ? absRepo : `${absRepo}${path.sep}`;
+    // A keyword in a README should not fill the result limit before the source file
+    // that defines it. Code-bearing paths go first; path order breaks the tie.
+    const codePath = /\.(?:ts|tsx|js|jsx|mjs|cjs|py|java|go|rs|c|cc|cpp|h|hpp|cs|rb|php|kt|swift|dart|vue|sh|ps1|sql)$/iu;
+    const ordered = [...requested].sort((a, b) => {
+        const aCode = codePath.test(a) ? 1 : 0;
+        const bCode = codePath.test(b) ? 1 : 0;
+        return bCode - aCode || a.localeCompare(b);
+    });
+    for (const relative of ordered.slice(0, maxFiles)) {
+        if (results.length >= limit) {
+            truncated = true;
+            break;
+        }
+        if (relative.includes('\0'))
+            continue;
+        const absolute = path.resolve(absRepo, relative);
+        // The manifest is written by GitNexus, but it is still data at a boundary: do
+        // not let a `../` entry turn the fallback into a read outside the project.
+        if (!absolute.startsWith(prefix))
+            continue;
+        let size;
+        try {
+            size = (await fs.stat(absolute)).size;
+        }
+        catch {
+            continue;
+        }
+        if (size > maxFileBytes) {
+            truncated = true;
+            continue;
+        }
+        if (bytesRead + size > maxBytes) {
+            truncated = true;
+            break;
+        }
+        let buffer;
+        try {
+            buffer = await fs.readFile(absolute);
+        }
+        catch {
+            continue;
+        }
+        bytesRead += buffer.length;
+        // Binary files have no meaningful line text; git's own NUL-byte rule is enough.
+        if (buffer.subarray(0, 8192).includes(0))
+            continue;
+        const text = buffer.toString('utf8');
+        if (!text.toLowerCase().includes(lower))
+            continue;
+        const lines = text.split(/\r?\n/);
+        for (let index = 0; index < lines.length; index += 1) {
+            if (results.length >= limit) {
+                truncated = true;
+                break;
+            }
+            const line = lines[index];
+            if (!line.toLowerCase().includes(lower))
+                continue;
+            results.push({
+                kind: 'Text',
+                name: line.trim().slice(0, 160) || query,
+                filePath: relative.replace(/\\/g, '/'),
+                startLine: index + 1,
+                endLine: index + 1,
+            });
+        }
+    }
+    return {
+        query,
+        mode: 'text',
+        ftsAvailable: false,
+        results,
+        total: results.length,
+        truncated,
+        warning,
+    };
+}
+/** Failures for which the source fallback is more useful than an error card. */
+const FALLBACK_CODES = new Set([
+    'search-unavailable',
+    'search-failed',
+    'index-busy',
+    'no-index-store',
+]);
+/**
+ * Graph first, then the bounded source fallback when the native path cannot run.
+ *
+ * The fallback is not attempted for an empty query, an unidentified project, or a
+ * project with no index: in all three there is either nothing to search or no honest
+ * denominator. Every other failure gets the text search, and its report carries
+ * `mode: "text"` plus the graph failure in `warning`.
+ */
+export async function searchWithFallback(repoPath, rawQuery, options) {
+    try {
+        return await searchViaHelper(repoPath, rawQuery, options);
+    }
+    catch (error) {
+        if (error instanceof SearchError && FALLBACK_CODES.has(error.code)) {
+            return searchText(repoPath, rawQuery, {
+                limit: options.limit,
+                reason: error.message,
+            });
+        }
+        throw error;
+    }
+}
+//# sourceMappingURL=search.js.map

package/lib/gitnexus/search.js.map

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

package/lib/index.d.ts

@@ -1,22 +1,23 @@
 /**
- * dsh-gitnexus-plus 鈥?host half.
+ * dsh-gitnexus-plus —host half.
  *
  * Registers one read-only tool and one loopback HTTP route over the coverage
- * engine in `./gitnexus/`. Both answer the same question 鈥?"what did this index
- * leave out?" 鈥?for the two callers that need it: the model, and a browser half
+ * engine in `./gitnexus/`. Both answer the same question —"what did this index
+ * leave out?" —for the two callers that need it: the model, and a browser half
  * that will render it.
  *
- * Deliberately read-only. Nothing here triggers `analyze`, writes to `.gitnexus/`,
- * or takes the index lock; driving updates is a separate concern with its own
- * safety story, and mixing the two would mean a status check could start a
- * 30-second rebuild.
+ * The read path is still never allowed to change anything: a status check must not
+ * start a 30-second rebuild. The two mutating capabilities are separate routes with
+ * their own guards, and both go through the host's shell executor rather than
+ * spawning from the read path. Keyword search is a third read-only route over the
+ * graph itself; the tool above stays read-only.
  */
 import type { Context } from '@deepseek-ai/cordis';
 import { type MaintenanceCommand } from './gitnexus/commands.js';
 export declare const name = "gitnexus-plus";
 /**
  * Only `tools` is required. `webServer` is reached through `ctx.inject` because a
- * headless profile has no HTTP carrier at all 鈥?naming it here would leave the
+ * headless profile has no HTTP carrier at all —naming it here would leave the
  * plugin permanently pending there, and the tool would never register.
  */
 export declare const inject: readonly ["tools"];
@@ -26,10 +27,16 @@ export interface PluginConfig {
     minifiedSampleLimit: number;
     serveRoutes: boolean;
     /**
-     * Shapes the maintenance commands the panel hands to the operator. The defaults
-     * are the values measured to work inside a confined DSH process; a deployment
-     * that is not sandboxed can turn them off to get keyword search and a
-     * self-managed heap.
+     * Shapes the maintenance commands the panel hands to the operator. `memoryOff`
+     * defaults on because the CLI otherwise re-spawns itself over piped stdio, which
+     * a confined process denies.
+     *
+     * `skipFts: false` (default) means **automatic**: the plugin skips FTS when the
+     * index does not have it, and omits the flag when it does. Both static values were
+     * measured wrong on a real machine: `true` forces a 21x full rebuild on an FTS
+     * index, while an unconditional `false` makes a refresh on a non-FTS index die
+     * with `spawn EPERM` when the extension tries to install out-of-process. `true`
+     * here forces the flag for an operator who needs it.
      */
     skipFts: boolean;
     memoryOff: boolean;
@@ -50,6 +57,12 @@ export interface PluginConfig {
     gitnexusInstallDir: string;
     /** Wall-clock ceiling for that install. Compiling native modules is slow. */
     installTimeoutMs: number;
+    /**
+     * Redirect for GitNexus's global registry write. Empty means
+     * `<project>/.gitnexus/plugin-home`, inside the workspace. The global
+     * `~/.gitnexus` is outside a confined host's writable scope, and a refresh that
+     * dies on the registry write leaves the index incomplete.
+     */
     gitnexusHome: string;
 }
 export declare const Config: import("@deepseek-ai/schemastery").SchemaLike<{
@@ -68,10 +81,16 @@ export declare const Config: import("@deepseek-ai/schemastery").SchemaLike<{
 export interface MaintenanceInfo {
     commands: MaintenanceCommand[];
     rationale: string[];
+    /**
+     * Whether the mounted analyze route understands `force=1`. The client uses it to
+     * avoid offering a full-rebuild button against an older host, where that flag was
+     * ignored and the button would silently run an incremental refresh instead.
+     */
+    supportsForce: true;
 }
 export declare function apply(ctx: Context, config: PluginConfig): void;
 /**
- * Human-readable rendering lives in `./gitnexus/format.js` 鈥?free of DSH imports
+ * Human-readable rendering lives in `./gitnexus/format.js` —free of DSH imports
  * so it can be tested without a host. Re-exported here for callers that already
  * hold the plugin module.
  */

package/lib/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD,OAAO,EAAyC,KAAK,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAqBxG,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,MAAM,oBAAqB,CAAC;AAEzC,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;OAKG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAC;IACzB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,MAAM;;;;;;;;;;;EAWjB,CAAC;AAqBH,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAiBD,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CAuJ9D;AAED;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAGH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAKnD,OAAO,EAKL,KAAK,kBAAkB,EACxB,MAAM,wBAAwB,CAAC;AAuBhC,eAAO,MAAM,IAAI,kBAAkB,CAAC;AAEpC;;;;GAIG;AACH,eAAO,MAAM,MAAM,oBAAqB,CAAC;AAEzC,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,gBAAgB,EAAE,MAAM,CAAC;IACzB,mBAAmB,EAAE,MAAM,CAAC;IAC5B,WAAW,EAAE,OAAO,CAAC;IACrB;;;;;;;;;;;OAWG;IACH,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB;;;;;;;OAOG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;OAGG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,gBAAgB,EAAE,MAAM,CAAC;IACzB;;;;;OAKG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,eAAO,MAAM,MAAM;;;;;;;;;;;EAWjB,CAAC;AAqBH,oEAAoE;AACpE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,kBAAkB,EAAE,CAAC;IAC/B,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB;;;;OAIG;IACH,aAAa,EAAE,IAAI,CAAC;CACrB;AAiBD,wBAAgB,KAAK,CAAC,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,YAAY,GAAG,IAAI,CA+L9D;AAED;;;;GAIG;AACH,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}