Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.ilyama.golain.io/llms.txt

Use this file to discover all available pages before exploring further.

Edge Sync in platform-tui is the primary operator UI for SQLite replication governance when you prefer a terminal over raw HTTP.

​
Access

platform-tui login
platform-tui context set --org=my-org --project=my-project
platform-tui    # no subcommand → TUI
Navigate: Project menu → Edge Sync 
Edge Sync
├── Lineages
│   ├── List (paginated)
│   └── Detail → staged/written data
└── Schema Reviews
    ├── List (filter by status)
    └── Detail → claim / approve / reject
Global TUI keys: ↑/↓ navigate, Enter select, Esc back, / filter, r refresh, q quit.

​
Lineages list

Shows per (device, source_table):
  • Lineage ID
  • Status: active or paused
  • Device reference
  • Source table name
Select a row for lineage detail.

​
Lineage detail

Displays:
  • Ingestion status and pause reason hints
  • Materialization section — failure count, last error (circuit breaker)
  • Schema version history summary
  • Column bindings (when approved)
  • Replay intent status
  • Registry / coalesced mirror info (when applicable)

​
Keybindings

KeyAction
dOpen staged row data for this lineage
wOpen written (materialized mirror) data
xReset materialization — only when materialization error present
DDelete lineage (confirmation prompt)
rRefresh detail
x reset clears materialization circuit breaker — not volume backpressure pause. See backpressure.

​
Staged / written data view

Shared viewport for inspecting row payloads.
KeyAction
sSwitch to staged rows
wSwitch to written rows
n / pNext / previous page (mirror-rows API pagination)
Scroll↑/↓ when viewport focused
Staged reads GET .../lineages/{id}/staged-rows. Written reads GET .../lineages/{id}/mirror-rows. If mirror not provisioned (404), TUI falls back to QueryScript against telemetry_data_point_value filtered by device — see querying data.

​
Schema reviews list

Shows reviews with status:
  • queued — needs claim
  • in_review — operator working
  • approved / rejected / abandoned — terminal
Select for review detail.

​
Schema review detail

KeyWhenAction
cstatus=queuedClaim review
astatus=in_reviewApprove (dev shortcut — single column)
xstatus=in_reviewReject
danyStaged data for linked lineage
wanyWritten data for linked lineage
ranyRefresh
For production approvals with multiple columns, use the HTTP API with full column_actions. TUI a is a convenience for single-value demo tables.

​
Typical operator session

  1. r on Edge Sync menu — refresh lineages after device deploy.
  2. Open Schema Reviews — claim newest queued.
  3. d — confirm staged JSON looks correct.
  4. Approve via API (or a for trivial tables).
  5. Return to Lineages → w — confirm mirror rows.
  6. events watch in separate terminal for materialization_failed events.

​
Not available in TUI yet

Use HTTP API instead:
  • Registry schema reviews (/edge/registry-reviews/*)
  • Coalesced mirror list and consolidation
  • Project edge policy PATCH (schema_coalescing_mode)

​
CLI alternatives

List lineages as JSON for scripts: 
# Requires API exposure or future CLI subcommand — today use curl:
curl -s -H "Authorization: Bearer $(platform-tui whoami 2>/dev/null)" ...
Edge Sync is TUI-first; governance mutations map 1:1 to API reference routes.