@andespindola/crow-skills 0.12.0 → 0.12.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +2 -2
- package/crow_skills/__init__.py +1 -1
- package/crow_skills/resources.py +7 -6
- package/docs/cli.md +2 -2
- package/package.json +1 -1
- package/release.json +7 -7
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
Skills com escopo explícito, conhecimento especializado preservado e fluxos comuns reutilizáveis.
|
|
4
4
|
|
|
5
|
-
**Versão 0.12.
|
|
5
|
+
**Versão 0.12.1** ([mudanças](CHANGELOG.md)): correção pequena na proteção de processos registrados e um teste instável. A 0.12.0 fez a crow-behaviour passar a encerrar a árvore inteira de todo processo que a execução inicia (com timeout, registro no ledger e verificação no fim) e `crow-skills resources --orphans` encontra e, com `--kill`, encerra só o que ficou órfão de ferramentas de agente. A 0.11.1 fez o Codex deixar de mostrar em dobro as skills que o Uniflow já projeta em `~/.codex/skills`. A 0.11.0 trouxe `crow-skills setup --yes`, que configura de uma vez todos os CLIs de agente da máquina, e `crow-skills upgrade --yes`, que atualiza tudo numa só passada; os hooks que o crow-skills grava já saem habilitados (no Codex, aprovados pelo próprio `codex app-server`, só os do crow-skills; `--no-trust` desliga) e `status`/`doctor` mostram se cada CLI vai rodá-los; a ajuda ficou curta e organizada por tarefa. A 0.10.1 passou a tratar swap e CPU como eixos de pressão no controle de recursos (swap quase cheio e carga alta reduzem agentes, jobs e workers; nenhuma recomendação cresce com a pressão), mostrou a CPU% dos CLIs de agente, trouxe `crow-skills resources --exec-prefix` para rodar jobs pesados em prioridade baixa e as regras da crow-behaviour sob pressão (reduzir já, um job pesado por vez, não repetir verificação, validação ampla no CI); os hooks do Codex vão para o `config.toml` quando o `hooks.json` é symlink. A 0.10.0 trouxe o crow-broadcast, que compartilha, de forma passiva, o que cada sessão e cada CLI (Claude Code, Codex, Gemini CLI, Antigravity, Devin, inclusive dentro do Uniflow) está fazendo nesta máquina: repositório, clone, branch, execução crow em andamento e arquivos em edição; o prompt recebe um resumo só quando outra sessão viva está no mesmo repositório, editar um arquivo que outra sessão tocou ou trocar de branch num clone em uso gera aviso (ou bloqueio, se configurado), e `crow-skills broadcast claim` reserva áreas; a crow-behaviour consulta isso antes de planejar e reserva as áreas que delega ([crow-broadcast](docs/broadcast.md)). A 0.9.0 trouxe o controle de memória da máquina: `crow-skills resources` mede memória, pressão e os CLIs de agente em execução e recomenda quantos agentes, jobs pesados e workers rodar em paralelo; a crow-behaviour consulta essa recomendação antes de cada fan-out (sob `warn` reduz, sob `critical` segue sequencial), limita workers de builds e testes, reutiliza um dev server por projeto e encerra o que abriu, e 15 especialistas que sobem processos pesados ganharam a regra correspondente; o hook de prompt e as status lines só avisam quando a máquina está sob pressão. A 0.8.0 trouxe `crow-skills mode on|off`, que liga e desliga a crow-behaviour em todas as sessões e CLIs (Claude Code, Codex, Gemini CLI, Antigravity, Devin) a partir do próximo prompt, com `/crow on|off` dentro da sessão e o indicador `▸▸ crow on` na status line; a crow-behaviour mostra o progresso como a lista de agentes do host (`● main`, `○ dono atividade`); `crow-skills events` publica um barramento de eventos dos hooks para terminais; `crow-skills autoupdate on` atualiza o CLI e as skills gerenciadas todo dia e no login. A 0.7.1 trouxe as correções da revalidação no Codex às skills especialistas; a 0.7.0 tornou o Uniflow agente de instalação (`--agents uniflow`); a 0.6.1 passou a mostrar o progresso da crow-behaviour na própria conversa; a 0.6.0 trouxe as regras de entrega das 32 skills especialistas, a partir da [validação no Codex](docs/evaluations/2026-10-26-codex.md).
|
|
6
6
|
|
|
7
7
|
**Reconstrução em andamento.** A primeira versão com 32 contratos genéricos não atende à preservação de capacidades solicitada. Não use esse número nem o mapeamento por categoria como prova de substituição das originais. A revisão passa a abranger cada definição e seus recursos, modos e dependências, sem número fixo de skills ou limite artificial de linhas. Veja [critérios e progresso](docs/reconstruction.md).
|
|
8
8
|
|
|
@@ -42,7 +42,7 @@ Exemplos:
|
|
|
42
42
|
O pacote de cada skill é somente sua pasta em `skills/`. O [CLI crow-skills](docs/cli.md) instala cópias completas e versionadas em agentes/escopos explícitos, com preview, saída JSON, detecção de conflitos e recuperação. Requer Python 3.10+; Git para fontes em clone, Node 18+ para o launcher npm; mutações em macOS/Linux. A distribuição npm privada `@andespindola/crow-skills` inclui um snapshot completo das skills, sem clone ou hooks que as instalem automaticamente. No [Uniflow](docs/cli.md#uniflow), `--agents uniflow --global` grava as skills no store dele (`~/.config/uniflow/skills`), sem tocar no resto da configuração. Em `--global`, instalar a crow-behaviour também grava o guia aditivo do agente (claude, codex, gemini, devin) para usar as skills; `--no-guide` desliga. As integrações de interface (status lines do Claude Code, do Codex e do Antigravity, hooks do modo crow em cada CLI, comando `/crow`, segmento tmux) seguem o mesmo fluxo, preservando a configuração existente; `--no-integrations` desliga. O [barramento de eventos](docs/events.md) e a atualização automática (`crow-skills autoupdate on`) estão no [CLI](docs/cli.md).
|
|
43
43
|
|
|
44
44
|
```sh
|
|
45
|
-
npm install -g @andespindola/crow-skills@0.12.
|
|
45
|
+
npm install -g @andespindola/crow-skills@0.12.1
|
|
46
46
|
crow-skills mode
|
|
47
47
|
crow-skills progress
|
|
48
48
|
./bin/crow-skills list
|
package/crow_skills/__init__.py
CHANGED
package/crow_skills/resources.py
CHANGED
|
@@ -1354,8 +1354,9 @@ def orphan_scan(home, rows=None, context=None, older_than=None, now=None, uid=No
|
|
|
1354
1354
|
protected = set(context.get("livePids") or ())
|
|
1355
1355
|
for record in context.get("records") or []:
|
|
1356
1356
|
cli = by_pid.get(record.get("cliPid"))
|
|
1357
|
-
|
|
1358
|
-
|
|
1357
|
+
# A CLI pid counts only with its start time: a bare pid could be any live process (pid reuse, a forged record).
|
|
1358
|
+
cli_alive = cli is not None and not zombie(cli) and isinstance(record.get("cliStart"), (int, float)) \
|
|
1359
|
+
and abs(start_of(cli, now) - record["cliStart"]) <= CLI_REUSE_SECONDS
|
|
1359
1360
|
if record.get("key") in (context.get("liveKeys") or ()) or cli_alive:
|
|
1360
1361
|
if cli is not None:
|
|
1361
1362
|
protected.add(cli["pid"]) # the recorded CLI (not the hook's shell) shields its whole tree
|
|
@@ -1371,11 +1372,11 @@ def orphan_scan(home, rows=None, context=None, older_than=None, now=None, uid=No
|
|
|
1371
1372
|
row = by_pid.get(item.get("pid")) if isinstance(item, dict) else None
|
|
1372
1373
|
if not row or not isinstance(item.get("start"), (int, float)) or abs(start_of(row, now) - item["start"]) > RECORD_TOLERANCE:
|
|
1373
1374
|
continue
|
|
1374
|
-
if isinstance(item.get("cliPid"), int):
|
|
1375
|
-
# Protected exactly while the agent CLI that registered it lives (same pid, same start).
|
|
1375
|
+
if isinstance(item.get("cliPid"), int) and isinstance(item.get("cliStart"), (int, float)):
|
|
1376
|
+
# Protected exactly while the agent CLI that registered it lives (same pid, same start). A CLI pid
|
|
1377
|
+
# without its start time is treated as unknown: it could name any live process.
|
|
1376
1378
|
cli = by_pid.get(item["cliPid"])
|
|
1377
|
-
if cli is None or zombie(cli) or (
|
|
1378
|
-
and abs(start_of(cli, now) - item["cliStart"]) > CLI_REUSE_SECONDS):
|
|
1379
|
+
if cli is None or zombie(cli) or abs(start_of(cli, now) - item["cliStart"]) > CLI_REUSE_SECONDS:
|
|
1379
1380
|
continue
|
|
1380
1381
|
elif not item.get("fresh", True):
|
|
1381
1382
|
continue # CLI unknown: only while the ledger is fresh or its session is live
|
package/docs/cli.md
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
# crow-skills CLI 0.12.
|
|
1
|
+
# crow-skills CLI 0.12.1
|
|
2
2
|
|
|
3
3
|
CLI local-first para humanos e agentes. Python 3.10+, sem bibliotecas Python externas; Git é necessário para fontes em clone, não para o snapshot npm. O launcher npm requer Node 18+. Mutações suportadas em macOS/Linux (locks POSIX). Não instala o agente, não executa scripts das skills e não muda modelos, prompts base ou permissões. Instruções de uso das skills (o guia do agente, abaixo) são gravadas pelo comando `guide` e, por padrão, por `install`/`update`/`uninstall` em `--global` quando a crow-behaviour fica instalada para um agente com mecanismo verificado; `--no-guide` desliga isso. Os mesmos comandos também aplicam as [integrações de interface](#integrações-de-interface-integrations) (status lines do Claude Code, do Codex e do Antigravity, hooks do modo crow em cada CLI, comando `/crow`, segmento tmux); `--no-integrations` desliga. `crow-skills mode on|off` liga e desliga a crow-behaviour em [todas as sessões e CLIs](#modo-crow-mode); `crow-skills progress` mostra o [painel de progresso](#progresso-progress) da execução ativa; `crow-skills events` expõe o [barramento de eventos](#eventos-events) dos hooks; `crow-skills autoupdate on` liga a [atualização automática](#atualização-automática-autoupdate).
|
|
4
4
|
|
|
@@ -81,7 +81,7 @@ Para testar/distribuir o arquivo local sem registry:
|
|
|
81
81
|
|
|
82
82
|
```sh
|
|
83
83
|
npm pack
|
|
84
|
-
npm install -g ./andespindola-crow-skills-0.12.
|
|
84
|
+
npm install -g ./andespindola-crow-skills-0.12.1.tgz --ignore-scripts
|
|
85
85
|
```
|
|
86
86
|
|
|
87
87
|
O pacote contém o CLI Python e todas as skills do commit, com `release.json` de hashes. Não requer acesso ao GitHub ou clone para list/install. O launcher Node encaminha argumentos sem shell para Python em modo isolado, evitando imports pelo diretório do chamador/PYTHONPATH. `CROW_SKILLS_PYTHON` pode apontar para outro executável Python 3.10+. Não há dependências npm nem hooks de instalação que instalem skills automaticamente.
|
package/package.json
CHANGED
package/release.json
CHANGED
|
@@ -3,7 +3,7 @@
|
|
|
3
3
|
"README.md": {
|
|
4
4
|
"executable": false,
|
|
5
5
|
"kind": "file",
|
|
6
|
-
"sha256": "
|
|
6
|
+
"sha256": "ca600ff64f0c3d794b42135654c172dd040b6284f8b79f291dbe854481fe37b7"
|
|
7
7
|
},
|
|
8
8
|
"bin/npm-crow-skills.cjs": {
|
|
9
9
|
"executable": true,
|
|
@@ -18,7 +18,7 @@
|
|
|
18
18
|
"crow_skills/__init__.py": {
|
|
19
19
|
"executable": false,
|
|
20
20
|
"kind": "file",
|
|
21
|
-
"sha256": "
|
|
21
|
+
"sha256": "72d65fe5e39f0cfc22e0bbfd54dbc9e0e443b2c34afd95c986e42f5df20dca20"
|
|
22
22
|
},
|
|
23
23
|
"crow_skills/__main__.py": {
|
|
24
24
|
"executable": false,
|
|
@@ -93,7 +93,7 @@
|
|
|
93
93
|
"crow_skills/resources.py": {
|
|
94
94
|
"executable": false,
|
|
95
95
|
"kind": "file",
|
|
96
|
-
"sha256": "
|
|
96
|
+
"sha256": "871e3834c342ee52e98a0999c679a8f329d7bc6d71d3008b21d08c806d39a7c3"
|
|
97
97
|
},
|
|
98
98
|
"crow_skills/source.py": {
|
|
99
99
|
"executable": false,
|
|
@@ -123,12 +123,12 @@
|
|
|
123
123
|
"docs/cli.md": {
|
|
124
124
|
"executable": false,
|
|
125
125
|
"kind": "file",
|
|
126
|
-
"sha256": "
|
|
126
|
+
"sha256": "445940b764248e25bf71800a8aed9e184b2c6527b5bf90ccd7a4dc49d2ff0d6b"
|
|
127
127
|
},
|
|
128
128
|
"package.json": {
|
|
129
129
|
"executable": false,
|
|
130
130
|
"kind": "file",
|
|
131
|
-
"sha256": "
|
|
131
|
+
"sha256": "5f74bd91fb0a725d1c73f685add978f46d77dde016c3c47f07cbf9c3e5bfd5ca"
|
|
132
132
|
},
|
|
133
133
|
"skills/crow-accessibility/SKILL.md": {
|
|
134
134
|
"executable": false,
|
|
@@ -696,7 +696,7 @@
|
|
|
696
696
|
"sha256": "e37132ef8b060548191fbf14a5a18a9dd3acd84ea9a35e802174455b9e374d3d"
|
|
697
697
|
}
|
|
698
698
|
},
|
|
699
|
-
"revision": "
|
|
699
|
+
"revision": "993780fce9cee8136ab10bcfd460148fd65508c5",
|
|
700
700
|
"schema_version": 1,
|
|
701
|
-
"version": "0.12.
|
|
701
|
+
"version": "0.12.1"
|
|
702
702
|
}
|