@remnic/core 9.3.639 → 9.3.640

package/dist/schemas.d.ts

@@ -275,12 +275,12 @@ declare const EntityMentionSchema: z.ZodObject<{
         title: z.ZodString;
         facts: z.ZodArray<z.ZodString, "many">;
     }, "strip", z.ZodTypeAny, {
-        key: string;
         title: string;
+        key: string;
         facts: string[];
     }, {
-        key: string;
         title: string;
+        key: string;
         facts: string[];
     }>, "many">>>;
 }, "strip", z.ZodTypeAny, {
@@ -288,8 +288,8 @@ declare const EntityMentionSchema: z.ZodObject<{
     name: string;
     facts: string[];
     structuredSections?: {
-        key: string;
         title: string;
+        key: string;
         facts: string[];
     }[] | null | undefined;
     promptedByQuestion?: string | null | undefined;
@@ -298,8 +298,8 @@ declare const EntityMentionSchema: z.ZodObject<{
     name: string;
     facts: string[];
     structuredSections?: {
-        key: string;
         title: string;
+        key: string;
         facts: string[];
     }[] | null | undefined;
     promptedByQuestion?: string | null | undefined;
@@ -584,12 +584,12 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
             title: z.ZodString;
             facts: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }, {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }>, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -597,8 +597,8 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -607,8 +607,8 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -665,8 +665,8 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -714,8 +714,8 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -952,12 +952,12 @@ declare const ExtractionResultSchema: z.ZodObject<{
             title: z.ZodString;
             facts: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }, {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }>, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -965,8 +965,8 @@ declare const ExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -975,8 +975,8 @@ declare const ExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1047,8 +1047,8 @@ declare const ExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1102,8 +1102,8 @@ declare const ExtractionResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1172,12 +1172,12 @@ declare const ConsolidationResultSchema: z.ZodObject<{
             title: z.ZodString;
             facts: z.ZodArray<z.ZodString, "many">;
         }, "strip", z.ZodTypeAny, {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }, {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }>, "many">>>;
     }, "strip", z.ZodTypeAny, {
@@ -1185,8 +1185,8 @@ declare const ConsolidationResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1195,8 +1195,8 @@ declare const ConsolidationResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1215,8 +1215,8 @@ declare const ConsolidationResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -1235,8 +1235,8 @@ declare const ConsolidationResultSchema: z.ZodObject<{
         name: string;
         facts: string[];
         structuredSections?: {
-            key: string;
             title: string;
+            key: string;
             facts: string[];
         }[] | null | undefined;
         promptedByQuestion?: string | null | undefined;

package/dist/search/factory.js

@@ -2,7 +2,7 @@ import {
   createConversationIndexRuntime,
   createConversationSearchBackend,
   createSearchBackend
-} from "../chunk-RAGXUVQW.js";
+} from "../chunk-KVUG7FF7.js";
 import "../chunk-JOASJWQR.js";
 import "../chunk-RN7MUWON.js";
 import "../chunk-3MAONBX3.js";
@@ -11,13 +11,13 @@ import "../chunk-CYEPCZN5.js";
 import "../chunk-DCGT4FPP.js";
 import "../chunk-Q4CAQGKQ.js";
 import "../chunk-CINZGPSJ.js";
-import "../chunk-Q6YIJGXJ.js";
-import "../chunk-ORFGK3XI.js";
+import "../chunk-7OGJQP7T.js";
+import "../chunk-E6ZDCOHM.js";
 import "../chunk-OIF36KGD.js";
 import "../chunk-7DTASS5T.js";
-import "../chunk-DEDTFRH2.js";
+import "../chunk-MUKXANAM.js";
 import "../chunk-FAV25DUZ.js";
-import "../chunk-NNVTUXEB.js";
+import "../chunk-O75CRYGF.js";
 import "../chunk-3ONXXHQO.js";
 import "../chunk-CPPS65WS.js";
 import "../chunk-JUC24CTX.js";

package/dist/search/index.js

@@ -2,7 +2,7 @@ import {
   createConversationIndexRuntime,
   createConversationSearchBackend,
   createSearchBackend
-} from "../chunk-RAGXUVQW.js";
+} from "../chunk-KVUG7FF7.js";
 import {
   RemoteSearchBackend
 } from "../chunk-JOASJWQR.js";
@@ -25,13 +25,13 @@ import {
   scanMemoryDir
 } from "../chunk-Q4CAQGKQ.js";
 import "../chunk-CINZGPSJ.js";
-import "../chunk-Q6YIJGXJ.js";
-import "../chunk-ORFGK3XI.js";
+import "../chunk-7OGJQP7T.js";
+import "../chunk-E6ZDCOHM.js";
 import "../chunk-OIF36KGD.js";
 import "../chunk-7DTASS5T.js";
-import "../chunk-DEDTFRH2.js";
+import "../chunk-MUKXANAM.js";
 import "../chunk-FAV25DUZ.js";
-import "../chunk-NNVTUXEB.js";
+import "../chunk-O75CRYGF.js";
 import "../chunk-3ONXXHQO.js";
 import "../chunk-CPPS65WS.js";
 import "../chunk-JUC24CTX.js";

package/dist/summarizer.js

@@ -1,16 +1,16 @@
 import {
   HourlySummarizer
-} from "./chunk-7R37SOT4.js";
+} from "./chunk-Y2XKJJEI.js";
 import "./chunk-XJNBEDFE.js";
 import "./chunk-XZ4WBBB5.js";
-import "./chunk-77NAFXUD.js";
+import "./chunk-H3HDXD3U.js";
 import "./chunk-A3BS64GV.js";
 import "./chunk-B5XMS73R.js";
 import "./chunk-7SI52C65.js";
 import "./chunk-L2EXJQJP.js";
 import "./chunk-RK6F44Y6.js";
 import "./chunk-FF4KLI5W.js";
-import "./chunk-NNVTUXEB.js";
+import "./chunk-O75CRYGF.js";
 import "./chunk-RGMVMVMF.js";
 import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";

package/dist/transfer/types.d.ts

@@ -313,13 +313,13 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         peerProfiles: boolean;
     }>;
 }, "strip", z.ZodTypeAny, {
+    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
-    schemaVersion: string;
     id: string;
     description: string;
     version: string;
@@ -334,13 +334,13 @@ declare const CapsuleBlockSchema: z.ZodObject<{
         directAnswerEnabled: boolean;
     };
 }, {
+    schemaVersion: string;
     includes: {
         procedural: boolean;
         taxonomy: boolean;
         identityAnchors: boolean;
         peerProfiles: boolean;
     };
-    schemaVersion: string;
     id: string;
     description: string;
     version: string;
@@ -464,13 +464,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             peerProfiles: boolean;
         }>;
     }, "strip", z.ZodTypeAny, {
+        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -485,13 +485,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
             directAnswerEnabled: boolean;
         };
     }, {
+        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -518,13 +518,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
     pluginVersion: string;
     includesTranscripts: boolean;
     capsule: {
+        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -551,13 +551,13 @@ declare const ExportManifestV2Schema: z.ZodObject<{
     pluginVersion: string;
     includesTranscripts: boolean;
     capsule: {
+        schemaVersion: string;
         includes: {
             procedural: boolean;
             taxonomy: boolean;
             identityAnchors: boolean;
             peerProfiles: boolean;
         };
-        schemaVersion: string;
         id: string;
         description: string;
         version: string;
@@ -683,13 +683,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 peerProfiles: boolean;
             }>;
         }, "strip", z.ZodTypeAny, {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -704,13 +704,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
                 directAnswerEnabled: boolean;
             };
         }, {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -737,13 +737,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -770,13 +770,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -815,13 +815,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;
@@ -854,13 +854,13 @@ declare const ExportBundleV2Schema: z.ZodObject<{
         pluginVersion: string;
         includesTranscripts: boolean;
         capsule: {
+            schemaVersion: string;
             includes: {
                 procedural: boolean;
                 taxonomy: boolean;
                 identityAnchors: boolean;
                 peerProfiles: boolean;
             };
-            schemaVersion: string;
             id: string;
             description: string;
             version: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.3.639",
+  "version": "9.3.640",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -2873,6 +2873,7 @@
     "@sinclair/typebox": "^0.34.0",
     "apache-arrow": "^18.1.0",
     "better-sqlite3": "^12.6.2",
+    "cross-spawn": "^7.0.6",
     "meilisearch": "^0.46.0",
     "node-gyp": "^12.3.0",
     "openai": "^6.0.0",
@@ -2885,6 +2886,7 @@
   },
   "devDependencies": {
     "@types/better-sqlite3": "^7.6.13",
+    "@types/cross-spawn": "^6.0.6",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3"

package/src/qmd.test.ts

@@ -1,4 +1,6 @@
 import assert from "node:assert/strict";
+import os from "node:os";
+import path from "node:path";
 import test from "node:test";
 
 import { parseConfig } from "./config.js";
@@ -148,6 +150,39 @@ test("post-install auto-upgrade probes PATH qmd before stale fallback paths", ()
   ]);
 });
 
+test("QmdClient preserves configured qmdPath diagnostics when all probes fail", async () => {
+  const { QmdClient } = await import("./qmd.js");
+  const originalPath = process.env.PATH;
+  const originalWindowsPath = process.env.Path;
+  const missingQmdPath = path.join(
+    os.tmpdir(),
+    `remnic-missing-qmd-${process.pid}-${Date.now()}`,
+    "qmd.cmd",
+  );
+
+  process.env.PATH = "";
+  process.env.Path = "";
+  try {
+    const client = new QmdClient("test-collection", 10, {
+      qmdPath: missingQmdPath,
+      qmdFallbackPaths: [],
+    });
+
+    assert.equal(await client.probe(), false);
+    const status = client.debugStatus();
+
+    assert.ok(status.includes(`cliPath=${missingQmdPath}`), status);
+    assert.ok(status.includes("cliPathSource=configured"), status);
+    assert.ok(status.includes("cliProbeError="), status);
+    assert.ok(!status.includes("/opt/homebrew/bin/qmd"), status);
+  } finally {
+    if (originalPath === undefined) delete process.env.PATH;
+    else process.env.PATH = originalPath;
+    if (originalWindowsPath === undefined) delete process.env.Path;
+    else process.env.Path = originalWindowsPath;
+  }
+});
+
 test("QmdClient applies chunk strategy to normal and forced embed args", async () => {
   const { QmdClient } = await import("./qmd.js");
   const client = new QmdClient("test", 5, {

package/src/qmd.ts

@@ -42,6 +42,8 @@ export interface QmdClientOptions {
   qmdSearchStrategy?: QmdSearchStrategy;
   /** Subprocess fallback command; default "query" keeps LLM expansion. Issue #1335. */
   qmdSubprocessStrategy?: QmdSubprocessStrategy;
+  /** Override automatic qmd fallback probes; defaults to known install paths. */
+  qmdFallbackPaths?: string[];
   /** Per-call daemon search timeout in ms; default 8000. Issue #1335. */
   qmdDaemonTimeoutMs?: number;
 }
@@ -1248,6 +1250,7 @@ export class QmdClient implements SearchBackend {
   private readonly qmdIndexName?: string;
   private readonly qmdSearchStrategy: QmdSearchStrategy;
   private readonly qmdSubprocessStrategy: QmdSubprocessStrategy;
+  private readonly qmdFallbackPaths: string[];
   private readonly daemonTimeoutMs: number;
   private readonly qmdRuntimeEnv: QmdRuntimeEnv;
   private qmdPathSource: "auto-path" | "auto-fallback" | "configured" = "auto-path";
@@ -1303,6 +1306,9 @@ export class QmdClient implements SearchBackend {
         : "hybrid";
     // Default "query" keeps `qmd query` (LLM expansion + rerank) per gotcha #7. Issue #1335.
     this.qmdSubprocessStrategy = opts?.qmdSubprocessStrategy === "search" ? "search" : "query";
+    this.qmdFallbackPaths = opts?.qmdFallbackPaths
+      ? opts.qmdFallbackPaths.map((candidate) => candidate.trim()).filter(Boolean)
+      : QMD_FALLBACK_PATHS;
     // Default 8000ms preserves the historical hardcoded daemon timeout. Issue #1335.
     // Floor of 1000ms avoids absurdly small values; callers wanting CPU-only HyDE
     // headroom can raise this (e.g. 20000) without code changes.
@@ -1404,9 +1410,16 @@ export class QmdClient implements SearchBackend {
   }
 
   private async probeCli(): Promise<boolean> {
+    let configuredProbeFailure: string | null = null;
     const markProbeFailure = (err: unknown): void => {
       this.lastCliProbeError = err instanceof Error ? err.message : String(err);
     };
+    const restoreConfiguredProbeFailure = (): void => {
+      if (!this.configuredQmdPath || !configuredProbeFailure) return;
+      this.qmdPath = this.configuredQmdPath;
+      this.qmdPathSource = "configured";
+      this.lastCliProbeError = configuredProbeFailure;
+    };
     const recordProbeSuccess = async (
       result: { stdout: string; stderr: string },
       qmdPath: string,
@@ -1428,6 +1441,7 @@ export class QmdClient implements SearchBackend {
         return true;
       } catch (err) {
         markProbeFailure(err);
+        configuredProbeFailure = this.lastCliProbeError;
         // Do not hard-fail here: fall through to PATH/fallback probing.
         // This keeps recall healthy even when configured path is stale.
         this.logCliProbeWarning(
@@ -1444,7 +1458,7 @@ export class QmdClient implements SearchBackend {
     } catch (err) {
       markProbeFailure(err);
       // Try fallback paths
-      for (const fallbackPath of QMD_FALLBACK_PATHS) {
+      for (const fallbackPath of this.qmdFallbackPaths) {
         try {
           const result = await runQmd(["--version"], QMD_PROBE_TIMEOUT_MS, fallbackPath, undefined, this.qmdRuntimeEnv);
           await recordProbeSuccess(result, fallbackPath, "auto-fallback");
@@ -1456,6 +1470,7 @@ export class QmdClient implements SearchBackend {
         }
       }
       this.available = false;
+      restoreConfiguredProbeFailure();
       return false;
     }
   }

package/src/runtime/child-process.test.ts

@@ -0,0 +1,15 @@
+import assert from "node:assert/strict";
+import test from "node:test";
+
+import { launchProcessSync } from "./child-process.js";
+
+test("launchProcessSync executes commands through the shared process wrapper", () => {
+  const result = launchProcessSync(
+    process.execPath,
+    ["-e", "process.stdout.write('ok')"],
+    { encoding: "utf8" },
+  );
+
+  assert.equal(result.status, 0);
+  assert.equal(result.stdout, "ok");
+});

package/src/runtime/child-process.ts

@@ -1,9 +1,5 @@
-import { createRequire } from "node:module";
+import crossSpawn from "cross-spawn";
 
-const require = createRequire(import.meta.url);
-const PROCESS_MODULE_NAME = `node:${"child"}_${"process"}`;
-
-type ProcessModule = Record<string, unknown>;
 type ProcessOptions = Record<string, unknown>;
 type ProcessStream = {
   destroyed?: boolean;
@@ -22,9 +18,12 @@ type ProcessResult = {
   stderr?: string;
 };
 
-function loadModule(): ProcessModule {
-  return require(PROCESS_MODULE_NAME) as ProcessModule;
-}
+type SpawnApi = {
+  (command: string, args?: readonly string[], options?: ProcessOptions): CommandChildProcess;
+  sync: (command: string, args: readonly string[], options: ProcessOptions) => ProcessResult;
+};
+
+const spawnApi = crossSpawn as unknown as SpawnApi;
 
 export type CommandChildProcess = {
   exitCode?: number | null;
@@ -43,13 +42,7 @@ export function launchProcess(
   args: string[],
   options?: ProcessOptions,
 ): CommandChildProcess {
-  const moduleApi = loadModule();
-  const launch = moduleApi["spawn"] as (
-    command: string,
-    args?: readonly string[],
-    options?: ProcessOptions,
-  ) => CommandChildProcess;
-  return launch(command, args, options);
+  return spawnApi(command, args, options);
 }
 
 export function launchProcessSync(
@@ -57,11 +50,5 @@ export function launchProcessSync(
   args: string[],
   options: ProcessOptions,
 ): ProcessResult {
-  const moduleApi = loadModule();
-  const launchSync = moduleApi["spawnSync"] as (
-    command: string,
-    args: readonly string[],
-    options: ProcessOptions,
-  ) => ProcessResult;
-  return launchSync(command, args, options);
+  return spawnApi.sync(command, args, options);
 }