[KunalSiyag]

What

Shows the city's AI at work from the street. This is the first of the PRs for the engagement feedback.

• Activity feed (scripts/fp/activity/, top right):
  • One card per mayor turn, council ruling, Chaos Director pick, Grid Operator order and Gazette front page.
  • A card names who decided and the model they run on. A badge gives the source: live, replay, fallback (after a failed live call) or the offline planner. The card also shows what they did and why, any votes, and where.
  • The header says Offline, Live or Reconnecting, and who is deciding or goes next.
  • J cycles full, brief and hidden. The feed hides under menus and cards (at once under the pause menu), but not under the chat input.
• Beacons and tags:
  • A decision with a place raises a light beacon in the agent's colour and pings the compass and minimap (ai:<agent>, no toast).
  • Within 30 tiles, a floating tag names the decision. A tag that would cover the top bar, feed, minimap or chat ticker is left out instead of being pushed to the screen edge. Tags hide while the chat drawer is open.
  • G routes the GPS to the newest decision with a place.
• Staggered mayor turns (scripts/ai/mayor_turns.gd):
  • On foot, the five mayors take their turns spread over the first 90% of the day, in an order that rotates daily, instead of all at dawn.
  • A turn starts only while the sliced sim is idle, so its actions never force a synchronous finish. Before that fix, the new test measured 4 forced finishes in one day, the worst taking 51 ms in a single frame.
  • A mayor still deciding keeps the turn. A turn still waiting when the day ends runs on its own day. Saves keep the queue.
• Refactor: prompt text helpers move from city_brain.gd to scripts/ai/brain_text.gd, since city_brain.gd was at the file-length limit.
• Input: ai_feed (J, keyboard only, since every pad button is taken on foot). G reuses site_waypoint on foot.
• Behind the activity flag (on by default).

Checks

• tools/gate.sh full: PASS (no flaky retries).
• pre-commit run --all-files and python tools/checks/run_all.py: PASS. API docs regenerated.
• New fp_activity_test.
• fp_brainspread_test adds a staggered-day check driven by the sim's own sliced clock at one job step per frame. The turns land at ticks 0, 1, 1, 2 and 3 with no forced finish.
• Windowed 1600x900 photo tour, 3 days offline: 22 shots, no errors. Tags stay clear of the HUD and hide while the chat drawer is open.

[github-actions]

Automated review

No new findings on the 35 changed files (gdlint, complexity, TODO policy, dead code).

Run python3 tools/checks/run_all.py locally for the full set of checks.