@remnic/core 1.1.27 → 1.1.29

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": "1.1.27",
+  "version": "1.1.29",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",

package/src/config.ts

@@ -96,14 +96,14 @@ function parseBoundedPositiveInteger(
 }
 
 function parseQmdSupportedVersion(value: unknown): string {
-  if (value === undefined || value === null) return "2.5.1";
+  if (value === undefined || value === null) return "2.5.3";
   if (typeof value !== "string") {
     throw new Error(`qmdSupportedVersion must be a semantic version string; got ${JSON.stringify(value)}`);
   }
   const normalized = value.trim();
   if (!/^\d+\.\d+\.\d+$/.test(normalized)) {
     throw new Error(
-      `qmdSupportedVersion must be a semantic version string like "2.5.1"; got ${JSON.stringify(value)}`,
+      `qmdSupportedVersion must be a semantic version string like "2.5.3"; got ${JSON.stringify(value)}`,
     );
   }
   return normalized;

package/src/qmd.test.ts

@@ -13,22 +13,22 @@ import {
 } from "./qmd.js";
 
 test("parseQmdVersion extracts semantic version from qmd output", () => {
-  assert.deepEqual(parseQmdVersion("qmd 2.5.1 (abcdef)"), [2, 5, 1]);
+  assert.deepEqual(parseQmdVersion("qmd 2.5.3 (abcdef)"), [2, 5, 3]);
   assert.deepEqual(parseQmdVersion("v2.1.0"), [2, 1, 0]);
   assert.equal(parseQmdVersion("Unknown command: doctor"), null);
 });
 
 test("parseQmdVersionOutput prefers qmd-labelled semantic version lines", () => {
   assert.equal(
-    parseQmdVersionOutput("bun 1.2.0\nqmd 2.5.1 (abcdef)", ""),
-    "qmd 2.5.1 (abcdef)",
+    parseQmdVersionOutput("bun 1.2.0\nqmd 2.5.3 (abcdef)", ""),
+    "qmd 2.5.3 (abcdef)",
   );
   assert.equal(parseQmdVersionOutput("wrapper ready", "v2.1.0"), "v2.1.0");
   assert.equal(parseQmdVersionOutput("", ""), null);
 });
 
 test("resolveQmdCapabilities gates qmd 2.5 features by installed version", () => {
-  const current = resolveQmdCapabilities("qmd 2.5.1 (abcdef)");
+  const current = resolveQmdCapabilities("qmd 2.5.3 (abcdef)");
   assert.equal(current.v2McpQueryTool, true);
   assert.equal(current.structuredSearches, true);
   assert.equal(current.chunkStrategy, true);
@@ -41,6 +41,7 @@ test("resolveQmdCapabilities gates qmd 2.5 features by installed version", () =>
   assert.equal(current.embedParallelism, true);
   assert.equal(current.modelEnvConsistency, true);
   assert.equal(current.scopedEmbed, true);
+  assert.equal(current.outputFormatFlag, true);
 
   const older = resolveQmdCapabilities("qmd 2.1.0 (abcdef)");
   assert.equal(older.v2McpQueryTool, true);
@@ -51,6 +52,11 @@ test("resolveQmdCapabilities gates qmd 2.5 features by installed version", () =>
   assert.equal(older.absoluteSnippetLines, false);
   assert.equal(older.forceCpu, false);
   assert.equal(older.scopedEmbed, false);
+  assert.equal(older.outputFormatFlag, false);
+
+  const v251 = resolveQmdCapabilities("qmd 2.5.1");
+  assert.equal(v251.doctor, true);
+  assert.equal(v251.outputFormatFlag, false);
 
   const v20 = resolveQmdCapabilities("qmd 2.0.0");
   assert.equal(v20.stableSdk, true);
@@ -62,10 +68,10 @@ test("resolveQmdCapabilities gates qmd 2.5 features by installed version", () =>
 });
 
 test("shouldAutoUpgradeQmd only upgrades below Remnic supported version", () => {
-  assert.equal(shouldAutoUpgradeQmd("qmd 2.1.0", "2.5.1"), true);
-  assert.equal(shouldAutoUpgradeQmd("qmd 2.5.1", "2.5.1"), false);
-  assert.equal(shouldAutoUpgradeQmd("qmd 2.6.0", "2.5.1"), false);
-  assert.equal(shouldAutoUpgradeQmd("not installed", "2.5.1"), false);
+  assert.equal(shouldAutoUpgradeQmd("qmd 2.1.0", "2.5.3"), true);
+  assert.equal(shouldAutoUpgradeQmd("qmd 2.5.3", "2.5.3"), false);
+  assert.equal(shouldAutoUpgradeQmd("qmd 2.6.0", "2.5.3"), false);
+  assert.equal(shouldAutoUpgradeQmd("not installed", "2.5.3"), false);
 });
 
 test("getQmdCommandName preserves write command detection behind qmd 2.5 index prefix", () => {
@@ -93,7 +99,7 @@ test("QmdClient applies chunk strategy to normal and forced embed args", async (
   const client = new QmdClient("test", 5, {
     qmdChunkStrategy: "regex",
   });
-  (client as any).qmdCapabilities = resolveQmdCapabilities("qmd 2.5.1");
+  (client as any).qmdCapabilities = resolveQmdCapabilities("qmd 2.5.3");
   assert.deepEqual((client as any).buildEmbedArgs("memory"), [
     "embed",
     "-c",
@@ -111,6 +117,55 @@ test("QmdClient applies chunk strategy to normal and forced embed args", async (
   ]);
 });
 
+test("QmdClient uses QMD 2.5.3 --format json for query subprocess output", async () => {
+  const { QmdClient } = await import("./qmd.js");
+  const client = new QmdClient("test", 5) as any;
+  client.available = true;
+  client.qmdCapabilities = resolveQmdCapabilities("qmd 2.5.3");
+  let observedArgs: string[] = [];
+  client.runQmdCommand = async (args: string[]) => {
+    observedArgs = args;
+    return { stdout: "[]", stderr: "" };
+  };
+
+  await client.searchViaSubprocess("memory query", "memory", 3);
+
+  assert.deepEqual(observedArgs, [
+    "query",
+    "memory query",
+    "-c",
+    "memory",
+    "--format",
+    "json",
+    "-n",
+    "3",
+  ]);
+});
+
+test("QmdClient keeps legacy --json for older QMD query subprocess output", async () => {
+  const { QmdClient } = await import("./qmd.js");
+  const client = new QmdClient("test", 5) as any;
+  client.available = true;
+  client.qmdCapabilities = resolveQmdCapabilities("qmd 2.5.1");
+  let observedArgs: string[] = [];
+  client.runQmdCommand = async (args: string[]) => {
+    observedArgs = args;
+    return { stdout: "[]", stderr: "" };
+  };
+
+  await client.searchViaSubprocess("memory query", "memory", 3);
+
+  assert.deepEqual(observedArgs, [
+    "query",
+    "memory query",
+    "-c",
+    "memory",
+    "--json",
+    "-n",
+    "3",
+  ]);
+});
+
 test("parseQmdExplain preserves qmd 2.5 nested RRF trace fields", () => {
   assert.deepEqual(
     parseQmdExplain({
@@ -184,7 +239,7 @@ test("QmdClient auto-upgrade throttle key is scoped by qmd target", async () =>
 
 test("parseConfig exposes qmd 2.5 integration defaults and opt-in auto upgrade", () => {
   const defaults = parseConfig({});
-  assert.equal(defaults.qmdSupportedVersion, "2.5.1");
+  assert.equal(defaults.qmdSupportedVersion, "2.5.3");
   assert.equal(defaults.qmdAutoUpgradeEnabled, false);
   assert.equal(defaults.qmdChunkStrategy, "auto");
   assert.equal(defaults.qmdQueryRerankEnabled, true);

package/src/qmd.ts

@@ -73,6 +73,7 @@ export interface QmdCapabilities {
   scopedEmbed: boolean;
   safeStatusDeviceProbe: boolean;
   mcpIndexSelection: boolean;
+  outputFormatFlag: boolean;
 }
 
 export interface QmdVersionStatus {
@@ -104,7 +105,7 @@ const QMD_PROBE_TIMEOUT_MS = 8_000;
 const QMD_UPDATE_BACKOFF_MS = 15 * 60 * 1000; // 15m
 const QMD_EMBED_BACKOFF_MS = 60 * 60 * 1000; // 60m
 const QMD_CLI_WARN_THROTTLE_MS = 15 * 60 * 1000; // 15m
-export const QMD_SUPPORTED_VERSION = "2.5.1";
+export const QMD_SUPPORTED_VERSION = "2.5.3";
 const QMD_PACKAGE_NAME = "@tobilu/qmd";
 const QMD_AUTO_UPGRADE_TIMEOUT_MS = 120_000;
 const QMD_AUTO_UPGRADE_CHECK_INTERVAL_MS = 24 * 60 * 60_000;
@@ -312,6 +313,7 @@ export function resolveQmdCapabilities(version: string | null): QmdCapabilities
     scopedEmbed: atLeast([2, 5, 0]),
     safeStatusDeviceProbe: atLeast([2, 5, 0]),
     mcpIndexSelection: atLeast([2, 5, 0]),
+    outputFormatFlag: atLeast([2, 5, 3]),
   };
 }
 
@@ -1763,6 +1765,14 @@ export class QmdClient implements SearchBackend {
     }
   }
 
+  private addQmdJsonOutputArgs(args: string[]): void {
+    if (this.qmdCapabilities.outputFormatFlag) {
+      args.push("--format", "json");
+    } else {
+      args.push("--json");
+    }
+  }
+
   private addResolvedSearchOptionsToMcpArgs(
     args: Record<string, unknown>,
     options?: SearchQueryOptions,
@@ -1779,7 +1789,7 @@ export class QmdClient implements SearchBackend {
     if (options?.rerank === false) {
       args.rerank = false;
     }
-    // QMD 2.5.1 MCP query does not expose chunkStrategy even though CLI/SDK
+    // QMD MCP query does not expose chunkStrategy even though CLI/SDK
     // search and embed do. Keep chunk strategy on CLI/embed paths only.
   }
 
@@ -2220,7 +2230,9 @@ export class QmdClient implements SearchBackend {
 
     const startedAtMs = Date.now();
     try {
-      const args = ["query", query, "-c", collection, "--json", "-n", String(maxResults)];
+      const args = ["query", query, "-c", collection];
+      this.addQmdJsonOutputArgs(args);
+      args.push("-n", String(maxResults));
       this.addResolvedSearchOptionsToArgs(args, options);
       const { stdout } = await this.runQmdCommand(args, QMD_TIMEOUT_MS, signal);
       const durationMs = Date.now() - startedAtMs;
@@ -2249,11 +2261,10 @@ export class QmdClient implements SearchBackend {
     if (this.available === false) return [];
     const startedAtMs = Date.now();
     try {
-      const { stdout } = await this.runQmdCommand(
-        ["search", query, "-c", collection, "--json", "-n", String(maxResults)],
-        QMD_TIMEOUT_MS,
-        signal,
-      );
+      const args = ["search", query, "-c", collection];
+      this.addQmdJsonOutputArgs(args);
+      args.push("-n", String(maxResults));
+      const { stdout } = await this.runQmdCommand(args, QMD_TIMEOUT_MS, signal);
       log.debug(`QMD bm25: ${Date.now() - startedAtMs}ms`);
       return parseQmdSearchStdout(stdout);
     } catch (err) {
@@ -2300,7 +2311,9 @@ export class QmdClient implements SearchBackend {
 
     const startedAtMs = Date.now();
     try {
-      const args = ["query", query, "--json", "-n", String(maxResults)];
+      const args = ["query", query];
+      this.addQmdJsonOutputArgs(args);
+      args.push("-n", String(maxResults));
       this.addResolvedSearchOptionsToArgs(args, options);
       const { stdout } = await this.runQmdCommand(args, QMD_TIMEOUT_MS, signal);
       const durationMs = Date.now() - startedAtMs;