@andespindola/crow-skills 0.23.0 → 0.25.0

package/LICENSE

@@ -4,6 +4,30 @@ Software proprietário. Este pacote é distribuído publicamente para uso, não
 cópia. O código-fonte não é aberto: a sua presença no pacote é uma necessidade de
 execução, não uma concessão de direitos sobre ele.
 
+## Componentes de terceiros
+
+Este pacote inclui software de terceiros sob licenças próprias. Todo ele está dentro de
+`skills/crow-interface/`:
+
+1. **Impeccable**, Copyright 2025 Paul Bakaus — Apache License 2.0, em
+   `skills/crow-interface/licenses/Apache-2.0.txt`, com o aviso original preservado em
+   `skills/crow-interface/licenses/Impeccable-NOTICE.md`. A proveniência e as
+   modificações estão em `skills/crow-interface/NOTICE.md`.
+2. **platform-design-skills** — MIT, em
+   `skills/crow-interface/licenses/platform-design-MIT.txt`.
+3. **modern-screenshot**, Copyright (c) 2021-present wxm — MIT, em
+   `skills/crow-interface/licenses/modern-screenshot-MIT.txt`.
+
+Para esses componentes e para as obras deles derivadas, **a licença de terceiros
+prevalece sobre esta**. Nada nesta licença restringe, condiciona ou revoga os direitos
+que a Apache-2.0 e a MIT concedem a você sobre esses arquivos, inclusive os de
+redistribuir, modificar e criar obra derivada, observadas as obrigações de atribuição e
+de aviso dessas mesmas licenças. As restrições de "O que você não pode fazer" abaixo
+alcançam somente o conteúdo próprio do Crow.
+
+Quando um arquivo trouxer aviso de licença próprio, é esse aviso que governa aquele
+arquivo. O inventário consolidado está em `THIRD-PARTY-NOTICES.md`.
+
 ## O que você pode fazer
 
 1. Instalar e executar o `crow-skills` nos seus próprios computadores, sem limite de
@@ -45,7 +69,11 @@ Qualquer uso fora do permitido acima depende de autorização escrita do titular
 
 ---
 
-Proprietary software, all rights reserved. Published for use, not for copying:
-installing and running it is permitted; redistribution, derivative works, extracting
-its content into another product or dataset, and reverse engineering are not. No
-warranty. See the Portuguese text above for the governing terms.
+Proprietary software, all rights reserved, EXCEPT for the third-party components
+bundled under `skills/crow-interface/` (Impeccable, Apache-2.0; platform-design-skills
+and modern-screenshot, MIT), for which the third-party licence prevails over this one:
+nothing here restricts the rights those licences grant you over those files. See
+`THIRD-PARTY-NOTICES.md`. For Crow's own content, publication is for use, not for
+copying: installing and running it is permitted; redistribution, derivative works,
+extracting its content into another product or dataset, and reverse engineering are
+not. No warranty. See the Portuguese text above for the governing terms.

package/THIRD-PARTY-NOTICES.md

@@ -0,0 +1,43 @@
+# Avisos de terceiros
+
+Inventário do software de terceiros distribuído dentro deste pacote. Para cada item, a
+licença indicada **prevalece** sobre o `LICENSE` da raiz, conforme a seção "Componentes
+de terceiros" dele.
+
+Todo o conteúdo de terceiros está sob `skills/crow-interface/`. As demais 34 skills e o
+CLI são conteúdo próprio do Crow.
+
+## Impeccable — Apache License 2.0
+
+- Titular: Copyright 2025 Paul Bakaus
+- Upstream: https://github.com/pbakaus/impeccable
+- Licença: `skills/crow-interface/licenses/Apache-2.0.txt`
+- Aviso original preservado: `skills/crow-interface/licenses/Impeccable-NOTICE.md`
+- Proveniência, snapshot e modificações Crow: `skills/crow-interface/NOTICE.md`
+- Escopo: a skill `crow-interface` é reconstrução derivada da Impeccable. Arquivos
+  derivados trazem cabeçalho "Derived from Impeccable".
+
+## platform-design-skills — MIT
+
+- Licença: `skills/crow-interface/licenses/platform-design-MIT.txt`. O arquivo MIT
+  distribuído traz "Copyright (c) 2026" sem titular nomeado; a atribuição a
+  ehmo/platform-design-skills vem do NOTICE upstream, conforme registrado em
+  `skills/crow-interface/NOTICE.md`.
+- Escopo, segundo esse mesmo NOTICE: `skills/crow-interface/reference/ios.md` e
+  `skills/crow-interface/reference/android.md`.
+
+## modern-screenshot — MIT
+
+- Titular: Copyright (c) 2021-present wxm (projeto qq15725/modern-screenshot)
+- Licença: `skills/crow-interface/licenses/modern-screenshot-MIT.txt`
+- Escopo: `skills/crow-interface/scripts/modern-screenshot.umd.js`, bundle distribuído
+  sem modificação
+
+---
+
+# Third-party notices
+
+Inventory of third-party software redistributed inside this package. For each item, the
+stated licence **prevails** over the root `LICENSE`, per its "Componentes de terceiros"
+section. All third-party content lives under `skills/crow-interface/`; the other 34
+skills and the CLI are Crow's own content.

package/catalog.json

@@ -4,39 +4,139 @@
     "overlays": [
       {
         "skill": "crow-behaviour",
-        "roles": ["coordinator", "specialist", "reviewer"]
+        "roles": [
+          "coordinator",
+          "specialist",
+          "reviewer"
+        ]
       }
     ]
   },
   "groups": [
-    {"name": "essencial", "title": "Essencial", "description": "Coordenação e o que serve a quase todo projeto: arquitetura, especificação, depuração, testes e revisão de segurança",
-     "skills": ["crow-behaviour", "crow-architecture", "crow-spec", "crow-debug", "crow-qa", "crow-security-review"]},
-    {"name": "web", "title": "Web", "description": "Interfaces web: direção visual, implementação, acessibilidade, navegador e SEO",
-     "skills": ["crow-frontend", "crow-interface", "crow-design", "crow-accessibility", "crow-browser", "crow-seo"]},
-    {"name": "backend", "title": "Backend", "description": "Serviços, APIs, dados e domínio",
-     "skills": ["crow-backend", "crow-api-test", "crow-postgres", "crow-domain", "crow-architecture"]},
-    {"name": "qualidade", "title": "Qualidade", "description": "Testes, defeitos, desempenho e observabilidade",
-     "skills": ["crow-qa", "crow-debug", "crow-performance", "crow-observe"]},
-    {"name": "seguranca", "title": "Segurança", "description": "Revisão, varredura, prova, modelagem de ameaças, credenciais e apps com LLM",
-     "skills": ["crow-security-review", "crow-security-scan", "crow-security-test", "crow-threat-model", "crow-secrets", "crow-agent-security"]},
-    {"name": "infra", "title": "Infra e entrega", "description": "Infraestrutura, release e coordenação de plataforma",
-     "skills": ["crow-infra", "crow-release", "crow-platform"]},
-    {"name": "mobile", "title": "Mobile", "description": "Apps nativos e mobile",
-     "skills": ["crow-native-mobile"]},
-    {"name": "produto", "title": "Produto", "description": "Descoberta, especificação, crescimento, liderança e coordenação de plataforma",
-     "skills": ["crow-discovery", "crow-spec", "crow-growth", "crow-product-leadership", "crow-platform"]},
-    {"name": "midia-docs", "title": "Mídia e documentos", "description": "Mídia, documentos, planilhas, apresentações e experiência de conversa",
-     "skills": ["crow-media", "crow-documents", "crow-be-human"]},
-    {"name": "reverse", "title": "Engenharia reversa", "description": "Análise de código, binário ou protocolo",
-     "skills": ["crow-reverse"]},
-    {"name": "autoria", "title": "Autoria de skills", "description": "Criar ou revisar skills",
-     "skills": ["crow-skill-author"]}
+    {
+      "name": "essencial",
+      "title": "Essencial",
+      "description": "Coordenação e o que serve a quase todo projeto: arquitetura, especificação, depuração, testes e revisão de segurança",
+      "skills": [
+        "crow-behaviour",
+        "crow-architecture",
+        "crow-spec",
+        "crow-debug",
+        "crow-qa",
+        "crow-security-review"
+      ]
+    },
+    {
+      "name": "web",
+      "title": "Web",
+      "description": "Interfaces web: direção visual, implementação, acessibilidade, navegador e SEO",
+      "skills": [
+        "crow-frontend",
+        "crow-interface",
+        "crow-design",
+        "crow-accessibility",
+        "crow-browser",
+        "crow-seo"
+      ]
+    },
+    {
+      "name": "backend",
+      "title": "Backend",
+      "description": "Serviços, APIs, dados e domínio",
+      "skills": [
+        "crow-backend",
+        "crow-api-test",
+        "crow-postgres",
+        "crow-domain",
+        "crow-architecture"
+      ]
+    },
+    {
+      "name": "qualidade",
+      "title": "Qualidade",
+      "description": "Testes, defeitos, desempenho e observabilidade",
+      "skills": [
+        "crow-qa",
+        "crow-debug",
+        "crow-performance",
+        "crow-observe"
+      ]
+    },
+    {
+      "name": "seguranca",
+      "title": "Segurança",
+      "description": "Revisão, varredura, prova, modelagem de ameaças, credenciais e apps com LLM",
+      "skills": [
+        "crow-security-review",
+        "crow-security-scan",
+        "crow-security-test",
+        "crow-threat-model",
+        "crow-secrets",
+        "crow-agent-security"
+      ]
+    },
+    {
+      "name": "infra",
+      "title": "Infra e entrega",
+      "description": "Infraestrutura, release e coordenação de plataforma",
+      "skills": [
+        "crow-infra",
+        "crow-release",
+        "crow-platform"
+      ]
+    },
+    {
+      "name": "mobile",
+      "title": "Mobile",
+      "description": "Apps nativos e mobile",
+      "skills": [
+        "crow-native-mobile"
+      ]
+    },
+    {
+      "name": "produto",
+      "title": "Produto",
+      "description": "Descoberta, especificação, crescimento, liderança e coordenação de plataforma",
+      "skills": [
+        "crow-discovery",
+        "crow-spec",
+        "crow-growth",
+        "crow-product-leadership",
+        "crow-platform"
+      ]
+    },
+    {
+      "name": "midia-docs",
+      "title": "Mídia e documentos",
+      "description": "Mídia, documentos, planilhas, apresentações e experiência de conversa",
+      "skills": [
+        "crow-media",
+        "crow-documents",
+        "crow-be-human"
+      ]
+    },
+    {
+      "name": "reverse",
+      "title": "Engenharia reversa",
+      "description": "Análise de código, binário ou protocolo",
+      "skills": [
+        "crow-reverse"
+      ]
+    },
+    {
+      "name": "autoria",
+      "title": "Autoria de skills",
+      "description": "Criar ou revisar skills",
+      "skills": [
+        "crow-skill-author"
+      ]
+    }
   ],
   "skills": [
     {
       "name": "crow-behaviour",
       "title": "Atuação coordenada",
-      "description": "Use PROATIVAMENTE, sem o usuário pedir, em QUALQUER pedido que não seja conversa pura, pergunta factual curta ou ajuste trivial e local — inclusive quando é um arquivo só, uma decisão só ou só um plano: implementar uma feature, refatorar, depurar, auditar, revisar, migrar, planejar, pesquisar a fundo, tarefa multi-etapa, com exploração e decisões, ou que exija verificação antes de entregar. Carregue-a ANTES de começar; na dúvida, carregue. Nunca pergunte ao usuário se deve usá-la nem ofereça um critério mais estreito: com o modo crow ON a decisão já está tomada. Uma vez ativa, segue em uso nos prompts seguintes da sessão — mesmo plano, mesmo ledger e mesma validação por fases, retomados por conta própria quando faltarem. Ao ativar: decomponha o trabalho, delegue com as capacidades reais do runtime, verifique de forma adversarial e sintetize evidências. Não simule agentes nem altere permissões.",
+      "description": "Use PROATIVAMENTE, sem o usuário pedir, em QUALQUER pedido que não seja conversa pura, pergunta factual curta ou ajuste trivial e local — inclusive quando é um arquivo só, uma decisão só ou só um plano: implementar uma feature, refatorar, depurar, auditar, revisar, migrar, planejar, pesquisar a fundo, tarefa multi-etapa, com exploração e decisões, ou que exija verificação antes de entregar. Carregue-a ANTES de começar; na dúvida, carregue. Nunca pergunte ao usuário se deve usá-la nem ofereça critério mais estreito: com o modo crow ON a decisão já está tomada. Uma vez ativa, segue em uso nos prompts seguintes da sessão — mesmo plano, mesmo ledger e mesma validação por fases, retomados por conta própria quando faltarem. Ao ativar: decomponha, delegue o braçal a micro-agents de escopo mínimo com as capacidades reais do runtime, verifique de forma adversarial e sintetize evidências. Planejar, decidir, verificar e registrar são seus; o executor informa, você registra. Não simule agentes nem altere permissões.",
       "role": "coordinator",
       "owns": "execution-ledger",
       "next": []
@@ -44,7 +144,7 @@
     {
       "name": "crow-platform",
       "title": "Entrega de plataforma",
-      "description": "Coordene uma plataforma ou iniciativa que atravessa produto, design, engenharia e operação. Não use para um bug ou ajuste isolado.",
+      "description": "Coordene uma plataforma ou iniciativa que atravessa produto, design, engenharia e operação, mapeando as etapas que faltam e o contrato entre elas. Não use para um bug ou ajuste isolado; a coordenação da execução e a delegação são de crow-behaviour.",
       "role": "coordinator",
       "owns": "delivery-map",
       "next": [
@@ -57,7 +157,7 @@
     {
       "name": "crow-discovery",
       "title": "Problema e decisão de produto",
-      "description": "Investigue um problema de produto, segmento e hipótese antes de comprometer uma solução. Não reabra discovery para um bug conhecido.",
+      "description": "Investigue um problema de produto, segmento e hipótese antes de comprometer uma solução. Não reabra discovery para um bug conhecido. Especificação, fatia de release e critério de aceite são de crow-spec; preço, canal e retenção são de crow-growth.",
       "role": "specialist",
       "owns": "problem-brief",
       "next": [
@@ -68,7 +168,7 @@
     {
       "name": "crow-spec",
       "title": "Escopo e critérios de aceite",
-      "description": "Transforme uma decisão de produto em uma especificação enxuta, fatias de release e critérios testáveis. Não conduz pesquisa de mercado.",
+      "description": "Transforme uma decisão de produto em uma especificação enxuta, fatias de release e critérios testáveis. Não conduz pesquisa de mercado: investigar o problema é de crow-discovery, e escrever ou rodar a suíte a partir do critério é de crow-qa.",
       "role": "specialist",
       "owns": "feature-spec",
       "next": [
@@ -105,7 +205,7 @@
     {
       "name": "crow-design",
       "title": "Direção visual e contrato de UI",
-      "description": "Defina o contrato de experiência visual, fluxos, tokens e estados para implementação. Entrega brief/decisões, sem editar a interface nem repetir discovery resolvido.",
+      "description": "Use quando a decisão visual ainda não existe e precisa ser fixada antes de alguém implementar: direção, tokens, hierarquia, estados, vocabulário de interface e regras de adaptação de uma superfície. Entra também quando telas divergiram e falta uma fonte única. Não é para executar, refinar ou criticar interface já construída, que é de crow-interface, nem para integrar dados e comportamento da aplicação, que é de crow-frontend: aqui se decide, lá se constrói.",
       "role": "specialist",
       "owns": "design-contract",
       "next": [
@@ -176,7 +276,7 @@
     {
       "name": "crow-security-scan",
       "title": "Scans e evidência estática",
-      "description": "Execute ou analise SAST, dependências, imagens e IaC conforme o alvo; normalize e compare resultados. Não confirma explorabilidade nem faz autofix.",
+      "description": "Use para rodar ou analisar scanner (SAST, dependências/SCA, imagem, IaC) e normalizar, deduplicar e comparar o resultado com a baseline. Achado é alegação: entrega candidatos com evidência, não confirma explorabilidade nem faz autofix — isso é de crow-security-review (julga a mudança) e crow-security-test (prova dinâmica). Diferente delas, aqui a saída é evidência de ferramenta sobre o alvo estático.",
       "role": "specialist",
       "owns": "scan-evidence",
       "next": [
@@ -186,7 +286,7 @@
     {
       "name": "crow-agent-security",
       "title": "Limites de agentes e LLMs",
-      "description": "Revise apps com LLM, ferramentas, fontes externas e memória para injeção, autoridade excessiva e efeitos inseguros. Não tenta contornar controles de terceiros.",
+      "description": "Revise apps com LLM, ferramentas, MCP, fontes externas e memória quando um agente age com autoridade real: injeção indireta, autoridade excessiva, vínculo de ação, exfiltração por canal lateral e efeitos inseguros. Diferente de crow-threat-model, que modela o desenho, e de crow-security-review, que revisa a mudança de código: aqui o alvo são as fronteiras do agente em execução. Não contorna controles de terceiros nem roda exploits.",
       "role": "reviewer",
       "owns": "agent-controls",
       "next": [
@@ -232,7 +332,7 @@
     {
       "name": "crow-accessibility",
       "title": "Uso acessível da jornada",
-      "description": "Valide e corrija semântica, teclado, foco, leitura assistiva e autenticação de uma interface real. Não certifica conformidade completa por scanner.",
+      "description": "Use quando a pergunta é se uma jornada real pode ser usada sem mouse, sem visão e sem memorização: semântica, teclado, foco, leitura assistiva, contraste medido, zoom e reflow, movimento e autenticação acessível. Entra depois de implementada, ou para julgar achado de varredura. Não certifica conformidade de nível por scanner, não substitui a verificação de comportamento de crow-qa e não é refinamento estético, que é de crow-interface.",
       "role": "specialist",
       "owns": "a11y-evidence",
       "next": [
@@ -303,7 +403,7 @@
     {
       "name": "crow-seo",
       "title": "Saída pública e descoberta",
-      "description": "Revise conteúdo e saída técnica de páginas públicas para busca, coerência e indexação. Não otimiza área logada nem promete ranking.",
+      "description": "Use quando páginas públicas precisam ser encontráveis e a saída que o indexador recebe precisa ser conferida: status, metadado, canonical, robots, sitemap, dados estruturados, links internos, hreflang e renderização. Entra também quando uma rota saiu do índice, aparece sem descrição ou duplica outra. Não promete posição nem tráfego, não otimiza área logada e não é aquisição paga ou experimento de crescimento, que é de crow-growth.",
       "role": "specialist",
       "owns": "seo-change",
       "next": [
@@ -314,7 +414,7 @@
     {
       "name": "crow-media",
       "title": "Artefatos de imagem, áudio e vídeo",
-      "description": "Crie ou edite mídia a partir de brief e assets autorizados, preservando fontes e validando o arquivo final. Não exige um fornecedor específico.",
+      "description": "Use quando o entregável é um arquivo de imagem, áudio ou vídeo a criar ou editar a partir de brief e assets autorizados, e quando o resultado precisa ser medido antes de ser entregue. Entra também para diagnosticar perda de qualidade, dessincronismo, legenda ausente ou arquivo que não abre no destino. Não exige fornecedor, modelo ou CLI específico, não produz o documento que a mídia ilustra, que é de crow-documents, e não decide a direção visual, que é de crow-design.",
       "role": "specialist",
       "owns": "media-artifact",
       "next": [
@@ -325,7 +425,7 @@
     {
       "name": "crow-documents",
       "title": "Documentos e entregáveis",
-      "description": "Crie ou edite documentos, planilhas, apresentações ou HTML a partir de conteúdo real, validando conteúdo e formato final. Não usa exportadores irrelevantes.",
+      "description": "Use quando o entregável é um arquivo de documento, planilha, apresentação ou HTML a criar ou editar a partir de conteúdo real, e quando o formato final precisa ser conferido antes da entrega. Quando o pedido não nomeia formato de arquivo e a sessão tem ferramenta nativa de documento ou slide, é dela. A mídia que o documento contém é de crow-media, e a direção visual é de crow-design.",
       "role": "specialist",
       "owns": "document-artifact",
       "next": [
@@ -336,7 +436,7 @@
     {
       "name": "crow-skill-author",
       "title": "Manutenção de skills",
-      "description": "Crie ou revise uma skill com escopo único, descoberta precisa e validação de uso isolado e em composição. Não instala automaticamente pacotes de terceiros.",
+      "description": "Use quando o pedido é criar, revisar, corrigir ou preparar para publicação uma skill deste repositório, inclusive quando o sintoma é uma skill que não dispara, dispara fora de hora ou colide com uma irmã. Entra também para julgar a description e o contrato de uma skill existente. Não instala automaticamente pacotes de terceiros e não substitui a especialista do domínio que a skill descreve.",
       "role": "specialist",
       "owns": "skill-package",
       "next": [
@@ -416,15 +516,25 @@
       "description": "Projete, implemente ou avalie a conversa de um agente de IA por chat ou voz, inclusive somente por voz, para que seja natural e contínua. Jornada não visual é de crow-accessibility, conduta do próprio agente é de crow-behaviour. Não substitui identidade do produto, segurança ou implementação de áudio.",
       "role": "specialist",
       "owns": "conversation-experience",
-      "next": ["crow-media", "crow-accessibility", "crow-agent-security", "crow-qa"]
+      "next": [
+        "crow-media",
+        "crow-accessibility",
+        "crow-agent-security",
+        "crow-qa"
+      ]
     },
     {
       "name": "crow-interface",
       "title": "Experiência de interface",
-      "description": "Crie, revise ou refine a experiência visual de interfaces web e nativas, com modos distintos de planejamento, crítica, auditoria, implementação e variantes live. Não implementa backend nem integração de dados por efeito colateral.",
+      "description": "Use quando há interface web ou nativa para construir, revisar, criticar, auditar, refinar ou explorar em variantes interativas, com brief pronto ou sem brief. Não é para fixar do zero o contrato visual que ainda não existe, que é de crow-design, nem para implementar backend ou integração de dados da aplicação, que é de crow-frontend: crow-design decide, esta constrói e julga o construído.",
       "role": "specialist",
       "owns": "interface-result",
-      "next": ["crow-design", "crow-frontend", "crow-accessibility", "crow-performance"]
+      "next": [
+        "crow-design",
+        "crow-frontend",
+        "crow-accessibility",
+        "crow-performance"
+      ]
     }
   ]
 }

package/crow_skills/__init__.py

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

package/crow_skills/autoupdate.py

@@ -88,7 +88,12 @@ def detect(source_root=None):
         prefix = Path(npm.group(1))
         tool = prefix / "bin" / "npm"
         return {"kind": "npm", "root": text, "version": __version__, "launcher": str(prefix / "bin" / "crow-skills"),
-                "upgrade": [str(tool) if tool.exists() else (shutil.which("npm") or "npm"), "install", "-g", PACKAGE + "@latest"]}
+                # --prefer-online: medido em 2026-11-09, o self-upgrade falhou com ETARGET ("No matching
+                # version found") logo após a publicação porque o metadado da versão nova estava em
+                # cache local, enquanto o registry já servia o dist-tag novo. Sem isso, o upgrade
+                # depende de quando o cache do npm expira.
+                "upgrade": [str(tool) if tool.exists() else (shutil.which("npm") or "npm"),
+                            "install", "-g", "--prefer-online", PACKAGE + "@latest"]}
     if (base / ".git").exists():
         return {"kind": "git", "root": text, "version": __version__, "launcher": str(base / "bin" / "crow-skills"),
                 "upgrade": None}