agents-city 0.1.0 → 0.2.1

package/.claude-plugin/marketplace.json

@@ -9,7 +9,7 @@
     {
       "name": "city",
       "source": "./plugin",
-      "version": "0.1.0",
+      "version": "0.2.1",
       "description": "Operate one autonomous city seat, its domain, role, repo support agents, goal, recognised skills and explicit roads to other cities."
     }
   ]

package/README.es.md

@@ -1058,13 +1058,22 @@ demuestra por sí solo mayor calidad de respuesta ni una afirmación SOTA.
 
 ### `agents-city reset`
 
-Reinicia **una** ciudad gestionada conservando su identidad estable y sus repos.
+Reinicia ciudades gestionadas conservando su identidad estable y sus repos.
 
 ```bash
-agents-city reset producto --dry-run
-agents-city reset producto
+agents-city reset product --dry-run   # muestra cada efecto, no cambia nada
+agents-city reset product
+agents-city reset product cliente-a   # varias, separadas por espacios
+agents-city reset all                 # todas las de este propietario
 ```
 
+Un nombre desconocido aborta la ejecución **entera** antes de tocar nada:
+reiniciar tres ciudades y pararse en una errata es el peor final posible para un
+comando destructivo. El Hall tiene lo mismo como botón, en **Cities** — primero
+enseña qué desaparece, qué sobrevive y dónde queda la copia, y te pide escribir
+el nombre de la ciudad.
+
+
 El plan de reset:
 
 1. valida que el destino sea una ciudad gestionada, no una ruta arbitraria;

package/README.md

@@ -1045,13 +1045,21 @@ benchmark; by itself it proves neither higher answer quality nor a SOTA claim.
 
 ### `agents-city reset`
 
-Resets **one** managed city while preserving its stable identity and repositories.
+Resets managed cities while preserving their stable identity and repositories.
 
 ```bash
-agents-city reset product --dry-run
+agents-city reset product --dry-run   # show every effect, change nothing
 agents-city reset product
+agents-city reset product client-a    # several, space separated
+agents-city reset all                 # every city this owner has
 ```
 
+One unknown name aborts the **whole** run before anything is touched: resetting
+three cities and then stopping on a typo is the worst outcome a destructive
+command can have. The Hall has the same thing as a button, in **Cities** — it
+first shows what disappears, what survives and where the copy lands, and asks
+you to type the city's name.
+
 The reset plan:
 
 1. verifies the target is a managed city, not an arbitrary path;

package/bin/hall.html

@@ -11,69 +11,60 @@
 <style>
 /* The map's palette and its three typefaces. The hall manages the city the map
    draws; they must not look like two products. Single visual world on purpose. */
-/* Two skins, one set of names. Night is the city's own light — an isometric map
-   at 3am — and stays the default. Day borrows the palette of agentscity.net, so
-   the local tool and the public site are visibly the same product: its paper,
-   its ink, its violet. Nothing below this block names a colour directly. */
+/* Two skins, one set of names. DAY is the default — the palette of
+   agentscity.net, so the local tool and the public site are visibly one
+   product. Night is the map's own light, chosen with the switch and
+   remembered. Nothing below this block names a colour directly. */
 :root{
-  /* Night, the city's own light: an isometric map at 3am. The default. */
-  --suelo:#131a24; --suelo2:#1b2431; --suelo3:#222d3c; --linea:#26313f; --linea2:#38495f;
-  --tinta:#e8e2d4; --tinta2:#9aa7b8; --tinta3:#6b7889;
-  --lampara:#f5c451; --carta:#e2604f; --verde:#4ec98a;
-  --panel:#101720; --burbuja:#171f2a; --burbuja-mia:#27291f;
-  --borde-acento:#65552d; --sobre-lampara:#1a1408; --lampara-viva:#ffd469;
-  --chip-luz:36% 30%; --chip-tinta:#f3eee4;
-  --tono-palabra:#aa93ff; --tono-evidencia:#61ace9; --tono-verificacion:#50ccb1;
+  /* Day is the default: the palette of agentscity.net, so the tool on your
+     machine and the public site are one product from the first second. Night
+     is one click away and remembered — it is the map's own light, not the
+     app's. */
+  --suelo:#f3f0e8; --suelo2:#fbfaf6; --suelo3:#ffffff;
+  --linea:#e2ddd0; --linea2:#cdc6b6;
+  --tinta:#1d2229; --tinta2:#515861; --tinta3:#7b8187;
+  --lampara:#7048e8; --carta:#dd5d3e; --verde:#5f8f2b;
+  --panel:#fbfaf6; --burbuja:#ffffff; --burbuja-mia:#f4efff;
+  --borde-acento:#c9b8ff; --sobre-lampara:#ffffff; --lampara-viva:#5331bd;
+  --chip-luz:52% 86%; --chip-tinta:#1d2229;
+  --tono-palabra:#6b46f0; --tono-evidencia:#2b7ab8; --tono-verificacion:#1c8d78;
   --hud:"Chakra Petch",system-ui,sans-serif; --texto:"Newsreader",Georgia,serif;
   --mono:"IBM Plex Mono",ui-monospace,monospace;
-  --sombra:none;
+  --sombra:0 18px 40px -30px #1d222945;
 
-  /* Day, declared once: the tokens of agentscity.net — its paper, its ink, its
-     violet — so the tool on your machine and the public site are one product.
-     The two rules below only MAP these; a palette written twice drifts twice. */
-  --dia-suelo:#f3f0e8; --dia-suelo2:#fbfaf6; --dia-suelo3:#ffffff;
-  --dia-linea:#e2ddd0; --dia-linea2:#cdc6b6;
-  --dia-tinta:#1d2229; --dia-tinta2:#515861; --dia-tinta3:#7b8187;
-  --dia-lampara:#7048e8; --dia-carta:#dd5d3e; --dia-verde:#5f8f2b;
-  --dia-panel:#fbfaf6; --dia-burbuja:#ffffff; --dia-burbuja-mia:#f4efff;
-  --dia-borde-acento:#c9b8ff; --dia-sobre-lampara:#ffffff; --dia-lampara-viva:#5331bd;
-  --dia-chip-luz:52% 86%; --dia-chip-tinta:#1d2229;
-  --dia-tono-palabra:#6b46f0; --dia-tono-evidencia:#2b7ab8;
-  --dia-tono-verificacion:#1c8d78;
-  --dia-sombra:0 18px 40px -30px #1d222945;
+  /* Night, declared once: the city's own light, an isometric map at 3am. The
+     two rules below only MAP these; a palette written twice drifts twice. */
+  --noche-suelo:#131a24; --noche-suelo2:#1b2431; --noche-suelo3:#222d3c;
+  --noche-linea:#26313f; --noche-linea2:#38495f;
+  --noche-tinta:#e8e2d4; --noche-tinta2:#9aa7b8; --noche-tinta3:#6b7889;
+  --noche-lampara:#f5c451; --noche-carta:#e2604f; --noche-verde:#4ec98a;
+  --noche-panel:#101720; --noche-burbuja:#171f2a; --noche-burbuja-mia:#27291f;
+  --noche-borde-acento:#65552d; --noche-sobre-lampara:#1a1408;
+  --noche-lampara-viva:#ffd469;
+  --noche-chip-luz:36% 30%; --noche-chip-tinta:#f3eee4;
+  --noche-tono-palabra:#aa93ff; --noche-tono-evidencia:#61ace9;
+  --noche-tono-verificacion:#50ccb1;
+  --noche-sombra:none;
 }
-/* One skin's worth of mapping, used by the explicit choice and by the system
-   preference alike. An explicit choice always outranks the machine's. */
-:root[data-tema="claro"]{
-  --suelo:var(--dia-suelo); --suelo2:var(--dia-suelo2); --suelo3:var(--dia-suelo3);
-  --linea:var(--dia-linea); --linea2:var(--dia-linea2);
-  --tinta:var(--dia-tinta); --tinta2:var(--dia-tinta2); --tinta3:var(--dia-tinta3);
-  --lampara:var(--dia-lampara); --carta:var(--dia-carta); --verde:var(--dia-verde);
-  --panel:var(--dia-panel); --burbuja:var(--dia-burbuja); --burbuja-mia:var(--dia-burbuja-mia);
-  --borde-acento:var(--dia-borde-acento); --sobre-lampara:var(--dia-sobre-lampara);
-  --lampara-viva:var(--dia-lampara-viva);
-  --chip-luz:var(--dia-chip-luz); --chip-tinta:var(--dia-chip-tinta);
-  --tono-palabra:var(--dia-tono-palabra); --tono-evidencia:var(--dia-tono-evidencia);
-  --tono-verificacion:var(--dia-tono-verificacion);
-  --sombra:var(--dia-sombra);
-}
-@media(prefers-color-scheme:light){
-  :root:not([data-tema="oscuro"]){
-    --suelo:var(--dia-suelo); --suelo2:var(--dia-suelo2); --suelo3:var(--dia-suelo3);
-    --linea:var(--dia-linea); --linea2:var(--dia-linea2);
-    --tinta:var(--dia-tinta); --tinta2:var(--dia-tinta2); --tinta3:var(--dia-tinta3);
-    --lampara:var(--dia-lampara); --carta:var(--dia-carta); --verde:var(--dia-verde);
-    --panel:var(--dia-panel); --burbuja:var(--dia-burbuja); --burbuja-mia:var(--dia-burbuja-mia);
-    --borde-acento:var(--dia-borde-acento); --sobre-lampara:var(--dia-sobre-lampara);
-    --lampara-viva:var(--dia-lampara-viva);
-    --chip-luz:var(--dia-chip-luz); --chip-tinta:var(--dia-chip-tinta);
-    --tono-palabra:var(--dia-tono-palabra); --tono-evidencia:var(--dia-tono-evidencia);
-    --tono-verificacion:var(--dia-tono-verificacion);
-  --tono-palabra:var(--dia-tono-palabra); --tono-evidencia:var(--dia-tono-evidencia);
-  --tono-verificacion:var(--dia-tono-verificacion);
-    --sombra:var(--dia-sombra);
-  }
+/* Night, mapped from the tokens declared once above. */
+:root[data-tema="oscuro"]{
+  --suelo:var(--noche-suelo); --suelo2:var(--noche-suelo2); --suelo3:var(--noche-suelo3);
+  --linea:var(--noche-linea); --linea2:var(--noche-linea2);
+  --tinta:var(--noche-tinta); --tinta2:var(--noche-tinta2); --tinta3:var(--noche-tinta3);
+  --lampara:var(--noche-lampara); --carta:var(--noche-carta); --verde:var(--noche-verde);
+  --panel:var(--noche-panel); --burbuja:var(--noche-burbuja);
+  --burbuja-mia:var(--noche-burbuja-mia);
+  --borde-acento:var(--noche-borde-acento); --sobre-lampara:var(--noche-sobre-lampara);
+  --lampara-viva:var(--noche-lampara-viva);
+  --chip-luz:var(--noche-chip-luz); --chip-tinta:var(--noche-chip-tinta);
+  --tono-palabra:var(--noche-tono-palabra); --tono-evidencia:var(--noche-tono-evidencia);
+  --tono-verificacion:var(--noche-tono-verificacion);
+  --sombra:var(--noche-sombra);
 }
+/* No `prefers-color-scheme` rule on purpose: daylight is THE default, not a
+   default that a machine set to dark quietly overrides. Night is a choice made
+   here, with the switch, and remembered — which is why an owner whose whole
+   desktop is dark still opens a paper-coloured hall. */
 *{box-sizing:border-box}
 html,body{height:100%}
 body{margin:0;background:var(--suelo);color:var(--tinta);font-family:var(--texto);
@@ -101,6 +92,13 @@ nav{background:var(--suelo2);border-right:1px solid var(--linea);padding:20px 0
 .badge::before{content:"";width:5px;height:5px;border-radius:50%;background:var(--lampara)}
 .marca h2{font-size:19px;margin:9px 0 0}
 .marca p{margin:4px 0 0;font-size:12px;color:var(--tinta3);line-height:1.45}
+.railCiudad{margin:0 18px;padding:10px 12px;border-radius:7px;background:var(--suelo3);
+  border:1px solid var(--linea);display:flex;flex-direction:column;gap:2px}
+.railCiudad .railEtiqueta{font:600 9px var(--hud);letter-spacing:.16em;text-transform:uppercase;
+  color:var(--tinta3)}
+.railCiudad b{font:600 15px var(--hud);color:var(--tinta)}
+.railCiudad .railDe{font:10.5px var(--mono);color:var(--tinta3)}
+.railOtras{margin-top:6px;padding-top:6px;border-top:1px solid var(--linea)}
 nav ol{list-style:none;margin:0;padding:0 10px;display:flex;flex-direction:column;gap:2px}
 nav li{display:flex;gap:10px;align-items:baseline;padding:9px 10px;border-radius:3px;
   font-family:var(--hud);font-size:13.5px;color:var(--tinta2);cursor:pointer;white-space:nowrap}
@@ -110,12 +108,19 @@ nav li .n{font-family:var(--mono);font-size:10px;color:var(--tinta3);margin-left
 nav .pie{margin-top:auto;padding:14px 18px 0;border-top:1px solid var(--linea);
   display:flex;flex-direction:column;gap:8px}
 nav .pie a{font-family:var(--hud);font-size:12px;color:var(--tinta3);text-decoration:none}
+.peligro{border:1px solid var(--carta);border-radius:8px;padding:16px 18px;
+  background:color-mix(in srgb,var(--carta) 7%,var(--suelo2));display:flex;
+  flex-direction:column;gap:10px;align-items:flex-start}
+.peligro h3{font:600 13px var(--hud);color:var(--carta)}
+.bt.malo{border-color:var(--carta);color:var(--carta)}
+.bt.malo:hover{background:var(--carta);color:var(--suelo2)}
 .avisoVersion{margin:0;font:11px/1.45 var(--mono);color:var(--lampara);
   border:1px solid var(--borde-acento);background:var(--burbuja-mia);
   padding:7px 9px;border-radius:4px}
 .avisoVersion[hidden]{display:none}
-.temaBoton{align-self:flex-start;border:1px solid var(--linea2);background:var(--suelo3);
-  color:var(--tinta2);font:11px var(--mono);padding:4px 9px;border-radius:4px;cursor:pointer}
+.temaBoton{margin-top:12px;border:1px solid var(--linea2);background:var(--suelo3);
+  color:var(--tinta2);font:11px var(--mono);padding:5px 11px;border-radius:999px;
+  cursor:pointer;box-shadow:var(--sombra)}
 .temaBoton:hover{color:var(--lampara);border-color:var(--lampara)}
 nav .pie a:hover{color:var(--lampara)}
 #ciudades select{width:100%;background:var(--suelo);border:1px solid var(--linea2);
@@ -305,6 +310,51 @@ input[type=text]:focus,select:focus{outline:none;border-color:var(--lampara)}
   color:var(--lampara);font:12px var(--mono);padding:7px 14px;border-radius:5px;
   cursor:pointer}
 .rpgAlta:hover{background:var(--suelo);border-color:var(--lampara)}
+
+/* ── the guided first run ────────────────────────────────────────────────── */
+.bv{display:flex;flex-direction:column;gap:26px;max-width:min(760px,100%)}
+.bv .prosa{max-width:100%}
+.bv code.mono{word-break:break-all}
+/* The live rail has nothing to show before a city exists, and it costs half
+   the screen exactly when the guide needs it. */
+body.enGuia #livePanel,body.enGuia #liveResize{display:none}
+body.enGuia #app{grid-template-columns:250px minmax(0,1fr)}
+.bvPasos{display:flex;gap:6px;flex-wrap:wrap;align-items:center}
+.bvPunto{display:flex;align-items:center;gap:6px;font:10px var(--hud);letter-spacing:.1em;
+  text-transform:uppercase;color:var(--tinta3)}
+.bvPunto i{width:8px;height:8px;border-radius:50%;background:var(--linea2);display:block}
+.bvPunto+.bvPunto{margin-left:10px}
+.bvPunto.aqui{color:var(--lampara)}.bvPunto.aqui i{background:var(--lampara)}
+.bvPunto.hecho i{background:var(--verde)}
+.bvHola{display:grid;grid-template-columns:auto 1fr;gap:26px;align-items:start}
+@media(max-width:820px){.bvHola{grid-template-columns:1fr}}
+.bvArte{display:flex;flex-direction:column;gap:2px;padding-top:6px}
+.bvCasa{width:92px;height:83px;margin-bottom:-26px;filter:drop-shadow(var(--sombra))}
+.bvPaso{display:flex;flex-direction:column;gap:14px}
+.bvPaso h1{font-size:26px;line-height:1.15}
+.bvEtiqueta{font:600 10px var(--hud);letter-spacing:.14em;text-transform:uppercase;
+  color:var(--tinta3)}
+.bvRejilla{display:grid;grid-template-columns:repeat(auto-fill,minmax(220px,1fr));gap:8px}
+.bvRejilla.bvTres{grid-template-columns:repeat(auto-fit,minmax(210px,1fr))}
+.bvOpcion{text-align:left;display:flex;flex-direction:column;gap:4px;padding:12px 13px;
+  border:1px solid var(--linea2);border-radius:7px;background:var(--suelo2);cursor:pointer}
+.bvOpcion b{font-family:var(--hud);font-size:13px;color:var(--tinta)}
+.bvOpcion span{font-size:12px;line-height:1.45;color:var(--tinta3)}
+.bvOpcion:hover{border-color:var(--lampara)}
+.bvOpcion.elegida{border-color:var(--lampara);background:var(--burbuja-mia);
+  box-shadow:inset 3px 0 0 var(--lampara)}
+.bvChips{display:flex;flex-wrap:wrap;gap:6px}
+.bvChip{border:1px solid var(--linea2);background:var(--suelo2);color:var(--tinta2);
+  font:11px var(--mono);padding:5px 10px;border-radius:999px;cursor:pointer}
+.bvChip:hover{border-color:var(--lampara)}
+.bvChip.elegida{border-color:var(--lampara);background:var(--burbuja-mia);color:var(--tinta)}
+.bvFichas{display:flex;flex-direction:column;gap:6px}
+.bvFicha{display:flex;gap:10px;align-items:baseline;padding:9px 12px;border-radius:6px;
+  border:1px solid var(--linea);background:var(--suelo2)}
+.bvFicha b{font-family:var(--hud);font-size:13px}
+.bvFicha span{font:11px var(--mono);color:var(--tinta3)}
+.bvBotones{display:flex;gap:9px;flex-wrap:wrap;margin-top:4px}
+.bvSiguientes{display:flex;gap:9px;flex-wrap:wrap}
 /* The instruction editor: one file, one reader, saved where the agent lives. */
 #editorIns{position:fixed;inset:0;background:rgba(6,10,15,.72);z-index:60;
   display:flex;align-items:center;justify-content:center}
@@ -442,15 +492,16 @@ input[type=text]:focus,select:focus{outline:none;border-color:var(--lampara)}
       <span class="badge">town hall</span>
       <h2>Agents City</h2>
       <p>Manage one autonomous city: its seat, repo agents, roads and map. Everything here is a plain file you can also inspect by hand.</p>
+      <button type="button" id="temaBoton" class="temaBoton"
+        title="Daylight is the default; night is the map's own light">☾ Night</button>
     </div>
+    <div id="railCiudad" class="railCiudad"></div>
     <ol id="rail"></ol>
+    <ol id="railOtras" class="railOtras"></ol>
     <div id="ciudades" style="padding:0 18px"></div>
     <div class="pie">
       <p id="avisoVersion" class="avisoVersion" hidden></p>
       <a href="#" id="alWizard">Create another city →</a>
-      <button type="button" id="temaBoton" class="temaBoton"
-        title="Switch between the night city and the daylight palette of agentscity.net">
-        ☾ Night</button>
       <span class="dato" id="dondeDatos"></span>
     </div>
   </nav>

package/bin/navegador.mjs

@@ -108,6 +108,7 @@ function comprueba(texto, bien, detalle = '') {
 
 async function main() {
   const url = process.argv[2];
+  const ciudadVacia = process.argv[3] || '';
   if (!url) {
     console.error('usage: navegador.mjs <hall url>');
     process.exit(2);
@@ -176,8 +177,8 @@ async function main() {
 
     // The agents view: this is where dead controls shipped once.
     const abierto = await cdp.evalua(`(async () => {
-      const ir = [...document.querySelectorAll('nav li')].find(l => /agents/i.test(l.textContent));
-      if (!ir) return { falta: 'no agents entry' };
+      const ir = [...document.querySelectorAll('nav li')].find(l => /houses/i.test(l.textContent));
+      if (!ir) return { falta: 'no houses entry' };
       ir.click();
       for (let i = 0; i < 40; i++) {
         if (document.querySelector('.fichaRPG')) break;
@@ -194,9 +195,9 @@ async function main() {
         test: boton('.rpgTest'),
       };
     })()`);
-    comprueba('the agents view renders its sheets', (abierto?.fichas ?? 0) > 0, JSON.stringify(abierto));
+    comprueba('the houses view renders its sheets', (abierto?.fichas ?? 0) > 0, JSON.stringify(abierto));
     for (const [control, etiqueta] of [
-      ['alta', '+ Add an agent'],
+      ['alta', 'the build-a-house button'],
       ['instrucciones', 'the CLAUDE.md / AGENTS.md editors'],
       ['subir', 'the skill zip upload'],
       ['monta', 'the + folder mount button'],
@@ -228,12 +229,97 @@ async function main() {
       JSON.stringify(modal),
     );
 
+    // The guided first run, checked against a city with nobody in it: that is
+    // the only state where it appears, and it is the screen that used to say
+    // "Not drawn yet" to somebody arriving for the first time.
+    if (ciudadVacia) {
+      await cdp.manda('Page.navigate', {
+        url: url + '&city=' + encodeURIComponent(ciudadVacia),
+      });
+      for (let i = 0; i < 60; i += 1) {
+        const listo = await cdp.evalua('!!document.getElementById("rail") && !!window.PASE');
+        if (listo) break;
+        await dormir(250);
+      }
+    }
+    const guia = await cdp.evalua(`(async () => {
+      for (let i = 0; i < 40; i++) {
+        if (document.querySelector('.bvPasos')) break;
+        await new Promise(r => setTimeout(r, 250));
+      }
+      const pasos = [...document.querySelectorAll('.bvPunto')].map(p => p.textContent.trim());
+      const b = document.querySelector('[data-bv="siguiente"]');
+      if (b) b.click();
+      await new Promise(r => setTimeout(r, 900));
+      return {
+        pasos,
+        titulo: document.querySelector('.bvPaso h1')?.textContent?.trim() ?? '',
+        opciones: document.querySelectorAll('.bvOpcion').length,
+      };
+    })()`);
+    comprueba(
+      'a city with no agents opens the guide, not an empty map',
+      (guia?.pasos?.length ?? 0) >= 4,
+      JSON.stringify(guia),
+    );
+    comprueba(
+      'and its first question offers the work domains to choose from',
+      /work happens here/i.test(guia?.titulo ?? '') && (guia?.opciones ?? 0) > 3,
+      JSON.stringify(guia),
+    );
+
+    // Cities: a person must be able to start and retire one without a terminal.
+    const ciudades = await cdp.evalua(`(async () => {
+      const ir = [...document.querySelectorAll('nav li')].find(l => /cities/i.test(l.textContent));
+      if (!ir) return { falta: true };
+      ir.click();
+      await new Promise(r => setTimeout(r, 700));
+      return {
+        crear: !!document.getElementById('creaCiudad'),
+        campo: !!document.getElementById('nuevaCiudad'),
+        filas: document.querySelectorAll('.lista .fila').length,
+      };
+    })()`);
+    const reinicio = await cdp.evalua(`(async () => {
+      const b = document.getElementById('reiniciaCiudad');
+      if (!b) return { falta: true };
+      // Nothing is clicked here: this asks the server what a reset WOULD do,
+      // which is the same call the button makes before it dares ask anything.
+      const r = await fetch('/api/ciudad-reinicia?PASE=' + window.PASE, {
+        method: 'POST',
+        headers: { 'X-City-Pase': window.PASE, 'Content-Type': 'application/json' },
+        body: '{}',
+      }).then((x) => x.json());
+      return { cableado: !!b.onclick, ok: r.ok, previa: r.preview, error: r.error };
+    })()`);
+    comprueba(
+      'the danger button exists and is wired',
+      reinicio?.cableado === true,
+      JSON.stringify(reinicio),
+    );
+    comprueba(
+      // Two acceptable answers, one forbidden: a preview of what would happen,
+      // or a refusal (this fixture's city lives outside the owner's folder and
+      // reset declines to touch such a thing). What must NEVER come back from a
+      // call with no typed name is ok:true — that would be a reset on one click.
+      'without the typed name it previews or refuses, but never resets',
+      reinicio?.ok !== true &&
+        (Array.isArray(reinicio?.previa?.loses) || typeof reinicio?.error === 'string'),
+      JSON.stringify(reinicio),
+    );
+
+    comprueba(
+      'the Cities section can start a new city',
+      ciudades?.crear === true && ciudades?.campo === true,
+      JSON.stringify(ciudades),
+    );
+
     const errores = await cdp.evalua('window.__erroresDePagina ? window.__erroresDePagina.length : 0');
     comprueba('the page raised no uncaught errors while we drove it', errores === 0, String(errores));
   } finally {
     proceso.kill('SIGKILL');
   }
-  console.log(`\n  ${fallos ? `${fallos} failed` : 'browser ok'} — 11 checks\n`);
+  console.log(`\n  ${fallos ? `${fallos} failed` : 'browser ok'} — 16 checks\n`);
   process.exit(fallos ? 1 : 0);
 }
 

package/bin/serve.py

@@ -48,6 +48,7 @@ import avatar  # noqa: E402
 import workspace  # noqa: E402
 import crecimiento  # noqa: E402
 import runtime_processes  # noqa: E402
+import reset as reinicio  # noqa: E402
 import actualiza  # noqa: E402
 import importlib.machinery as _mach
 import importlib.util as _iu  # noqa: E402
@@ -175,6 +176,16 @@ def skills_de_ciudad(datos):
     return valor
 
 
+def estado_seguro_agentes(datos):
+    """How many agents this city has, or none when the card cannot be read."""
+    owner = cities.lee_clave(datos, "owner") or seat.quien_soy()
+    try:
+        texto = card.lee(os.path.join(datos, f"{owner}.md")).get("texto") or ""
+        return workspace.agentes(texto, datos)
+    except (OSError, ValueError):
+        return []
+
+
 def olvida_skills():
     """Forget the discovery memo: a skill was installed or removed, and that
     changes the answer without touching the card."""
@@ -426,10 +437,20 @@ def lee_clave(fichero, clave, defecto=""):
 
 
 def lista_con(datos):
+    """Every city this owner has, with the one being looked at marked — and how
+    many agents live in each.
+
+    The count is not decoration: an agent belongs to ONE city because its
+    workspace and its mounts live inside that city's folder, and a menu that
+    lists "Cities" and "Agents" as two unrelated things hides exactly that. One
+    card read per city, which is cheaper than the page that draws it.
+    """
     real = os.path.realpath(datos)
     fuera = [dict(c, actual=(c["ruta"] == real)) for c in cities.lista(seat.quien_soy())]
     if not any(c["actual"] for c in fuera):
         fuera.insert(0, {"ruta": real, "nombre": cities.nombre(real), "actual": True})
+    for c in fuera:
+        c["agentes"] = len(estado_seguro_agentes(c["ruta"]))
     return fuera
 
 
@@ -679,6 +700,8 @@ class Manejador(http.server.BaseHTTPRequestHandler):
         "/api/mapa": "p_mapa",
         "/api/sesion": "p_sesion",
         "/api/ciudades": "p_ciudades",
+        "/api/ciudad-archiva": "p_archiva_ciudad",
+        "/api/ciudad-reinicia": "p_reinicia_ciudad",
         "/api/roads": "p_roads",
         "/api/agente": "p_agente",
         "/api/agentes": "p_agentes",
@@ -1049,6 +1072,70 @@ class Manejador(http.server.BaseHTTPRequestHandler):
             {"ok": True, "city": datos, "address": cities.direccion(usuario, datos)}
         )
 
+    def p_archiva_ciudad(self, q, cuerpo):
+        """Take one city out of use — recoverably, and never the last one.
+
+        Not a delete: `cities.archiva` MOVES the folder into the owner's
+        backups. A city is somebody's cards, deliberations and map, and a
+        product that erases that on one click will erase the wrong one.
+        """
+        pedida = str(cuerpo.get("city") or "")
+        usuario = seat.quien_soy()
+        datos = cities.resuelve(pedida, usuario) if pedida else ""
+        if not datos:
+            return self.responde({"error": f"no city called {pedida!r}"}, codigo=404)
+        try:
+            copia = cities.archiva(datos, usuario)
+        except (OSError, ValueError) as e:
+            return self.responde({"error": str(e)}, codigo=409)
+        return self.responde(
+            {"ok": True, "backup": copia, "ciudades": lista_con(cities.actual(usuario))}
+        )
+
+    def p_reinicia_ciudad(self, q, cuerpo):
+        """Take a city back to its first day — after showing exactly what that
+        means, and only when the person types its name.
+
+        Two calls, on purpose. Without `confirm` it answers with the effects and
+        changes nothing; with `confirm` matching the city's own name it does the
+        work. A dangerous button that fires on one click will eventually be
+        clicked by an elbow, and the answer "are you sure?" is not information —
+        the list below is.
+        """
+        datos = self.ciudad(q)
+        usuario = cities.lee_clave(datos, "owner") or seat.quien_soy()
+        nombre = cities.nombre(datos)
+        try:
+            copia = reinicio.reinicia(datos, usuario, dry_run=True)
+        except (OSError, ValueError) as e:
+            return self.responde({"error": str(e)}, codigo=409)
+        agentes = len(estado_seguro_agentes(datos))
+        efectos = {
+            "city": nombre,
+            "backup": copia,
+            "agents": agentes,
+            "roads": len(roads.lee(datos)),
+            "deliberations": len(deliberations.lista(datos)),
+            "keeps": [
+                "every repository and folder your agents mount — untouched",
+                f"a full copy of this city at {copia}",
+            ],
+            "loses": [
+                "your seat card: role, goal and the whole roster",
+                "each agent's workspace, its mounts and the skills installed in it",
+                "the committee history and every recorded decision",
+                "the map's districts and houses",
+            ],
+        }
+        if str(cuerpo.get("confirm") or "") != nombre:
+            return self.responde({"ok": False, "preview": efectos})
+        try:
+            copia = reinicio.reinicia(datos, usuario)
+        except (OSError, ValueError) as e:
+            return self.responde({"error": str(e)}, codigo=409)
+        olvida_skills()
+        return self.responde({"ok": True, "backup": copia, "preview": efectos})
+
     def p_roads(self, q, cuerpo):
         origen = self.ciudad(q)
         accion = str(cuerpo.get("action") or "")

package/bin/test-cities.py

@@ -438,6 +438,50 @@ def skills_transparentes():
         comprueba("· there is no stale capability cache", nombres, ["safe-deploy", "audit"])
 
 
+def reset_de_varias():
+    """`reset` takes several cities, or `all` — and stops before touching any
+    of them when one name is wrong.
+
+    Resetting three of four cities and then failing on a typo is the worst
+    possible outcome of a destructive command, so resolution happens first and
+    completely.
+    """
+    print("  resetting more than one city")
+    base = tempfile.mkdtemp()
+    previo = {k: os.environ.get(k) for k in ("AGENTS_CITY_HOME", "AGENTS_CITY_USER")}
+    os.environ.update(AGENTS_CITY_HOME=base, AGENTS_CITY_USER="ana")
+    registro = cities.REGISTRO
+    cities.REGISTRO = os.path.join(base, "reg")
+    try:
+        for n in ("home", "producto", "cliente"):
+            cities.crea("ana", n)
+        entorno = dict(os.environ, AGENTS_CITY_HOME=base, AGENTS_CITY_USER="ana")
+        guion = os.path.join(RAIZ, "plugin", "scripts", "reset.py")
+
+        r = subprocess.run(["python3", guion, "all", "--dry-run"],
+                           capture_output=True, text=True, env=entorno)
+        comprueba("· `all` covers every city this owner has",
+                  sum(1 for ln in r.stdout.splitlines() if "Would reset" in ln), 3)
+        r = subprocess.run(["python3", guion, "home", "cliente", "--dry-run"],
+                           capture_output=True, text=True, env=entorno)
+        afirma("· several names, space separated, cover exactly those",
+               "`home`" in r.stdout and "`cliente`" in r.stdout and "`producto`" not in r.stdout,
+               r.stdout)
+        r = subprocess.run(["python3", guion, "home", "inventada", "--dry-run"],
+                           capture_output=True, text=True, env=entorno)
+        afirma("· one unknown name aborts the whole run, before any city is touched",
+               r.returncode == 1 and "Nothing was reset" in r.stderr, r.stderr)
+        comprueba("· so nothing was reset", len(cities.lista("ana")), 3)
+    finally:
+        cities.REGISTRO = registro
+        for k, v in previo.items():
+            if v is None:
+                os.environ.pop(k, None)
+            else:
+                os.environ[k] = v
+        shutil.rmtree(base, ignore_errors=True)
+
+
 def main():
     print()
     identidad_y_catalogo()
@@ -446,6 +490,7 @@ def main():
     carreteras()
     reinicio_aislado()
     skills_transparentes()
+    reset_de_varias()
     return resumen("cities")
 
 

package/bin/test-navegador.py

@@ -95,13 +95,20 @@ def main():
     )
     ciudad_de_prueba(datos)
 
+    # A SECOND city, deliberately empty: the guide only appears where there is
+    # nothing yet, and the first fixture has an agent so the sheets can render.
+    try:
+        vacia = serve.cities.crea("navtest", "sin-nadie", usar=False)
+    except (OSError, ValueError):
+        vacia = ""
+
     servidor = serve.Servidor(("127.0.0.1", 0), serve.Manejador)
     hilo = threading.Thread(target=servidor.serve_forever, daemon=True)
     hilo.start()
     url = f"http://127.0.0.1:{servidor.server_port}/?PASE={serve.PASE}"
     try:
         salida = subprocess.run(
-            ["node", os.path.join(AQUI, "navegador.mjs"), url],
+            ["node", os.path.join(AQUI, "navegador.mjs"), url, vacia],
             capture_output=True,
             text=True,
             timeout=300,

package/bin/test-seat.py

@@ -518,7 +518,7 @@ def maquinas_hostiles():
         "· an old cached Claude plugin is updated through Claude's own CLI",
         llamadas
         and llamadas[0][:4] == ["claude", "plugin", "update", "city@agents-city"]
-        and "0.1.0" in salida.getvalue(),
+        and "0.2.1" in salida.getvalue(),
         f"calls={llamadas!r} output={salida.getvalue()!r}",
     )