OQ — Operational Qualification¶

Operational Qualification proves that the running sovereign stack produces correct outputs. Every check runs against the live Franklin.app process — not mocks, not stubs.

Document reference: GFTCL-OQ-001-M8
Framework: GAMP 5 | EU Annex 11
Stack: Pure Swift 6.2 / SPM
Prerequisite: IQ CALORIE (all 7 IQ checks passed)

Running OQ¶

In-app (runtime gate — 7 checks):

Launch Franklin.app and wait for stack ready (~30s for VQbitVM first heartbeat)
Click ⬡ → Run Qualification… → RUN QUALIFICATION
OQ runs automatically after IQ completes

Build-time (CI gate — ~80 OQ-tier tests):

cd cells/xcode
swift test --filter GaiaFTCLOQTests

OQ Checks (7 in-app checks)¶

ID	Name	Passes when
OQ-001	VQbitVM emitted vm.ready	`SovereignStackLauncher.phase == .ready`
OQ-002	C4 constitutional health measurable	`mean(c1..c4) > 0` from live `ManifoldOverlayStore`
OQ-003	Terminal state derivation correct	`health >= 0.65 → .calorie`, `0.35..0.65 → .cure`, `< 0.35 → .blocked`
OQ-004	Sovereign cell quorum met	`liveCells >= 5` OR `stackReady` (standalone mode)
OQ-005	Awakening ceremony completed	`ManifoldState.timestampUTC` is non-empty
OQ-006	C4MemoryStore contains genesis record	Memory store has a GENESIS event from this session
OQ-007	Quantum proof invariant	`quantumAlgorithmCount() == 19`

OQ-004 — Cell quorum, two pass paths¶

Path A — Production mesh: liveCells >= CellDescriptor.quorumRequired (5)

FranklinDriver subscribes to gaiaftcl.vm.heartbeat. When VQbitVM's heartbeat arrives (~30s post-launch), all 9 mesh cell IDs (hel-01..hel-05, nbg-01..nbg-04) are marked live. OQ-004 detail shows: 9/9 cells live — quorum threshold: 5.

Path B — Standalone sovereign: stackReady == true

Before VQbitVM's first heartbeat fires, launcher.phase == .ready satisfies quorum. OQ-004 passes via this path for the first 30s after launch; detail shows: Standalone sovereign mode — VQbitVM + FCS instantiated.

OQ Acceptance Criteria¶

Criterion	Requirement
Check count	Exactly 7 checks executed
Pass rate	100% — zero failures permitted
Receipt	`OQ-<timestamp>.json` with `overallStatus: "CALORIE"`

Evidence — 2026-05-09 qualification run¶

OQ results section

Run timestamp: 2026-05-09T10:12:42Z
Platform: macOS Version 26.4.1 (Build 25E253) · Swift 6.2
Verdict: CALORIE — 7/7 pass

ID	Result	Detail
OQ-001	✅ PASS	`SovereignStackLauncher.phase == .ready`
OQ-002	✅ PASS	`health=0.6566 c1=0.556 c2=0.481 c3=0.690 c4=0.900`
OQ-003	✅ PASS	`health=0.657 → expected CALORIE, got CALORIE`
OQ-004	✅ PASS	Standalone sovereign mode — VQbitVM + FCS instantiated (no external mesh)
OQ-005	✅ PASS	Manifold timestamped `2026-05-09T09:47:36Z`
OQ-006	✅ PASS	Genesis event found: `GENESIS. I am Franklin. Session 9535F5C6. Born 2026-05-09T09…`
OQ-007	✅ PASS	Quantum algorithm count = 19 (invariant: 19)

Receipt written to ~/Library/Application Support/GaiaFTCL/qualification/OQ-<timestamp>.json

Build-time OQ test suite (~80 tests in `Tests/GAMP5/OQ/`)¶

Key test files:

File	Tests	What they cover
`ReceiptPersistenceTests.swift`	RP-001..006	ClosureReceipt → SwiftData persistence, sessionID, entropyDelta ≤ 0
`UngatedPathClosureTests.swift`	UPC-001..006	Every S4/C4 mutation path routes through `FranklinDriver.propose()`
`UISpecConformanceTests.swift`	UI-AVATAR-001, UI-PORTAL-ATTACH-001	USD REFUSED terminals declared on Avatar and portal prims
`LanguageGameOQTests.swift`	LG-001..LG-N	Language game domain contracts, vQbit validation, receipt closure

Run: swift test from cells/xcode/

Continuous operational measurement — Quantum C4¶

In addition to the build-time OQ suite, the cell runs a continuous operational walk against 19 quantum algorithms + 7 combination stacks. v38 seeded 26 sovereign_scenarios (domain='quantum_algorithm' × 19 and domain='quantum_combination' × 7); v39 corrected their warrant queries to the per-algorithm substrate-resident teaching atom. The SentinelReflectionLoop walks them on a 30s cadence, the QuantumC4MetricsAggregator refreshes quantum_c4_metrics every 30s, and the ContinuousImprovementLoop records every autonomous targeting decision in improvement_loop_audit every 60s.

The substrate-resident result is that operational status for every quantum algorithm is queryable at any tauBlock without rerunning a build-time test. The same current_health / calorie_rate_24h / drift_indicator shape the runtime sentinel emits is the shape the runtime aggregator exposes. See Quantum-C4-Autonomous-Loop for the schemas and inspection queries.