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: mempool-graft-candidates, verdict-listener, fold-cas-selftest, mesh-contract-dispatch, contract-verify-selftest, collapse-selftest, mesh-observer-verify, mesh-miner-dispatch, born-pair-geometry, collapse-run, entanglement-invariant, mining-invariant, invariant-verify, language-invariant, sprout, bonded-pair-csv, invariance-walk, prove-c4-law, prove-invariant, substrate-size, substrate-grow, feed-mesh, patoshi-direct-inject, patoshi-projection, mining-direct-inject, mesh-zoom-serve, mesh-zoom-dispatch, ladder-proof, franklin-play, crucible-seeds, crucible-status, game0-closure, invariant-fuzz, patoshi-node-sweep, state-transition-gate, franklin, public-games, graph-compile, play-local, enumerate-patoshi, anchors, mesh-execute, mine-strobe, wiring-health, keychain, extract-mainnet-blocks, p2pk-known, stewardship, reversible-oracle, prove, ask, qc020, qc, substrate, wiki, patoshi, subscription, mesh, admin, 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>]

PQ wallet migration:
  gaiaftcl wallet pq migrate --secp256k1-wallet-label <label> [--pq-scheme ml-dsa-87]

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 ce2fe0b2a4000cf9…, manifest witness 3d999b305397d96c…, signed 2026-07-17T15:45:53Z by cell gaiaftcl-mac-cell. Verify with gaiaftcl wiki sign --all and compare wiki-all-signatures.json.