@zvec/zvec-grep 0.1.5 → 0.1.7

package/dist/daemon/server-controller.js

@@ -0,0 +1,254 @@
+import { randomUUID } from "node:crypto";
+import { spawn } from "node:child_process";
+import { open, readFile, unlink } from "node:fs/promises";
+import { createServer } from "node:net";
+import { hostname } from "node:os";
+import { join } from "node:path";
+import { configuredListenAddress, daemonHome, resolveClientToken, } from "./config.js";
+import { processIsAlive } from "../engine/utils/daemon-lease.js";
+import { DEFAULT_MCP_TOOLSET, MCP_TOOLSET_ENV, resolveMcpToolset, } from "../mcp/toolset.js";
+const LIFTOFF_ONLY_FLAG = "--liftoff-only";
+export class DaemonInstanceLock {
+    path;
+    record;
+    heartbeat;
+    constructor(path, record) {
+        this.path = path;
+        this.record = record;
+    }
+    static async acquire(home, serverUrl, mcpToolset = DEFAULT_MCP_TOOLSET) {
+        const path = join(daemonHome(home), "instance.lock");
+        const record = {
+            pid: process.pid,
+            hostname: hostname(),
+            instanceToken: randomUUID(),
+            startedAt: Date.now(),
+            updatedAt: Date.now(),
+            serverUrl,
+            ready: false,
+            mcpToolset,
+        };
+        for (let attempt = 0; attempt < 3; attempt++) {
+            try {
+                const handle = await open(path, "wx", 0o600);
+                try {
+                    await handle.writeFile(`${JSON.stringify(record)}\n`);
+                }
+                finally {
+                    await handle.close();
+                }
+                return new DaemonInstanceLock(path, record);
+            }
+            catch (error) {
+                if (error.code === "ENOENT") {
+                    const { mkdir } = await import("node:fs/promises");
+                    await mkdir(daemonHome(home), { recursive: true, mode: 0o700 });
+                    continue;
+                }
+                if (error.code !== "EEXIST")
+                    throw error;
+                const existing = await readInstanceRecord(home);
+                if (existing &&
+                    existing.hostname === hostname() &&
+                    processIsAlive(existing.pid)) {
+                    throw new Error(`zvec-grep server is already running with PID ${existing.pid}`, {
+                        cause: error,
+                    });
+                }
+                await unlink(path).catch(() => undefined);
+            }
+        }
+        throw new Error("Could not acquire the zvec-grep server instance lock.");
+    }
+    async markReady() {
+        this.record.ready = true;
+        await this.write();
+        this.heartbeat = setInterval(() => {
+            void this.write();
+        }, 5_000);
+        this.heartbeat.unref?.();
+    }
+    async release() {
+        if (this.heartbeat)
+            clearInterval(this.heartbeat);
+        const current = await readRecordPath(this.path);
+        if (current?.instanceToken === this.record.instanceToken &&
+            current.pid === process.pid) {
+            await unlink(this.path).catch(() => undefined);
+        }
+    }
+    async write() {
+        this.record.updatedAt = Date.now();
+        const current = await readRecordPath(this.path);
+        if (current?.instanceToken !== this.record.instanceToken ||
+            current.pid !== process.pid)
+            return;
+        const { writeFile } = await import("node:fs/promises");
+        await writeFile(this.path, `${JSON.stringify(this.record)}\n`, {
+            mode: 0o600,
+        });
+    }
+}
+export async function readInstanceRecord(home) {
+    return readRecordPath(join(daemonHome(home), "instance.lock"));
+}
+export async function serverStatus(home) {
+    const record = await readInstanceRecord(home);
+    if (!record ||
+        record.hostname !== hostname() ||
+        !processIsAlive(record.pid)) {
+        return { running: false, ready: false };
+    }
+    try {
+        const response = await fetch(new URL("/healthz", record.serverUrl), {
+            signal: AbortSignal.timeout(1_000),
+        });
+        return {
+            running: true,
+            ready: response.ok && record.ready,
+            pid: record.pid,
+            serverUrl: record.serverUrl,
+            mcpToolset: record.mcpToolset,
+        };
+    }
+    catch {
+        return {
+            running: true,
+            ready: false,
+            pid: record.pid,
+            serverUrl: record.serverUrl,
+            mcpToolset: record.mcpToolset,
+        };
+    }
+}
+export async function startServer(options) {
+    const environmentToolset = process.env[MCP_TOOLSET_ENV];
+    const requestedToolset = resolveMcpToolset(options.mcpToolset, environmentToolset);
+    const toolsetWasExplicit = options.mcpToolset !== undefined || environmentToolset !== undefined;
+    const current = await serverStatus(options.home);
+    if (current.running) {
+        if (toolsetWasExplicit &&
+            current.mcpToolset !== undefined &&
+            current.mcpToolset !== requestedToolset) {
+            throw new Error(`zvec-grep server is already running with MCP toolset "${current.mcpToolset}". Run \`zg server off\`, then restart it with \`zg server on --mcp-toolset ${requestedToolset}\`.`);
+        }
+        if (current.ready)
+            return current;
+        return waitForStatus(options.home, true, options.timeoutMs ?? 10_000);
+    }
+    const listen = configuredListenAddress(options.listen);
+    try {
+        await assertListenAddressAvailable(listen.host, listen.port);
+    }
+    catch (error) {
+        const starting = await waitForRunningRecord(options.home, 500);
+        if (starting) {
+            return waitForStatus(options.home, true, options.timeoutMs ?? 10_000);
+        }
+        throw error;
+    }
+    const args = [LIFTOFF_ONLY_FLAG, options.cliPath, "server", "run"];
+    args.push("--mcp-toolset", requestedToolset);
+    if (options.listen)
+        args.push("--listen", options.listen);
+    if (options.tokenFile)
+        args.push("--token-file", options.tokenFile);
+    if (options.home)
+        args.push("--home", options.home);
+    const child = spawn(process.execPath, args, {
+        detached: true,
+        stdio: "ignore",
+        windowsHide: true,
+    });
+    child.unref();
+    return waitForStatus(options.home, true, options.timeoutMs ?? 10_000);
+}
+export async function stopServer(home, timeoutMs = 30_000, tokenFile) {
+    const status = await serverStatus(home);
+    if (!status.running)
+        return status;
+    const token = await resolveClientToken({ home, tokenFile });
+    const response = await fetch(new URL("/control/shutdown", status.serverUrl), {
+        method: "POST",
+        headers: token ? { Authorization: `Bearer ${token}` } : {},
+        signal: AbortSignal.timeout(2_000),
+    });
+    if (!response.ok)
+        throw new Error(`Server shutdown request failed with HTTP ${response.status}`);
+    return status.pid === undefined
+        ? waitForStatus(home, false, timeoutMs)
+        : waitForProcessExit(status.pid, timeoutMs);
+}
+async function assertListenAddressAvailable(host, port) {
+    const probe = createServer();
+    try {
+        await new Promise((resolve, reject) => {
+            probe.once("error", reject);
+            probe.listen({ host, port, exclusive: true }, () => {
+                probe.removeListener("error", reject);
+                probe.close((error) => (error ? reject(error) : resolve()));
+            });
+        });
+    }
+    catch (error) {
+        if (error.code === "EADDRINUSE") {
+            throw new Error(`Server address ${host}:${port} is already in use. Another or legacy zvec-grep server may still be running.`, { cause: error });
+        }
+        throw error;
+    }
+}
+async function waitForProcessExit(pid, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if (!processIsAlive(pid))
+            return { running: false, ready: false };
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+    throw new Error(`Timed out waiting for zvec-grep server process ${pid} to stop.`);
+}
+async function waitForStatus(home, running, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    let last = { running: false, ready: false };
+    while (Date.now() < deadline) {
+        last = await serverStatus(home);
+        if (running ? last.running && last.ready : !last.running)
+            return last;
+        await new Promise((resolve) => setTimeout(resolve, 50));
+    }
+    throw new Error(`Timed out waiting for zvec-grep server to ${running ? "start" : "stop"}.`);
+}
+async function waitForRunningRecord(home, timeoutMs) {
+    const deadline = Date.now() + timeoutMs;
+    while (Date.now() < deadline) {
+        if ((await serverStatus(home)).running)
+            return true;
+        await new Promise((resolve) => setTimeout(resolve, 25));
+    }
+    return false;
+}
+async function readRecordPath(path) {
+    try {
+        const value = JSON.parse(await readFile(path, "utf8"));
+        if (typeof value.pid !== "number" ||
+            typeof value.hostname !== "string" ||
+            typeof value.instanceToken !== "string" ||
+            typeof value.startedAt !== "number" ||
+            typeof value.updatedAt !== "number" ||
+            typeof value.serverUrl !== "string" ||
+            typeof value.ready !== "boolean" ||
+            (value.mcpToolset !== undefined &&
+                value.mcpToolset !== "agent" &&
+                value.mcpToolset !== "full"))
+            return undefined;
+        return {
+            ...value,
+            // Locks written before toolset profiles exposed the full six-tool MCP
+            // surface, so preserve that behavior when reporting a live legacy daemon.
+            mcpToolset: value.mcpToolset ?? "full",
+        };
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=server-controller.js.map

package/dist/daemon/server-controller.js.map

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

package/dist/daemon/watch-manager.d.ts

@@ -0,0 +1,50 @@
+import { watch } from "node:fs";
+import { type ChangeSetSnapshot } from "./change-set.js";
+export type WatchManagerOptions = {
+    root: string;
+    onChanges: (changes: ChangeSetSnapshot, reason: "watch" | "reconcile") => void | Promise<void>;
+    debounceMs?: number;
+    maxWaitMs?: number;
+    reconcileIntervalMs?: number;
+    maxChangedPaths?: number;
+    watchFactory?: typeof watch;
+    onPendingChange?: (pending: boolean) => void;
+    resumeCheckIntervalMs?: number;
+    resumeThresholdMs?: number;
+    platform?: NodeJS.Platform;
+    nodeVersion?: string;
+};
+export declare class WatchManager {
+    private readonly options;
+    private readonly watchers;
+    private readonly watchedDirectories;
+    private readonly directoryWatchers;
+    private readonly pendingRecords;
+    private readonly inflightFlushes;
+    private readonly recoveryStates;
+    private changes;
+    private debounceTimer?;
+    private maxWaitTimer?;
+    private reconcileTimer?;
+    private resumeTimer?;
+    private closed;
+    private reconcileRequested;
+    private lastResumeCheckAt;
+    constructor(options: WatchManagerOptions);
+    start(): void;
+    close(): Promise<void>;
+    flushPending(): Promise<void>;
+    checkForResume(now?: number): void;
+    private recordPath;
+    private queueRecord;
+    private queueFullReconcile;
+    private scheduleFlush;
+    private flush;
+    private newChangeSet;
+    private startFlush;
+    private addWatcher;
+    private recoveryState;
+    private startPrimaryWatcher;
+    private watchDirectoryTree;
+    private removeDirectoryWatchers;
+}

package/dist/daemon/watch-manager.js

@@ -0,0 +1,293 @@
+import { watch } from "node:fs";
+import { readdir, stat } from "node:fs/promises";
+import { basename, isAbsolute, join, relative, sep } from "node:path";
+import { ChangeSet } from "./change-set.js";
+const PRIMARY_WATCHER = Symbol("primary-watcher");
+export class WatchManager {
+    options;
+    watchers = new Set();
+    watchedDirectories = new Set();
+    directoryWatchers = new Map();
+    pendingRecords = new Set();
+    inflightFlushes = new Set();
+    recoveryStates = new Map();
+    changes;
+    debounceTimer;
+    maxWaitTimer;
+    reconcileTimer;
+    resumeTimer;
+    closed = false;
+    reconcileRequested = false;
+    lastResumeCheckAt = Date.now();
+    constructor(options) {
+        this.options = options;
+        this.changes = this.newChangeSet();
+    }
+    start() {
+        if (this.watchers.size > 0 || this.closed) {
+            return;
+        }
+        const factory = this.options.watchFactory ?? watch;
+        this.startPrimaryWatcher(factory);
+        const intervalMs = this.options.reconcileIntervalMs ?? 60 * 60_000;
+        if (intervalMs > 0) {
+            this.reconcileTimer = setInterval(() => this.queueFullReconcile(), intervalMs);
+            this.reconcileTimer.unref?.();
+        }
+        const resumeCheckIntervalMs = this.options.resumeCheckIntervalMs ?? 30_000;
+        if (resumeCheckIntervalMs > 0) {
+            this.lastResumeCheckAt = Date.now();
+            this.resumeTimer = setInterval(() => this.checkForResume(), resumeCheckIntervalMs);
+            this.resumeTimer.unref?.();
+        }
+    }
+    async close() {
+        if (this.closed) {
+            return;
+        }
+        this.closed = true;
+        for (const watcher of this.watchers)
+            watcher.close();
+        this.watchers.clear();
+        this.watchedDirectories.clear();
+        this.directoryWatchers.clear();
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        if (this.maxWaitTimer)
+            clearTimeout(this.maxWaitTimer);
+        if (this.reconcileTimer)
+            clearInterval(this.reconcileTimer);
+        if (this.resumeTimer)
+            clearInterval(this.resumeTimer);
+        for (const recovery of this.recoveryStates.values()) {
+            if (recovery.retryTimer)
+                clearTimeout(recovery.retryTimer);
+            if (recovery.stableTimer)
+                clearTimeout(recovery.stableTimer);
+        }
+        this.recoveryStates.clear();
+        await Promise.allSettled([...this.pendingRecords]);
+        await Promise.allSettled([...this.inflightFlushes]);
+        this.options.onPendingChange?.(false);
+    }
+    async flushPending() {
+        await Promise.allSettled([...this.pendingRecords]);
+        await Promise.allSettled([...this.inflightFlushes]);
+        await this.startFlush();
+    }
+    checkForResume(now = Date.now()) {
+        const thresholdMs = this.options.resumeThresholdMs ?? 90_000;
+        if (now - this.lastResumeCheckAt > thresholdMs) {
+            this.queueFullReconcile();
+        }
+        this.lastResumeCheckAt = now;
+    }
+    async recordPath(path, eventType, factory) {
+        const pathFromRoot = relative(this.options.root, path);
+        if (pathFromRoot
+            .split(sep)
+            .some((segment) => segment === ".git" || segment === ".zvec-grep")) {
+            return;
+        }
+        const info = await stat(path).catch(() => null);
+        if (this.closed) {
+            return;
+        }
+        if (info?.isDirectory() && eventType === "rename") {
+            void this.watchDirectoryTree(path, factory);
+        }
+        else if (!info && eventType === "rename") {
+            this.removeDirectoryWatchers(path);
+        }
+        this.changes.add(path, info ? (eventType === "rename" ? "created" : "changed") : "deleted", info?.isDirectory());
+        this.scheduleFlush();
+    }
+    queueRecord(path, eventType, factory) {
+        const pending = this.recordPath(path, eventType, factory).finally(() => {
+            this.pendingRecords.delete(pending);
+        });
+        this.pendingRecords.add(pending);
+    }
+    queueFullReconcile() {
+        this.changes.requireFullReconcile();
+        this.reconcileRequested = true;
+        this.scheduleFlush();
+    }
+    scheduleFlush() {
+        if (this.closed) {
+            return;
+        }
+        this.options.onPendingChange?.(true);
+        if (this.debounceTimer) {
+            clearTimeout(this.debounceTimer);
+        }
+        this.debounceTimer = setTimeout(() => void this.startFlush(), this.options.debounceMs ?? 750);
+        this.debounceTimer.unref?.();
+        if (!this.maxWaitTimer) {
+            this.maxWaitTimer = setTimeout(() => void this.startFlush(), this.options.maxWaitMs ?? 5_000);
+            this.maxWaitTimer.unref?.();
+        }
+    }
+    async flush() {
+        if (this.closed || this.changes.empty) {
+            return;
+        }
+        if (this.debounceTimer)
+            clearTimeout(this.debounceTimer);
+        if (this.maxWaitTimer)
+            clearTimeout(this.maxWaitTimer);
+        this.debounceTimer = undefined;
+        this.maxWaitTimer = undefined;
+        const changes = this.changes.snapshot();
+        const reason = this.reconcileRequested ? "reconcile" : "watch";
+        this.changes = this.newChangeSet();
+        this.reconcileRequested = false;
+        try {
+            await this.options.onChanges(changes, reason);
+            this.options.onPendingChange?.(false);
+        }
+        catch {
+            this.changes.merge({ ...changes, forceFullReconcile: true });
+            this.reconcileRequested = true;
+            this.scheduleFlush();
+        }
+    }
+    newChangeSet() {
+        return new ChangeSet({ maxChangedPaths: this.options.maxChangedPaths });
+    }
+    startFlush() {
+        const flush = this.flush().finally(() => this.inflightFlushes.delete(flush));
+        this.inflightFlushes.add(flush);
+        return flush;
+    }
+    addWatcher(watcher, factory, directory) {
+        const recoveryKey = directory ?? PRIMARY_WATCHER;
+        this.watchers.add(watcher);
+        if (directory)
+            this.directoryWatchers.set(directory, watcher);
+        watcher.on("error", () => {
+            watcher.close();
+            this.watchers.delete(watcher);
+            if (directory) {
+                this.directoryWatchers.delete(directory);
+                this.watchedDirectories.delete(directory);
+            }
+            const recovery = this.recoveryState(recoveryKey);
+            if (recovery.stableTimer)
+                clearTimeout(recovery.stableTimer);
+            recovery.stableTimer = undefined;
+            recovery.consecutiveErrors += 1;
+            if (!recovery.reconciliationPending) {
+                recovery.reconciliationPending = true;
+                this.queueFullReconcile();
+            }
+            if (!this.closed) {
+                if (recovery.retryTimer)
+                    clearTimeout(recovery.retryTimer);
+                const retryDelayMs = Math.min(100 * 2 ** (recovery.consecutiveErrors - 1), 5_000);
+                recovery.retryTimer = setTimeout(() => {
+                    recovery.retryTimer = undefined;
+                    if (directory) {
+                        void this.watchDirectoryTree(directory, factory);
+                    }
+                    else {
+                        this.startPrimaryWatcher(factory);
+                    }
+                }, retryDelayMs);
+                recovery.retryTimer.unref?.();
+            }
+        });
+        const recovery = this.recoveryState(recoveryKey);
+        if (recovery.stableTimer)
+            clearTimeout(recovery.stableTimer);
+        recovery.stableTimer = setTimeout(() => {
+            recovery.stableTimer = undefined;
+            recovery.consecutiveErrors = 0;
+            recovery.reconciliationPending = false;
+            if (!recovery.retryTimer)
+                this.recoveryStates.delete(recoveryKey);
+        }, 1_000);
+        recovery.stableTimer.unref?.();
+    }
+    recoveryState(key) {
+        const existing = this.recoveryStates.get(key);
+        if (existing)
+            return existing;
+        const created = {
+            consecutiveErrors: 0,
+            reconciliationPending: false,
+        };
+        this.recoveryStates.set(key, created);
+        return created;
+    }
+    startPrimaryWatcher(factory) {
+        if (this.closed) {
+            return;
+        }
+        if (requiresDirectoryWatchers(this.options.platform ?? process.platform, this.options.nodeVersion ?? process.versions.node)) {
+            void this.watchDirectoryTree(this.options.root, factory);
+            return;
+        }
+        try {
+            this.addWatcher(factory(this.options.root, { recursive: true }, (eventType, filename) => {
+                if (!filename || this.closed) {
+                    this.queueFullReconcile();
+                    return;
+                }
+                this.queueRecord(join(this.options.root, filename.toString()), eventType, factory);
+            }), factory);
+        }
+        catch {
+            void this.watchDirectoryTree(this.options.root, factory);
+        }
+    }
+    async watchDirectoryTree(directory, factory) {
+        if (this.closed ||
+            this.watchedDirectories.has(directory) ||
+            basename(directory) === ".git" ||
+            basename(directory) === ".zvec-grep") {
+            return;
+        }
+        this.watchedDirectories.add(directory);
+        try {
+            this.addWatcher(factory(directory, { recursive: false }, (eventType, filename) => {
+                if (!filename || this.closed) {
+                    this.queueFullReconcile();
+                    return;
+                }
+                this.queueRecord(join(directory, filename.toString()), eventType, factory);
+            }), factory, directory);
+        }
+        catch {
+            this.watchedDirectories.delete(directory);
+            this.queueFullReconcile();
+            return;
+        }
+        const entries = await readdir(directory, { withFileTypes: true }).catch(() => []);
+        await Promise.all(entries
+            .filter((entry) => entry.isDirectory())
+            .map((entry) => this.watchDirectoryTree(join(directory, entry.name), factory)));
+    }
+    removeDirectoryWatchers(path) {
+        for (const [directory, watcher] of this.directoryWatchers) {
+            const pathFromDeleted = relative(path, directory);
+            if (pathFromDeleted === "" ||
+                (!isAbsolute(pathFromDeleted) &&
+                    !pathFromDeleted.startsWith(`..${sep}`) &&
+                    pathFromDeleted !== "..")) {
+                watcher.close();
+                this.watchers.delete(watcher);
+                this.directoryWatchers.delete(directory);
+                this.watchedDirectories.delete(directory);
+            }
+        }
+    }
+}
+function requiresDirectoryWatchers(platform, nodeVersion) {
+    if (platform !== "linux") {
+        return false;
+    }
+    const [major, minor] = nodeVersion.split(".", 2).map(Number);
+    return major === 22 && minor === 0;
+}
+//# sourceMappingURL=watch-manager.js.map

package/dist/daemon/watch-manager.js.map

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

package/dist/daemon/workspace-read-session-cache.d.ts

@@ -0,0 +1,31 @@
+export type ClosableReadHandle = {
+    close(): void | Promise<void>;
+};
+export type WorkspaceReadSessionCacheOptions<T extends ClosableReadHandle> = {
+    open: () => T | Promise<T>;
+    idleTtlMs?: number;
+    serializeOperations?: boolean;
+};
+export declare class WorkspaceReadSessionCache<T extends ClosableReadHandle> {
+    private readonly options;
+    private handle?;
+    private openPromise?;
+    private activeReaders;
+    private lastReadAt;
+    private idleTimer?;
+    private operationTail;
+    private closePromise?;
+    private closeResolve?;
+    private closed;
+    constructor(options: WorkspaceReadSessionCacheOptions<T>);
+    withRead<R>(operation: (handle: T) => Promise<R>): Promise<R>;
+    close(): Promise<void>;
+    snapshot(): {
+        open: boolean;
+        activeReaders: number;
+    };
+    private getOrOpen;
+    private runSerial;
+    private scheduleIdleClose;
+    private closeHandle;
+}