Skip to content

docs(contract): exemplar centroid moves required -> optional (kannaka-memory#703) - #72

Merged
NickFlach merged 1 commit into
masterfrom
docs/exemplar-centroid-optional
Aug 19, 2026
Merged

NickFlach merged 1 commit into
masterfrom
docs/exemplar-centroid-optional

Conversation

@NickFlach

Copy link
Copy Markdown
Collaborator

Companion to the publisher-side envelope fix already on kannaka-memory master.

The requirement was wrong by design, not just by size: HRM encodings are per-agent — each agent's encoder maps content into its own wave space, and divergence between encoders is deliberate — so an absorbing agent cannot use a foreign centroid. It re-encodes the exemplar's content into its own space; content + content_hash is the interchange payload, and always was. Size seconds the motion: a full centroid is WAVEFRONT_DIM floats, and the top-25 post-dream batch brushes NATS's 1 MB cap at large dims.

With this amendment plus the landed add_envelope change, the shipped exemplar payload is fully on-contract. A regression test pinning the envelope keys lands separately in kannaka-memory.

…-memory#703)

The exemplar publisher never sent centroid and the requirement turned out to
be wrong by design, not just by size: HRM encodings are per-agent — each
agent's encoder maps content into its own wave space, and divergence between
encoders is deliberate — so an absorbing agent cannot use a foreign centroid.
It re-encodes the exemplar's CONTENT into its own space; content plus
content_hash is the interchange payload, and always was. Size seconds the
motion: a full centroid is WAVEFRONT_DIM floats, and at large dims the top-25
post-dream batch brushes NATS's 1 MB payload cap.

The envelope half of kannaka-memory#703 (schema_version + ts via
add_envelope) already landed on the publisher side; with this amendment the
shipped payload is fully on-contract.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@NickFlach
NickFlach merged commit c714b0d into master Aug 19, 2026
2 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant