pdate

devplacepy/templates/docs/code-farm.html

@@ -195,13 +195,26 @@ multiplies with the Optimizer perk. Refactoring is the long-term progression and
 largest factor in the leaderboard. The state reports `prestige`, `prestige_multiplier`, and
 `prestige_available`.
 
+Refactoring is not free: it costs a **coin fee** that grows with both your prestige count and your
+current coin balance (a wealth tax), so each refactor takes longer to afford than the last. The
+live state reports the exact `refactor_cost` and whether you can pay it (`refactor_affordable`).
+After the fee, **10%** of your remaining coins carry over into the new run - more with the Golden
+Parachute Legacy upgrade (up to 35%), previewed as `refactor_carryover_preview`.
+
 Each refactor also awards **stars**, a separate prestige currency (more at higher levels and higher
 prestige). Stars are never reset and are spent on permanent **Legacy upgrades**.
 
+## Community treasury and weekly grant
+
+Every refactor fee flows into a shared **community treasury**. Once per week, an active farm that
+is still building up - at least five harvests this week, fewer than 10,000 coins, and at most
+prestige 5 - can claim a grant of up to 2,500 coins from it with `POST /game/grant`. The state
+reports `grant_available`, `grant_amount`, `grant_reason`, and the current `treasury_balance`.
+
 ## Legacy upgrades
 
 Stars buy Legacy upgrades, permanent boosts that persist through every future refactor. There are
-five:
+six:
 
 | Legacy upgrade | Effect | Max level |
 |----------------|--------|:---------:|
@@ -210,6 +223,7 @@ five:
 | 🏎️ Bare-Metal | +5% base build speed per level | 8 |
 | 🗂️ Monorepo | +1 starting plot after each refactor per level | 4 |
 | 🛡️ Branch Protection | +30s steal grace and -5% steal loss per level | 5 |
+| 🪂 Golden Parachute | +5% refactor coin carry-over per level | 5 |
 
 The live state reports your `stars` balance and each legacy upgrade's current level and the exact
 star cost of its next level.
@@ -273,7 +287,8 @@ your **API key** in an `X-API-KEY` header (or `Authorization: Bearer`). Your key
 | `POST` | `/game/perk` | Upgrade `perk` (`yield`, `growth`, `discount`, `xp`). |
 | `POST` | `/game/daily` | Claim the daily bonus. |
 | `POST` | `/game/quests/claim` | Claim a completed quest by `quest` kind, optional `scope` (`daily` or `weekly`). |
-| `POST` | `/game/prestige` | Refactor at level 10 or above. |
+| `POST` | `/game/prestige` | Refactor at level 10 or above; costs the current `refactor_cost` in coins. |
+| `POST` | `/game/grant` | Claim the weekly community grant from the treasury. |
 | `POST` | `/game/legacy` | Buy a legacy upgrade (`key`) with stars. |
 | `POST` | `/game/mastery` | Buy a Mastery upgrade (`key`) with Mastery points. |
 | `POST` | `/game/infrastructure/buy` | Buy an Infrastructure building (`key`) with coins. |