botwir3 Mechanic
Ledger
An append-only local log that records every proposed action, gate decision, and execution result — the bot's complete audit trail.
The ledger records everything. Every cycle: what the agent proposed, whether the gate approved or rejected it, the reason code, the execution result (if approved), the spec hash at the time, and the timestamp. No entry is modified or deleted after it is written. The file is append-only.
The ledger exists locally on the machine running the bot. botwir3 never sees it, accesses it, or stores it. The user owns the ledger, can read it, export it, and analyze it at any time.
Run botwir3 verify to validate the ledger: every entry is checked for spec hash consistency, action validity, magnitude compliance, and mathematical accuracy. If every entry passes every check, the output is "discipline proven." The ledger does not prove the strategy was profitable. It proves the bot followed its configured rules.