You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
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>
Copy file name to clipboardExpand all lines: README.md
+18-21Lines changed: 18 additions & 21 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,8 +1,8 @@
1
1
# Constellation Protocol — Proof of Concept
2
2
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.
4
4
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.
6
6
7
7
## What This Proves
8
8
@@ -16,7 +16,7 @@ Each node validates its own coherence through a 3-layer stack applied to its git
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.
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.
30
30
31
31
### 3. Stolen Keys Insufficient for Impersonation
32
32
@@ -271,32 +271,29 @@ apps/constellation-poc/
271
271
272
272
## Connection to CogOS
273
273
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.
275
275
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.
277
277
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.
279
279
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**|
For the full system specification: [CogOS System Spec](https://github.com/cogos-dev/cogos/blob/main/docs/SYSTEM-SPEC.md)
292
290
For the research paper thesis: [Paper Thesis](docs/PAPER.md)
293
291
294
292
## Theoretical Context
295
293
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:
297
295
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
300
297
-**Temporal coupling** (not mechanical): Nodes couple through shared timeline, not forced consensus
301
298
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