Skip to content

Commit 8e7c8bf

Browse files
docs: rewrite README for practical tone, remove taglines and metaphors
Remove eigenform/organelle language, keep all technical substance. Clean up ecosystem table to match cogos README style. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent cb84416 commit 8e7c8bf

1 file changed

Lines changed: 18 additions & 21 deletions

File tree

README.md

Lines changed: 18 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -1,8 +1,8 @@
11
# Constellation Protocol — Proof of Concept
22

3-
> Part of the [CogOS ecosystem](https://github.com/cogos-dev)**how it TRUSTS**
3+
A distributed identity protocol where trust is earned through temporal consistency, not granted by authority.
44

5-
A distributed trust protocol where **identity is a dynamical property** — coherence with history — rather than a static credential. Each node maintains a hash-chained event ledger in a git repository, broadcasts signed state snapshots to peers, and derives trust from temporal consistency rather than certificate authority.
5+
Each node maintains a hash-chained event ledger in a git repository, broadcasts signed state snapshots to peers, and derives trust from behavioral history rather than certificate authority. Stolen keys are insufficient for impersonation because trust is coupled to the full event chain, not just a credential.
66

77
## What This Proves
88

@@ -16,7 +16,7 @@ Each node validates its own coherence through a 3-layer stack applied to its git
1616
- **Schema validation**: Required fields present, valid RFC 3339 timestamps, non-empty hashes
1717
- **Temporal monotonicity**: Timestamps non-decreasing, sequence numbers contiguous
1818

19-
A node that detects its own incoherence reports `pass: false` on its `/health` endpoint. This is the eigenform property -- the system is a self-consistent fixed point of its own validation process, where re-applying the rules leaves the system unchanged. `x = F(x)`.
19+
A node that detects its own incoherence reports `pass: false` on its `/health` endpoint. The validation is idempotent -- re-applying the rules to a consistent ledger leaves it unchanged.
2020

2121
### 2. O(1) Mutual Verification
2222

@@ -26,7 +26,7 @@ Nodes exchange signed heartbeats containing `{node_id, tree_hash, seq, last_hash
2626
2. Verify NodeID matches public key (one hash)
2727
3. Check `seq == last_known_seq + 1` (one comparison)
2828

29-
No event replay, no Merkle proof traversal, no state synchronization. The tree hash of the git events directory serves as a compact state fingerprint if two nodes agree on the tree hash, they agree on all events. This is temporal coupling, not mechanical coupling.
29+
No event replay, no Merkle proof traversal, no state synchronization. The tree hash of the git events directory serves as a compact state fingerprint -- if two nodes agree on the tree hash, they agree on all events.
3030

3131
### 3. Stolen Keys Insufficient for Impersonation
3232

@@ -271,32 +271,29 @@ apps/constellation-poc/
271271

272272
## Connection to CogOS
273273

274-
Constellation is the trust organelle in the [CogOS](https://github.com/cogos-dev/cogos) ecosystem — it answers "how does the cell trust?" CogOS externalizes attention and executive function for intelligent systems; Constellation externalizes identity verification and trust scoring across distributed nodes.
274+
Constellation is the trust layer in the [CogOS](https://github.com/cogos-dev/cogos) ecosystem. It handles identity verification and trust scoring across distributed nodes.
275275

276-
In the CogOS cell model, Constellation enables the 4-node topology (laptop, phone, desktop, cloud) where each node maintains its own workspace but verifies peer coherence through temporal coupling. The kernel imports Constellation as a Go library via the `ConstellationBridge` interface in standalone mode, a `NilBridge` provides healthy defaults with zero overhead.
276+
In a multi-node CogOS deployment (laptop, phone, desktop, cloud), each node maintains its own workspace and verifies peer coherence through Constellation. The kernel imports Constellation as a Go library via the `ConstellationBridge` interface -- in standalone mode, a `NilBridge` provides healthy defaults with zero overhead.
277277

278-
Each event in the ledger is a CogBlock — the quantum of distinction in the CogOS ontology. Workspace sync uses Syncthing BEP as the transport layer, with signed `SyncEnvelopes` gated by trust score before ingestion.
278+
Workspace sync uses Syncthing BEP as the transport layer, with signed `SyncEnvelopes` gated by trust score before ingestion.
279279

280-
| Ecosystem | |
281-
|-----------|--|
282-
| [cogos](https://github.com/cogos-dev/cogos) | The kernel — what it IS |
283-
| **constellation** | **Trust — how it TRUSTS** |
284-
| [mod3](https://github.com/cogos-dev/mod3) | Modality — how it ACTS |
285-
| [charts](https://github.com/cogos-dev/charts) | Deployment — how it DEPLOYS |
286-
| [desktop](https://github.com/cogos-dev/desktop) | Interface — how you USE it |
287-
| [skills](https://github.com/cogos-dev/skills) | Plugins — what it CAN DO |
288-
| [research](https://github.com/cogos-dev/research) | Theory — why it WORKS |
289-
| [openclaw-plugin](https://github.com/cogos-dev/openclaw-plugin) | OpenClaw integration — how it CONNECTS |
280+
| Repo | Purpose |
281+
|------|---------|
282+
| [cogos](https://github.com/cogos-dev/cogos) | The daemon |
283+
| **constellation** | **Distributed identity and trust -- this repo** |
284+
| [mod3](https://github.com/cogos-dev/mod3) | Voice -- multi-model TTS |
285+
| [charts](https://github.com/cogos-dev/charts) | Helm charts for deployment |
286+
| [desktop](https://github.com/cogos-dev/desktop) | macOS dashboard app |
287+
| [skills](https://github.com/cogos-dev/skills) | Agent skill library |
290288

291289
For the full system specification: [CogOS System Spec](https://github.com/cogos-dev/cogos/blob/main/docs/SYSTEM-SPEC.md)
292290
For the research paper thesis: [Paper Thesis](docs/PAPER.md)
293291

294292
## Theoretical Context
295293

296-
The protocol models identity as a fixed point of a self-referential validation process:
294+
The protocol models identity as a fixed point of a self-validating process:
297295

298-
- **Self-referential closure** (`x = F(x)`): A node is the eigenform of its own coherence validation
299-
- **Thermodynamic cost** (ln(2) per distinction): Every event that passes validation has paid its Landauer cost
296+
- **Self-referential closure** (`x = F(x)`): A node's coherence check is idempotent -- re-applying validation leaves the system unchanged
300297
- **Temporal coupling** (not mechanical): Nodes couple through shared timeline, not forced consensus
301298

302-
The key insight: blockchain's O(n^2) consensus cost arises from treating identity as a static credential in an adversarial environment. When identity is instead a dynamical property — coherence with history verification becomes O(1) per peer and stolen credentials become insufficient for impersonation.
299+
The key insight: blockchain's O(n^2) consensus cost arises from treating identity as a static credential in an adversarial environment. When identity is instead tied to behavioral history, verification becomes O(1) per peer and stolen credentials become insufficient for impersonation.

0 commit comments

Comments
 (0)