docs: reframe README and PAPER as L1 projection of the Constellation substrate - #7
Merged
chazmaniandinkle merged 2 commits intoApr 29, 2026
Conversation
…substrate Three substantive updates: - Constellation is one substrate applied to multiple node populations (peer nodes, identities, cogdocs, channels, sessions, agents). The same primitives (RFC 8785 + SHA-256 + git-backed event chain + tree-hash fingerprint + EMA-weighted decay signals) compose into each projection. This repo specifies the peer-node projection. - Three-layer model added: Node (L1, this repo) / Identity (L2, CRD in the cogos kernel reconciled by pkg/reconcile) / Presence (L3, emergent and query-derived from attention + bus events). - Reposition from "Proof of Concept" to reference implementation. Soften the cross-workspace sync claim: the cogos kernel defines a ConstellationBridge seam designed to consume this protocol; BEP sync currently gates by static per-peer trust, with EMA-weighted gating in progress. Cuts: blockchain comparison table from README; Landauer / thermodynamic-cost framing from both surfaces; "novel mathematical framework" register; loaded eigenform vocabulary softened to "fixed point" in PAPER. PAPER's "Connection to CogOS" reframed onto the workspaces-compose-recursively thesis instead of the semiconductive-membrane framing.
The five flagged calls in TestProcessHeartbeat_SequenceDrift_TrustDecreases, TestProcessHeartbeat_DriftCount_Resets_OnConsistent, and TestPeerRegistry_Summarize are establishing peer state for assertions about side effects (DriftCount, Trust, Summarize output). Mark the return values as intentionally discarded with '_ =' to satisfy errcheck. Pre-existing on main; surfaced as a blocker for myrgic#7 (docs).
2 tasks
chazmaniandinkle
pushed a commit
to myrgic/cogos
that referenced
this pull request
Apr 29, 2026
Aligns the description with the new framing landed in myrgic/constellation#7. Constellation is the L1 projection of the Constellation substrate (the same primitives that hash- chained-ledger plus EMA-weighted decay support across multiple node populations); this repo specifies the peer-node protocol and the kernel consumes it via a ConstellationBridge seam. Workspace sync gating by EMA scores is still pending against that seam; this row now reflects current scope rather than planned scope.
5 tasks
chazmaniandinkle
added a commit
to myrgic/.github
that referenced
this pull request
Apr 29, 2026
Replaces the old 'AI agents need persistent memory' framing with a
sharper thesis: every modern AI tool already has memory; what's
missing is shared memory across tools, machines, and orgs. CogOS is
the substrate underneath that solves that.
Substantive changes:
- New opener leads with the cross-tool / cross-device / cross-org gap
and the 'hierarchical like git remotes, but recursive' framing.
- New three-piece architecture diagram (AI tools to kernel to
workspace overlay), replacing the dense seven-module diagram. The
old diagram referenced openclaw reconciler providers (archived).
- New '.cog/ and .git/' section explicitly positions the cognitive
overlay as a sibling to git, not a replacement, with content-
addressed cross-references rather than duplication.
- New 'Workspaces compose' section names the recursive upstream
pattern as the operational expression of selective sovereignty.
- Kernel features rewritten as a lean seven-bullet summary that names
externalized attention as the conceptual frame and reconcilers as
a primary kernel function.
- Repos table cleaned up. Constellation row reframed as L1 trust-node
protocol (matching the recently-merged constellation rewrite).
Research row reframed away from EA/EFM/LoRO acronym soup.
- Quickstart adds 'cogos init' as a step before 'serve'.
- Em-dash substitutes ('--') swept from body prose; commas, periods,
parens, colons used instead.
- TRM name retired throughout. NDCG@10 / LOC / test count metrics
removed.
Aligned with myrgic/cogos#84 (cogos README) and
myrgic/constellation#7 (constellation README) so the three repos
describe the substrate consistently.
chazmaniandinkle
added a commit
to myrgic/.github
that referenced
this pull request
Apr 29, 2026
Replaces the old 'AI agents need persistent memory' framing with a
sharper thesis: every modern AI tool already has memory; what's
missing is shared memory across tools, machines, and orgs. CogOS is
the substrate underneath that solves that.
Substantive changes:
- New opener leads with the cross-tool / cross-device / cross-org gap
and the 'hierarchical like git remotes, but recursive' framing.
- New three-piece architecture diagram (AI tools to kernel to
workspace overlay), replacing the dense seven-module diagram. The
old diagram referenced openclaw reconciler providers (archived).
- New '.cog/ and .git/' section explicitly positions the cognitive
overlay as a sibling to git, not a replacement, with content-
addressed cross-references rather than duplication.
- New 'Workspaces compose' section names the recursive upstream
pattern as the operational expression of selective sovereignty.
- Kernel features rewritten as a lean seven-bullet summary that names
externalized attention as the conceptual frame and reconcilers as
a primary kernel function.
- Repos table cleaned up. Constellation row reframed as L1 trust-node
protocol (matching the recently-merged constellation rewrite).
Research row reframed away from EA/EFM/LoRO acronym soup.
- Quickstart adds 'cogos init' as a step before 'serve'.
- Em-dash substitutes ('--') swept from body prose; commas, periods,
parens, colons used instead.
- TRM name retired throughout. NDCG@10 / LOC / test count metrics
removed.
Aligned with myrgic/cogos#84 (cogos README) and
myrgic/constellation#7 (constellation README) so the three repos
describe the substrate consistently.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Rewrites the public-facing docs to reflect the substrate framing developed in design discussions since the original PoC drop. Three substantive updates:
Constellation is a unified substrate, not just an identity protocol. The same primitives (RFC 8785 canonical JSON, SHA-256 content hashing, git-backed
events/{seq:08d}.jsonchain withprior_hashlinking, tree-hash state fingerprint, EMA-weighted decay signals) apply to multiple node populations: peer nodes, identities, cogdocs, channels, sessions, agents. This repo specifies the peer-node projection. Other projections live in the cogos kernel.Three-layer model. Node (L1, this repo) / Identity (L2,
kind: IdentityCRD reconciled bypkg/reconcilein the cogos kernel, OIDC-shaped) / Presence (L3, emergent, query-derived from the attention table and bus events). L1 node keys sign L2 attestations.Reference implementation, not Proof of Concept. Title and framing updated to match how the project is actually used. The cogos kernel defines a
ConstellationBridgeseam designed to consume this protocol.What's cut
ln(2) per distinctionline and the "thermodynamic work invested" claim)What's softened
The README claim that the cogos kernel imports this repo as a Go library and uses its trust scores to gate cross-workspace sync was structurally aspirational. Verified against the kernel:
cogos/go.modhas no dependency oncogos-dev/constellationConstellationBridgeis an interface defined inside the kernel; the only implementation present isNilBridge(standalone-mode defaults)Trustedflag inpkg/bep/config.go, not by EMA scores from this protocolThe new framing: "the cogos kernel defines a
ConstellationBridgeseam designed to consume this protocol; BEP sync currently uses static per-peer trust, with EMA-weighted gating in progress."Alignment
cogos-devorg-level README's framing (workspaces compose hierarchically like git remotes but recursive; AI tools → kernel → workspace overlay;.cog/and.git/as siblings)cogos-dev/constellationGitHub repo description, then update the cogos README's ecosystem table mention.Test plan