@remnic/core 9.43.0 → 9.44.0

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/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.43.0",
+  "version": "9.44.0",
   "description": "Framework-agnostic Remnic memory engine — orchestrator, storage, extraction, search, trust zones",
   "type": "module",
   "main": "dist/index.js",
@@ -3096,7 +3096,7 @@
     "core"
   ],
   "peerDependencies": {
-    "@remnic/coding-graph": "^9.43.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();
+  }
+});

package/src/access-http.ts

@@ -18,6 +18,7 @@ import {
   type EngramAccessWriteResponse,
 } from "./access-service.js";
 import { maybeHandleLifecycleFlush, type LifecycleFlushHttpDeps } from "./access-http-lifecycle-flush.js";
+import { nonEmptyQueryParam, optionalQueryString, positiveIntQueryParam } from "./access-http-query.js";
 import { CorrectionContractError } from "./correction/correction-contract.js";
 import { WearablesInputError } from "./wearables/errors.js"; import { respondMeetingsList, respondMeetingsGet, respondMeetingsBuild } from "./meetings/http-glue.js";
 import { EngramMcpServer, MCP_SUPPORTED_PROTOCOL_VERSIONS } from "./access-mcp.js";
@@ -1322,6 +1323,31 @@ export class EngramAccessHttpServer {
       return;
     }
 
+    if (
+      req.method === "POST" &&
+      (
+        pathname === "/engram/v1/offline-sync/convergence-complete" ||
+        pathname === "/remnic/v1/offline-sync/convergence-complete"
+      )
+    ) {
+      this.enforceTokenOp("offline_sync_apply_file_content");
+      const namespaceParams = parsed.searchParams.getAll("namespace").filter(Boolean);
+      const requestedNamespaces: Array<string | undefined> =
+        namespaceParams.length > 0 ? namespaceParams : [undefined];
+      const namespaces = requestedNamespaces
+        .map((namespace) => this.resolveNamespace(req, namespace))
+        .filter((namespace): namespace is string => namespace !== undefined);
+      this.ensureWriteRateLimitAvailable(req);
+      const result = await this.service.offlineSyncFinalizeConvergence({
+        ...(namespaces.length > 0 ? { namespaces } : {}),
+        principal: this.resolveRequestPrincipal(req),
+        sourceId: this.readRequiredDecodedHeader(req, "x-remnic-source-id"),
+      });
+      this.recordWriteRateLimitHit(req);
+      this.respondJson(res, 200, result);
+      return;
+    }
+
     if (
       req.method === "POST" &&
       (pathname === "/engram/v1/offline-sync/apply" || pathname === "/remnic/v1/offline-sync/apply")
@@ -3925,29 +3951,3 @@ export class EngramAccessHttpServer {
     return false;
   }
 }
-
-/** Optional string field from a JSON body: absent/null/"" → undefined. */
-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. */
-function nonEmptyQueryParam(value: string | null): string | undefined {
-  return value !== null && value.length > 0 ? value : undefined;
-}
-
-/** Optional positive-integer query param; rejects invalid values. */
-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-service-offline-file-content.test.ts

@@ -52,3 +52,43 @@ test("offline apply-file-content reports invalid metadata as input errors", asyn
       /mtimeMs must be within JavaScript Date range/.test(error.message),
   );
 });
+
+test("offline convergence completion refreshes authorized namespaces as one batch and rejects other sources", async () => {
+  const refreshed: string[][] = [];
+  const orchestratorStub = {
+    config: {
+      memoryDir: "/tmp/remnic-access-service-convergence-test",
+      namespacesEnabled: false,
+      defaultNamespace: "global",
+      sharedNamespace: "shared",
+    },
+    refreshNamespacesAfterConvergence: async (namespaces: readonly string[]) => {
+      refreshed.push([...namespaces]);
+    },
+  };
+  const service = new EngramAccessService(
+    orchestratorStub as unknown as ConstructorParameters<typeof EngramAccessService>[0],
+  );
+  const convergenceService = service as unknown as {
+    offlineSyncFinalizeConvergence(options: {
+      namespaces?: string[];
+      principal?: string;
+      sourceId: string;
+    }): Promise<{ namespaces: string[]; refreshed: true }>;
+  };
+
+  await assert.rejects(
+    () => convergenceService.offlineSyncFinalizeConvergence({ sourceId: "laptop" }),
+    (error) =>
+      error instanceof EngramAccessInputError
+      && /sourceId must be remnic-converge/.test(error.message),
+  );
+  assert.deepEqual(refreshed, []);
+
+  const result = await convergenceService.offlineSyncFinalizeConvergence({
+    sourceId: "remnic-converge",
+  });
+
+  assert.deepEqual(result, { namespaces: ["global"], refreshed: true });
+  assert.deepEqual(refreshed, [["global"]]);
+});

package/src/access-service.ts

@@ -818,6 +818,12 @@ export interface EngramAccessOfflineSyncApplyRequest {
   returnCurrentFiles?: boolean;
 }
 
+export interface EngramAccessOfflineSyncFinalizeConvergenceRequest {
+  namespaces?: string[];
+  principal?: string;
+  sourceId: string;
+}
+
 export interface EngramAccessOfflineSyncSnapshotResponse extends OfflineSyncSnapshot {
   namespace: string;
 }
@@ -843,6 +849,11 @@ export interface EngramAccessOfflineSyncApplyResponse extends OfflineSyncApplyCh
   namespace: string;
 }
 
+export interface EngramAccessOfflineSyncFinalizeConvergenceResponse {
+  namespaces: string[];
+  refreshed: true;
+}
+
 export type EngramAccessActionConfidenceRequest = ActionConfidenceInput;
 export type EngramAccessActionConfidenceResponse = ActionConfidenceResult;
 
@@ -5621,6 +5632,29 @@ export class EngramAccessService {
     }
   }
 
+  async offlineSyncFinalizeConvergence(
+    options: EngramAccessOfflineSyncFinalizeConvergenceRequest,
+  ): Promise<EngramAccessOfflineSyncFinalizeConvergenceResponse> {
+    if (options.sourceId !== "remnic-converge") {
+      throw new EngramAccessInputError("sourceId must be remnic-converge");
+    }
+    const requestedNamespaces = options.namespaces?.length
+      ? options.namespaces
+      : [undefined];
+    const resolvedNamespaces = Array.from(new Set(
+      requestedNamespaces.map((namespace) => this.writableNamespaceFor(
+        namespace,
+        undefined,
+        options.principal,
+      )),
+    ));
+    await this.orchestrator.refreshNamespacesAfterConvergence(resolvedNamespaces);
+    return {
+      namespaces: resolvedNamespaces,
+      refreshed: true,
+    };
+  }
+
   async offlineSyncApply(
     options: EngramAccessOfflineSyncApplyRequest,
   ): Promise<EngramAccessOfflineSyncApplyResponse> {

package/src/access-surface-catalog.ts

@@ -183,6 +183,11 @@ export const HTTP_ROUTES: readonly HttpRouteEntry[] = [
   { method: "POST", pathname: "/engram/v1/offline-sync/files", operation: "offline_sync_files" },
   { method: "POST", pathname: "/engram/v1/offline-sync/file-content", operation: "offline_sync_file_content" },
   { method: "POST", pathname: "/engram/v1/offline-sync/apply-file-content", operation: "offline_sync_apply_file_content" },
+  {
+    method: "POST",
+    pathname: "/engram/v1/offline-sync/convergence-complete",
+    operation: "offline_sync_apply_file_content",
+  },
   { method: "POST", pathname: "/engram/v1/offline-sync/apply", operation: "offline_sync_apply" },
   { method: "POST", pathname: "/engram/v1/recall/explain", operation: "recall_explain" },
   { method: "POST", pathname: "/engram/v1/action-confidence", operation: "action_confidence" },

package/src/convergence-refresh.ts

@@ -0,0 +1,28 @@
+import {
+  type RebuildMemoryProjectionOptions,
+  rebuildMemoryProjection,
+} from "./maintenance/rebuild-memory-projection.js";
+import type { NamespaceSearchRouter } from "./namespaces/search.js";
+
+type ConvergenceStorage = NonNullable<RebuildMemoryProjectionOptions["storage"]>;
+
+export async function refreshConvergedNamespaces(
+  namespaces: readonly string[],
+  namespaceSearchRouter: Pick<NamespaceSearchRouter, "updateNamespacesDetailed">,
+  getStorage: (namespace: string) => Promise<ConvergenceStorage>
+): Promise<void> {
+  const targetNamespaces = Array.from(new Set(namespaces.map((namespace) => namespace.trim()).filter(Boolean)));
+  if (targetNamespaces.length === 0) return;
+
+  await namespaceSearchRouter.updateNamespacesDetailed(targetNamespaces, undefined, { strict: true });
+
+  for (const namespace of targetNamespaces) {
+    const storage = await getStorage(namespace);
+    await rebuildMemoryProjection({
+      memoryDir: storage.dir,
+      storage,
+      defaultNamespace: namespace,
+      dryRun: false,
+    });
+  }
+}