Skip to content

Commit efa0e89

Browse files
authored
Freeze the dormant sync IPC bridge (#161)
1 parent 68c3afc commit efa0e89

4 files changed

Lines changed: 996 additions & 0 deletions

File tree

CHANGELOG.md

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -8,6 +8,12 @@ EXPERIMENTAL, so on-disk formats and the CLI may change without notice.
88

99
### Changed
1010

11+
- **The dormant `fabric/sync-ipc/1` local bridge now has a frozen contract.**
12+
Versioned, bounded control frames negotiate peer resolution, raw sync streams,
13+
status, shutdown, and structured errors. The socket is owner-only, verifies
14+
the local user and daemon-instance nonce, and applies no extra framing after
15+
a stream is ready. Production still uses the embedded sync engine.
16+
1117
- **`fabric doctor` now gives uncertainty a distinct exit code.** Code 0 means
1218
verified healthy, code 1 means a problem or setup remains, and code 3 means
1319
one or more checks are unknown with no known problem. Clap keeps code 2 for

README.md

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -972,6 +972,11 @@ The sync engine receives explicit config and state paths instead of the daemon
972972
home. It holds `<home>/sync/owner.lock` for its lifetime, so a second engine
973973
fails before it reads or changes the same state.
974974

975+
The library also defines a dormant `fabric/sync-ipc/1` Unix bridge for the
976+
planned companion process. Its owner-only socket uses bounded, versioned control
977+
messages, then carries raw `fabric/sync/1` bytes. No production request selects
978+
this bridge yet; the daemon remains the embedded sync owner.
979+
975980
Entries live in an authoritative, hand-editable `syncs.toml` next to `peers.toml`
976981
(`~/.config/fabric/syncs.toml` for the default home, `<home>/syncs.toml` with
977982
`--home` or `FABRIC_HOME`):

0 commit comments

Comments
 (0)