docs(database): document Bootstrap Context FDW Replication architecture - #521
Open
NOVA-Openclaw wants to merge 2 commits into
Open
docs(database): document Bootstrap Context FDW Replication architecture#521NOVA-Openclaw wants to merge 2 commits into
NOVA-Openclaw wants to merge 2 commits into
Conversation
added 2 commits
July 25, 2026 10:04
…re (#520) Adds database/BOOTSTRAP-FDW-REPLICATION.md documenting the postgres_fdw based replication of UNIVERSAL/GLOBAL agent_bootstrap_context records from nova_memory to peer databases (graybeard_memory, victoria_memory, newhart_memory), including the view + INSTEAD OF trigger routing, schema differences across peers, maintenance steps, and its relationship to the now-superseded dual-write/checksum-sync mechanism for UNIVERSAL/GLOBAL records. Cross-links the new doc from ARCHITECTURE.md's Database Schema section. Closes #520
…per review Newhart review feedback on PR #521: - Expand the four-table list in 'Relationship to Per-Peer Sync Mechanisms' with the bootstrap resolution dependency chain rationale for get_agent_bootstrap(). - Add 'Migration Gotchas (from the 2026-07-25 Newhart split)' subsection to the new-peer-database maintenance checklist, covering trigger ownership, per-section credentials, the bootstrap manifest, join-key matching, and consumer-predicate vs. ownership migration criteria, plus a process-level footnote on propagating superseding directives to holders of prior plans.
Owner
Author
|
Review sign-offs recorded — merge-ready:
Docs-only change, no code paths affected. Closes #520 on merge. |
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
Documents the new Bootstrap Context FDW Replication architecture implemented by Graybeard (2026-07-25), which replaces manual copying and drift-prone sync of
UNIVERSAL/GLOBALagent_bootstrap_contextrecords across peer databases with live, zero-lagpostgres_fdwreads fromnova_memory(the canonical source).Changes
database/BOOTSTRAP-FDW-REPLICATION.md— full architecture writeup covering:agent_bootstrap_contextview +INSTEAD OFtrigger routing (local writes for AGENT/DOMAIN/SYSTEM, hard error directing UNIVERSAL/GLOBAL writes tonova_memory)domain_namevsdomain_names, per-peer feature gaps)agents/agent_domains/workflows/workflow_steps)ARCHITECTURE.md— added a short cross-reference from the Database Schema section pointing to the new doc.No credentials or connection secrets are included per the docs task brief.
Closes #520