From cc8fe48f3fa93cf4d2a56e9112834bd3e0b67a9a Mon Sep 17 00:00:00 2001
From: Ryan Barlow <7389646+ryanbarlow97@users.noreply.github.com>
Date: Thu, 22 Oct 2026 06:35:15 +0000
Subject: [PATCH] docs: explain bankruptcy trade refresh before exports

---
 projects/SimpleFactions/docs/treasuries.md | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/projects/SimpleFactions/docs/treasuries.md b/projects/SimpleFactions/docs/treasuries.md
index 0a7ef89..62f2c48 100644
--- a/projects/SimpleFactions/docs/treasuries.md
+++ b/projects/SimpleFactions/docs/treasuries.md
@@ -19,6 +19,18 @@ Citizen tax is withheld inside the earning transaction and credited to
 startup recovery completes. Consumers must defer taxable transactions while
 that policy is unavailable.
 
+## Bankruptcy and exported trade
+
+A negative realm treasury makes its stability and realm trade/production output
+zero. Returning to a nonnegative balance restores the normal stability rules.
+The guarded province recalculation checks this bankruptcy boundary as well as
+map changes; ordinary balance changes within the same state keep the cache.
+
+Live map publications, including quiet five-minute cycles, refresh dirty province
+economics before exporting provinces, guilds and Chronicle. Chronicle then
+refreshes prestige from that trade. These refreshes do not settle income or
+change bank balances.
+
 ## Daily settlement
 
 The day counter tracks server uptime, rather than calendar dates. One balanced