@omgbase/sync 0.3.0 → 0.4.0

package/dist/src/coordinator.d.ts

@@ -32,7 +32,8 @@ export declare class Coordinator {
     syncOut(cursor?: number): Promise<SyncOutSummary>;
     /**
      * Live source→engine sync: subscribe to the source's change batches and
-     * reconcile each. Returns the subscription (call `.stop()`), or null if the
+     * reconcile each. Returns the subscription (`.ready` resolves once the source
+     * reported its feed primed — spec/sync §5; call `.stop()`), or null if the
      * source cannot watch. Reconcile runs off the batch callback; `onSummary`
      * observes each batch's result, `onError` any failure.
      */

package/dist/src/coordinator.js

@@ -80,15 +80,18 @@ export class Coordinator {
     }
     /**
      * Live source→engine sync: subscribe to the source's change batches and
-     * reconcile each. Returns the subscription (call `.stop()`), or null if the
+     * reconcile each. Returns the subscription (`.ready` resolves once the source
+     * reported its feed primed — spec/sync §5; call `.stop()`), or null if the
      * source cannot watch. Reconcile runs off the batch callback; `onSummary`
      * observes each batch's result, `onError` any failure.
      */
     async watchIn(handlers = {}) {
         if (!this.source.watch)
             return null;
-        return this.source.watch((paths) => {
-            this.reconcile(paths).then((s) => handlers.onSummary?.(s), (err) => handlers.onError?.(err));
+        return this.source.watch((ev) => {
+            if (ev.event !== "batch")
+                return;
+            this.reconcile(ev.paths).then((s) => handlers.onSummary?.(s), (err) => handlers.onError?.(err));
         });
     }
 }

package/dist/src/mirror.js

@@ -1,6 +1,5 @@
-import { execPath } from "node:process";
-import { createExternalSource } from "@omgbase/core";
-import { fsAdapterBinPath } from "@omgbase/fs-adapter";
+import { createExternalSource, awaitReady, WATCH_READY_PATIENCE_MS } from "@omgbase/core";
+import { fsAdapterLaunch } from "@omgbase/fs-adapter";
 import { connectEngine } from "./mcp-engine-client.js";
 import { Coordinator } from "./coordinator.js";
 /**
@@ -14,7 +13,10 @@ export async function runFsMirror(opts) {
         ? { kind: "stdio", command: opts.server[0], args: opts.server.slice(1) }
         : opts.server;
     const engine = await connectEngine(spec);
-    const source = await createExternalSource({ command: execPath, args: [fsAdapterBinPath(), "--root", opts.root] });
+    // The built-in fs adapter, launched per spec/sync §5 (1.2): `$OMGBASE_FS_ADAPTER`
+    // when set, else the bundled bin under the running node; no registry here, so
+    // no fixed args — just the rendered `--root`.
+    const source = await createExternalSource(fsAdapterLaunch([], ["--root", opts.root]));
     const coord = new Coordinator(engine, source);
     const shutdown = async () => {
         try {
@@ -41,6 +43,9 @@ export async function runFsMirror(opts) {
                 await shutdown();
                 return;
             }
+            // spec/sync §5: report live only once the feed is primed (bounded patience).
+            if (!(await awaitReady(sub.ready, WATCH_READY_PATIENCE_MS)))
+                log(`the fs adapter did not report ready within ${WATCH_READY_PATIENCE_MS / 1000}s — proceeding as if ready`);
             log("watching — Ctrl-C to stop");
             await new Promise((resolve) => {
                 const stop = () => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omgbase/sync",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Open Markdown Graph Base — standalone store-to-store synchronizer: a coordinator over an EngineClient seam (in-process or MCP-client) and source adapters",
   "license": "MIT",
   "repository": {
@@ -53,8 +53,8 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@omgbase/core": "^0.3.0",
-    "@omgbase/fs-adapter": "^0.1.0"
+    "@omgbase/core": "^0.4.0",
+    "@omgbase/fs-adapter": "^0.2.0"
   },
   "scripts": {
     "build": "tsc -p tsconfig.json",