claude-simple 0.2.24 → 0.2.25

package/README.md

@@ -14,6 +14,24 @@ Inspired by [cc-connect](https://github.com/chenhg5/cc-connect) agent adapters:
 
 **本地跑不需要中心端。** 单机默认就是 Standalone：UI + 后端 + agent 都在同一个 Node 进程里。
 
+### Multi-user, locks, port maps, Flutter
+
+Design: [`docs/multiuser-portmap-design.md`](docs/multiuser-portmap-design.md).
+
+| Piece | What it does |
+|-------|----------------|
+| Roles | `owner` / `admin` / `editor` / `viewer` — live role on mutating APIs |
+| Locks | Lease locks (`POST /api/collab/locks`, heartbeat/release/break). 423 if held. Auto-claim 30s on unguarded writes |
+| Port map | `POST /api/collab/routes` then visit `/r/{slug}/…` — Hub tunnels to edge `host:port` (loopback by default) |
+| Flutter | `app/` — login, machines, locks, routes, users; local JSON cache + sync |
+
+Hub stores users/locks/routes under `hub-data/`. Standalone uses `.collab.json` plus `.credentials.json` (`role` on each user). Invite users: `POST /api/collab/users` as admin/owner.
+
+```
+cd app && flutter run
+# Hub URL e.g. http://127.0.0.1:8080
+```
+
 前端会探测 `GET /api/hub`：没有该接口即按单机模式工作，逻辑与多机无关。
 
 ```
@@ -70,6 +88,8 @@ npm install -g @openai/codex
 | `CURSOR_HOME`        | `~/.cursor`                     | Cursor home (UI session journal)         |
 | `JWT_SECRET`         | persisted in `.credentials.json` | Override JWT signing key                 |
 | `AUTH_USERNAME` / `AUTH_PASSWORD` | —                    | Bootstrap first user from env            |
+| `ANTHROPIC_BASE_URL` / `ANTHROPIC_AUTH_TOKEN` / `ANTHROPIC_MODEL` | — | Anthropic-compatible APIs (DeepSeek etc.). LaunchAgent does **not** inherit shell `export` — use Settings → Claude env, `~/.claude/settings.json` `env`, or `~/.claude-simple-edge/agent-env.json` |
+| `ANTHROPIC_DEFAULT_*_MODEL` / `CLAUDE_CODE_SUBAGENT_MODEL` / `CLAUDE_CODE_EFFORT_LEVEL` | — | Merged into the Claude spawn env (`effort` e.g. `max`) |
 
 Edge-only env (when connecting to a hub):
 

package/client.js

@@ -150,15 +150,32 @@ async function refreshSessionCatalog() {
       const key = catalogKey(session);
       if (session.sessionId) next[key] = session;
     }
-    const before = syncState.catalog || {};
+    // Prefer the in-flight snapshot so a missing Hub ACK cannot re-diff
+    // against a stale committed catalog on every file watch.
+    const before = syncState.catalogPending?.next || syncState.catalog || {};
+    const fingerprint = (session) => {
+      if (!session) return '';
+      const { updatedAt, ...rest } = session;
+      return JSON.stringify(rest);
+    };
     const upserts = Object.entries(next)
-      .filter(([key, value]) => JSON.stringify(before[key]) !== JSON.stringify(value))
+      .filter(([key, value]) => fingerprint(before[key]) !== fingerprint(value))
       .map(([, value]) => value);
     const removes = Object.keys(before).filter(key => !next[key]);
     if (upserts.length || removes.length) {
       // Keep the outgoing delta on disk until the Hub confirms it. Retrying
       // is safe because Hub-side upserts/removes are idempotent.
-      const id = ++syncState.catalogSeq;
+      // If the Hub never ACKs (older hub, drop), do not mint a new seq or log
+      // on every fs watch — that flooded edge.out.log with "+1 -0".
+      const prev = syncState.catalogPending;
+      const same = prev
+        && JSON.stringify(prev.upserts) === JSON.stringify(upserts)
+        && JSON.stringify(prev.removes) === JSON.stringify(removes);
+      if (same) {
+        flushCatalogOutbox();
+        return;
+      }
+      const id = prev?.id || ++syncState.catalogSeq;
       syncState.catalogPending = { id, upserts, removes, next };
       void persistSyncState();
       flushCatalogOutbox();