agents-city 0.1.0 → 0.2.0

package/city/web/src/hall.ts

@@ -11,6 +11,7 @@
  * ever serves this file.
  */
 
+import { Bienvenida } from './bienvenida';
 import {
   ActivityEvent,
   MAP_ACTIVITY_PROTOCOL,
@@ -267,10 +268,24 @@ const SECCIONES: Array<[string, string]> = [
   ['red', 'Roads'],
   ['committee', 'Committee'],
   ['gente', 'Agents & skills'],
+  ['ciudades', 'Cities'],
 ];
 
+/** True until the person navigates: the landing section is decided once, from
+ * the state, and never yanked out from under them afterwards. */
+let primeraCarga = true;
+
 async function refresca(): Promise<void> {
   E = await api<Estado>('/api/estado');
+  if (primeraCarga) {
+    primeraCarga = false;
+    // A city with no seat or no agents has nothing to draw, and "Not drawn
+    // yet" is a dead end as a first impression. Start where the next step is.
+    const mia = E.tarjetas.find((t) => t.user === E.yo);
+    // A city with no seat and no agents has nothing to show and everything to
+    // ask, so it opens the guide instead of a map it cannot draw.
+    if (!mia || (E.agents ?? []).length === 0) SECCION = 'bienvenida';
+  }
   pinta();
   pintaAvisoDeVersion();
   pintaDemoControles();
@@ -722,6 +737,7 @@ function rail(): void {
   }).join('');
   todos<HTMLElement>('#rail li').forEach((li) => {
     li.onclick = () => {
+      document.body.classList.remove('enGuia');
       SECCION = li.dataset.s ?? 'mapa';
       pinta();
     };
@@ -768,17 +784,134 @@ function pinta(): void {
 const VISTAS: Record<string, () => void> = {};
 
 // ── overview ─────────────────────────────────────────────────────────────────
+/** The guided first run. Built once and kept, so a half-finished answer
+ * survives a repaint. */
+let guia: Bienvenida | null = null;
+
+VISTAS.bienvenida = () => {
+  document.body.classList.add('enGuia');
+  guia ??= new Bienvenida({
+    api,
+    esc,
+    aviso: toast,
+    refresca,
+    vete: (seccion: string) => {
+      document.body.classList.remove('enGuia');
+      SECCION = seccion;
+      pinta();
+    },
+    ciudad: E.city_name,
+    yo: E.yo,
+    datos: corto(E.datos),
+  });
+  void guia.pinta(q<HTMLElement>('#lienzo'));
+};
+
+VISTAS.ciudades = () => {
+  const filas = E.ciudades
+    .map(
+      (c) => `
+      <div class="fila ${c.actual ? 'on' : ''}">
+        <span class="et">${esc(c.nombre)}${c.actual ? ' <b class="de">· open now</b>' : ''}</span>
+        <span class="de mono">${esc(corto(c.ruta))}</span>
+        <span style="margin-left:auto;display:flex;gap:6px">
+          ${
+            c.actual
+              ? ''
+              : `<a class="bt mini" href="?city=${encodeURIComponent(c.ruta)}">open</a>
+                 <button class="bt mini archiva" data-ciudad="${esc(c.ruta)}"
+                   data-nombre="${esc(c.nombre)}">archive</button>`
+          }
+        </span>
+      </div>`,
+    )
+    .join('');
+  q('#lienzo').innerHTML = `<div><span class="sub">cities</span>
+    <h1 style="margin-top:6px">Your cities</h1>
+    <p class="prosa" style="margin-top:8px">One person, several autonomous cities: each has
+    its own identity, domain, chair, agents and roads. They share nothing unless you build a
+    road between them. The one you have open is marked.</p></div>
+    <div class="lista"><div class="filas">${filas}</div></div>
+    <div class="campos" style="max-width:420px">
+      <div class="campo"><label>Start another city</label>
+        <input type="text" id="nuevaCiudad" placeholder="client-a, research, the book…"></div>
+      <button class="bt ppal" id="creaCiudad">Create it</button>
+    </div>
+    <p class="pista">Archiving <b>moves</b> a city into
+    <code class="mono">.backups/</code> — nothing is deleted, and you can bring it back with
+    <code class="mono">mv</code>. The city you are standing in, and the last one you own,
+    cannot be archived.</p>`;
+  enlaza();
+  const campo = q<HTMLInputElement>('#nuevaCiudad');
+  q<HTMLButtonElement>('#creaCiudad').onclick = async () => {
+    const nombre = campo.value.trim();
+    if (!nombre) {
+      toast('Give it a name', true);
+      return;
+    }
+    const r = await api<Respuesta>('/api/ciudades', {
+      method: 'POST',
+      body: JSON.stringify({ name: nombre }),
+    });
+    if (!r.ok) {
+      toast(r.error ?? 'Could not create it', true);
+      return;
+    }
+    toast(`${nombre} created`);
+    await refresca();
+  };
+  todos<HTMLButtonElement>('.archiva').forEach((boton) => {
+    boton.onclick = async () => {
+      const nombre = boton.dataset.nombre ?? '';
+      if (!window.confirm(`Archive ${nombre}? It moves into .backups — nothing is deleted.`))
+        return;
+      const r = await api<{ ok?: boolean; backup?: string; error?: string }>(
+        '/api/ciudad-archiva',
+        { method: 'POST', body: JSON.stringify({ city: boton.dataset.ciudad ?? '' }) },
+      );
+      if (!r.ok) {
+        toast(r.error ?? 'Could not archive it', true);
+        return;
+      }
+      toast(`${nombre} archived — it is in ${r.backup ?? '.backups'}`);
+      await refresca();
+    };
+  });
+};
+
 VISTAS.resumen = () => {
   const mia = E.tarjetas.find((t) => t.user === E.yo);
   const sinUnidad = E.parcelas.filter((p) => p.unidad === 'none' || p.unidad === 'mine').length;
+  const agentes = E.agents ?? [];
+  // The order somebody actually does it in: take the chair, say who works
+  // here, say what for. The old list asked for "folders" — the vocabulary of
+  // the model before agents existed — and never mentioned the roster at all,
+  // so a new city could look finished with nobody in it.
   const tareas = [
     {
       ok: !!mia,
       txt: mia
-        ? `Your card exists — you are <b>${esc(mia.agent)}</b>`
-        : 'Take your seat: role, folders, one goal',
+        ? `Your seat is taken — you are <b>${esc(mia.agent)}</b> in <b>${esc(E.domain)}</b>`
+        : 'Take your seat: the work domain and your role in it',
       ir: 'puesto',
     },
+    {
+      ok: agentes.length > 0,
+      txt:
+        agentes.length === 0
+          ? 'Add the <b>agents</b> that work in this city — each one whole: its kind, its role, and everything it works on'
+          : `<b>${agentes.length}</b> agent${agentes.length === 1 ? '' : 's'} in this city: ${esc(
+              agentes.map((a) => a.name).join(', '),
+            )}`,
+      ir: 'gente',
+    },
+    {
+      ok: agentes.length === 0 || agentes.some((a) => (a.mounts ?? []).length),
+      txt: agentes.some((a) => (a.mounts ?? []).length)
+        ? 'Your agents work on real repositories and folders'
+        : 'Give an agent something to work on — a repository, a worktree, a folder of documents',
+      ir: 'gente',
+    },
     {
       ok: !!(mia && mia.goals_defined),
       txt:
@@ -788,23 +921,33 @@ VISTAS.resumen = () => {
       ir: 'puesto',
     },
     {
-      ok: E.parcelas.length > 0 && sinUnidad === 0,
+      ok: E.parcelas.length === 0 || sinUnidad === 0,
       txt:
         E.parcelas.length === 0
-          ? 'No houses yet — pick your folders and they appear'
+          ? 'Districts appear on the map once agents have houses'
           : sinUnidad
             ? `<b>${sinUnidad}</b> of ${E.parcelas.length} houses sit in no real district — assign them`
             : 'Every house has its district',
       ir: 'barrios',
     },
   ];
+  const empezando = !mia || agentes.length === 0;
   const sesionArriba = E.tmux.includes(E.sesion);
   q('#lienzo').innerHTML = `
-    <div><span class="sub">your city</span>
-      <h1 style="margin-top:6px">${esc(E.city_name)}</h1>
+    <div><span class="sub">${empezando ? 'welcome' : 'your city'}</span>
+      <h1 style="margin-top:6px">${empezando ? 'Let’s build ' + esc(E.city_name) : esc(E.city_name)}</h1>
       <p class="de mono" style="margin-top:5px">${esc(E.address)}</p>
-      <p class="prosa" style="margin-top:8px">Domain: <b>${esc(E.domain)}</b>. Growth is
-      counted with <code class="mono">${esc(E.grow || 'nothing yet')}</code>.</p></div>
+      ${
+        empezando
+          ? `<p class="prosa" style="margin-top:8px">A city is a chair and the agents behind
+             it. Two steps and it is alive: take your seat — the work domain and your role in
+             it — then add the agents, each one asked for whole: what kind of work it does,
+             its role, everything it works on, the engine that runs it and the skills it
+             starts with. Everything below is a plain file in
+             <code class="mono">${esc(corto(E.datos))}</code> you can also edit by hand.</p>`
+          : `<p class="prosa" style="margin-top:8px">Domain: <b>${esc(E.domain)}</b>. Growth is
+             counted with <code class="mono">${esc(E.grow || 'nothing yet')}</code>.</p>`
+      }</div>
     <div class="cifras">
       <div class="cifra"><b>${Object.keys(E.skills).length}</b><span>repo agents</span></div>
       <div class="cifra"><b>${E.parcelas.length}</b><span>houses</span></div>
@@ -1909,7 +2052,8 @@ window.addEventListener('message', (message) => {
 function temaActual(): 'light' | 'dark' {
   const elegido = document.documentElement.getAttribute('data-tema');
   if (elegido) return elegido === 'claro' ? 'light' : 'dark';
-  return window.matchMedia?.('(prefers-color-scheme: light)').matches ? 'light' : 'dark';
+  // Day is the default now, so only a machine that asks for dark gets it.
+  return window.matchMedia?.('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
 }
 
 function tema(): void {
@@ -1921,14 +2065,16 @@ function tema(): void {
       return ''; // a browser with site data blocked still gets a working page
     }
   })();
-  const claroDelSistema = window.matchMedia?.('(prefers-color-scheme: light)').matches ?? false;
+  const oscuroDelSistema = window.matchMedia?.('(prefers-color-scheme: dark)').matches ?? false;
 
   const pon = (elegido: string): void => {
     const raiz = document.documentElement;
     if (elegido) raiz.setAttribute('data-tema', elegido);
     else raiz.removeAttribute('data-tema');
-    const claro = elegido ? elegido === 'claro' : claroDelSistema;
-    if (boton) boton.textContent = claro ? '☀ Day' : '☾ Night';
+    const claro = elegido ? elegido === 'claro' : !oscuroDelSistema;
+    // The button says where a click TAKES you, not where you are: a control
+    // labelled with the state you can already see is a riddle.
+    if (boton) boton.textContent = claro ? '☾ Night' : '☀ Day';
     const frame = document.querySelector<HTMLIFrameElement>('#cityMapFrame');
     frame?.contentWindow?.postMessage(
       { type: 'agents-city-map-theme/1', theme: claro ? 'light' : 'dark' },
@@ -1941,7 +2087,7 @@ function tema(): void {
     boton.onclick = () => {
       const claroAhora = document.documentElement.getAttribute('data-tema')
         ? document.documentElement.getAttribute('data-tema') === 'claro'
-        : claroDelSistema;
+        : !oscuroDelSistema;
       const elegido = claroAhora ? 'oscuro' : 'claro';
       try {
         localStorage.setItem('hall-tema', elegido);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-city",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Run autonomous agent cities: one chair seat, role-aware repo agents, repo-owned skills, and explicit roads.",
   "bin": {
     "agents-city": "bin/agents-city.js"

package/plugin/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "city",
   "displayName": "Agents City",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "One autonomous city seat with a work domain, role, goal, repo support agents, recognised skills and explicit roads to other cities.",
   "author": {
     "name": "jlcases",

package/plugin/channel/bus.js

@@ -20100,7 +20100,7 @@ try {
 }
 var chair = Boolean(context && context.actors[actor]?.role === "chair" && actor === "seat");
 var server = new Server(
-  { name: "agents-city-bus", version: "0.1.0" },
+  { name: "agents-city-bus", version: "0.2.0" },
   {
     capabilities: {
       ...channelEnabled ? { experimental: { "claude/channel": {} } } : {},

package/plugin/channel/bus.ts

@@ -24,7 +24,7 @@ try {
 
 const chair = Boolean(context && context.actors[actor]?.role === 'chair' && actor === 'seat');
 const server = new Server(
-  { name: 'agents-city-bus', version: '0.1.0' },
+  { name: 'agents-city-bus', version: '0.2.0' },
   {
     capabilities: {
       ...(channelEnabled ? { experimental: { 'claude/channel': {} } } : {}),

package/plugin/channel/runtime/codex.ts

@@ -67,7 +67,7 @@ export class CodexConnector implements RuntimeConnector {
       async (method, params) => this.providerRequest(method, params),
     );
     await this.rpc.request('initialize', {
-      clientInfo: { name: 'agents-city', title: 'Agents City', version: '0.1.0' },
+      clientInfo: { name: 'agents-city', title: 'Agents City', version: '0.2.0' },
       capabilities: { experimentalApi: true },
     });
     await this.rpc.notify('initialized');

package/plugin/channel/runtime-gateway.js

@@ -4894,7 +4894,7 @@ var CodexConnector = class {
       async (method, params) => this.providerRequest(method, params)
     );
     await this.rpc.request("initialize", {
-      clientInfo: { name: "agents-city", title: "Agents City", version: "0.1.0" },
+      clientInfo: { name: "agents-city", title: "Agents City", version: "0.2.0" },
       capabilities: { experimentalApi: true }
     });
     await this.rpc.notify("initialized");

package/plugin/scripts/cities.py

@@ -248,6 +248,40 @@ def crea(usuario, nombre_ciudad, usar=True):
     return _real(destino)
 
 
+def archiva(datos, usuario=''):
+    """Take one city out of use, keeping every byte of it.
+
+    Deliberately NOT a delete. A city is somebody's cards, deliberations and
+    map; a product that offers to erase that with one click will eventually
+    erase the wrong one. So the folder MOVES into `<user>/.backups/` with a
+    timestamp, the registry forgets it, and the selection falls back to another
+    city — recoverable with `mv`, which is a sentence a person can act on.
+
+    Returns the backup path. Refuses a city that is not this owner's managed
+    one, and refuses the last one standing: a city list with nothing in it is
+    not a state this product knows how to be in.
+    """
+    usuario = _slug(usuario or usuario_actual(), 'me')
+    real = _real(datos)
+    if not es_ciudad(real):
+        raise ValueError(f'{datos} is not a city')
+    if not gestionada(real, usuario):
+        raise ValueError('that city lives outside this owner\'s folder; move it by hand')
+    restantes = [c for c in lista(usuario) if _real(c['ruta']) != real]
+    if not restantes:
+        raise ValueError('this is your only city — create another one first')
+    base = os.path.join(carpeta_usuario(usuario), '.backups')
+    os.makedirs(base, mode=0o700, exist_ok=True)
+    destino, _ = _respaldo_libre(base, f'archivada-{nombre(real) or "city"}')
+    # The registry only ever held EXTERNAL cities — a managed one is found by
+    # walking the owner's folder, so moving it out is the whole removal.
+    seleccionada = _real(actual(usuario, crear=False) or '')
+    shutil.move(real, destino)
+    if seleccionada == real:
+        selecciona(usuario, restantes[0]['ruta'])
+    return destino
+
+
 def _registro_para(usuario):
     try:
         lineas = [l.strip() for l in open(REGISTRO, encoding='utf-8') if l.strip()]