agents-city 0.3.0 → 0.4.0

package/demo/grabaciones/software.jsonl

@@ -0,0 +1,22 @@
+{"actor": "seat", "details": ["Desired outcome: Que cada persona afectada recupere lo suyo, y saber qué contamos públicamente y cuándo.", "Definition of done: Cada cuenta afectada tiene un camino para recuperar su partida · Mensaje público con hora y explicación honesta", "Invited: nova, store-service, telemetry-collector"], "kind": "committee.opened", "phase": "collecting", "protocol": "agents-city-activity/1", "role": "chair", "seq": 1, "summary": "¿Qué hacemos con las partidas que desaparecieron el sábado?", "title": "The chair opened a committee", "tone": "question"}
+{"actor": "nova", "details": ["1/3 positions received"], "kind": "committee.position.submitted", "phase": "collecting", "protocol": "agents-city-activity/1", "role": "member", "seq": 2, "summary": "Its content stays sealed until every selected specialist has answered.", "target": "seat", "title": "nova submitted an independent position", "tone": "work"}
+{"actor": "store-service", "details": ["2/3 positions received"], "kind": "committee.position.submitted", "phase": "collecting", "protocol": "agents-city-activity/1", "role": "member", "seq": 3, "summary": "Its content stays sealed until every selected specialist has answered.", "target": "seat", "title": "store-service submitted an independent position", "tone": "work"}
+{"actor": "telemetry-collector", "details": ["3/3 positions received"], "kind": "committee.position.submitted", "phase": "review", "protocol": "agents-city-activity/1", "role": "member", "seq": 4, "summary": "The collection barrier is complete; all positions can now be revealed together.", "target": "seat", "title": "telemetry-collector submitted an independent position", "tone": "work"}
+{"actor": "seat", "details": ["The chair can now compare evidence, conflicts and unknowns without anchoring bias."], "kind": "committee.positions.revealed", "phase": "review", "protocol": "agents-city-activity/1", "role": "chair", "seq": 5, "summary": "3 specialists completed the blind first round.", "title": "All independent positions were revealed together", "tone": "evidence"}
+{"actor": "nova", "details": ["Stance: support", "Evidence: 412 mensajes en soporte y subiendo", "Evidence: Una madre escribió: su hijo perdió seis meses de partida y no deja de llorar", "Expected impact: La gente aguanta un fallo; no aguanta el silencio", "Visible when: En cuanto publiquemos el primer mensaje", "Risk: Prometer una hora y no llegar"], "kind": "committee.position.revealed", "phase": "review", "protocol": "agents-city-activity/1", "role": "member", "seq": 6, "summary": "Lo primero es la gente: congelar la actualización del viernes y decir hoy mismo, en público, que lo sabemos y estamos en ello.", "target": "committee", "title": "nova proposes", "tone": "evidence"}
+{"actor": "store-service", "details": ["Stance: conditional", "Evidence: Las copias del jueves por la noche están completas y verificadas", "Evidence: Ningún acceso extraño en todo el fin de semana", "Expected impact: Recuperar lo perdido sin inventar nada", "Visible when: Al restaurar la primera tanda", "Risk: Restaurar borra lo que se jugó después del jueves"], "kind": "committee.position.revealed", "phase": "review", "protocol": "agents-city-activity/1", "role": "member", "seq": 7, "summary": "Nadie ha entrado a robar nada: no es un ataque. El viernes cambiamos cómo se guardan las partidas sin dejar puerta de vuelta. Propongo recuperar las copias de la noche del jueves antes de tocar nada más.", "target": "committee", "title": "store-service proposes", "tone": "evidence"}
+{"actor": "telemetry-collector", "details": ["Stance: conditional", "Evidence: 3.804 cuentas afectadas por ahora", "Evidence: Casi todas jugaron el sábado entre las 22h y la 1h", "Expected impact: Avisar a los afectados directamente, no a bulto", "Visible when: Con la lista de cuentas en la mano", "Unknown: Cuántos afectados aún no han abierto el juego y no lo saben"], "kind": "committee.position.revealed", "phase": "review", "protocol": "agents-city-activity/1", "role": "member", "seq": 8, "summary": "Antes de decidir, contar bien a cuánta gente le pasa y a quién. No es todo el mundo: es una franja concreta, y eso dice dónde mirar.", "target": "committee", "title": "telemetry-collector proposes", "tone": "evidence"}
+{"actor": "seat", "details": ["Agreement: No es un ataque", "Agreement: La causa es el cambio del viernes", "Agreement: Hay copias del jueves por la noche", "Conflict: Avisar primero o restaurar primero", "Unknown: Afectados que aún no lo saben"], "kind": "committee.synthesis.published", "phase": "deliberating", "protocol": "agents-city-activity/1", "role": "chair", "seq": 9, "summary": "Los tres coinciden: no es un ataque, viene del cambio del viernes y hay copias del jueves. La discusión es el orden: ¿avisamos primero o restauramos primero?", "title": "The chair published the synthesis", "tone": "evidence"}
+{"actor": "nova", "details": ["Basis: new evidence", "Evidence: Un streamer con dos millones de seguidores acaba de subir un vídeo enseñando su partida vacía"], "kind": "committee.floor.requested", "phase": "deliberating", "protocol": "agents-city-activity/1", "role": "member", "seq": 10, "summary": "Esto acaba de dejar de ser solo un problema técnico.", "target": "seat", "title": "nova requested the floor", "tone": "floor"}
+{"actor": "seat", "details": ["Request: Esto acaba de dejar de ser solo un problema técnico.", "Evidence: Un streamer con dos millones de seguidores acaba de subir un vídeo enseñando su partida vacía"], "kind": "committee.floor.granted", "phase": "deliberating", "protocol": "agents-city-activity/1", "role": "chair", "seq": 11, "summary": "One scoped reply was granted for new evidence.", "target": "nova", "title": "The chair gave nova the floor", "tone": "floor"}
+{"actor": "nova", "details": ["Evidence: El vídeo lleva 40.000 visitas en una hora", "Consequence: El mensaje público pasa a ser lo más urgente de la lista.", "Every committee member heard this intervention and may request a bounded reply."], "kind": "committee.floor.spoke", "phase": "deliberating", "protocol": "agents-city-activity/1", "role": "member", "seq": 12, "summary": "Si restauramos sin avisar y alguien pierde lo que jugó el domingo, el enfado será doble. Primero el aviso con hora, después la restauración.", "target": "committee", "title": "nova spoke on the granted floor", "tone": "floor"}
+{"actor": "store-service", "details": ["Basis: risk", "Evidence: La copia es del jueves; lo jugado el viernes y el sábado no está en ella"], "kind": "committee.floor.requested", "phase": "deliberating", "protocol": "agents-city-activity/1", "role": "member", "seq": 13, "summary": "Restaurar tal cual tiene un precio que nadie ha dicho en voz alta.", "target": "seat", "title": "store-service requested the floor", "tone": "floor"}
+{"actor": "seat", "details": ["Request: Restaurar tal cual tiene un precio que nadie ha dicho en voz alta.", "Evidence: La copia es del jueves; lo jugado el viernes y el sábado no está en ella"], "kind": "committee.floor.granted", "phase": "deliberating", "protocol": "agents-city-activity/1", "role": "chair", "seq": 14, "summary": "One scoped reply was granted for risk.", "target": "store-service", "title": "The chair gave store-service the floor", "tone": "floor"}
+{"actor": "store-service", "details": ["Evidence: Guardar aparte las 3.804 cuentas lleva unas dos horas", "Consequence: La restauración se retrasa dos horas y se vuelve segura.", "Every committee member heard this intervention and may request a bounded reply."], "kind": "committee.floor.spoke", "phase": "deliberating", "protocol": "agents-city-activity/1", "role": "member", "seq": 15, "summary": "Antes de restaurar hay que guardar aparte todo lo del fin de semana, aunque tardemos dos horas más. Nadie pierde nada dos veces.", "target": "committee", "title": "store-service spoke on the granted floor", "tone": "floor"}
+{"actor": "seat", "details": ["Rationale: Primero la confianza, después la restauración segura: las tres posiciones caben en ese orden.", "Decisive contributors: nova, store-service, telemetry-collector", "Independent verifier: telemetry-collector"], "kind": "committee.decision.recorded", "phase": "verifying", "protocol": "agents-city-activity/1", "role": "chair", "seq": 16, "summary": "A las 17h, mensaje público contando qué pasó y qué vamos a hacer. A las 18h, guardar aparte todo lo del fin de semana. A las 20h, restaurar las copias del jueves. Nadie pierde nada dos veces.", "target": "telemetry-collector", "title": "The chair recorded a decision", "tone": "decision"}
+{"actor": "telemetry-collector", "details": ["Evidence: 71 cuentas de la franja empezaron a jugar el viernes: no existen en la copia del jueves", "Residual risk: Son precisamente los jugadores más nuevos"], "kind": "committee.verification.fail", "phase": "verification_failed", "protocol": "agents-city-activity/1", "role": "member", "seq": 17, "summary": "Cruce de la lista de afectados contra las copias del jueves · Para 71 personas el plan no recupera nada", "target": "seat", "title": "telemetry-collector reported verification FAIL", "tone": "verification"}
+{"actor": "seat", "details": [], "kind": "committee.replanned", "phase": "review", "protocol": "agents-city-activity/1", "role": "chair", "seq": 18, "summary": "El plan deja fuera a 71 personas que empezaron después de la copia. Un plan que recupera a casi todos no es un plan: se replantea.", "title": "The chair reopened the plan", "tone": "decision"}
+{"actor": "seat", "details": ["Agreement: Mantener horario de aviso y restauración", "Unknown: Cuánto se puede reconstruir de cada cuenta nueva"], "kind": "committee.synthesis.published", "phase": "deliberating", "protocol": "agents-city-activity/1", "role": "chair", "seq": 19, "summary": "El plan general sigue en pie; las 71 cuentas nuevas necesitan un trato aparte: contacto directo y reconstrucción con lo que sí tenemos.", "title": "The chair published the synthesis", "tone": "evidence"}
+{"actor": "seat", "details": ["Rationale: Nadie se queda fuera por haber llegado el último.", "Decisive contributors: telemetry-collector, store-service", "Independent verifier: telemetry-collector"], "kind": "committee.decision.recorded", "phase": "verifying", "protocol": "agents-city-activity/1", "role": "chair", "seq": 20, "summary": "El mismo plan, más un equipo dedicado a las 71 cuentas nuevas: contacto personal, compensación y reconstrucción manual de su progreso con los registros del fin de semana.", "target": "telemetry-collector", "title": "The chair recorded a decision", "tone": "decision"}
+{"actor": "telemetry-collector", "details": ["Evidence: Prueba con 50 cuentas piloto: todas recuperan su partida", "Evidence: Las 71 cuentas nuevas contactadas una a una; 68 ya respondieron", "Residual risk: Vigilar la franja del sábado durante una semana"], "kind": "committee.verification.pass", "phase": "verified", "protocol": "agents-city-activity/1", "role": "member", "seq": 21, "summary": "Restauración probada antes de la hora anunciada · Mensaje público revisado y con hora concreta", "target": "seat", "title": "telemetry-collector reported verification PASS", "tone": "verification"}
+{"actor": "seat", "details": [], "kind": "committee.closed", "phase": "closed", "protocol": "agents-city-activity/1", "role": "chair", "seq": 22, "summary": "Partidas restauradas, mensaje publicado a su hora y las 71 cuentas nuevas con seguimiento personal.", "title": "The chair closed the committee", "tone": "decision"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agents-city",
-  "version": "0.3.0",
+  "version": "0.4.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.3.0",
+  "version": "0.4.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/scripts/demos.py

@@ -0,0 +1,107 @@
+#!/usr/bin/env python3
+"""The recorded demos: what exists, and what each one contains.
+
+One reader for the recordings under `demo/grabaciones/`, shared by the Hall and
+by the suite that checks they still match their stories. The recordings are made
+by `demo/graba.py`, which plays each story over the real bus — nothing here
+invents an event, and nothing here knows what a committee is. It reads files.
+
+A missing `demo/` folder is not an error: an install can be trimmed, and a Hall
+whose demo shelf is empty should say so rather than fail to load.
+"""
+
+import json
+import os
+
+AQUI = os.path.dirname(os.path.abspath(__file__))
+RAIZ = os.path.dirname(os.path.dirname(AQUI))
+DEMO = os.path.join(RAIZ, "demo")
+
+#: What each story is, in the words somebody choosing one would use. The domain
+#: is the one the wizard offers, so "see it in my own field" means something.
+DOMINIOS = {
+    "software": ("Software", "Aurora Games"),
+    "medicina": ("Healthcare", "Clínica Alba"),
+    "legal": ("Legal", "Costa & Ley"),
+}
+
+
+def carpeta():
+    return os.path.join(DEMO, "grabaciones")
+
+
+def _titulos():
+    """The story titles, read from the stories module when it is installed."""
+    import sys
+
+    if DEMO not in sys.path:
+        sys.path.insert(0, DEMO)
+    try:
+        from stories import STORIES  # noqa: PLC0415
+
+        return {k: v.get("title", k) for k, v in STORIES.items()}
+    except (ImportError, AttributeError):
+        return {}
+
+
+def catalogo():
+    """Every demo with a recording on disk, in a stable order."""
+    titulos = _titulos()
+    fuera = []
+    for ident in sorted(DOMINIOS):
+        ruta = os.path.join(carpeta(), f"{ident}.jsonl")
+        if not os.path.isfile(ruta):
+            continue
+        dominio, ciudad = DOMINIOS[ident]
+        fuera.append(
+            {
+                "id": ident,
+                "dominio": dominio,
+                "ciudad": ciudad,
+                "titulo": titulos.get(ident, ident),
+                "turnos": _cuenta(ruta),
+                "reparto": _reparto(ruta),
+            }
+        )
+    return fuera
+
+
+def _lineas(ruta):
+    try:
+        with open(ruta, encoding="utf-8") as f:
+            for linea in f:
+                linea = linea.strip()
+                if linea:
+                    yield linea
+    except OSError:
+        return
+
+
+def _cuenta(ruta):
+    return sum(1 for _ in _lineas(ruta))
+
+
+def _reparto(ruta):
+    """Who speaks in this story, in the order they first do."""
+    visto = []
+    for linea in _lineas(ruta):
+        try:
+            actor = json.loads(linea).get("actor", "")
+        except json.JSONDecodeError:
+            continue
+        if actor and actor not in visto:
+            visto.append(actor)
+    return visto
+
+
+def eventos(ident):
+    """One recording, as the list of activity events it holds."""
+    if ident not in DOMINIOS:
+        return []
+    fuera = []
+    for linea in _lineas(os.path.join(carpeta(), f"{ident}.jsonl")):
+        try:
+            fuera.append(json.loads(linea))
+        except json.JSONDecodeError:
+            continue
+    return fuera

package/plugin/scripts/desinstala.py

@@ -0,0 +1,222 @@
+#!/usr/bin/env python3
+"""Remove this product from this machine, with everything it ever wrote.
+
+    agents-city uninstall              say exactly what would go. Remove nothing.
+    agents-city uninstall --yes        do it
+    agents-city uninstall --keep-cities --yes
+                                       unwire the machine, keep your cities
+    agents-city uninstall --npm --yes  and remove the global package too
+
+`reset` empties one city and keeps a backup, because a person resetting a city
+means to keep using the product. This is the other question — "get it off my
+machine" — and answering it with a list of eight folders to delete by hand is not
+an answer. A product that is easy to install and hard to remove is a product that
+does not respect the person running it.
+
+What it never touches: your repositories, your worktrees and your document
+folders. An agent's home holds *links* to those, never copies, and removing a
+link removes a link. That is the one property of this file worth testing, and it
+is tested.
+"""
+
+import argparse
+import os
+import shutil
+import subprocess
+import sys
+
+AQUI = os.path.dirname(os.path.abspath(__file__))
+sys.path.insert(0, AQUI)
+import atajos  # noqa: E402  the desktop icons, one per city
+import cities  # noqa: E402
+import city_env  # noqa: E402  where the bus keeps its folder
+
+def _sitios():
+    """Everything on disk that belongs to the product and to nothing else, as
+    (what it is, absolute path, whether it holds your cities)."""
+    casa = os.path.expanduser("~")
+    cache = os.environ.get("XDG_CACHE_HOME") or os.path.join(casa, ".cache")
+    return [
+        ("your cities, their state and their backups", cities.raiz(), True),
+        ("the list of which cities exist", os.path.dirname(cities.REGISTRO), False),
+        ("the cached index of your disk", os.path.join(cache, "agents-city"), False),
+        ("the bus folder, its .env and its hooks", city_env.CANAL, False),
+    ]
+
+
+def _tamano(ruta):
+    """How much is there, without following a single link out of it."""
+    if not os.path.exists(ruta):
+        return 0
+    if os.path.islink(ruta) or os.path.isfile(ruta):
+        return 0 if os.path.islink(ruta) else os.path.getsize(ruta)
+    total = 0
+    for base, dirs, ficheros in os.walk(ruta):
+        # A symlinked directory is somebody's repository. It is not ours to
+        # measure, and it is certainly not ours to delete.
+        dirs[:] = [d for d in dirs if not os.path.islink(os.path.join(base, d))]
+        for f in ficheros:
+            ruta_f = os.path.join(base, f)
+            if os.path.islink(ruta_f):
+                continue
+            try:
+                total += os.path.getsize(ruta_f)
+            except OSError:
+                continue
+    return total
+
+
+def _tamano_legible(n):
+    unidades = ["B", "KB", "MB", "GB", "TB"]
+    i = 0
+    valor = float(n)
+    while valor >= 1024 and i < len(unidades) - 1:
+        valor /= 1024.0
+        i += 1
+    return f"{valor:.0f} {unidades[i]}" if i == 0 else f"{valor:.1f} {unidades[i]}"
+
+
+def plan(usuario="", conservar_ciudades=False, con_npm=False):
+    """What would be removed, in the order it would be removed."""
+    usuario = usuario or cities.usuario_actual()
+    pasos = [{"que": "stop every city session, hall and map this product started",
+              "clase": "procesos"}]
+    for datos in [c["ruta"] for c in cities.lista(usuario)]:
+        pasos.append({"que": f"the desktop shortcut for {cities.nombre(datos)}",
+                      "clase": "atajo", "datos": datos})
+    pasos.append({"que": "the Claude plugin registration (city@agents-city)",
+                  "clase": "plugin"})
+    for etiqueta, ruta, es_ciudades in _sitios():
+        if es_ciudades and conservar_ciudades:
+            continue
+        if not os.path.exists(ruta):
+            continue
+        pasos.append({"que": etiqueta, "clase": "carpeta", "ruta": ruta,
+                      "bytes": _tamano(ruta)})
+    if sys.platform == "darwin":
+        pasos.append({"que": "the bus token in the macOS Keychain", "clase": "llavero"})
+    if con_npm:
+        pasos.append({"que": "the global npm package (agents-city)", "clase": "npm"})
+    return pasos
+
+
+def _quita_carpeta(ruta):
+    """Delete one of ours, following no link out of it.
+
+    `shutil.rmtree` unlinks a symlinked directory rather than descending into
+    it, which is exactly right here: an agent's home is full of links to
+    repositories that must survive this untouched.
+    """
+    if os.path.islink(ruta):
+        os.unlink(ruta)
+        return True
+    if not os.path.exists(ruta):
+        return False
+    shutil.rmtree(ruta, ignore_errors=True)
+    return not os.path.exists(ruta)
+
+
+def _apaga():
+    guion = os.path.join(AQUI, "apaga.py")
+    return subprocess.run([sys.executable, guion], capture_output=True, text=True)
+
+
+def _quita_plugin():
+    """Ask Claude to forget the plugin. Claude's own CLI owns that registry and
+    editing its files by hand would be this product reaching into another's."""
+    if not shutil.which("claude"):
+        return "claude is not on PATH — nothing registered to remove"
+    for verbo in ("uninstall", "remove"):
+        r = subprocess.run(
+            ["claude", "plugin", verbo, "city@agents-city", "--scope", "user", "--yes"],
+            capture_output=True,
+            text=True,
+        )
+        if r.returncode == 0:
+            return "removed"
+    return "claude kept it — remove it with: claude plugin uninstall city@agents-city"
+
+
+def _quita_llavero():
+    r = subprocess.run(
+        ["security", "delete-generic-password", "-s", "city@agents-city"],
+        capture_output=True,
+        text=True,
+    )
+    return "removed" if r.returncode == 0 else "nothing stored"
+
+
+def _quita_npm():
+    if not shutil.which("npm"):
+        return "npm is not on PATH — remove the package yourself"
+    r = subprocess.run(["npm", "rm", "-g", "agents-city"], capture_output=True, text=True)
+    return "removed" if r.returncode == 0 else (r.stderr or "npm refused").strip().splitlines()[-1]
+
+
+def ejecuta(pasos, salida=print):
+    """Carry out a plan. Each step reports for itself; a step that fails does not
+    stop the ones after it, because a half-removed install is the worst outcome
+    available."""
+    hechos = []
+    for paso in pasos:
+        clase = paso["clase"]
+        if clase == "procesos":
+            r = _apaga()
+            estado = "closed" if r.returncode == 0 else "some were already gone"
+        elif clase == "atajo":
+            estado = "removed" if atajos.quita(paso["datos"]) else "none there"
+        elif clase == "plugin":
+            estado = _quita_plugin()
+        elif clase == "carpeta":
+            estado = "removed" if _quita_carpeta(paso["ruta"]) else "could not remove"
+        elif clase == "llavero":
+            estado = _quita_llavero()
+        elif clase == "npm":
+            estado = _quita_npm()
+        else:
+            estado = "skipped"
+        salida(f"    · {paso['que']} — {estado}")
+        hechos.append((paso["que"], estado))
+    return hechos
+
+
+def _muestra(pasos, salida=print):
+    salida("\n  Uninstalling agents-city would remove:\n")
+    for paso in pasos:
+        tamano = f"  ({_tamano_legible(paso['bytes'])})" if paso.get("bytes") else ""
+        ruta = f"\n        {paso['ruta']}" if paso.get("ruta") else ""
+        salida(f"    · {paso['que']}{tamano}{ruta}")
+    salida(
+        "\n  It would NOT touch your repositories, your worktrees or your document\n"
+        "  folders. An agent's home holds links to those, and a link is all that goes.\n"
+    )
+
+
+def main(argv=None):
+    p = argparse.ArgumentParser(
+        prog="agents-city uninstall",
+        description="Remove agents-city and everything it wrote on this machine.",
+    )
+    p.add_argument("--yes", action="store_true", help="actually remove it")
+    p.add_argument("--keep-cities", action="store_true",
+                   help="unwire the machine but leave ~/.agents-city alone")
+    p.add_argument("--npm", action="store_true",
+                   help="also remove the globally installed npm package")
+    args = p.parse_args(argv)
+
+    pasos = plan(conservar_ciudades=args.keep_cities, con_npm=args.npm)
+    _muestra(pasos)
+    if not args.yes:
+        print("  Nothing was removed. Add --yes to go through with it.\n")
+        return 0
+    print("  Removing:\n")
+    ejecuta(pasos)
+    if not args.npm:
+        print("\n  The package itself is still installed. To finish:\n"
+              "    npm rm -g agents-city")
+    print("\n  Gone. Thank you for trying it.\n")
+    return 0
+
+
+if __name__ == "__main__":
+    sys.exit(main())