agents-city 0.1.0 → 0.2.0

package/.claude-plugin/marketplace.json

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

package/bin/hall.html

@@ -16,62 +16,66 @@
    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. */
 :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);
+: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);
 }
-@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);
+@media(prefers-color-scheme:dark){
+  :root:not([data-tema="claro"]){
+    --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);
   }
 }
 *{box-sizing:border-box}
@@ -114,8 +118,9 @@ nav .pie a{font-family:var(--hud);font-size:12px;color:var(--tinta3);text-decora
   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,14 @@ 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>
     <ol id="rail"></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);
@@ -228,12 +229,69 @@ 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,
+      };
+    })()`);
+    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'} — 14 checks\n`);
   process.exit(fallos ? 1 : 0);
 }
 

package/bin/serve.py

@@ -679,6 +679,7 @@ class Manejador(http.server.BaseHTTPRequestHandler):
         "/api/mapa": "p_mapa",
         "/api/sesion": "p_sesion",
         "/api/ciudades": "p_ciudades",
+        "/api/ciudad-archiva": "p_archiva_ciudad",
         "/api/roads": "p_roads",
         "/api/agente": "p_agente",
         "/api/agentes": "p_agentes",
@@ -1049,6 +1050,26 @@ 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_roads(self, q, cuerpo):
         origen = self.ciudad(q)
         accion = str(cuerpo.get("action") or "")

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.0" in salida.getvalue(),
         f"calls={llamadas!r} output={salida.getvalue()!r}",
     )
 

package/bin/test-serve.py

@@ -176,18 +176,24 @@ def main():
         cabecera = pagina.split("*{box-sizing", 1)[0]
         cuerpo_css = pagina.split("*{box-sizing", 1)[1].split("</style>", 1)[0]
         afirma(
-            "· the day palette carries the tokens of agentscity.net",
-            "--dia-suelo:#f3f0e8" in cabecera
-            and "--dia-tinta:#1d2229" in cabecera
-            and "--dia-lampara:#7048e8" in cabecera,
-            cabecera[-400:],
+            "· daylight is the default skin, in the tokens of agentscity.net",
+            "--suelo:#f3f0e8" in cabecera
+            and "--tinta:#1d2229" in cabecera
+            and "--lampara:#7048e8" in cabecera,
+            cabecera[-500:],
+        )
+        afirma(
+            "· night is declared once and only mapped, never written twice",
+            "--noche-suelo:#131a24" in cabecera
+            and cabecera.count("--noche-suelo:#131a24") == 1,
+            cabecera[-500:],
         )
         afirma(
             "· an explicit choice outranks the machine's preference",
-            '[data-tema="claro"]' in cabecera
-            and "prefers-color-scheme:light" in cabecera
-            and ':root:not([data-tema="oscuro"])' in cabecera,
-            cabecera[-600:],
+            '[data-tema="oscuro"]' in cabecera
+            and "prefers-color-scheme:dark" in cabecera
+            and ':root:not([data-tema="claro"])' in cabecera,
+            cabecera[-700:],
         )
         import re as _re