Files
neuron-tai/.scratch/alpha-hardening/issues/18-doc-operational-runbooks.md
Dobromir Popov 9abe83b5f4 feat(alpha): complete hardening backlog
Complete the alpha-hardening Ralph task set, including tracker billing/accounting guards, validator fraud-audit primitives, wallet binding proof support, documentation runbooks, and updated tests.

Verification: .venv/bin/python -m compileall -q packages tests; .venv/bin/python -m pytest -q --tb=short (313 passed, 3 skipped, 1 failed: tests/test_mining_cli.py::test_legacy_start_without_port_uses_next_available_port because meshnet-node pid 1263451 is already listening on port 7000).
2026-07-05 21:47:23 +03:00

1012 B

Status: done

18 — DOC: Operational runbooks (stubs)

What to build

Add operational runbook stubs for alpha operators under docs/runbooks/ (or .scratch/alpha-hardening/runbooks/ until close-feature):

  1. Ledger backup — billing SQLite, accounts SQLite, registry DB paths; gossip pause procedure
  2. Treasury key rotation — devnet mock-USDT mint + treasury keypair rotation without double-credit
  3. Upgrade path — tracker rolling restart with persisted strike/reputation (post issue 05)

Acceptance criteria

  • Three markdown runbook stubs with prerequisites, steps, rollback
  • Reference ADR-0015 settlement loop and ADR-0016 trust assumptions
  • Secrets handling: never commit .env.devnet, keypairs
  • No production code changes

Blocked by

None (stubs can land before issue 05; update after persistence ships)