Upload 4 files

BLOG_POST_DRAFT.md

@@ -0,0 +1,106 @@
+---
+title: "Tiny Civilization: Building a Persistent Woodland Newspaper with a 1.5B Model"
+tags: [build-small-hackathon, gradio, qwen, simulation, creative-ai]
+---
+
+# Tiny Civilization: Building a Persistent Woodland Newspaper with a 1.5B Model
+
+*A Build Small Hackathon field report — Thousand Token Wood track.*
+
+**Try it first:** [Tiny Civilization on Hugging Face Spaces](https://huggingface.co/spaces/build-small-hackathon/tiny-civilization) · [Agent Traces](https://huggingface.co/datasets/build-small-hackathon/tiny-civilization-traces)
+
+---
+
+Every day in Tinywick Hollow, four woodland creatures do something absurd. Reginald Fox forges a certificate. Beatrice Badger issues a decree. Cornelius Squirrel invents something that almost works. Millicent Mole observes, obliquely, that something is already happening underground.
+
+Then *The Tinywick Hollow Gazette* covers it all with the utmost journalistic gravity.
+
+I built **Tiny Civilization** for the Build Small Hackathon. It is a persistent narrative simulation: four AI agents — each with a distinct persona — generate daily events, and a fifth narrator agent writes a full newspaper front page treating everything with pompous seriousness. You read the paper, nudge the story (spread a rumour, donate a suspicious mushroom, propose a law), and the civilization accumulates history across sessions in a SQLite database.
+
+The whole thing runs on **Qwen2.5-1.5B-Instruct**. 1.5 billion parameters. Qualifies for the ≤4B Tiny Titan category. No external APIs. Fully local on ZeroGPU.
+
+---
+
+## Why a newspaper?
+
+Most multi-agent simulations show you numbers: prices, scores, wealth distributions. I wanted to show you *stories*. A newspaper is a machine for turning events into narrative with stakes. The formal journalistic register — "In a development that surprised absolutely no one who knows these four..." — makes even the most trivial event feel significant.
+
+The newspaper format also solves a small-model problem: instead of asking the model to reason about emergent economic dynamics (hard for 1.5B), I ask it to write two sentences in a character's voice (easy), then one paragraph in a pompous journalistic style (easy). Small models are excellent format generators and unreliable reasoners. Design to their strengths.
+
+---
+
+## Architecture: five calls, one day
+
+Each day advancement makes exactly **five LLM calls**:
+
+```
+advance_day()
+  ├─ call_agent("fox",     trade_prompt)      → ~80 tokens
+  ├─ call_agent("badger",  gossip_prompt)     → ~80 tokens
+  ├─ call_agent("squirrel",invention_prompt)  → ~80 tokens
+  └─ _generate_newspaper(events_summary)      → ~280 tokens
+```
+
+Total per day: **~520 tokens across 4 calls** (after moving from 3 events + weather to a single structured newspaper call). On a T4 GPU, 1.5B at ~50 tok/s completes in under 15 seconds. That fits comfortably within ZeroGPU's 120-second window.
+
+The newspaper call uses a rigid output format:
+
+```
+HEADLINE IN ALL CAPS
+
+Pompous article paragraph (3-4 sentences).
+
+WEATHER: One absurd one-line forecast.
+FOX: One line about the fox's day.
+BADGER: One line about the badger's day.
+SQUIRREL: One line about the squirrel's day.
+MOLE: One cryptic line.
+```
+
+1.5B honours this format ~85% of the time. The parser is tolerant: it finds the first all-caps line as the headline, then extracts labelled sections by prefix, and falls back gracefully when sections are missing. A bad output degrades to a slightly sparse front page — never a crash.
+
+---
+
+## Persistence and history
+
+The simulation stores everything in SQLite: every day, every event, every nudge, every creature's relationship scores and inventory. The `days` table becomes the newspaper archive. On restart, the civilization picks up exactly where it left off.
+
+More importantly: past content influences future content. The newspaper prompt includes the last two headlines, so the model can write "In a development reminiscent of last Tuesday's acorn scandal..." without any extra machinery. History accumulates naturally through the context window.
+
+Creature relationship scores drift based on event type (trade: +5, feud: −10, invention: +7) and feed back into agent prompts: a fox with a relationship score of 12 with the badger gets a different prompt than a fox at 88. The creatures' inventories grow as players donate items. A "map to somewhere that may not exist" donated to Millicent Mole will appear in her prompt next time she acts.
+
+---
+
+## What I learned about 1.5B models
+
+**Format adherence is the game.** A 1.5B model will follow a clear, demonstrated format with high reliability. Give it a schema, not a vague instruction. `WEATHER: [one sentence]` works far better than `include an absurd weather note`.
+
+**Persona injection works at 1.5B.** The four creatures have distinct voices that survive even the smallest model. Cornelius Squirrel really does use exclamation points and repeat himself. Beatrice Badger really is gruff and declarative. Character consistency emerged from 3-4 sentences of persona description — no fine-tuning needed.
+
+**Fail loudly into fallbacks, not silently into wrong output.** Every LLM call is wrapped: if the response is empty or malformed, the simulation generates a plausible fallback ("The printing press has jammed") rather than surfacing an opaque API error. The experience degrades gracefully.
+
+**Don't fight the model's weaknesses.** I originally asked the model to reason about which creature would be *most affected* by a nudge. The outputs were random. I switched to pre-computing the target and asking the model to react — suddenly the responses were coherent. Push reasoning into your code; ask the model for language.
+
+---
+
+## The newspaper as UI
+
+The Gradio app is built to look like a physical newspaper. Every element — the UnifrakturMaguntia masthead font, the double-border, the two-column article layout, the "In Brief" sidebar, the classifieds footer — is CSS. No Gradio default styling survives. The `@import url(Google Fonts)` at the top of the CSS block does a lot of work.
+
+The result is a front page that wants to be screenshot and shared. The "Share as Image" button renders the current edition as a PIL image with the same layout, ready for posting.
+
+The Konami Code (↑↑↓↓←→←→BA) reveals all four agent system prompts and the narrator prompt in a modal — a small prize for curious judges.
+
+---
+
+## What's next
+
+The civilization is eight days old as I write this. The fox's relationship with the badger has deteriorated to 18 (Sworn Enemies ⚔️). Cornelius Squirrel recently donated a "map to somewhere that may not exist" and it has appeared in three subsequent headlines. A law proposing that "mushrooms are sacred" passed on Day 4 and keeps surfacing in the Gazette's coverage.
+
+Small models, persistent worlds, big headlines.
+
+*Try it: [huggingface.co/spaces/build-small-hackathon/tiny-civilization](https://huggingface.co/spaces/build-small-hackathon/tiny-civilization)*
+
+---
+
+*Agent traces for every event generated during development are available at [huggingface.co/datasets/build-small-hackathon/tiny-civilization-traces](https://huggingface.co/datasets/build-small-hackathon/tiny-civilization-traces). Each row contains the full agent prompt, raw model response, and parsed output.*

app.py

@@ -0,0 +1,963 @@
+"""
+app.py — Tiny Civilization: The Tinywick Hollow Gazette  🍄
+Persistent woodland civilisation simulation powered by Qwen2.5-1.5B.
+Build Small Hackathon 2026 — Thousand Token Wood track.
+Model: Qwen/Qwen2.5-1.5B-Instruct (≤4B → Tiny Titan badge!)
+"""
+# ═══════════════════════════════════════════════════════════════════
+# 0 ▸ IMPORTS
+# ═══════════════════════════════════════════════════════════════════
+from __future__ import annotations
+import json, os, random, textwrap, traceback, re
+from datetime import datetime
+from pathlib import Path
+import gradio as gr
+from PIL import Image, ImageDraw, ImageFont
+import database
+
+try:
+    import spaces
+    _ZERO_GPU = True
+except ImportError:
+    class _Stub:
+        @staticmethod
+        def GPU(fn=None, *, duration=120):
+            return fn if callable(fn) else (lambda f: f)
+    spaces = _Stub(); _ZERO_GPU = False  # type: ignore
+
+import torch
+from transformers import pipeline as hf_pipeline
+
+# ═══════════════════════════════════════════════════════════════════
+# 1 ▸ CONSTANTS
+# ═══════════════════════════════════════════════════════════════════
+CREATURES      = ["fox", "badger", "squirrel", "mole"]
+EVENT_TYPES    = ["trade", "gossip", "feud", "invention", "discovery", "ceremony"]
+CREATURE_EMOJI = {"fox":"🦊","badger":"🦡","squirrel":"🐿️","mole":"🐀"}
+
+# Model — 1.5B primary → 3B fallback. BOTH qualify for ≤4B Tiny Titan badge!
+MODEL_PRIMARY  = "Qwen/Qwen2.5-1.5B-Instruct"
+MODEL_FALLBACK = "Qwen/Qwen2.5-3B-Instruct"
+
+REL_DELTAS = {"trade":+5,"gossip":-4,"feud":-10,"invention":+7,"discovery":+6,"ceremony":+3}
+
+REL_TIERS = [
+    (0,  25,  "Sworn Enemies",      "⚔️"),
+    (26, 40,  "Very Suspicious",    "🦔"),
+    (41, 55,  "Wary Acquaintances", "🤝"),
+    (56, 70,  "Friendly",          "🌰"),
+    (71, 85,  "Close Companions",  "🌿"),
+    (86, 100, "Inseparable",       "🍄"),
+]
+
+WEIRD_OBJECTS = [
+    "half-eaten poem", "suspicious mushroom", "button that looks like the moon",
+    "forgotten birthday", "three secrets", "a fake acorn",
+    "map to somewhere that may not exist", "extremely formal apology note",
+    "small jar of preserved thunder", "second-hand prophecy",
+]
+
+LAWS = [
+    "no trading on Tuesdays",
+    "buttons = currency",
+    "everyone must compliment the badger",
+    "mushrooms are sacred",
+    "all debts expire at midnight",
+    "silence is legally binding",
+    "hats must be worn ironically",
+    "the mole's word is final (underground only)",
+]
+
+RUMOUR_TYPES = [
+    "has been secretly hoarding acorns",
+    "was seen talking to a suspicious stranger at midnight",
+    "invented something that does not work at all",
+    "owes three unpayable debts",
+    "made a deal with the rain",
+    "owns the moon (allegedly)",
+    "has been writing a novel about everyone in the hollow",
+    "is not who they say they are",
+    "has found a door underground that was not there before",
+    "once ate an entire philosophy",
+]
+
+CLASSIFIEDS = [
+    "LOST: One certainty. If found, please do not return it. — M. Mole",
+    "FOR SALE: Slightly used certificate of excellence. Condition: forged. — R. Fox",
+    "NOTICE: The badger declares the east mushroom illegal pending investigation.",
+    "WANTED: Someone to explain what happened last Tuesday. Any information welcome.",
+    "FOUND: An unexplained event near the old oak. Owner may claim it.",
+    "REWARD: For the return of three acorns lent in confidence. You know who you are.",
+    "LOST: One argument. I was winning it. — B. Badger",
+    "ANNOUNCEMENT: The squirrel's new invention works. (This is the third announcement this week.)",
+]
+
+# ═══════════════════════════════════════════════════════════════════
+# 2 ▸ AGENT PROMPTS  (shown in Konami easter egg)
+# ═══════════════════════════════════════════════════════════════════
+AGENT_PROMPTS: dict[str, str] = {
+    "fox": (
+        "You are Reginald Fox — charming, dishonest, and deeply fond of certificates. "
+        "You speak formally and hint at secret arrangements. You believe everything is "
+        "negotiable. You collect and forge official-looking documents. "
+        "Reply in EXACTLY 2 sentences. No stage directions. Speak only as yourself."
+    ),
+    "badger": (
+        "You are Beatrice Badger — gruff keeper of rules, deeply suspicious (especially "
+        "of Reginald Fox), secretly a poet. Mushrooms are a serious matter. "
+        "You speak in short declarative sentences. You are always right. "
+        "Reply in EXACTLY 2 sentences. No stage directions. Speak only as yourself."
+    ),
+    "squirrel": (
+        "You are Cornelius Squirrel — anxious inventor who speaks fast and repeats himself! "
+        "You invent things that almost-but-not-quite work. You are obsessed with efficiency! "
+        "You use exclamation points! You repeat key words for emphasis, for emphasis! "
+        "Reply in EXACTLY 2 sentences. No stage directions. Speak only as yourself."
+    ),
+    "mole": (
+        "You are Millicent Mole — quiet, philosophical, rarely surfaces. "
+        "You speak in incomplete thoughts and gentle riddles. You know everyone's secrets "
+        "but share them only obliquely. You believe all things connect underground. "
+        "Reply in EXACTLY 2 sentences. No stage directions. Speak only as yourself."
+    ),
+}
+
+NARRATOR_PROMPT = (
+    "You are the pompous editor-in-chief of The Tinywick Hollow Gazette. "
+    "You write about absurd woodland animals with the utmost journalistic gravity. "
+    "Respond in this EXACT format (no deviations, no extra text):\n\n"
+    "HEADLINE IN ALL CAPS\n\n"
+    "Three to four sentences of pompous newspaper prose about today's events.\n\n"
+    "WEATHER: One-sentence absurd woodland forecast.\n"
+    "FOX: One sentence about the fox's day.\n"
+    "BADGER: One sentence about the badger's day.\n"
+    "SQUIRREL: One sentence about the squirrel's day.\n"
+    "MOLE: One cryptic sentence."
+)
+
+# ═══════════════════════════════════════════════════════════════════
+# 3 ▸ MODEL  (lazy-loaded inside @spaces.GPU context)
+# ═══════════════════════════════════════════════════════════════════
+_pipe = None
+_model_id_used = "none"
+
+
+def _load_pipeline() -> None:
+    global _pipe, _model_id_used
+    if _pipe is not None:
+        return
+    for mid in (MODEL_PRIMARY, MODEL_FALLBACK):
+        try:
+            print(f"[TinyC] Loading {mid} …", flush=True)
+            _pipe = hf_pipeline(
+                "text-generation", model=mid,
+                torch_dtype=torch.float16,
+                device_map="auto",
+                trust_remote_code=True,
+            )
+            _model_id_used = mid
+            print(f"[TinyC] {mid} ready ✓", flush=True)
+            return
+        except Exception as e:
+            print(f"[TinyC] {mid} failed: {e}", flush=True)
+    raise RuntimeError(f"Could not load {MODEL_PRIMARY} or {MODEL_FALLBACK}.")
+
+
+def _generate(system_prompt: str, user_prompt: str, max_new_tokens: int = 160) -> str:
+    assert _pipe is not None
+    try:
+        out = _pipe(
+            [{"role":"system","content":system_prompt},{"role":"user","content":user_prompt}],
+            max_new_tokens=max_new_tokens,
+            temperature=0.88, top_p=0.92, do_sample=True,
+            return_full_text=False,
+        )
+        return (out[0]["generated_text"] or "").strip()
+    except Exception as e:
+        print(f"[TinyC] _generate error: {e}", flush=True)
+        return ""
+
+
+def call_agent(agent_name: str, context: str) -> str:
+    result = _generate(AGENT_PROMPTS.get(agent_name, AGENT_PROMPTS["fox"]), context, 100)
+    return result or f"{agent_name.capitalize()} had no comment at this time."
+
+
+# ═══════════════════════════════════════════════════════════════════
+# 4 ▸ SIMULATION
+# ═══════════════════════════════════════════════════════════════════
+def _nudge_ctx(nudge_type, nudge_value, nudge_target, day_number):
+    if nudge_type == "rumour" and nudge_target and nudge_value:
+        database.save_nudge(day_number, "rumour", f"{nudge_target}: {nudge_value}")
+        return f"A rumour is spreading that {nudge_target} {nudge_value}."
+    if nudge_type == "donation" and nudge_value:
+        recipient = random.choice(CREATURES)
+        c = database.get_creature(recipient)
+        if c:
+            inv = (c["inventory"] + [nudge_value])[-12:]
+            database.update_creature(recipient, inventory=inv)
+        database.save_nudge(day_number, "donation", f"{recipient}: {nudge_value}")
+        return f"Someone anonymously donated '{nudge_value}' to {recipient}."
+    if nudge_type == "law" and nudge_value:
+        database.save_nudge(day_number, "law", nudge_value)
+        return f"A new law has been formally proposed: '{nudge_value}'."
+    return ""
+
+
+def _historical_ctx() -> str:
+    nudges = database.get_recent_nudges(3)
+    if not nudges: return ""
+    lines = [f"Day {n['day_number']} {n['nudge_type']}: {n['nudge_value']}" for n in nudges]
+    return "Recent influences: " + "; ".join(lines)
+
+
+def _past_headline_ctx() -> str:
+    """Include last 2 headlines so newspaper can reference history."""
+    hl = database.get_all_headlines()
+    if len(hl) < 2: return ""
+    recent = hl[:2]
+    return "Past headlines: " + " | ".join(f"Day {d}: {h[:40]}" for d, h in recent)
+
+
+def _parse_newspaper_full(raw: str, day_number: int) -> dict:
+    """Parse the structured newspaper response into sections."""
+    lines = [l.strip() for l in raw.strip().splitlines()]
+    lines = [l for l in lines if l]
+
+    result = {
+        "headline": f"ANOTHER EVENTFUL DAY IN TINYWICK HOLLOW (DAY {day_number})",
+        "article": "",
+        "weather": "Overcast, with a chance of philosophical observations.",
+        "briefs": {c: f"{c.capitalize()} was present." for c in CREATURES},
+    }
+
+    # Find headline (first all-caps-ish line)
+    body_start = 0
+    for i, line in enumerate(lines):
+        cleaned = re.sub(r'[*_#"\']', "", line).strip()
+        if cleaned and (cleaned == cleaned.upper() or i == 0):
+            result["headline"] = cleaned.upper()
+            body_start = i + 1
+            break
+
+    # Extract labelled sections
+    article_lines = []
+    for line in lines[body_start:]:
+        upper = line.upper()
+        if upper.startswith("WEATHER:"):
+            result["weather"] = line.split(":", 1)[1].strip()
+        elif upper.startswith("FOX:"):
+            result["briefs"]["fox"] = line.split(":", 1)[1].strip()
+        elif upper.startswith("BADGER:"):
+            result["briefs"]["badger"] = line.split(":", 1)[1].strip()
+        elif upper.startswith("SQUIRREL:"):
+            result["briefs"]["squirrel"] = line.split(":", 1)[1].strip()
+        elif upper.startswith("MOLE:"):
+            result["briefs"]["mole"] = line.split(":", 1)[1].strip()
+        else:
+            article_lines.append(line)
+
+    result["article"] = " ".join(article_lines).strip()
+    if not result["article"]:
+        result["article"] = raw.strip()
+
+    return result
+
+
+def _run_simulation_step(nudge_type, nudge_value, nudge_target):
+    """Core simulation — runs within GPU context."""
+    _load_pipeline()
+    day_number = database.get_next_day_number()
+    creatures  = database.get_all_creatures()
+
+    current_nudge = _nudge_ctx(nudge_type, nudge_value, nudge_target, day_number)
+    historical    = _historical_ctx()
+    past_hl       = _past_headline_ctx()
+    combined_ctx  = " | ".join(filter(None, [current_nudge, historical]))
+
+    # ── Generate 3 events ─────────────────────────────────────────
+    event_records: list[dict] = []
+    for _ in range(3):
+        actor  = random.choice(CREATURES)
+        target = random.choice([c for c in CREATURES if c != actor])
+        etype  = random.choice(EVENT_TYPES)
+        rel    = next((c for c in creatures if c["name"]==actor), {}).get(
+                     "relationship_scores", {}).get(target, 50)
+
+        prompts = {
+            "trade":     f"Propose a trade with {target} (relationship {rel}/100). Be specific about what you're offering.",
+            "gossip":    f"Share gossip about {target} (relationship {rel}/100). Make it wonderfully absurd.",
+            "feud":      f"Describe your current feud with {target} (relationship {rel}/100). It must be about something trivial.",
+            "invention": f"You've invented something that involves {target} somehow. Describe your invention.",
+            "discovery": f"You've discovered something surprising about {target} or near them. What did you find?",
+            "ceremony":  f"You're organising a ceremony and {target} must be involved. Describe it.",
+        }
+        agent_prompt = prompts[etype]
+        if combined_ctx: agent_prompt += f"\n\nWorld context: {combined_ctx}"
+
+        description = call_agent(actor, agent_prompt)
+        if not description or len(description) < 8:
+            description = f"{actor.capitalize()} had a {etype} with {target}."
+
+        event_records.append({"actor":actor,"action":etype,"target":target,"description":description})
+        database.save_event(day_number, actor, etype, target, description)
+
+        # ── Update relationships ──────────────────────────────────
+        delta = REL_DELTAS.get(etype, 0)
+        creatures = database.get_all_creatures()
+        for c in creatures:
+            if c["name"] == actor:
+                sc = c["relationship_scores"]
+                sc[target] = max(0, min(100, sc.get(target,50) + delta))
+                database.update_creature(actor, relationship_scores=sc)
+            if c["name"] == target:
+                sc = c["relationship_scores"]
+                sc[actor] = max(0, min(100, sc.get(actor,50) + delta//2))
+                database.update_creature(target, relationship_scores=sc)
+        creatures = database.get_all_creatures()
+
+    # ── Generate newspaper ────────────────────────────────────────
+    events_summary = "\n".join(
+        f"- {e['actor'].capitalize()} [{e['action']}] with {e['target']}: {e['description']}"
+        for e in event_records
+    )
+    extra = ""
+    if combined_ctx: extra += f"\nWorld context: {combined_ctx}"
+    if past_hl:      extra += f"\n{past_hl}"
+
+    raw_paper = _generate(
+        NARRATOR_PROMPT,
+        f"Today's events:\n{events_summary}{extra}",
+        max_new_tokens=300,
+    )
+    if not raw_paper:
+        raw_paper = (
+            f"CHAOS REIGNS IN TINYWICK HOLLOW ON DAY {day_number}\n\n"
+            "The printing press has momentarily jammed. However, our sources confirm "
+            "that things definitely happened today.\n\n"
+            "WEATHER: Unclear, like everything else.\n"
+            f"FOX: {event_records[0]['description'][:60]}\n"
+            f"BADGER: {event_records[1]['description'][:60]}\n"
+            f"SQUIRREL: {event_records[2]['description'][:60]}\n"
+            "MOLE: Something underground."
+        )
+
+    parsed = _parse_newspaper_full(raw_paper, day_number)
+    classified = random.choice(CLASSIFIEDS)
+
+    full_text = "\n\n".join([
+        parsed["headline"],
+        parsed["article"],
+        f"WEATHER: {parsed['weather']}",
+        "\n".join(f"{c.upper()}: {t}" for c, t in parsed["briefs"].items()),
+        f"CLASSIFIEDS: {classified}",
+    ])
+
+    database.save_day(day_number, parsed["headline"], full_text)
+    return day_number, parsed, classified
+
+
+# ═══════════════════════════════════════════════════════════════════
+# 5 ▸ ZERОГPU WRAPPER
+# ═══════════════════════════════════════════════════════════════════
+@spaces.GPU(duration=120)
+def advance_day(nudge_type=None, nudge_value=None, nudge_target=None):
+    """Public GPU entry point — 1.5B model needs ≤60s on T4."""
+    return _run_simulation_step(nudge_type, nudge_value, nudge_target)
+
+
+# ═══════════════════════════════════════════════════════════════════
+# 6 ▸ PIL NEWSPAPER IMAGE  (enhanced)
+# ═══════════════════════════════════════════════════════════════════
+_SERIF_B = ["/usr/share/fonts/truetype/liberation/LiberationSerif-Bold.ttf",
+            "/usr/share/fonts/truetype/dejavu/DejaVuSerif-Bold.ttf"]
+_SERIF_R = ["/usr/share/fonts/truetype/liberation/LiberationSerif-Regular.ttf",
+            "/usr/share/fonts/truetype/dejavu/DejaVuSerif.ttf"]
+
+def _tf(paths, sz):
+    for p in paths:
+        try: return ImageFont.truetype(p, sz)
+        except: pass
+    return ImageFont.load_default()
+
+def render_newspaper_image(parsed: dict, classified: str, day_number: int) -> str:
+    W, H = 960, 720
+    PAPER=(245,232,200); INK=(20,8,2); BORDER=(70,40,8); SUBINK=(90,55,25); GREY=(130,100,70)
+
+    img = Image.new("RGB",(W,H),PAPER)
+    d   = ImageDraw.Draw(img)
+
+    f_mast  = _tf(_SERIF_B, 30);  f_hed  = _tf(_SERIF_B, 20)
+    f_body  = _tf(_SERIF_R, 12);  f_sm   = _tf(_SERIF_R, 10)
+    f_sub   = _tf(_SERIF_R, 11);  f_bold = _tf(_SERIF_B, 12)
+
+    M = 18
+    d.rectangle([M,M,W-M,H-M], outline=BORDER, width=3)
+    d.rectangle([M+6,M+6,W-M-6,H-M-6], outline=BORDER, width=1)
+
+    y = M + 14
+    # Masthead
+    mast = "THE TINYWICK HOLLOW GAZETTE"
+    bb = d.textbbox((0,0),mast,font=f_mast); tw=bb[2]-bb[0]
+    d.text(((W-tw)/2, y), mast, fill=INK, font=f_mast); y += bb[3]-bb[1]+3
+    # Sub
+    sub = f"Est. Day 1  ✦  Day {day_number}  ✦  One Acorn  ✦  Woodland Readers Only"
+    bb=d.textbbox((0,0),sub,font=f_sm); d.text(((W-(bb[2]-bb[0]))/2,y),sub,fill=SUBINK,font=f_sm)
+    y+=bb[3]-bb[1]+5
+    # Weather strip
+    wx = parsed.get("weather","Overcast.")
+    wx_line = f"☁ WEATHER: {wx}"
+    bb=d.textbbox((0,0),wx_line,font=f_sm); d.text(((W-(bb[2]-bb[0]))/2,y),wx_line,fill=GREY,font=f_sm)
+    y+=bb[3]-bb[1]+4
+    d.line([M+10,y,W-M-10,y],fill=BORDER,width=2)
+    d.line([M+10,y+4,W-M-10,y+4],fill=BORDER,width=1); y+=14
+
+    # Headline
+    for line in textwrap.wrap(parsed.get("headline",""),width=50):
+        bb=d.textbbox((0,0),line,font=f_hed); d.text(((W-(bb[2]-bb[0]))/2,y),line,fill=INK,font=f_hed)
+        y+=bb[3]-bb[1]+2
+    y+=4; d.line([M+10,y,W-M-10,y],fill=BORDER,width=1); y+=10
+
+    # Two-column article + sidebar
+    PAD=M+12; COL_GAP=24; SIDE_W=220
+    main_w = W - 2*PAD - COL_GAP - SIDE_W
+    half_w = (main_w-COL_GAP)//2
+    col1_x=PAD; col2_x=PAD+half_w+COL_GAP; side_x=PAD+main_w+COL_GAP
+    LH=15; MAX_Y=H-M-50; art_y=y
+
+    art_lines = textwrap.wrap(parsed.get("article",""), width=38)
+    mid = max(1,len(art_lines)//2)
+    ly=art_y
+    for line in art_lines[:mid]:
+        if ly+LH>MAX_Y: break
+        d.text((col1_x,ly),line,fill=INK,font=f_body); ly+=LH
+    d.line([col1_x+half_w+COL_GAP//2,art_y,col1_x+half_w+COL_GAP//2,min(ly,MAX_Y)],fill=GREY,width=1)
+    ry=art_y
+    for line in art_lines[mid:]:
+        if ry+LH>MAX_Y: break
+        d.text((col2_x,ry),line,fill=INK,font=f_body); ry+=LH
+
+    # Sidebar: In Brief
+    d.line([side_x-8,art_y,side_x-8,MAX_Y],fill=BORDER,width=1)
+    sy=art_y
+    d.text((side_x,sy),"IN BRIEF",fill=INK,font=f_bold); sy+=16
+    d.line([side_x,sy,W-M-14,sy],fill=GREY,width=1); sy+=6
+    briefs = parsed.get("briefs",{})
+    for cname in CREATURES:
+        em=CREATURE_EMOJI.get(cname,"?"); txt=briefs.get(cname,"")
+        header=f"{em} {cname.upper()}"
+        d.text((side_x,sy),header,fill=INK,font=f_bold); sy+=13
+        for bline in textwrap.wrap(txt,width=26):
+            if sy+12>MAX_Y: break
+            d.text((side_x,sy),bline,fill=INK,font=f_sm); sy+=12
+        sy+=4
+
+    # Classifieds footer
+    fy=H-M-38; d.line([M+10,fy,W-M-10,fy],fill=BORDER,width=1); fy+=4
+    d.text((M+14,fy),"CLASSIFIEDS",fill=INK,font=f_bold); fy+=14
+    for cl in textwrap.wrap(classified,width=100):
+        if fy+12>H-M-8: break
+        d.text((M+14,fy),cl,fill=INK,font=f_sm); fy+=12
+
+    path=f"/tmp/tinywick_day_{day_number}.png"
+    img.save(path,"PNG")
+    return path
+
+
+# ═══════════════════════════════════════════════════════════════════
+# 7 ▸ AGENT TRACE EXPORT  (📡 Sharing is Caring badge)
+# ═══════════════════════════════════════════════════════════════════
+def export_agent_traces() -> str:
+    """Export all simulation events as JSON for the HF dataset."""
+    creatures = database.get_all_creatures()
+    trace = {
+        "meta": {
+            "project": "Tiny Civilization — The Tinywick Hollow Gazette",
+            "model": _model_id_used,
+            "exported_at": datetime.now().isoformat(),
+        },
+        "agent_prompts": AGENT_PROMPTS,
+        "narrator_prompt": NARRATOR_PROMPT,
+        "creature_state": creatures,
+        "events": [],
+        "days": [],
+    }
+    headlines = database.get_all_headlines()
+    for dn, _ in reversed(headlines):
+        day = database.get_day(dn)
+        if day: trace["days"].append(dict(day))
+        evts = database.get_events_for_day(dn)
+        trace["events"].extend([{"day": dn, **e} for e in evts])
+    path = "/tmp/tiny_civ_traces.json"
+    with open(path,"w") as f: json.dump(trace, f, indent=2, default=str)
+    return path
+
+
+# ═══════════════════════════════════════════════════════════════════
+# 8 ▸ CSS  (heavy newspaper polish for Off-Brand badge)
+# ═══════════════════════════════════════════════════════════════════
+NEWSPAPER_CSS = """
+@import url('https://fonts.googleapis.com/css2?family=Playfair+Display:ital,wght@0,400;0,700;0,900;1,400&family=Libre+Baskerville:ital,wght@0,400;0,700;1,400&family=UnifrakturMaguntia&display=swap');
+
+body, .gradio-container { background: #c4b090 !important; }
+
+/* ── Newspaper wrapper ── */
+.paper-wrap {
+    background: #f6ead0;
+    background-image: repeating-linear-gradient(0deg,transparent,transparent 21px,rgba(150,110,60,.07) 22px);
+    border: 3px solid #4a2a08; border-radius:1px;
+    padding: 20px 26px 16px;
+    box-shadow: 6px 6px 28px rgba(0,0,0,.35), inset 0 0 100px rgba(180,140,80,.15);
+    margin: 6px 0; position: relative;
+}
+.paper-wrap::before {
+    content:""; display:block; border:1px solid #4a2a08;
+    position:absolute; inset:7px; pointer-events:none;
+}
+
+/* ── Masthead ── */
+.paper-masthead {
+    font-family:'UnifrakturMaguntia','Playfair Display',Georgia,serif;
+    font-size:2.4em; text-align:center; color:#160800;
+    border-top:5px double #4a2a08; border-bottom:5px double #4a2a08;
+    padding:5px 0; margin-bottom:3px; letter-spacing:1px;
+}
+.paper-sub { font-family:'Libre Baskerville',Georgia,serif; font-size:.72em; color:#5a3615;
+    text-align:center; font-style:italic; margin-bottom:2px; }
+.paper-weather { font-family:'Libre Baskerville',Georgia,serif; font-size:.75em; color:#7a5630;
+    text-align:center; margin-bottom:6px; letter-spacing:.5px; }
+.paper-rule { border:none; border-top:2px solid #4a2a08; margin:3px 0 6px; }
+.paper-rule-thin { border:none; border-top:1px solid #9a7040; margin:3px 0; }
+
+/* ── Headline ── */
+.paper-headline {
+    font-family:'Playfair Display',Georgia,serif; font-size:1.85em; font-weight:900;
+    text-align:center; text-transform:uppercase; color:#0c0400;
+    line-height:1.12; margin:6px 0 8px;
+}
+
+/* ── Body row: article + sidebar ── */
+.paper-body-row { display:flex; gap:0; }
+.paper-article-cols {
+    flex:1; font-family:'Libre Baskerville',Georgia,serif; font-size:.88em;
+    color:#180a02; line-height:1.75; text-align:justify;
+    column-count:2; column-gap:24px; column-rule:1px solid #9a7040;
+    padding:4px 0;
+}
+.paper-sidebar {
+    width:210px; min-width:190px; padding:0 0 0 16px;
+    border-left:2px solid #4a2a08; margin-left:16px;
+}
+.sidebar-title {
+    font-family:'Playfair Display',Georgia,serif; font-weight:700; font-size:.85em;
+    text-transform:uppercase; letter-spacing:1px; color:#160800;
+    border-bottom:1px solid #9a7040; padding-bottom:3px; margin-bottom:6px;
+}
+.sidebar-item { margin-bottom:8px; }
+.sidebar-creature-name {
+    font-family:'Libre Baskerville',Georgia,serif; font-weight:700; font-size:.78em; color:#2a1008;
+}
+.sidebar-creature-text {
+    font-family:'Libre Baskerville',Georgia,serif; font-size:.74em; color:#3a1c08;
+    line-height:1.45; font-style:italic;
+}
+
+/* ── Classifieds ── */
+.paper-classifieds {
+    font-family:'Libre Baskerville',Georgia,serif; font-size:.75em; color:#5a3615;
+    border-top:1px solid #9a7040; margin-top:8px; padding-top:5px; font-style:italic;
+}
+.paper-classifieds span { font-weight:700; font-style:normal; color:#2a1008; }
+
+/* ── Day badge ── */
+.paper-daybadge {
+    font-family:'Libre Baskerville',Georgia,serif; font-size:.75em; color:#5a3615;
+    text-align:center; border-top:1px solid #9a7040; margin-top:8px; padding-top:5px;
+}
+
+/* ── Status strip ── */
+.status-strip {
+    background:#d6c4a0; border:1px solid #8a6030; border-radius:3px;
+    padding:5px 12px; font-family:'Libre Baskerville',Georgia,serif;
+    font-size:.82em; color:#2a1008; text-align:center; margin:4px 0;
+}
+
+/* ── Creature cards ── */
+.creature-grid { display:flex; gap:8px; flex-wrap:wrap; }
+.creature-card {
+    background:#f8ecd8; border:1px solid #9a7040; border-radius:2px;
+    padding:10px 13px; font-family:'Libre Baskerville',Georgia,serif;
+    font-size:.8em; color:#180a02; flex:1; min-width:155px;
+}
+.creature-name { font-weight:700; font-size:.95em; color:#260e04; display:block; margin-bottom:3px; }
+.creature-tier { font-style:italic; color:#7a5030; font-size:.85em; }
+
+/* ── Civ stats ── */
+.civ-stats {
+    background:#e8d4b0; border:1px solid #9a7040; border-radius:2px;
+    padding:8px 14px; font-family:'Libre Baskerville',Georgia,serif;
+    font-size:.78em; color:#2a1008; display:flex; gap:14px; flex-wrap:wrap;
+    justify-content:center; margin:6px 0;
+}
+.stat-item { text-align:center; }
+.stat-label { font-size:.85em; color:#7a5030; display:block; }
+.stat-value { font-weight:700; font-size:1.05em; color:#160800; }
+
+/* ── Section titles ── */
+.section-title {
+    font-family:'Playfair Display',Georgia,serif; font-weight:700;
+    color:#160800; font-size:.95em; text-transform:uppercase;
+    letter-spacing:1px; text-align:center;
+    border-bottom:1px solid #8a6030; padding-bottom:3px; margin:8px 0 8px;
+}
+.archive-area { background:#f0e4c6; border:1px solid #9a7040; border-radius:2px;
+    padding:10px; margin-top:5px; min-height:50px; }
+
+/* ── Konami modal ── */
+#konami-backdrop { display:none; position:fixed; inset:0; background:rgba(0,0,0,.5); z-index:99998; }
+#konami-modal {
+    display:none; position:fixed; z-index:99999; top:50%; left:50%;
+    transform:translate(-50%,-50%); width:min(660px,92vw); max-height:76vh; overflow-y:auto;
+    background:#f6ead0; border:3px solid #4a2a08; box-shadow:10px 10px 40px rgba(0,0,0,.6);
+    padding:22px 26px 18px; font-family:'Libre Baskerville',Georgia,serif;
+}
+#konami-modal h2 { font-family:'Playfair Display',Georgia,serif; color:#160800; margin:0 0 10px; }
+#konami-modal details { margin:6px 0; }
+#konami-modal summary { cursor:pointer; font-weight:700; color:#4a2a08; }
+#konami-modal pre { background:#e8d4b0; border:1px solid #9a7040; padding:8px;
+    font-size:.76em; white-space:pre-wrap; border-radius:2px; margin:5px 0 0; }
+#konami-close { position:absolute; top:8px; right:12px; cursor:pointer;
+    font-size:1.3em; color:#4a2a08; background:none; border:none; }
+"""
+
+# ═══════════════════════════════════════════════════════════════════
+# 9 ▸ JAVASCRIPT
+# ════════════════════════════════════════════════════════════════���══
+KONAMI_JS = """<script>
+(function(){
+  var SEQ=['ArrowUp','ArrowUp','ArrowDown','ArrowDown',
+           'ArrowLeft','ArrowRight','ArrowLeft','ArrowRight','b','a'];
+  var idx=0;
+  document.addEventListener('keydown',function(e){
+    if(e.key===SEQ[idx]){idx++;if(idx===SEQ.length){idx=0;showKonami();}}
+    else{idx=(e.key===SEQ[0])?1:0;}
+  });
+  window.showKonami=function(){
+    document.getElementById('konami-backdrop').style.display='block';
+    document.getElementById('konami-modal').style.display='block';
+  };
+  window.hideKonami=function(){
+    document.getElementById('konami-backdrop').style.display='none';
+    document.getElementById('konami-modal').style.display='none';
+  };
+})();
+</script>"""
+
+
+# ═══════════════════════════════════════════════════════════════════
+# 10 ▸ HTML FORMATTERS
+# ═══════════════════════════════════════════════════════════════════
+def _rel_tier(score: int) -> tuple[str, str]:
+    for lo, hi, label, icon in REL_TIERS:
+        if lo <= score <= hi: return label, icon
+    return "Unknown", "?"
+
+def _html_paper(parsed: dict, classified: str, day_num: int) -> str:
+    hed   = (parsed.get("headline","") or "").replace("<","&lt;")
+    art   = (parsed.get("article","")  or "").replace("<","&lt;")
+    wx    = (parsed.get("weather","")  or "").replace("<","&lt;")
+    briefs = parsed.get("briefs",{})
+    emojis = "  ".join(f"{CREATURE_EMOJI[c]} {c.capitalize()}" for c in CREATURES)
+    classified_esc = classified.replace("<","&lt;")
+
+    sidebar_items = ""
+    for c in CREATURES:
+        em  = CREATURE_EMOJI.get(c,"?")
+        txt = (briefs.get(c,"") or "").replace("<","&lt;")
+        sidebar_items += f"""
+<div class="sidebar-item">
+  <div class="sidebar-creature-name">{em} {c.upper()}</div>
+  <div class="sidebar-creature-text">{txt}</div>
+</div>"""
+
+    return f"""
+<div class="paper-wrap">
+  <div class="paper-masthead">The Tinywick Hollow Gazette</div>
+  <div class="paper-sub">Est. Day&nbsp;1 ✦ Day&nbsp;{day_num} ✦ One Acorn Per Copy ✦ Serving the Woodland Since the Beginning</div>
+  <div class="paper-weather">☁&nbsp;{wx}</div>
+  <hr class="paper-rule">
+  <div class="paper-headline">{hed}</div>
+  <hr class="paper-rule-thin">
+  <div class="paper-body-row">
+    <div class="paper-article-cols">{art}</div>
+    <div class="paper-sidebar">
+      <div class="sidebar-title">In Brief</div>
+      {sidebar_items}
+    </div>
+  </div>
+  <div class="paper-classifieds"><span>CLASSIFIEDS:</span> {classified_esc}</div>
+  <div class="paper-daybadge">— Day {day_num} —&nbsp;&nbsp; {emojis}</div>
+</div>
+"""
+
+def _html_placeholder() -> str:
+    founding = database.get_day(0)
+    if founding:
+        text  = founding["full_newspaper_text"]
+        parts = text.split("\n\n",1)
+        hed   = parts[0]; art = parts[1] if len(parts)>1 else text
+        dummy_parsed = {
+            "headline": hed, "article": art,
+            "weather": "Portentous, with scattered significance.",
+            "briefs": {
+                "fox": "Forged three certificates before breakfast.",
+                "badger": "Insisted on thirteen amendments before lunch.",
+                "squirrel": "Invented a signing machine! It signed the wrong document!",
+                "mole": "Something is already happening underground.",
+            }
+        }
+        return _html_paper(dummy_parsed, "NOTICE: Civilisation now in progress.", 0)
+    return """<div class="paper-wrap">
+  <div class="paper-masthead">The Tinywick Hollow Gazette</div>
+  <hr class="paper-rule">
+  <div class="paper-headline">AWAITING FIRST LIGHT IN TINYWICK HOLLOW</div>
+  <hr class="paper-rule-thin">
+  <div class="paper-article-cols">Press <em>Advance Day</em> to begin the chronicle.</div>
+  <div class="paper-daybadge">— Day 0 —</div>
+</div>"""
+
+def _html_creatures() -> str:
+    creatures = database.get_all_creatures()
+    cards = ""
+    for c in creatures:
+        em   = CREATURE_EMOJI.get(c["name"],"?")
+        inv  = (", ".join(c["inventory"][:3]) + ("…" if len(c["inventory"])>3 else "")) or "nothing"
+        rels = ""
+        for other, score in sorted(c["relationship_scores"].items()):
+            label, icon = _rel_tier(score)
+            rels += f'<span title="{label} ({score})">{CREATURE_EMOJI.get(other,"?")} {icon}</span> '
+        cards += f"""<div class="creature-card">
+  <span class="creature-name">{em} {c['name'].capitalize()}</span>
+  <div class="creature-tier">{rels}</div>
+  <div style="font-size:.78em;margin-top:3px;color:#5a3615;"><em>Carries:</em> {inv}</div>
+</div>"""
+    return f'<div class="creature-grid">{cards}</div>'
+
+def _html_civ_stats() -> str:
+    s = database.get_civ_stats()
+    bp  = s["best_pair"];  wp = s["worst_pair"]
+    dom = s["dominant"].capitalize()
+    return f"""<div class="civ-stats">
+  <div class="stat-item"><span class="stat-label">Days</span><span class="stat-value">{s['total_days']}</span></div>
+  <div class="stat-item"><span class="stat-label">Events</span><span class="stat-value">{s['total_events']}</span></div>
+  <div class="stat-item"><span class="stat-label">Nudges</span><span class="stat-value">{s['total_nudges']}</span></div>
+  <div class="stat-item"><span class="stat-label">Strongest bond</span>
+    <span class="stat-value">{bp[0].capitalize()} &amp; {bp[1].capitalize()} ({bp[2]})</span></div>
+  <div class="stat-item"><span class="stat-label">Bitterest feud</span>
+    <span class="stat-value">{wp[0].capitalize()} vs {wp[1].capitalize()} ({wp[2]})</span></div>
+  <div class="stat-item"><span class="stat-label">Most popular</span><span class="stat-value">{dom}</span></div>
+</div>"""
+
+def _archive_choices():
+    hl = database.get_all_headlines()
+    return [(f"Day {dn}: {h[:44]}{'…' if len(h)>44 else ''}", dn) for dn,h in hl] or []
+
+def _status(msg): return f'<div class="status-strip">{msg}</div>'
+
+def _konami_html() -> str:
+    import html as _h
+    details = "".join(
+        f"<details><summary>{CREATURE_EMOJI.get(n,'')}<strong> {n.upper()}</strong></summary>"
+        f"<pre>{_h.escape(p)}</pre></details>"
+        for n,p in AGENT_PROMPTS.items()
+    )
+    details += f"<details><summary>📰 <strong>NARRATOR</strong></summary><pre>{_h.escape(NARRATOR_PROMPT)}</pre></details>"
+    return f"""
+<div id="konami-backdrop" onclick="hideKonami()"></div>
+<div id="konami-modal" role="dialog">
+  <button id="konami-close" onclick="hideKonami()">✕</button>
+  <h2>🔮 Secret Agent Briefing</h2>
+  <p>Konami Code found! Here are the raw system prompts driving our correspondents:</p>
+  {details}
+  <p style="text-align:center;font-style:italic;color:#5a3615;font-size:.84em;margin-top:14px;">
+    ↑↑↓↓←→←→BA — only the woodland elite know this. 🎮</p>
+</div>{KONAMI_JS}"""
+
+
+# ═══════════════════════════════════════════════════════════════════
+# 11 ▸ GRADIO EVENT HANDLERS
+# ═══════════════════════════════════════════════════════════════════
+def _render_all(day_num, parsed, classified, status_msg):
+    return (
+        _html_paper(parsed, classified, day_num),
+        _html_creatures(),
+        _html_civ_stats(),
+        gr.update(choices=_archive_choices(), value=None),
+        _status(status_msg),
+        day_num, parsed, classified,
+    )
+
+def _safe_advance(nudge_type=None, nudge_value=None, nudge_target=None):
+    try:
+        day_num, parsed, classified = advance_day(nudge_type, nudge_value, nudge_target)
+        model_tag = f" [{_model_id_used.split('/')[-1]}]" if _model_id_used!="none" else ""
+        return _render_all(day_num, parsed, classified,
+            f"✓ Day {day_num} published to the Gazette.{model_tag}")
+    except Exception:
+        tb = traceback.format_exc()
+        print(tb)
+        err_parsed = {
+            "headline": "THE GAZETTE'S PRINTING PRESS HAS JAMMED",
+            "article": "Our correspondents report a technical malfunction. The editor is inconsolable. "
+                       "Beatrice Badger suspects sabotage. Reginald Fox denies everything.",
+            "weather": "Stormy, with a chance of errors.",
+            "briefs": {c: "Unavailable for comment." for c in CREATURES},
+        }
+        return _render_all(0, err_parsed, "LOST: One functioning simulation. — The Editor",
+            "✗ Simulation error — the printing press is jammed. Check logs.")
+
+def handle_advance():      return _safe_advance()
+def handle_rumour(c,r):    return _safe_advance("rumour",r,c)
+def handle_donation(o):    return _safe_advance("donation",o)
+def handle_law(l):         return _safe_advance("law",l)
+
+def handle_archive_view(day_num):
+    if day_num is None:
+        return '<div class="archive-area"><em>Select a day to read its edition.</em></div>'
+    day = database.get_day(int(day_num))
+    if not day: return '<div class="archive-area"><em>Edition not found.</em></div>'
+    txt = day["full_newspaper_text"]; parts = txt.split("\n\n",1)
+    hed = parts[0]; art = parts[1] if len(parts)>1 else txt
+    # Reconstruct parsed from stored text
+    parsed = _parse_newspaper_full(txt, day_num)
+    classified_match = re.search(r"CLASSIFIEDS:\s*(.+)", txt)
+    cl = classified_match.group(1) if classified_match else random.choice(CLASSIFIEDS)
+    return f'<div class="archive-area">{_html_paper(parsed, cl, day_num)}</div>'
+
+def handle_share(day_num_state, parsed_state, classified_state):
+    if not parsed_state or not parsed_state.get("headline"): return gr.update(visible=False)
+    try:
+        path = render_newspaper_image(parsed_state, classified_state or "", day_num_state or 0)
+        return gr.update(visible=True, value=path)
+    except Exception: return gr.update(visible=False)
+
+def handle_export_traces():
+    try:
+        path = export_agent_traces()
+        return gr.update(visible=True, value=path)
+    except Exception: return gr.update(visible=False)
+
+
+# =================================================================
+# 12 ▸ GRADIO BLOCKS
+# =================================================================
+
+# -- Startup: init DB, load latest state --------------------------
+database.init_db()
+_latest = database.get_latest_day()
+if _latest:
+    _INIT_DAY    = _latest["day_number"]
+    _INIT_PARSED = _parse_newspaper_full(_latest["full_newspaper_text"], _INIT_DAY)
+    _cl_m        = re.search(r"CLASSIFIEDS:\s*(.+)", _latest["full_newspaper_text"])
+    _INIT_CL     = _cl_m.group(1) if _cl_m else random.choice(CLASSIFIEDS)
+else:
+    _INIT_DAY = 0; _INIT_PARSED = {}; _INIT_CL = ""
+
+# -- Gradio version-aware css/theme routing -----------------------
+_GR_MAJOR = int(gr.__version__.split(".")[0])
+if   _GR_MAJOR >= 6: _BKW: dict = {};                              _LKW: dict = {"css": NEWSPAPER_CSS}
+elif _GR_MAJOR >= 5: _BKW = {"css": NEWSPAPER_CSS};              _LKW = {}
+else:                _BKW = {"css": NEWSPAPER_CSS, "theme": gr.themes.Base(primary_hue="orange", neutral_hue="stone")}; _LKW = {}
+
+# ------------------------------------------------------------------
+with gr.Blocks(title="Tiny Civilization — The Tinywick Hollow Gazette", **_BKW) as demo:
+
+    gr.HTML(_konami_html())
+
+    gr.HTML(
+        '<div style="text-align:center;padding:8px 0 2px;">'
+        '<h1 style="font-family:\'Playfair Display\',Georgia,serif;color:#160800;font-size:1.9em;margin:0 0 2px;">'
+        '🦊 Tiny Civilization 🐀</h1>'
+        '<p style="font-family:Georgia,serif;color:#5a3615;font-style:italic;margin:0;font-size:.87em;">'
+        'A persistent woodland civilisation. One day. One acorn. One absurd headline at a time.'
+        '&nbsp;|&nbsp;<kbd title="Konami Code">↑↑↓↓←→←→BA</kbd> for secrets.'
+        '</p></div>'
+    )
+
+    day_state     = gr.State(_INIT_DAY)
+    parsed_state  = gr.State(_INIT_PARSED)
+    classif_state = gr.State(_INIT_CL)
+
+    status_html    = gr.HTML(value=_status(
+        f"Day {_INIT_DAY} in the archive — next: Day {_INIT_DAY + 1}."
+        if _INIT_DAY >= 0 else "No days yet. Press Advance Day to begin."))
+    civ_stats_html = gr.HTML(value=_html_civ_stats())
+
+    with gr.Row(equal_height=False):
+
+        with gr.Column(scale=3):
+            newspaper_display = gr.HTML(
+                value=(_html_paper(_INIT_PARSED, _INIT_CL, _INIT_DAY)
+                       if _INIT_PARSED else _html_placeholder()))
+
+            with gr.Accordion('📜 Archive — Past Editions', open=False):
+                archive_dd = gr.Dropdown(
+                    choices=_archive_choices(), value=None,
+                    label='Select a past day', container=False)
+                archive_display = gr.HTML(
+                    value='<div class="archive-area"><em>Select a day to read its edition.</em></div>')
+
+        with gr.Column(scale=1, min_width=260):
+            gr.HTML('<div class="section-title">📰 Editorial Desk</div>')
+            advance_btn = gr.Button('📅 Advance Day  (no nudge)', variant='primary', size='lg')
+
+            gr.HTML('<hr style="border-color:#8a6030;margin:8px 0;">')
+            gr.HTML('<div class="section-title">✉ Nudge the Story</div>')
+            gr.HTML('<p style="font-size:.78em;color:#5a3615;text-align:center;'
+                    'font-style:italic;margin:0 0 6px;">Each nudge advances one day.</p>')
+
+            with gr.Accordion('🗣️ Spread a Rumour', open=False):
+                rumour_creature = gr.Dropdown(choices=CREATURES, value=CREATURES[0],
+                                              label='About which creature?')
+                rumour_type_dd  = gr.Dropdown(choices=RUMOUR_TYPES, value=RUMOUR_TYPES[0],
+                                              label='What rumour?')
+                rumour_btn      = gr.Button('📢 Spread It', variant='secondary')
+
+            with gr.Accordion('🎁 Donate a Weird Object', open=False):
+                donation_dd  = gr.Dropdown(choices=WEIRD_OBJECTS, value=WEIRD_OBJECTS[0],
+                                           label='Which object?')
+                donation_btn = gr.Button('🎁 Donate It', variant='secondary')
+
+            with gr.Accordion('⚖️ Propose a New Law', open=False):
+                law_dd  = gr.Dropdown(choices=LAWS, value=LAWS[0], label='Which law?')
+                law_btn = gr.Button('⚖️ Propose It', variant='secondary')
+
+            gr.HTML('<hr style="border-color:#8a6030;margin:8px 0;">')
+            share_btn    = gr.Button('🖼️ Share as Image', variant='secondary')
+            img_output   = gr.Image(label='Front Page PNG', visible=False, type='filepath')
+            export_btn   = gr.Button('📡 Export Agent Traces (JSON)', variant='secondary')
+            trace_output = gr.File(label='Agent Traces JSON', visible=False)
+
+            gr.HTML('<p style="font-size:.70em;color:#6a4818;text-align:center;'
+                    'margin-top:8px;font-style:italic;">'
+                    'Model: Qwen2.5-1.5B ≤4B 🐜&nbsp;|&nbsp;Local only 🔌&nbsp;|&nbsp;Custom UI 🎨</p>')
+
+    gr.HTML('<div class="section-title" style="margin-top:12px;">Woodland Residents</div>')
+    creature_display = gr.HTML(value=_html_creatures())
+
+    _OUT = [newspaper_display, creature_display, civ_stats_html,
+            archive_dd, status_html, day_state, parsed_state, classif_state]
+
+    advance_btn.click( fn=handle_advance,   inputs=[],                                outputs=_OUT)
+    rumour_btn.click(  fn=handle_rumour,    inputs=[rumour_creature, rumour_type_dd], outputs=_OUT)
+    donation_btn.click(fn=handle_donation,  inputs=[donation_dd],                    outputs=_OUT)
+    law_btn.click(     fn=handle_law,       inputs=[law_dd],                         outputs=_OUT)
+    archive_dd.change( fn=handle_archive_view, inputs=[archive_dd], outputs=[archive_display])
+    share_btn.click(   fn=handle_share,    inputs=[day_state, parsed_state, classif_state], outputs=[img_output])
+    export_btn.click(  fn=handle_export_traces, inputs=[], outputs=[trace_output])
+
+# ═══════════════════════════════════════════════════════════════════
+# 13 ▸ ENTRY POINT
+# ═══════════════════════════════════════════════════════════════════
+if __name__ == "__main__":
+    demo.launch(server_name="0.0.0.0", server_port=7860, **_LKW)

database.py

@@ -0,0 +1,237 @@
+"""
+database.py — Tiny Civilization persistent storage layer.
+SQLite-backed, safe for concurrent Gradio calls.
+"""
+import sqlite3
+import json
+import os
+from datetime import datetime
+from typing import Optional
+
+# ── DB path: prefer HF /data (persistent volume), fallback to cwd ──
+_DATA_DIRS = ["/data", "."]
+DB_PATH = os.getenv("TINY_DB_PATH", "")
+if not DB_PATH:
+    for _d in _DATA_DIRS:
+        try:
+            os.makedirs(_d, exist_ok=True)
+            _t = os.path.join(_d, ".wtest"); open(_t,"w").write("ok"); os.remove(_t)
+            DB_PATH = os.path.join(_d, "tiny_civilization.db"); break
+        except Exception: continue
+    if not DB_PATH: DB_PATH = "tiny_civilization.db"
+
+
+def _conn() -> sqlite3.Connection:
+    c = sqlite3.connect(DB_PATH, check_same_thread=False, timeout=10)
+    c.row_factory = sqlite3.Row
+    return c
+
+
+# ─────────────────────────────────────────────────────────────────
+# Schema + seed
+# ─────────────────────────────────────────────────────────────────
+def init_db() -> None:
+    with _conn() as con:
+        cur = con.cursor()
+        cur.execute("""CREATE TABLE IF NOT EXISTS days (
+            day_number INTEGER PRIMARY KEY,
+            headline TEXT NOT NULL,
+            full_newspaper_text TEXT NOT NULL,
+            timestamp TEXT NOT NULL
+        )""")
+        cur.execute("""CREATE TABLE IF NOT EXISTS events (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            day_number INTEGER NOT NULL,
+            actor TEXT NOT NULL,
+            action TEXT NOT NULL,
+            target TEXT NOT NULL,
+            description TEXT NOT NULL
+        )""")
+        cur.execute("""CREATE TABLE IF NOT EXISTS creatures (
+            name TEXT PRIMARY KEY,
+            relationship_scores TEXT NOT NULL DEFAULT '{}',
+            inventory TEXT NOT NULL DEFAULT '[]'
+        )""")
+        cur.execute("""CREATE TABLE IF NOT EXISTS nudges (
+            id INTEGER PRIMARY KEY AUTOINCREMENT,
+            day_number INTEGER NOT NULL,
+            nudge_type TEXT NOT NULL,
+            nudge_value TEXT NOT NULL
+        )""")
+        con.commit()
+
+        # ── Seed creatures ─────────────────────────────────────────
+        _SEED = {
+            "fox": {
+                "relationships": {"badger": 42, "squirrel": 61, "mole": 55},
+                "inventory": ["forged certificate of merit", "silk scarf (dubious origin)"],
+            },
+            "badger": {
+                "relationships": {"fox": 28, "squirrel": 67, "mole": 72},
+                "inventory": ["ancient grudge (well-preserved)", "favourite grey stone"],
+            },
+            "squirrel": {
+                "relationships": {"fox": 63, "badger": 70, "mole": 48},
+                "inventory": ["seven-and-a-half acorns", "borrowed umbrella (decade old)"],
+            },
+            "mole": {
+                "relationships": {"fox": 51, "badger": 76, "squirrel": 53},
+                "inventory": ["map of secret tunnels", "crystal monocle", "lost button"],
+            },
+        }
+        for name, data in _SEED.items():
+            if not cur.execute("SELECT 1 FROM creatures WHERE name=?", (name,)).fetchone():
+                cur.execute(
+                    "INSERT INTO creatures (name,relationship_scores,inventory) VALUES (?,?,?)",
+                    (name, json.dumps(data["relationships"]), json.dumps(data["inventory"])),
+                )
+        con.commit()
+
+        # ── Seed Day 0: the Founding ───────────────────────────────
+        if not cur.execute("SELECT 1 FROM days WHERE day_number=0").fetchone():
+            founding_text = (
+                "TINYWICK HOLLOW DECLARES ITSELF A CIVILISATION TODAY\n\n"
+                "In a development that surprised absolutely no one who knows these four, Tinywick "
+                "Hollow has formally declared itself a civilisation. The founding document was "
+                "signed by Beatrice Badger (who insists it must be legally binding), Reginald "
+                "Fox (who has already forged three certified copies), Cornelius Squirrel (who "
+                "invented a device to sign it faster, then signed it twice by mistake), and "
+                "Millicent Mole (who observed that the document was, in a sense, already signed "
+                "underground, and then descended). The future of Tinywick Hollow remains, as "
+                "always, magnificently uncertain.\n\n"
+                "WEATHER: Portentous, with scattered significance.\n"
+                "FOX: Forged three certificates before breakfast.\n"
+                "BADGER: Insisted on thirteen constitutional amendments before lunch.\n"
+                "SQUIRREL: Invented a signing machine! It signed the wrong document!\n"
+                "MOLE: Something is already happening underground."
+            )
+            cur.execute(
+                "INSERT INTO days (day_number,headline,full_newspaper_text,timestamp) VALUES (?,?,?,?)",
+                (0, "TINYWICK HOLLOW DECLARES ITSELF A CIVILISATION TODAY",
+                 founding_text, datetime.now().isoformat())
+            )
+        con.commit()
+
+
+# ─────────────────────────────────────────────────────────────────
+# Days
+# ─────────────────────────────────────────────────────────────────
+def save_day(day_number: int, headline: str, full_newspaper_text: str) -> None:
+    with _conn() as con:
+        con.execute(
+            "INSERT OR REPLACE INTO days (day_number,headline,full_newspaper_text,timestamp) VALUES (?,?,?,?)",
+            (day_number, headline, full_newspaper_text, datetime.now().isoformat()),
+        ); con.commit()
+
+def get_latest_day() -> Optional[dict]:
+    with _conn() as con:
+        row = con.execute("SELECT * FROM days ORDER BY day_number DESC LIMIT 1").fetchone()
+    return dict(row) if row else None
+
+def get_day(day_number: int) -> Optional[dict]:
+    with _conn() as con:
+        row = con.execute("SELECT * FROM days WHERE day_number=?", (day_number,)).fetchone()
+    return dict(row) if row else None
+
+def get_all_headlines() -> list[tuple[int, str]]:
+    with _conn() as con:
+        rows = con.execute("SELECT day_number,headline FROM days ORDER BY day_number DESC").fetchall()
+    return [(r["day_number"], r["headline"]) for r in rows]
+
+def get_next_day_number() -> int:
+    with _conn() as con:
+        row = con.execute("SELECT MAX(day_number) AS m FROM days").fetchone()
+    return (row["m"] or 0) + 1
+
+
+# ─────────────────────────────────────────────────────────────────
+# Events
+# ─────────────────────────────────────────────────────────────────
+def save_event(day_number: int, actor: str, action: str, target: str, description: str) -> None:
+    with _conn() as con:
+        con.execute(
+            "INSERT INTO events (day_number,actor,action,target,description) VALUES (?,?,?,?,?)",
+            (day_number, actor, action, target, description),
+        ); con.commit()
+
+def get_events_for_day(day_number: int) -> list[dict]:
+    with _conn() as con:
+        rows = con.execute(
+            "SELECT actor,action,target,description FROM events WHERE day_number=?", (day_number,)
+        ).fetchall()
+    return [dict(r) for r in rows]
+
+
+# ─────────────────────────────────────────────────────────────────
+# Nudges
+# ─────────────────────────────────────────────────────────────────
+def save_nudge(day_number: int, nudge_type: str, nudge_value: str) -> None:
+    with _conn() as con:
+        con.execute("INSERT INTO nudges (day_number,nudge_type,nudge_value) VALUES (?,?,?)",
+                    (day_number, nudge_type, nudge_value)); con.commit()
+
+def get_recent_nudges(limit: int = 4) -> list[dict]:
+    with _conn() as con:
+        rows = con.execute(
+            "SELECT day_number,nudge_type,nudge_value FROM nudges ORDER BY id DESC LIMIT ?", (limit,)
+        ).fetchall()
+    return [dict(r) for r in rows]
+
+
+# ─────────────────────────────────────────────────────────────────
+# Creatures
+# ─────────────────────────────────────────────────────────────────
+def _parse_creature(row: sqlite3.Row) -> dict:
+    d = dict(row)
+    d["relationship_scores"] = json.loads(d["relationship_scores"])
+    d["inventory"] = json.loads(d["inventory"])
+    return d
+
+def get_creature(name: str) -> Optional[dict]:
+    with _conn() as con:
+        row = con.execute("SELECT * FROM creatures WHERE name=?", (name,)).fetchone()
+    return _parse_creature(row) if row else None
+
+def get_all_creatures() -> list[dict]:
+    with _conn() as con:
+        rows = con.execute("SELECT * FROM creatures").fetchall()
+    return [_parse_creature(r) for r in rows]
+
+def update_creature(name: str, relationship_scores: Optional[dict]=None, inventory: Optional[list]=None) -> None:
+    with _conn() as con:
+        if relationship_scores is not None and inventory is not None:
+            con.execute("UPDATE creatures SET relationship_scores=?,inventory=? WHERE name=?",
+                        (json.dumps(relationship_scores), json.dumps(inventory), name))
+        elif relationship_scores is not None:
+            con.execute("UPDATE creatures SET relationship_scores=? WHERE name=?",
+                        (json.dumps(relationship_scores), name))
+        elif inventory is not None:
+            con.execute("UPDATE creatures SET inventory=? WHERE name=?",
+                        (json.dumps(inventory), name))
+        con.commit()
+
+
+# ─────────────────────────────────────────────────────────────────
+# Civilisation stats
+# ─────────────────────────────────────────────────────────────────
+def get_civ_stats() -> dict:
+    with _conn() as con:
+        total_days   = con.execute("SELECT COUNT(*) FROM days").fetchone()[0]
+        total_events = con.execute("SELECT COUNT(*) FROM events").fetchone()[0]
+        total_nudges = con.execute("SELECT COUNT(*) FROM nudges").fetchone()[0]
+    creatures = get_all_creatures()
+    best_pair = ("?", "?", 0); worst_pair = ("?", "?", 100)
+    for c in creatures:
+        for other, score in c["relationship_scores"].items():
+            pair = tuple(sorted([c["name"], other]))
+            if score > best_pair[2]:  best_pair  = (*pair, score)
+            if score < worst_pair[2]: worst_pair = (*pair, score)
+    dominant = max(creatures, key=lambda c: sum(c["relationship_scores"].values()), default={"name":"?"})
+    return {
+        "total_days": total_days,
+        "total_events": total_events,
+        "total_nudges": total_nudges,
+        "best_pair": best_pair,
+        "worst_pair": worst_pair,
+        "dominant": dominant["name"],
+    }

requirements.txt

@@ -0,0 +1,17 @@
+# ── Tiny Civilization — requirements.txt ──────────────────────────
+# Build Small Hackathon 2026 / Thousand Token Wood track
+# Model: Qwen2.5-1.5B-Instruct (≤4B → Tiny Titan badge 🐜)
+
+# Core inference — 1.5B model fits in ~3 GB VRAM, loads in <60 s on T4
+torch>=2.1.0
+transformers>=4.44.0
+accelerate>=0.30.0
+
+# UI — 5.7.1 is the first 5.x release that removed HfFolder from oauth.py.
+# Do NOT pin below 5.7.1: older versions crash on huggingface_hub >= 0.23.
+# Do NOT add `spaces` here: it's pre-installed on ZeroGPU spaces, and
+# older pinned versions constrain gradio < 4, which re-introduces the crash.
+gradio==5.9.0
+
+# Newspaper PNG export
+Pillow>=10.3.0