akm-cli 0.9.5 → 0.9.7

package/dist/workflows/source-ir/schema.js

@@ -14,7 +14,7 @@ import { validateExtraParams } from "../../core/extra-params.js";
 import { checkJsonSchemaDefinition } from "../../core/json-schema.js";
 import { parseReference } from "../program/expressions.js";
 import { PROGRAM_RETRY_REASONS } from "../program/schema.js";
-import { jsonBytes, utf8Bytes, WORKFLOW_ENGINE_NAME_PATTERN, WORKFLOW_ENV_VAR_NAME_PATTERN, WORKFLOW_MAX_CONCURRENCY, WORKFLOW_MAX_ENGINE_NAME_LENGTH, WORKFLOW_MAX_EXEC_ARG_BYTES, WORKFLOW_MAX_EXEC_ARGV, WORKFLOW_MAX_EXEC_CWD_LENGTH, WORKFLOW_MAX_EXEC_PASS_ENV, WORKFLOW_MAX_EXTRA_PARAMS_BYTES, WORKFLOW_MAX_GATE_LOOPS, WORKFLOW_MAX_INPUTS, WORKFLOW_MAX_MAP_EXPANSION, WORKFLOW_MAX_OUTPUTS, WORKFLOW_MAX_PARAMS, WORKFLOW_MAX_RETRIES, WORKFLOW_MAX_ROUTE_BRANCHES, WORKFLOW_MAX_SCHEMA_BYTES, WORKFLOW_MAX_TIMEOUT_MS, } from "../resource-limits.js";
+import { jsonBytes, WORKFLOW_ENGINE_NAME_PATTERN, WORKFLOW_ENV_VAR_NAME_PATTERN, WORKFLOW_MAX_CONCURRENCY, WORKFLOW_MAX_ENGINE_NAME_LENGTH, WORKFLOW_MAX_EXTRA_PARAMS_BYTES, WORKFLOW_MAX_SCHEMA_BYTES, WORKFLOW_MAX_TIMEOUT_MS, } from "../resource-limits.js";
 import { compareWorkflowSourceCodePoints } from "./compare.js";
 import { canonicalizeWorkflowCron, canonicalizeWorkflowRun, canonicalizeWorkflowWorkingDirectory, classifyWorkflowStepUses, rejectNulInArgv, validateWorkflowBuiltinCommand, WorkflowSourceSemanticError, } from "./semantics.js";
 export const WORKFLOW_SOURCE_IR_VERSION = 1;
@@ -255,7 +255,7 @@ function validateStep(value, jobId, index, stepIds, options) {
     }
     validateMap(step.map, `step ${id} map`);
     validateRoute(step.route, `step ${id} route`);
-    optionalStringList(step.inputs, `step ${id} inputs`, WORKFLOW_MAX_INPUTS);
+    optionalStringList(step.inputs, `step ${id} inputs`, Infinity);
     if (Array.isArray(step.inputs)) {
         for (const [inputIndex, input] of step.inputs.entries())
             validateReference(input, `step ${id} inputs[${inputIndex}]`);
@@ -277,12 +277,7 @@ function validateExec(value, location, options) {
         return;
     const exec = record(value, location);
     keys(exec, ["command", "cwd", "passEnv"], location);
-    stringList(exec.command, `${location}.command`, WORKFLOW_MAX_EXEC_ARGV, false);
-    for (const [index, argument] of exec.command.entries()) {
-        if (utf8Bytes(argument) > WORKFLOW_MAX_EXEC_ARG_BYTES) {
-            fail(`${location}.command[${index}] exceeds ${WORKFLOW_MAX_EXEC_ARG_BYTES} bytes`);
-        }
-    }
+    stringList(exec.command, `${location}.command`, Infinity, false);
     try {
         rejectNulInArgv(exec.command);
     }
@@ -291,9 +286,6 @@ function validateExec(value, location, options) {
     }
     optionalString(exec.cwd, `${location}.cwd`);
     if (exec.cwd !== undefined) {
-        if (exec.cwd.length > WORKFLOW_MAX_EXEC_CWD_LENGTH) {
-            fail(`${location}.cwd exceeds ${WORKFLOW_MAX_EXEC_CWD_LENGTH} characters`);
-        }
         try {
             exec.cwd = canonicalizeWorkflowWorkingDirectory(exec.cwd, options.workspaceRoot);
         }
@@ -302,7 +294,7 @@ function validateExec(value, location, options) {
         }
     }
     if (exec.passEnv !== undefined) {
-        stringList(exec.passEnv, `${location}.passEnv`, WORKFLOW_MAX_EXEC_PASS_ENV, false);
+        stringList(exec.passEnv, `${location}.passEnv`, Infinity, false);
     }
     if (Array.isArray(exec.passEnv)) {
         for (const name of exec.passEnv) {
@@ -359,8 +351,8 @@ function validateRetry(value, location) {
         return;
     const retry = record(value, location);
     keys(retry, ["max", "on"], location);
-    if (!Number.isSafeInteger(retry.max) || retry.max < 0 || retry.max > WORKFLOW_MAX_RETRIES) {
-        fail(`${location}.max must be an integer from 0 through ${WORKFLOW_MAX_RETRIES}`);
+    if (!Number.isSafeInteger(retry.max) || retry.max < 0) {
+        fail(`${location}.max must be a non-negative integer`);
     }
     stringList(retry.on, `${location}.on`, PROGRAM_RETRY_REASONS.length, false);
     for (const reason of retry.on) {
@@ -393,10 +385,8 @@ function validateRoute(value, location) {
     keys(route, ["input", "branches", "defaultStepId"], location);
     nonEmptyString(route.input, `${location}.input`);
     validateReference(route.input, `${location}.input`);
-    if (!Array.isArray(route.branches) ||
-        route.branches.length === 0 ||
-        route.branches.length > WORKFLOW_MAX_ROUTE_BRANCHES) {
-        fail(`${location}.branches must contain 1 through ${WORKFLOW_MAX_ROUTE_BRANCHES} entries`);
+    if (!Array.isArray(route.branches) || route.branches.length === 0) {
+        fail(`${location}.branches must be a non-empty array`);
     }
     const matches = new Set();
     for (const [index, value] of route.branches.entries()) {
@@ -416,11 +406,8 @@ function validateGate(value, location) {
         return;
     const gate = record(value, location);
     keys(gate, ["maxLoops", "rubric"], location);
-    if (gate.maxLoops !== undefined &&
-        (!Number.isSafeInteger(gate.maxLoops) ||
-            gate.maxLoops < 1 ||
-            gate.maxLoops > WORKFLOW_MAX_GATE_LOOPS)) {
-        fail(`${location}.maxLoops must be an integer from 1 through ${WORKFLOW_MAX_GATE_LOOPS}`);
+    if (gate.maxLoops !== undefined && (!Number.isSafeInteger(gate.maxLoops) || gate.maxLoops < 1)) {
+        fail(`${location}.maxLoops must be an integer of at least 1`);
     }
     optionalString(gate.rubric, `${location}.rubric`);
 }
@@ -453,8 +440,8 @@ function validateParams(value) {
     if (value === undefined)
         return;
     const params = record(value, "params");
-    if (Object.keys(params).length === 0 || Object.keys(params).length > WORKFLOW_MAX_PARAMS) {
-        fail(`params must contain 1 through ${WORKFLOW_MAX_PARAMS} entries`);
+    if (Object.keys(params).length === 0) {
+        fail(`params must contain at least one entry`);
     }
     for (const [name, schema] of Object.entries(params)) {
         if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name))
@@ -472,8 +459,8 @@ function validateOutputs(value) {
     if (value === undefined)
         return;
     const outputs = record(value, "outputs");
-    if (Object.keys(outputs).length === 0 || Object.keys(outputs).length > WORKFLOW_MAX_OUTPUTS) {
-        fail(`outputs must contain 1 through ${WORKFLOW_MAX_OUTPUTS} entries`);
+    if (Object.keys(outputs).length === 0) {
+        fail(`outputs must contain at least one entry`);
     }
     for (const [name, declaration] of Object.entries(outputs)) {
         if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name))
@@ -496,9 +483,6 @@ function validateBudget(value) {
             fail(`budget.${key} must be a positive integer`);
         }
     }
-    if (typeof budget.maxUnits === "number" && budget.maxUnits > WORKFLOW_MAX_MAP_EXPANSION) {
-        fail(`budget.maxUnits must be at most ${WORKFLOW_MAX_MAP_EXPANSION}`);
-    }
 }
 function validateLlm(value, location) {
     if (value === undefined)

package/dist/workflows/validator.js

@@ -16,7 +16,7 @@
  * resource limits).
  */
 import { bundleRefToString, parseBundleRef } from "../core/asset/asset-ref.js";
-import { utf8Bytes, WORKFLOW_MAX_INSTRUCTION_BYTES, WORKFLOW_MAX_PARAMS, WORKFLOW_MAX_STEPS } from "./resource-limits.js";
+import { utf8Bytes, WORKFLOW_MAX_INSTRUCTION_BYTES } from "./resource-limits.js";
 export function runSemanticChecks(draft, frontmatterData, frontmatterEndLine, errors) {
     checkXrefs(frontmatterData.xrefs, frontmatterEndLine, errors);
     checkResourceLimits(draft, errors);
@@ -43,12 +43,6 @@ function checkXrefs(value, line, errors) {
     }
 }
 function checkResourceLimits(draft, errors) {
-    if (draft.steps.length > WORKFLOW_MAX_STEPS) {
-        errors.push({ line: 1, message: `Workflow must contain at most ${WORKFLOW_MAX_STEPS} steps.` });
-    }
-    if (Object.keys(draft.params ?? {}).length > WORKFLOW_MAX_PARAMS) {
-        errors.push({ line: 1, message: `Workflow must contain at most ${WORKFLOW_MAX_PARAMS} parameters.` });
-    }
     for (const step of draft.steps) {
         if (step.instructions && utf8Bytes(step.instructions.text) > WORKFLOW_MAX_INSTRUCTION_BYTES) {
             errors.push({

package/docs/reference/cli.md

@@ -2032,7 +2032,9 @@ when one exists.
 Scan bundle markdown files for structural issues: unquoted colons, missing
 `updated` field, orphaned stubs, placeholder stubs, missing `name`/`type`,
 stale paths, and broken refs — in body text and in
-`refs`/`xrefs`/`supersededBy`/`contradictedBy` frontmatter. Also reports
+`refs`/`xrefs`/`supersededBy`/`contradictedBy` frontmatter. A belief edge
+pointing at a memory that `akm improve` pruned resolves through the archive
+tombstone under `.akm/memory-cleanup/archive/` and is not reported (#884). Also reports
 `dangerous-env-key` findings for env files (the same key set `akm bundle add`
 enforces — see [Dangerous env key audit](#dangerous-env-key-audit) — but
 non-blocking here; `lint` only warns). `--type workflows` structurally parses
@@ -2046,6 +2048,7 @@ akm lint --fix                  # Auto-fix Tier-1 issues in place
 akm lint --type workflows       # Only lint one asset type
 akm lint --dir ~/other-bundle    # Override the bundle root (default: from config)
 akm lint --fail-on-flagged      # CI-friendly: exit non-zero when summary.flagged > 0
+akm lint --prune-dangling-edges # Opt-in: drop belief edges whose target is gone
 ```
 
 | Flag | Description |
@@ -2054,6 +2057,7 @@ akm lint --fail-on-flagged      # CI-friendly: exit non-zero when summary.flagge
 | `--dir` | Override the bundle root directory (default: from config) |
 | `--type` | Only lint assets of this type (e.g. `workflows`, `tasks`, `memories`). **akm bundles only** — every other adapter validates the whole bundle and warns on stderr that the flag had no effect. |
 | `--fail-on-flagged` | Exit non-zero when `summary.flagged > 0`. Default: exit 0 regardless of findings. |
+| `--prune-dangling-edges` | Opt-in repair (#884): drop `supersededBy`/`contradictedBy` entries whose target has neither a file nor a prune tombstone. **Not** implied by `--fix` — it edits well-formed files to delete a belief-graph claim, so review a plain `akm lint` report first. Clears the same `writable: false` gate `--fix` does. |
 
 Returns `fixed[]` and `flagged[]` arrays plus a `summary: { fixed, flagged }`
 count. Each entry carries `file`, `issue`, `detail`, and whether it was

package/docs/reference/configuration.md

@@ -366,7 +366,7 @@ reference, same rules as engine `apiKey`), `dimension`, `localModel`,
 
 | Key | Purpose |
 | --- | --- |
-| `search.graphBoost.*` | Entity-graph relevance boost: `directBoostPerEntity`/`directBoostCap` (directly related entities), `hopBoostPerEntity`/`hopBoostCap` (multi-hop, capped at `maxHops` ≤ 3), `confidenceMode` (`off`\|`blend`\|`multiply`, default `blend`), `confidenceWeight` (0–1, default `0.2`) |
+| `search.graphBoost.*` | Entity-graph relevance boost: `directBoostPerEntity`/`directBoostCap` (directly related entities), `hopBoostPerEntity`/`hopBoostCap` (multi-hop, capped at `maxHops` ≤ 3), `confidenceMode` (`blend`, the only supported value), `confidenceWeight` (0–1, default `0.2`) |
 
 ## Feedback
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "akm-cli",
-  "version": "0.9.5",
+  "version": "0.9.7",
   "type": "module",
   "description": "akm (Agent Knowledge Manager) — a portable, local-first capability library for AI agents. Discover, load, share, and improve reusable skills, scripts, workflows, and knowledge across any shell-capable coding agent, including Claude Code, OpenCode, and Cursor.",
   "keywords": [

package/schemas/akm-config.json

@@ -57,9 +57,6 @@
                 "type": "integer",
                 "exclusiveMinimum": 0
               },
-              "supportsJsonSchema": {
-                "type": "boolean"
-              },
               "extraParams": {
                 "type": "object",
                 "additionalProperties": {}
@@ -572,9 +569,7 @@
             "confidenceMode": {
               "type": "string",
               "enum": [
-                "off",
-                "blend",
-                "multiply"
+                "blend"
               ],
               "default": "blend"
             },
@@ -1747,9 +1742,6 @@
                     "type": "integer",
                     "exclusiveMinimum": 0
                   },
-                  "supportsJsonSchema": {
-                    "type": "boolean"
-                  },
                   "extraParams": {
                     "type": "object",
                     "additionalProperties": {}
@@ -2262,9 +2254,7 @@
                 "confidenceMode": {
                   "type": "string",
                   "enum": [
-                    "off",
-                    "blend",
-                    "multiply"
+                    "blend"
                   ],
                   "default": "blend"
                 },
@@ -3420,14 +3410,8 @@
           "type": "integer",
           "exclusiveMinimum": 0
         },
-        "capabilities": {
-          "type": "object",
-          "properties": {
-            "structuredOutput": {
-              "type": "boolean"
-            }
-          },
-          "additionalProperties": true
+        "supportsJsonSchema": {
+          "type": "boolean"
         },
         "extraParams": {
           "type": "object",
@@ -3443,9 +3427,6 @@
         "reasoningEffort": {
           "type": "string",
           "minLength": 1
-        },
-        "supportsJsonSchema": {
-          "type": "boolean"
         }
       },
       "required": [

package/schemas/akm-task.json

@@ -27,7 +27,6 @@
     },
     "inputs": {
       "type": "object",
-      "maxProperties": 128,
       "propertyNames": { "$ref": "#/definitions/taskInputName" },
       "additionalProperties": { "$ref": "#/definitions/inputDeclaration" }
     },
@@ -105,7 +104,7 @@
       "items": { "type": "string", "pattern": "^[A-Za-z_][A-Za-z0-9_]*$" }
     },
     "maxSteps": { "type": "integer", "minimum": 1, "maximum": 9007199254740991 },
-    "maxRetries": { "type": "integer", "minimum": 0, "maximum": 100 }
+    "maxRetries": { "type": "integer", "minimum": 0 }
   },
   "oneOf": [
     {

package/schemas/akm-workflow.json

@@ -22,7 +22,6 @@
     "params": {
       "type": "object",
       "minProperties": 1,
-      "maxProperties": 128,
       "description": "Run parameters: param name -> JSON Schema declaration. Names must be params.<name>-addressable identifiers.",
       "propertyNames": {
         "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
@@ -34,7 +33,6 @@
     "outputs": {
       "type": "object",
       "minProperties": 1,
-      "maxProperties": 64,
       "description": "Named, optionally schema-validated projections of step artifacts, exported when the run completes. Names must be steps.<child>.output.<name>-addressable identifiers. Each entry: { from: steps.<id>.output(.<seg>)*, schema?: <bounded JSON Schema> }. Markdown-frontmatter only.",
       "propertyNames": {
         "pattern": "^[A-Za-z_][A-Za-z0-9_]*$"
@@ -52,7 +50,6 @@
     "steps": {
       "type": "array",
       "minItems": 1,
-      "maxItems": 256,
       "items": {
         "$ref": "#/definitions/step"
       }
@@ -188,7 +185,6 @@
         "max": {
           "type": "integer",
           "minimum": 0,
-          "maximum": 100,
           "description": "Maximum retry attempts per unit."
         },
         "on": {
@@ -213,7 +209,6 @@
         "max_units": {
           "type": "integer",
           "minimum": 1,
-          "maximum": 10000,
           "description": "Ceiling on total dispatched units across the run (seeded from journaled unit rows)."
         }
       }
@@ -252,25 +247,21 @@
           "type": "array",
           "description": "argv; command[0] is the program, resolved through PATH. Never shell-parsed.",
           "minItems": 1,
-          "maxItems": 64,
           "items": {
             "type": "string",
-            "minLength": 1,
-            "maxLength": 4096
+            "minLength": 1
           }
         },
         "cwd": {
           "type": "string",
           "description": "Optional RELATIVE working directory inside the unit's working directory (its fresh worktree under `isolation: worktree`). Absolute paths, Windows drive letters, \"~\", and \"..\" segments are rejected here, and containment is re-checked against the resolved base — symlinks included — before the command is spawned.",
           "minLength": 1,
-          "maxLength": 1024,
           "pattern": "^(?!/|\\\\|~|[A-Za-z]:)(?!.*(?:^|[/\\\\])\\.\\.(?:[/\\\\]|$)).+$"
         },
         "pass_env": {
           "type": "array",
           "description": "Extra environment variable NAMES copied through from akm's own environment on top of the default allowlist — for a per-machine toolchain variable (e.g. CARGO_HOME) that no committed `env:` asset could carry. NAMES ONLY: values never appear in a workflow, and unlike `env:` bindings these values are NOT redacted from the command's output, so never list a credential here.",
           "minItems": 1,
-          "maxItems": 32,
           "uniqueItems": true,
           "items": {
             "type": "string",
@@ -398,7 +389,6 @@
         "when": {
           "type": "array",
           "minItems": 1,
-          "maxItems": 256,
           "items": {
             "$ref": "#/definitions/routeBranch"
           }
@@ -416,7 +406,6 @@
         "max_loops": {
           "type": "integer",
           "minimum": 1,
-          "maximum": 100,
           "description": "Evaluator-optimizer loop bound."
         }
       }
@@ -424,7 +413,6 @@
     "inputs": {
       "type": "array",
       "minItems": 1,
-      "maxItems": 64,
       "uniqueItems": true,
       "items": {
         "$ref": "#/definitions/reference"

package/dist/assets/improve-strategies/frequent.json

@@ -1,15 +0,0 @@
-{
-  "description": "Frequent inference pass — memory inference, graph extraction, and reflect; improve-stage extract off.",
-  "processes": {
-    "reflect": { "enabled": true },
-    "distill": { "enabled": false },
-    "consolidate": { "enabled": false },
-    "memoryInference": { "enabled": true },
-    "graphExtraction": { "enabled": true },
-    "extract": { "enabled": false, "minNewSessions": 3, "triage": { "enabled": true, "minScore": 2 } },
-    "triage": { "enabled": false },
-    "validation": { "enabled": false },
-    "proactiveMaintenance": { "enabled": false }
-  },
-  "sync": { "enabled": true, "push": true }
-}

package/dist/assets/improve-strategies/memory-focus.json

@@ -1,15 +0,0 @@
-{
-  "description": "Memory and lesson improvement only — no distill, consolidate, or graphExtraction.",
-  "processes": {
-    "reflect": { "enabled": true, "allowedTypes": ["memory", "lesson"] },
-    "distill": { "enabled": false },
-    "consolidate": { "enabled": false },
-    "memoryInference": { "enabled": true },
-    "graphExtraction": { "enabled": false },
-    "extract": { "enabled": false },
-    "triage": { "enabled": false },
-    "validation": { "enabled": false },
-    "proactiveMaintenance": { "enabled": false }
-  },
-  "sync": { "enabled": true, "push": true }
-}

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";
-}