@omgbase/sync 0.6.0 → 0.6.1

package/dist/src/coordinator.js

@@ -65,9 +65,10 @@ export class Coordinator {
                 if (digest.origin === "observed")
                     continue; // came from a source; don't echo back
                 for (const rev of digest.revisions) {
-                    // `changes_since` reports the reference form (`path`, spec/surface
-                    // §1.2); the source takes storage paths.
-                    const path = storagePath(rev.path);
+                    // `changes_since` reports a revision under the row's engine names
+                    // (`_id`, `_path`, `_hash` — spec/surface §1.2, 5.0) in the
+                    // reference form; the source takes storage paths.
+                    const path = storagePath(rev._path);
                     const doc = await this.engine.readDoc(path);
                     if (doc) {
                         await this.source.write(path, doc.content);

package/dist/src/engine-client.d.ts

@@ -8,7 +8,7 @@ export interface ChangesPage {
 }
 export interface DocBytes {
     content: string;
-    /** hex of the doc's current rendered/file hash (matches a changes_since revision's `hash`). */
+    /** hex of the doc's current rendered/file hash (matches a changes_since revision's `_hash`). */
     contentHash: string;
 }
 export interface EngineClient {

package/dist/src/engine-client.js

@@ -30,7 +30,7 @@ export class InProcessEngineClient {
         const res = docsRead(this.store, row.doc_id);
         if (!res)
             return Promise.resolve(null);
-        return Promise.resolve({ content: res.raw, contentHash: row.file_hash?.toString("hex") ?? "" });
+        return Promise.resolve({ content: res._raw, contentHash: row.file_hash?.toString("hex") ?? "" });
     }
     close() {
         // The store's lifetime is owned by the caller (it may serve other work).

package/dist/src/mcp-engine-client.d.ts

@@ -1,5 +1,5 @@
 import { Client } from "@modelcontextprotocol/sdk/client/index.js";
-import { type ObserveResult, type ObserveDeleteResult } from "@omgbase/core";
+import { type ObserveResult, type ObserveDeleteResult, type SurfaceObserveResult } from "@omgbase/core";
 import type { EngineClient, ChangesPage, DocBytes } from "./engine-client.js";
 /** Wraps a connected MCP SDK Client, calling the engine's sync tools. */
 export declare class McpEngineClient implements EngineClient {
@@ -33,6 +33,11 @@ export declare class McpEngineClient implements EngineClient {
     readDoc(path: string): Promise<DocBytes | null>;
     close(): Promise<void>;
 }
+/** A wire observe outcome (`{ _id, _path, … }`, spec/surface §3, 5.0) as the library's `{ docId, path, … }`. */
+export declare function fromWireObserve<T extends {
+    docId: string | null;
+    path: string;
+}>(w: SurfaceObserveResult<T>): T;
 /** Connect to an omgbase MCP server over stdio by spawning `command args`
  *  (e.g. `omg mcp -C /vault`). Returns a ready EngineClient. */
 export declare function connectStdioEngine(spec: {

package/dist/src/mcp-engine-client.js

@@ -48,9 +48,12 @@ export class McpEngineClient {
         }
         return body;
     }
-    // The wire spells a document's identity `id`/`path` (spec/surface §1.2,
-    // 3.0); the engine-client contract keeps the library's `docId`/`path`
-    // (spec/store's observe outcome), so the two are mapped back here.
+    // The wire spells a document's identity `_id`/`_path` (spec/surface §1.2,
+    // 5.0: an underscore-prefixed name is an engine field); the engine-client
+    // contract keeps the library's `docId`/`path` (spec/store's observe
+    // outcome), so the two are mapped back here. The `observe*` ARGUMENTS keep
+    // `path` and `files[].path`: a file event's path is a role, not a row
+    // attribute (§4 "Arguments").
     async observeMany(files) {
         const out = await this.callTool("observe_many", { files });
         return out.map(fromWireObserve);
@@ -67,8 +70,11 @@ export class McpEngineClient {
     }
     async readDoc(path) {
         try {
-            const res = await this.callTool("docs_read", { path });
-            return { content: res.raw, contentHash: createHash("sha256").update(res.raw, "utf8").digest("hex") };
+            // `docs_read { _path }` — the argument addresses the row's `_path`
+            // (5.0; a bare `path` is refused, no tolerance) — and `_raw` is the
+            // document's reconstructed bytes.
+            const res = await this.callTool("docs_read", { _path: path });
+            return { content: res._raw, contentHash: createHash("sha256").update(res._raw, "utf8").digest("hex") };
         }
         catch {
             // doc_missing (or any read failure) → treat as absent.
@@ -79,10 +85,10 @@ export class McpEngineClient {
         await this.client.close();
     }
 }
-/** A wire observe outcome (`{ id, path, … }`) as the library's `{ docId, path, … }`. */
-function fromWireObserve(w) {
-    const { id, path, ...rest } = w;
-    return { docId: id, path: path, ...rest };
+/** A wire observe outcome (`{ _id, _path, … }`, spec/surface §3, 5.0) as the library's `{ docId, path, … }`. */
+export function fromWireObserve(w) {
+    const { _id, _path, ...rest } = w;
+    return { docId: _id, path: _path, ...rest };
 }
 /** Connect to an omgbase MCP server over stdio by spawning `command args`
  *  (e.g. `omg mcp -C /vault`). Returns a ready EngineClient. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@omgbase/sync",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "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,7 +53,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "@omgbase/core": "^0.28.0",
+    "@omgbase/core": "^0.29.0",
     "@omgbase/fs-adapter": "^0.2.0"
   },
   "scripts": {