@andespindola/crow-skills 0.7.1 → 0.8.0

package/skills/crow-behaviour/SKILL.md

@@ -11,7 +11,7 @@ Transforme o agente principal em responsável pelo resultado completo: ele defin
 
 Pedido atual, alvo e revisão, critérios de sucesso, restrições, artefatos já válidos e ferramentas efetivamente expostas pelo runtime. Reutilize o contexto disponível; pergunte apenas por uma decisão material que não possa resolver com evidência.
 
-Instalação torna a skill disponível, não garante que o host a carregue em todo turno. Quando selecionada/invocada, aplique este comportamento ao pedido em curso. Mantenha-o nos turnos relacionados enquanto a skill permanecer no contexto e o usuário não o substituir. Se o usuário ou o host declarar um modo de orquestração permanente na sessão, trate-o como vigente para toda tarefa substantiva até ser desligado explicitamente, inclusive após compactação de contexto. Não edite prompts globais, hooks ou configurações para forçar ativação.
+Instalação torna a skill disponível, não garante que o host a carregue em todo turno. Quando selecionada/invocada, aplique este comportamento ao pedido em curso. Mantenha-o nos turnos relacionados enquanto a skill permanecer no contexto e o usuário não o substituir. Se o usuário ou o host declarar um modo de orquestração permanente na sessão, trate-o como vigente para toda tarefa substantiva até ser desligado explicitamente, inclusive após compactação de contexto. O interruptor do usuário é o modo crow (`crow-skills mode on|off`, `/crow on|off`), informado pelo host a cada prompt como `[crow-skills] modo crow: ON` ou `OFF`; vale o anúncio mais recente. ON é essa declaração de modo permanente. OFF desliga esta skill: não a aplique, salvo se o usuário a invocar explicitamente no pedido em curso. Não edite prompts globais, hooks ou configurações para forçar ativação nem altere o modo por iniciativa própria; só o usuário liga ou desliga.
 
 ## Trabalho
 
@@ -40,7 +40,7 @@ Leia [padrões e critérios de conclusão](references/quality-patterns.md) quand
 - Um responsável por arquivo ou recurso mutável em cada momento. Antes de escrita concorrente, use isolamento suportado e autorizado ou ownership disjunto. Não crie clones/worktrees por suposição. Sem isolamento seguro, serialize.
 - O principal pode avançar uma unidade independente enquanto aguarda, mas não refazer em paralelo a mesma unidade atribuída ao worker. Reatribua explicitamente se o executor falhar ou ficar indisponível.
 - Não deixe trabalhadores dispararem novas equipes sem escopo e limite atribuídos. Cancele trabalho obsoleto e aguarde processos relevantes antes de reiniciar ou declarar conclusão.
-- Mantenha o ledger de progresso: o coordenador é o único que grava; registre cada unidade ao iniciar e ao terminar, mostre o progresso na própria conversa (plano no início, resumo compacto a cada transição de fase, linha curta quando algo muda) e, se o host tiver uma ferramenta nativa de plano/tarefas, espelhe nela as mesmas unidades. Nunca abra janela, painel ou outro processo para exibir progresso; veja [ledger de progresso](references/progress-ledger.md).
+- Mantenha o ledger de progresso: o coordenador é o único que grava; registre cada unidade ao iniciar e ao terminar, mostre o progresso na própria conversa (plano no início, bloco de processos a cada transição de fase, linha curta quando algo muda) e, se o host tiver uma ferramenta nativa de plano/tarefas, espelhe nela as mesmas unidades. O bloco de processos usa sempre o formato da lista de agentes do host, uma linha por processo em andamento: `● main  <o que o coordenador faz>`, depois `○ <dono>  <atividade>` para cada unidade em andamento de outro dono (subagente, workflow), e uma linha de contagem (`✓ 3 concluída(s) · ✗ 1 falha(s) · 2 pendente(s)`); `crow_ledger.py show` o imprime a partir do ledger. Nunca abra janela, painel ou outro processo para exibir progresso; veja [ledger de progresso](references/progress-ledger.md).
 
 ### 4. Verifique antes de sintetizar
 
@@ -66,7 +66,7 @@ Quando o usuário pedir para configurar o comportamento padrão de um agente de
 
 ## Saída e aceite
 
-Entregue o resultado pedido, apoiado pelo **execution-ledger**: cobertura de requisitos, evidências da revisão final, contradições resolvidas e pendências com continuação concreta. A resposta ao usuário deve ser proporcional e natural, não uma transcrição de coordenação; o resumo compacto de progresso entra nas transições de fase e no fim.
+Entregue o resultado pedido, apoiado pelo **execution-ledger**: cobertura de requisitos, evidências da revisão final, contradições resolvidas e pendências com continuação concreta. A resposta ao usuário deve ser proporcional e natural, não uma transcrição de coordenação; o bloco de processos entra nas transições de fase e no fim.
 
 - Distinga planejado, tentado, produzido e verificado. Registre testes não executados.
 - Relate o modo real quando relevante: workflow, subagentes ou sequencial. Não atribua trabalho a agentes que não existiram.

package/skills/crow-behaviour/references/progress-ledger.md

@@ -56,7 +56,8 @@ python3 <pasta-da-skill>/scripts/crow_ledger.py start --title "Paridade" --host
 # imprime "<run-id> <caminho>"; guarde o run-id e passe-o em toda chamada seguinte
 python3 <pasta-da-skill>/scripts/crow_ledger.py unit u1 --run <run-id> --phase d --title "Mapear CLI" --owner subagent:leitor --status running
 python3 <pasta-da-skill>/scripts/crow_ledger.py unit u1 --run <run-id> --status done --summary "3 pontos de extensão"
-python3 <pasta-da-skill>/scripts/crow_ledger.py show --run <run-id>
+python3 <pasta-da-skill>/scripts/crow_ledger.py show --run <run-id>          # bloco de processos para o chat
+python3 <pasta-da-skill>/scripts/crow_ledger.py show --tree --run <run-id>   # árvore de fases, se o usuário pedir detalhe
 python3 <pasta-da-skill>/scripts/crow_ledger.py finish --run <run-id> --status done
 ```
 
@@ -70,11 +71,24 @@ O progresso aparece na própria conversa, exibido pelo agente que está trabalha
 
 - **Início:** ao começar uma tarefa substantiva, mostre o plano em poucas linhas: fases, unidades e o que será entregue.
 - **Plano nativo do host:** se o host tiver ferramenta de plano ou tarefas (lista de tarefas, plano de etapas), espelhe nela as mesmas unidades e mantenha os estados em dia: uma unidade em andamento por responsável, concluída assim que tiver evidência. É o jeito preferido de mostrar progresso contínuo, porque a interface do próprio host o exibe sem outra janela.
-- **Transições:** a cada transição de fase e no fim, inclua no chat o resumo compacto (`crow_ledger.py show`): árvore de fases e unidades com barras ASCII. Não repita o resumo a cada unidade.
+- **Bloco de processos:** a cada transição de fase e no fim, inclua no chat o bloco impresso por `crow_ledger.py show`, no mesmo formato da lista de agentes do host. Uma linha por processo em andamento; `main` é sempre a primeira; o dono vem sem o prefixo `subagent:`; a última linha conta as unidades:
+
+  ```text
+  ● main  Integrar resultados
+  ○ revisor  Revisar o diff
+  ○ workflow:testes  Rodar a suíte
+  ✓ 3 concluída(s) · ✗ 1 falha(s) · 2 pendente(s)
+  ```
+
+  Escreva o bloco à mão nesse formato quando o script não estiver disponível; em terminal sem Unicode, `show --ascii` troca `●`/`○` por `*`/`o`. A árvore de fases com barras (`show --tree`) só entra se o usuário pedir detalhe. Não repita o bloco a cada unidade.
 - **Entre transições:** uma linha curta quando uma unidade demorada começa ou termina, ou quando algo muda o plano (falha, achado, decisão pendente). Em espera longa (job em segundo plano, workflow, CI), diga o que está rodando e quando vai checar de novo.
 - **Proporção:** o progresso informa, não substitui a resposta. Sem transcrição de coordenação, sem resumo repetido e sem barra inventada.
 
-Não instale nada para exibir progresso.
+Não instale nada para exibir progresso. Se o usuário instalou as integrações do crow-skills, a status line do Claude Code e do Antigravity já mostra o mesmo bloco e o indicador `▸▸ crow on`; isso não substitui o bloco no chat, que funciona em qualquer CLI.
+
+## Modo crow
+
+O usuário liga ou desliga esta skill para todas as sessões e CLIs com `crow-skills mode on|off` (ou `/crow on|off`). O host informa o modo a cada prompt (`[crow-skills] modo crow: ON|OFF`). Com OFF, não abra ledger nem aplique a skill, salvo invocação explícita. Nunca mude o modo por conta própria.
 
 ## Limites
 

package/skills/crow-behaviour/scripts/crow_ledger.py

@@ -9,7 +9,8 @@ coordinator records the transition.
   crow_ledger.py phase ID --run RUN [--title T] [--status running|done|...]
   crow_ledger.py unit ID --run RUN [--title T] [--phase P] [--owner O] [--status S] [--progress 0..1] [--summary TXT]
   crow_ledger.py finish --run RUN [--status done|failed|cancelled]
-  crow_ledger.py show [--run RUN]         # tree + ASCII bars for the chat
+  crow_ledger.py show [--run RUN]         # process list for the chat (● main / ○ owner  activity)
+  crow_ledger.py show --tree [--run RUN]  # phase tree with ASCII bars, when the user asks for detail
   crow_ledger.py path [--run RUN]         # where the ledger lives
 
 start prints "<run-id> <path>"; pass that run id as --run (or $CROW_RUN) on
@@ -155,6 +156,45 @@ def clean(text, limit=120):
     return text if len(text) <= limit else text[: limit - 3] + "..."
 
 
+def owner_label(owner):
+    owner = clean(owner, 40) or "main"
+    return owner.split(":", 1)[1] if owner.startswith("subagent:") and owner[9:] else owner
+
+
+def processes(data, ascii_only=False):
+    """The progress block shown in the conversation, in the layout of the host's agent list:
+
+        ● main  <what the coordinator is doing>
+        ○ <owner>  <running unit>
+        ✓ 3 concluída(s) · ✗ 1 falha(s) · 2 pendente(s)
+    """
+    dot, ring, check, cross, sep = ("*", "o", "ok", "x", " - ") if ascii_only else ("●", "○", "✓", "✗", " · ")
+    units = data.get("units", []) or []
+    running = [u for u in units if u.get("status") == "running"]
+    mine = [u for u in running if owner_label(u.get("owner")) in ("main", "sequential")]
+    others = [u for u in running if u not in mine]
+    head = dot + " main"
+    if mine:
+        head += "  " + clean(mine[0].get("title") or mine[0].get("id"), 70) + (" (+" + str(len(mine) - 1) + ")" if len(mine) > 1 else "")
+    elif data.get("status", "running") == "running":
+        head += "  " + clean(data.get("title"), 70)
+    else:
+        head += "  " + clean(data.get("title"), 70) + " [" + clean(data.get("status")) + "]"
+    lines = [head]
+    for unit in others:
+        lines.append(ring + " " + owner_label(unit.get("owner")) + "  " + clean(unit.get("title") or unit.get("id"), 70))
+    done = sum(u.get("status") == "done" for u in units)
+    failed = sum(u.get("status") == "failed" for u in units)
+    pending = sum(u.get("status") == "pending" for u in units)
+    parts = [check + " " + str(done) + " concluída(s)"]
+    if failed:
+        parts.append(cross + " " + str(failed) + " falha(s)")
+    if pending:
+        parts.append(str(pending) + " pendente(s)")
+    lines.append(sep.join(parts))
+    return "\n".join(lines)
+
+
 def render(data):
     units = data.get("units", [])
     counted = [u for u in units if u.get("status") != "skipped"]
@@ -210,6 +250,9 @@ def main(argv=None):
     for name in ("show", "path"):
         child = sub.add_parser(name)
         child.add_argument("--run")
+        if name == "show":
+            child.add_argument("--tree", action="store_true", help="árvore de fases com barras, em vez da lista de processos")
+            child.add_argument("--ascii", action="store_true", help="lista de processos só com ASCII")
     for child in (phase, unit, finish):
         child.add_argument("--run")
     args = p.parse_args(argv)
@@ -234,7 +277,7 @@ def main(argv=None):
         print(path)
         return 0
     if args.command == "show":
-        print(render(data))
+        print(render(data) if args.tree else processes(data, args.ascii))
         return 0
     if args.command == "phase":
         phases = data.setdefault("phases", [])