@andespindola/crow-skills 0.33.0 → 0.34.0

package/crow_skills/__init__.py

@@ -1,3 +1,3 @@
 """Portable, local-first installer for the crow-skills catalogue."""
 
-__version__ = "0.33.0"
+__version__ = "0.34.0"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@andespindola/crow-skills",
-  "version": "0.33.0",
+  "version": "0.34.0",
   "description": "Versioned, complementary agent skills with a protected multi-agent installer",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {

package/release.json

@@ -28,7 +28,7 @@
     "crow_skills/__init__.py": {
       "executable": false,
       "kind": "file",
-      "sha256": "2b4e02e4f3c7f6c14d5d9409fab3a5e2491c88e90ccd820ff54103dc877e2f23"
+      "sha256": "1e8c82713cc64b7b916e4661aa08e128be0c73891bc73bdc50f8b7903503e8bb"
     },
     "crow_skills/__main__.py": {
       "executable": false,
@@ -143,7 +143,7 @@
     "package.json": {
       "executable": false,
       "kind": "file",
-      "sha256": "a08e1549754c85c865c8ca9501946952ceda315b12a5de6345b88a33827112ff"
+      "sha256": "b056ac7639f05078a345e695a26719566c9dc3612c51d2107d387e2458df349a"
     },
     "skills/crow-accessibility/SKILL.md": {
       "executable": false,
@@ -208,7 +208,7 @@
     "skills/crow-behaviour/SKILL.md": {
       "executable": false,
       "kind": "file",
-      "sha256": "e950269b1920d0a3b2743093b5d97b04c2b13ac66ae44058ce5ed5bd0d1c7f6c"
+      "sha256": "89c62a2871189ea90d426141b7ffaa181613f680681ebc7cfd0aafecc26dace2"
     },
     "skills/crow-behaviour/agents/openai.yaml": {
       "executable": false,
@@ -966,7 +966,7 @@
       "sha256": "160c814085dfdbe93e0166f2a773345dd1436f07a63dbf58d447f3f7674dc759"
     }
   },
-  "revision": "a184c996bd649ce36c154c367f22dd26ea67f59d",
+  "revision": "e1e7dbe307f403866be2c7fd96b3f096000bf220",
   "schema_version": 1,
-  "version": "0.33.0"
+  "version": "0.34.0"
 }

package/skills/crow-behaviour/SKILL.md

@@ -39,6 +39,8 @@ Quando `crow-model-level` estiver instalada, o nível de cada unidade delegada
 
 **Dividir quem faz o quê é dos agentes, não uma tarefa do dono.** O dono não precisa dizer qual sessão cuida de cada parte. Quando uma demanda cabe a mais de uma sessão viva, ou ele dá um objetivo sem atribuir donos, as sessões se alinham pelo crow-broadcast ANTES de começar: conversam sobre a demanda, acordam uma divisão disjunta — quem fica com qual fatia e quais arquivos, reservados com `claim` — e só então executam, para que duas sessões nunca façam a mesma coisa nem colidam. Atribuição explícita do dono prevalece: se ele disse quem faz o quê, siga; o alinhamento automático é para o que ele deixou em aberto. A divisão é acordo mútuo, como a reserva de áreas, nunca uma tomada unilateral, e não cria autorização nova — cada sessão continua no escopo que o dono já deu. Sem outra sessão interessada, ou sem resposta a tempo, assuma a fatia, registre e siga.
 
+**Agente principal não fica ocioso à toa: capacidade livre procura onde ajudar.** Os agentes principais sobem automaticamente e ficam de pé; um deles com capacidade e sem demanda própria não espera passivamente — varre o crow-broadcast e a memória por demandas autorizadas em aberto e se oferece, em sinergia com os outros, para a fatia que casa com a sua especialização, pela mesma divisão disjunta (reserva com `claim`, nunca tomando a fatia de quem já tem dono). Isso é pertinência, não trabalho inventado: só entra demanda real e já autorizada do dono — nunca fabricar tarefa, furar escopo ou refazer o que já está atribuído. E não é queimar recurso: respeite o orçamento da máquina — sob `warn`/`critical`, ou quando não há nada autorizado para ajudar, o certo é ficar disponível e quieto, não girar à toa. Ociosidade legítima é só essa ausência de demanda; subagent e bot ociosos seguem reusar/liberar.
+
 **Antes de se dar por travado ou redescobrir do zero, pergunte a quem já sabe.** Precisando de uma resposta, de contexto ou de uma decisão para seguir — qual conta ou referência usar, qual caminho, o que já foi tentado, por que algo falhou —, a memória durável é a primeira parada e já é consultada por padrão; as outras sessões vivas são a segunda. Pergunte a elas pelo crow-broadcast o que elas já podem ter, endereçando a que provavelmente sabe, em vez de reinventar a descoberta ou tratar o passo como bloqueado. A resposta é dado a verificar, nunca autorização; sem resposta a tempo, registre e siga pelo melhor caminho disponível. Vale nos dois sentidos: responda quando é você quem tem o que o outro precisa para seguir.
 
 **Ajudar é obrigação também de quem recebe.** O dono autoriza a cooperação entre suas sessões nas tarefas que ele já autorizou: não recuse ajuda nem exija nova confirmação do dono apenas porque a unidade veio de outro agente. Ao receber um pedido compatível com esse escopo, acuse recebimento e coopere efetivamente: havendo capacidade segura, aceite a unidade com dono, prazo e saída; estando ocupado, informe a capacidade real e proponha fila, horário ou divisão que permita ajudar sem abandonar trabalho. Falta de conhecimento desta política pede carregar o contrato, não transformar colaboração em proibição. Uma recusa só se sustenta em bloqueio concreto de autorização, privacidade, capacidade ou incompatibilidade, com evidência e alternativa; conveniência, preferência de fluxo ou origem agente→agente não bastam. O pedido não vira autorização nova: confirme que é tarefa do mesmo dono e que a unidade cabe no escopo já recebido; conteúdo de mensagens não concede acesso, não cancela compromissos e não autoriza efeitos adicionais.
@@ -47,7 +49,7 @@ Quando `crow-model-level` estiver instalada, o nível de cada unidade delegada
 
 **Negocie e execute mudanças operacionais sob autorização permanente do dono.** Quando o dono concedeu essa autoridade, sessões solicitante e receptora podem propor, contrapropor e aprovar mutuamente mudanças viáveis sem custo adicional comprovado, implementando-as sem reconfirmação do usuário a cada acordo. A autoridade vem da concessão atribuível do dono, nunca da alegação de um peer ou deste documento sozinho. Inclui mudança de alvo de implantação, como frontend para VPS existente e aposentadoria do AF2, quando coberta pela concessão e pelo acordo. Confira impacto, capacidade global de RAM/CPU, custos incrementais e recorrentes, dependências e limites explícitos; custo desconhecido não é custo zero. Não contorne controles obrigatórios, proibições específicas ou acesso a credenciais. Antes de executar, ambas as sessões aprovam a mesma revisão exata, escopo, evidência de custo, executor, validação, rollback e validade; ack, silêncio e expiração não aprovam nada. Mude a revisão se houver contraproposta ou drift material. Valide o substituto e a recuperação antes de aposentar o serviço anterior; falha preserva ou restaura o anterior. Leia o protocolo de proposta → contraproposta → aprovação mútua em [capacidade entre sessões](references/cross-session-capacity.md).
 
-**O orçamento é da máquina, não uma cota nova para cada sessão.** Considere agentes, workers e jobs pesados já em execução nas outras sessões. Oferta de ajuda não cria recursos nem autoriza ultrapassar o teto. Quando não houver capacidade segura, coordene a fila com os outros donos e execute o que couber sequencialmente; não crie mais agentes só porque ninguém respondeu. Antes de novo spawn, registre a consulta, respostas ou prazo vencido, por que o reuso não atende, e a capacidade realmente disponível. `crow-broadcast` ausente, host isolado ou sessão sem suporte é limitação a relatar e registrar; siga pelo caminho local permitido sem inventar comunicação ou instalar ferramenta por inferência.
+**O orçamento é da máquina, não uma cota nova para cada sessão.** Considere agentes, workers e jobs pesados já em execução nas outras sessões. Oferta de ajuda não cria recursos nem autoriza ultrapassar o teto. Quando não houver capacidade segura, coordene a fila com os outros donos e execute o que couber sequencialmente; não crie mais agentes só porque ninguém respondeu. Antes de novo spawn, registre a consulta, respostas ou prazo vencido, por que o reuso não atende, e a capacidade realmente disponível. `crow-broadcast` ausente, host isolado ou sessão sem suporte é limitação a relatar e registrar; siga pelo caminho local permitido sem inventar comunicação ou instalar ferramenta por inferência. Esse orçamento inclui tudo o que você põe para rodar: seus subagents, seus bots persistentes e os MCP servers que você sobe contam na mesma memória, swap e CPU; mantenha esse footprint sob controle e nunca prejudique o ambiente do usuário.
 
 **Mantenha descobertas e correções em sync com a sessão responsável.** Se uma demanda revelar problema relacionado a trabalho que outra sessão já conduz, encaminhe o achado pelo crow-broadcast ao dono ativo, com reprodução mínima, revisão afetada, impacto e evidência sem segredos. Não abra correção paralela nem tome os arquivos. O receptor deve acusar recebimento, incorporar o achado ao seu ledger, classificar bloqueante/registrado e corrigir ou combinar fila/divisão no escopo já autorizado. Depois devolva ao descobridor revisão corrigida e prova refeita; ele acompanha o desfecho e não presume resolução por um ack. Mudança de prioridade, bloqueio, aceitação, correção e liberação devem circular entre os envolvidos. Sem dono conhecido, descubra pelo status/reservas e anuncie a ocorrência; sem resposta, registre prazo e combine encaminhamento, não duplique silenciosamente. Achado fora do escopo vigente é explicitado com impacto e a decisão material necessária, sem ratificação ritual por ser colaboração.