feat: organic territory claims + Ages prestige ladder

Dami committed Aug 16f53f681

- territory: multi-source bucket-Dijkstra claims with terrain costs (plains 1,
  forest 2, swamp 3, mountain 5; water/river/volcano unclaimable) budgeted by
  tier — natural borders, chokepoints, no overlap; census/capacity derive from
  claims; TribeView.claims + SettlementView.territoryTiles; map renders true
  claim edges instead of squares
- ages: advance verb burns an escalating hoard to climb
  wandering->settled->crafting->high; each age +10% extraction/refinement,
  +3 warband power per soldier, flat score term and +25%-per-age score
  multiplier (prestige accelerator); age_advanced events; bots attempt
  advancement periodically; violet 'age' series in the score breakdown

commit: f53f681ac4f9987df9040a4aa9c2fd754f910c9b
parent: 99e3ffb6e805a76bc32e040c5b6f64af8a071908
author: Dami <dami.etoile@gmail.com>

25 files changed, +480 -74wrap lines

M	docs/llms.txt	24	+++-
M	packages/engine/README.md	19	+++
M	packages/engine/src/constants.ts	29	++++
M	packages/engine/src/world.ts	221	+++++++++++++++++++++++++-----
M	packages/engine/test/engine.test.ts	82	+++++++++++-
M	packages/engine/tsconfig.tsbuildinfo	2	+-
M	packages/protocol/src/game.ts	32	++++-
M	packages/protocol/tsconfig.tsbuildinfo	2	+-
M	packages/script-host/bots/bulwark.js	4	+
M	packages/script-host/bots/homesteader.js	4	+
M	packages/script-host/bots/magnate.js	4	+
M	packages/script-host/bots/warlord.js	4	+
M	packages/script-host/src/bots.ts	16	++
M	packages/script-host/src/index.ts	2	+
M	packages/script-host/src/prelude.ts	3	+
M	packages/script-host/test/fixtures.ts	4	+-
M	packages/script-host/test/host.test.ts	2	+-
M	packages/script-host/tsconfig.tsbuildinfo	2	+-
M	web/src/dev-mock.ts	6	+-
M	web/src/pages/viewer.ts	3	+
M	web/src/render/map-view.ts	50	++++---
M	web/src/sim-worker.ts	8	+
M	web/src/sim/frames.ts	4	+
M	web/src/viz/palette.ts	3	+-
M	worker/src/mcp/docs.ts	24	+++-

M docs/llms.txt +23 -1

@@ -315,7 +315,7 @@ territory means buying metal or taking someone else's.
315315 316316 `SettlementView`: `{id, x, y, tier, pop, morale (0..1000),317317 stores: {resource: n}, storeCap, buildings: {building: count},318-buildQueue: [{building, progress}], territoryRadius,318+buildQueue: [{building, progress}], territoryTiles,319319 workers: {profession: n}, capacity: {profession: n}, herds, horses}`.320320 321321 `WarbandView`: `{id, home, size, kind, weapons, armor, veterancy (0..1000),@@ -358,6 +358,7 @@ v2. One-shot verbs act once and are done. All are subject to the 64-order
358358 | `api.research(tech)` | `research` | Sets the research target (one at a time) until unlocked. |359359 | `api.decree(key, value)` | `decree` | **Policy.** Civil per-mille knobs: `'rations'` (food issued per capita), `'slaughter'` (herd culling → meat/hides), `'fodder'` (livestock feeding), `'ale_ration'` (ale issue → morale). Echoed in `state.decrees`. |360360 | `api.rite(rite, target)` | `rite` | One-shot **faith spend** (the exception to persistence): `'blessing' \| 'harvest' \| 'warding' \| 'war'`, `target` = settlement id or `null`. |361+| `api.advance()` | one-shot | Prestige: burn the age hoard (escalating resource chunk drawn across your settlements; costs in the engine README) to enter the next age. Each age: +10% extraction & refinement rates, +3 warband power per soldier, a score term AND a x1.25-per-age score multiplier. Dropped silently if unaffordable. |361362 | `api.say(text)` | `say` | Broadcast a short message to EVERY tribe's feed (and spectators). Sanitized; 120 chars max, 1 per tick. |362363 | `api.rng()` | — (not an order) | Next value from your tribe's seeded PRNG stream: a float in `[0, 1)`. The **only** permitted randomness. |363364 | `api.log(msg)` | — (not an order) | Debug line in your own sim log (local viewer/devtools only). Never visible to other tribes; still costs gas. |@@ -607,6 +608,27 @@ function tick(state, memory, api) {
607608 }608609 ```609610 611+### Territory (organic claims)612+613+Settlements claim ground by cheapest-cost expansion, budgeted by tier: plains614+and steppe cost 1, forest/hills/arctic 2, swamp 3, mountains 5 — water,615+rivers and volcanoes cannot be claimed AT ALL. Rivers and coasts are hard616+borders; mountain lines are near-borders. Your claims cap your extraction617+(farmers need claimed plains, miners claimed hills). Contested frontiers618+resolve by expansion cost, earlier-founded settlements winning ties. Watch619+`state.claims` and `settlement.territoryTiles`.620+621+### Ages (prestige)622+623+The age ladder: wandering -> settled -> crafting -> high. `api.advance()`624+burns an escalating hoard (grain/timber/hides, then bread/planks/metal/625+cloth/coin, then bread/metal/armor/ale/coin/clothes — exact numbers in the626+engine README). Each age permanently grants +10% extraction and refinement627+rates, +3 warband power per soldier, a flat score term, and multiplies your628+TOTAL score by +25% per age. An advanced civilization out-farms, out-mines,629+out-fights and out-scores the wandering ones — hoard deliberately and630+prestige when the chunk is ready.631+610632 ## System examples: frozen primitives to fork611633 612634 Five frozen example scripts ship with the game — four runnable reference bots

M packages/engine/README.md +19 -0

@@ -381,3 +381,22 @@ apportionment, economy/tools/starvation/population, muster/battle/capture,
381381 threats, trade/peddler, fog/spawn fairness, invalid-order no-divergence,382382 metrics sanity, JSON round-trips, and a perf gate: 8 tribes × 10,000 ticks383383 with active policies in well under 10 s (measured ~0.6 s; asserted < 20 s).384+385+## Organic territory (claims)386+387+Multi-source bucket Dijkstra from every settlement, recomputed each slow388+tick. Claim cost per tile: plains/steppe 1, forest/arctic 2, hills/ore/gold389+2, swamp 3, mountain 5, water/river/volcano impassable. Budget by tier390+(`TIER_CLAIM_BUDGET` = 5/8/12/16 accumulated cost). Ties: earlier-founded391+(lower id) settlement wins. Census (and thus extraction capacity) derives392+from claimed tiles; water access stays adjacency-based for docks.393+394+## Ages (prestige ladder)395+396+`advance` burns, drawn across your settlements (ascending id):397+wandering -> settled: 800 grain, 400 timber, 100 hides;398+settled -> crafting: 400 bread, 300 planks, 150 metal, 100 cloth, 100 coin;399+crafting -> high: 800 bread, 300 metal, 60 armor, 300 ale, 400 coin, 150 clothes.400+Effects per age: +100‰ on every extraction/refinement rate, +3 warband power401+per soldier, +60 flat score, and the total score is multiplied by402+(1000 + age x 250)‰.

M packages/engine/src/constants.ts +29 -0

@@ -147,6 +147,35 @@ export const WATER_CLASS = new Set<number>([TC.WATER, TC.RIVER]);
147147 export const TIER_POP = [0, 100, 400, 1000] as const;148148 /** Territory radius (Chebyshev) per tier. */149149 export const TIER_RADIUS = [4, 6, 9, 12] as const;150+/**151+ * Organic territory: settlements claim ground by multi-source cheapest-cost152+ * expansion. Per-tile claim cost by terrain code (index = TC): plains 1,153+ * forest 2, hills 2, mountain 5, water/river IMPASSABLE (0 = blocked), swamp154+ * 3, steppe 1, arctic 2, volcano blocked, ore 2, gold 2. Water and rivers155+ * hard-stop claims — natural borders and chokepoints are real.156+ */157+export const CLAIM_COST: ReadonlyArray<number> = [1, 2, 2, 5, 0, 0, 3, 1, 2, 0, 2, 2];158+/** Max accumulated claim cost by settlement tier (expansion budget). */159+export const TIER_CLAIM_BUDGET = [5, 8, 12, 16] as const;160+161+// ---------------------------------------------------------------------------162+// Ages (prestige ladder)163+// ---------------------------------------------------------------------------164+/** Hoard burned (drawn across your settlements, ascending id) to reach age165+ * index i+1. Escalating and chain-deep: advancing PROVES the civilization. */166+export const AGE_COSTS: ReadonlyArray<Partial<Record<import('@tribes/protocol').Resource, number>>> = [167+  { grain: 800, timber: 400, hides: 100 }, // -> settled168+  { bread: 400, planks: 300, metal: 150, cloth: 100, coin: 100 }, // -> crafting169+  { bread: 800, metal: 300, armor: 60, ale: 300, coin: 400, clothes: 150 }, // -> high170+];171+/** Extraction & refinement rate bonus per age, ‰ added to every rate. */172+export const AGE_RATE_BONUS = [0, 100, 200, 300] as const;173+/** Warband power bonus per soldier per age. */174+export const AGE_POWER_BONUS = 3;175+/** Flat score term per age. */176+export const SCORE_PER_AGE = 60;177+/** Score multiplier per age, ‰ added (age 3 = x1.75 total score). */178+export const AGE_SCORE_MULT = 250;150179 151180 export const BASE_STORE_CAP = 2000;152181 /** Granary and warehouse each add to ONE shared per-resource cap (documented

M packages/engine/src/world.ts +181 -40

@@ -187,6 +187,7 @@ interface Settlement {
187187   allocOverride: Int32Array; // P_N, -1 = no override188188   // Derived caches (recomputed deterministically; not hashed):189189   census: Census;190+  territoryTiles: number;190191   workers: Int32Array; // P_N, last apportionment191192   capacity: Int32Array; // P_N192193   herderEff1000: number;@@ -275,6 +276,8 @@ interface Tribe {
275276   id: number;276277   alive: boolean;277278   diedAt: number;279+  /** Prestige age index into AGES (hashed state). */280+  age: number;278281   alloc: Int32Array; // P_N permille279282   craft: Int32Array; // 6 (CRAFT_KEYS order)280283   decrees: Int32Array; // 4 (DECREE_KEYS order)@@ -293,6 +296,8 @@ interface Tribe {
293296   glimpsed: Uint8Array;294297   glimpsedDirty: boolean;295298   distantCache: string | null;299+  claimsCache: string | null;300+  claimsCacheVersion: number;296301   // Counters (buildingsCompleted feeds score and is hashed; the rest are297302   // metrics narration — cumulative unless noted).298303   buildingsCompleted: number;@@ -323,6 +328,11 @@ class World implements EngineWorld {
323328   private readonly rng: Rng;324329   private readonly size: number;325330   private readonly terrain: Uint8Array;331+  /** Claim map: settlement id per cell, -1 unclaimed. Derived (not hashed),332+   * recomputed every slow tick by deterministic bucket Dijkstra. */333+  private claims: Int16Array;334+  /** Bumped on every claim recompute; invalidates per-tribe view caches. */335+  private claimsVersion = 0;326336   private readonly tribes: Tribe[] = [];327337   private readonly settlements: Settlement[] = []; // ascending id328338   private readonly warbands: Warband[] = [];@@ -371,6 +381,7 @@ class World implements EngineWorld {
371381 372382     const map = generateMap(this.size, config.tribeCount, this.rng);373383     this.terrain = map.terrain;384+    this.claims = new Int16Array(this.size * this.size).fill(-1);374385 375386     for (let t = 0; t < config.tribeCount; t++) {376387       const alloc = new Int32Array(P_N);@@ -381,6 +392,7 @@ class World implements EngineWorld {
381392         id: t,382393         alive: true,383394         diedAt: -1,395+        age: 0,384396         alloc,385397         craft,386398         decrees,@@ -397,6 +409,8 @@ class World implements EngineWorld {
397409         glimpsed: new Uint8Array(this.size * this.size),398410         glimpsedDirty: true,399411         distantCache: null,412+        claimsCache: null,413+        claimsCacheVersion: -1,400414         terrainCache: null,401415         buildingsCompleted: 0,402416         battlesWon: 0,@@ -527,42 +541,105 @@ class World implements EngineWorld {
527541     return 0;528542   }529543 530-  private computeCensus(s: Settlement): void {531-    const r = s.radius;532-    let plains = 0;533-    let forest = 0;534-    let hills = 0;535-    let water = 0;536-    let ore = 0;537-    let gold = 0;538-    const x0 = Math.max(0, s.x - r);539-    const x1 = Math.min(this.size - 1, s.x + r);540-    const y0 = Math.max(0, s.y - r);541-    const y1 = Math.min(this.size - 1, s.y + r);542-    for (let y = y0; y <= y1; y++) {543-      for (let x = x0; x <= x1; x++) {544-        const t = this.terrainAt(x, y);545-        if (t === TC.PLAINS) plains++;546-        else if (t === TC.FOREST) forest++;547-        else if (C.HILLS_CLASS.has(t)) {548-          hills++;549-          if (t === TC.ORE) ore++;550-          else if (t === TC.GOLD) gold++;551-        } else if (C.WATER_CLASS.has(t)) water++;552-      }553-    }554-    let cold = false;555-    for (let dy = -1; dy <= 1 && !cold; dy++) {556-      for (let dx = -1; dx <= 1; dx++) {557-        const x = s.x + dx;558-        const y = s.y + dy;559-        if (this.inMap(x, y) && C.COLD_CLASS.has(this.terrainAt(x, y))) {560-          cold = true;561-          break;544+  /**545+   * Organic territory: multi-source bucket-Dijkstra from every settlement.546+   * Cost per tile from CLAIM_COST (0 = impassable to claims: water, river,547+   * volcano); budget by tier from TIER_CLAIM_BUDGET. Deterministic: seeds in548+   * ascending settlement id (= founding order), FIFO within each cost bucket,549+   * first claim wins. Derived state — recomputed every slow tick, not hashed.550+   */551+  private recomputeClaims(): void {552+    const n = this.size * this.size;553+    this.claims.fill(-1);554+    const cost = new Int16Array(n).fill(32767);555+    const maxBudget = C.TIER_CLAIM_BUDGET[C.TIER_CLAIM_BUDGET.length - 1]!;556+    const buckets: number[][] = [];557+    for (let i = 0; i <= maxBudget; i++) buckets.push([]);558+    const budgetOf = new Map<number, number>();559+    for (const st of this.settlements) {560+      const i = st.y * this.size + st.x;561+      this.claims[i] = st.id;562+      cost[i] = 0;563+      budgetOf.set(st.id, C.TIER_CLAIM_BUDGET[st.tier]!);564+      buckets[0]!.push(i);565+    }566+    for (let c = 0; c <= maxBudget; c++) {567+      const bucket = buckets[c]!;568+      for (let bi = 0; bi < bucket.length; bi++) {569+        const i = bucket[bi]!;570+        if (cost[i]! !== c) continue; // stale entry571+        const owner = this.claims[i]!;572+        const budget = budgetOf.get(owner) ?? 0;573+        const x = i % this.size;574+        const y = (i / this.size) | 0;575+        // 4-neighbors in fixed order (N, W, E, S)576+        for (let d = 0; d < 4; d++) {577+          const nx = x + (d === 1 ? -1 : d === 2 ? 1 : 0);578+          const ny = y + (d === 0 ? -1 : d === 3 ? 1 : 0);579+          if (nx < 0 || ny < 0 || nx >= this.size || ny >= this.size) continue;580+          const ni = ny * this.size + nx;581+          const stepCost = C.CLAIM_COST[this.terrain[ni]!]!;582+          if (stepCost === 0) continue; // impassable to claims583+          const nc = c + stepCost;584+          if (nc > budget) continue;585+          if (nc < cost[ni]!) {586+            cost[ni] = nc;587+            this.claims[ni] = owner;588+            buckets[nc]!.push(ni);589+          }562590         }563591       }564592     }565-    s.census = { plains, forest, hills, water, ore, gold, cold };593+    // Census + territory size per settlement, derived from the claim map.594+    const byId = new Map<number, Settlement>();595+    for (const st of this.settlements) {596+      st.census = { plains: 0, forest: 0, hills: 0, water: 0, ore: 0, gold: 0, cold: st.census.cold };597+      st.territoryTiles = 0;598+      byId.set(st.id, st);599+    }600+    for (let i = 0; i < n; i++) {601+      const owner = this.claims[i]!;602+      if (owner === -1) continue;603+      const st = byId.get(owner);604+      if (st === undefined) continue;605+      st.territoryTiles++;606+      const t = this.terrain[i]!;607+      if (t === TC.PLAINS || t === TC.STEPPE) st.census.plains++;608+      else if (t === TC.FOREST) st.census.forest++;609+      else if (C.HILLS_CLASS.has(t)) {610+        st.census.hills++;611+        if (t === TC.ORE) st.census.ore++;612+        else if (t === TC.GOLD) st.census.gold++;613+      }614+    }615+    // Water access is adjacency-based (docks fish the shoreline, not claims).616+    for (const st of this.settlements) {617+      let water = 0;618+      const r = st.radius;619+      const x0 = Math.max(0, st.x - r);620+      const x1 = Math.min(this.size - 1, st.x + r);621+      const y0 = Math.max(0, st.y - r);622+      const y1 = Math.min(this.size - 1, st.y + r);623+      for (let y = y0; y <= y1; y++) {624+        for (let x = x0; x <= x1; x++) {625+          if (C.WATER_CLASS.has(this.terrainAt(x, y))) water++;626+        }627+      }628+      st.census.water = water;629+      let cold = false;630+      for (let dy = -1; dy <= 1 && !cold; dy++) {631+        for (let dx = -1; dx <= 1; dx++) {632+          const x = st.x + dx;633+          const y = st.y + dy;634+          if (this.inMap(x, y) && C.COLD_CLASS.has(this.terrainAt(x, y))) {635+            cold = true;636+            break;637+          }638+        }639+      }640+      st.census.cold = cold;641+    }642+    this.claimsVersion++;566643   }567644 568645   private computeCapacity(s: Settlement): void {@@ -625,6 +702,7 @@ class World implements EngineWorld {
625702       flags: 0,626703       allocOverride: new Int32Array(P_N).fill(-1),627704       census: { plains: 0, forest: 0, hills: 0, water: 0, ore: 0, gold: 0, cold: false },705+      territoryTiles: 0,628706       workers: new Int32Array(P_N),629707       capacity: new Int32Array(P_N),630708       herderEff1000: 0,@@ -632,7 +710,7 @@ class World implements EngineWorld {
632710     s.buildings[BI.hall] = 1;633711     this.settlements.push(s);634712     this.updateTier(s);635-    this.computeCensus(s);713+    this.recomputeClaims();636714     this.reveal(tribe, x, y, s.radius + C.SETTLEMENT_VISION_BONUS);637715     return s;638716   }@@ -651,7 +729,7 @@ class World implements EngineWorld {
651729       const r = C.TIER_RADIUS[s.tier]!;652730       if (r !== s.radius) {653731         s.radius = r;654-        this.computeCensus(s);732+        this.recomputeClaims();655733         this.reveal(s.tribe, s.x, s.y, r + C.SETTLEMENT_VISION_BONUS);656734       }657735     }@@ -736,7 +814,7 @@ class World implements EngineWorld {
736814     }737815 738816     // 2. Territory & census.739-    if (slow) for (const s of this.settlements) this.computeCensus(s);817+    if (slow) this.recomputeClaims();740818 741819     // 3. Labor.742820     this.phaseLabor();@@ -984,6 +1062,9 @@ class World implements EngineWorld {
9841062         tribe.researching = t;9851063         return;9861064       }1065+      case 'advance':1066+        this.orderAdvance(tribe);1067+        return;9871068       case 'rite':9881069         this.orderRite(tribe, order);9891070         return;@@ -1091,6 +1172,34 @@ class World implements EngineWorld {
10911172     });10921173   }10931174 1175+  /** Prestige: burn the age hoard (drawn across settlements ascending id). */1176+  private orderAdvance(tribe: Tribe): void {1177+    if (tribe.age >= C.AGE_COSTS.length) return; // already at max age1178+    const cost = C.AGE_COSTS[tribe.age]!;1179+    const own = this.settlements.filter((s) => s.tribe === tribe.id);1180+    // Affordability check over the aggregate.1181+    for (const [resName, amount] of Object.entries(cost)) {1182+      const ri = C.RES_IDX[resName as Resource];1183+      let have = 0;1184+      for (const s of own) have += s.stores[ri]!;1185+      if (have < (amount as number)) return; // unaffordable — dropped1186+    }1187+    // Pay, drawing ascending settlement id.1188+    for (const [resName, amount] of Object.entries(cost)) {1189+      const ri = C.RES_IDX[resName as Resource];1190+      let left = amount as number;1191+      for (const s of own) {1192+        if (left <= 0) break;1193+        const take = Math.min(left, s.stores[ri]!);1194+        s.stores[ri]! -= take;1195+        left -= take;1196+      }1197+      this.cons(tribe.id, ri, amount as number);1198+    }1199+    tribe.age++;1200+    this.events.push({ t: 'age_advanced', tick: this.tick, tribe: tribe.id, age: tribe.age });1201+  }1202+10941203   private orderMuster(tribe: Tribe, order: Extract<Order, { kind: 'muster' }>): void {10951204     const kind = WB_KINDS.indexOf(order.unitKind as WarbandKind);10961205     if (kind === -1) return;@@ -1336,7 +1445,9 @@ class World implements EngineWorld {
13361445    * documented 1e6-denominator variant of the accumulator rule).13371446    */13381447   private flow(s: Settlement, slot: number, effW1000: number, rate: number): number {1339-    const total = effW1000 * rate + s.acc[slot]!;1448+    // Age bonus: advanced civilizations extract and refine faster.1449+    const aged = Math.trunc((rate * (1000 + C.AGE_RATE_BONUS[this.tribes[s.tribe]!.age]!)) / 1000);1450+    const total = effW1000 * aged + s.acc[slot]!;13401451     const out = Math.trunc(total / 1_000_000);13411452     s.acc[slot] = total - out * 1_000_000;13421453     return out;@@ -1943,6 +2054,7 @@ class World implements EngineWorld {
19432054     if (w.weapons >= w.size) per += C.POWER_ARMED;19442055     per += Math.trunc((w.armor * 10) / w.size); // armorRatio‰ / 10019452056     per += Math.trunc(w.vet / 100);2057+    per += this.tribes[w.tribe]!.age * C.AGE_POWER_BONUS;19462058     if (defTerrain >= 0) per += C.TERRAIN_DEF_MOD[defTerrain] ?? 0;19472059     if (wallLevel > 0) per += wallLevel * C.WALL_DEF_PER_SOLDIER;19482060     let p = w.size * Math.max(1, per);@@ -3002,6 +3114,27 @@ class World implements EngineWorld {
30023114       tribe.glimpsedDirty = false;30033115     }30043116 3117+    let claimsStr = tribe.claimsCache;3118+    if (3119+      claimsStr === null ||3120+      tribe.claimsCacheVersion !== this.claimsVersion ||3121+      tribe.exploredDirty3122+    ) {3123+      // Owner tribe char over explored ground; '.' elsewhere.3124+      const chars = new Array<string>(s * s);3125+      const ex = tribe.explored;3126+      const settlementTribe = new Map<number, number>();3127+      for (const st of this.settlements) settlementTribe.set(st.id, st.tribe);3128+      for (let i = 0; i < s * s; i++) {3129+        const owner = ex[i] === 1 ? this.claims[i]! : -1;3130+        const ownerTribe = owner === -1 ? -1 : settlementTribe.get(owner) ?? -1;3131+        chars[i] = ownerTribe === -1 ? '.' : String(ownerTribe);3132+      }3133+      claimsStr = chars.join('');3134+      tribe.claimsCache = claimsStr;3135+      tribe.claimsCacheVersion = this.claimsVersion;3136+    }3137+30053138     const settlements: SettlementView[] = [];30063139     for (const t of this.settlements) {30073140       if (t.tribe !== tribeId) continue;@@ -3028,7 +3161,7 @@ class World implements EngineWorld {
30283161         storeCap: this.storeCapOf(t),30293162         buildings,30303163         buildQueue: t.queue.map((q) => ({ building: BUILDINGS[q.b]!, progress: q.progress })),3031-        territoryRadius: t.radius,3164+        territoryTiles: t.territoryTiles,30323165         workers,30333166         capacity,30343167         herds: t.herds,@@ -3199,6 +3332,8 @@ class World implements EngineWorld {
31993332       mapSize: s,32003333       terrain: terrainStr,32013334       distant: distantStr,3335+      claims: claimsStr,3336+      age: tribe.age,32023337       settlements,32033338       warbands,32043339       caravans,@@ -3253,12 +3388,16 @@ class World implements EngineWorld {
32533388       military: Math.trunc(this.warbandPowerOf(tribeId) / C.SCORE_POWER_DIV),32543389       coin: Math.trunc(coin / C.SCORE_COIN_DIV),32553390       buildings: tribe.buildingsCompleted * C.SCORE_PER_BUILDING,3391+      age: tribe.age * C.SCORE_PER_AGE,32563392     };32573393   }32583394 32593395   private scoreOf(tribeId: number): number {32603396     const b = this.scoreBreakdownOf(tribeId);3261-    return b.pop + b.settlements + b.techs + b.military + b.coin + b.buildings;3397+    const base = b.pop + b.settlements + b.techs + b.military + b.coin + b.buildings + b.age;3398+    // Prestige accelerator: each age multiplies the whole score.3399+    const age = this.tribes[tribeId]!.age;3400+    return Math.trunc((base * (1000 + age * C.AGE_SCORE_MULT)) / 1000);32623401   }32633402 32643403   private computeMetrics(): MetricsFrame {@@ -3292,7 +3431,7 @@ class World implements EngineWorld {
32923431         }32933432       }32943433       let territory = 0;3295-      for (let i = 0; i < mask.length; i++) territory += mask[i]!;3434+      for (const st of this.settlements) if (st.tribe === tribe.id) territory += st.territoryTiles;32963435       let nWarbands = 0;32973436       for (const w of this.warbands) {32983437         if (w.tribe === tribe.id) {@@ -3348,6 +3487,7 @@ class World implements EngineWorld {
33483487         settlementsByTier: tiers,33493488         buildingsCompleted: tribe.buildingsCompleted,33503489         techsUnlocked: techs,3490+        age: tribe.age,33513491         knowledge: tribe.knowledge,33523492         faith: tribe.faith,33533493         coin,@@ -3433,6 +3573,7 @@ class World implements EngineWorld {
34333573       h.int(t.techMask);34343574       h.int(t.researching);34353575       h.int(t.knowledge);3576+      h.int(t.age);34363577       h.int(t.faith);34373578       h.int(t.knowAcc);34383579       h.int(t.faithAcc);

M packages/engine/test/engine.test.ts +79 -3

@@ -124,9 +124,9 @@ const GOLDEN_CONFIG = { seed: '123456789', tribeCount: 4, mapSize: 128, maxTicks
124124 // simulation behavior must regenerate these (see scripts in repo history:125125 // run this test with GOLDEN printed on failure).126126 const GOLDEN_HASHES: Record<number, string> = {127-  0: '54efd9ccbab4315f',128-  100: 'f7e0b98219842e71',129-  1000: '4aaa612303ce6b90',127+  0: '0e3ae27cf3378a4f',128+  100: '0d6a052aceb277e9',129+  1000: '1d7a492119b01976',130130 };131131 132132 describe('golden replay', () => {@@ -858,3 +858,79 @@ describe('distant view (glimpse band)', () => {
858858     expect(v.distant).not.toContain('G');859859   });860860 });861+862+describe('organic territory (claims)', () => {863+  it('claims are exclusive, terrain-shaped, and water-blocked', () => {864+    const world = createWorld({ seed: '77', tribeCount: 2, mapSize: 32, maxTicks: 100 });865+    for (let i = 0; i < 11; i++) world.step(new Map());866+    const v = world.viewFor(0);867+    expect(v.claims.length).toBe(32 * 32);868+    let mine = 0;869+    for (let i = 0; i < v.claims.length; i++) {870+      const c = v.claims[i]!;871+      if (c === '.') continue;872+      expect('01').toContain(c); // owner chars only873+      if (c === '0') mine++;874+      // water and rivers can never be claimed875+      expect('wr').not.toContain(v.terrain[i] ?? '?');876+    }877+    expect(mine).toBeGreaterThan(30); // a real organic territory exists878+    expect(v.settlements[0]!.territoryTiles).toBeGreaterThan(30);879+  });880+881+  it('claim maps are deterministic across identical runs', () => {882+    const run = () => {883+      const world = createWorld({ seed: '78', tribeCount: 3, mapSize: 32, maxTicks: 60 });884+      for (let i = 0; i < 31; i++) world.step(new Map());885+      return world.viewFor(1).claims;886+    };887+    expect(run()).toBe(run());888+  });889+});890+891+describe('ages (prestige)', () => {892+  it('advance burns the hoard, raises the age, boosts rates and score', () => {893+    const world = createWorld({ seed: '79', tribeCount: 2, mapSize: 32, maxTicks: 200 });894+    const before = world.viewFor(0);895+    expect(before.age).toBe(0);896+    // Starting stores: grain 2000, timber 400, hides 50 — not enough hides.897+    world.step(new Map([[0, [{ kind: 'advance' } as Order]]]));898+    expect(world.viewFor(0).age).toBe(0); // unaffordable -> dropped899+900+    // Top up hides via a fake windfall: use a herd slaughter decree over time901+    // is slow — instead verify the cost gate itself by checking affordable902+    // path on a fresh world with a boosted decree-free route: trade is heavy;903+    // simplest deterministic route: slaughter herds hard for hides.904+    const world2 = createWorld({ seed: '79', tribeCount: 2, mapSize: 32, maxTicks: 4000 });905+    const orders: Order[] = [906+      { kind: 'decree', key: 'slaughter', value: 60 },907+      { kind: 'decree', key: 'fodder', value: 1 },908+      { kind: 'allocate', profession: 'farmer', permille: 500 },909+      { kind: 'allocate', profession: 'herder', permille: 120 },910+      { kind: 'allocate', profession: 'woodcutter', permille: 250 },911+    ];912+    world2.step(new Map([[0, orders]]));913+    let advancedAt = -1;914+    for (let t = 0; t < 3900; t++) {915+      world2.step(new Map([[0, t % 20 === 0 ? [{ kind: 'advance' } as Order] : []]]));916+      if (world2.viewFor(0).age === 1) {917+        advancedAt = world2.tick;918+        break;919+      }920+    }921+    expect(advancedAt).toBeGreaterThan(0);922+    const v = world2.viewFor(0);923+    expect(v.age).toBe(1);924+    // score breakdown carries the prestige term (metrics recompute on the925+    // next slow-tick boundary — step past it before asserting)926+    for (let i = 0; i < 10; i++) world2.step(new Map());927+    const m = world2.latestMetrics();928+    if (m) {929+      const t0 = m.tribes.find((t) => t.tribeId === 0)!;930+      expect(t0.age).toBe(1);931+    }932+    // age_advanced event was emitted (delivered to the tribe itself)933+    // (event already consumed from the view ring in earlier steps — the age934+    // field itself is the durable assertion here)935+  });936+});

M packages/engine/tsconfig.tsbuildinfo +1 -1

@@ -1 +1 @@

M packages/protocol/src/game.ts +31 -1

@@ -164,6 +164,17 @@ export type CraftTarget =
164164 165165 export type ThreatKind = 'goblin_camp' | 'skeleton_barrow' | 'ogre_den' | 'demon_gate';166166 167+/**168+ * Ages — the prestige ladder. A tribe BURNS a hoard of resources (via the169+ * `advance` verb) to enter the next age. Each age grants a permanent170+ * extraction/refinement rate bonus, a warband power bonus, a score term, and171+ * a score MULTIPLIER — advanced civilizations out-farm, out-mine and out-war172+ * the wandering ones, and their score accumulates faster. Costs escalate per173+ * age; see the engine README for exact hoards and bonuses.174+ */175+export const AGES = ['wandering', 'settled', 'crafting', 'high'] as const;176+export type AgeName = (typeof AGES)[number];177+167178 // ---------------------------------------------------------------------------168179 // Actions — what a script emits each tick (all persistent policy unless noted)169180 // ---------------------------------------------------------------------------@@ -193,6 +204,9 @@ export type Order =
193204   | { kind: 'decree'; key: DecreeKey; value: number }194205   /** One-shot faith spend (the exception to persistence). */195206   | { kind: 'rite'; rite: RiteKind; target: number | null }207+  /** One-shot prestige: burn the age hoard (drawn across your settlements)208+   * to advance to the next age. Dropped if unaffordable or already at max. */209+  | { kind: 'advance' }196210   /** Broadcast a short sanitized message to every tribe's world feed. */197211   | { kind: 'say'; text: string };198212 @@ -213,7 +227,8 @@ export interface SettlementView {
213227   storeCap: number;214228   buildings: Partial<Record<Building, number>>;215229   buildQueue: Array<{ building: Building; progress: number }>;216-  territoryRadius: number;230+  /** Tiles this settlement currently claims (organic, terrain-shaped). */231+  territoryTiles: number;217232   /** Current workers apportioned per profession (derived from allocation). */218233   workers: Partial<Record<Profession, number>>;219234   /** Capacity per profession (building slots × biome census). */@@ -326,8 +341,18 @@ export interface TribeView {
326341   craft: Record<CraftTarget, number>;327342   decrees: Record<DecreeKey, number>;328343   allocations: Record<Profession, number>;344+  /** Current age index into AGES (0 = wandering). */345+  age: number;329346   stances: Record<number, Posture>;330347   aliveTribes: number[];348+  /**349+   * Territory claims over EXPLORED ground: row-major mapSize² chars, '.' for350+   * unclaimed-or-unknown, '0'-'7' for the owning tribe. Claims grow351+   * organically from settlements via terrain-cost expansion — water and352+   * rivers block claims entirely, mountains are expensive — so natural353+   * borders and chokepoints matter.354+   */355+  claims: string;331356   /** Feed events from the previous tick (fog-filtered; see SimEvent). */332357   events: SimEvent[];333358 }@@ -376,6 +401,7 @@ export type SimEvent =
376401   | { t: 'threat_spawned'; tick: number; kind: ThreatKind; x: number; y: number }377402   | { t: 'threat_cleared'; tick: number; tribe: number; kind: ThreatKind; x: number; y: number }378403   | { t: 'tech_unlocked'; tick: number; tribe: number; tech: Tech }404+  | { t: 'age_advanced'; tick: number; tribe: number; age: number }379405   | { t: 'sighted'; tick: number; tribe: number; enemy: number; x: number; y: number }380406   | { t: 'eliminated'; tick: number; tribe: number }381407   | { t: 'forfeited'; tick: number; tribe: number };@@ -418,6 +444,8 @@ export interface TribeMetrics {
418444   buildingsCompleted: number;419445   // tech / faith / trade lens420446   techsUnlocked: number;447+  /** Age index (prestige tier). */448+  age: number;421449   knowledge: number;422450   faith: number;423451   coin: number;@@ -432,6 +460,8 @@ export interface TribeMetrics {
432460     military: number;433461     coin: number;434462     buildings: number;463+    /** Prestige term (before the age multiplier is applied to the total). */464+    age: number;435465   };436466 }437467 

M packages/protocol/tsconfig.tsbuildinfo +1 -1

@@ -1 +1 @@

M packages/script-host/bots/bulwark.js +4 -0

@@ -10,6 +10,10 @@
1010 // Contract: define a global `function tick(state, memory, api)`.1111 1212 function tick(state, memory, api) {13+  // Prestige: try to advance the age when the hoard allows (the engine14+  // drops the order if we cannot afford it — a cheap periodic attempt).15+  if (state.tick % 50 === 0 && state.age < 3) api.advance();16+1317   var home = state.settlements[0];1418   if (!home) return;1519 

M packages/script-host/bots/homesteader.js +4 -0

@@ -14,6 +14,10 @@
1414 //   api    - policy verbs + api.rng() (seeded stream) + api.log(msg)1515 1616 function tick(state, memory, api) {17+  // Prestige: try to advance the age when the hoard allows (the engine18+  // drops the order if we cannot afford it — a cheap periodic attempt).19+  if (state.tick % 50 === 0 && state.age < 3) api.advance();20+1721   var home = state.settlements[0];1822   if (!home) return; // eliminated-in-all-but-name; nothing to govern1923 

M packages/script-host/bots/magnate.js +4 -0

@@ -11,6 +11,10 @@
1111 // Contract: define a global `function tick(state, memory, api)`.1212 1313 function tick(state, memory, api) {14+  // Prestige: try to advance the age when the hoard allows (the engine15+  // drops the order if we cannot afford it — a cheap periodic attempt).16+  if (state.tick % 50 === 0 && state.age < 3) api.advance();17+1418   var home = state.settlements[0];1519   if (!home) return;1620 

M packages/script-host/bots/warlord.js +4 -0

@@ -11,6 +11,10 @@
1111 // Contract: define a global `function tick(state, memory, api)`.1212 1313 function tick(state, memory, api) {14+  // Prestige: try to advance the age when the hoard allows (the engine15+  // drops the order if we cannot afford it — a cheap periodic attempt).16+  if (state.tick % 50 === 0 && state.age < 3) api.advance();17+1418   var home = state.settlements[0];1519   if (!home) return;1620 

M packages/script-host/src/bots.ts +16 -0

@@ -17,6 +17,10 @@ export const homesteaderSource = `// Homesteader — balanced-economy reference
1717 //   api    - policy verbs + api.rng() (seeded stream) + api.log(msg)1818 1919 function tick(state, memory, api) {20+  // Prestige: try to advance the age when the hoard allows (the engine21+  // drops the order if we cannot afford it — a cheap periodic attempt).22+  if (state.tick % 50 === 0 && state.age < 3) api.advance();23+2024   var home = state.settlements[0];2125   if (!home) return; // eliminated-in-all-but-name; nothing to govern2226 @@ -135,6 +139,10 @@ export const bulwarkSource = `// Bulwark — defensive reference bot for Tribes
135139 // Contract: define a global \`function tick(state, memory, api)\`.136140 137141 function tick(state, memory, api) {142+  // Prestige: try to advance the age when the hoard allows (the engine143+  // drops the order if we cannot afford it — a cheap periodic attempt).144+  if (state.tick % 50 === 0 && state.age < 3) api.advance();145+138146   var home = state.settlements[0];139147   if (!home) return;140148 @@ -281,6 +289,10 @@ export const warlordSource = `// Warlord — aggressive reference bot for Tribes
281289 // Contract: define a global \`function tick(state, memory, api)\`.282290 283291 function tick(state, memory, api) {292+  // Prestige: try to advance the age when the hoard allows (the engine293+  // drops the order if we cannot afford it — a cheap periodic attempt).294+  if (state.tick % 50 === 0 && state.age < 3) api.advance();295+284296   var home = state.settlements[0];285297   if (!home) return;286298 @@ -464,6 +476,10 @@ export const magnateSource = `// Magnate — trade-focused reference bot for Tri
464476 // Contract: define a global \`function tick(state, memory, api)\`.465477 466478 function tick(state, memory, api) {479+  // Prestige: try to advance the age when the hoard allows (the engine480+  // drops the order if we cannot afford it — a cheap periodic attempt).481+  if (state.tick % 50 === 0 && state.age < 3) api.advance();482+467483   var home = state.settlements[0];468484   if (!home) return;469485 

M packages/script-host/src/index.ts +2 -0

@@ -309,6 +309,8 @@ export function validateOrder(raw: unknown): Order | null {
309309       if (target !== null && target !== undefined && !isId(target)) return null;310310       return { kind: "rite", rite: rite as RiteKind, target: target ?? null };311311     }312+    case "advance":313+      return { kind: "advance" };312314     case "say": {313315       if (typeof o["text"] !== "string") return null;314316       const text = sanitizeSay(o["text"]);

M packages/script-host/src/prelude.ts +3 -0

@@ -194,6 +194,9 @@ export function buildPrelude(seed32: number, memoryMaxBytes: number): string {
194194     "        target: target === null || target === undefined ? null : +target,\n" +195195     "      });\n" +196196     "    },\n" +197+    "    advance: function () {\n" +198+    '      pushOrder({ kind: \"advance\" });\n' +199+    "    },\n" +197200     "    say: function (text) {\n" +198201     '      pushOrder({ kind: "say", text: "" + text });\n' +199202     "    },\n" +

M packages/script-host/test/fixtures.ts +3 -1

@@ -49,6 +49,8 @@ export function makeView(partial: Partial<TribeView> = {}): TribeView {
4949     mapSize: size,5050     terrain: ".".repeat(size * size),5151     distant: "?".repeat(size * size),52+    claims: ".".repeat(size * size),53+    age: 0,5254     settlements: [5355       {5456         id: 1,@@ -61,7 +63,7 @@ export function makeView(partial: Partial<TribeView> = {}): TribeView {
6163         storeCap: 2000,6264         buildings: { hall: 1, house: 6, farm: 2 },6365         buildQueue: [],64-        territoryRadius: 4,66+        territoryTiles: 40,6567         workers: { farmer: 240, woodcutter: 90, miner: 50 },6668         capacity: { farmer: 400, woodcutter: 150, miner: 100 },6769         herds: 20,

M packages/script-host/test/host.test.ts +1 -1

@@ -344,7 +344,7 @@ describe("determinism", () => {
344344     const v2Kinds = new Set([345345       "allocate", "craft", "build", "demolish", "found", "route", "muster",346346       "command", "trade_offer", "trade_cancel", "stance", "research",347-      "decree", "rite", "say",347+      "decree", "rite", "advance", "say",348348     ]);349349     for (const source of BOT_SOURCES) {350350       await withVm(source, {}, (vm) => {

M packages/script-host/tsconfig.tsbuildinfo +1 -1

@@ -1 +1 @@

M web/src/dev-mock.ts +5 -1

@@ -302,6 +302,8 @@ class MockWorld implements EngineWorld {
302302       mapSize: n,303303       terrain: chars.join(''),304304       distant: '?'.repeat(n * n),305+      claims: '.'.repeat(n * n),306+      age: Math.min(3, Math.floor(this.tick / 3000)),305307       settlements: t.settlements.map((s, i) => ({306308         id: s.id,307309         x: s.x,@@ -314,7 +316,7 @@ class MockWorld implements EngineWorld {
314316         storeCap: 5000,315317         buildings: { hall: 1, house: Math.max(1, Math.floor(s.pop / 40)), granary: 1, walls: s.walls },316318         buildQueue: [],317-        territoryRadius: 4 + this.tierOf(s.pop) * 2,319+        territoryTiles: 30 + this.tierOf(s.pop) * 60,318320         workers: Object.fromEntries(319321           PROFESSIONS.map((prof) => [prof, Math.floor((s.pop * t.allocations[prof]) / 1000)]),320322         ),@@ -763,6 +765,7 @@ class MockWorld implements EngineWorld {
763765       military: Math.floor(this.power(t) / 4) + t.battlesWon * 25 + t.campsCleared * 40,764766       coin: Math.floor(t.stores.coin / 10),765767       buildings: t.buildingsCompleted * 10,768+      age: Math.min(3, Math.floor(this.tick / 3000)) * 60,766769     };767770     const score = Object.values(breakdown).reduce((a, v) => a + v, 0);768771     return { score, breakdown };@@ -818,6 +821,7 @@ class MockWorld implements EngineWorld {
818821           ),819822           buildingsCompleted: t.buildingsCompleted,820823           techsUnlocked: t.techs.length,824+          age: Math.min(3, Math.floor(this.tick / 3000)),821825           knowledge: t.knowledge,822826           faith: t.faith,823827           coin: t.stores.coin,

M web/src/pages/viewer.ts +3 -0

@@ -573,6 +573,9 @@ function makeEventFeed(names: string[], opts: FeedOptions = {}): EventFeed {
573573         return h('div', { class: 'feed-line' }, tick, `${noun(ev.kind)} appeared${at(ev.x, ev.y)}`);574574       case 'threat_cleared':575575         return h('div', { class: 'feed-line' }, tick, nameSpan(ev.tribe), ` cleared a ${noun(ev.kind)}${at(ev.x, ev.y)}`);576+      case 'age_advanced':577+        return h('div', { class: 'feed-line feed-say' }, tick, nameSpan(ev.tribe),578+          ` enters a new age (${['wandering', 'settled', 'crafting', 'high'][ev.age] ?? ev.age})`);576579       case 'tech_unlocked':577580         return h('div', { class: 'feed-line' }, tick, nameSpan(ev.tribe), ` unlocked ${noun(ev.tech)}`);578581       case 'sighted':

M web/src/render/map-view.ts +29 -21

@@ -216,28 +216,36 @@ export function createMapView(
216216       drawBadge(x, y, fmtCount(w.size), color);217217     }218218 219-    // territory borders — dashed tribe-tinted squares around each settlement's220-    // claim (radius by tier, mirroring the engine's TIER_RADIUS 4/6/9/12), so221-    // holding ground reads differently from just running around a lot.222-    const TIER_TERRITORY = [4, 6, 9, 12];223-    ctx.save();224-    ctx.setLineDash([3, 3]);225-    ctx.lineWidth = 1;226-    for (const s of frame.settlements) {227-      const r = TIER_TERRITORY[s.tier] ?? 4;228-      const bx = Math.max(0, s.x - r) * TILE;229-      const by = Math.max(0, s.y - r) * TILE;230-      const bw = (Math.min(mapSize - 1, s.x + r) - Math.max(0, s.x - r) + 1) * TILE;231-      const bh = (Math.min(mapSize - 1, s.y + r) - Math.max(0, s.y - r) + 1) * TILE;232-      ctx.strokeStyle = tribeColor(s.tribe);233-      ctx.globalAlpha = 0.55;234-      ctx.strokeRect(bx + 0.5, by + 0.5, bw - 1, bh - 1);235-      // faint interior wash so overlapping (contested) claims visibly stack236-      ctx.globalAlpha = 0.05;237-      ctx.fillStyle = tribeColor(s.tribe);238-      ctx.fillRect(bx, by, bw, bh);219+    // territory borders — organic claim edges from the engine's terrain-cost220+    // expansion. A cell edge is drawn where ownership changes; interiors get221+    // a faint wash so contested frontiers and enclaves read at a glance.222+    if (frame.claims.length === mapSize * mapSize) {223+      ctx.save();224+      ctx.lineWidth = 1;225+      for (let ty = 0; ty < mapSize; ty++) {226+        for (let tx = 0; tx < mapSize; tx++) {227+          const c = frame.claims[ty * mapSize + tx]!;228+          if (c === '.') continue;229+          const color = tribeColor(Number(c));230+          const x = tx * TILE;231+          const y = ty * TILE;232+          ctx.globalAlpha = 0.05;233+          ctx.fillStyle = color;234+          ctx.fillRect(x, y, TILE, TILE);235+          ctx.globalAlpha = 0.6;236+          ctx.strokeStyle = color;237+          const at = (nx: number, ny: number): string =>238+            nx < 0 || ny < 0 || nx >= mapSize || ny >= mapSize ? '.' : frame.claims[ny * mapSize + nx]!;239+          ctx.beginPath();240+          if (at(tx, ty - 1) !== c) { ctx.moveTo(x, y + 0.5); ctx.lineTo(x + TILE, y + 0.5); }241+          if (at(tx, ty + 1) !== c) { ctx.moveTo(x, y + TILE - 0.5); ctx.lineTo(x + TILE, y + TILE - 0.5); }242+          if (at(tx - 1, ty) !== c) { ctx.moveTo(x + 0.5, y); ctx.lineTo(x + 0.5, y + TILE); }243+          if (at(tx + 1, ty) !== c) { ctx.moveTo(x + TILE - 0.5, y); ctx.lineTo(x + TILE - 0.5, y + TILE); }244+          ctx.stroke();245+        }246+      }247+      ctx.restore();239248     }240-    ctx.restore();241249 242250     // settlements — tribe-tinted ring + tier glyph + banner243251     for (const s of frame.settlements) {

M web/src/sim-worker.ts +8 -0

@@ -152,6 +152,7 @@ function isWorldEvent(ev: SimEvent): boolean {
152152     ev.t === 'settlement_captured' ||153153     ev.t === 'settlement_founded' ||154154     ev.t === 'tech_unlocked' ||155+    ev.t === 'age_advanced' ||155156     ev.t === 'threat_spawned' ||156157     (ev.t === 'battle' && ev.defender != null)157158   );@@ -257,6 +258,7 @@ function buildFrame(): MapFrame {
257258   const tribes: FrameTribe[] = [];258259   let terrain = '';259260   let distant = '';261+  let claims = '';260262 261263   const views = lastViews;262264 @@ -308,15 +310,18 @@ function buildFrame(): MapFrame {
308310       const view = views.find((v) => v.tribeId === pov);309311       terrain = view ? view.terrain : '?'.repeat(mapSize * mapSize);310312       distant = view ? view.distant : '?'.repeat(mapSize * mapSize);313+      claims = view ? view.claims : '.'.repeat(mapSize * mapSize);311314       if (view) takeView(view, true);312315     } else {313316       // Omniscient = union of every tribe's own view (terrain merged char-wise).314317       const chars = new Array<string>(mapSize * mapSize).fill('?');315318       const dchars = new Array<string>(mapSize * mapSize).fill('?');319+      const cchars = new Array<string>(mapSize * mapSize).fill('.');316320       for (const v of views) {317321         for (let i = 0; i < v.terrain.length; i++) {318322           if (chars[i] === '?' && v.terrain[i] !== '?') chars[i] = v.terrain[i]!;319323           if (dchars[i] === '?' && v.distant[i] !== '?') dchars[i] = v.distant[i]!;324+          if (cchars[i] === '.' && v.claims[i] !== '.') cchars[i] = v.claims[i]!;320325         }321326         // Own assets from every view; enemy sightings too, in case a tribe's322327         // own view has gone missing (viewFor failure) — dedupe handles overlap.@@ -326,6 +331,7 @@ function buildFrame(): MapFrame {
326331       // Distant knowledge is only shown where no tribe has hard knowledge.327332       for (let i = 0; i < dchars.length; i++) if (chars[i] !== '?') dchars[i] = '?';328333       distant = dchars.join('');334+      claims = cchars.join('');329335     }330336     settlements.sort((a, b) => a.id - b.id);331337     warbands.sort((a, b) => a.id - b.id);@@ -353,6 +359,7 @@ function buildFrame(): MapFrame {
353359       warbands: v ? v.warbands.length : 0,354360       coin,355361       score: scoreOf(t),362+      age: v ? v.age : 0,356363       overBudget: st.overBudget,357364       error: st.error,358365     });@@ -374,6 +381,7 @@ function buildFrame(): MapFrame {
374381     hasMap: watching,375382     terrain,376383     distant,384+    claims,377385     settlements,378386     warbands,379387     caravans,

M web/src/sim/frames.ts +4 -0

@@ -60,6 +60,8 @@ export interface FrameTribe {
6060   coin: number;6161   /** Latest headline score (from the most recent metrics frame; 0 early). */6262   score: number;63+  /** Prestige age index (0 wandering .. 3 high). */64+  age: number;6365   /** Script went over its gas budget this tick. */6466   overBudget: boolean;6567   /** Last runtime error thrown by the script, if any. */@@ -91,6 +93,8 @@ export interface MapFrame {
9193   terrain: string;9294   /** Distant category glimpses (DistantChar per cell; rendered ~35% alpha). */9395   distant: string;96+  /** Territory claims ('.' none, '0'-'7' tribe) — organic, terrain-shaped. */97+  claims: string;9498   settlements: FrameSettlement[];9599   warbands: FrameWarband[];96100   caravans: FrameCaravan[];

M web/src/viz/palette.ts +2 -1

@@ -26,7 +26,7 @@ export const TRIBE_COLORS = [
2626 export const tribeColor = (id: number): string => TRIBE_COLORS[id % TRIBE_COLORS.length]!;2727 2828 /** Score-breakdown components, fixed order (matches scoreBreakdown keys). */29-export const BREAKDOWN_KEYS = ['pop', 'settlements', 'techs', 'military', 'coin', 'buildings'] as const;29+export const BREAKDOWN_KEYS = ['pop', 'settlements', 'techs', 'military', 'coin', 'buildings', 'age'] as const;3030 export const BREAKDOWN_COLORS: Record<(typeof BREAKDOWN_KEYS)[number], string> = {3131   pop: '#3987e5',3232   settlements: '#d95926',@@ -34,6 +34,7 @@ export const BREAKDOWN_COLORS: Record<(typeof BREAKDOWN_KEYS)[number], string> =
3434   military: '#c98500',3535   coin: '#d55181',3636   buildings: '#008300',37+  age: '#9a7bd0', // prestige violet3738 };3839 3940 /**

M worker/src/mcp/docs.ts +23 -1

@@ -325,7 +325,7 @@ territory means buying metal or taking someone else's.
325325 326326 \`SettlementView\`: \`{id, x, y, tier, pop, morale (0..1000),327327 stores: {resource: n}, storeCap, buildings: {building: count},328-buildQueue: [{building, progress}], territoryRadius,328+buildQueue: [{building, progress}], territoryTiles,329329 workers: {profession: n}, capacity: {profession: n}, herds, horses}\`.330330 331331 \`WarbandView\`: \`{id, home, size, kind, weapons, armor, veterancy (0..1000),@@ -368,6 +368,7 @@ v2. One-shot verbs act once and are done. All are subject to the 64-order
368368 | \`api.research(tech)\` | \`research\` | Sets the research target (one at a time) until unlocked. |369369 | \`api.decree(key, value)\` | \`decree\` | **Policy.** Civil per-mille knobs: \`'rations'\` (food issued per capita), \`'slaughter'\` (herd culling → meat/hides), \`'fodder'\` (livestock feeding), \`'ale_ration'\` (ale issue → morale). Echoed in \`state.decrees\`. |370370 | \`api.rite(rite, target)\` | \`rite\` | One-shot **faith spend** (the exception to persistence): \`'blessing' \\| 'harvest' \\| 'warding' \\| 'war'\`, \`target\` = settlement id or \`null\`. |371+| \`api.advance()\` | one-shot | Prestige: burn the age hoard (escalating resource chunk drawn across your settlements; costs in the engine README) to enter the next age. Each age: +10% extraction & refinement rates, +3 warband power per soldier, a score term AND a x1.25-per-age score multiplier. Dropped silently if unaffordable. |371372 | \`api.say(text)\` | \`say\` | Broadcast a short message to EVERY tribe's feed (and spectators). Sanitized; 120 chars max, 1 per tick. |372373 | \`api.rng()\` | — (not an order) | Next value from your tribe's seeded PRNG stream: a float in \`[0, 1)\`. The **only** permitted randomness. |373374 | \`api.log(msg)\` | — (not an order) | Debug line in your own sim log (local viewer/devtools only). Never visible to other tribes; still costs gas. |@@ -617,6 +618,27 @@ function tick(state, memory, api) {
617618 }618619 \`\`\`619620 621+### Territory (organic claims)622+623+Settlements claim ground by cheapest-cost expansion, budgeted by tier: plains624+and steppe cost 1, forest/hills/arctic 2, swamp 3, mountains 5 — water,625+rivers and volcanoes cannot be claimed AT ALL. Rivers and coasts are hard626+borders; mountain lines are near-borders. Your claims cap your extraction627+(farmers need claimed plains, miners claimed hills). Contested frontiers628+resolve by expansion cost, earlier-founded settlements winning ties. Watch629+\`state.claims\` and \`settlement.territoryTiles\`.630+631+### Ages (prestige)632+633+The age ladder: wandering -> settled -> crafting -> high. \`api.advance()\`634+burns an escalating hoard (grain/timber/hides, then bread/planks/metal/635+cloth/coin, then bread/metal/armor/ale/coin/clothes — exact numbers in the636+engine README). Each age permanently grants +10% extraction and refinement637+rates, +3 warband power per soldier, a flat score term, and multiplies your638+TOTAL score by +25% per age. An advanced civilization out-farms, out-mines,639+out-fights and out-scores the wandering ones — hoard deliberately and640+prestige when the chunk is ready.641+620642 ## System examples: frozen primitives to fork621643 622644 Five frozen example scripts ship with the game — four runnable reference bots