Git mirror of a shared folder #52

New issue

Closed

opened 2026-09-21 18:04:31 +01:00 by cruelacid · 1 comment

cruelacid commented

2026-09-21 18:04:31 +01:00

Owner

Part of #37. Depends on the headless client. Must follow Phase 17.

What Relay does

relay-git-sync, a Python Docker service on the Premium tier, subscribes to
shared folders over websocket and writes timestamped Git commits. Server-side,
because their server reads plaintext.

What we do

The same outcome, from a headless client holding the customer's keys. Ours can be
self-hosted by the customer without trusting us with anything, which is the
better story — but it is a different deployment shape and the docs must say so.

Sequencing: this cannot precede Phase 17

A Git mirror that cannot serialise a canvas produces a repository that is wrong
in a way nobody notices — which is the failure mode CLAUDE.md calls the worst
one, transplanted into a backup. Structured documents must serialise correctly
first.

Risk

risk:additive.

Verification

A round trip: sync a folder containing markdown, attachments and a canvas; the
Git tree reproduces all three faithfully.

Part of #37. Depends on the headless client. **Must follow Phase 17.** ## What Relay does `relay-git-sync`, a Python Docker service on the **Premium** tier, subscribes to shared folders over websocket and writes timestamped Git commits. Server-side, because their server reads plaintext. ## What we do The same outcome, from a headless client holding the customer's keys. Ours can be self-hosted by the customer without trusting us with anything, which is the better story — but it is a different deployment shape and the docs must say so. ## Sequencing: this cannot precede Phase 17 A Git mirror that cannot serialise a canvas produces a repository that is **wrong in a way nobody notices** — which is the failure mode `CLAUDE.md` calls the worst one, transplanted into a backup. Structured documents must serialise correctly first. ## Risk `risk:additive`. ## Verification A round trip: sync a folder containing markdown, attachments and a canvas; the Git tree reproduces all three faithfully.

cruelacid added this to the Phase 18 - Agents and headless milestone

2026-09-21 18:04:31 +01:00

cruelacid added the

labels

2026-09-21 18:04:31 +01:00

cruelacid referenced this issue

2026-09-21 18:08:51 +01:00

Relay feature parity, with end-to-end encryption (tracking) #37