External/beardrive
1
0
Fork 0
mirror of https://github.com/runbear-io/beardrive.git synced 2026-08-25 08:08:08 +02:00
Code Issues Packages Projects Releases Wiki Activity

feat(sync): agents hear what teammates changed before they overwrite it (BEA-127) (#144)

Browse Source 
A teammate's agent rewrites a file and yours never hears about it — the only
trace is a `.bdrive-conflict-*` nobody opens. Now the turn-start hook names
the paths that arrived since the last turn: "re-read before editing".

The record lives in a spool (`internal/store/inbound.go`), not in Cycle's
Result, because the daemon usually materializes a peer's change seconds
before the turn starts — so the hook's own cycle sees nothing. materialize
appends every path it writes or removes, `bdrive sync --hook` drains it after
its cycle and renders it under each mount's own prefix (stripping the session
subpath when the run is inside a mount, dropping paths outside it).

Advisory only: nothing blocks, nothing prompts, no per-Write remote call. The
spool is capped, 0600, in the volume dir, and best-effort everywhere — a
spool failure never fails a cycle or a turn.

Co-authored-by: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Snow Lee (Sungwon)
2026-08-10 14:33:20 -07:00
committed by GitHub
co-authored by Claude Opus 5
parent 2875e033be
commit 5623113ff7
11 changed files with 584 additions and 12 deletions
Download Patch File Download Diff File Expand all files Collapse all files
web/docs/src/content/docs/guides/shared-agent-memory.md
+16
View File
@@ -90,6 +90,22 @@ bdrive log wiki # which areas are alive
— and, if this device created the project, offer to draft `AGENTS.md` for the
team.
## Your agent is told what moved
Six people's agents in one folder means an agent can start a turn holding a
copy of a file a teammate's agent rewrote an hour ago. So it is told: at turn
start, the sync hook names the files that arrived from teammates since the
last turn — "changed since your last turn, re-read before editing" — with
deletions marked.
It is advisory. Nothing blocks, nothing prompts, no write is refused; the
agent gets the fact and decides. That needs the turn-start hooks `bdrive init`
registers ([Hooks in detail](/manual/hooks/)) — without them nothing drains
the list, and the agent hears nothing.
The list is capped, so the first turn after joining a project names some of
what arrived rather than the whole project.
## What belongs in shared memory
Good candidates are the things that are expensive to rediscover and cheap to
web/docs/src/content/docs/reference/cli.md
+1 -1
View File
@@ -21,7 +21,7 @@ One binary, `bdrive` — the CLI, the sync daemon, and the web server.
| `bdrive forget <path>...` | Stop syncing a path and remove it from the hub. Adds the rule to `.bdriveignore` (which syncs) and prunes in one step. Local files are never touched, here or on teammates' devices |
| `bdrive url [path]` | Internal hub link for a file or folder — sign-in and membership required. `--sync` pushes first; no argument gives the project home. Computed locally |
| `bdrive share <file>` | Public URL for a synced file. `--list`, `--revoke`, `--expires` (the hub's Share dialog can also set an expiry on an existing link). Refuses a file whose first 1 MiB holds credential-shaped strings — `--force` shares it anyway |
| `bdrive sync [folder]` | Run one sync cycle now. Refuses folders this device never `init`ed and folders paused by `bdrive stop`. `--note <text>` stamps session context onto changes; `--note-ttl` (default 30m) bounds it. `--prune` also removes from the hub what `.bdriveignore` now excludes (files stay on disk everywhere). `--hook <label>` is agent-hook plumbing |
| `bdrive sync [folder]` | Run one sync cycle now. Refuses folders this device never `init`ed and folders paused by `bdrive stop`. `--note <text>` stamps session context onto changes; `--note-ttl` (default 30m) bounds it. `--prune` also removes from the hub what `.bdriveignore` now excludes (files stay on disk everywhere). `--hook <label>` is agent-hook plumbing: it also reports the files teammates changed since the agent's last turn |
| `bdrive hooks [install\|uninstall]` | Register turn-boundary sync hooks in each detected agent platform's user config — once per machine, covering every folder. Run automatically by `bdrive init`; idempotent; `--agent` overrides detection. `uninstall` removes only BearDrive's own hook entries |
| `bdrive read-log [folder]` | Hook plumbing: queue agent file reads for the hub's read heatmap. Registered by `bdrive hooks install` |
| `bdrive status [folder]` | Projects, daemon state, pending changes |