@remnic/core 9.42.0 → 9.44.0

package/dist/search/factory.js

@@ -2,24 +2,24 @@ import {
   createConversationIndexRuntime,
   createConversationSearchBackend,
   createSearchBackend
-} from "../chunk-UZQCNOPS.js";
-import "../chunk-ES36HTSC.js";
-import "../chunk-3Y224NYC.js";
-import "../chunk-H24WNPA2.js";
+} from "../chunk-NVRYW264.js";
 import "../chunk-BLAKS3CP.js";
 import "../chunk-S2BBISHU.js";
+import "../chunk-CYEPCZN5.js";
+import "../chunk-ES36HTSC.js";
+import "../chunk-3Y224NYC.js";
 import "../chunk-W7IGLX4G.js";
+import "../chunk-H24WNPA2.js";
 import "../chunk-CINZGPSJ.js";
-import "../chunk-CYEPCZN5.js";
-import "../chunk-LEPOP46W.js";
+import "../chunk-227UFSEQ.js";
+import "../chunk-ET356KSB.js";
 import "../chunk-72A4L5JJ.js";
 import "../chunk-A7Q43EUZ.js";
-import "../chunk-ET356KSB.js";
 import "../chunk-3ONXXHQO.js";
-import "../chunk-ONHRRJZM.js";
+import "../chunk-QJAQNXWI.js";
 import "../chunk-YV32N67O.js";
-import "../chunk-IUM3VSHI.js";
 import "../chunk-64UDOIMI.js";
+import "../chunk-IUM3VSHI.js";
 import "../chunk-O75CRYGF.js";
 import "../chunk-GCASGYIO.js";
 import "../chunk-XMMESCPD.js";

package/dist/search/index.js

@@ -2,38 +2,38 @@ import {
   createConversationIndexRuntime,
   createConversationSearchBackend,
   createSearchBackend
-} from "../chunk-UZQCNOPS.js";
-import {
-  OramaBackend
-} from "../chunk-ES36HTSC.js";
-import {
-  RemoteSearchBackend
-} from "../chunk-3Y224NYC.js";
-import {
-  EmbedHelper
-} from "../chunk-H24WNPA2.js";
+} from "../chunk-NVRYW264.js";
 import {
   LanceDbBackend
 } from "../chunk-BLAKS3CP.js";
 import {
   MeilisearchBackend
 } from "../chunk-S2BBISHU.js";
+import {
+  NoopSearchBackend
+} from "../chunk-CYEPCZN5.js";
+import {
+  OramaBackend
+} from "../chunk-ES36HTSC.js";
+import {
+  RemoteSearchBackend
+} from "../chunk-3Y224NYC.js";
 import {
   scanMemoryDir
 } from "../chunk-W7IGLX4G.js";
-import "../chunk-CINZGPSJ.js";
 import {
-  NoopSearchBackend
-} from "../chunk-CYEPCZN5.js";
-import "../chunk-LEPOP46W.js";
+  EmbedHelper
+} from "../chunk-H24WNPA2.js";
+import "../chunk-CINZGPSJ.js";
+import "../chunk-227UFSEQ.js";
+import "../chunk-ET356KSB.js";
 import "../chunk-72A4L5JJ.js";
 import "../chunk-A7Q43EUZ.js";
-import "../chunk-ET356KSB.js";
 import "../chunk-3ONXXHQO.js";
-import "../chunk-ONHRRJZM.js";
+import "../chunk-QJAQNXWI.js";
 import "../chunk-YV32N67O.js";
-import "../chunk-IUM3VSHI.js";
 import "../chunk-64UDOIMI.js";
+import "../chunk-IUM3VSHI.js";
 import "../chunk-O75CRYGF.js";
 import "../chunk-GCASGYIO.js";
 import "../chunk-XMMESCPD.js";

package/dist/semantic-consolidation.js

@@ -7,28 +7,29 @@ import {
   materializeAfterSemanticConsolidation,
   parseConsolidationResponse,
   parseOperatorAwareConsolidationResponse
-} from "./chunk-QY66HJ4X.js";
+} from "./chunk-7PLHD7EO.js";
 import {
   resolveExtensionsRoot
 } from "./chunk-JLNBQWZ2.js";
-import "./chunk-KPJQTSRJ.js";
+import "./chunk-UUQLB2HJ.js";
 import "./chunk-KSXJOC4F.js";
-import "./chunk-ZERSIPFC.js";
-import "./chunk-UHVXE24Y.js";
+import "./chunk-ZBJMUXZH.js";
+import "./chunk-OHLNFI6Z.js";
 import "./chunk-ENTCVTQR.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-WIPEXG6R.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-GSL47NPM.js";
-import "./chunk-4VXGRIH6.js";
+import "./chunk-WUNIWKY4.js";
 import "./chunk-EGGE52UU.js";
 import "./chunk-ZA53AZND.js";
-import "./chunk-7RJUVTVF.js";
-import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-GCASGYIO.js";
+import "./chunk-7RJUVTVF.js";
+import "./chunk-SCU65EZI.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-BEQOZOYZ.js";
+import "./chunk-2FTRRQKZ.js";
 import "./chunk-CGASUJVP.js";
 import "./chunk-R3DJVOSM.js";
 import "./chunk-BT7NVCML.js";
@@ -37,6 +38,7 @@ import "./chunk-RL6NEVXT.js";
 import "./chunk-JYIJNNN3.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-YXZG5TVN.js";
+import "./chunk-W5H6ZRPT.js";
 import {
   CONSOLIDATION_OPERATORS,
   isConsolidationOperator,
@@ -50,7 +52,6 @@ import "./chunk-4J7G5SY4.js";
 import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-FFAZ2XFU.js";
-import "./chunk-W5H6ZRPT.js";
 import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-C23BYTJV.js";
@@ -67,7 +68,6 @@ import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-6MKAMLQL.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-ZBJMUXZH.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";

package/dist/semantic-rule-promotion.js

@@ -1,23 +1,23 @@
 import {
   promoteSemanticRuleFromMemory,
   setSemanticRulePromotionTestHooks
-} from "./chunk-MVW234LO.js";
-import "./chunk-ZERSIPFC.js";
-import "./chunk-UHVXE24Y.js";
+} from "./chunk-O4BADU6R.js";
+import "./chunk-OHLNFI6Z.js";
 import "./chunk-ENTCVTQR.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-WIPEXG6R.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-GSL47NPM.js";
-import "./chunk-4VXGRIH6.js";
+import "./chunk-WUNIWKY4.js";
 import "./chunk-EGGE52UU.js";
 import "./chunk-ZA53AZND.js";
-import "./chunk-7RJUVTVF.js";
-import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-GCASGYIO.js";
+import "./chunk-7RJUVTVF.js";
+import "./chunk-SCU65EZI.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-BEQOZOYZ.js";
+import "./chunk-2FTRRQKZ.js";
 import "./chunk-CGASUJVP.js";
 import "./chunk-R3DJVOSM.js";
 import "./chunk-BT7NVCML.js";
@@ -26,6 +26,7 @@ import "./chunk-RL6NEVXT.js";
 import "./chunk-JYIJNNN3.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-YXZG5TVN.js";
+import "./chunk-W5H6ZRPT.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-DLVPUX7U.js";
 import "./chunk-IJ7HK452.js";
@@ -34,7 +35,6 @@ import "./chunk-4J7G5SY4.js";
 import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-FFAZ2XFU.js";
-import "./chunk-W5H6ZRPT.js";
 import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-C23BYTJV.js";

package/dist/semantic-rule-verifier.js

@@ -1,23 +1,24 @@
 import {
   compareVerifiedSemanticRuleResults,
   searchVerifiedSemanticRules
-} from "./chunk-5TOV3D6U.js";
-import "./chunk-ZERSIPFC.js";
-import "./chunk-UHVXE24Y.js";
+} from "./chunk-CH2WTP6R.js";
+import "./chunk-ZBJMUXZH.js";
+import "./chunk-OHLNFI6Z.js";
 import "./chunk-ENTCVTQR.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-WIPEXG6R.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-GSL47NPM.js";
-import "./chunk-4VXGRIH6.js";
+import "./chunk-WUNIWKY4.js";
 import "./chunk-EGGE52UU.js";
 import "./chunk-ZA53AZND.js";
-import "./chunk-7RJUVTVF.js";
-import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-GCASGYIO.js";
+import "./chunk-7RJUVTVF.js";
+import "./chunk-SCU65EZI.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-BEQOZOYZ.js";
+import "./chunk-2FTRRQKZ.js";
 import "./chunk-CGASUJVP.js";
 import "./chunk-R3DJVOSM.js";
 import "./chunk-BT7NVCML.js";
@@ -26,6 +27,7 @@ import "./chunk-RL6NEVXT.js";
 import "./chunk-JYIJNNN3.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-YXZG5TVN.js";
+import "./chunk-W5H6ZRPT.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-DLVPUX7U.js";
 import "./chunk-IJ7HK452.js";
@@ -34,7 +36,6 @@ import "./chunk-4J7G5SY4.js";
 import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-FFAZ2XFU.js";
-import "./chunk-W5H6ZRPT.js";
 import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-C23BYTJV.js";
@@ -51,7 +52,6 @@ import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-6MKAMLQL.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-ZBJMUXZH.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";

package/dist/source-agent-qualifier.js

@@ -3,7 +3,7 @@ import {
   headerConnector,
   renderExtractionConversation,
   resolveSourceConnector
-} from "./chunk-AX2J2LC4.js";
+} from "./chunk-5ZE7QHTK.js";
 import "./chunk-YIAA2X3D.js";
 import "./chunk-WOCNN776.js";
 import "./chunk-P2BM76KT.js";
@@ -11,33 +11,34 @@ import "./chunk-VEWZZM3H.js";
 import "./chunk-T2TTP3KU.js";
 import "./chunk-7TWUCYER.js";
 import "./chunk-EMDLM3LW.js";
-import "./chunk-NF3U3MPG.js";
+import "./chunk-ECK75GDJ.js";
 import "./chunk-BUE5E2HL.js";
 import "./chunk-PD6O7AXF.js";
-import "./chunk-ONHRRJZM.js";
+import "./chunk-QJAQNXWI.js";
 import "./chunk-YV32N67O.js";
-import "./chunk-IUM3VSHI.js";
 import "./chunk-64UDOIMI.js";
+import "./chunk-IUM3VSHI.js";
 import "./chunk-O75CRYGF.js";
 import "./chunk-OD4FM2U7.js";
-import "./chunk-KPJQTSRJ.js";
+import "./chunk-UUQLB2HJ.js";
 import "./chunk-KSXJOC4F.js";
-import "./chunk-ZERSIPFC.js";
-import "./chunk-UHVXE24Y.js";
+import "./chunk-TBBDFYXW.js";
+import "./chunk-OHLNFI6Z.js";
 import "./chunk-ENTCVTQR.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-WIPEXG6R.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-GSL47NPM.js";
-import "./chunk-4VXGRIH6.js";
+import "./chunk-WUNIWKY4.js";
 import "./chunk-EGGE52UU.js";
 import "./chunk-ZA53AZND.js";
-import "./chunk-7RJUVTVF.js";
-import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-GCASGYIO.js";
+import "./chunk-7RJUVTVF.js";
+import "./chunk-SCU65EZI.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-BEQOZOYZ.js";
+import "./chunk-2FTRRQKZ.js";
 import "./chunk-CGASUJVP.js";
 import "./chunk-R3DJVOSM.js";
 import "./chunk-BT7NVCML.js";
@@ -46,6 +47,7 @@ import "./chunk-RL6NEVXT.js";
 import "./chunk-JYIJNNN3.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-YXZG5TVN.js";
+import "./chunk-W5H6ZRPT.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-DLVPUX7U.js";
 import "./chunk-IJ7HK452.js";
@@ -54,7 +56,6 @@ import "./chunk-4J7G5SY4.js";
 import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-FFAZ2XFU.js";
-import "./chunk-W5H6ZRPT.js";
 import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-C23BYTJV.js";
@@ -73,7 +74,6 @@ import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-6MKAMLQL.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-TBBDFYXW.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";

package/dist/storage.js

@@ -13,25 +13,25 @@ import {
   parseFrontmatter,
   parseFrontmatterStringValue,
   serializeEntityFile
-} from "./chunk-ZERSIPFC.js";
-import "./chunk-UHVXE24Y.js";
+} from "./chunk-OHLNFI6Z.js";
 import "./chunk-ENTCVTQR.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-WIPEXG6R.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-GSL47NPM.js";
-import "./chunk-4VXGRIH6.js";
+import "./chunk-WUNIWKY4.js";
 import "./chunk-EGGE52UU.js";
 import "./chunk-ZA53AZND.js";
-import "./chunk-7RJUVTVF.js";
-import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-GCASGYIO.js";
+import "./chunk-7RJUVTVF.js";
+import "./chunk-SCU65EZI.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
 import {
   ContentHashIndex,
   FactHashIndexNotAuthoritativeError
-} from "./chunk-BEQOZOYZ.js";
+} from "./chunk-2FTRRQKZ.js";
 import "./chunk-CGASUJVP.js";
 import {
   normalizeAttributePairs,
@@ -45,6 +45,7 @@ import "./chunk-AAD2ZS6P.js";
 import {
   normalizeEntityName
 } from "./chunk-YXZG5TVN.js";
+import "./chunk-W5H6ZRPT.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-DLVPUX7U.js";
 import "./chunk-IJ7HK452.js";
@@ -53,7 +54,6 @@ import "./chunk-4J7G5SY4.js";
 import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-FFAZ2XFU.js";
-import "./chunk-W5H6ZRPT.js";
 import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-C23BYTJV.js";

package/dist/transfer/import-sqlite.js

@@ -1,8 +1,8 @@
 import {
   importSqlite
-} from "../chunk-LRGSLV7M.js";
-import "../chunk-G4IAEX6D.js";
+} from "../chunk-PYHOAXTI.js";
 import "../chunk-Z734BLO3.js";
+import "../chunk-G4IAEX6D.js";
 import "../chunk-RL6NEVXT.js";
 import "../chunk-GCGJW34D.js";
 import "../chunk-PZ5AY32C.js";

package/dist/verified-recall.js

@@ -1,24 +1,25 @@
 import {
   compareVerifiedEpisodeResults,
   searchVerifiedEpisodes
-} from "./chunk-OEXKYYVH.js";
+} from "./chunk-HGFILS2Q.js";
 import "./chunk-B7RWBZXW.js";
-import "./chunk-ZERSIPFC.js";
-import "./chunk-UHVXE24Y.js";
+import "./chunk-ZBJMUXZH.js";
+import "./chunk-OHLNFI6Z.js";
 import "./chunk-ENTCVTQR.js";
+import "./chunk-UHVXE24Y.js";
 import "./chunk-WIPEXG6R.js";
 import "./chunk-J6A3CX5N.js";
 import "./chunk-GSL47NPM.js";
-import "./chunk-4VXGRIH6.js";
+import "./chunk-WUNIWKY4.js";
 import "./chunk-EGGE52UU.js";
 import "./chunk-ZA53AZND.js";
-import "./chunk-7RJUVTVF.js";
-import "./chunk-SCU65EZI.js";
 import "./chunk-WRJVB3C2.js";
 import "./chunk-GCASGYIO.js";
+import "./chunk-7RJUVTVF.js";
+import "./chunk-SCU65EZI.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-LDXUBPMO.js";
-import "./chunk-BEQOZOYZ.js";
+import "./chunk-2FTRRQKZ.js";
 import "./chunk-CGASUJVP.js";
 import "./chunk-R3DJVOSM.js";
 import "./chunk-BT7NVCML.js";
@@ -27,6 +28,7 @@ import "./chunk-RL6NEVXT.js";
 import "./chunk-JYIJNNN3.js";
 import "./chunk-AAD2ZS6P.js";
 import "./chunk-YXZG5TVN.js";
+import "./chunk-W5H6ZRPT.js";
 import "./chunk-G7D6GZ5J.js";
 import "./chunk-DLVPUX7U.js";
 import "./chunk-IJ7HK452.js";
@@ -35,7 +37,6 @@ import "./chunk-4J7G5SY4.js";
 import "./chunk-DNHVPZOD.js";
 import "./chunk-6CIAGZ6X.js";
 import "./chunk-FFAZ2XFU.js";
-import "./chunk-W5H6ZRPT.js";
 import "./chunk-XMMESCPD.js";
 import "./chunk-42JKGUFJ.js";
 import "./chunk-C23BYTJV.js";
@@ -52,7 +53,6 @@ import "./chunk-EYIEWJNI.js";
 import "./chunk-JUC24CTX.js";
 import "./chunk-6MKAMLQL.js";
 import "./chunk-JAKIDQB2.js";
-import "./chunk-ZBJMUXZH.js";
 import "./chunk-BJMBJZ2Y.js";
 import "./chunk-UKJAGEXH.js";
 import "./chunk-FP2373TW.js";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@remnic/core",
-  "version": "9.42.0",
+  "version": "9.44.0",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -166,6 +166,16 @@
       "remnic-source": "./src/reconcile/plan.ts",
       "import": "./dist/reconcile/plan.js"
     },
+    "./reconcile/cursor": {
+      "types": "./dist/reconcile/cursor.d.ts",
+      "remnic-source": "./src/reconcile/cursor.ts",
+      "import": "./dist/reconcile/cursor.js"
+    },
+    "./reconcile/cursor.js": {
+      "types": "./dist/reconcile/cursor.d.ts",
+      "remnic-source": "./src/reconcile/cursor.ts",
+      "import": "./dist/reconcile/cursor.js"
+    },
     "./adapters/codex": {
       "types": "./dist/adapters/codex.d.ts",
       "remnic-source": "./src/adapters/codex.ts",
@@ -3086,7 +3096,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.42.0"
+    "@remnic/coding-graph": "^9.44.0"
   },
   "peerDependenciesMeta": {
     "@remnic/coding-graph": {

package/src/access-http-query.ts

@@ -0,0 +1,25 @@
+import { EngramAccessInputError } from "./access-service.js";
+
+/** Optional string field from a JSON body: absent/null/"" → undefined. */
+export function optionalQueryString(value: unknown, label: string): string | undefined {
+  if (value === undefined || value === null || value === "") return undefined;
+  if (typeof value !== "string") {
+    throw new EngramAccessInputError(`${label} must be a string (got ${JSON.stringify(value)})`);
+  }
+  return value;
+}
+
+/** Optional non-empty query param: null/"" → undefined. */
+export function nonEmptyQueryParam(value: string | null): string | undefined {
+  return value !== null && value.length > 0 ? value : undefined;
+}
+
+/** Optional positive-integer query param; rejects invalid values. */
+export function positiveIntQueryParam(value: string | null, label: string): number | undefined {
+  if (value === null || value.length === 0) return undefined;
+  const parsed = Number(value);
+  if (!Number.isFinite(parsed) || parsed <= 0 || !Number.isInteger(parsed)) {
+    throw new EngramAccessInputError(`${label} expects a positive integer`);
+  }
+  return parsed;
+}

package/src/access-http.test.ts

@@ -3648,3 +3648,139 @@ test("HTTP authorization probe verifies requested operation grants without invok
     await server.stop();
   }
 });
+
+test("HTTP convergence completion forwards one authenticated namespace batch refresh", async () => {
+  const calls: Array<{ namespaces: string[]; principal?: string; sourceId: string }> = [];
+  const service = {
+    offlineSyncFinalizeConvergence: async (options: {
+      namespaces: string[];
+      principal?: string;
+      sourceId: string;
+    }) => {
+      calls.push(options);
+      return { namespaces: options.namespaces, refreshed: true as const };
+    },
+  } as unknown as EngramAccessService;
+  const server = new EngramAccessHttpServer({
+    service,
+    port: 0,
+    authToken: "test-token",
+    principal: "writer",
+    adminConsoleEnabled: false,
+  });
+  const route = "/remnic/v1/offline-sync/convergence-complete?namespace=team&namespace=shared";
+
+  const status = await server.start();
+  try {
+    const denied = await fetch(`http://127.0.0.1:${status.port}${route}`, {
+      method: "POST",
+      headers: { "x-remnic-source-id": encodeURIComponent("remnic-converge") },
+    });
+    assert.equal(denied.status, 401);
+
+    const response = await fetch(`http://127.0.0.1:${status.port}${route}`, {
+      method: "POST",
+      headers: {
+        authorization: "Bearer test-token",
+        "x-remnic-source-id": encodeURIComponent("remnic-converge"),
+      },
+    });
+
+    assert.equal(response.status, 200);
+    assert.deepEqual(await response.json(), {
+      namespaces: ["team", "shared"],
+      refreshed: true,
+    });
+    assert.deepEqual(calls, [{
+      namespaces: ["team", "shared"],
+      principal: "writer",
+      sourceId: "remnic-converge",
+    }]);
+  } finally {
+    await server.stop();
+  }
+});
+
+test("HTTP convergence completion enforces the per-principal write rate limit", async () => {
+  let completions = 0;
+  const service = {
+    offlineSyncFinalizeConvergence: async () => {
+      completions += 1;
+      return { namespaces: ["team"], refreshed: true as const };
+    },
+  } as unknown as EngramAccessService;
+  const server = new EngramAccessHttpServer({
+    service,
+    port: 0,
+    authToken: "test-token",
+    adminConsoleEnabled: false,
+    writeRateLimitMaxRequests: 1,
+  });
+  const status = await server.start();
+  const route = `http://127.0.0.1:${status.port}/remnic/v1/offline-sync/convergence-complete?namespace=team`;
+  const requestOptions: RequestInit = {
+    method: "POST",
+    headers: {
+      authorization: "Bearer test-token",
+      "x-remnic-source-id": encodeURIComponent("remnic-converge"),
+    },
+  };
+
+  try {
+    const first = await fetch(route, requestOptions);
+    assert.equal(first.status, 200);
+    await first.text();
+
+    const second = await fetch(route, requestOptions);
+    assert.equal(second.status, 429);
+    const rateLimited: unknown = await second.json();
+    assert.ok(rateLimited && typeof rateLimited === "object" && "code" in rateLimited);
+    assert.equal(rateLimited.code, "write_rate_limited");
+    assert.equal(completions, 1, "the rate-limited completion must not reach the service");
+  } finally {
+    await server.stop();
+  }
+});
+
+test("HTTP convergence completion denies scoped tokens that omit the namespace", async () => {
+  let completions = 0;
+  const service = {
+    configRef: parseConfig({
+      memoryDir: "/tmp/remnic-http-convergence-completion-namespace",
+      namespacesEnabled: true,
+      defaultNamespace: "default",
+    }),
+    offlineSyncFinalizeConvergence: async () => {
+      completions += 1;
+      return { namespaces: ["default"], refreshed: true as const };
+    },
+  } as unknown as EngramAccessService;
+  const server = new EngramAccessHttpServer({
+    service,
+    port: 0,
+    authTokenEntriesGetter: () => [
+      { token: "scoped-token", capabilities: { version: 1, namespaces: ["team"] } },
+    ],
+    adminConsoleEnabled: false,
+  });
+  const status = await server.start();
+
+  try {
+    const response = await fetch(
+      `http://127.0.0.1:${status.port}/remnic/v1/offline-sync/convergence-complete`,
+      {
+        method: "POST",
+        headers: {
+          authorization: "Bearer scoped-token",
+          "x-remnic-source-id": encodeURIComponent("remnic-converge"),
+        },
+      },
+    );
+
+    assert.equal(response.status, 403);
+    await response.text();
+    assert.equal(completions, 0, "the denied completion must not reach the service");
+  } finally {
+    await server.stop();
+  }
+});