docs(rfc): Update RFC 0001 with refinement dialogue consensus

Browse source

Major updates from 12-round alignment dialogue (unanimous consensus):

Architecture:
- Hybrid coordination: SQLite IPC for real-time hints + Git PRs for durable changes
- SQLite sessions.db replaces JSON file for session coordination
- SQLite cache.db for export/contract/validation caching

Commands:
- Reduced to 5 MVP commands: status, sync, worktree, pr, check
- Admin commands under `blue realm admin` subcommand
- Added `blue realm check` with modes: exporter, importer, contract, compatibility

Contracts:
- Added `owner` field (one exporter per contract)
- Added `compatibility: {backwards, forwards}` rules
- Added `validation:` hooks with ci_only option
- Semver ranges in import bindings

Trust & Governance:
- Explicit trust.permissions model
- Contract ownership enforcement
- Cycle detection and prevention

Credentials:
- Layered: env → git credential → keychain → config
- GitHub App auth support for CI

Conflict Resolution:
- Ownership + semver + git rebase strategy
- Stale bindings as soft warnings

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

...

This commit is contained in:

Eric Garcia 2026-01-24 05:33:55 -05:00

parent af9794f044

commit b8a15c2d87

1 changed files with 537 additions and 1045 deletions

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Show stats Download patch file Download diff file Expand all files Collapse all files

1582

docs/rfcs/0001-cross-repo-realms.md

View file

File diff suppressed because it is too large Load diff