zen-fs-config 0.3.11 → 0.3.13

package/dist/index.d.mts

@@ -242,6 +242,8 @@ declare class ConfigRepo implements IConfigRepo {
     private disposed;
     private configCache;
     constructor(appId: string, nodeId: string, cachedFS: MinimalAsyncFS, serializer: PathAwareSerializer, onConflict?: (conflict: ConflictInfo) => Promise<unknown | null>);
+    /** Full path to this node's directory on the primary backend. */
+    get nodePath(): string;
     load(rawConfig?: string): Promise<void>;
     getConfig<T = unknown>(path: string): T;
     setConfig(path: string, data: unknown): void;
@@ -256,7 +258,7 @@ declare class ConfigRepo implements IConfigRepo {
     resolveConflict(conflictId: string, mergedContent: unknown): Promise<void>;
     listConflicts(): Promise<ConflictArchive[]>;
     dispose(): Promise<void>;
-    setupSync(rules: SyncRule[], backends: BackendDescriptor[], primaryBackendId: string): Promise<void>;
+    setupSync(backends: BackendDescriptor[], primaryBackendId: string): Promise<void>;
     private persistConfig;
     private reloadConfigCache;
     private handleConflict;

package/dist/index.d.ts

@@ -242,6 +242,8 @@ declare class ConfigRepo implements IConfigRepo {
     private disposed;
     private configCache;
     constructor(appId: string, nodeId: string, cachedFS: MinimalAsyncFS, serializer: PathAwareSerializer, onConflict?: (conflict: ConflictInfo) => Promise<unknown | null>);
+    /** Full path to this node's directory on the primary backend. */
+    get nodePath(): string;
     load(rawConfig?: string): Promise<void>;
     getConfig<T = unknown>(path: string): T;
     setConfig(path: string, data: unknown): void;
@@ -256,7 +258,7 @@ declare class ConfigRepo implements IConfigRepo {
     resolveConflict(conflictId: string, mergedContent: unknown): Promise<void>;
     listConflicts(): Promise<ConflictArchive[]>;
     dispose(): Promise<void>;
-    setupSync(rules: SyncRule[], backends: BackendDescriptor[], primaryBackendId: string): Promise<void>;
+    setupSync(backends: BackendDescriptor[], primaryBackendId: string): Promise<void>;
     private persistConfig;
     private reloadConfigCache;
     private handleConflict;

package/dist/index.js

@@ -353,6 +353,7 @@ async function wrapZenFSFileSystem(config) {
         await isolatedFS.createFile(path, { uid: 0, gid: 0, mode: 420 });
       }
       await isolatedFS.write(path, bytes, 0);
+      await isolatedFS.touch(path, { size: bytes.byteLength, mtimeMs: Date.now() });
     },
     async readdir(path) {
       return isolatedFS.readdir(path);
@@ -409,227 +410,59 @@ registerBackend("WebStorage", async (options) => {
   return wrapZenFSFileSystem({ backend: WebStorage, storage });
 });
 registerBackend("GitHub", async (options) => {
-  const token = options.token ?? "";
-  const owner = options.owner ?? "";
-  const repo = options.repo ?? "";
-  const branch = options.branch ?? "main";
-  const baseUrl = options.baseUrl ?? "https://api.github.com";
-  if (!owner || !repo) throw new Error('GitHub backend requires "owner" and "repo" options');
-  const headers = {
-    "Accept": "application/vnd.github.v3+json",
-    "User-Agent": "zen-fs-config"
-  };
-  if (token) headers["Authorization"] = `Bearer ${token}`;
-  const apiUrl = (path) => {
-    const p = path.startsWith("/") ? path.slice(1) : path;
-    return `${baseUrl}/repos/${owner}/${repo}/contents/${p}?ref=${branch}`;
-  };
-  const treeUrl = () => `${baseUrl}/repos/${owner}/${repo}/git/trees/${branch}?recursive=1`;
-  const ghStat = (item) => ({
-    isFile: () => item.type === "file",
-    isDirectory: () => item.type === "dir",
-    size: item.size ?? 0
+  const { Github } = await import("zen-fs-github");
+  return wrapZenFSFileSystem({
+    backend: Github,
+    token: options.token,
+    owner: options.owner,
+    repo: options.repo,
+    branch: options.branch,
+    baseUrl: options.baseUrl && options.baseUrl.trim() || void 0
   });
-  const fetchJson = async (url) => {
-    const res = await fetch(url, { headers });
-    if (!res.ok) throw new Error(`GitHub API ${res.status}: ${url}`);
-    return res.json();
-  };
-  const backend = {
-    async readFile(path, ...args) {
-      const data = await fetchJson(apiUrl(path));
-      if (data.encoding === "base64") {
-        const raw = Uint8Array.from(atob(data.content), (c) => c.charCodeAt(0));
-        if (args[0] === "utf-8") return new TextDecoder().decode(raw);
-        return raw;
-      }
-      return data;
-    },
-    async writeFile(path, data, options2) {
-      const message = options2?.message || `Update ${path}`;
-      const content = typeof data === "string" ? btoa(unescape(encodeURIComponent(data))) : btoa(String.fromCharCode(...new Uint8Array(data)));
-      const sha = await (async () => {
-        try {
-          const d = await fetchJson(apiUrl(path));
-          return d.sha;
-        } catch {
-          return void 0;
-        }
-      })();
-      await fetch(apiUrl(path), {
-        method: "PUT",
-        headers,
-        body: JSON.stringify({ message, content, sha, branch })
-      });
-    },
-    async readdir(path) {
-      const data = await fetchJson(apiUrl(path));
-      return data.map((item) => item.name);
-    },
-    async stat(path, ...args) {
-      try {
-        const data = await fetchJson(apiUrl(path));
-        if (Array.isArray(data)) {
-          return { isFile: () => false, isDirectory: () => true, size: 0 };
-        }
-        return ghStat(data);
-      } catch {
-        throw new Error(`ENOENT: ${path}`);
-      }
-    },
-    async exists(path) {
-      try {
-        await fetchJson(apiUrl(path));
-        return true;
-      } catch {
-        return false;
-      }
-    },
-    async mkdir(path, options2) {
-      const dirPath = path.replace(/\/$/, "");
-      const keepPath = `${dirPath}/.gitkeep`;
-      const message = options2?.message || `Create directory ${dirPath}`;
-      const content = btoa("");
-      await fetch(apiUrl(keepPath), {
-        method: "PUT",
-        headers,
-        body: JSON.stringify({ message, content, branch })
-      });
-    },
-    async unlink(path) {
-      const data = await fetchJson(apiUrl(path));
-      await fetch(apiUrl(path), {
-        method: "DELETE",
-        headers,
-        body: JSON.stringify({ message: `Delete ${path}`, sha: data.sha, branch })
-      });
-    },
-    async rmdir(path) {
-      const items = await fetchJson(apiUrl(path));
-      if (Array.isArray(items)) {
-        for (const item of items) {
-          const itemPath = `${path}/${item.name}`;
-          if (item.type === "dir") {
-            await backend.rmdir(itemPath);
-          } else {
-            await backend.unlink(itemPath);
-          }
-        }
-      }
-    },
-    async rename(oldPath, newPath) {
-      const content = await backend.readFile(oldPath);
-      await backend.writeFile(newPath, content);
-      await backend.unlink(oldPath);
-    }
-  };
-  return backend;
 });
 registerBackend("Gitee", async (options) => {
-  const token = options.token ?? "";
-  const owner = options.owner ?? "";
-  const repo = options.repo ?? "";
-  const branch = options.branch ?? "master";
-  const baseUrl = options.baseUrl ?? "https://gitee.com/api/v5";
-  if (!owner || !repo) throw new Error('Gitee backend requires "owner" and "repo" options');
-  const fetchJson = async (url) => {
-    const res = await fetch(url);
-    if (!res.ok) throw new Error(`Gitee API ${res.status}: ${url}`);
-    return res.json();
-  };
-  const apiUrl = (path) => {
-    const p = path.startsWith("/") ? path.slice(1) : path;
-    const params = new URLSearchParams({ access_token: token, ref: branch, path: p });
-    return `${baseUrl}/repos/${owner}/${repo}/contents?${params}`;
-  };
-  const ghStat = (item) => ({
-    isFile: () => item.type === "file",
-    isDirectory: () => item.type === "dir",
-    size: item.size ?? 0
-  });
-  const backend = {
-    async readFile(path, ...args) {
-      const data = await fetchJson(apiUrl(path));
-      if (data.content) {
-        const raw = Uint8Array.from(atob(data.content), (c) => c.charCodeAt(0));
-        if (args[0] === "utf-8") return new TextDecoder().decode(raw);
-        return raw;
-      }
-      return data;
-    },
-    async writeFile(path, data, options2) {
-      const message = options2?.message || `Update ${path}`;
-      const content = typeof data === "string" ? btoa(unescape(encodeURIComponent(data))) : btoa(String.fromCharCode(...new Uint8Array(data)));
-      const sha = await (async () => {
-        try {
-          const d = await fetchJson(apiUrl(path));
-          return d.sha;
-        } catch {
-          return void 0;
-        }
-      })();
-      await fetch(apiUrl(path), {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ access_token: token, message, content, sha, branch })
-      });
-    },
-    async readdir(path) {
-      const data = await fetchJson(apiUrl(path));
-      return Array.isArray(data) ? data.map((i) => i.name) : [];
-    },
-    async stat(path) {
-      try {
-        const data = await fetchJson(apiUrl(path));
-        if (Array.isArray(data)) return ghStat({ type: "dir", size: 0 });
-        return ghStat(data);
-      } catch {
-        throw new Error(`ENOENT: ${path}`);
-      }
-    },
-    async exists(path) {
-      try {
-        await fetchJson(apiUrl(path));
-        return true;
-      } catch {
-        return false;
-      }
-    },
-    async mkdir(path, options2) {
-      const dirPath = path.replace(/\/$/, "");
-      const keepPath = `${dirPath}/.gitkeep`;
-      const message = options2?.message || `Create directory ${dirPath}`;
-      await fetch(apiUrl(keepPath), {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ access_token: token, message, content: btoa(""), branch })
-      });
-    },
-    async unlink(path) {
-      const data = await fetchJson(apiUrl(path));
-      await fetch(apiUrl(path), {
-        method: "DELETE",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ access_token: token, message: `Delete ${path}`, sha: data.sha, branch })
-      });
-    },
-    async rmdir(path) {
-      const items = await fetchJson(apiUrl(path));
-      if (Array.isArray(items)) {
-        for (const item of items) {
-          const itemPath = `${path}/${item.name}`;
-          if (item.type === "dir") await backend.rmdir(itemPath);
-          else await backend.unlink(itemPath);
-        }
+  const zenGitee = await import("zen-fs-gitee");
+  const { GiteeAPI } = await import("zen-fs-gitee/dist/gitee-api.js");
+  const originalGetTree = GiteeAPI.prototype.getTree;
+  GiteeAPI.prototype.getTree = async function(recursive = true) {
+    try {
+      return await originalGetTree.call(this, recursive);
+    } catch (err) {
+      if (!err.message?.includes("404") && !err.message?.includes("Tree not found")) {
+        throw err;
       }
-    },
-    async rename(oldPath, newPath) {
-      const content = await backend.readFile(oldPath);
-      await backend.writeFile(newPath, content);
-      await backend.unlink(oldPath);
     }
+    console.log(`[Gitee] getTree failed with branch="${this.branch}", resolving to SHA...`);
+    const baseUrl = this.baseUrl || "https://gitee.com/api/v5";
+    const sep = "?";
+    const auth = `access_token=${this.token}`;
+    const branchUrl = `${baseUrl}/repos/${this.owner}/${this.repo}/branches/${this.branch}${sep}${auth}`;
+    const branchRes = await fetch(branchUrl);
+    if (!branchRes.ok) throw new Error(`Gitee: branch "${this.branch}" not found (${branchRes.status})`);
+    const branchData = await branchRes.json();
+    const commitSha = branchData.commit?.sha;
+    if (!commitSha) throw new Error(`Gitee: could not get commit SHA for branch "${this.branch}"`);
+    const commitUrl = `${baseUrl}/repos/${this.owner}/${this.repo}/git/commits/${commitSha}${sep}${auth}`;
+    const commitRes = await fetch(commitUrl);
+    if (!commitRes.ok) throw new Error(`Gitee: commit ${commitSha} not found (${commitRes.status})`);
+    const commitData = await commitRes.json();
+    const treeSha = commitData.tree?.sha;
+    if (!treeSha) throw new Error(`Gitee: could not get tree SHA from commit ${commitSha}`);
+    console.log(`[Gitee] Resolved branch="${this.branch}" \u2192 commit=${commitSha.slice(0, 8)} \u2192 tree=${treeSha.slice(0, 8)}`);
+    const treeUrl = `${baseUrl}/repos/${this.owner}/${this.repo}/git/trees/${treeSha}${sep}recursive=${recursive ? 1 : 0}&${auth}`;
+    const treeRes = await fetch(treeUrl);
+    if (!treeRes.ok) throw new Error(`Gitee: tree ${treeSha} not found (${treeRes.status})`);
+    const treeData = await treeRes.json();
+    return treeData.tree || [];
   };
-  return backend;
+  return wrapZenFSFileSystem({
+    backend: zenGitee.Gitee,
+    token: options.token,
+    owner: options.owner,
+    repo: options.repo,
+    branch: options.branch,
+    baseUrl: options.baseUrl && options.baseUrl.trim() || void 0
+  });
 });
 registerBackend("WebDAV", async (options) => {
   const url = options.url ?? "";
@@ -856,6 +689,10 @@ var ConfigRepo = class {
     this.fs = createChrootFS(cachedFS, `/${appId}`);
     this.rootFS = createChrootFS(cachedFS, "/");
   }
+  /** Full path to this node's directory on the primary backend. */
+  get nodePath() {
+    return `/nodes/${this.nodeId}`;
+  }
   // -----------------------------------------------------------------------
   // IConfigRepo — Load
   // -----------------------------------------------------------------------
@@ -1074,11 +911,14 @@ var ConfigRepo = class {
   // -----------------------------------------------------------------------
   // Internal — Setup
   // -----------------------------------------------------------------------
-  async setupSync(rules, backends, primaryBackendId) {
+  async setupSync(backends, primaryBackendId) {
     console.log(`[ConfigRepo] setupSync: ${backends.length} backends, primary=${primaryBackendId}`);
-    console.log(`[ConfigRepo] setupSync: rules=`, JSON.stringify(rules, null, 2));
     for (const desc of backends) {
       if (desc.id === primaryBackendId) continue;
+      if (desc.enabled === false) {
+        console.log(`[ConfigRepo] Skipping disabled replica: ${desc.id}`);
+        continue;
+      }
       console.log(`[ConfigRepo] Creating replica backend: id=${desc.id}, type=${desc.type}`);
       try {
         const instance = await createBackend(desc);
@@ -1090,39 +930,23 @@ var ConfigRepo = class {
       }
     }
     console.log(`[ConfigRepo] Available replicas:`, Array.from(this.replicaBackends.keys()));
-    for (const rule of rules) {
-      if (rule.direction === "none") continue;
-      if (!rule.replicas?.length) {
-        console.log(`[ConfigRepo] Skipping rule ${rule.prefix}: no replicas`);
-        continue;
-      }
-      const zenSyncDirection = rule.direction === "bi-directional" ? import_zen_fs_sync.SyncDirection.BiDirectional : import_zen_fs_sync.SyncDirection.OneWay;
-      for (const replicaId of rule.replicas) {
-        if (replicaId === primaryBackendId) continue;
-        const replica = this.replicaBackends.get(replicaId);
-        if (!replica) {
-          console.warn(`[ConfigRepo] Skipping pair ${replicaId}: replica not found (available: ${Array.from(this.replicaBackends.keys()).join(", ")})`);
-          continue;
-        }
-        const pair = this.syncEngine.addPair(
-          this.fullFS,
-          replica.syncable,
-          {
-            direction: zenSyncDirection,
-            conflictStrategy: rule.conflictStrategy,
-            filter: {
-              includePrefixes: [rule.prefix]
-            }
-          },
-          "/"
-        );
-        console.log(`[ConfigRepo] Sync pair added: pairId=${pair.pairId}, prefix=${rule.prefix}, dir=${rule.direction}, replica=${replicaId}`);
-        const conflictHandler = (event) => {
-          this.handleConflict(event, rule);
-        };
-        this.syncEngine.on(pair.pairId, "conflict", conflictHandler);
-        this.syncEngine.watch(pair.pairId);
-      }
+    for (const [replicaId, replica] of this.replicaBackends.entries()) {
+      const pair = this.syncEngine.addPair(
+        this.fullFS,
+        replica.syncable,
+        {
+          direction: import_zen_fs_sync.SyncDirection.OneWay,
+          conflictStrategy: "source-wins"
+          // No filter = sync everything under root
+        },
+        "/"
+      );
+      console.log(`[ConfigRepo] Sync pair added: pairId=${pair.pairId}, replica=${replicaId}, root=/`);
+      const conflictHandler = (event) => {
+        this.handleConflict(event, { prefix: "/", direction: "one-way" });
+      };
+      this.syncEngine.on(pair.pairId, "conflict", conflictHandler);
+      this.syncEngine.watch(pair.pairId);
     }
     console.log(`[ConfigRepo] setupSync complete. Sync statuses:`, this.getSyncStatuses());
   }
@@ -1440,7 +1264,6 @@ async function createConfigRepo(appId, options) {
     options.onConflict
   );
   await repo.setupSync(
-    syncRulesMeta.rules,
     backendsMeta.backends,
     options.primaryBackendId
   );

package/dist/index.mjs

@@ -306,6 +306,7 @@ async function wrapZenFSFileSystem(config) {
         await isolatedFS.createFile(path, { uid: 0, gid: 0, mode: 420 });
       }
       await isolatedFS.write(path, bytes, 0);
+      await isolatedFS.touch(path, { size: bytes.byteLength, mtimeMs: Date.now() });
     },
     async readdir(path) {
       return isolatedFS.readdir(path);
@@ -362,227 +363,59 @@ registerBackend("WebStorage", async (options) => {
   return wrapZenFSFileSystem({ backend: WebStorage, storage });
 });
 registerBackend("GitHub", async (options) => {
-  const token = options.token ?? "";
-  const owner = options.owner ?? "";
-  const repo = options.repo ?? "";
-  const branch = options.branch ?? "main";
-  const baseUrl = options.baseUrl ?? "https://api.github.com";
-  if (!owner || !repo) throw new Error('GitHub backend requires "owner" and "repo" options');
-  const headers = {
-    "Accept": "application/vnd.github.v3+json",
-    "User-Agent": "zen-fs-config"
-  };
-  if (token) headers["Authorization"] = `Bearer ${token}`;
-  const apiUrl = (path) => {
-    const p = path.startsWith("/") ? path.slice(1) : path;
-    return `${baseUrl}/repos/${owner}/${repo}/contents/${p}?ref=${branch}`;
-  };
-  const treeUrl = () => `${baseUrl}/repos/${owner}/${repo}/git/trees/${branch}?recursive=1`;
-  const ghStat = (item) => ({
-    isFile: () => item.type === "file",
-    isDirectory: () => item.type === "dir",
-    size: item.size ?? 0
+  const { Github } = await import("zen-fs-github");
+  return wrapZenFSFileSystem({
+    backend: Github,
+    token: options.token,
+    owner: options.owner,
+    repo: options.repo,
+    branch: options.branch,
+    baseUrl: options.baseUrl && options.baseUrl.trim() || void 0
   });
-  const fetchJson = async (url) => {
-    const res = await fetch(url, { headers });
-    if (!res.ok) throw new Error(`GitHub API ${res.status}: ${url}`);
-    return res.json();
-  };
-  const backend = {
-    async readFile(path, ...args) {
-      const data = await fetchJson(apiUrl(path));
-      if (data.encoding === "base64") {
-        const raw = Uint8Array.from(atob(data.content), (c) => c.charCodeAt(0));
-        if (args[0] === "utf-8") return new TextDecoder().decode(raw);
-        return raw;
-      }
-      return data;
-    },
-    async writeFile(path, data, options2) {
-      const message = options2?.message || `Update ${path}`;
-      const content = typeof data === "string" ? btoa(unescape(encodeURIComponent(data))) : btoa(String.fromCharCode(...new Uint8Array(data)));
-      const sha = await (async () => {
-        try {
-          const d = await fetchJson(apiUrl(path));
-          return d.sha;
-        } catch {
-          return void 0;
-        }
-      })();
-      await fetch(apiUrl(path), {
-        method: "PUT",
-        headers,
-        body: JSON.stringify({ message, content, sha, branch })
-      });
-    },
-    async readdir(path) {
-      const data = await fetchJson(apiUrl(path));
-      return data.map((item) => item.name);
-    },
-    async stat(path, ...args) {
-      try {
-        const data = await fetchJson(apiUrl(path));
-        if (Array.isArray(data)) {
-          return { isFile: () => false, isDirectory: () => true, size: 0 };
-        }
-        return ghStat(data);
-      } catch {
-        throw new Error(`ENOENT: ${path}`);
-      }
-    },
-    async exists(path) {
-      try {
-        await fetchJson(apiUrl(path));
-        return true;
-      } catch {
-        return false;
-      }
-    },
-    async mkdir(path, options2) {
-      const dirPath = path.replace(/\/$/, "");
-      const keepPath = `${dirPath}/.gitkeep`;
-      const message = options2?.message || `Create directory ${dirPath}`;
-      const content = btoa("");
-      await fetch(apiUrl(keepPath), {
-        method: "PUT",
-        headers,
-        body: JSON.stringify({ message, content, branch })
-      });
-    },
-    async unlink(path) {
-      const data = await fetchJson(apiUrl(path));
-      await fetch(apiUrl(path), {
-        method: "DELETE",
-        headers,
-        body: JSON.stringify({ message: `Delete ${path}`, sha: data.sha, branch })
-      });
-    },
-    async rmdir(path) {
-      const items = await fetchJson(apiUrl(path));
-      if (Array.isArray(items)) {
-        for (const item of items) {
-          const itemPath = `${path}/${item.name}`;
-          if (item.type === "dir") {
-            await backend.rmdir(itemPath);
-          } else {
-            await backend.unlink(itemPath);
-          }
-        }
-      }
-    },
-    async rename(oldPath, newPath) {
-      const content = await backend.readFile(oldPath);
-      await backend.writeFile(newPath, content);
-      await backend.unlink(oldPath);
-    }
-  };
-  return backend;
 });
 registerBackend("Gitee", async (options) => {
-  const token = options.token ?? "";
-  const owner = options.owner ?? "";
-  const repo = options.repo ?? "";
-  const branch = options.branch ?? "master";
-  const baseUrl = options.baseUrl ?? "https://gitee.com/api/v5";
-  if (!owner || !repo) throw new Error('Gitee backend requires "owner" and "repo" options');
-  const fetchJson = async (url) => {
-    const res = await fetch(url);
-    if (!res.ok) throw new Error(`Gitee API ${res.status}: ${url}`);
-    return res.json();
-  };
-  const apiUrl = (path) => {
-    const p = path.startsWith("/") ? path.slice(1) : path;
-    const params = new URLSearchParams({ access_token: token, ref: branch, path: p });
-    return `${baseUrl}/repos/${owner}/${repo}/contents?${params}`;
-  };
-  const ghStat = (item) => ({
-    isFile: () => item.type === "file",
-    isDirectory: () => item.type === "dir",
-    size: item.size ?? 0
-  });
-  const backend = {
-    async readFile(path, ...args) {
-      const data = await fetchJson(apiUrl(path));
-      if (data.content) {
-        const raw = Uint8Array.from(atob(data.content), (c) => c.charCodeAt(0));
-        if (args[0] === "utf-8") return new TextDecoder().decode(raw);
-        return raw;
-      }
-      return data;
-    },
-    async writeFile(path, data, options2) {
-      const message = options2?.message || `Update ${path}`;
-      const content = typeof data === "string" ? btoa(unescape(encodeURIComponent(data))) : btoa(String.fromCharCode(...new Uint8Array(data)));
-      const sha = await (async () => {
-        try {
-          const d = await fetchJson(apiUrl(path));
-          return d.sha;
-        } catch {
-          return void 0;
-        }
-      })();
-      await fetch(apiUrl(path), {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ access_token: token, message, content, sha, branch })
-      });
-    },
-    async readdir(path) {
-      const data = await fetchJson(apiUrl(path));
-      return Array.isArray(data) ? data.map((i) => i.name) : [];
-    },
-    async stat(path) {
-      try {
-        const data = await fetchJson(apiUrl(path));
-        if (Array.isArray(data)) return ghStat({ type: "dir", size: 0 });
-        return ghStat(data);
-      } catch {
-        throw new Error(`ENOENT: ${path}`);
-      }
-    },
-    async exists(path) {
-      try {
-        await fetchJson(apiUrl(path));
-        return true;
-      } catch {
-        return false;
-      }
-    },
-    async mkdir(path, options2) {
-      const dirPath = path.replace(/\/$/, "");
-      const keepPath = `${dirPath}/.gitkeep`;
-      const message = options2?.message || `Create directory ${dirPath}`;
-      await fetch(apiUrl(keepPath), {
-        method: "POST",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ access_token: token, message, content: btoa(""), branch })
-      });
-    },
-    async unlink(path) {
-      const data = await fetchJson(apiUrl(path));
-      await fetch(apiUrl(path), {
-        method: "DELETE",
-        headers: { "Content-Type": "application/json" },
-        body: JSON.stringify({ access_token: token, message: `Delete ${path}`, sha: data.sha, branch })
-      });
-    },
-    async rmdir(path) {
-      const items = await fetchJson(apiUrl(path));
-      if (Array.isArray(items)) {
-        for (const item of items) {
-          const itemPath = `${path}/${item.name}`;
-          if (item.type === "dir") await backend.rmdir(itemPath);
-          else await backend.unlink(itemPath);
-        }
+  const zenGitee = await import("zen-fs-gitee");
+  const { GiteeAPI } = await import("zen-fs-gitee/dist/gitee-api.js");
+  const originalGetTree = GiteeAPI.prototype.getTree;
+  GiteeAPI.prototype.getTree = async function(recursive = true) {
+    try {
+      return await originalGetTree.call(this, recursive);
+    } catch (err) {
+      if (!err.message?.includes("404") && !err.message?.includes("Tree not found")) {
+        throw err;
       }
-    },
-    async rename(oldPath, newPath) {
-      const content = await backend.readFile(oldPath);
-      await backend.writeFile(newPath, content);
-      await backend.unlink(oldPath);
     }
+    console.log(`[Gitee] getTree failed with branch="${this.branch}", resolving to SHA...`);
+    const baseUrl = this.baseUrl || "https://gitee.com/api/v5";
+    const sep = "?";
+    const auth = `access_token=${this.token}`;
+    const branchUrl = `${baseUrl}/repos/${this.owner}/${this.repo}/branches/${this.branch}${sep}${auth}`;
+    const branchRes = await fetch(branchUrl);
+    if (!branchRes.ok) throw new Error(`Gitee: branch "${this.branch}" not found (${branchRes.status})`);
+    const branchData = await branchRes.json();
+    const commitSha = branchData.commit?.sha;
+    if (!commitSha) throw new Error(`Gitee: could not get commit SHA for branch "${this.branch}"`);
+    const commitUrl = `${baseUrl}/repos/${this.owner}/${this.repo}/git/commits/${commitSha}${sep}${auth}`;
+    const commitRes = await fetch(commitUrl);
+    if (!commitRes.ok) throw new Error(`Gitee: commit ${commitSha} not found (${commitRes.status})`);
+    const commitData = await commitRes.json();
+    const treeSha = commitData.tree?.sha;
+    if (!treeSha) throw new Error(`Gitee: could not get tree SHA from commit ${commitSha}`);
+    console.log(`[Gitee] Resolved branch="${this.branch}" \u2192 commit=${commitSha.slice(0, 8)} \u2192 tree=${treeSha.slice(0, 8)}`);
+    const treeUrl = `${baseUrl}/repos/${this.owner}/${this.repo}/git/trees/${treeSha}${sep}recursive=${recursive ? 1 : 0}&${auth}`;
+    const treeRes = await fetch(treeUrl);
+    if (!treeRes.ok) throw new Error(`Gitee: tree ${treeSha} not found (${treeRes.status})`);
+    const treeData = await treeRes.json();
+    return treeData.tree || [];
   };
-  return backend;
+  return wrapZenFSFileSystem({
+    backend: zenGitee.Gitee,
+    token: options.token,
+    owner: options.owner,
+    repo: options.repo,
+    branch: options.branch,
+    baseUrl: options.baseUrl && options.baseUrl.trim() || void 0
+  });
 });
 registerBackend("WebDAV", async (options) => {
   const url = options.url ?? "";
@@ -809,6 +642,10 @@ var ConfigRepo = class {
     this.fs = createChrootFS(cachedFS, `/${appId}`);
     this.rootFS = createChrootFS(cachedFS, "/");
   }
+  /** Full path to this node's directory on the primary backend. */
+  get nodePath() {
+    return `/nodes/${this.nodeId}`;
+  }
   // -----------------------------------------------------------------------
   // IConfigRepo — Load
   // -----------------------------------------------------------------------
@@ -1027,11 +864,14 @@ var ConfigRepo = class {
   // -----------------------------------------------------------------------
   // Internal — Setup
   // -----------------------------------------------------------------------
-  async setupSync(rules, backends, primaryBackendId) {
+  async setupSync(backends, primaryBackendId) {
     console.log(`[ConfigRepo] setupSync: ${backends.length} backends, primary=${primaryBackendId}`);
-    console.log(`[ConfigRepo] setupSync: rules=`, JSON.stringify(rules, null, 2));
     for (const desc of backends) {
       if (desc.id === primaryBackendId) continue;
+      if (desc.enabled === false) {
+        console.log(`[ConfigRepo] Skipping disabled replica: ${desc.id}`);
+        continue;
+      }
       console.log(`[ConfigRepo] Creating replica backend: id=${desc.id}, type=${desc.type}`);
       try {
         const instance = await createBackend(desc);
@@ -1043,39 +883,23 @@ var ConfigRepo = class {
       }
     }
     console.log(`[ConfigRepo] Available replicas:`, Array.from(this.replicaBackends.keys()));
-    for (const rule of rules) {
-      if (rule.direction === "none") continue;
-      if (!rule.replicas?.length) {
-        console.log(`[ConfigRepo] Skipping rule ${rule.prefix}: no replicas`);
-        continue;
-      }
-      const zenSyncDirection = rule.direction === "bi-directional" ? SyncDirection.BiDirectional : SyncDirection.OneWay;
-      for (const replicaId of rule.replicas) {
-        if (replicaId === primaryBackendId) continue;
-        const replica = this.replicaBackends.get(replicaId);
-        if (!replica) {
-          console.warn(`[ConfigRepo] Skipping pair ${replicaId}: replica not found (available: ${Array.from(this.replicaBackends.keys()).join(", ")})`);
-          continue;
-        }
-        const pair = this.syncEngine.addPair(
-          this.fullFS,
-          replica.syncable,
-          {
-            direction: zenSyncDirection,
-            conflictStrategy: rule.conflictStrategy,
-            filter: {
-              includePrefixes: [rule.prefix]
-            }
-          },
-          "/"
-        );
-        console.log(`[ConfigRepo] Sync pair added: pairId=${pair.pairId}, prefix=${rule.prefix}, dir=${rule.direction}, replica=${replicaId}`);
-        const conflictHandler = (event) => {
-          this.handleConflict(event, rule);
-        };
-        this.syncEngine.on(pair.pairId, "conflict", conflictHandler);
-        this.syncEngine.watch(pair.pairId);
-      }
+    for (const [replicaId, replica] of this.replicaBackends.entries()) {
+      const pair = this.syncEngine.addPair(
+        this.fullFS,
+        replica.syncable,
+        {
+          direction: SyncDirection.OneWay,
+          conflictStrategy: "source-wins"
+          // No filter = sync everything under root
+        },
+        "/"
+      );
+      console.log(`[ConfigRepo] Sync pair added: pairId=${pair.pairId}, replica=${replicaId}, root=/`);
+      const conflictHandler = (event) => {
+        this.handleConflict(event, { prefix: "/", direction: "one-way" });
+      };
+      this.syncEngine.on(pair.pairId, "conflict", conflictHandler);
+      this.syncEngine.watch(pair.pairId);
     }
     console.log(`[ConfigRepo] setupSync complete. Sync statuses:`, this.getSyncStatuses());
   }
@@ -1393,7 +1217,6 @@ async function createConfigRepo(appId, options) {
     options.onConflict
   );
   await repo.setupSync(
-    syncRulesMeta.rules,
     backendsMeta.backends,
     options.primaryBackendId
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zen-fs-config",
-  "version": "0.3.11",
+  "version": "0.3.13",
   "description": "Distributed config management library built on ZenFS, zen-fs-cache, and zen-fs-sync",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -39,6 +39,8 @@
   "peerDependencies": {
     "@zenfs/core": ">=2.3.0",
     "zen-fs-cache": ">=1.0.0",
+    "zen-fs-gitee": ">=1.0.0",
+    "zen-fs-github": ">=1.0.0",
     "zen-fs-sync": ">=0.1.0"
   },
   "devDependencies": {
@@ -46,6 +48,8 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "zen-fs-cache": "^1.0.1",
+    "zen-fs-gitee": "^1.0.0",
+    "zen-fs-github": "^1.0.0",
     "zen-fs-sync": "^0.1.0"
   },
   "dependencies": {