agents-city 0.3.0-beta.21

package/city/web/src/puertas.ts

@@ -0,0 +1,180 @@
+/**
+ * The city gates: one per road, at the entrance, past the square.
+ *
+ * A road is an allowlist entry — reachability, not a channel — and this is its
+ * honest drawing: not a highway to somewhere, but a gate with a name over it.
+ * Everything beyond the gate is another city this map will never draw; the
+ * other cities exist here exactly as much as they exist to the seat, as an
+ * address you may send to. A letter for one of them flies out through its gate
+ * and fades at the edge, because that is all this city ever sees of it.
+ *
+ * The gates come from the Hall's config message. The standalone team map never
+ * receives one and draws no gates: a map must not invent connections.
+ */
+import { Container, Graphics, Text, TextStyle } from 'pixi.js';
+import { TH, tono } from './draw';
+import type { RoadInfo } from './activity';
+
+const PIEDRA = 0xb9a67c;
+
+export interface Ancla {
+  x: number;
+  y: number;
+}
+
+export class Puertas {
+  /** The arches, in world coordinates, under the people layer. */
+  readonly capa = new Container();
+  /** The name plates, in the banner layer, zoom-stable like every label. */
+  readonly carteles = new Container();
+
+  private readonly sitios = new Map<string, Ancla>();
+
+  constructor(
+    private readonly origen: Ancla,
+    private readonly anima: (f: (dt: number) => boolean) => void,
+    private readonly alTocar?: (road: RoadInfo) => void,
+  ) {}
+
+  /** Draw the gates the Hall says exist. Called again when the roads change:
+   * it redraws from scratch — there are never more than a handful. */
+  configura(roads: RoadInfo[]): void {
+    this.capa.removeChildren().forEach((child) => child.destroy({ children: true }));
+    this.carteles.removeChildren().forEach((child) => child.destroy({ children: true }));
+    this.sitios.clear();
+
+    roads.forEach((road, i) => {
+      // Gates line up along the near edge, to the right of the square, each a
+      // step further out: the first road is the nearest gate.
+      const pos = { x: this.origen.x + 340 + i * 150, y: this.origen.y - 40 - i * 26 };
+      this.sitios.set(this.clave(road.address), pos);
+      this.sitios.set(this.clave(road.name), pos);
+
+      const g = new Container();
+      g.position.set(pos.x, pos.y);
+      // A gate is a question waiting to be clicked: where does this one go?
+      g.eventMode = 'static';
+      g.cursor = 'pointer';
+      g.on('pointertap', () => this.alTocar?.(road));
+
+      // The stub of road the gate stands on: it starts here and leaves the map.
+      const camino = new Graphics()
+        .poly([-46, 16, 96, -14, 96, 2, -46, 32])
+        .fill({ color: 0x1b2532, alpha: 0.9 });
+      camino.moveTo(-38, 22).lineTo(88, -4).stroke({ color: 0xc8b48a, width: 0.9, alpha: 0.3 });
+      g.addChild(camino);
+
+      // Two pillars flanking the road, a lintel across: the arch of the mock-up.
+      for (const [px, py] of [
+        [-12, 6],
+        [16, 22],
+      ] as const) {
+        g.addChild(
+          new Graphics()
+            .ellipse(px, py + 3, 6, 2.6)
+            .fill({ color: 0x000000, alpha: 0.3 })
+            .poly([px, py, px - 5, py - 2.5, px - 5, py - 34, px, py - 31.5])
+            .fill({ color: tono(PIEDRA, -0.28) })
+            .poly([px, py, px + 5, py - 2.5, px + 5, py - 34, px, py - 31.5])
+            .fill({ color: tono(PIEDRA, -0.5) })
+            .poly([px, py - 36.5, px + 5, py - 34, px, py - 31.5, px - 5, py - 34])
+            .fill({ color: tono(PIEDRA, 0.24) }),
+        );
+      }
+      g.addChild(
+        new Graphics()
+          .moveTo(-12, -30)
+          .lineTo(16, -14)
+          .stroke({ color: tono(PIEDRA, 0.25), width: 3.5, alpha: 0.95 }),
+      );
+      this.capa.addChild(g);
+
+      // The plate: the address is the point of the gate. `owner/city` is how the
+      // roads file names the far end, and how the seat addresses it.
+      const cartel = new Container();
+      const nombre = new Text({
+        text: road.name,
+        style: new TextStyle({
+          fontFamily: 'Chakra Petch, sans-serif',
+          fontSize: 10,
+          fontWeight: '700',
+          letterSpacing: 0.8,
+          fill: 0x131a24,
+        }),
+      });
+      const dir = new Text({
+        text: road.address,
+        style: new TextStyle({
+          fontFamily: 'IBM Plex Mono, monospace',
+          fontSize: 8.5,
+          fill: 0x8d99a8,
+        }),
+      });
+      const ancho = Math.max(nombre.width, dir.width) + 14;
+      cartel.addChild(
+        new Graphics()
+          .roundRect(-ancho / 2, -12, ancho, 18, 3)
+          .fill({ color: PIEDRA, alpha: 0.94 }),
+      );
+      nombre.position.set(-nombre.width / 2, -10);
+      dir.position.set(-dir.width / 2, 8);
+      cartel.addChild(nombre, dir);
+      cartel.position.set(pos.x + 2, pos.y - 52);
+      this.carteles.addChild(cartel);
+    });
+  }
+
+  hay(): boolean {
+    return this.sitios.size > 0;
+  }
+
+  /** The gate a recipient leaves through — matched by address or name, and the
+   * first gate when the address is external but unknown: a letter that must
+   * leave the city leaves by A gate, not by teleport. */
+  puerta(destino: string): Ancla | null {
+    if (!this.sitios.size) return null;
+    const clave = this.clave(destino);
+    const exacta = this.sitios.get(clave);
+    if (exacta) return exacta;
+    for (const [k, v] of this.sitios) {
+      if (clave.includes(k) || k.includes(clave)) return v;
+    }
+    return this.sitios.values().next().value ?? null;
+  }
+
+  /** A letter crossing the arch, outward or inward, fading at the map's edge. */
+  vuela(puerta: Ancla, color: number, sale: boolean): void {
+    const carta = new Graphics()
+      .rect(-4, -3, 8, 6)
+      .fill({ color: 0xf2ecdd })
+      .rect(-4, -3, 8, 2)
+      .fill({ color });
+    const g = new Container();
+    g.addChild(new Graphics().circle(0, 0, 5).fill({ color, alpha: 0.16 }), carta);
+    this.capa.parent?.addChild(g);
+    const dentro = { x: puerta.x - 4, y: puerta.y - 18 };
+    const fuera = { x: puerta.x + 120, y: puerta.y - 44 };
+    const p0 = sale ? dentro : fuera;
+    const p1 = sale ? fuera : dentro;
+    let t = 0;
+    this.anima((dt) => {
+      t += 0.03 * dt;
+      const s = Math.min(1, t);
+      g.x = p0.x + (p1.x - p0.x) * s;
+      g.y = p0.y + (p1.y - p0.y) * s - Math.sin(s * Math.PI) * 10;
+      // Outward it fades leaving; inward it arrives already faint and firms up.
+      g.alpha = sale ? (s > 0.6 ? (1 - s) / 0.4 : 1) : s < 0.4 ? s / 0.4 : 1;
+      carta.rotation = Math.sin(t * 6) * 0.25;
+      if (t >= 1) {
+        g.parent?.removeChild(g);
+        g.destroy({ children: true });
+        return false;
+      }
+      return true;
+    });
+  }
+
+  private clave(valor: string): string {
+    return valor.trim().toLowerCase();
+  }
+}

package/city/web/src/repo-roles.ts

@@ -0,0 +1,59 @@
+/** Pure rendering/data helpers for one operating role per repo support agent. */
+export interface RepoRoleOption {
+  id: string;
+  name: string;
+  summary: string;
+  trade: string;
+  domains: string[];
+}
+
+export type RepoRoleAssignments = Record<string, string>;
+
+export function selectedRepoRoles(
+  repos: Iterable<string>,
+  assignments: RepoRoleAssignments,
+): RepoRoleAssignments {
+  return Object.fromEntries([...repos].sort().map((repo) => [repo, assignments[repo] || 'blank']));
+}
+
+export function renderRepoRoleEditor(
+  repos: Iterable<string>,
+  assignments: RepoRoleAssignments,
+  roles: RepoRoleOption[],
+  escape: (value: unknown) => string,
+): string {
+  const selected = [...repos].sort();
+  if (!selected.length) {
+    return '<p class="prosa">No repo agents in this city.</p>';
+  }
+  return `<div class="agenteRoles">${selected
+    .map((repo) => {
+      const current = assignments[repo] || 'blank';
+      const choices = roles.some((role) => role.id === current)
+        ? roles
+        : [
+            {
+              id: current,
+              name: `${current} (city-defined)`,
+              summary: 'Role defined in this city rather than the built-in catalogue.',
+              trade: current,
+              domains: [],
+            },
+            ...roles,
+          ];
+      return `<div class="agenteRol">
+        <div><code>${escape(repo)}</code><span>support agent · member</span></div>
+        <select data-repo-role="${escape(repo)}" aria-label="Operating role for ${escape(repo)}">
+          ${choices
+            .map((role) => {
+              const family = role.domains.filter((domain) => domain !== 'custom').join(', ');
+              const suffix = family ? ` · ${family}` : '';
+              return `<option value="${escape(role.id)}"${role.id === current ? ' selected' : ''}
+                title="${escape(role.summary)}">${escape(role.name)}${escape(suffix)}</option>`;
+            })
+            .join('')}
+        </select>
+      </div>`;
+    })
+    .join('')}</div>`;
+}

package/city/worker/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "city-worker",
+  "private": true,
+  "scripts": {
+    "dev": "bun x wrangler@4 dev --local",
+    "deploy": "bun x wrangler@4 deploy",
+    "d1:crear": "bun x wrangler@4 d1 create city",
+    "d1:schema": "bun x wrangler@4 d1 execute city --remote --file schema.sql",
+    "d1:schema:local": "bun x wrangler@4 d1 execute city --local --file schema.sql",
+    "typecheck": "tsc"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^5.20260826.1",
+    "typescript": "^7.0.2"
+  }
+}

package/city/worker/schema.sql

@@ -0,0 +1,117 @@
+-- Agents City — the record of what has been built.
+-- The Durable Object holds the now; this holds the before.
+
+-- A parcel is one business unit inside one repo: a repo can hold several, and
+-- that is what the whole model is about. Seeded from your data repo's parcels.yml.
+CREATE TABLE IF NOT EXISTS parcela (
+  id        TEXT PRIMARY KEY,          -- "org/repo:apps/checkout"
+  repo      TEXT NOT NULL,
+  ruta      TEXT NOT NULL,             -- glob relative to the repo, "" = the whole repo
+  unidad    TEXT NOT NULL,             -- one of your units, or "none"
+  nombre    TEXT NOT NULL,             -- what the house is called on the map
+  dueno     TEXT,                      -- the bus user who answers for it
+  UNIQUE(repo, ruta)
+);
+CREATE INDEX IF NOT EXISTS ix_parcela_unidad ON parcela(unidad);
+
+-- What has been built: one row per parcel, recomputed by the cron.
+CREATE TABLE IF NOT EXISTS casa (
+  parcela_id   TEXT PRIMARY KEY REFERENCES parcela(id),
+  pisos        INTEGER NOT NULL DEFAULT 0,   -- merged PRs (a floor per landing)
+  ladrillos    INTEGER NOT NULL DEFAULT 0,   -- commits with no PR
+  andamios     INTEGER NOT NULL DEFAULT 0,   -- open PRs
+  andamio_viejo INTEGER NOT NULL DEFAULT 0,  -- open PRs older than 14 days
+  grieta       INTEGER NOT NULL DEFAULT 0,   -- 1 = CI is red
+  actividad30  INTEGER NOT NULL DEFAULT 0,   -- commits in the last 30 days
+  actualizado  TEXT NOT NULL
+);
+
+-- Everything that happens, so the map can be rewound and the ticker has a feed.
+CREATE TABLE IF NOT EXISTS evento (
+  id      INTEGER PRIMARY KEY AUTOINCREMENT,
+  ts      TEXT NOT NULL,
+  tipo    TEXT NOT NULL,               -- notice | floor | scaffold | crack | light
+  origen  TEXT,                        -- a bus agent, or a parcel
+  destino TEXT,
+  etiqueta TEXT,                       -- data | ux | security | cost | product | llm
+  texto   TEXT,
+  leido   INTEGER NOT NULL DEFAULT 0   -- an unopened notice is the one thing worth measuring
+);
+CREATE INDEX IF NOT EXISTS ix_evento_ts ON evento(ts DESC);
+CREATE INDEX IF NOT EXISTS ix_evento_sin_leer ON evento(leido, ts DESC);
+
+-- The syncer's own state: how far the last pass got.
+CREATE TABLE IF NOT EXISTS meta (
+  clave TEXT PRIMARY KEY,
+  valor TEXT NOT NULL
+);
+
+-- Who is who on the site: the architect, the specialists, and their trade.
+CREATE TABLE IF NOT EXISTS persona (
+  usuario TEXT PRIMARY KEY,
+  nombre  TEXT NOT NULL,
+  rol     TEXT NOT NULL,
+  oficio  TEXT NOT NULL,
+  agente  TEXT
+);
+
+-- The history of what was built, day by day: this is what the replay plays.
+-- Rebuilt backwards from each PR's merge date, so you do not have to wait for
+-- time to pass before you have a past.
+CREATE TABLE IF NOT EXISTS hito (
+  parcela_id TEXT NOT NULL,
+  dia        TEXT NOT NULL,          -- "2026-08-25"
+  n          INTEGER NOT NULL,       -- PRs landed THAT day
+  PRIMARY KEY (parcela_id, dia)
+);
+-- Per day, not per month: a month is too coarse to watch anything grow.
+CREATE INDEX IF NOT EXISTS ix_hito_dia ON hito(dia);
+
+-- The districts of the city: your business units. Data, not code — so the map
+-- redraws itself when the org changes shape, without a deploy.
+CREATE TABLE IF NOT EXISTS unidad (
+  id     TEXT PRIMARY KEY,
+  nombre TEXT NOT NULL,
+  color  TEXT NOT NULL,          -- hex, no #
+  orden  INTEGER NOT NULL DEFAULT 50,
+  nota   TEXT,
+  cols   INTEGER NOT NULL DEFAULT 3   -- how wide its grid is on the map
+);
+
+-- Token spend, aggregated by day and person. Counts only: never content, never
+-- prompts.
+--
+-- Stored per person because that is the only way to deduplicate reports and to
+-- attribute spend to a unit. Shown as a GLOBAL total, and never as a ranking —
+-- the moment there is a leaderboard, people optimise for the leaderboard. Same
+-- rule as everywhere else in this map.
+CREATE TABLE IF NOT EXISTS gasto (
+  dia      TEXT NOT NULL,
+  usuario  TEXT NOT NULL,
+  modelo   TEXT NOT NULL DEFAULT '',
+  entrada  INTEGER NOT NULL DEFAULT 0,
+  salida   INTEGER NOT NULL DEFAULT 0,
+  cache_r  INTEGER NOT NULL DEFAULT 0,
+  cache_w  INTEGER NOT NULL DEFAULT 0,
+  PRIMARY KEY (dia, usuario, modelo)
+);
+CREATE INDEX IF NOT EXISTS ix_gasto_dia ON gasto(dia DESC);
+
+-- Goals: one per person, with the command that measures them.
+--
+-- The one thing that does not change whatever kind of city this is, so it lives
+-- in the database and not only in a card nobody opens. Seeded from the cards,
+-- which stay the place they are written and reviewed — this is a copy for the
+-- map, never the source.
+CREATE TABLE IF NOT EXISTS objetivo (
+  usuario  TEXT NOT NULL,
+  n        INTEGER NOT NULL,        -- O1, O2…
+  titulo   TEXT NOT NULL,
+  como     TEXT,                    -- what signal says it is going well
+  medida   TEXT,                    -- the command or query, runnable as written
+  partida  TEXT,                    -- what it returned the day it was agreed
+  meta     TEXT,                    -- the value to reach
+  cuando   TEXT,                    -- a date or a quarter
+  estado   TEXT,                    -- not started | in progress | at risk | done
+  PRIMARY KEY (usuario, n)
+);