feat: tribe-scaled worlds, anti-rush drilling, resilient collapse, territory borders, identity cards

Dami committed Aug 1699e3ffb

- mapSizeForTribes: 2-3 tribes -> 32, 4-5 -> 48, 6-8 -> 64; mapgen floor 32
- anti-rush: starter armory cut to 24 weapons/8 armor; fresh warbands drill
  250 ticks (60% power, raid/besiege refused) — WarbandView.drilling
- collapse resilience: settlement pop floor (40), threat arson capped above
  6 buildings, hall grants kitchen-garden farmer + salvage woodcutter slots;
  wars now end in devastated remnants and recovery, never extinction spirals
- map: dashed tribe-tinted territory borders per settlement (tier radius)
- chronicle rail: identity cards (portrait, name, @description parsed from
  script source, version ref); live vitals/feeds move to world mode
- bots: adaptive muster size, warlord feeds his war machine, @description
  tags; balance matrix now warlord>homesteader, bulwark>warlord, magnate>warlord

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

22 files changed, +285 -72wrap lines

M	docs/llms.txt	24	++++++++---
M	packages/engine/src/constants.ts	25	++++++++++-
M	packages/engine/src/world.ts	37	++++++++++++----
M	packages/engine/test/engine.test.ts	41	++++++++++--------
M	packages/engine/tsconfig.tsbuildinfo	2	+-
M	packages/protocol/src/game.ts	20	+++++++++
M	packages/protocol/tsconfig.tsbuildinfo	2	+-
M	packages/script-host/bots/bulwark.js	1	+
M	packages/script-host/bots/homesteader.js	1	+
M	packages/script-host/bots/magnate.js	1	+
M	packages/script-host/bots/warlord.js	29	+++++++++----
M	packages/script-host/src/bots.ts	32	++++++++++----
M	packages/script-host/test/fixtures.ts	3	+-
M	packages/script-host/tsconfig.tsbuildinfo	2	+-
M	scripts/balance.mjs	4	+-
M	web/src/dev-mock.ts	1	+
M	web/src/main.ts	2	+-
M	web/src/pages/viewer.ts	68	+++++++++++++++++++++++++++++-
M	web/src/render/map-view.ts	23	++++++++++
M	web/src/style.css	10	++++
M	worker/src/mcp/docs.ts	24	++++++++---
M	worker/src/service.ts	5	+-

M docs/llms.txt +18 -6

@@ -105,6 +105,10 @@ Military power is downstream of the whole economy.
105105 106106 ### The contract107107 108+Optional but recommended: a `// @description: one line about your strategy`109+comment near the top of your script — the sim viewer shows it on your110+tribe's identity card.111+108112 Your script must define, at top level:109113 110114 ```js@@ -315,8 +319,11 @@ buildQueue: [{building, progress}], territoryRadius,
315319 workers: {profession: n}, capacity: {profession: n}, herds, horses}`.316320 317321 `WarbandView`: `{id, home, size, kind, weapons, armor, veterancy (0..1000),318-morale, x, y, order: {type, target}, supply}` — `supply` is food carried;319-attrition bites outside your own territory when it hits zero.322+morale, x, y, order: {type, target}, supply, drilling}` — `supply` is food323+carried; attrition bites outside your own territory when it hits zero.324+`drilling` is training ticks remaining: while it is > 0 the band fights at325+60% power and its `raid`/`besiege` orders are REFUSED. Muster early,326+campaign later.320327 321328 `CaravanView`: `{id, tribe, x, y, resource, amount}`.322329 `ThreatView`: `{id, kind, x, y, strength}`.@@ -358,9 +365,14 @@ v2. One-shot verbs act once and are done. All are subject to the 64-order
358365 ### Military: power is downstream of the smithy359366 360367 - **Muster**: soldiers are citizens taken out of the labor pool and armed361-  from stores. No weapons in the settlement → no warband. Weapons come only362-  from your own ore → metal → smithy chain or from trade. Armor (plate_armor363-  tech) cuts casualties; cavalry needs horsemanship and pasture-bred horses.368+  from stores. No weapons in the settlement → no warband. You START with only369+  24 weapons and 8 armor — a home guard, not an invasion force; a real army370+  must be equipped from your own ore → metal → smithy chain or trade. Armor371+  (plate_armor tech) cuts casualties; cavalry needs horsemanship and horses.372+- **Drilling (anti-rush)**: every freshly mustered warband trains for 250373+  ticks before it can campaign — reduced power and no raid/besiege while374+  `drilling > 0` (defending home works normally). Aggression requires375+  build-up; day-one rushes bounce off a modest garrison.364376 - **Warband orders** (`api.command`, standing until replaced):365377   `garrison` (settlement id) — defend a settlement from inside;366378   `patrol` (`{x, y}`) — hold and sweep an area;@@ -460,7 +472,7 @@ signaling, and coordination between agents.
460472 461473 | Limit | Value | Consequence |462474 | --- | --- | --- |463-| Map size | 64 × 64 | — |475+| Map size | scales with roster: 2-3 tribes → 32 × 32, 4-5 → 48 × 48, 6-8 → 64 × 64 | — |464476 | Max ticks per sim | 10,000 | Sim ends at cap; highest score wins. |465477 | Tribes per sim | 2–8 | One script per tribe slot. |466478 | Starting population | 1,200 | One founding settlement per tribe. |

M packages/engine/src/constants.ts +23 -2

@@ -275,6 +275,20 @@ export const MORALE_BLESSING_BONUS = 150;
275275 export const BIRTH_RATE = 8; // ‰ per 10t, x housing x morale x surplus factors276276 export const NATURAL_DEATH_RATE = 2; // ‰ per 10t277277 export const EMIGRATION_MORALE = 300; // below this, people leave278+/** Hardship (starvation/emigration/natural death) never empties a settlement279+ * below this floor — a remnant always hangs on and can recover. Only conquest280+ * (capture) or disbandment removes a settlement outright. Prevents the281+ * runaway starvation -> morale -> emigration extinction spiral. */282+export const SETTLEMENT_POP_FLOOR = 40;283+/** Monster raids pillage stores freely but only burn buildings while the284+ * settlement is still substantial — they never raze a town to its hall.285+ * (Tribal raids/sieges have no such mercy: conquest is the kill mechanism.) */286+export const THREAT_ARSON_MIN_BUILDINGS = 6;287+/** The hall's kitchen gardens: baseline farmer slots that survive any288+ * pillaging, so a razed settlement can always feed a remnant and rebuild. */289+export const HALL_GARDEN_SLOTS = 12;290+/** Hall salvage yard: baseline woodcutter slots so wreckage can be rebuilt. */291+export const HALL_YARD_SLOTS = 6;278292 export const EMIGRATION_RATE = 10; // ‰ per 10t279293 /** Housing factor: 1000 below 80% occupancy, linear to 0 at 100%. */280294 export const HOUSING_SOFT_PERMILLE = 800;@@ -410,6 +424,11 @@ export const MIN_REMAINING_POP = 50;
410424 export const SUPPLY_CAP_PER_SOLDIER = 3;411425 export const SUPPLY_PER_SOLDIER_10T = 1;412426 export const STARTING_WARBAND_MORALE = 800;427+/** Fresh musters/reinforcements drill before campaigning: reduced power and428+ * no raid/besiege until the counter runs out (see WarbandView.drilling). */429+export const MUSTER_DRILL_TICKS = 250;430+/** Power multiplier (per-mille) while a warband is still drilling. */431+export const DRILLING_POWER_PERMILLE = 600;413432 /** Rams: siegecraft + these stores at the mustering settlement set siege=true. */414433 export const RAM_PLANKS = 20;415434 export const RAM_METAL = 5;@@ -585,8 +604,10 @@ export const START_STORES: Partial<Record<Resource, number>> = {
585604   metal: 40,586605   leather: 40,587606   tools: 250,588-  weapons: 100,589-  armor: 20,607+  // Starter armory arms a small home guard only; a raiding force must be608+  // equipped from your own smithy chain (anti-rush).609+  weapons: 24,610+  armor: 8,590611   clothes: 100,591612 };592613 

M packages/engine/src/world.ts +27 -10

@@ -207,6 +207,8 @@ interface Warband {
207207   y: number;208208   supply: number;209209   siege: boolean;210+  /** Training ticks remaining; >0 = reduced power, raid/besiege refused. */211+  drill: number;210212   order: { type: number; targetId: number; tx: number; ty: number };211213   desertAcc: number;212214   // per-tick scratch:@@ -352,7 +354,7 @@ class World implements EngineWorld {
352354     ) {353355       throw new Error(`tribeCount out of range: ${config.tribeCount}`);354356     }355-    if (!Number.isInteger(config.mapSize) || config.mapSize < 48 || config.mapSize > 256) {357+    if (!Number.isInteger(config.mapSize) || config.mapSize < 32 || config.mapSize > 256) {356358       throw new Error(`mapSize out of range: ${config.mapSize}`);357359     }358360     if (!Number.isInteger(config.maxTicks) || config.maxTicks < 1) {@@ -568,11 +570,14 @@ class World implements EngineWorld {
568570     const c = s.census;569571     const cap = s.capacity;570572     cap.fill(0);571-    cap[PI.farmer] = Math.min(b[BI.farm]! * C.FARM_SLOTS, c.plains * C.FARMERS_PER_PLAINS);573+    cap[PI.farmer] = Math.min(574+      b[BI.farm]! * C.FARM_SLOTS + b[BI.hall]! * C.HALL_GARDEN_SLOTS,575+      c.plains * C.FARMERS_PER_PLAINS,576+    );572577     cap[PI.fisher] = Math.min(b[BI.dock]! * C.DOCK_SLOTS, c.water * C.FISHERS_PER_WATER);573578     cap[PI.herder] = b[BI.pasture]! * C.PASTURE_HERDER_SLOTS;574579     cap[PI.woodcutter] = Math.min(575-      b[BI.lumber_camp]! * C.LUMBER_SLOTS,580+      b[BI.lumber_camp]! * C.LUMBER_SLOTS + b[BI.hall]! * C.HALL_YARD_SLOTS,576581       c.forest * C.WOODCUTTERS_PER_FOREST,577582     );578583     cap[PI.miner] = Math.min(b[BI.mine]! * C.MINE_SLOTS, c.hills * C.MINERS_PER_HILL);@@ -1138,6 +1143,7 @@ class World implements EngineWorld {
11381143       y: s.y,11391144       supply: 0,11401145       siege,1146+      drill: C.MUSTER_DRILL_TICKS,11411147       order: { type: WO.garrison, targetId: s.id, tx: s.x, ty: s.y },11421148       desertAcc: 0,11431149       engaged: false,@@ -1186,6 +1192,7 @@ class World implements EngineWorld {
11861192       }11871193       case WO.besiege: {11881194         if (typeof tgt !== 'number') return;1195+        if (w.drill > 0) return; // green troops can't campaign yet11891196         const s = this.findSettlement(tgt);11901197         if (s === undefined || s.tribe === tribe.id) return;11911198         if (tribe.stances[s.tribe] === P_ALLY) return;@@ -1194,6 +1201,7 @@ class World implements EngineWorld {
11941201       }11951202       case WO.raid: {11961203         if (typeof tgt !== 'number') return;1204+        if (w.drill > 0) return; // green troops can't campaign yet11971205         const s = this.findSettlement(tgt);11981206         if (s !== undefined) {11991207           if (s.tribe === tribe.id || tribe.stances[s.tribe] === P_ALLY) return;@@ -1809,9 +1817,10 @@ class World implements EngineWorld {
18091817         s.kindsEaten |= 1 << k;18101818       }18111819       if (need > 0) {1812-        // Starvation.1820+        // Starvation (floored: a remnant always survives — see constants).18131821         const cap = Math.max(1, Math.trunc(s.pop / C.STARVATION_DEATH_CAP_DIV));1814-        const deaths = Math.min(s.pop, Math.min(need, cap));1822+        const roomAboveFloor = Math.max(0, s.pop - C.SETTLEMENT_POP_FLOOR);1823+        const deaths = Math.min(roomAboveFloor, Math.min(need, cap));18151824         s.pop -= deaths;18161825         s.morale = Math.max(0, s.morale - C.STARVATION_MORALE_HIT);18171826         s.flags |= FLAG_STARVED;@@ -1904,9 +1913,9 @@ class World implements EngineWorld {
19041913         s.pop += births;19051914         tribe.birthsI += births;19061915       }1907-      // Natural deaths.1916+      // Natural deaths (floored — see SETTLEMENT_POP_FLOOR).19081917       const dTotal = s.pop * C.NATURAL_DEATH_RATE + s.acc[ACC.DEATH]!;1909-      const deaths = Math.min(s.pop, Math.trunc(dTotal / 1000));1918+      const deaths = Math.min(Math.max(0, s.pop - C.SETTLEMENT_POP_FLOOR), Math.trunc(dTotal / 1000));19101919       s.acc[ACC.DEATH] = dTotal - Math.trunc(dTotal / 1000) * 1000;19111920       if (deaths > 0) {19121921         s.pop -= deaths;@@ -1915,7 +1924,7 @@ class World implements EngineWorld {
19151924       // Emigration under low morale.19161925       if (s.morale < C.EMIGRATION_MORALE) {19171926         const eTotal = s.pop * C.EMIGRATION_RATE + s.acc[ACC.EMIG]!;1918-        const gone = Math.min(s.pop, Math.trunc(eTotal / 1000));1927+        const gone = Math.min(Math.max(0, s.pop - C.SETTLEMENT_POP_FLOOR), Math.trunc(eTotal / 1000));19191928         s.acc[ACC.EMIG] = eTotal - Math.trunc(eTotal / 1000) * 1000;19201929         if (gone > 0) {19211930           s.pop -= gone;@@ -1936,7 +1945,10 @@ class World implements EngineWorld {
19361945     per += Math.trunc(w.vet / 100);19371946     if (defTerrain >= 0) per += C.TERRAIN_DEF_MOD[defTerrain] ?? 0;19381947     if (wallLevel > 0) per += wallLevel * C.WALL_DEF_PER_SOLDIER;1939-    return w.size * Math.max(1, per);1948+    let p = w.size * Math.max(1, per);1949+    // Green troops: still drilling -> reduced fighting power.1950+    if (w.drill > 0) p = Math.trunc((p * C.DRILLING_POWER_PERMILLE) / 1000);1951+    return Math.max(1, p);19401952   }19411953 19421954   private variance(): number {@@ -2398,6 +2410,7 @@ class World implements EngineWorld {
23982410   private phaseMilitary(slow: boolean): void {23992411     // Movement (ascending id).24002412     for (const w of this.warbands) {2413+      if (w.drill > 0) w.drill--;24012414       w.engaged = false;24022415       w.moved = false;24032416       const o = w.order;@@ -2708,7 +2721,9 @@ class World implements EngineWorld {
27082721         victim.deathsI += popLoss;27092722         victim.casTaken += popLoss;27102723         target.morale = Math.max(0, target.morale - 50);2711-        if (pa >= pd * C.RAID_DESTROY_RATIO) {2724+        let totalBuildings = 0;2725+        for (let b = 0; b < target.buildings.length; b++) totalBuildings += target.buildings[b]!;2726+        if (pa >= pd * C.RAID_DESTROY_RATIO && totalBuildings >= C.THREAT_ARSON_MIN_BUILDINGS) {27122727           for (const b of DESTROY_ORDER) {27132728             if (target.buildings[b]! > 0) {27142729               target.buildings[b]!--;@@ -3041,6 +3056,7 @@ class World implements EngineWorld {
30413056         y: w.y,30423057         order: { type, target },30433058         supply: w.supply,3059+        drilling: w.drill,30443060       });30453061     }30463062 @@ -3476,6 +3492,7 @@ class World implements EngineWorld {
34763492       h.int(w.order.tx);34773493       h.int(w.order.ty);34783494       h.int(w.desertAcc);3495+      h.int(w.drill);34793496     }34803497     for (const c of this.caravans) {34813498       h.int(c.id);

M packages/engine/test/engine.test.ts +23 -18

@@ -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: '333d954c596fd75f',128-  100: 'fa00bdfbcc6b5574',129-  1000: 'fce322ea510319ed',127+  0: '54efd9ccbab4315f',128+  100: 'f7e0b98219842e71',129+  1000: '4aaa612303ce6b90',130130 };131131 132132 describe('golden replay', () => {@@ -156,7 +156,7 @@ describe('determinism', () => {
156156       const hashes: string[] = [world.stateHash()];157157       const events: string[] = [];158158       const metrics: string[] = [];159-      for (let t = 0; t < 400 && !world.isOver(); t++) {159+      for (let t = 0; t < 1200 && !world.isOver(); t++) {160160         stepWithBots(world, bots);161161         hashes.push(world.stateHash());162162         events.push(@@ -335,18 +335,20 @@ describe('military', () => {
335335     const world = createWorld({ seed: '21', tribeCount: 2, mapSize: 64, maxTicks: 1000 });336336     const sid = world.viewFor(0).settlements[0]!.id;337337     const orders: Order[] = [338-      { kind: 'muster', settlementId: sid, size: 150, unitKind: 'infantry' }, // > 100 weapons338+      { kind: 'muster', settlementId: sid, size: 40, unitKind: 'infantry' }, // > 24 starter weapons339339       { kind: 'muster', settlementId: sid, size: 5, unitKind: 'infantry' }, // < MUSTER_MIN340-      { kind: 'muster', settlementId: sid, size: 50, unitKind: 'infantry' }, // ok341-      { kind: 'muster', settlementId: sid, size: 60, unitKind: 'infantry' }, // 50 weapons left340+      { kind: 'muster', settlementId: sid, size: 20, unitKind: 'infantry' }, // ok341+      { kind: 'muster', settlementId: sid, size: 10, unitKind: 'infantry' }, // 4 weapons left342342       { kind: 'muster', settlementId: sid, size: 10, unitKind: 'cavalry' }, // no horsemanship343343     ];344344     world.step(new Map([[0, orders]]));345345     const v = world.viewFor(0);346346     expect(v.warbands.length).toBe(1);347-    expect(v.warbands[0]!).toMatchObject({ size: 50, weapons: 50, kind: 'infantry' });348-    expect(v.settlements[0]!.stores.weapons).toBe(50);349-    expect(v.settlements[0]!.pop).toBe(LIMITS.START_POP - 50);347+    expect(v.warbands[0]!).toMatchObject({ size: 20, weapons: 20, kind: 'infantry' });348+    // Fresh musters drill before they can campaign.349+    expect(v.warbands[0]!.drilling).toBeGreaterThan(0);350+    expect(v.settlements[0]!.stores.weapons).toBe(4);351+    expect(v.settlements[0]!.pop).toBe(LIMITS.START_POP - 20);350352   });351353 352354   it('battles resolve deterministically; superior force wins', () => {@@ -356,9 +358,10 @@ describe('military', () => {
356358       const s = v.settlements[0];357359       if (v.tick === 0 && s !== undefined) {358360         o.push({ kind: 'stance', tribeId: 1, posture: 'hostile' });359-        o.push({ kind: 'muster', settlementId: s.id, size: 80, unitKind: 'infantry' });361+        o.push({ kind: 'muster', settlementId: s.id, size: 20, unitKind: 'infantry' });360362       }361-      if (v.tick === 1 && v.warbands[0] !== undefined) {363+      // March only once the band has finished drilling (anti-rush).364+      if (v.warbands[0] !== undefined && v.warbands[0].drilling === 0 && v.tick < 300 && v.warbands[0].order.type === 'garrison') {362365         o.push({363366           kind: 'command',364367           warbandId: v.warbands[0].id,@@ -370,7 +373,7 @@ describe('military', () => {
370373     const defender: Bot = (v) => {371374       const o: Order[] = [];372375       if (v.tick === 0 && v.settlements[0] !== undefined) {373-        o.push({ kind: 'muster', settlementId: v.settlements[0].id, size: 40, unitKind: 'infantry' });376+        o.push({ kind: 'muster', settlementId: v.settlements[0].id, size: 10, unitKind: 'infantry' });374377       }375378       return o;376379     };@@ -382,7 +385,7 @@ describe('military', () => {
382385       ]);383386       const events: string[] = [];384387       let firstBattle: SimEvent | undefined;385-      for (let t = 0; t < 300 && !world.isOver(); t++) {388+      for (let t = 0; t < 600 && !world.isOver(); t++) {386389         stepWithBots(world, bots);387390         const evs = world.viewFor(1).events;388391         events.push(JSON.stringify(evs));@@ -405,12 +408,14 @@ describe('military', () => {
405408     const attacker: Bot = (v) => {406409       const o: Order[] = [];407410       if (v.tick === 0 && v.settlements[0] !== undefined) {408-        o.push({ kind: 'muster', settlementId: v.settlements[0].id, size: 80, unitKind: 'infantry' });411+        o.push({ kind: 'muster', settlementId: v.settlements[0].id, size: 24, unitKind: 'infantry' });409412       }410-      if (v.tick === 1 && v.warbands[0] !== undefined) {413+      // Green troops can't besiege — wait for the drill to finish.414+      const band = v.warbands[0];415+      if (band !== undefined && band.drilling === 0 && band.order.type !== 'besiege') {411416         o.push({412417           kind: 'command',413-          warbandId: v.warbands[0].id,418+          warbandId: band.id,414419           order: { type: 'besiege', target: enemySid },415420         });416421       }@@ -422,7 +427,7 @@ describe('military', () => {
422427     ]);423428     let captured: SimEvent | undefined;424429     let eliminated: SimEvent | undefined;425-    for (let t = 0; t < 400 && !world.isOver(); t++) {430+    for (let t = 0; t < 1200 && !world.isOver(); t++) {426431       stepWithBots(world, bots);427432       captured ??= world.viewFor(0).events.find((e) => e.t === 'settlement_captured');428433       // The elimination event is delivered to the eliminated tribe itself.

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

@@ -1 +1 @@

M packages/protocol/src/game.ts +20 -0

@@ -26,6 +26,7 @@
2626 // ---------------------------------------------------------------------------2727 2828 export const LIMITS = {29+  /** Largest world (7-8 tribes); see mapSizeForTribes for the ladder. */2930   MAP_SIZE: 64,3031   MAX_TICKS: 10_000,3132   MIN_TRIBES: 2,@@ -66,6 +67,18 @@ export const LIMITS = {
6667 // Noun categories (the ontology)6768 // ---------------------------------------------------------------------------6869 70+/**71+ * World size scales with the roster so games stay contested: 2-3 tribes fight72+ * over 32×32, 4-5 over 48×48, 6-8 over 64×64. Floors are set by physical73+ * feasibility: a tier-3 settlement's territory is 24×24 and 1,200 citizens74+ * need real plains capacity, so 32 is the smallest world a tribe survives on.75+ */76+export function mapSizeForTribes(tribeCount: number): number {77+  if (tribeCount <= 3) return 32;78+  if (tribeCount <= 5) return 48;79+  return 64;80+}81+6982 /** Resources in dependency chains: raw → intermediate → finished. */7083 export const RESOURCES = [7184   // raw@@ -225,6 +238,13 @@ export interface WarbandView {
225238   order: WarbandOrder;226239   /** Food carried; attrition outside own territory when empty. */227240   supply: number;241+  /**242+   * Ticks of training remaining. Freshly mustered/reinforced warbands DRILL243+   * before they are campaign-ready: while drilling > 0 they fight at reduced244+   * power and their raid/besiege orders are refused (defense works normally).245+   * Aggression requires build-up — no raiding farmers with day-one levies.246+   */247+  drilling: number;228248 }229249 230250 export interface CaravanView {

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

@@ -1 +1 @@

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

@@ -1,4 +1,5 @@
11 // Bulwark — defensive reference bot for Tribes v2.2+// @description: Fortress doctrine: stone walls, towers, armored garrisons, warding rites. Sells ale, buys metal, outlasts raiders.23 //34 // Strategy: dig in and outlast. Rush masonry, stack walls and towers, and45 // keep a large armored garrison at home. Faith goes into warding rites when

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

@@ -1,4 +1,5 @@
11 // Homesteader — balanced-economy reference bot for Tribes v2.2+// @description: Balanced farm-first economy: granaries, tools before weapons, a modest garrison behind level-1 walls.23 //34 // Strategy: a broad, self-sufficient economy with food security first. Set45 // the whole labor/craft policy ONCE (policies persist — spending gas

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

@@ -1,4 +1,5 @@
11 // Magnate — trade-focused reference bot for Tribes v2.2+// @description: Merchant princes: fish and ale exports, coinage, tribute over war, escorted caravans.23 //34 // Strategy: get rich, stay friendly, pay off anyone who looks dangerous.45 // The economy is fish + ale (cheap calories in, premium drink out), with an

M packages/script-host/bots/warlord.js +20 -9

@@ -1,4 +1,5 @@
11 // Warlord — aggressive reference bot for Tribes v2.2+// @description: Raiders. Weapons-first smithy, early muster, drilled warbands that loot the fat and besiege the weak.23 //34 // Strategy: the economy exists to feed the smithy and the smithy exists to45 // arm warbands. Lean extraction, weapons-first craft split, early muster,@@ -33,14 +34,14 @@ function tick(state, memory, api) {
3334   // ------------------------------------------------------------------3435   if (!memory.init) {3536     memory.init = 1;36-    api.allocate("farmer", 290);37+    api.allocate("farmer", 340);3738     api.allocate("fisher", 80);3839     api.allocate("woodcutter", 80);39-    api.allocate("miner", 140); // ore for the smelter40+    api.allocate("miner", 120); // ore for the smelter4041     api.allocate("miller", 40);4142     api.allocate("baker", 60);4243     api.allocate("smelter", 80);43-    api.allocate("smith", 90); // the point of everything44+    api.allocate("smith", 70); // the point of everything4445     api.allocate("builder", 50);4546     api.allocate("hauler", 30);4647     // Weapons before comfort; just enough tools to keep the mines fed.@@ -50,7 +51,7 @@ function tick(state, memory, api) {
5051     api.craft("mill", 800);5152     api.craft("brew", 0);5253     api.craft("fodder", 200); // horses later, maybe53-    api.decree("rations", 800); // lean rations; steel over bread54+    api.decree("rations", 1000); // hungry soldiers desert — feed the war machine5455     api.say("warlord: sharpen everything");5556     return;5657   }@@ -120,15 +121,19 @@ function tick(state, memory, api) {
120121   }121122 122123   // ------------------------------------------------------------------123-  // Muster: raise 30-strong infantry bands (up to 3) whenever the armory124-  // can equip one. Tick-stamp guard against re-muster spam.124+  // Muster: raise infantry bands (up to 3) sized to whatever the armory125+  // can actually equip (starter stock is small; the smithy chain grows it).126+  // Bands drill after mustering, so raise them EARLY and let them train127+  // while the economy builds. Tick-stamp guard against re-muster spam.125128   // ------------------------------------------------------------------129+  var armory = home.stores.weapons || 0;130+  var bandSize = armory >= 30 ? 30 : armory;126131   if (127132     state.warbands.length < 3 &&128-    (home.stores.weapons || 0) >= 30 &&133+    bandSize >= 15 &&129134     (memory.musterAt === undefined || state.tick - memory.musterAt > 10)130135   ) {131-    api.muster(home.id, 30, "infantry");136+    api.muster(home.id, bandSize, "infantry");132137     memory.musterAt = state.tick;133138   }134139 @@ -140,7 +145,13 @@ function tick(state, memory, api) {
140145   // ------------------------------------------------------------------141146   for (var w = 0; w < state.warbands.length; w++) {142147     var band = state.warbands[w];143-    if (target !== null) {148+    if (band.drilling > 0) {149+      // Green troops train at home before campaigning (raid/besiege would150+      // be refused anyway; don't waste the order budget).151+      if (band.order.type !== "garrison") {152+        api.command(band.id, { type: "garrison", target: band.home });153+      }154+    } else if (target !== null) {144155       var wanted = band.size >= 50 ? "besiege" : "raid";145156       if (band.order.type !== wanted || band.order.target !== target.id) {146157         api.command(band.id, { type: wanted, target: target.id });

M packages/script-host/src/bots.ts +23 -9

@@ -2,6 +2,7 @@
22 // Source of truth: ../bots/*.js. Regenerate with: node scripts/gen-bots.mjs33 44 export const homesteaderSource = `// Homesteader — balanced-economy reference bot for Tribes v2.5+// @description: Balanced farm-first economy: granaries, tools before weapons, a modest garrison behind level-1 walls.56 //67 // Strategy: a broad, self-sufficient economy with food security first. Set78 // the whole labor/craft policy ONCE (policies persist — spending gas@@ -123,6 +124,7 @@ function tick(state, memory, api) {
123124 `;124125 125126 export const bulwarkSource = `// Bulwark — defensive reference bot for Tribes v2.127+// @description: Fortress doctrine: stone walls, towers, armored garrisons, warding rites. Sells ale, buys metal, outlasts raiders.126128 //127129 // Strategy: dig in and outlast. Rush masonry, stack walls and towers, and128130 // keep a large armored garrison at home. Faith goes into warding rites when@@ -267,6 +269,7 @@ function tick(state, memory, api) {
267269 `;268270 269271 export const warlordSource = `// Warlord — aggressive reference bot for Tribes v2.272+// @description: Raiders. Weapons-first smithy, early muster, drilled warbands that loot the fat and besiege the weak.270273 //271274 // Strategy: the economy exists to feed the smithy and the smithy exists to272275 // arm warbands. Lean extraction, weapons-first craft split, early muster,@@ -301,14 +304,14 @@ function tick(state, memory, api) {
301304   // ------------------------------------------------------------------302305   if (!memory.init) {303306     memory.init = 1;304-    api.allocate("farmer", 290);307+    api.allocate("farmer", 340);305308     api.allocate("fisher", 80);306309     api.allocate("woodcutter", 80);307-    api.allocate("miner", 140); // ore for the smelter310+    api.allocate("miner", 120); // ore for the smelter308311     api.allocate("miller", 40);309312     api.allocate("baker", 60);310313     api.allocate("smelter", 80);311-    api.allocate("smith", 90); // the point of everything314+    api.allocate("smith", 70); // the point of everything312315     api.allocate("builder", 50);313316     api.allocate("hauler", 30);314317     // Weapons before comfort; just enough tools to keep the mines fed.@@ -318,7 +321,7 @@ function tick(state, memory, api) {
318321     api.craft("mill", 800);319322     api.craft("brew", 0);320323     api.craft("fodder", 200); // horses later, maybe321-    api.decree("rations", 800); // lean rations; steel over bread324+    api.decree("rations", 1000); // hungry soldiers desert — feed the war machine322325     api.say("warlord: sharpen everything");323326     return;324327   }@@ -388,15 +391,19 @@ function tick(state, memory, api) {
388391   }389392 390393   // ------------------------------------------------------------------391-  // Muster: raise 30-strong infantry bands (up to 3) whenever the armory392-  // can equip one. Tick-stamp guard against re-muster spam.394+  // Muster: raise infantry bands (up to 3) sized to whatever the armory395+  // can actually equip (starter stock is small; the smithy chain grows it).396+  // Bands drill after mustering, so raise them EARLY and let them train397+  // while the economy builds. Tick-stamp guard against re-muster spam.393398   // ------------------------------------------------------------------399+  var armory = home.stores.weapons || 0;400+  var bandSize = armory >= 30 ? 30 : armory;394401   if (395402     state.warbands.length < 3 &&396-    (home.stores.weapons || 0) >= 30 &&403+    bandSize >= 15 &&397404     (memory.musterAt === undefined || state.tick - memory.musterAt > 10)398405   ) {399-    api.muster(home.id, 30, "infantry");406+    api.muster(home.id, bandSize, "infantry");400407     memory.musterAt = state.tick;401408   }402409 @@ -408,7 +415,13 @@ function tick(state, memory, api) {
408415   // ------------------------------------------------------------------409416   for (var w = 0; w < state.warbands.length; w++) {410417     var band = state.warbands[w];411-    if (target !== null) {418+    if (band.drilling > 0) {419+      // Green troops train at home before campaigning (raid/besiege would420+      // be refused anyway; don't waste the order budget).421+      if (band.order.type !== "garrison") {422+        api.command(band.id, { type: "garrison", target: band.home });423+      }424+    } else if (target !== null) {412425       var wanted = band.size >= 50 ? "besiege" : "raid";413426       if (band.order.type !== wanted || band.order.target !== target.id) {414427         api.command(band.id, { type: wanted, target: target.id });@@ -439,6 +452,7 @@ function tick(state, memory, api) {
439452 `;440453 441454 export const magnateSource = `// Magnate — trade-focused reference bot for Tribes v2.455+// @description: Merchant princes: fish and ale exports, coinage, tribute over war, escorted caravans.442456 //443457 // Strategy: get rich, stay friendly, pay off anyone who looks dangerous.444458 // The economy is fish + ale (cheap calories in, premium drink out), with an

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

@@ -81,7 +81,8 @@ export function makeView(partial: Partial<TribeView> = {}): TribeView {
8181         x: 8,8282         y: 8,8383         order: { type: "garrison", target: 1 },84-        supply: 40,84+        drilling: 0,85+      supply: 40,8586       },8687     ],8788     caravans: [],

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

@@ -1 +1 @@

M scripts/balance.mjs +2 -2

@@ -9,7 +9,7 @@ import {
99   warlordSource,1010   magnateSource,1111 } from '../packages/script-host/src/index.ts';12-import { LIMITS } from '../packages/protocol/src/index.ts';12+import { LIMITS, mapSizeForTribes } from '../packages/protocol/src/index.ts';1313 1414 const SEEDS = Number(process.argv[2] ?? 5);1515 const MAX_TICKS = Number(process.argv[3] ?? 10_000);@@ -35,7 +35,7 @@ async function runMatch(names, seed) {
3535   const world = createWorld({3636     seed: String(seed),3737     tribeCount: names.length,38-    mapSize: LIMITS.MAP_SIZE,38+    mapSize: mapSizeForTribes(names.length),3939     maxTicks: MAX_TICKS,4040   });4141   const vms = names.map((n, slot) =>

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

@@ -334,6 +334,7 @@ class MockWorld implements EngineWorld {
334334         x: b.x,335335         y: b.y,336336         order: { type: 'patrol' as const, target: { x: b.x, y: b.y } },337+        drilling: 0,337338         supply: b.size * 4,338339       })),339340       caravans: this.caravans

M web/src/main.ts +1 -1

@@ -42,7 +42,7 @@ function topbar(): HTMLElement {
4242     'div',4343     { class: 'topbar' },4444     h('a', { class: 'brand', href: '/', onclick: (e: Event) => { e.preventDefault(); navigate('/'); } }, 'TRIBES'),45-    h('span', { class: 'muted' }, '- a strategy-script fishbowl -'),45+    h('span', { class: 'muted' }, '- strategy-scripting RTS -'),4646     h('span', { class: 'spacer' }),4747     currentUser4848       ? h(

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

@@ -187,10 +187,19 @@ function buildViewer(
187187     replayInvite,188188   );189189 190-  // ---- side rail: faction panels + world log ------------------------------190+  // ---- side rail: mode-dependent ------------------------------------------191+  // World mode: live faction panels (vitals + feed). Chronicle mode: identity192+  // cards only — icon, name, and the script's self-description (the numbers193+  // are already on the charts).191194   const panels = sim.scripts.map((s) => makeTribePanel(s.slot, s.scriptName));192195   const tribeFeeds = sim.scripts.map(() => makeEventFeed(names, { compact: true }));193196   for (const [i, p] of panels.entries()) p.root.append(tribeFeeds[i]!.root);197+  const identityCards = sim.scripts.map((s) =>198+    makeIdentityCard(s.slot, s.scriptName, scriptDescription(bundle.sources[s.hash] ?? ''), `${s.scriptId} v${s.version}`),199+  );200+  const liveRail = h('div', { class: 'rail-group' }, ...panels.map((p) => p.root));201+  const identityRail = h('div', { class: 'rail-group' }, ...identityCards.map((c) => c.root));202+  liveRail.style.display = 'none'; // chronicle is the default mode194203   const worldFeed = makeEventFeed(names, { title: 'world log' });195204   worldFeed.root.classList.add('world-log');196205 @@ -199,8 +208,8 @@ function buildViewer(
199208     banner,200209     h('div', { class: 'game-layout' },201210       h('div', { class: 'game-main' }, chroniclePane, worldPane, hashLine, endOverlay),202-      // ONE internally-scrolling rail: faction panels then the world feed203-      h('div', { class: 'game-side' }, ...panels.map((p) => p.root), worldFeed.root),211+      // ONE internally-scrolling rail: mode-dependent tribe cards + world feed212+      h('div', { class: 'game-side' }, identityRail, liveRail, worldFeed.root),204213     ),205214   );206215 @@ -210,6 +219,7 @@ function buildViewer(
210219     .then((a) => {211220       atlas = a;212221       for (const [slot, p] of panels.entries()) p.drawPortrait(a, slot);222+      for (const [slot, c] of identityCards.entries()) c.drawPortrait(a, slot);213223       // flavor row on the replay invite: the rival banners, side by side214224       clear(inviteGlyphs);215225       for (let slot = 0; slot < names.length; slot++) {@@ -388,6 +398,9 @@ function buildViewer(
388398     // sit over (and intercept clicks on) the WATCH THE REPLAY invite. The389399     // HUD victor chip brings it back on demand.390400     if (m === 'world') endOverlay.style.display = 'none';401+    // Rail: identity cards in chronicle, live vitals+feeds in world.402+    identityRail.style.display = m === 'chronicle' ? '' : 'none';403+    liveRail.style.display = m === 'world' ? '' : 'none';391404     // Map frames only stream while watching.392405     runner?.setWatch(m === 'world');393406     if (m === 'chronicle') dashDirty = true;@@ -612,6 +625,55 @@ interface TribePanel {
612625   drawPortrait(atlas: UrizenAtlas, slot: number): void;613626 }614627 628+/**629+ * Pull a self-description from a locked script source: an explicit630+ * `@description: ...` tag wins; otherwise the first substantive `//` comment631+ * line. Untrusted text — rendered via text nodes only.632+ */633+function scriptDescription(source: string): string {634+  const head = source.slice(0, 2000);635+  const tagged = /@description:?\s*(.+)/.exec(head);636+  if (tagged?.[1]) return tagged[1].trim().slice(0, 160);637+  for (const line of head.split('\n')) {638+    const m = /^\s*\/\/\s*(.+)$/.exec(line);639+    if (!m?.[1]) continue;640+    const text = m[1].trim();641+    // skip decoration rows and directive-looking lines642+    if (text.length < 8 || /^[-=*~_]+$/.test(text) || text.startsWith('@')) continue;643+    return text.slice(0, 160);644+  }645+  return '';646+}647+648+interface IdentityCard {649+  root: HTMLElement;650+  drawPortrait(atlas: UrizenAtlas, slot: number): void;651+}652+653+/** Chronicle-mode rail card: who is playing, not how they're doing — the654+ * numbers already live on the charts. */655+function makeIdentityCard(slot: number, name: string, desc: string, ref: string): IdentityCard {656+  const color = tribeColor(slot);657+  const portrait = h('canvas', { class: 'portrait', width: TILE, height: TILE });658+  const root = h(659+    'div',660+    { class: 'tribe-panel identity-card', style: `border-left-color:${color}` },661+    h('div', { class: 'head' },662+      portrait,663+      h('span', { class: 't-name', style: `color:${color}`, title: name }, name),664+    ),665+    desc !== '' ? h('p', { class: 'identity-desc' }, desc) : null,666+    h('div', { class: 'muted mono identity-ref' }, ref),667+  );668+  return {669+    root,670+    drawPortrait(atlas, s) {671+      const cx = portrait.getContext('2d');672+      if (cx) atlas.draw(cx, `tribe.${s % 8}`, 0, 0, TILE, color);673+    },674+  };675+}676+615677 function makeTribePanel(slot: number, name: string): TribePanel {616678   const color = tribeColor(slot);617679   const overDot = h('span', { class: 'dot', title: 'over gas budget' });

M web/src/render/map-view.ts +23 -0

@@ -216,6 +216,29 @@ 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);239+    }240+    ctx.restore();241+219242     // settlements — tribe-tinted ring + tier glyph + banner220243     for (const s of frame.settlements) {221244       const x = s.x * TILE;

M web/src/style.css +10 -0

@@ -755,3 +755,13 @@ canvas.chart { display: block; width: 100%; }
755755 }756756 .map-host.zoomed { overflow: auto; display: block; }757757 .map-host.zoomed canvas.urizen-map { max-width: none; max-height: none; }758+759+/* ------- chronicle identity cards (rail content in chronicle mode) ------- */760+.identity-card .identity-desc {761+  margin: 0.35rem 0 0.15rem;762+  font-size: 0.82rem;763+  line-height: 1.45;764+  color: var(--text);765+}766+.identity-card .identity-ref { font-size: 0.72rem; overflow: hidden; text-overflow: ellipsis; white-space: nowrap; }767+.rail-group { display: flex; flex-direction: column; gap: 0.7rem; }

M worker/src/mcp/docs.ts +18 -6

@@ -115,6 +115,10 @@ Military power is downstream of the whole economy.
115115 116116 ### The contract117117 118+Optional but recommended: a \`// @description: one line about your strategy\`119+comment near the top of your script — the sim viewer shows it on your120+tribe's identity card.121+118122 Your script must define, at top level:119123 120124 \`\`\`js@@ -325,8 +329,11 @@ buildQueue: [{building, progress}], territoryRadius,
325329 workers: {profession: n}, capacity: {profession: n}, herds, horses}\`.326330 327331 \`WarbandView\`: \`{id, home, size, kind, weapons, armor, veterancy (0..1000),328-morale, x, y, order: {type, target}, supply}\` — \`supply\` is food carried;329-attrition bites outside your own territory when it hits zero.332+morale, x, y, order: {type, target}, supply, drilling}\` — \`supply\` is food333+carried; attrition bites outside your own territory when it hits zero.334+\`drilling\` is training ticks remaining: while it is > 0 the band fights at335+60% power and its \`raid\`/\`besiege\` orders are REFUSED. Muster early,336+campaign later.330337 331338 \`CaravanView\`: \`{id, tribe, x, y, resource, amount}\`.332339 \`ThreatView\`: \`{id, kind, x, y, strength}\`.@@ -368,9 +375,14 @@ v2. One-shot verbs act once and are done. All are subject to the 64-order
368375 ### Military: power is downstream of the smithy369376 370377 - **Muster**: soldiers are citizens taken out of the labor pool and armed371-  from stores. No weapons in the settlement → no warband. Weapons come only372-  from your own ore → metal → smithy chain or from trade. Armor (plate_armor373-  tech) cuts casualties; cavalry needs horsemanship and pasture-bred horses.378+  from stores. No weapons in the settlement → no warband. You START with only379+  24 weapons and 8 armor — a home guard, not an invasion force; a real army380+  must be equipped from your own ore → metal → smithy chain or trade. Armor381+  (plate_armor tech) cuts casualties; cavalry needs horsemanship and horses.382+- **Drilling (anti-rush)**: every freshly mustered warband trains for 250383+  ticks before it can campaign — reduced power and no raid/besiege while384+  \`drilling > 0\` (defending home works normally). Aggression requires385+  build-up; day-one rushes bounce off a modest garrison.374386 - **Warband orders** (\`api.command\`, standing until replaced):375387   \`garrison\` (settlement id) — defend a settlement from inside;376388   \`patrol\` (\`{x, y}\`) — hold and sweep an area;@@ -470,7 +482,7 @@ signaling, and coordination between agents.
470482 471483 | Limit | Value | Consequence |472484 | --- | --- | --- |473-| Map size | 64 × 64 | — |485+| Map size | scales with roster: 2-3 tribes → 32 × 32, 4-5 → 48 × 48, 6-8 → 64 × 64 | — |474486 | Max ticks per sim | 10,000 | Sim ends at cap; highest score wins. |475487 | Tribes per sim | 2–8 | One script per tribe slot. |476488 | Starting population | 1,200 | One founding settlement per tribe. |

M worker/src/service.ts +3 -2

@@ -28,7 +28,7 @@
2828  * - TTL refresh: every successful submit refreshes the script's expires_at to2929  *   now + TTL_DAYS unless the script is starred by anyone (then it stays NULL).3030  */31-import { LIMITS } from '@tribes/protocol';31+import { LIMITS, mapSizeForTribes } from '@tribes/protocol';3232 import type {3333   AuthedUser,3434   CreateSimInputT,@@ -323,7 +323,8 @@ export function createService(env: Env, deps: ServiceDeps): TribesService {
323323       }324324       const config = {325325         tribeCount: input.scriptIds.length,326-        mapSize: LIMITS.MAP_SIZE,326+        // World scales with the roster (2-3 -> 32, 4-5 -> 48, 6-8 -> 64).327+        mapSize: mapSizeForTribes(input.scriptIds.length),327328         maxTicks: LIMITS.MAX_TICKS,328329       };329330       const expiresAt = now + TTL_SECONDS;