agents-city 0.3.0-beta.21

package/demo/despacho/marta.md

@@ -0,0 +1,46 @@
+---
+user: marta
+name: Marta Costa
+role: cpto
+agent: marta/seat
+agents: [contratos, litigios, archivo, fiscal, recepcion]
+kind.contratos: knowledge
+kind.litigios: coordinator
+kind.archivo: knowledge
+kind.fiscal: knowledge
+kind.recepcion: coordinator
+role.contratos: redaccion
+role.litigios: plazos
+role.archivo: expedientes
+role.fiscal: impuestos
+role.recepcion: agenda
+runs.seat: claude
+runs.contratos: claude
+runs.litigios: claude
+runs.archivo: claude
+runs.fiscal: claude
+runs.recepcion: claude
+goals_defined: true
+---
+
+# Marta Costa — Costa & Ley, socia directora
+
+Marta chairs the firm. No agent here is a repository: they are knowledge and
+coordination agents — the agents-first model, where a repo is just one thing an
+agent may mount and none of these mounts one.
+
+## Current goal
+
+### O1 — Ningún plazo se pierde y ningún cliente se entera tarde
+- **What**: Presentar en plazo o avisar el mismo día con un plan B concreto.
+- **How it is measured**: expedientes presentados a tiempo y llamadas hechas.
+- **Measure**: `demo — scripted evidence over the local WebSocket committee`
+- **Baseline**: sustos de última hora resueltos a base de noches
+- **Target**: el caos absorbido de día, con horas y nombres
+- **By when**: demo day
+- **State**: in progress
+
+## Round history
+
+The guided committee writes its complete act here at runtime. The packaged
+fixture is copied to a temporary directory first, so this file stays untouched.

package/demo/despacho/parcels.yml

@@ -0,0 +1,15 @@
+# Five agents, five houses. The scripted committee invites only three, so
+# abstention and bounded participation remain believable — same as Aurora.
+repos:
+  contratos:
+    - ruta: "" ; unidad: civil ; nombre: "Contratos"
+  litigios:
+    - ruta: "" ; unidad: civil ; nombre: "Litigios"
+  archivo:
+    - ruta: "" ; unidad: gestion ; nombre: "Archivo"
+  fiscal:
+    - ruta: "" ; unidad: fiscalidad ; nombre: "Fiscal"
+  recepcion:
+    - ruta: "" ; unidad: gestion ; nombre: "Recepción"
+
+lab: []

package/demo/despacho/roads.json

@@ -0,0 +1,4 @@
+{
+  "version": 1,
+  "roads": []
+}

package/demo/despacho/units.yml

@@ -0,0 +1,9 @@
+# A small law firm: three districts anyone can read at a glance.
+units:
+  - id: civil      ; name: Derecho Civil ; color: e2604f ; order: 1
+  - id: fiscalidad ; name: Fiscal        ; color: f5c451 ; order: 2
+  - id: gestion    ; name: Gestión       ; color: 8f7ae6 ; order: 3
+
+special:
+  - id: lab        ; name: Lab           ; color: 8fb8c9 ; order: 90
+  - id: none       ; name: Shared        ; color: c8b48a ; order: 99

package/demo/elsa.md

@@ -0,0 +1,50 @@
+---
+user: elsa
+name: Elsa Marín
+role: po
+agent: elsa/po
+repos: [nova, store-service]
+covers: [all]
+goals_defined: true
+---
+
+# Elsa Marín
+
+Role: **po** — in the city, the **site manager**. The domain is in `roles/po.md`.
+
+## Repos
+
+Answers for: `nova`, `store-service`.
+
+## Current goals
+
+### O1 — A release note nobody has to translate
+- **What**: A release note nobody has to translate.
+- **How it is measured**: Releases whose note names the player-visible change
+- **Measure**: `manual — Elsa reads the last ten notes and marks those a player would understand`
+- **Baseline**: 4 of 10 (2026-07-02)
+- **Target**: 9 of 10
+- **By when**: Q4 2026
+- **State**: in progress
+
+<!-- Format, one block per goal:
+
+### O1 — <short title>
+- **What**: what has to be achieved, in one sentence.
+- **How it is measured**: the concrete signal that says whether it is going well.
+- **Measure**: the command or query returning that signal, runnable as written.
+  If the signal is a judgement and not a number: `manual — <who looks at what, and
+  how often>`.
+- **Baseline**: what the measure returned the day it was agreed, with the date.
+- **Target**: the value to reach.
+- **By when**: a date or a quarter.
+- **State**: not started | in progress | at risk | done
+
+The measure gets run before the goal is agreed: if it does not work, what is
+missing is building it, and that is work. See /city:goals.
+
+-->
+
+## Round history
+
+Rounds leave their summary here, most recent first.

package/demo/farid.md

@@ -0,0 +1,52 @@
+---
+user: farid
+name: Farid Nasser
+role: llm-engineer
+agent: farid/llm
+repos: []
+covers: [all]
+goals_defined: true
+---
+
+# Farid Nasser
+
+Role: **llm-engineer** — in the city, the **machinist**. The domain is in `roles/llm-engineer.md`.
+
+## Repos
+
+No repos of their own: cross-cutting roles do not own any, they answer for one property of all of them.
+
+## Current goals
+
+### O1 — Cost per NPC dialogue drops 60% with no quality loss
+- **What**: Cost per NPC dialogue drops 60% with no quality loss.
+- **How it is measured**: average cost per conversation and hit rate over the 40 reference cases.
+- **Measure**: `python evals/npc_dialog.py --report`
+- **Baseline**: $0.021 and 86% (2026-02-01)
+- **Target**: $0.008 and ≥86%
+- **By when**: Q2 2026
+- **State**: in progress
+
+_Last edited: 2026-02-14 by ada._
+
+<!-- Format, one block per goal:
+
+### O1 — <short title>
+- **What**: what has to be achieved, in one sentence.
+- **How it is measured**: the concrete signal that says whether it is going well.
+- **Measure**: the command or query returning that signal, runnable as written.
+  If the signal is a judgement and not a number: `manual — <who looks at what, and
+  how often>`.
+- **Baseline**: what the measure returned the day it was agreed, with the date.
+- **Target**: the value to reach.
+- **By when**: a date or a quarter.
+- **State**: not started | in progress | at risk | done
+
+The measure gets run before the goal is agreed: if it does not work, what is
+missing is building it, and that is work. See /city:goals.
+
+-->
+
+## Round history
+
+Rounds leave their summary here, most recent first.

package/demo/greta.md

@@ -0,0 +1,50 @@
+---
+user: greta
+name: Greta Lindqvist
+role: ai-manager
+agent: greta/ai
+repos: [lab-npc-brains, telemetry-collector, nova]
+covers: [all]
+goals_defined: true
+---
+
+# Greta Lindqvist
+
+Role: **ai-manager** — in the city, the **works inspector**. The domain is in `roles/ai-manager.md`.
+
+## Repos
+
+Answers for: `lab-npc-brains`, `telemetry-collector`, `nova`.
+
+## Current goals
+
+### O1 — Agents ask before they touch somebody else's property
+- **What**: Agents ask before they touch somebody else's property.
+- **How it is measured**: Notices sent before the merge, not after
+- **Measure**: `select count(*) from evento where tipo='notice'`
+- **Baseline**: 31 last month, 12 after the merge (2026-07-01)
+- **Target**: none after the merge
+- **By when**: Q4 2026
+- **State**: in progress
+
+<!-- Format, one block per goal:
+
+### O1 — <short title>
+- **What**: what has to be achieved, in one sentence.
+- **How it is measured**: the concrete signal that says whether it is going well.
+- **Measure**: the command or query returning that signal, runnable as written.
+  If the signal is a judgement and not a number: `manual — <who looks at what, and
+  how often>`.
+- **Baseline**: what the measure returned the day it was agreed, with the date.
+- **Target**: the value to reach.
+- **By when**: a date or a quarter.
+- **State**: not started | in progress | at risk | done
+
+The measure gets run before the goal is agreed: if it does not work, what is
+missing is building it, and that is work. See /city:goals.
+
+-->
+
+## Round history
+
+Rounds leave their summary here, most recent first.

package/demo/hugo.md

@@ -0,0 +1,49 @@
+---
+user: hugo
+name: Hugo Beltrán
+role: dev
+agent: hugo/dev
+repos: [nova, engine-core, asset-pipeline, launcher]
+goals_defined: true
+---
+
+# Hugo Beltrán
+
+Role: **dev** — in the city, the **master builder**. The domain is in `roles/dev.md`.
+
+## Repos
+
+Answers for: `nova`, `engine-core`, `asset-pipeline`, `launcher`.
+
+## Current goals
+
+### O1 — The engine stops being the thing everybody waits for
+- **What**: The engine stops being the thing everybody waits for.
+- **How it is measured**: Open PRs on engine-core older than two weeks
+- **Measure**: `gh pr list --repo aurora/engine-core --search 'created:<2026-08-12' --json number --jq length`
+- **Baseline**: 7 stale (2026-08-01)
+- **Target**: 1 or none
+- **By when**: Q4 2026
+- **State**: at risk
+
+<!-- Format, one block per goal:
+
+### O1 — <short title>
+- **What**: what has to be achieved, in one sentence.
+- **How it is measured**: the concrete signal that says whether it is going well.
+- **Measure**: the command or query returning that signal, runnable as written.
+  If the signal is a judgement and not a number: `manual — <who looks at what, and
+  how often>`.
+- **Baseline**: what the measure returned the day it was agreed, with the date.
+- **Target**: the value to reach.
+- **By when**: a date or a quarter.
+- **State**: not started | in progress | at risk | done
+
+The measure gets run before the goal is agreed: if it does not work, what is
+missing is building it, and that is work. See /city:goals.
+
+-->
+
+## Round history
+
+Rounds leave their summary here, most recent first.

package/demo/iris.md

@@ -0,0 +1,49 @@
+---
+user: iris
+name: Iris Cabrera
+role: dev
+agent: iris/dev
+repos: [puzzle-quest, farm-tycoon, store-service, ads-mediation]
+goals_defined: true
+---
+
+# Iris Cabrera
+
+Role: **dev** — in the city, the **master builder**. The domain is in `roles/dev.md`.
+
+## Repos
+
+Answers for: `puzzle-quest`, `farm-tycoon`, `store-service`, `ads-mediation`.
+
+## Current goals
+
+### O1 — A crash a player hits twice never survives a week
+- **What**: A crash a player hits twice never survives a week.
+- **How it is measured**: Crash groups over 100 sessions open more than seven days
+- **Measure**: `manual — Iris reads the crash board every Monday and counts them`
+- **Baseline**: 6 groups (2026-06-08)
+- **Target**: 0
+- **By when**: Q4 2026
+- **State**: in progress
+
+<!-- Format, one block per goal:
+
+### O1 — <short title>
+- **What**: what has to be achieved, in one sentence.
+- **How it is measured**: the concrete signal that says whether it is going well.
+- **Measure**: the command or query returning that signal, runnable as written.
+  If the signal is a judgement and not a number: `manual — <who looks at what, and
+  how often>`.
+- **Baseline**: what the measure returned the day it was agreed, with the date.
+- **Target**: the value to reach.
+- **By when**: a date or a quarter.
+- **State**: not started | in progress | at risk | done
+
+The measure gets run before the goal is agreed: if it does not work, what is
+missing is building it, and that is work. See /city:goals.
+
+-->
+
+## Round history
+
+Rounds leave their summary here, most recent first.

package/demo/jonas.md

@@ -0,0 +1,51 @@
+---
+user: jonas
+name: Jonas Weber
+role: dev
+agent: jonas/dev
+repos: [rift-runner, netcode, controller-sdk, crash-reporter]
+goals_defined: true
+---
+
+# Jonas Weber
+
+Role: **dev** — in the city, the **master builder**. The domain is in `roles/dev.md`.
+
+## Repos
+
+Answers for: `rift-runner`, `netcode`, `controller-sdk`, `crash-reporter`.
+
+## Current goals
+
+### O1 — Networked matches survive 200 ms latency with no rubber-banding
+- **What**: Networked matches survive 200 ms latency with no rubber-banding.
+- **How it is measured**: matches with more than two visible jumps per minute, in the network simulator.
+- **Measure**: `python tools/netsim.py --latency 200 --report`
+- **Baseline**: 31% of matches (2026-01-12)
+- **Target**: < 5%
+- **By when**: Q1 2026
+- **State**: in progress
+
+_Last edited: 2026-02-14 by ada._
+
+<!-- Format, one block per goal:
+
+### O1 — <short title>
+- **What**: what has to be achieved, in one sentence.
+- **How it is measured**: the concrete signal that says whether it is going well.
+- **Measure**: the command or query returning that signal, runnable as written.
+  If the signal is a judgement and not a number: `manual — <who looks at what, and
+  how often>`.
+- **Baseline**: what the measure returned the day it was agreed, with the date.
+- **Target**: the value to reach.
+- **By when**: a date or a quarter.
+- **State**: not started | in progress | at risk | done
+
+The measure gets run before the goal is agreed: if it does not work, what is
+missing is building it, and that is work. See /city:goals.
+
+-->
+
+## Round history
+
+Rounds leave their summary here, most recent first.

package/demo/kira.md

@@ -0,0 +1,51 @@
+---
+user: kira
+name: Kira Sato
+role: dev
+agent: kira/dev
+repos: [telemetry-collector, dbt-models, etl-jobs, player-dashboards, ab-testing]
+goals_defined: true
+---
+
+# Kira Sato
+
+Role: **dev** — in the city, the **master builder**. The domain is in `roles/dev.md`.
+
+## Repos
+
+Answers for: `telemetry-collector`, `dbt-models`, `etl-jobs`, `player-dashboards`, `ab-testing`.
+
+## Current goals
+
+### O1 — No telemetry event is lost on deploy
+- **What**: No telemetry event is lost on deploy.
+- **How it is measured**: events received against events sent, in the deploy window.
+- **Measure**: `python tools/telemetry_audit.py --window deploy`
+- **Baseline**: 97.3% (2026-02-03)
+- **Target**: ≥ 99.9%
+- **By when**: Q2 2026
+- **State**: in progress
+
+_Last edited: 2026-02-14 by ada._
+
+<!-- Format, one block per goal:
+
+### O1 — <short title>
+- **What**: what has to be achieved, in one sentence.
+- **How it is measured**: the concrete signal that says whether it is going well.
+- **Measure**: the command or query returning that signal, runnable as written.
+  If the signal is a judgement and not a number: `manual — <who looks at what, and
+  how often>`.
+- **Baseline**: what the measure returned the day it was agreed, with the date.
+- **Target**: the value to reach.
+- **By when**: a date or a quarter.
+- **State**: not started | in progress | at risk | done
+
+The measure gets run before the goal is agreed: if it does not work, what is
+missing is building it, and that is work. See /city:goals.
+
+-->
+
+## Round history
+
+Rounds leave their summary here, most recent first.

package/demo/luca.md

@@ -0,0 +1,49 @@
+---
+user: luca
+name: Luca Ferri
+role: dev
+agent: luca/dev
+repos: [lab-procgen, lab-npc-brains, lab-shaders, lab-notebooks, sandbox-ui]
+goals_defined: true
+---
+
+# Luca Ferri
+
+Role: **dev** — in the city, the **master builder**. The domain is in `roles/dev.md`.
+
+## Repos
+
+Answers for: `lab-procgen`, `lab-npc-brains`, `lab-shaders`, `lab-notebooks`, `sandbox-ui`.
+
+## Current goals
+
+### O1 — The lab ships one thing a quarter into a real game
+- **What**: The lab ships one thing a quarter into a real game.
+- **How it is measured**: Lab work that reaches players
+- **Measure**: `manual — Luca and Ada review at the end of each quarter`
+- **Baseline**: 0 in the last two quarters (2026-06-30)
+- **Target**: 1 per quarter
+- **By when**: Q1 2027
+- **State**: not started
+
+<!-- Format, one block per goal:
+
+### O1 — <short title>
+- **What**: what has to be achieved, in one sentence.
+- **How it is measured**: the concrete signal that says whether it is going well.
+- **Measure**: the command or query returning that signal, runnable as written.
+  If the signal is a judgement and not a number: `manual — <who looks at what, and
+  how often>`.
+- **Baseline**: what the measure returned the day it was agreed, with the date.
+- **Target**: the value to reach.
+- **By when**: a date or a quarter.
+- **State**: not started | in progress | at risk | done
+
+The measure gets run before the goal is agreed: if it does not work, what is
+missing is building it, and that is work. See /city:goals.
+
+-->
+
+## Round history
+
+Rounds leave their summary here, most recent first.

package/demo/parcels.yml

@@ -0,0 +1,92 @@
+# Parcels — which slice of which repo serves which business unit.
+#
+# Aurora Games is made up for this demo: a game studio with four business units,
+# a lab, and a pile of shared code. Any company shaped like this works the same.
+#
+# A house on the map is not a repo: it is a **parcel**. One repo can hold several,
+# and that is not a drawing detail — it is the central fact of most codebases: a
+# monorepo holds products from every unit, and the shared engine serves them all.
+#
+# Two things read this file, which is why it lives in data and not in code:
+#   1. The city map, to know which district each house belongs to.
+#   2. The notice router, to decide who to tell based on the FILES a PR touches
+#      — an exact signal, not a list of topics that goes stale.
+#
+# units: mobile | console | arcade | school | platform | data | lab | none
+# path: glob relative to the repo. Empty = the whole repo. First match wins, so
+#       specific goes before general.
+
+repos:
+  nova:
+    - ruta: "apps/puzzle-*/**"      ; unidad: mobile  ; nombre: "Puzzle Quest"
+    - ruta: "apps/farm-*/**"        ; unidad: mobile  ; nombre: "Farm Tycoon"
+    - ruta: "apps/rift-*/**"        ; unidad: console ; nombre: "Rift Runner"
+    - ruta: "apps/cabinet-*/**"     ; unidad: arcade  ; nombre: "Cabinet firmware"
+    - ruta: "apps/school-*/**"      ; unidad: school  ; nombre: "School editions"
+    - ruta: "packages/**"           ; unidad: none    ; nombre: "nova · packages"
+    - ruta: ""                      ; unidad: none    ; nombre: "nova · monorepo"
+
+  # Standalone repos. A repo with nothing declared here lands in "no unit", which
+  # is honest but not useful: on the map it turns into a district of orphans that
+  # tells you nothing. Saying which unit each repo serves is the work, and it is
+  # the work that makes the map worth looking at.
+  puzzle-quest:
+    - ruta: ""                      ; unidad: mobile  ; nombre: "Puzzle Quest"
+  farm-tycoon:
+    - ruta: ""                      ; unidad: mobile  ; nombre: "Farm Tycoon"
+  ads-mediation:
+    - ruta: ""                      ; unidad: mobile  ; nombre: "Ad mediation"
+  rift-runner:
+    - ruta: ""                      ; unidad: console ; nombre: "Rift Runner"
+  netcode:
+    - ruta: ""                      ; unidad: console ; nombre: "Netcode"
+  controller-sdk:
+    - ruta: ""                      ; unidad: console ; nombre: "Controller SDK"
+  launcher:
+    - ruta: ""                      ; unidad: platform; nombre: "Launcher"
+  store-service:
+    - ruta: ""                      ; unidad: platform; nombre: "Store"
+  infrastructure:
+    - ruta: ""                      ; unidad: platform; nombre: "Infrastructure"
+  ci-templates:
+    - ruta: ""                      ; unidad: platform; nombre: "CI templates"
+  crash-reporter:
+    - ruta: ""                      ; unidad: platform; nombre: "Crash reporter"
+  consent-kit:
+    - ruta: ""                      ; unidad: platform; nombre: "Consent kit"
+  asset-pipeline:
+    - ruta: ""                      ; unidad: arcade  ; nombre: "Asset pipeline"
+  telemetry-collector:
+    - ruta: ""                      ; unidad: data    ; nombre: "Telemetry collector"
+  etl-jobs:
+    - ruta: ""                      ; unidad: data    ; nombre: "ETL jobs"
+  dbt-models:
+    - ruta: ""                      ; unidad: data    ; nombre: "dbt models"
+  ab-testing:
+    - ruta: ""                      ; unidad: data    ; nombre: "Experiments"
+  player-dashboards:
+    - ruta: ""                      ; unidad: school  ; nombre: "Classroom dashboards"
+
+  engine-core:
+    - ruta: "renderer/**"           ; unidad: none    ; nombre: "engine · renderer"
+    - ruta: "audio/**"              ; unidad: none    ; nombre: "engine · audio"
+    - ruta: "physics/**"            ; unidad: none    ; nombre: "engine · physics"
+    - ruta: ""                      ; unidad: none    ; nombre: "engine · core"
+
+# The lab.
+#
+# Research and development: it does not ship to players yet, and it is needed.
+# It gets its own district instead of falling into the "no unit" bucket on
+# purpose — a lab repo among the orphans reads as waste, and it is the opposite:
+# it is the part of the studio working for two years from now instead of for this
+# quarter.
+#
+# Drawn with permanent scaffolding, because that is what it is: a site that is
+# open on purpose. And its growth is not compared against the shipping units: a
+# lab house with few floors is not behind, it is early.
+lab:
+  - lab-procgen
+  - lab-npc-brains
+  - lab-shaders
+  - lab-notebooks
+  - sandbox-ui

package/demo/seed.py

@@ -0,0 +1,20 @@
+#!/usr/bin/env python3
+"""Load the demo city: Aurora Games, a made-up game studio.
+
+Twelve people, four business units, a lab, and three years of generated history
+so the replay has something to replay. It is the same seeder the real thing uses,
+pointed at `demo/` and told to invent a past.
+
+    ./demo/seed.py --local     load it into the local D1
+    ./demo/seed.py --remote    load it into the deployed one
+
+An empty city teaches nothing: you cannot tell whether the thing works, and you
+cannot show it to anyone. Hence a demo that arrives alive.
+"""
+import os
+import sys
+
+AQUI = os.path.dirname(os.path.abspath(__file__))
+SEMBRADOR = os.path.join(AQUI, '..', 'city', 'scripts', 'seed.py')
+os.execv(sys.executable,
+         [sys.executable, SEMBRADOR, '--data', AQUI, '--fake-history', *sys.argv[1:]])