Skip to content

GaiaFTCL CLI Reference

The full gaiaftcl operator command surface, generated from the master usage block in cells/xcode/Sources/GaiaFTCLCLI/GaiaFTCLCLIEntry.swift. This is the exact surface gaiaftcl --help prints.

Build: swift build --product GaiaFTCLCLI · run .build/debug/GaiaFTCLCLI <command>.

Top-level command groups: franklin, qc020, qc, substrate, wiki, shor, pq, subscription, mesh, cell, wallet

Command surface

gaiaftcl — operator surface for the Gaia-FTCL substrate

Franklin observation + commission:
  gaiaftcl franklin status
  gaiaftcl franklin observations list [--n <count>]
  gaiaftcl franklin orchestration status
  gaiaftcl franklin operations list [--status <status>]
  gaiaftcl franklin operation show <operation_id>
  gaiaftcl franklin operation authorize <operation_id>     (sovereign-vocabulary manual override)
  gaiaftcl franklin operation reject <operation_id> [--reason <text>]
  gaiaftcl franklin operation claim <operation_id>
  gaiaftcl franklin operation complete <operation_id>

Authority + lifecycle:
  gaiaftcl franklin authority show
  gaiaftcl franklin pause
  gaiaftcl franklin resume

Substrate-mathematical foundation (QC-026):
  gaiaftcl franklin show-phase-classification [--algorithm <id>]
  gaiaftcl franklin show-observer-state
  gaiaftcl franklin show-randomness-provenance
  gaiaftcl franklin show-continuum-bridge [--algorithm <id>]

QC-020 substrate session replay:
  gaiaftcl qc020 replay --from-anchor <id> --to-anchor <id>

Sovereign commission state machine:
  proposed → franklin_authorized → substrate_in_development →
  landed → franklin_authority_active (or rolled_back).
  franklin_rejected is a terminal state for refused-set
  commissions. All transitions normally fire autonomously through
  Franklin's heartbeat per
  ~/.gaiaftcl/franklin_sovereign_authority_bounds.toml.

QC algorithm evaluation:
  gaiaftcl qc evaluate-all

Substrate health:
  gaiaftcl substrate healing history
  gaiaftcl substrate health observations

Wiki federation signing:
  gaiaftcl wiki sign --all [--root <dir>] [--output <path>]
  gaiaftcl wiki sign --section <name> [--root <dir>] [--output <path>]

Shor break chain (RSA + ECDLP + Lean seal):
  gaiaftcl shor break-classical
  Exit 0 = all legs pass; 1=RSA 2=ECDLP 3=Lean 4=lean_gate missing 5=V188 refused

PQ hard-fork doctrine (runs RSA+ECDLP math legs, then doctrine):
  gaiaftcl pq prove-fork-required
  Exit 0 = math legs pass + doctrine printed; 1=RSA 2=ECDLP

PQ wallet migration (after break-classical + V188):
  gaiaftcl wallet pq migrate --secp256k1-wallet-label <label> [--pq-scheme ml-dsa-87]

Shor PQ safety rationale (after V189 migration row):
  gaiaftcl shor prove-pq-safe --migration-id <id>

Cell lifecycle (mesh-distributed substrate; no App Store):
  gaiaftcl cell sprout            — initialize cell substrate identity
  gaiaftcl cell moor              — bind sprouted cell to federation mesh
  gaiaftcl cell identity          — print this cell's identity

QFOT subscription (mesh-only token; 1 QFOT = 1 Euro by Rick declaration):
  gaiaftcl subscription record-payment-sent \
      --cell-id <id> --payment-reference <ref> \
      --payment-amount-eur <canonical> --qfot-credit-amount <canonical>
  gaiaftcl subscription confirm-email-sent --payment-id <id>
  gaiaftcl mesh dispatch-qfot --payment-id <id> [--rationale <text>]

Environment:
  GAIAFTCL_REPO_ROOT — repo root for proof/scripts/lean_gate.sh

Sovereign commission state machine: proposed → franklin_authorized → substrate_in_development → landed → franklin_authority_active (or franklin_rejected / rolled-back). Transitions normally fire autonomously through Franklin's heartbeat; the operation authorize/reject/claim/complete verbs are the same-vocabulary manual override surface. Every transition appends one row to qc020_franklin_commission_history.

Federation-cosigned

This page's source is sealed in the GaiaFTCL federation manifest — page SHA-256 6f132f8559cb5bfa…, manifest witness a090592e0609adc8…, signed 2026-06-02T18:58:22Z by cell gaiaftcl-mac-cell. Verify with gaiaftcl wiki sign --all and compare wiki-all-signatures.json.