wangchuan 5.3.0 → 5.6.0

package/dist/test/migrate.test.js

@@ -0,0 +1,133 @@
+/**
+ * migrate.test.ts — ensureMigrated unit tests
+ *
+ * Tests profile reconciliation behavior: verifies that user customizations
+ * (enabled state, workspacePath) are preserved while sync definitions are
+ * updated from latest agent definitions.
+ */
+import { describe, it, after, before } from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { ensureMigrated } from '../src/core/migrate.js';
+import { config, CONFIG_VERSION } from '../src/core/config.js';
+import { buildDefaultProfiles, buildDefaultShared } from '../src/agents/index.js';
+import { AGENT_NAMES } from '../src/types.js';
+const TMP = fs.mkdtempSync(path.join(os.tmpdir(), 'wc-test-migrate-'));
+// Create a synthetic ~/.wangchuan structure for config.save() calls inside ensureMigrated
+const FAKE_HOME = path.join(TMP, 'home');
+const WANGCHUAN_DIR = path.join(FAKE_HOME, '.wangchuan');
+const REPO_DIR = path.join(WANGCHUAN_DIR, 'repo');
+// Backup real paths and override
+const REAL_SAVE = config.save.bind(config);
+let savedCfg = null;
+before(() => {
+    fs.mkdirSync(REPO_DIR, { recursive: true });
+    fs.mkdirSync(path.join(REPO_DIR, 'agents'), { recursive: true });
+    // Monkey-patch config.save to capture output without writing to real ~/.wangchuan
+    config.save = (cfg) => {
+        savedCfg = cfg;
+    };
+});
+after(() => {
+    // Restore real save
+    config.save = REAL_SAVE;
+    fs.rmSync(TMP, { recursive: true, force: true });
+});
+/** Build a minimal v2 config for testing */
+function buildTestConfig(profileOverrides) {
+    const defaults = buildDefaultProfiles();
+    const profiles = {};
+    for (const name of AGENT_NAMES) {
+        const def = defaults[name];
+        const override = profileOverrides?.[name];
+        profiles[name] = { ...def, ...override };
+    }
+    return {
+        repo: 'git@github.com:test/test.git',
+        branch: 'main',
+        localRepoPath: REPO_DIR,
+        keyPath: path.join(WANGCHUAN_DIR, 'master.key'),
+        hostname: 'test-host',
+        version: CONFIG_VERSION,
+        profiles: { default: profiles },
+        shared: buildDefaultShared(),
+    };
+}
+describe('ensureMigrated — v2 config reconciliation', () => {
+    it('already-current v2 config passes through without error', () => {
+        const cfg = buildTestConfig();
+        const result = ensureMigrated(cfg);
+        assert.equal(result.version, CONFIG_VERSION);
+    });
+    it('preserves user enabled=true when reconciling', () => {
+        const cfg = buildTestConfig({ claude: { enabled: true } });
+        const result = ensureMigrated(cfg);
+        const claude = result.profiles.default.claude;
+        assert.equal(claude.enabled, true);
+    });
+    it('preserves user enabled=false when reconciling', () => {
+        const cfg = buildTestConfig({ openclaw: { enabled: false } });
+        const result = ensureMigrated(cfg);
+        const oc = result.profiles.default.openclaw;
+        assert.equal(oc.enabled, false);
+    });
+    it('preserves user workspacePath customization', () => {
+        const customPath = '/custom/workspace/path';
+        const cfg = buildTestConfig({ gemini: { workspacePath: customPath } });
+        const result = ensureMigrated(cfg);
+        assert.equal(result.profiles.default.gemini.workspacePath, customPath);
+    });
+    it('updates syncFiles from latest definitions', () => {
+        const defaults = buildDefaultProfiles();
+        const latestClaudeFiles = defaults.claude.syncFiles;
+        // Start with an outdated syncFiles (empty array)
+        const cfg = buildTestConfig({ claude: { syncFiles: [] } });
+        const result = ensureMigrated(cfg);
+        assert.deepEqual(result.profiles.default.claude.syncFiles, latestClaudeFiles);
+    });
+    it('result contains all agent names', () => {
+        const cfg = buildTestConfig();
+        const result = ensureMigrated(cfg);
+        for (const name of AGENT_NAMES) {
+            assert.ok(result.profiles.default[name] !== undefined, `agent ${name} should be present in reconciled profiles`);
+        }
+    });
+    it('result has shared config', () => {
+        const cfg = buildTestConfig();
+        const result = ensureMigrated(cfg);
+        assert.ok(result.shared !== undefined);
+        assert.ok(result.shared.skills !== undefined);
+        assert.ok(result.shared.mcp !== undefined);
+    });
+});
+describe('ensureMigrated — new agent detection', () => {
+    it('adds new agents from definitions with enabled=false', () => {
+        // Build a config missing the last agent to simulate an upgrade
+        const defaults = buildDefaultProfiles();
+        const profiles = {};
+        const allNames = [...AGENT_NAMES];
+        const removedAgent = allNames[allNames.length - 1];
+        for (const name of allNames) {
+            if (name === removedAgent)
+                continue;
+            profiles[name] = defaults[name];
+        }
+        const cfg = {
+            repo: 'git@github.com:test/test.git',
+            branch: 'main',
+            localRepoPath: REPO_DIR,
+            keyPath: path.join(WANGCHUAN_DIR, 'master.key'),
+            hostname: 'test-host',
+            version: CONFIG_VERSION,
+            profiles: { default: profiles },
+            shared: buildDefaultShared(),
+        };
+        const result = ensureMigrated(cfg);
+        const added = result.profiles.default[removedAgent];
+        assert.ok(added !== undefined, `${removedAgent} should be added`);
+        assert.equal(added.enabled, false, 'newly added agent should be disabled');
+    });
+});
+//# sourceMappingURL=migrate.test.js.map

package/dist/test/migrate.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.test.js","sourceRoot":"","sources":["../../test/migrate.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AACxD,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,MAAU,IAAI,CAAC;AACxB,OAAO,EAAE,MAAU,IAAI,CAAC;AACxB,OAAO,IAAI,MAAQ,MAAM,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,EAAE,oBAAoB,EAAE,kBAAkB,EAAqB,MAAM,wBAAwB,CAAC;AAErG,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAE9C,MAAM,GAAG,GAAG,EAAE,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,kBAAkB,CAAC,CAAC,CAAC;AAEvE,0FAA0F;AAC1F,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;AACzC,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;AACzD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC,CAAC;AAElD,iCAAiC;AACjC,MAAM,SAAS,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3C,IAAI,QAAQ,GAA2B,IAAI,CAAC;AAE5C,MAAM,CAAC,GAAG,EAAE;IACV,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5C,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,QAAQ,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAEjE,kFAAkF;IACjF,MAAuC,CAAC,IAAI,GAAG,CAAC,GAAoB,EAAE,EAAE;QACvE,QAAQ,GAAG,GAAG,CAAC;IACjB,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,KAAK,CAAC,GAAG,EAAE;IACT,oBAAoB;IACnB,MAAuC,CAAC,IAAI,GAAG,SAAS,CAAC;IAC1D,EAAE,CAAC,MAAM,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC,CAAC;AAEH,4CAA4C;AAC5C,SAAS,eAAe,CAAC,gBAAiE;IACxF,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;IACxC,MAAM,QAAQ,GAAiC,EAAE,CAAC;IAElD,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;QAC/B,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC3B,MAAM,QAAQ,GAAG,gBAAgB,EAAE,CAAC,IAAI,CAAC,CAAC;QAC1C,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,GAAG,EAAE,GAAG,QAAQ,EAAkB,CAAC;IAC3D,CAAC;IAED,OAAO;QACL,IAAI,EAAE,8BAA8B;QACpC,MAAM,EAAE,MAAM;QACd,aAAa,EAAE,QAAQ;QACvB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC;QAC/C,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,cAAc;QACvB,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAoC,EAAE;QAC3D,MAAM,EAAE,kBAAkB,EAAE;KAC7B,CAAC;AACJ,CAAC;AAED,QAAQ,CAAC,2CAA2C,EAAE,GAAG,EAAE;IACzD,EAAE,CAAC,wDAAwD,EAAE,GAAG,EAAE;QAChE,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,8CAA8C,EAAE,GAAG,EAAE;QACtD,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC;QAC9C,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,+CAA+C,EAAE,GAAG,EAAE;QACvD,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9D,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC;QAC5C,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,UAAU,GAAG,wBAAwB,CAAC;QAC5C,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE,CAAC,CAAC;QACvE,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,aAAa,EAAE,UAAU,CAAC,CAAC;IACzE,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,2CAA2C,EAAE,GAAG,EAAE;QACnD,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;QACxC,MAAM,iBAAiB,GAAG,QAAQ,CAAC,MAAM,CAAC,SAAS,CAAC;QAEpD,iDAAiD;QACjD,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;QAC3D,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,SAAS,EAAE,iBAAiB,CAAC,CAAC;IAChF,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,iCAAiC,EAAE,GAAG,EAAE;QACzC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,KAAK,MAAM,IAAI,IAAI,WAAW,EAAE,CAAC;YAC/B,MAAM,CAAC,EAAE,CACP,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,SAAS,EAC3C,SAAS,IAAI,2CAA2C,CACzD,CAAC;QACJ,CAAC;IACH,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,0BAA0B,EAAE,GAAG,EAAE;QAClC,MAAM,GAAG,GAAG,eAAe,EAAE,CAAC;QAC9B,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QACvC,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAO,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC;QAC/C,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,MAAO,CAAC,GAAG,KAAK,SAAS,CAAC,CAAC;IAC9C,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC;AAEH,QAAQ,CAAC,sCAAsC,EAAE,GAAG,EAAE;IACpD,EAAE,CAAC,qDAAqD,EAAE,GAAG,EAAE;QAC7D,+DAA+D;QAC/D,MAAM,QAAQ,GAAG,oBAAoB,EAAE,CAAC;QACxC,MAAM,QAAQ,GAAiC,EAAE,CAAC;QAClD,MAAM,QAAQ,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;QAClC,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAE,CAAC;QAEpD,KAAK,MAAM,IAAI,IAAI,QAAQ,EAAE,CAAC;YAC5B,IAAI,IAAI,KAAK,YAAY;gBAAE,SAAS;YACpC,QAAQ,CAAC,IAAI,CAAC,GAAG,QAAQ,CAAC,IAA2B,CAAC,CAAC;QACzD,CAAC;QAED,MAAM,GAAG,GAAoB;YAC3B,IAAI,EAAE,8BAA8B;YACpC,MAAM,EAAE,MAAM;YACd,aAAa,EAAE,QAAQ;YACvB,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,YAAY,CAAC;YAC/C,QAAQ,EAAE,WAAW;YACrB,OAAO,EAAE,cAAc;YACvB,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAoC,EAAE;YAC3D,MAAM,EAAE,kBAAkB,EAAE;SAC7B,CAAC;QAEF,MAAM,MAAM,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAmC,CAAC,CAAC;QAC3E,MAAM,CAAC,EAAE,CAAC,KAAK,KAAK,SAAS,EAAE,GAAG,YAAY,kBAAkB,CAAC,CAAC;QAClE,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,OAAO,EAAE,KAAK,EAAE,sCAAsC,CAAC,CAAC;IAC7E,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/test/sync-lock.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * sync-lock.test.ts — syncLock unit tests
+ */
+export {};
+//# sourceMappingURL=sync-lock.test.d.ts.map

package/dist/test/sync-lock.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-lock.test.d.ts","sourceRoot":"","sources":["../../test/sync-lock.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/test/sync-lock.test.js

@@ -0,0 +1,94 @@
+/**
+ * sync-lock.test.ts — syncLock unit tests
+ */
+import { describe, it, after } from 'node:test';
+import assert from 'node:assert/strict';
+import fs from 'fs';
+import os from 'os';
+import path from 'path';
+import { execSync } from 'child_process';
+import { syncLock } from '../src/core/sync-lock.js';
+const TMP = fs.mkdtempSync(path.join(os.tmpdir(), 'wc-test-lock-'));
+// Create a bare repo + work clone so acquire() has a valid repoPath for cleanDirtyState
+const BARE = path.join(TMP, 'bare.git');
+const REPO = path.join(TMP, 'repo');
+execSync(`git init --bare "${BARE}"`);
+// Use a seed clone to create initial commit, then re-clone for REPO
+const SEED = path.join(TMP, 'seed');
+execSync(`git clone "${BARE}" "${SEED}"`);
+execSync('git config user.name "Test"', { cwd: SEED });
+execSync('git config user.email "test@test.com"', { cwd: SEED });
+fs.writeFileSync(path.join(SEED, 'init.txt'), 'seed');
+execSync('git add . && git commit -m "seed"', { cwd: SEED });
+// Push to whatever default branch was created
+const branch = execSync('git rev-parse --abbrev-ref HEAD', { cwd: SEED, encoding: 'utf-8' }).trim();
+execSync(`git push origin ${branch}`, { cwd: SEED });
+// Clone fresh for test use
+execSync(`git clone "${BARE}" "${REPO}"`);
+after(() => {
+    // Always clean up lock to avoid polluting the real ~/.wangchuan/
+    syncLock.release();
+    fs.rmSync(TMP, { recursive: true, force: true });
+});
+describe('syncLock.acquire + release', () => {
+    it('basic cycle: lock file created then deleted', async () => {
+        await syncLock.acquire(REPO);
+        assert.ok(fs.existsSync(syncLock.lockPath), 'lock file should exist after acquire');
+        syncLock.release();
+        assert.ok(!fs.existsSync(syncLock.lockPath), 'lock file should be gone after release');
+    });
+});
+describe('syncLock.exists', () => {
+    it('returns true when lock present', async () => {
+        await syncLock.acquire(REPO);
+        assert.equal(syncLock.exists(), true);
+        syncLock.release();
+    });
+    it('returns false when absent', () => {
+        assert.equal(syncLock.exists(), false);
+    });
+});
+describe('syncLock.read', () => {
+    it('returns parsed lock with pid and startedAt', async () => {
+        await syncLock.acquire(REPO);
+        const lock = syncLock.read();
+        assert.ok(lock !== null);
+        assert.equal(lock.pid, process.pid);
+        assert.ok(typeof lock.startedAt === 'string');
+        syncLock.release();
+    });
+    it('returns null for corrupt lock file', () => {
+        // Write garbage to the lock path
+        fs.mkdirSync(path.dirname(syncLock.lockPath), { recursive: true });
+        fs.writeFileSync(syncLock.lockPath, '{{{not json', 'utf-8');
+        const lock = syncLock.read();
+        assert.equal(lock, null);
+        fs.unlinkSync(syncLock.lockPath);
+    });
+});
+describe('syncLock.acquire stale detection', () => {
+    it('cleans stale lock from dead PID', async () => {
+        // Write a lock with a PID that almost certainly does not exist
+        fs.mkdirSync(path.dirname(syncLock.lockPath), { recursive: true });
+        fs.writeFileSync(syncLock.lockPath, JSON.stringify({
+            startedAt: new Date().toISOString(),
+            pid: 999999,
+        }), 'utf-8');
+        // acquire should detect dead PID and succeed
+        await syncLock.acquire(REPO);
+        assert.ok(syncLock.exists());
+        const lock = syncLock.read();
+        assert.equal(lock.pid, process.pid);
+        syncLock.release();
+    });
+    it('throws when live PID holds lock', async () => {
+        await syncLock.acquire(REPO);
+        // Attempting a second acquire with live PID should throw
+        await assert.rejects(() => syncLock.acquire(REPO), (err) => {
+            assert.ok(err.message.includes(String(process.pid)));
+            return true;
+        });
+        syncLock.release();
+    });
+});
+//# sourceMappingURL=sync-lock.test.js.map

package/dist/test/sync-lock.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sync-lock.test.js","sourceRoot":"","sources":["../../test/sync-lock.test.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wangchuan",
-  "version": "5.3.0",
+  "version": "5.6.0",
   "description": "忘川 · AI 记忆同步系统 — 智能体记忆永不遗失",
   "bin": {
     "wangchuan": "./dist/bin/wangchuan.js"
@@ -17,7 +17,7 @@
     "postbuild": "chmod +x dist/bin/wangchuan.js",
     "prepublishOnly": "npm run build",
     "dev": "tsx bin/wangchuan.ts",
-    "test": "node --import tsx/esm --test test/crypto.test.ts test/json-field.test.ts test/sync.test.ts test/sync-history.test.ts test/merge.test.ts",
+    "test": "node --import tsx/esm --test test/crypto.test.ts test/json-field.test.ts test/sync.test.ts test/sync-history.test.ts test/merge.test.ts test/git.test.ts test/sync-lock.test.ts test/migrate.test.ts",
     "typecheck": "tsc --noEmit"
   },
   "keywords": [

package/skill/SKILL.md

@@ -113,12 +113,12 @@ Supported by: `sync`, `status`, `watch`, `memory`.
 | Value | Description |
 |-------|-------------|
 | `openclaw`  | MEMORY.md (enc), AGENTS.md, SOUL.md, TOOLS.md, IDENTITY.md, USER.md (enc), HEARTBEAT.md, BOOTSTRAP.md, memory/ (enc), openclaw.json → agents/skills/ui (enc), skills/ |
-| `claude`    | CLAUDE.md, settings.json (enc), .claude.json → mcpServers (enc) |
-| `gemini`    | settings.internal.json → security + model + general (enc) |
-| `codebuddy` | MEMORY.md (enc), CODEBUDDY.md, mcp.json → mcpServers (enc), settings.json → enabledPlugins (enc) |
-| `workbuddy` | MEMORY.md (enc), IDENTITY.md, SOUL.md, USER.md (enc), BOOTSTRAP.md, mcp.json → mcpServers (enc), settings.json → enabledPlugins (enc) |
-| `cursor`    | rules/ dir, mcp.json → mcpServers (enc), cli-config.json → permissions + model + enabledPlugins (enc) |
-| `codex`     | AGENTS.md, instructions.md |
+| `claude`    | CLAUDE.md, settings.json (enc), .claude.json → mcpServers (enc), commands/ (dir), plugins/ (installed + marketplaces) |
+| `gemini`    | settings.internal.json → security + model + general (enc), skills/ (dir) |
+| `codebuddy` | MEMORY.md (enc), CODEBUDDY.md, mcp.json → mcpServers (enc), settings.json → enabledPlugins + hooks (enc), plugins/ (marketplaces) |
+| `workbuddy` | MEMORY.md (enc), IDENTITY.md, SOUL.md, USER.md (enc), BOOTSTRAP.md, mcp.json → mcpServers (enc), settings.json → enabledPlugins + hooks (enc), skills/ (dir), extensions/ |
+| `cursor`    | rules/ dir, mcp.json → mcpServers (enc), cli-config.json → permissions + model + enabledPlugins (enc), extensions/, hooks.json |
+| `codex`     | MEMORY.md (enc), instructions.md, config.toml (enc), skills/ (dir), memories/ (enc) |
 
 When omitted, operates on all enabled agents plus the shared tier (skills/MCP/custom agents/shared memory).
 
@@ -162,6 +162,78 @@ The watch daemon auto-detects file changes and triggers sync, serving as a safet
 ## Prerequisites
 
 1. Node.js ≥ 18
-2. `wangchuan init` has been run (~/.wangchuan/config.json exists)
-3. Local SSH key has access to the target git repo
-4. Copy `~/.wangchuan/master.key` manually when migrating across machines (or use `wangchuan doctor --key-export`)
+2. Git installed and configured (SSH key or HTTPS credentials)
+3. A **private** Git repo on any hosting platform (GitHub, GitLab, Gitee, Bitbucket, Gitea, or self-hosted)
+
+## Installation
+
+### Install wangchuan CLI
+
+```bash
+npm install -g wangchuan
+```
+
+### First-time setup
+
+```bash
+# Interactive — auto-detects installed agents, creates repo via GitHub CLI if available
+wangchuan init
+
+# Or specify a repo URL directly (any Git hosting):
+wangchuan init --repo git@github.com:you/brain.git
+wangchuan init --repo git@gitlab.com:you/brain.git
+wangchuan init --repo git@gitee.com:you/brain.git
+```
+
+### Install this skill to an agent
+
+Copy the `wangchuan/` skill folder to your agent's skills directory:
+
+```bash
+# Claude
+cp -r wangchuan/ ~/.claude/skills/wangchuan/
+
+# OpenClaw
+cp -r wangchuan/ ~/.openclaw/workspace/skills/wangchuan/
+
+# Codex
+cp -r wangchuan/ ~/.codex/skills/wangchuan/
+
+# Or let wangchuan sync distribute it to all agents automatically:
+wangchuan sync
+```
+
+### Setting up Git repo (if you don't have one)
+
+Create a **private** repo on your preferred platform:
+
+| Platform | How to create |
+|----------|--------------|
+| **GitHub** | `wangchuan init` auto-creates via `gh` CLI, or: github.com → New repository → Private |
+| **GitLab** | gitlab.com → New project → Private |
+| **Gitee** | gitee.com → New repo → Private |
+| **Bitbucket** | bitbucket.org → Create repository → Private |
+| **Gitea** | Your instance → New Repository → Private |
+
+Then: `wangchuan init --repo <ssh-url>`
+
+### New machine setup
+
+```bash
+npm install -g wangchuan
+wangchuan init --repo <your-repo-url> --key <master-key-hex>
+```
+
+Get the master key from your original machine: `wangchuan doctor --key-export`
+
+### Migrating the master key
+
+⚠️ **`master.key` is the ONLY thing that cannot be recovered.** Back it up securely.
+
+```bash
+# On the source machine:
+wangchuan doctor --key-export    # prints wangchuan_<hex>
+
+# On the target machine:
+wangchuan init --repo <url> --key wangchuan_<hex>
+```