AGENTS.md — cyb

the doctrine of the home is ~/cyber/AGENTS.md; it applies here first. Claude Code receives both files at session start through ~/.config/cyber/agents-md.nu; other agents read them in order.

Архитектура

Bevy — корневой runtime. Один бинарник для всех платформ.

/                    Rust workspace (Cargo.toml, Makefile)
├── shell/           Bevy desktop runtime — package/bin `cyb`, all worlds
├── apps/            Leptos WASM web apps — loaded via WebView in Portal world
├── reference/       Спецификация, roadmap
├── graph/           Knowledge graph pages
├── docs/            Документация

Внешние зависимости:

• ~/cyber/nu/ — форк nushell (nu-protocol, nu-engine, sugarloaf и др.)
• ~/cyber/evy/forks/naga/ — форк naga (shader compiler)

One Binary Rule

WebView is only for web content (Portal world). All other rendering — terminal, graph, 3D, UI — is pure Rust via Bevy + wgpu. No JS bundles, no external runtimes embedded in the binary.

Android = desktop. The Android build is the same app, same Bevy, same worlds, same terminal, same nushell. The only Android-specific addition is nu_plugin_android which exposes hardware APIs (GPS, camera, sensors, etc.) that desktop doesn't have. There is no separate Android UI or Android terminal — it's one codebase.

Worlds

Сборка

# Bevy shell (desktop):
make build                         # debug build
make run                           # release run
make dmg                           # macOS release + DMG

# Leptos apps:
make apps                          # trunk build --release

# Android:
make android                       # full: rust + assets + apk

# Dev:
make dev                           # cargo run -p cyb

Проверка после изменений

• Fleet (обязателен перед коммитом): make fleet — мульти-окружение: N изолированных тел (свои HOME) + детерминированный mockchain (harness/mockchain.py), ассерты на boot/identity/graph/networks/ beacon/prover/vault/orphans. Хук pre-commit гоняет его сам; SKIP_FLEET=1 для docs-only коммитов. FLEET_SKIP_BUILD=1 если бинарь свежий.
• Shell: cargo check -p cyb
• Apps: cd apps && trunk build --release
• Release: make dmg
• Android: make android

Релизы

Релизный поезд (правила: ~/cyber/cyberia/dev.md § release train):

• кандидат режется каждую пятницу 12:00 UTC агентом только из origin/master; рабочее дерево никогда не вход. candidate-YYYYMMDD.N, черновой pre-release: dmg (arm64, x64), apk, SHA256SUMS, sources.json, candidate.json, release-validation.json.
• гейты кандидата: cargo check --tests --locked, cargo test, make fleet GREEN, make dmg, make android-apk. Красный гейт публикуется красным с уликами, руками артефакт не чинится.
• бамп версии — один PR chore: cyb <version> (Cargo.toml, CHANGELOG, пины сиблингов в cyber и soft3), ничего больше.
• make ship — рука владельца: бамп, коммит через fleet-ворота, тег, dmg чистого дерева, notes из git log, push master+tags. Агент ship не запускает, тег не пушит, кандидат в релиз не продвигает.
• квитанции в audit/release-<date>/; одна строка в work log cyber/launch.md на кандидат.

Git

• Push только по запросу (исключение: make ship пушит по определению)
• Атомарные коммиты

Планы и решения

.claude/plans/ — утверждённые планы. reference/roadmap.md — общий roadmap.