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

28 lines
1012 B
Markdown

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
## ADR links
- [ADR-0015](../../docs/adr/0015-usdt-custodial-settlement.md)
- [ADR-0016](../../docs/adr/0016-alpha-scope-and-known-limitations.md)
## Blocked by
None (stubs can land before issue 05; update after persistence ships)