feat: wire move+found loops + 29x render perf (Sprint 1 integration)

Five parallel department workflows (disjoint files) + integrator wiring:

- PERF (#4): viewport culling + LOD + dpr clamp + auto quality in render/* —
  render at zoom 8.2 dropped 33.9ms -> 1.17ms/frame (~29x), crushing the
  GitHub Pages heavy-load on weak/high-dpr devices. Drop-in, on by default.
- FOUND (#1,#2): territory.js TREASURY_RESERVE lets a nation save past the 10g
  cost (gold reaches 12 by yr3, was stuck 0-2 forever); settlement.js spacing
  relaxed 8->5 + settleSys.lastFoundReason surfaced in game.js so a rejected
  tile explains why (water/too_close).
- MOVE (#3): pathfind.js flow-field wired into the sim.js order block, replacing
  the greedy 6-angle deflector. A pinned-energy unit now routes around water and
  ARRIVES (48.6 -> 1.2 tiles). Real-play long-march completion + player-survival
  balance tracked in #8.
- Cognition: agent order/hold/path state + bit-identical brain forward pass.
- Statecraft: war-goals/peace-terms + treasury lever + war-tracking APIs (landed;
  wiring in the next slice).
- Docs: ECONOMY_DESIGN.md (#6), AGENT_LIFE_DESIGN.md (#7), SPRINT_PLAN.md.

Headless invariant ALL PASS (pop 3200, gen 27). CI gates every push.

Fixes #1
Fixes #2
Fixes #4
Refs #3
Refs #8

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

Author: lordbasilaiassistant-sudo

.gitignore

@@ -6,6 +6,7 @@ Thumbs.db
 # editor / OS cruft
 .vscode/
 .idea/
+.serena/
 # scratch workflow / playtest scripts (not part of the game)
 test/_*.js
 test/_*.mjs

AGENT_LIFE_DESIGN.md

@@ -0,0 +1,52 @@
+# AEON — The Free Guy Principle: every soul has an inner life
+
+_North-star design (drlor, 2026-06-13): "give them feelings, hunger, community needs, personal
+behaviors... we want them basically living in the city like Free Guy. We just can be a leader in
+places, as survival mode." Tracked as issue #7._
+
+## The vision
+AEON's one true differentiator: **every creature already thinks with a real, evolving neural net.**
+The goal is to make that FELT — each NPC is a background character with a life of their own (like the
+NPCs in *Free Guy*): they get hungry, afraid, content, lonely; they have personal habits and bonds;
+they pursue their own little goals. **The player is a LEADER among them (Survival mode), not a
+puppeteer** — you set direction (policies, orders, found cities) and the populace lives in response.
+The drama is emergent, not scripted. (Creative/god mode is the sandbox exception.)
+
+## Inner state (per agent) — the two-layer mind, deepened
+**Layer 1 — needs & feelings (survival brain, already partly here):**
+- **Needs:** hunger (energy), thirst, rest/fatigue, safety, and **belonging** (social contact with
+  one's people). Each has a level; unmet needs drive behavior and hurt the agent over time.
+- **Emotions/mood:** an affect state DERIVED from needs + recent events — content (fed & safe),
+  fear (under threat / starving), anger (attacked / rival near), grief (lost kin), joy (birth, plenty).
+  Mood biases the NN's choices and is VISIBLE.
+- **Personality:** genome-derived tendencies (bold/timid, social/solitary, forager/homebody,
+  curious/cautious) so two well-fed agents still behave differently — watching ONE is interesting.
+- **Relationships & memory:** kin and tribe bonds; light memory of recent events (who fed/attacked me,
+  where food/danger was) that colors decisions.
+
+**Layer 2 — community (culture/social):** belonging, shared language/religion/customs (already
+emerging via culture/anthropology) become real social NEEDS — agents want to be near their people,
+participate, and suffer when isolated (ties to the city-needs economy, issue #6, and tribe fission).
+
+## Wire it into the NN (cognition + integrator)
+- Add **senses** for inner/social state (own mood, nearest-kin direction, crowd density, belonging
+  level) so the brain can act ON feelings.
+- Feed needs/mood as **modulators** of existing drives (a fearful agent flees & shares less; a content
+  one explores & breeds). Keep it cheap (no per-agent heavy loops) and keep evolution intact.
+
+## Surface it (frontend + integrator) — legibility is the feature
+- **Inspect an NPC** → a little "life card": mood (emoji/face + color), needs bars (hunger/thirst/
+  belonging), current activity WITH A REASON ("foraging — hungry", "fleeing — afraid", "heading home"),
+  closest bonds, age/generation. This is the Free Guy moment: you click a dot and meet a person.
+- Subtle world tells: expression/posture, occasional thought/▴ emote, mood-tinted shading (cheap LOD).
+
+## Player-as-leader (survival)
+You lead a people, not micro-pawns: policies bias the population's feelings/behavior; orders/found are
+deliberate interventions; the populace otherwise lives autonomously. Success = a thriving, content
+nation; failure = starvation, fear, collapse (the fail-state work). Legible cause→effect throughout.
+
+## Sequencing
+A COGNITION-led sprint (brain.js/agent.js inner state) + FRONTEND (life-card UI) + INTEGRATOR (senses
+wiring + inspector), AFTER the current verb-wiring wave. Pairs with the city-needs economy (#6). Balance
+per the design law ([[feedback-balance-and-ux]]): feelings must MATTER without being punishing, and
+must be readable.

ECONOMY_DESIGN.md

@@ -0,0 +1,50 @@
+# AEON — Economy Design: Costs & City Needs
+
+_Design spec for the "not-too-easy" depth layer (drlor, 2026-06-13). Tracked as issue #6.
+Implemented in the coremech sprint AFTER the verb-wiring integration wave (single-writer settlement.js)._
+
+## Principle
+Mechanics must be **neither too easy nor too hard**, and **interface/controls must make every
+cost and need legible**. Cities are not plant-and-forget: founding and building **cost currencies/
+resources**, and every city carries **ongoing needs** it must meet or it declines. This is the
+pressure that turns a sandbox into a game with real decisions.
+
+## Currencies & resources (mostly already in `tribe.stock` + `tribe.gold`)
+`gold` (treasury) · `wood` · `stone` · `ore` → refined `metal` · `food`.
+
+## Costs (the sinks)
+| Action | Cost | Notes |
+|--------|------|-------|
+| Found city | gold + settler pop | **scales per city** (city N costs more) so expansion is a decision, not a reflex |
+| Granary | stone + food | +food / growth (FUNC-BUILDINGS) |
+| Walls | stone | +defense (feeds conquest `s.defense`) |
+| Barracks | wood + metal | lets you train soldiers you control |
+| Market | gold + wood | +gold |
+| Library | stone + gold | +research |
+| Train soldier | gold + metal | partially exists (`trainSoldier`) |
+
+## City NEEDS (ongoing — unmet ⇒ the city suffers)
+- **Food:** city food income ≥ pop, else it shrinks / starves (formalize per-city food balance; the
+  founding food-magnet is the seed of this).
+- **Water:** city-level water access (adjacent water or a well building); extends the agent thirst need.
+- **Upkeep:** every city and unit costs gold/yr. If the treasury can't pay → unrest, then disband.
+  This is the sink that makes gold income matter turn-to-turn.
+- **Supply / connection:** a city disconnected from national territory is **isolated** → reduced
+  output and revolt risk (hooks into TRIBE-FISSION / secession).
+- **Stability:** unmet needs or overexpansion → unhappiness → revolt / secession.
+
+## Balance knobs (target feel)
+- 2–3 cities comfortable on default play; 6+ requires deliberate economy management.
+- Needs create **failure pressure** (you can lose a city, even your nation) but recoverable — not punishing.
+- Costs scale so the player must choose between tall (few strong cities) and wide (many needy ones).
+
+## Interface / controls (REQUIRED — legibility is the feature)
+- City inspector shows **each need** with sign + color: `food +3 / −1`, `upkeep −4g`, `water ✓`,
+  `supply ✓/✗`, `stability 72%`.
+- Build queue shows **costs up front**; an unaffordable item shows the **missing resource by name**
+  ("need 2 stone").
+- A city in trouble surfaces a **toast** ("Rondisad is starving") so the player can act.
+
+## Dependencies
+Builds on the now-working **Found** verb (#1, #2) and treasury reserve. Pairs with FUNC-BUILDINGS,
+GHOST-CITY, FOUND-SUSTAIN, EMPTY-CITY-GATE from SPRINT_PLAN.md.