flatland3 0.2.0

Flatland3 terminal play client and account CLI
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54

//! Built-in capabilities reference for `flatland3 capabilities`.

pub fn print() {
    println!(
        r#"Flatland3 CLI — capabilities (Tier 1.3)

BINARIES
  flatland3                 Play client + account CLI (this binary)
  flatland-server           Game TCP server (:7373)
  flatland-control-plane    HTTP API (:7380) — accounts, tokens
  flatland-bot              Headless bot harness
  flatland-dev              Embedded server + TUI (monorepo dev only)

PLAY (default — no subcommand)
  flatland3                         Connect to game server, Ratatui UI
  flatland3 --name traveler         Set display name
  flatland3 --server HOST:7373      Remote game server address

  Controls: WASD move, Space stop, Q quit

AUTH
  flatland3 auth register --email E --password P --name DISPLAY
      Create account; logs in automatically (use --no-login to skip)

  flatland3 auth login --email E --password P
      Log in via control plane; saves ~/.config/flatland/session.json

  flatland3 auth token create --name LABEL --scope play,read
      Create API token (shown once). Scopes: play, read, write

  flatland3 auth token list            List token prefixes (not secrets)
  flatland3 auth token revoke UUID     Revoke a token

ENVIRONMENT
  FLATLAND_API_URL          Control plane base (default http://127.0.0.1:7380)
  FLATLAND_API_TOKEN        flat_live_… for agents (export after token create)
  RUST_LOG                  Log level (warn, info, debug)

LOCAL STACK
  cp .env.example .env && make db-up
  cargo run -p flatland-control-plane-bin
  cargo run -p flatland-server
  cargo run -p flatland3

SOLO DEV (embedded server, monorepo):
  cargo run -p flatland-dev -- --bots 8

DOCS
  README.md                 Quickstart
  plans/05-cli-and-developer-guide.md   Full CLI + HTTP reference
  plans/04-implementation-roadmap.md  Implementation checklist
"#
    );
}