pi-ghost-autocomplete 0.3.1

package/dist/index.js

@@ -0,0 +1,210 @@
+import { readConfigFromEnv } from "./config.js";
+import { GhostEditor } from "./ghost-editor.js";
+import { MetricsLogger, readMetricsConfigFromEnv } from "./metrics.js";
+import { buildPathIndex } from "./path-index.js";
+import { CloudProvider } from "./providers/cloud-provider.js";
+import { LocalProvider } from "./providers/local-provider.js";
+import { OpenAICompatProvider } from "./providers/openai-compat-provider.js";
+import { RaceProvider } from "./providers/race.js";
+const ghost = (pi) => {
+    const config = readConfigFromEnv();
+    pi.registerCommand("ghost", {
+        description: "Ghost autocomplete: status / toggle. Args: 'on' | 'off' | empty (status)",
+        handler: async (args, ctx) => {
+            const arg = args.trim().toLowerCase();
+            if (arg === "on") {
+                config.enabled = true;
+                ctx.ui.notify("Pi Ghost: enabled", "info");
+            }
+            else if (arg === "off") {
+                config.enabled = false;
+                ctx.ui.notify("Pi Ghost: disabled", "info");
+            }
+            else {
+                ctx.ui.notify(`Pi Ghost: ${config.enabled ? "enabled" : "disabled"}\n  ${describeProvider(config)}`, "info");
+            }
+        },
+    });
+    let activeEditor = null;
+    pi.on("session_start", async (_event, ctx) => {
+        if (!ctx.hasUI)
+            return;
+        const provider = await buildProvider(config, ctx);
+        const metricsCfg = readMetricsConfigFromEnv();
+        const metrics = metricsCfg.metricsEnabled || metricsCfg.debugEnabled
+            ? new MetricsLogger(ctx.cwd, metricsCfg)
+            : null;
+        const onError = makeOneShotNotifier(ctx);
+        let resolvedIndex = null;
+        ctx.ui.setEditorComponent((tui, theme, keybindings) => {
+            const editor = new GhostEditor(tui, theme, keybindings, ctx, config, provider, metrics, resolvedIndex, onError);
+            activeEditor = editor;
+            return editor;
+        });
+        ctx.ui.setStatus("ghost", provider ? `ghost:${provider.name.replace(/^ghost-/, "")}` : "ghost:off");
+        void buildPathIndex(ctx.cwd).then((idx) => {
+            resolvedIndex = idx;
+            activeEditor?.setPathIndex(idx);
+        });
+    });
+    pi.on("session_shutdown", async () => {
+        activeEditor?.dispose();
+        activeEditor = null;
+    });
+};
+async function buildProvider(config, ctx) {
+    if (!config.enabled)
+        return null;
+    if (config.provider.kind === "race") {
+        const members = [];
+        for (const m of config.provider.members) {
+            if (m.kind === "cloud") {
+                members.push(new CloudProvider(m));
+                continue;
+            }
+            if (m.kind === "openai-compat") {
+                members.push(new OpenAICompatProvider(m));
+                continue;
+            }
+            const local = new LocalProvider(m);
+            if (await local.preflight())
+                members.push(local);
+        }
+        if (members.length === 0) {
+            if (ctx.hasUI)
+                ctx.ui.notify("Pi Ghost: no race members available", "warning");
+            return null;
+        }
+        return new RaceProvider(members, {
+            pauseMs: config.provider.pauseMs,
+            cooldownMs: config.provider.cooldownMs,
+            cutoffMs: config.provider.cutoffMs,
+        });
+    }
+    if (config.provider.kind === "cloud") {
+        const p = new CloudProvider(config.provider);
+        return p;
+    }
+    if (config.provider.kind === "openai-compat") {
+        const p = new OpenAICompatProvider(config.provider);
+        void preflightAndWarn(p, ctx);
+        return p;
+    }
+    const p = new LocalProvider(config.provider);
+    const ok = await p.preflight();
+    if (!ok) {
+        if (ctx.hasUI)
+            ctx.ui.notify("Pi Ghost: local server unreachable, ghost disabled", "warning");
+        return null;
+    }
+    return p;
+}
+/**
+ * Fire-and-forget preflight for OpenAI-compat providers. The provider is
+ * returned to the caller immediately (so the session isn't blocked), and
+ * this runs in the background. On failure it surfaces a warning so the
+ * user knows their key/endpoint is misconfigured instead of wondering why
+ * nothing happens.
+ */
+async function preflightAndWarn(provider, ctx) {
+    try {
+        const result = await provider.preflight();
+        if (result.ok)
+            return;
+        if (ctx.hasUI) {
+            ctx.ui.notify(`Pi Ghost (${provider.name}): ${result.message}\n` +
+                "  File-path completions still work. LLM predictions disabled until resolved.\n" +
+                "  Run /ghost for current status.", "warning");
+        }
+    }
+    catch {
+        // Preflight itself must never break the session.
+    }
+}
+/**
+ * Returns a callback that notifies the user about the first API error
+ * encountered at runtime, then goes silent. Respects the design principle
+ * of not spamming the chat with repeated warnings.
+ */
+function makeOneShotNotifier(ctx) {
+    let fired = false;
+    return (err) => {
+        if (fired || !ctx.hasUI)
+            return;
+        fired = true;
+        ctx.ui.notify(`Pi Ghost: LLM request failed — ${err.message}\n` +
+            "  Further errors will be silent. Run /ghost for status.\n" +
+            "  Tip: enable PI_GHOST_DEBUG_LOG=1 for detailed diagnostics.", "warning");
+    };
+}
+function describeProvider(config) {
+    const mask = (s) => (s ? `${s.substring(0, 4)}***` : "unset");
+    const parts = [];
+    parts.push(`minChars=${config.minChars}`);
+    parts.push(`maxLineLength=${config.maxLineLength}`);
+    if (config.provider.kind === "race") {
+        parts.push(`mode=race`);
+        parts.push(`pauseMs=${config.provider.pauseMs}`);
+        parts.push(`cooldownMs=${config.provider.cooldownMs}`);
+        parts.push(`cutoffMs=${config.provider.cutoffMs}`);
+        parts.push(`maxRecentMessages=${config.provider.maxRecentMessages}`);
+        const members = config.provider.members.map((m, i) => {
+            const mp = [];
+            if (m.kind === "cloud") {
+                mp.push(`provider=${m.provider}`);
+                mp.push(`model=${m.modelId}`);
+                mp.push(`apiKey=${mask(m.apiKey)}`);
+            }
+            else if (m.kind === "openai-compat") {
+                mp.push(`provider=${m.providerName}`);
+                mp.push(`baseUrl=${m.baseUrl}`);
+                mp.push(`model=${m.modelId}`);
+                mp.push(`apiKey=${mask(m.apiKey)}`);
+            }
+            else if (m.kind === "local") {
+                mp.push(`baseUrl=${m.baseUrl}`);
+                mp.push(`model=${m.modelId}`);
+            }
+            mp.push(`debounceMs=${m.debounceMs}`);
+            mp.push(`maxTokens=${m.maxTokens}`);
+            return `[${m.kind}] ${mp.join(", ")}`;
+        });
+        parts.push(`members:\n    ${members.join("\n    ")}`);
+    }
+    else {
+        const p = config.provider;
+        parts.push(`mode=${p.kind}`);
+        if (p.kind === "cloud") {
+            parts.push(`provider=${p.provider}`);
+            parts.push(`model=${p.modelId}`);
+            parts.push(`apiKey=${mask(p.apiKey)}`);
+        }
+        else if (p.kind === "openai-compat") {
+            parts.push(`provider=${p.providerName}`);
+            parts.push(`baseUrl=${p.baseUrl}`);
+            parts.push(`model=${p.modelId}`);
+            parts.push(`apiKey=${mask(p.apiKey)}`);
+        }
+        else if (p.kind === "local") {
+            parts.push(`baseUrl=${p.baseUrl}`);
+            parts.push(`model=${p.modelId}`);
+        }
+        parts.push(`debounceMs=${p.debounceMs}`);
+        parts.push(`maxTokens=${p.maxTokens}`);
+        parts.push(`maxRecentMessages=${p.maxRecentMessages}`);
+    }
+    return parts.join("\n  ");
+}
+export default ghost;
+export { CloudProvider } from "./providers/cloud-provider.js";
+export { LocalProvider } from "./providers/local-provider.js";
+export { OpenAICompatProvider } from "./providers/openai-compat-provider.js";
+export { RaceProvider, firstNonNull } from "./providers/race.js";
+export { GhostEditor, computeReplacement } from "./ghost-editor.js";
+export { MetricsLogger, readMetricsConfigFromEnv } from "./metrics.js";
+export { buildPathIndex } from "./path-index.js";
+export { extractPathPrefixToken, findPathPrefix } from "./path-matcher.js";
+export { extractFuzzyToken, findFuzzyFilename, hasActionTrigger } from "./fuzzy-matcher.js";
+export { extractRecentPaths, getRoleWeightedRecent, recentBoost } from "./recent-paths.js";
+export { formatReport, loadMetrics, parseMetricsText, quantile, runBenchmark, summarize, THRESHOLDS, } from "./bench.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/metrics.d.ts

@@ -0,0 +1,56 @@
+export type CompletionMode = "deterministic" | "llm";
+export type RequestResult = "produced" | "empty" | "rejected" | "aborted" | "error";
+export type AcceptanceOutcome = "accepted" | "dismissed" | "stale" | "expired";
+export type RejectionReason = "stale-text" | "newline" | "too-long" | "assistant-phrasing" | "duplicate-suffix" | "markdown" | "empty" | "echo-token";
+export interface ProviderLatency {
+    provider: string;
+    latencyMs: number;
+    result: RequestResult;
+    rejectionReason?: RejectionReason;
+}
+export interface MetricsRecord {
+    ts: number;
+    requestId: string;
+    mode: CompletionMode;
+    providers?: ProviderLatency[];
+    winner?: string;
+    result: RequestResult;
+    rejectionReason?: RejectionReason;
+    completionLength?: number;
+    shown?: boolean;
+    acceptance?: AcceptanceOutcome;
+    /**
+     * For deterministic-mode records, the matched file path from the index.
+     * Allows benchmark/analysis to correlate accepted ghosts with files.
+     * Never set for LLM mode (would risk leaking output text).
+     */
+    matchedPath?: string;
+}
+export interface DebugRecord {
+    ts: number;
+    requestId: string;
+    kind: string;
+    [k: string]: unknown;
+}
+export interface MetricsConfig {
+    metricsEnabled: boolean;
+    debugEnabled: boolean;
+}
+export declare function readMetricsConfigFromEnv(): MetricsConfig;
+export declare class MetricsLogger {
+    private readonly cwd;
+    private readonly cfg;
+    private readonly metricsPath;
+    private readonly debugPath;
+    private writeQueue;
+    private nextId;
+    constructor(cwd: string, cfg: MetricsConfig);
+    get metricsEnabled(): boolean;
+    get debugEnabled(): boolean;
+    newRequestId(): string;
+    logMetric(record: MetricsRecord): void;
+    logDebug(record: DebugRecord): void;
+    flush(): Promise<void>;
+    private enqueue;
+}
+//# sourceMappingURL=metrics.d.ts.map

package/dist/metrics.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metrics.d.ts","sourceRoot":"","sources":["../src/metrics.ts"],"names":[],"mappings":"AAOA,MAAM,MAAM,cAAc,GAAG,eAAe,GAAG,KAAK,CAAC;AAErD,MAAM,MAAM,aAAa,GACtB,UAAU,GACV,OAAO,GACP,UAAU,GACV,SAAS,GACT,OAAO,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,UAAU,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAC;AAE/E,MAAM,MAAM,eAAe,GACxB,YAAY,GACZ,SAAS,GACT,UAAU,GACV,oBAAoB,GACpB,kBAAkB,GAClB,UAAU,GACV,OAAO,GACP,YAAY,CAAC;AAEhB,MAAM,WAAW,eAAe;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,aAAa,CAAC;IACtB,eAAe,CAAC,EAAE,eAAe,CAAC;CAClC;AAED,MAAM,WAAW,aAAa;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,cAAc,CAAC;IACrB,SAAS,CAAC,EAAE,eAAe,EAAE,CAAC;IAC9B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,aAAa,CAAC;IACtB,eAAe,CAAC,EAAE,eAAe,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAC/B;;;;OAIG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,WAAW;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,aAAa;IAC7B,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;CACtB;AAED,wBAAgB,wBAAwB,IAAI,aAAa,CAKxD;AAED,qBAAa,aAAa;IAOxB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAPrB,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,MAAM,CAAK;gBAGD,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,aAAa;IAMpC,IAAI,cAAc,IAAI,OAAO,CAE5B;IAED,IAAI,YAAY,IAAI,OAAO,CAE1B;IAED,YAAY,IAAI,MAAM;IAItB,SAAS,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAKtC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAK7B,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B,OAAO,CAAC,OAAO;CAGf"}

package/dist/metrics.js

@@ -0,0 +1,98 @@
+import { appendFile, mkdir, rename, stat } from "node:fs/promises";
+import { dirname, join } from "node:path";
+const MAX_BYTES = 10 * 1024 * 1024;
+const METRICS_REL = ".pi/ghost-autocomplete/metrics.jsonl";
+const DEBUG_REL = ".pi/ghost-autocomplete/debug.jsonl";
+export function readMetricsConfigFromEnv() {
+    return {
+        metricsEnabled: process.env.PI_GHOST_METRICS === "1",
+        debugEnabled: process.env.PI_GHOST_DEBUG_LOG === "1",
+    };
+}
+export class MetricsLogger {
+    cwd;
+    cfg;
+    metricsPath;
+    debugPath;
+    writeQueue = Promise.resolve();
+    nextId = 1;
+    constructor(cwd, cfg) {
+        this.cwd = cwd;
+        this.cfg = cfg;
+        this.metricsPath = join(cwd, METRICS_REL);
+        this.debugPath = join(cwd, DEBUG_REL);
+    }
+    get metricsEnabled() {
+        return this.cfg.metricsEnabled;
+    }
+    get debugEnabled() {
+        return this.cfg.debugEnabled;
+    }
+    newRequestId() {
+        return `r${Date.now().toString(36)}-${this.nextId++}`;
+    }
+    logMetric(record) {
+        if (!this.cfg.metricsEnabled)
+            return;
+        this.enqueue(() => writeLine(this.metricsPath, redactMetric(record)));
+    }
+    logDebug(record) {
+        if (!this.cfg.debugEnabled)
+            return;
+        this.enqueue(() => writeLine(this.debugPath, record));
+    }
+    async flush() {
+        await this.writeQueue;
+    }
+    enqueue(fn) {
+        this.writeQueue = this.writeQueue.then(fn, fn).catch(() => { });
+    }
+}
+function redactMetric(rec) {
+    const { ts, requestId, mode, providers, winner, result, rejectionReason, completionLength, shown, acceptance, matchedPath } = rec;
+    const out = { ts, requestId, mode, result };
+    if (providers && providers.length > 0)
+        out.providers = providers;
+    if (winner !== undefined)
+        out.winner = winner;
+    if (rejectionReason !== undefined)
+        out.rejectionReason = rejectionReason;
+    if (completionLength !== undefined)
+        out.completionLength = completionLength;
+    if (shown !== undefined)
+        out.shown = shown;
+    if (acceptance !== undefined)
+        out.acceptance = acceptance;
+    if (mode === "deterministic" && matchedPath !== undefined)
+        out.matchedPath = matchedPath;
+    return out;
+}
+async function writeLine(path, payload) {
+    try {
+        await mkdir(dirname(path), { recursive: true });
+        await rotateIfNeeded(path);
+        await appendFile(path, `${JSON.stringify(payload)}\n`, "utf8");
+    }
+    catch {
+        // Logging must never break ghost completion. Swallow.
+    }
+}
+async function rotateIfNeeded(path) {
+    let size;
+    try {
+        const s = await stat(path);
+        size = s.size;
+    }
+    catch {
+        return;
+    }
+    if (size < MAX_BYTES)
+        return;
+    try {
+        await rename(path, `${path}.1`);
+    }
+    catch {
+        // Best-effort rotation; if rename fails, keep appending to the file.
+    }
+}
+//# sourceMappingURL=metrics.js.map

package/dist/metrics.js.map

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

package/dist/path-index.d.ts

@@ -0,0 +1,20 @@
+export interface PathIndexOptions {
+    cap?: number;
+    signal?: AbortSignal;
+}
+export interface PathIndex {
+    readonly root: string;
+    readonly cwd: string;
+    readonly capExceeded: boolean;
+    readonly files: readonly string[];
+    prefixMatches(token: string, limit: number): string[];
+}
+/**
+ * Build a deterministic path index rooted at the Git toplevel of `cwd`.
+ *
+ * Returns null when Git is unavailable, `cwd` is outside any repo, or the
+ * underlying commands fail. Callers should treat null as "no deterministic
+ * path completion this session".
+ */
+export declare function buildPathIndex(cwd: string, opts?: PathIndexOptions): Promise<PathIndex | null>;
+//# sourceMappingURL=path-index.d.ts.map

package/dist/path-index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-index.d.ts","sourceRoot":"","sources":["../src/path-index.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,gBAAgB;IAChC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,WAAW,CAAC;CACrB;AAED,MAAM,WAAW,SAAS;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAC;IAClC,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;CACtD;AAED;;;;;;GAMG;AACH,wBAAsB,cAAc,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE,gBAAqB,GACzB,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAqB3B"}

package/dist/path-index.js

@@ -0,0 +1,148 @@
+import { spawn } from "node:child_process";
+const DEFAULT_CAP = 20_000;
+/**
+ * Build a deterministic path index rooted at the Git toplevel of `cwd`.
+ *
+ * Returns null when Git is unavailable, `cwd` is outside any repo, or the
+ * underlying commands fail. Callers should treat null as "no deterministic
+ * path completion this session".
+ */
+export async function buildPathIndex(cwd, opts = {}) {
+    const cap = opts.cap ?? DEFAULT_CAP;
+    const root = await gitToplevel(cwd, opts.signal);
+    if (!root)
+        return null;
+    const all = await gitLsFiles(root, opts.signal);
+    if (!all)
+        return null;
+    let files;
+    let capExceeded = false;
+    if (all.length > cap) {
+        capExceeded = true;
+        const rel = relPosix(root, cwd);
+        const subtreePrefix = rel === "" ? "" : `${rel}/`;
+        files = all.filter((f) => subtreePrefix === "" || f.startsWith(subtreePrefix));
+        if (files.length > cap)
+            files = files.slice(0, cap);
+    }
+    else {
+        files = all;
+    }
+    files.sort();
+    return new PathIndexImpl(root, cwd, files, capExceeded);
+}
+class PathIndexImpl {
+    root;
+    cwd;
+    files;
+    capExceeded;
+    constructor(root, cwd, files, capExceeded) {
+        this.root = root;
+        this.cwd = cwd;
+        this.files = files;
+        this.capExceeded = capExceeded;
+    }
+    prefixMatches(token, limit) {
+        if (!token || limit <= 0)
+            return [];
+        const start = lowerBound(this.files, token);
+        const out = [];
+        for (let i = start; i < this.files.length && out.length < limit; i++) {
+            const f = this.files[i];
+            if (!f || !f.startsWith(token))
+                break;
+            out.push(f);
+        }
+        return out;
+    }
+}
+function lowerBound(arr, target) {
+    let lo = 0;
+    let hi = arr.length;
+    while (lo < hi) {
+        const mid = (lo + hi) >>> 1;
+        const v = arr[mid];
+        if (v !== undefined && v < target)
+            lo = mid + 1;
+        else
+            hi = mid;
+    }
+    return lo;
+}
+function relPosix(root, cwd) {
+    const r = normSlashes(root);
+    const c = normSlashes(cwd);
+    if (c === r)
+        return "";
+    const prefix = r.endsWith("/") ? r : `${r}/`;
+    if (c.startsWith(prefix))
+        return c.slice(prefix.length);
+    return "";
+}
+function normSlashes(p) {
+    return p.replace(/\\/g, "/").replace(/\/+$/, "");
+}
+async function gitToplevel(cwd, signal) {
+    const res = await runGit(["rev-parse", "--show-toplevel"], cwd, signal);
+    if (!res)
+        return null;
+    const line = res.split(/\r?\n/)[0]?.trim();
+    if (!line)
+        return null;
+    return normSlashes(line);
+}
+async function gitLsFiles(root, signal) {
+    const res = await runGit(["ls-files", "-z"], root, signal);
+    if (res === null)
+        return null;
+    if (res === "")
+        return [];
+    return res.split("\0").filter((s) => s.length > 0);
+}
+function runGit(args, cwd, signal) {
+    return new Promise((resolve) => {
+        let proc;
+        try {
+            proc = spawn("git", args, { cwd, windowsHide: true });
+        }
+        catch {
+            resolve(null);
+            return;
+        }
+        let out = "";
+        let err = false;
+        const onAbort = () => {
+            try {
+                proc.kill();
+            }
+            catch {
+                // proc may already be dead
+            }
+        };
+        if (signal) {
+            if (signal.aborted)
+                onAbort();
+            else
+                signal.addEventListener("abort", onAbort, { once: true });
+        }
+        proc.stdout?.on("data", (chunk) => {
+            out += chunk.toString("utf8");
+        });
+        proc.on("error", () => {
+            err = true;
+            resolve(null);
+        });
+        proc.on("close", (code) => {
+            if (signal)
+                signal.removeEventListener("abort", onAbort);
+            if (err)
+                return;
+            if (code !== 0) {
+                resolve(null);
+                return;
+            }
+            resolve(out);
+        });
+    });
+}
+//# sourceMappingURL=path-index.js.map

package/dist/path-index.js.map

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

package/dist/path-matcher.d.ts

@@ -0,0 +1,32 @@
+import type { PathIndex } from "./path-index.js";
+export interface PathToken {
+    token: string;
+    insideQuote: boolean;
+}
+export interface PathPrefixMatch {
+    match: string;
+    suffix: string;
+    score: number;
+}
+export interface FindPathPrefixOptions {
+    limit?: number;
+    recentPaths?: Set<string> | null;
+}
+/**
+ * Extract a path-like token from the end of `before` (text before the cursor).
+ * Returns null when no path-prefix mode is applicable: a token is only
+ * eligible when it contains a `/` (path-prefix mode is structural, not fuzzy).
+ *
+ * `insideQuote` is true when the character immediately preceding the token is
+ * a quote or backtick; callers can still trust the token in that case.
+ */
+export declare function extractPathPrefixToken(before: string): PathToken | null;
+/**
+ * Pick the best path-prefix match for `token`. Strategy: enumerate matches
+ * (capped), prefer files inside `cwdRel` subtree, then shorter paths.
+ *
+ * Returns null when the token has no matches or matches itself exactly
+ * (nothing to insert).
+ */
+export declare function findPathPrefix(index: PathIndex, token: string, opts?: FindPathPrefixOptions | number): PathPrefixMatch | null;
+//# sourceMappingURL=path-matcher.d.ts.map

package/dist/path-matcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-matcher.d.ts","sourceRoot":"","sources":["../src/path-matcher.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAGjD,MAAM,WAAW,SAAS;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,eAAe;IAC/B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAqB;IACrC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;CACjC;AAKD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAevE;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAC7B,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,MAAM,EACb,IAAI,GAAE,qBAAqB,GAAG,MAAW,GACvC,eAAe,GAAG,IAAI,CA+BxB"}