GaiaFTCL Fusion Mac Cell — Wiki

The sovereign M⁸ plasma control substrate

FortressAI Research Institute | Norwich, Connecticut

Patents: USPTO 19/460,960 | USPTO 19/096,071 — © 2026 Richard Gillespie

Updated: 2026-05-07 · Status: CALORIE — 156/156 tests · 18/18 in-app checks · 11/11 language games validated

---

Table of Contents

1. What This Is

2. Architecture

3. UUM-8D Framework

4. Fusion Domain

5. Mac App

6. Language Games

7. Constitutional Constraints

8. Glossary

Related pages: Mac-Cell-Guide · Sovereign-M8-Qualification · Language-Games · Language-Game-Narrator · Franklin-Consciousness-MQ · vQbitPrimitive-ABI · Directive-Architecture · MCP-Cell-Server

---

1. What This Is

GaiaFTCL is a sovereign macOS application — Franklin.app — that operates an eight-dimensional manifold (M⁸ = S⁴ × C⁴) for constitutionally-governed fusion plasma measurement. It runs entirely in pure Swift 6.2 on Apple Silicon, ships as a single ad-hoc-signed DMG, and is qualified to GAMP 5.

The app is not a dashboard. It is a measurement substrate. Every operator interaction is a projection move validated by VQbitUIValidator before any state is committed. Every committed move produces a ClosureReceipt with a SHA-256 seal. Every receipt persists to SwiftData. No state mutation bypasses the FranklinDriver.propose() sovereign gate.

Three processes, one NATS bus, no external dependencies:

Franklin.app
  ├── Franklin            — SwiftUI macOS app, RealityKit S4 projection
  │     ├── FranklinDriver           — sovereign gate: propose(_:origin:)
  │     ├── FranklinSceneView        — RealityKit USD scene viewer
  │     └── SwiftNATSServer          — embedded NATS on 127.0.0.1:4222
  │
  ├── VQbitVM             — child process: sovereign measurement engine
  │     ├── S4DeltaWire → ManifoldTensorStore → C4ProjectionWire pipeline
  │     ├── VQbitMeasurementGate     — Bell/CHSH gates, constitutional invariants
  │     └── Publishes: gaiaftcl.vm.ready · gaiaftcl.vm.heartbeat (30s)
  │
  └── FranklinConsciousnessService  — child process: C4 projection + audit
        ├── FranklinConsciousnessActor  — C4 projection loop, self-review
        ├── GRDB substrate              — SQLite v1→v11 migrations
        └── Publishes: gaiaftcl.franklin.consciousness.state

Hardware requirement: Apple Silicon (arm64). No Intel path, no AMD path. Unified memory architecture is load-bearing — RealityKit entity updates from C4ProjectionSystem go directly to the GPU without a staging buffer.

---

2. Architecture

2.1 The Sovereign Gate

Every S4/C4 mutation routes through a single method. Nothing bypasses it.

// Sources/GaiaFTCLApp/FranklinDriver.swift
@MainActor
public func propose(_ move: UIProjectionMove,
                    origin: ValidationOrigin,
                    modelContext: ModelContext? = nil) async -> UIValidationResult

VQbitUIValidator runs four gates in sequence:

1. Bounds gate — all 8 dimensions ∈ [0, 1]

2. Entropy gate — ΔE = current.health − proposed.health ≤ 0 (health must improve or hold)

3. Terminal gate — proposed state must not be .refused or .blocked

4. Mooring gate — primID must not be the zero UUID

On .closed(receipt): state is committed, ClosureReceiptRecord inserted into SwiftData, activeTone updated from domain.

On .refused(code, reason): SHA-256-sealed refused receipt persisted, activeTone shifts to .diagnostic. No state mutation.

2.2 NATS Subject Catalogue

2.3 Persistence

2.4 The Sovereign Mesh

Quorum threshold: ≥5/9 cells. In standalone sovereign mode (single DMG), VQbitVM's gaiaftcl.vm.heartbeat marks all 9 cells live at first tick (~30s). Current mode: sovereign_single (0/5 remote peers). Quorum passes via OQ-004 Path B (standalone) until peers are live.

---

3. UUM-8D Framework

3.1 The Eight-Dimensional State Space

M⁸ = S⁴ × C⁴

S⁴ — Structural (Projection Space). What the system currently believes about the physical state.

C⁴ — Constitutional (Obligation Space). What the system is obligated to do.

Constitutional health = mean(c1, c2, c3, c4).

3.2 Terminal States

3.3 The vQbit Primitive

// Sources/GaiaFTCLCore/VQbitPrimitive.swift
public struct VQbitPrimitive: Sendable, Codable {
    public var s1_structural:  Float32
    public var s2_temporal:    Float32
    public var s3_spatial:     Float32
    public var s4_observable:  Float32
    public var c1_trust:       Float32
    public var c2_identity:    Float32
    public var c3_closure:     Float32
    public var c4_consequence: Float32
    public var primID:         UUID
    public var domain:         String    // FUSION / HEALTH / QUANTUM / etc.
    public var timestampUTC:   String
}

Wire formats (frozen by IQ-007):

Any wire size change requires a full GAMP 5 re-qualification.

3.4 Epistemic Tags

Tags are immutable for the lifetime of a measurement. A M-tagged value cannot be downgraded.

---

4. Fusion Domain

4.1 The Nine Canonical Plant Kinds

The nine fusion plant kinds define the physical parameter space. They are domain contexts for language game projections, not rendered UI entities.

4.2 Fusion Domain — Language Game Mapping

The FUSION-001 language game maps the four S4 dimensions to fusion plasma:

CALORIE on FUSION-001 requires constitutional health ≥ 0.82 with plasma confined.

4.3 Constitutional Rules for Fusion Telemetry

• No NaN, No Infinity. Any NaN or Inf in Ip, Bt, or ne is unconditional REFUSED. The cell does not warn. It halts.
• No negative telemetry. Ip, Bt, and ne must all be ≥ 0.0.
• Stellarator Ip cap. Ip ≤ 0.05 MA. Higher values indicate a configuration error.
• Epistemic tags are immutable. Set at measurement time, cannot change during a run.

---

5. Mac App

5.1 App Architecture

Franklin.app is a pure SwiftUI macOS application targeting macOS 26.0+ (arm64). The three-layer structure:

FranklinDriver (@Observable)
  └─ Sovereign gate for all S4/C4 mutations
  └─ NATS client (SwiftNATSServer embedded)
  └─ SovereignStackLauncher (VQbitVM + FCS process management)

FranklinSceneView (RealityKit)
  └─ FranklinSceneDirector — USD scene catalog
  └─ C4ProjectionSystem — render tick updates from bridge
  └─ C4ManifoldRuntimeBridge — only written via propose()

DomainStageView (SwiftUI nav bar)
  └─ 11 language games (5 nav buttons: FUSION, HEALTH, QUANTUM menu, CHAT, HUD)
  └─ LanguageGameMultiTurnView — per-turn validation + receipt persistence

5.2 The RealityKit S4 Layer

Every domain has a USD scene in FranklinSceneDirector.catalog. USD file locations:

USD hierarchy contract:

def Xform "<FileName>" (kind="group")       ← defaultPrim
    def Xform "<SCOPE_NAME>" (kind="group") ← must match catalog entry
        def Xform "CatalogAnchor"           ← M⁸ origin for portals

C4ProjectionSystem.update() runs every render tick, reads C4ManifoldRuntimeBridge, and updates entity components. The bridge is only written via FranklinDriver.propose().

Current USD portal states (2026-05-07):

5.3 Franklin Consciousness Layer

FranklinConsciousnessActor runs inside FranklinConsciousnessService (child process). It maintains a C4 projection loop, self-review cycle, and inner monologue. All activity is journaled to GRDB (substrate.sqlite). The awakening ceremony runs on first launch and produces a GENESIS record.

Apple Intelligence (FoundationModels) is used for Franklin's chat responses in FRANKLIN-CHAT-001. Entitlement: com.apple.developer.foundation-models.inference.

5.4 Navigation

The main window nav bar (DomainStageView) is structured as five nav entries:

5.5 Franklin Constitutional State (2026-05-07)

Franklin is BLOCKED because C4 values are below threshold. Lift path: replay language games with s1–s4 ≥ 0.85 (requires slider fix) → VQbitVM measures S4 deltas → C4 improves → CALORIE.

5.6 Build

cd cells/xcode

# Build + test
swift build && swift test

# Sovereign DMG (118M, ad-hoc signed arm64)
zsh scripts/build_dmg.sh

# Verify CALORIE
zsh scripts/verify_calorie.sh

Build output: dist/GaiaFTCL-1.0.0.dmg. dist/ is gitignored.

Franklin.app/Contents/MacOS/Franklin is CFBundleExecutable. Build product is GaiaFTCLApp — build_dmg.sh renames it.

---

6. Language Games

Language games are the primary operator interface for submitting S4 projections. Full specification: [[Language-Games]].

Why 10/11 CURE: AppleScript set value of slider does not drive SwiftUI Slider bindings. Submitted s1–s4 stayed at defaults (~0.500). Fix next session: coordinate-based drag on slider track.

---

7. Constitutional Constraints

7.1 Invariant Set

These rules are hard-coded. No configuration, user action, or external signal overrides them.

1. No NaN, No Infinity. NaN/Inf in any S4 dimension → unconditional REFUSED.

2. No negative telemetry. All S4 values ≥ 0.0.

3. All S4/C4 values ∈ [0, 1]. Values outside this range are rejected at the bounds gate.

4. Entropy gate enforced. health_proposed ≥ health_current — system health must not decrease from any validated move.

5. Epistemic tags are immutable. Set at measurement time, cannot be downgraded.

6. Wire sizes frozen. S4DeltaWire.byteCount == 53 and C4ProjectionWire.byteCount == 53 enforced by IQ-007.

7. One authoritative Franklin.usda. Exactly one copy in Sources/GaiaFTCL/Resources/. Duplicates are rejected by check-no-duplicate-franklin-usda.sh.

8. FranklinSceneDirector.catalog scope must match USDA. scope string must exactly equal the def Xform name in the USD file.

9. Quantum algorithm count invariant. quantumAlgorithmCount() == 19. Enforced by IQ-006 and OQ-007.

10. All S4/C4 mutations route through propose(). No direct bridge write. Enforced by UngatedPathClosureTests.swift.

7.2 Change Control

Any change to the following requires a full GAMP 5 re-qualification cycle (IQ → OQ → PQ → new receipts):

• S4DeltaWire.byteCount or C4ProjectionWire.byteCount
• VQbitPrimitive field layout
• FranklinDriver.propose() signature or validation logic
• SovereignQualificationRunner check set

---

8. Glossary