STD-BEADS-002: Oracle Canonical Synchronization & Topology Reconciliation¶

Status: Approved Governing Standard
Authority: Thomas P. Scola Jr. — Work Authority Architecture
Date: 2026-09-23
Bead: bc-1u7 / bl-1mw / bc-kn68

1. Prime Architecture Invariant¶

There is ONE canonical work authority:

CANONICAL_BEADS_AUTHORITY = ORACLE (bluefly-platform)
CANONICAL_DATABASE        = hq
CANONICAL_PORT            = 3308
CANONICAL_PREFIX          = bl

The workstation (Mac) is NOT a second authority.

LOCAL_ROLE = DISPOSABLE_RECONCILIATION_WORKSPACE

2. Synchronization Pipeline Contract¶

ORACLE CANONICAL HQ
    │ (bd backup sync / dolt push)
    ▼
DURABLE OFF-HOST REMOTE (GitLab/DoltHub)
    │ (bd bootstrap / bd dolt pull)
    ▼
DISPOSABLE LOCAL RECONCILIATION COPY (Mac)
    │ (Curate / Dedupe / Reconcile)
    ▼
LOCAL DOLT COMMIT (bd dolt commit)
    │ (bd dolt push)
    ▼
CANONICAL OFF-HOST REMOTE
    │ (bd dolt pull)
    ▼
ORACLE CANONICAL HQ (Verify & Re-arm)

JSONL Law: - JSONL_FOR_AUDIT = YES - JSONL_FOR_BACKUP_INTERCHANGE = YES - JSONL_FOR_ROUTINE_CANONICAL_SYNC = NO (Dolt-native push/pull only)

3. Measured Topology Baseline (2026-09-23)¶

Key	Canonical Oracle	Local Mac (Diverged)	Target Converged State
Dolt Endpoint	`127.0.0.1:3308`	`127.0.0.1:3308` (via gt)	`127.0.0.1:3308` (Oracle)
Dolt Database	`hq`	`hq`	`hq`
Total Issues	11,353	~4,200	11,353+ (Reconciled)
Active Open Issues	1,047	~350	Reconciled
Issue Prefix	`bl`	`bc` (runtime divergence)	`bl` (canonical) / `bc` aliased
Dolt HEAD Commit	`93hnsuhni0u2sgiehi3en98932q16u2m`	`ogtk6u1bov857cd60kgttbem1fq8n124`	Oracle-promoted HEAD
Remote (GitLab)	`blueflyio/blu/blutown.git`	`blueflyio/blu/blucity.git`	Canonical sync remote
Remote (DoltHub)	`doltremoteapi.dolthub.com/bluefly/BluCity`	None	Off-host mirror
`bd` Binary Version	`1.2.2` (6c124203e)	`1.3.0 (dev)` (trips GC gate)	`1.2.2` aligned across fleet
Gas City Version	`1.4.1`	`1.4.1`	`1.4.1`

4. Wave Acceptance Gates¶

Wave 0 — Claim Path Works¶

gc status: controller running, no init failure.
gc convoy list: returns rows, no missing tables.
gc doctor: no native_store_unavailable warnings (bd binary downgraded to 1.2.2 to match linked library).
gc bd list --limit 0: full backlog accessible via native store.

Wave 2 — One Graph¶

gc graph <mountain-id>: zero orphan convoys, no duplicate work records.
gc bd list --limit 0 | grep -c MOUNTAIN: exactly 5 strategic mountains.

Wave 3 — Autonomous Proof¶

gc events | grep factory.gate.evaluated: gate telemetry recorded.
gc costs: cost per accepted outcome baseline established.
Whole-plan acceptance: Non-human agent claims bead under FACTORY_GATE=PASS, delivers through GitLab MR, independent WITNESS proves it, BLU remains in coordination loop.