akm-cli 0.9.5 → 0.9.6

package/dist/indexer/search/semantic-status.js

@@ -1,142 +0,0 @@
-// This Source Code Form is subject to the terms of the Mozilla Public
-// License, v. 2.0. If a copy of the MPL was not distributed with this
-// file, You can obtain one at https://mozilla.org/MPL/2.0/.
-import fs from "node:fs";
-import { writeFileAtomic } from "../../core/common.js";
-import { getCacheDir, getSemanticStatusPath } from "../../core/paths.js";
-import { DETERMINISTIC_EMBED_MODEL_ID, isDeterministicEmbedEnabled } from "../../llm/embedders/deterministic.js";
-import { DEFAULT_LOCAL_MODEL } from "../../llm/embedders/local.js";
-let semanticStatusMutationForTests;
-/** TEST-ONLY. Inject a semantic-status filesystem publication fault. */
-export function _setSemanticStatusMutationForTests(mutation) {
-    semanticStatusMutationForTests = mutation;
-}
-export function deriveSemanticProviderFingerprint(embedding) {
-    if (isDeterministicEmbedEnabled()) {
-        return `deterministic:${DETERMINISTIC_EMBED_MODEL_ID}`;
-    }
-    if (embedding?.endpoint) {
-        // Fingerprint keys on vector identity only (model + dimension). The endpoint
-        // is transport/routing and has no bearing on vector compatibility, so moving
-        // the same model+dimension to a different host must not force a full re-embed.
-        return `remote:${embedding.model}|${embedding.dimension ?? "default"}`;
-    }
-    return `local:${embedding?.localModel ?? DEFAULT_LOCAL_MODEL}`;
-}
-export function readSemanticStatus() {
-    try {
-        const raw = JSON.parse(fs.readFileSync(getSemanticStatusPath(), "utf8"));
-        if ((raw.status === "pending" ||
-            raw.status === "ready-js" ||
-            raw.status === "ready-vec" ||
-            raw.status === "blocked") &&
-            typeof raw.providerFingerprint === "string" &&
-            typeof raw.lastCheckedAt === "string") {
-            const status = {
-                status: raw.status,
-                providerFingerprint: raw.providerFingerprint,
-                lastCheckedAt: raw.lastCheckedAt,
-            };
-            if (typeof raw.reason === "string")
-                status.reason = raw.reason;
-            if (typeof raw.message === "string")
-                status.message = raw.message;
-            if (typeof raw.entryCount === "number")
-                status.entryCount = raw.entryCount;
-            if (typeof raw.embeddingCount === "number")
-                status.embeddingCount = raw.embeddingCount;
-            return status;
-        }
-    }
-    catch {
-        // ignore corrupt or missing semantic status
-    }
-    return undefined;
-}
-export function writeSemanticStatus(status) {
-    semanticStatusMutationForTests?.("write");
-    const dir = getCacheDir();
-    fs.mkdirSync(dir, { recursive: true });
-    writeFileAtomic(getSemanticStatusPath(), `${JSON.stringify(status, null, 2)}\n`);
-}
-export function clearSemanticStatus() {
-    semanticStatusMutationForTests?.("clear");
-    try {
-        fs.unlinkSync(getSemanticStatusPath());
-    }
-    catch {
-        // ignore missing file
-    }
-}
-/** How long a "blocked" status is retained before the system retries. 24 hours. */
-export const BLOCKED_TTL_MS = 24 * 60 * 60 * 1000;
-export function getEffectiveSemanticStatus(config, status = readSemanticStatus()) {
-    if (config.semanticSearchMode === "off")
-        return "disabled";
-    if (!status)
-        return "pending";
-    const fingerprint = deriveSemanticProviderFingerprint(config.embedding);
-    if (status.providerFingerprint !== fingerprint)
-        return "pending";
-    // Auto-recovery: if blocked status is older than BLOCKED_TTL_MS, treat as pending
-    // so the next index run will re-attempt semantic setup.
-    if (status.status === "blocked") {
-        const checkedAt = new Date(status.lastCheckedAt).getTime();
-        if (Number.isNaN(checkedAt) || Date.now() - checkedAt > BLOCKED_TTL_MS) {
-            return "pending";
-        }
-    }
-    return status.status;
-}
-export function isSemanticRuntimeReady(status) {
-    return status === "ready-js" || status === "ready-vec";
-}
-export function classifySemanticFailure(message) {
-    const lower = message.toLowerCase();
-    if (lower.includes("401") || lower.includes("403") || lower.includes("auth") || lower.includes("unauthorized")) {
-        return "remote-auth";
-    }
-    if (lower.includes("429") || lower.includes("rate limit") || lower.includes("quota")) {
-        return "remote-rate-limit";
-    }
-    if (lower.includes("eacces") || lower.includes("permission denied")) {
-        return "permission-denied";
-    }
-    // Native library / linker errors must be checked before the generic ONNX
-    // match because Alpine/musl linker errors often contain "onnxruntime" in
-    // the library path (e.g. onnxruntime_binding.node).
-    if (lower.includes("shared library") ||
-        lower.includes("glibc") ||
-        lower.includes("musl") ||
-        lower.includes("libc.so")) {
-        return "native-lib-missing";
-    }
-    if (lower.includes("onnx") || lower.includes("onnxruntime")) {
-        return "onnx-runtime-failed";
-    }
-    if (lower.includes("404") || lower.includes("model not found") || lower.includes("bad request")) {
-        return "remote-model";
-    }
-    if (lower.includes("transformers") ||
-        lower.includes("missing-package") ||
-        lower.includes("local embedding dependency is unavailable")) {
-        return "missing-package";
-    }
-    if (lower.includes("download")) {
-        return "local-model-download";
-    }
-    if (lower.includes("dimension mismatch")) {
-        return "dimension-mismatch";
-    }
-    if (lower.includes("db") || lower.includes("sqlite") || lower.includes("cache dir")) {
-        return "db-open";
-    }
-    if (lower.includes("timeout") ||
-        lower.includes("unreachable") ||
-        lower.includes("refused") ||
-        lower.includes("network") ||
-        lower.includes("fetch")) {
-        return "remote-network";
-    }
-    return "unknown";
-}