@andespindola/crow-skills 0.7.0 → 0.8.0

package/crow_skills/events.py

@@ -0,0 +1,111 @@
+"""Read side of the event bus: ``crow-skills events snapshot|tail``.
+
+The hooks (crow_hook.py, see hook.py) append ``crow-event/1`` lines and keep
+one ``crow-session/1`` snapshot per session. This module aggregates them with
+the mode, the live crow-behaviour ledger runs and the autoupdate status into
+``crow-snapshot/1``, the document terminals such as crow-term poll. The
+contract is in docs/events.md.
+"""
+from datetime import datetime, timezone
+import json
+import sys
+import time
+
+from . import autoupdate, hook, progress
+from .source import CrowError
+
+SNAPSHOT_SCHEMA = "crow-snapshot/1"
+
+
+def ledger_runs(home, cwds):
+    """Live crow-behaviour runs for the sessions' directories and ~/.crow/runs."""
+    seen, runs = set(), []
+    for cwd in list(dict.fromkeys(cwds)) or [str(home)]:
+        for run in progress.discover(cwd, home, env={}):
+            if run["path"] in seen or not progress.active(run):
+                continue
+            seen.add(run["path"])
+            info = progress.summary(run)
+            runs.append({"id": run["id"], "title": run["title"], "host": run["host"], "cwd": run["cwd"], "status": run["status"],
+                         "session": run["session"].get("id"), "path": run["path"], "updatedAt": run.get("updatedAt"),
+                         "done": info["done"], "failed": info["failed"], "total": info["total"], "running": info["running"],
+                         "progress": info["progress"],
+                         "agents": [{"owner": progress.owner_label(u["owner"]), "unit": u["id"], "activity": u["title"]}
+                                    for u in run["units"] if u["status"] == "running"]})
+    return runs
+
+
+def snapshot(home, store):
+    live = hook.sessions(home)
+    runs = ledger_runs(home, [s.get("cwd") for s in live if s.get("cwd")])
+    for session in live:
+        # Link a session to its ledger run: same session id, else the same directory.
+        match = [r for r in runs if r["session"] and r["session"] == session.get("session")] or \
+                [r for r in runs if not r["session"] and r["cwd"] and session.get("cwd") and progress.related({"cwd": r["cwd"]}, session["cwd"])]
+        session["ledgerRun"] = match[0]["id"] if match else None
+    try:
+        update = autoupdate.status(store, home)
+        update = {k: update[k] for k in ("enabled", "lastRun", "healthy")} | {"scheduler": (update.get("scheduler") or {}).get("kind")}
+        if update["lastRun"]:
+            last = update["lastRun"]
+            update["lastRun"] = {"startedAt": last.get("startedAt"), "endedAt": last.get("endedAt"), "ok": last.get("ok"),
+                                 "self": (last.get("self") or {}).get("result"),
+                                 "updated": sum(len(s.get("updated") or []) for s in last.get("skills", []))}
+    except CrowError as exc:
+        update = {"enabled": None, "error": exc.code}
+    mode = hook.read_mode(home)
+    return {"schema": SNAPSHOT_SCHEMA, "generatedAt": datetime.now(timezone.utc).isoformat(timespec="seconds"),
+            "mode": {k: mode[k] for k in ("mode", "updatedAt", "updatedBy", "source")}, "indicator": hook.indicator(mode["mode"]),
+            "sessions": live, "runs": runs, "autoupdate": update}
+
+
+def render(data, unicode=True):
+    lines = [data["indicator"] + "  ·  " + str(len(data["sessions"])) + " sessão(ões) ativa(s)  ·  " +
+             str(len(data["runs"])) + " execução(ões) crow"]
+    for s in data["sessions"]:
+        flag = " [bloqueada]" if s.get("blocked") else ""
+        lines.append("- " + " ".join(str(x) for x in (s.get("host"), s.get("state"), s.get("cwd") or "", s.get("branch") or "") if x) +
+                     flag + ("  tool=" + s["currentTool"] if s.get("currentTool") else "") +
+                     ("  subagentes=" + str(s["subagents"]) if s.get("subagents") else ""))
+    for run in data["runs"]:
+        lines.append("")
+        lines += progress.agent_rows(progress.validate({"id": run["id"], "title": run["title"], "status": run["status"],
+                                                         "units": [{"id": a["unit"], "title": a["activity"], "owner": a["owner"],
+                                                                    "status": "running"} for a in run["agents"]]}),
+                                     unicode, counts=False)
+        lines.append(("✓ " if unicode else "ok ") + str(run["done"]) + "/" + str(run["total"]) + "  " + run["title"])
+    update = data["autoupdate"]
+    lines.append("")
+    lines.append("autoupdate: " + ("ligado" if update.get("enabled") else "desligado") +
+                 ((" · última execução " + str(update["lastRun"]["startedAt"]) + (" ok" if update["lastRun"]["ok"] else " com falha"))
+                  if update.get("lastRun") else ""))
+    return "\n".join(lines)
+
+
+def follow(home, interval=0.5, stream=None, max_seconds=None):
+    """Stream new crow-event/1 lines (JSONL) until interrupted."""
+    stream = stream or sys.stdout
+    path = hook.events_dir(home) / "events.jsonl"
+    position = path.stat().st_size if path.exists() else 0
+    started = time.time()
+    try:
+        while max_seconds is None or time.time() - started < max_seconds:
+            if path.exists():
+                size = path.stat().st_size
+                if size < position:  # rotated
+                    position = 0
+                if size > position:
+                    with open(path, "rb") as handle:
+                        handle.seek(position)
+                        chunk = handle.read(size - position)
+                    position = size
+                    for raw in chunk.splitlines():
+                        try:
+                            stream.write(json.dumps(json.loads(raw), ensure_ascii=False, separators=(",", ":")) + "\n")
+                        except ValueError:
+                            continue
+                    stream.flush()
+            time.sleep(interval)
+    except KeyboardInterrupt:
+        return 0
+    return 0

package/crow_skills/guide.py

@@ -201,7 +201,13 @@ def render_body(agent, catalog, revision, skills):
         "",
         "Gerado por crow-skills guide a partir do catálogo " + revision[:12] + ". Complementa as instruções do usuário e do projeto; havendo conflito, elas prevalecem.",
         "",
-        "## crow-behaviour: quando aplicar",
+        "## Modo crow (liga/desliga)",
+        "- O usuário liga ou desliga a crow-behaviour para todas as sessões e CLIs com `crow-skills mode on|off` (ou `/crow on|off`). O estado fica em `~/.config/crow-skills/mode.json`; sem esse arquivo, o modo é ON.",
+        "- Obedeça ao modo vigente mais recente: o hook do crow-skills o informa a cada prompt numa linha `[crow-skills] modo crow: ON|OFF`. Sem essa linha (hook ausente ou não aprovado), leia o arquivo uma vez no início da sessão.",
+        "- ON é o modo de orquestração permanente: as regras abaixo valem para toda tarefa substantiva, até o usuário desligar.",
+        "- OFF: não carregue nem aplique a crow-behaviour, salvo se o usuário a invocar explicitamente no pedido; as skills especialistas continuam disponíveis.",
+        "",
+        "## crow-behaviour: quando aplicar (modo ON)",
         "- Tarefa substantiva (várias etapas ou partes, exploração e decisões, mudanças em vários arquivos ou componentes, ou entrega que exige verificação): carregue a skill crow-behaviour ANTES de começar, por iniciativa própria, sem esperar pedido. Para carregar, " + mech["load"] + "; por exemplo, " + invoke(name="crow-behaviour") + ". Siga-a até a entrega.",
         "- Vale também quando a entrega é só um plano, um diagnóstico ou uma revisão, ou quando não há código no diretório: depurar, auditar, investigar, migrar ou planejar uma mudança com várias etapas continua sendo tarefa substantiva.",
         "- Conversa, pergunta factual curta ou ajuste trivial e local: responda direto, sem carregá-la.",