@remnic/core 9.7.14 → 9.8.0

package/dist/chunk-PQVCH2AE.js

@@ -0,0 +1,76 @@
+import {
+  isLoggerInitialized,
+  log
+} from "./chunk-3WCASNQZ.js";
+
+// src/connectors/coerce.ts
+var BOOL_TOKENS = {
+  true: true,
+  "1": true,
+  yes: true,
+  on: true,
+  false: false,
+  "0": false,
+  no: false,
+  off: false
+};
+function warnUnrecognizedConfig(message) {
+  if (isLoggerInitialized()) {
+    log.warn(message);
+  } else {
+    console.warn(`remnic: ${message}`);
+  }
+}
+function coerceBool(value, label) {
+  if (typeof value === "boolean") return value;
+  if (typeof value === "string") {
+    const v = value.trim().toLowerCase();
+    if (v === "") return void 0;
+    if (Object.hasOwn(BOOL_TOKENS, v)) return BOOL_TOKENS[v];
+    warnUnrecognizedConfig(
+      `ignoring unrecognized boolean value ${JSON.stringify(value)}${label ? ` for ${label}` : ""}; expected true|false|1|0|yes|no|on|off \u2014 using default`
+    );
+  }
+  return void 0;
+}
+function coerceInstallExtension(value) {
+  return coerceBool(value, "installExtension");
+}
+function coerceNumber(value, label) {
+  if (typeof value === "number") {
+    if (Number.isFinite(value)) return value;
+    warnUnrecognizedConfig(
+      `ignoring non-finite numeric value ${JSON.stringify(value)}${label ? ` for ${label}` : ""}; expected a finite number \u2014 using default`
+    );
+    return void 0;
+  }
+  if (typeof value === "string") {
+    const trimmed = value.trim();
+    if (trimmed.length === 0) return void 0;
+    const n = Number(trimmed);
+    if (Number.isFinite(n)) return n;
+    warnUnrecognizedConfig(
+      `ignoring unrecognized numeric value ${JSON.stringify(value)}${label ? ` for ${label}` : ""}; expected a finite number \u2014 using default`
+    );
+  }
+  return void 0;
+}
+function coerceBooleanLike(value, label) {
+  if (typeof value === "number") {
+    if (value === 1) return true;
+    if (value === 0) return false;
+    warnUnrecognizedConfig(
+      `ignoring unrecognized boolean value ${JSON.stringify(value)}${label ? ` for ${label}` : ""}; expected true|false|1|0|yes|no|on|off \u2014 using default`
+    );
+    return void 0;
+  }
+  return coerceBool(value, label);
+}
+
+export {
+  coerceBool,
+  coerceInstallExtension,
+  coerceNumber,
+  coerceBooleanLike
+};
+//# sourceMappingURL=chunk-PQVCH2AE.js.map

package/dist/chunk-PQVCH2AE.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/connectors/coerce.ts"],"sourcesContent":["/**\n * Shared boolean coercion helpers.\n *\n * Extracted from connectors/index.ts so that both config.ts and\n * connectors/index.ts can import them without creating a circular dependency.\n */\n\nimport { isLoggerInitialized, log } from \"../logger.js\";\n\nconst BOOL_TOKENS: Record<string, boolean> = {\n  true: true, \"1\": true, yes: true, on: true,\n  false: false, \"0\": false, no: false, off: false,\n};\n\n/**\n * Surface a \"present but unrecognized config value\" diagnostic. Routes through\n * the installed logger when a host has called `initLogger`, and otherwise falls\n * back to `console.warn` so the standalone `@remnic/core` path (documented to\n * call `parseConfig()` without a logger) does not silently discard the warning\n * and re-introduce the fail-open default this whole change exists to prevent.\n */\nexport function warnUnrecognizedConfig(message: string): void {\n  if (isLoggerInitialized()) {\n    log.warn(message);\n  } else {\n    console.warn(`remnic: ${message}`);\n  }\n}\n\n/**\n * Generic boolean coercion: converts string representations of booleans\n * (e.g. from CLI `--config someFlag=false`) to proper boolean values.\n * Accepts the same truthy/falsy strings that common shells and env vars use.\n *\n * Returns `undefined` when the value is neither a boolean nor a recognised\n * string, so callers can fall back to a default.\n *\n * A value that is PRESENT but unrecognised (a non-empty string like `\"disabled\"`\n * or a typo like `\"fales\"`) is logged at warn level before returning `undefined`,\n * so an operator typo does not silently take the caller's default — which is\n * frequently a fail-open `?? true`. Absent values (`undefined`/`null`/empty\n * string) fall through silently: absence legitimately means \"use the default\".\n * Pass `label` (the config key) to make the warning actionable.\n *\n * CLAUDE.md gotcha #36: String \"false\" is truthy in JavaScript.\n * CLAUDE.md gotcha #28: Coerce CLI values to expected types at input boundaries.\n * CLAUDE.md gotcha #51: Reject/flag present-but-unrecognized values; don't\n * silently default them.\n */\nexport function coerceBool(value: unknown, label?: string): boolean | undefined {\n  if (typeof value === \"boolean\") return value;\n  if (typeof value === \"string\") {\n    const v = value.trim().toLowerCase();\n    if (v === \"\") return undefined;\n    if (Object.hasOwn(BOOL_TOKENS, v)) return BOOL_TOKENS[v];\n    warnUnrecognizedConfig(\n      `ignoring unrecognized boolean value ${JSON.stringify(value)}${label ? ` for ${label}` : \"\"}; ` +\n        `expected true|false|1|0|yes|no|on|off — using default`,\n    );\n  }\n  return undefined;\n}\n\n/**\n * Coerce the `installExtension` config value from a string (e.g. from CLI\n * `--config installExtension=false`) to a proper boolean.\n *\n * Delegates to the generic `coerceBool` helper. Kept for backward compatibility.\n */\nexport function coerceInstallExtension(value: unknown): boolean | undefined {\n  return coerceBool(value, \"installExtension\");\n}\n\n/**\n * Generic numeric coercion: accepts a finite number or a string that\n * parses cleanly to one. Returns `undefined` otherwise so callers can\n * fall back to a default.\n *\n * Rules:\n * - number: returned as-is only if finite (NaN / ±Infinity → undefined).\n * - string: trimmed, parsed with `Number()`. Returns `undefined` on\n *   empty, NaN, or Infinity.\n *\n * A PRESENT but unparseable string (a non-empty value that is not a finite\n * number) is logged at warn level before returning `undefined`, for the same\n * reason as `coerceBool`: a typo must not silently take the caller's default.\n * Absent values (`undefined`/`null`/empty string) fall through silently.\n * Pass `label` (the config key) to make the warning actionable.\n *\n * CLAUDE.md gotcha #28: Coerce CLI values to expected types at input boundaries.\n * CLAUDE.md gotcha #51: Flag present-but-unrecognized values.\n */\nexport function coerceNumber(value: unknown, label?: string): number | undefined {\n  if (typeof value === \"number\") {\n    if (Number.isFinite(value)) return value;\n    warnUnrecognizedConfig(\n      `ignoring non-finite numeric value ${JSON.stringify(value)}${label ? ` for ${label}` : \"\"}; ` +\n        `expected a finite number — using default`,\n    );\n    return undefined;\n  }\n  if (typeof value === \"string\") {\n    const trimmed = value.trim();\n    if (trimmed.length === 0) return undefined;\n    const n = Number(trimmed);\n    if (Number.isFinite(n)) return n;\n    warnUnrecognizedConfig(\n      `ignoring unrecognized numeric value ${JSON.stringify(value)}${label ? ` for ${label}` : \"\"}; ` +\n        `expected a finite number — using default`,\n    );\n  }\n  return undefined;\n}\n\n/**\n * Config-layer boolean coercion. Adds numeric 1/0 handling on top of the\n * canonical `coerceBool` because config values can arrive as JSON numbers,\n * which `coerceBool` intentionally does not accept. Any other present-but-\n * unrecognized value (string typo or out-of-range number) warns and returns\n * `undefined` so a caller's fail-open `?? true` default is not taken silently.\n *\n * CLAUDE.md gotcha #36: string \"false\" is truthy in JavaScript.\n */\nexport function coerceBooleanLike(value: unknown, label?: string): boolean | undefined {\n  if (typeof value === \"number\") {\n    if (value === 1) return true;\n    if (value === 0) return false;\n    warnUnrecognizedConfig(\n      `ignoring unrecognized boolean value ${JSON.stringify(value)}${label ? ` for ${label}` : \"\"}; ` +\n        `expected true|false|1|0|yes|no|on|off — using default`,\n    );\n    return undefined;\n  }\n  return coerceBool(value, label);\n}\n"],"mappings":";;;;;;AASA,IAAM,cAAuC;AAAA,EAC3C,MAAM;AAAA,EAAM,KAAK;AAAA,EAAM,KAAK;AAAA,EAAM,IAAI;AAAA,EACtC,OAAO;AAAA,EAAO,KAAK;AAAA,EAAO,IAAI;AAAA,EAAO,KAAK;AAC5C;AASO,SAAS,uBAAuB,SAAuB;AAC5D,MAAI,oBAAoB,GAAG;AACzB,QAAI,KAAK,OAAO;AAAA,EAClB,OAAO;AACL,YAAQ,KAAK,WAAW,OAAO,EAAE;AAAA,EACnC;AACF;AAsBO,SAAS,WAAW,OAAgB,OAAqC;AAC9E,MAAI,OAAO,UAAU,UAAW,QAAO;AACvC,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,IAAI,MAAM,KAAK,EAAE,YAAY;AACnC,QAAI,MAAM,GAAI,QAAO;AACrB,QAAI,OAAO,OAAO,aAAa,CAAC,EAAG,QAAO,YAAY,CAAC;AACvD;AAAA,MACE,uCAAuC,KAAK,UAAU,KAAK,CAAC,GAAG,QAAQ,QAAQ,KAAK,KAAK,EAAE;AAAA,IAE7F;AAAA,EACF;AACA,SAAO;AACT;AAQO,SAAS,uBAAuB,OAAqC;AAC1E,SAAO,WAAW,OAAO,kBAAkB;AAC7C;AAqBO,SAAS,aAAa,OAAgB,OAAoC;AAC/E,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,OAAO,SAAS,KAAK,EAAG,QAAO;AACnC;AAAA,MACE,qCAAqC,KAAK,UAAU,KAAK,CAAC,GAAG,QAAQ,QAAQ,KAAK,KAAK,EAAE;AAAA,IAE3F;AACA,WAAO;AAAA,EACT;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,UAAU,MAAM,KAAK;AAC3B,QAAI,QAAQ,WAAW,EAAG,QAAO;AACjC,UAAM,IAAI,OAAO,OAAO;AACxB,QAAI,OAAO,SAAS,CAAC,EAAG,QAAO;AAC/B;AAAA,MACE,uCAAuC,KAAK,UAAU,KAAK,CAAC,GAAG,QAAQ,QAAQ,KAAK,KAAK,EAAE;AAAA,IAE7F;AAAA,EACF;AACA,SAAO;AACT;AAWO,SAAS,kBAAkB,OAAgB,OAAqC;AACrF,MAAI,OAAO,UAAU,UAAU;AAC7B,QAAI,UAAU,EAAG,QAAO;AACxB,QAAI,UAAU,EAAG,QAAO;AACxB;AAAA,MACE,uCAAuC,KAAK,UAAU,KAAK,CAAC,GAAG,QAAQ,QAAQ,KAAK,KAAK,EAAE;AAAA,IAE7F;AACA,WAAO;AAAA,EACT;AACA,SAAO,WAAW,OAAO,KAAK;AAChC;","names":[]}

package/dist/{chunk-AXTXN4T6.js → chunk-PWFCHOB3.js}

@@ -1,6 +1,6 @@
 import {
   log
-} from "./chunk-37CTGERM.js";
+} from "./chunk-3WCASNQZ.js";
 
 // src/extraction-judge-training.ts
 import path from "path";
@@ -157,4 +157,4 @@ export {
   readJudgeTrainingPairs,
   isValidTrainingPair
 };
-//# sourceMappingURL=chunk-AXTXN4T6.js.map
+//# sourceMappingURL=chunk-PWFCHOB3.js.map

package/dist/{chunk-FDPZVY6D.js → chunk-QFN4U7AG.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-Z5LAYHGJ.js";
 import {
   log
-} from "./chunk-37CTGERM.js";
+} from "./chunk-3WCASNQZ.js";
 
 // src/session-observer-state.ts
 import path from "path";
@@ -323,4 +323,4 @@ export {
   normalizeObserverBands,
   SessionObserverState
 };
-//# sourceMappingURL=chunk-FDPZVY6D.js.map
+//# sourceMappingURL=chunk-QFN4U7AG.js.map

package/dist/{chunk-K2ZLHESQ.js → chunk-QIEUU4UK.js}

@@ -3,7 +3,7 @@ import {
 } from "./chunk-JUC24CTX.js";
 import {
   log
-} from "./chunk-37CTGERM.js";
+} from "./chunk-3WCASNQZ.js";
 
 // src/resolve-provider-secret.ts
 import path from "path";
@@ -142,4 +142,4 @@ export {
   __setGatewayResolverForTest,
   __setGatewayRuntimeAuthForModelForTest
 };
-//# sourceMappingURL=chunk-K2ZLHESQ.js.map
+//# sourceMappingURL=chunk-QIEUU4UK.js.map

package/dist/{chunk-AHLPZ2SF.js → chunk-QJAQNXWI.js}

@@ -1,6 +1,6 @@
 import {
   resolveEnsureCollectionArgs
-} from "./chunk-WU46YPY6.js";
+} from "./chunk-YV32N67O.js";
 import {
   QMD_PROBE_RETRY_BACKOFF_MS,
   QMD_PROBE_TIMEOUT_MS,
@@ -13,24 +13,30 @@ import {
   qmdVersionToString,
   resolveQmdCapabilities
 } from "./chunk-64UDOIMI.js";
+import {
+  EMPTY_QMD_STATUS,
+  embedQmdFiles,
+  fetchQmdStatus
+} from "./chunk-IUM3VSHI.js";
 import {
   launchProcess
 } from "./chunk-O75CRYGF.js";
 import {
+  clearQmdResultCaches,
   getCachedQmdSearch,
   setCachedQmdSearch
-} from "./chunk-X47LWMKA.js";
+} from "./chunk-XMMESCPD.js";
 import {
   mergeEnv
 } from "./chunk-JUC24CTX.js";
-import {
-  log
-} from "./chunk-37CTGERM.js";
 import {
   abortError,
   isAbortError,
   throwIfAborted
 } from "./chunk-PVGDJXVK.js";
+import {
+  log
+} from "./chunk-3WCASNQZ.js";
 
 // src/qmd.ts
 import { createHash } from "crypto";
@@ -1238,6 +1244,20 @@ var QmdClient = class _QmdClient {
       };
     }
   }
+  /**
+   * Query QMD collection status for embedding backlog metrics.
+   * Runs `qmd status -c <collection>` and parses the text output.
+   * Returns null fields when the command fails or output is unparseable.
+   */
+  async status() {
+    if (!this.isAvailable()) {
+      return EMPTY_QMD_STATUS;
+    }
+    if (!this.qmdCapabilities.safeStatusDeviceProbe) {
+      return EMPTY_QMD_STATUS;
+    }
+    return fetchQmdStatus((args, timeoutMs) => this.runQmdCommand(args, timeoutMs), this.collection, QMD_TIMEOUT_MS);
+  }
   isDaemonMode() {
     return this.daemonAvailable;
   }
@@ -1979,6 +1999,7 @@ var QmdClient = class _QmdClient {
         this.lastUpdateRunAtMs = at;
         globalState.lastGlobalUpdateRunAtMs = at;
       }
+      clearQmdResultCaches();
       log.debug(`QMD update completed for collection=${name}`);
     } catch (err) {
       const at = Date.now();
@@ -2008,6 +2029,21 @@ var QmdClient = class _QmdClient {
   async embedCollectionStrict(collection) {
     await this.runEmbedForCollection(collection, { perCollectionThrottle: true, strict: true });
   }
+  /** Trigger a collection-level embed for fresh writes (debounced by prioritized-embed). */
+  async embedFiles(filePaths) {
+    if (this.available === false || filePaths.length === 0) {
+      return false;
+    }
+    const result = await embedQmdFiles(
+      (args, timeoutMs) => this.runQmdCommand(args, timeoutMs),
+      this.collection,
+      filePaths,
+      3e5,
+      this.buildEmbedArgs(this.collection)
+    );
+    if (result.ok) clearQmdResultCaches();
+    return result.ok;
+  }
   async runEmbedForCollection(collection, options) {
     if (this.available === false) {
       if (options.strict) throw new Error("QMD unavailable");
@@ -2067,6 +2103,7 @@ var QmdClient = class _QmdClient {
         globalState.lastEmbedByCollectionMs[name] = at;
       }
       globalState.lastGlobalEmbedRunAtMs = at;
+      clearQmdResultCaches();
       log.debug(`QMD embed completed for collection=${name}`);
     } catch (err) {
       let failure = err;
@@ -2083,6 +2120,7 @@ var QmdClient = class _QmdClient {
           }
           globalState.lastGlobalEmbedRunAtMs = recoveredAt;
           globalState.lastGlobalEmbedFailAtMs = null;
+          clearQmdResultCaches();
           log.warn(`QMD embed for collection ${name} recovered by forcing a full vector rebuild`);
           return;
         } catch (retryErr) {
@@ -2190,4 +2228,4 @@ export {
   sharedDaemonSessionCountForTest,
   QmdClient
 };
-//# sourceMappingURL=chunk-AHLPZ2SF.js.map
+//# sourceMappingURL=chunk-QJAQNXWI.js.map