@angri450/zvec-grep 0.2.2

package/dist/daemon/job-scheduler.js

@@ -0,0 +1,492 @@
+import { randomUUID } from "node:crypto";
+import { redactErrorText } from "../engine/errors.js";
+import { DaemonError } from "./errors.js";
+import { rootIdentity } from "./logger.js";
+// How many finished jobs stay queryable via get()/wait() before the oldest
+// ones are evicted. Keeps the jobs Map bounded on long-running daemons.
+const MAX_RETAINED_FINISHED_JOBS = 256;
+export class JobScheduler {
+    jobs = new Map();
+    activeByRoot = new Map();
+    latestByRoot = new Map();
+    finishedJobIds = [];
+    queue = [];
+    concurrency;
+    maxAttempts;
+    retryBaseDelayMs;
+    running = 0;
+    closed = false;
+    closePromise;
+    closeResolve;
+    logger;
+    constructor(options = {}) {
+        this.concurrency = options.concurrency ?? 1;
+        this.maxAttempts = options.maxAttempts ?? 3;
+        this.retryBaseDelayMs = options.retryBaseDelayMs ?? 250;
+        this.logger = options.logger;
+    }
+    submit(input) {
+        if (this.closed) {
+            throw new DaemonError("DAEMON_SHUTTING_DOWN", "The daemon is shutting down.", true);
+        }
+        const active = this.activeByRoot.get(input.canonicalRoot);
+        if (active) {
+            if (active.state === "queued" && !active.retryTimer) {
+                if (input.reason === "watch" || input.followupIfRunning) {
+                    active.run = combineRuns(active.run, input.run);
+                }
+                if (priority(input.reason) > priority(active.reason)) {
+                    active.reason = input.reason;
+                    this.sortQueue();
+                }
+            }
+            else if (input.reason === "watch" || input.followupIfRunning) {
+                if (active.followup) {
+                    mergeQueuedJob(active.followup, input);
+                }
+                else {
+                    active.followup = this.createJob(input);
+                }
+                return { job: snapshot(active.followup), reused: true };
+            }
+            return { job: snapshot(active), reused: true };
+        }
+        const job = this.enqueue(input);
+        return { job: snapshot(job), reused: false };
+    }
+    getByRoot(canonicalRoot) {
+        const job = this.latestByRoot.get(canonicalRoot);
+        return job ? snapshot(job) : undefined;
+    }
+    hasActiveRoot(canonicalRoot) {
+        return this.activeByRoot.has(canonicalRoot);
+    }
+    get(jobId) {
+        const job = this.jobs.get(jobId);
+        return job ? snapshot(job) : undefined;
+    }
+    async wait(jobId, onProgress) {
+        const job = this.jobs.get(jobId);
+        if (!job) {
+            throw new Error(`Unknown job: ${jobId}`);
+        }
+        if (!onProgress) {
+            return job.completion;
+        }
+        job.progressListeners.add(onProgress);
+        if (job.progress) {
+            try {
+                onProgress({ ...job.progress });
+            }
+            catch {
+                // Progress observers must never change the indexing outcome.
+            }
+        }
+        try {
+            return await job.completion;
+        }
+        finally {
+            job.progressListeners.delete(onProgress);
+        }
+    }
+    async waitForRootIdle(canonicalRoot) {
+        while (true) {
+            const active = this.activeByRoot.get(canonicalRoot);
+            if (!active) {
+                return;
+            }
+            await active.completion;
+        }
+    }
+    /**
+     * Drop all in-memory bookkeeping for a root: cancels any active job,
+     * removes the last-job record, and evicts the root's finished jobs from
+     * retention. Call when a root is dropped or evicted — without this the
+     * entries outlive the workspace and accumulate without bound on
+     * long-lived daemons. Drain the root first (cancelRoot +
+     * waitForRootIdle) so no job is still running; a running job left behind
+     * finishes into normal retention.
+     */
+    forgetRoot(canonicalRoot) {
+        this.cancelRoot(canonicalRoot);
+        const forgotten = new Set();
+        for (const [jobId, job] of this.jobs) {
+            if (job.canonicalRoot === canonicalRoot &&
+                job.state !== "queued" &&
+                job.state !== "running") {
+                forgotten.add(jobId);
+                this.jobs.delete(jobId);
+            }
+        }
+        this.latestByRoot.delete(canonicalRoot);
+        for (let index = this.finishedJobIds.length - 1; index >= 0; index--) {
+            if (forgotten.has(this.finishedJobIds[index])) {
+                this.finishedJobIds.splice(index, 1);
+            }
+        }
+    }
+    cancelRoot(canonicalRoot) {
+        const active = this.activeByRoot.get(canonicalRoot);
+        if (!active) {
+            return false;
+        }
+        this.cancelJob(active, "Indexing was cancelled.");
+        return true;
+    }
+    snapshot() {
+        return {
+            queued: [...this.jobs.values()].filter((job) => job.state === "queued")
+                .length,
+            running: this.running,
+        };
+    }
+    async close() {
+        if (this.closed) {
+            return this.closePromise;
+        }
+        this.closed = true;
+        for (const job of this.jobs.values()) {
+            this.cancelJob(job, "Indexing was cancelled because the daemon is shutting down.");
+        }
+        this.queue.length = 0;
+        if (this.running === 0) {
+            return;
+        }
+        this.closePromise = new Promise((resolve) => {
+            this.closeResolve = resolve;
+        });
+        return this.closePromise;
+    }
+    pump() {
+        while (!this.closed &&
+            this.running < this.concurrency &&
+            this.queue.length > 0) {
+            const job = this.queue.shift();
+            if (job.state !== "queued" || job.retryTimer) {
+                continue;
+            }
+            this.running += 1;
+            job.state = "running";
+            job.attempt += 1;
+            job.error = undefined;
+            job.startedAt ??= Date.now();
+            this.logger?.event("job.started", {
+                root_id: rootIdentity(job.canonicalRoot),
+                job_id: job.id,
+                reason: job.reason,
+                attempt: job.attempt,
+            });
+            void this.runJob(job);
+        }
+    }
+    async runJob(job) {
+        // Only non-terminal jobs are pumped, and run is only cleared on finish,
+        // so it is always present here.
+        const run = job.run;
+        try {
+            await run((progress) => {
+                job.progress = { ...progress };
+                if (progress.embedding?.stage === "warning") {
+                    this.logger?.event("model.warning", {
+                        root_id: rootIdentity(job.canonicalRoot),
+                        job_id: job.id,
+                        attempt: job.attempt,
+                        model: progress.embedding.model,
+                        message: redactErrorText(progress.embedding.message ?? "Embedding model warning", 512),
+                    });
+                }
+                for (const listener of job.progressListeners) {
+                    try {
+                        listener({ ...progress });
+                    }
+                    catch {
+                        // Progress observers must never change the indexing outcome.
+                    }
+                }
+            }, job.abortController.signal);
+            if (job.abortController.signal.aborted) {
+                job.error ??= errorInfo(job.abortController.signal.reason);
+                this.finish(job, "cancelled");
+            }
+            else {
+                this.finish(job, "succeeded");
+            }
+        }
+        catch (error) {
+            if (job.abortController.signal.aborted) {
+                job.error = errorInfo(error);
+                this.finish(job, "cancelled");
+                return;
+            }
+            if (!this.closed &&
+                isRetryable(error) &&
+                job.attempt < this.maxAttempts) {
+                job.state = "queued";
+                job.error = errorInfo(error);
+                const delay = this.retryBaseDelayMs * 2 ** (job.attempt - 1);
+                this.logger?.event("job.retry", {
+                    root_id: rootIdentity(job.canonicalRoot),
+                    job_id: job.id,
+                    error_code: job.error.code,
+                    retry_after_ms: delay,
+                });
+                job.retryTimer = setTimeout(() => {
+                    job.retryTimer = undefined;
+                    this.queue.push(job);
+                    this.sortQueue();
+                    this.pump();
+                }, delay);
+            }
+            else {
+                job.error = errorInfo(error);
+                this.finish(job, this.closed ? "cancelled" : "failed");
+            }
+        }
+        finally {
+            this.running -= 1;
+            if (this.closed && this.running === 0) {
+                this.closeResolve?.();
+            }
+            this.pump();
+        }
+    }
+    finish(job, state) {
+        job.state = state;
+        job.finishedAt = Date.now();
+        this.logger?.event("job.finished", {
+            root_id: rootIdentity(job.canonicalRoot),
+            job_id: job.id,
+            state,
+            attempt: job.attempt,
+            error_code: job.error?.code,
+            duration_ms: job.startedAt ? job.finishedAt - job.startedAt : 0,
+        });
+        if (this.activeByRoot.get(job.canonicalRoot) === job) {
+            this.activeByRoot.delete(job.canonicalRoot);
+        }
+        const followup = !this.closed && state !== "cancelled" && job.followup?.state === "queued"
+            ? job.followup
+            : undefined;
+        job.followup = undefined;
+        if (followup) {
+            this.activate(followup);
+        }
+        job.resolveCompletion(snapshot(job));
+        // Keep the terminal job for late get()/wait() lookups, but stop pinning
+        // the run closure and any progress listeners, then evict old entries so
+        // the jobs Map stays bounded on long-running daemons.
+        job.run = undefined;
+        job.progressListeners.clear();
+        this.retainFinishedJob(job.id);
+    }
+    retainFinishedJob(jobId) {
+        this.finishedJobIds.push(jobId);
+        while (this.finishedJobIds.length > MAX_RETAINED_FINISHED_JOBS) {
+            const oldest = this.finishedJobIds.shift();
+            if (oldest !== undefined) {
+                this.jobs.delete(oldest);
+            }
+        }
+    }
+    enqueue(input) {
+        const job = this.createJob(input);
+        this.activate(job);
+        return job;
+    }
+    createJob(input) {
+        let resolveCompletion;
+        const completion = new Promise((resolve) => {
+            resolveCompletion = resolve;
+        });
+        const job = {
+            id: randomUUID(),
+            canonicalRoot: input.canonicalRoot,
+            reason: input.reason,
+            state: "queued",
+            attempt: 0,
+            createdAt: Date.now(),
+            run: input.run,
+            completion,
+            resolveCompletion,
+            progressListeners: new Set(),
+            abortController: new AbortController(),
+        };
+        this.jobs.set(job.id, job);
+        return job;
+    }
+    activate(job) {
+        this.activeByRoot.set(job.canonicalRoot, job);
+        this.latestByRoot.set(job.canonicalRoot, job);
+        this.queue.push(job);
+        this.sortQueue();
+        this.pump();
+    }
+    cancelJob(job, message) {
+        if (job.state === "succeeded" ||
+            job.state === "failed" ||
+            job.state === "cancelled") {
+            return;
+        }
+        if (!job.abortController.signal.aborted) {
+            job.abortController.abort(new DaemonError("INDEX_CANCELLED", message));
+        }
+        if (job.retryTimer) {
+            clearTimeout(job.retryTimer);
+            job.retryTimer = undefined;
+        }
+        const followup = job.followup;
+        job.followup = undefined;
+        if (followup) {
+            this.cancelJob(followup, message);
+        }
+        if (job.state === "queued") {
+            job.error = { code: "INDEX_CANCELLED", message };
+            this.finish(job, "cancelled");
+        }
+    }
+    sortQueue() {
+        this.queue.sort((left, right) => priority(right.reason) - priority(left.reason) ||
+            left.createdAt - right.createdAt);
+    }
+}
+function priority(reason) {
+    switch (reason) {
+        case "manual":
+            return 4;
+        case "fresh_query":
+            return 3;
+        case "watch":
+            return 2;
+        case "background_reconcile":
+            return 1;
+        case "reconcile":
+            return 1;
+    }
+}
+function mergeQueuedJob(current, incoming) {
+    current.run = combineRuns(current.run, incoming.run);
+    if (priority(incoming.reason) > priority(current.reason)) {
+        current.reason = incoming.reason;
+    }
+}
+function combineRuns(first, second) {
+    return async (report, signal) => {
+        await first?.(report, signal);
+        await second(report, signal);
+    };
+}
+function snapshot(job) {
+    return {
+        id: job.id,
+        canonicalRoot: job.canonicalRoot,
+        reason: job.reason,
+        state: job.state,
+        attempt: job.attempt,
+        createdAt: job.createdAt,
+        startedAt: job.startedAt,
+        finishedAt: job.finishedAt,
+        progress: job.progress ? { ...job.progress } : undefined,
+        error: job.error ? { ...job.error } : undefined,
+    };
+}
+function isRetryable(error) {
+    if (error instanceof DaemonError) {
+        return error.retryable;
+    }
+    return Boolean(error &&
+        typeof error === "object" &&
+        "code" in error &&
+        error.code === "ZVEC_GREP.ENGINE.LOCK.BUSY");
+}
+function errorInfo(error) {
+    const context = errorProperty(error, "context", 4_096);
+    const cause = errorCause(error);
+    if (error instanceof DaemonError) {
+        return jobError(error.code, error.message, context, cause);
+    }
+    if (error &&
+        typeof error === "object" &&
+        "code" in error &&
+        typeof error.code === "string") {
+        return jobError(error.code, error instanceof Error ? error.message : String(error), context, cause);
+    }
+    return jobError("INDEX_FAILED", error instanceof Error ? error.message : String(error), context, cause);
+}
+function jobError(code, message, context, cause) {
+    return {
+        code: safeErrorCode(code) ?? "INDEX_FAILED",
+        message: redactErrorText(message, 512),
+        ...(context ? { context } : {}),
+        ...(cause ? { cause } : {}),
+    };
+}
+function errorProperty(error, property, maxLength) {
+    if (!error || typeof error !== "object" || !(property in error)) {
+        return undefined;
+    }
+    const value = error[property];
+    return typeof value === "string" && value.trim().length > 0
+        ? redactErrorText(value, maxLength)
+        : undefined;
+}
+function errorCause(error) {
+    if (!(error instanceof Error) || error.cause === undefined) {
+        return undefined;
+    }
+    const summaries = [];
+    const seen = new Set();
+    let cause = error.cause;
+    for (let depth = 0; cause !== undefined && depth < 3; depth++) {
+        if (cause && typeof cause === "object") {
+            if (seen.has(cause)) {
+                break;
+            }
+            seen.add(cause);
+        }
+        const summary = causeSummary(cause);
+        if (summary && !summaries.includes(summary)) {
+            summaries.push(summary);
+        }
+        cause = nestedCause(cause);
+    }
+    return summaries.length > 0
+        ? redactErrorText(summaries.join("; "), 512)
+        : undefined;
+}
+function causeSummary(cause) {
+    const message = cause instanceof Error
+        ? cause.message
+        : typeof cause === "string" ||
+            typeof cause === "number" ||
+            typeof cause === "boolean"
+            ? String(cause)
+            : cause &&
+                typeof cause === "object" &&
+                "message" in cause &&
+                typeof cause.message === "string"
+                ? cause.message
+                : undefined;
+    const code = errorCodeProperty(cause);
+    if (!message || message.trim().length === 0) {
+        return code;
+    }
+    return code && !message.includes(code) ? `${code}: ${message}` : message;
+}
+function nestedCause(error) {
+    return error && typeof error === "object" && "cause" in error
+        ? error.cause
+        : undefined;
+}
+function errorCodeProperty(error) {
+    return error &&
+        typeof error === "object" &&
+        "code" in error &&
+        typeof error.code === "string"
+        ? safeErrorCode(error.code)
+        : undefined;
+}
+function safeErrorCode(code) {
+    const value = redactErrorText(code.trim(), 128);
+    return /^[A-Z][A-Z0-9_.-]{0,127}$/.test(value) ? value : undefined;
+}
+//# sourceMappingURL=job-scheduler.js.map

package/dist/daemon/job-scheduler.js.map

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

package/dist/daemon/logger.d.ts

@@ -0,0 +1,10 @@
+import type { ZvecGrepLogConfig } from "../engine/config.js";
+export type LogFields = Record<string, string | number | boolean | undefined>;
+export type DaemonLogger = {
+    event(name: string, fields?: LogFields, level?: "info" | "debug"): void;
+    flush(): Promise<void>;
+};
+export declare function createDaemonLogger(home?: string, options?: ZvecGrepLogConfig): DaemonLogger;
+export declare function rootIdentity(root: string): string;
+export declare function opaqueIdentity(value: string): string;
+export declare function requestId(): string;

package/dist/daemon/logger.js

@@ -0,0 +1,101 @@
+import { createHash, randomUUID } from "node:crypto";
+import { chmod, mkdir, readdir, rm } from "node:fs/promises";
+import { finished } from "node:stream/promises";
+import { createStream } from "rotating-file-stream";
+import { dirname, join } from "node:path";
+import { daemonHome } from "./config.js";
+import { currentTraceContext } from "../observability/trace-context.js";
+export function createDaemonLogger(home, options = {}) {
+    const maxBytes = options.maxBytes ?? 10 * 1024 * 1024;
+    const keep = options.keep ?? 5;
+    const level = options.level ?? "info";
+    const path = join(daemonHome(home), "logs", "server.log");
+    let tail = Promise.resolve();
+    let stream;
+    async function openStream() {
+        if (stream && !stream.destroyed)
+            return stream;
+        await mkdir(dirname(path), { recursive: true, mode: 0o700 });
+        // Classical rotation does not remove backups beyond a reduced retention limit.
+        for (const name of await readdir(dirname(path))) {
+            const match = /^server\.log\.([1-9]\d*)$/.exec(name);
+            if (match && Number(match[1]) > keep)
+                await rm(join(dirname(path), name));
+        }
+        await chmod(path, 0o600).catch((error) => {
+            if (error.code !== "ENOENT")
+                throw error;
+        });
+        stream = createStream("server.log", {
+            path: dirname(path),
+            size: `${maxBytes}B`,
+            rotate: Math.max(1, keep),
+            mode: 0o600,
+        });
+        // Logging failures must not become unhandled stream errors in the daemon.
+        stream.on("error", () => undefined);
+        return stream;
+    }
+    return {
+        event(name, fields = {}, eventLevel = "info") {
+            if (eventLevel === "debug" && level !== "debug")
+                return;
+            const trace = currentTraceContext();
+            const record = JSON.stringify({
+                timestamp: new Date().toISOString(),
+                event: name,
+                level: eventLevel,
+                ...(trace ? { trace_id: trace.traceId } : {}),
+                ...sanitizeFields(fields),
+            });
+            tail = tail
+                .then(async () => {
+                const output = await openStream();
+                // One write per JSON record keeps oversized and UTF-8 records intact.
+                await new Promise((resolve, reject) => {
+                    output.write(`${record}\n`, (error) => error ? reject(error) : resolve());
+                });
+                // The library requires at least one backup; zero retention discards it.
+                if (keep === 0)
+                    await rm(`${path}.1`, { force: true });
+            })
+                .catch(() => undefined);
+        },
+        flush() {
+            tail = tail
+                .then(async () => {
+                const output = stream;
+                stream = undefined;
+                if (!output)
+                    return;
+                const completion = finished(output, { cleanup: true });
+                output.end();
+                await completion;
+            })
+                .catch(() => undefined);
+            return tail;
+        },
+    };
+}
+export function rootIdentity(root) {
+    return createHash("sha256").update(root).digest("hex").slice(0, 16);
+}
+export function opaqueIdentity(value) {
+    return createHash("sha256").update(value).digest("hex").slice(0, 16);
+}
+export function requestId() {
+    return randomUUID();
+}
+function sanitizeFields(fields) {
+    const safe = {};
+    for (const [key, value] of Object.entries(fields)) {
+        if (value === undefined || /token|api.?key|authorization|query/i.test(key))
+            continue;
+        safe[key] =
+            typeof value === "string" && value.length > 512
+                ? `${value.slice(0, 512)}…`
+                : value;
+    }
+    return safe;
+}
+//# sourceMappingURL=logger.js.map

package/dist/daemon/logger.js.map

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