docs/README.md

# mantra docs

Notes on the parts of this app whose behaviour is not recoverable by reading the
code alone — where the reasoning lives in a protocol, a failure mode that is
silent, or a decision that looked arbitrary and was not.

| document | covers |
|---|---|
| [shared-key-ceremony.md](./shared-key-ceremony.md) | ChillDKG over NIP-17: the rounds, the approval gates, the chat transcript, participant ordering |
| [shared-key-derivation.md](./shared-key-derivation.md) | deriving further keys from the group's threshold key with FROST tweaks — why not BIP32, why no chain code, and the one rule that must not be broken |
| [marmot-membership.md](./marmot-membership.md) | how members join an MLS group, and the epoch race that makes a missing member look like a successful invite |
| [long-running-sync.md](./long-running-sync.md) | keeping the chat subscriptions open instead of pulling once per screen — what the request-queue pipeline assumes about short subscriptions, and how the group filter follows the room list |

Start with the ceremony if you are new to this area; the next two both assume it.
The sync note stands alone.
docs: write down the shared-key subsystem and how Marmot membership fails 2026-09-05 14:39:19 +02:00			`# mantra docs`

			`Notes on the parts of this app whose behaviour is not recoverable by reading the`
			`code alone — where the reasoning lives in a protocol, a failure mode that is`
			`silent, or a decision that looked arbitrary and was not.`

			`\| document \| covers \|`
			`\|---\|---\|`
			`\| [shared-key-ceremony.md](./shared-key-ceremony.md) \| ChillDKG over NIP-17: the rounds, the approval gates, the chat transcript, participant ordering \|`
			`\| [shared-key-derivation.md](./shared-key-derivation.md) \| deriving further keys from the group's threshold key with FROST tweaks — why not BIP32, why no chain code, and the one rule that must not be broken \|`
			`\| [marmot-membership.md](./marmot-membership.md) \| how members join an MLS group, and the epoch race that makes a missing member look like a successful invite \|`
docs: write down how a long-running chat sync would work 2026-09-05 16:01:47 +02:00			`\| [long-running-sync.md](./long-running-sync.md) \| keeping the chat subscriptions open instead of pulling once per screen — what the request-queue pipeline assumes about short subscriptions, and how the group filter follows the room list \|`
docs: write down the shared-key subsystem and how Marmot membership fails 2026-09-05 14:39:19 +02:00
docs: write down how a long-running chat sync would work 2026-09-05 16:01:47 +02:00			`Start with the ceremony if you are new to this area; the next two both assume it.`
			`The sync note stands alone.`