@pathbit/agentdevkit 0.0.0-stage → 0.0.5

package/.pbai4devs/templates/gitignore/shared.ignore

@@ -0,0 +1,60 @@
+# Derivados locais
+/catalog.json
+/skills.json
+/agents.json
+/rules.json
+/espelhos.conf
+/estado/agentdevkit.json
+/estado/derived.json
+
+# Downloads e launchers de ferramentas
+/tools/bin/
+/tools/npm-cache/
+/tools/*/CURRENT.json
+/external-skills/*/
+
+# ---------------------------
+# CUSTOM IGNORE
+# ---------------------------
+
+## Estado local, caches e credenciais conhecidas
+**/.[Ll][Oo][Cc][Aa][Ll]/
+**/.[Cc][Aa][Cc][Hh][Ee]/
+/[Cc][Aa][Cc][Hh][Ee]/
+**/[Nn][Oo][Dd][Ee]_[Mm][Oo][Dd][Uu][Ll][Ee][Ss]/
+**/__pycache__/
+**/.DS_Store
+**/._*
+**/Thumbs.db
+**/Desktop.ini
+**/*.[Ss][Ww][Pp]
+**/*.[Ss][Ww][Oo]
+**/*~
+**/[Ss][Ee][Ss][Ss][Ii][Oo][Nn][Ss]/
+**/[Ll][Oo][Gg][Ss]/
+**/[Oo][Pp][Ee][Nn][Cc][Oo][Dd][Ee]-[Ll][Oo][Oo][Pp]/
+**/[Aa][Uu][Tt][Hh].[Jj][Ss][Oo][Nn]
+**/[Cc][Rr][Ee][Dd][Ee][Nn][Tt][Ii][Aa][Ll][Ss].[Jj][Ss][Oo][Nn]
+**/[Hh][Ii][Ss][Tt][Oo][Rr][Yy].[Jj][Ss][Oo][Nn][Ll]
+**/*.[Ll][Oo][Cc][Aa][Ll].[Jj][Ss][Oo][Nn]
+**/*.[Ll][Oo][Cc][Aa][Ll].[Jj][Ss][Oo][Nn][Cc]
+**/*.[Ll][Oo][Cc][Aa][Ll].[Tt][Oo][Mm][Ll]
+**/*.[Ll][Oo][Cc][Aa][Ll].[Yy][Aa][Mm][Ll]
+**/*.[Ll][Oo][Cc][Aa][Ll].[Yy][Mm][Ll]
+**/*.[Ll][Oo][Gg]
+**/.[Ee][Nn][Vv]
+**/.[Ee][Nn][Vv].*
+!**/.env.example
+!**/.env.sample
+!**/.env.template
+!**/.env.*.example
+
+## Resultados e arquivos temporarios
+**/.[Aa][Gg][Ee][Nn][Tt]-[Tt][Ee][Ss][Tt][Ss]/
+**/[Tt][Ee][Ss][Tt][Rr][Ee][Ss][Uu][Ll][Tt][Ss]/
+**/[Tt][Ee][Ss][Tt]-[Rr][Ee][Ss][Uu][Ll][Tt][Ss]/
+**/.[Pp][Ll][Aa][Yy][Ww][Rr][Ii][Gg][Hh][Tt]*
+**/[Pp][Ll][Aa][Yy][Ww][Rr][Ii][Gg][Hh][Tt]*/
+**/[Bb][Ll][Oo][Bb]-[Rr][Ee][Pp][Oo][Rr][Tt]/
+**/[Tt][Mm][Pp]/
+**/[Tt][Ee][Mm][Pp]/

package/.pbai4devs/templates/instrucoes-agentes/TEMPLATE.md

@@ -0,0 +1,25 @@
+---
+description: Funcionamento do projeto e descoberta dos recursos dos agentes.
+status: modelo
+---
+
+# Guia de agentes
+
+## Projeto
+
+[Propósito, fase, estrutura e pontos de entrada conhecidos. Atualize conforme
+produto, arquitetura e comandos de desenvolvimento forem definidos.]
+
+## Recursos compartilhados
+
+A origem fica em `.pbai4devs/`: skills, comandos, agentes e regras têm seus
+índices e apontamentos próprios. Liste as skills/grupos existentes e indique
+`.pbai4devs/INSTRUCTIONS.md` para ordem e pré-requisitos.
+Skills externas são referências do catálogo `.pbai4devs/external-skills/README.md`;
+downloads locais não pertencem aos espelhos.
+
+## Trabalho no repositório
+
+[Indique comandos reais e os documentos de produto/arquitetura vigentes.]
+Consulte as regras e skills correspondentes à tarefa; mantenha detalhes do
+fluxo na origem de cada recurso. `CLAUDE.md` aponta para este arquivo.

package/.pbai4devs/templates/plano-implementacao/TEMPLATE.md

@@ -0,0 +1,27 @@
+---
+description: Plano do incremento antes de alterar sua implementação.
+status: modelo
+spec: null
+---
+
+# Plano de implementação
+
+## Escopo e dúvidas
+
+[Spec/referência, critérios AC-001, dependências e respostas necessárias antes
+de implementar. Declare limites e o que não faz parte desta entrega.]
+
+## Passos
+
+| Passo | Arquivos/contratos | Critérios | Verificação |
+| --- | --- | --- | --- |
+| A definir | A definir | AC-001 | A definir |
+
+## Documentação e entrega
+
+[Documentos afetados, riscos/reversão e pré-requisitos de validação. Reutilize
+as matrizes da spec e o relatório de revisão; não replique status manualmente.]
+
+## Aprovação
+
+[Decisão do usuário e mudanças de escopo que exigem revisar este plano.]

package/.pbai4devs/templates/prd/TEMPLATE.md

@@ -0,0 +1,30 @@
+---
+description: Requisitos de produto.
+status: rascunho
+---
+
+# PRD
+
+## Problema e objetivo
+
+A definir.
+
+## Público e necessidades
+
+A definir.
+
+## Escopo e requisitos
+
+A definir.
+
+## Sucesso e validação
+
+A definir.
+
+## Dependências e questões pendentes
+
+A definir.
+
+## Aprovação
+
+Pendente.

package/.pbai4devs/templates/readme-pasta/TEMPLATE.md

@@ -0,0 +1,16 @@
+---
+description: Finalidade e entradas de uma pasta de documentação ou projeto.
+status: modelo
+---
+
+# Nome da pasta
+
+[Finalidade, público e quando consultar este conteúdo.]
+
+## Conteúdo
+
+[Liste apenas os documentos ou pontos de entrada relevantes que existem.]
+
+## Manutenção
+
+[Informe a origem das informações e que mudanças exigem atualizar esta pasta.]

package/.pbai4devs/templates/readme-projeto/TEMPLATE.md

@@ -0,0 +1,34 @@
+---
+description: Apresentação e uso do projeto, atualizados conforme sua fase.
+status: modelo
+fase: preparacao
+---
+
+# Nome do projeto
+
+[Propósito e público conhecidos; na preparação, indique o que ainda falta.]
+
+## Estado
+
+[Fase atual, funcionalidades disponíveis e limites; vincule os documentos
+existentes. Evolua este resumo após PRD, design, configuração e entregas.]
+
+## Começar
+
+[Pré-requisitos, configuração e comandos reais verificados. Antes da definição
+técnica, explique a próxima etapa em vez de inventar comandos ou uma stack.]
+
+## Estrutura e documentação
+
+[Pastas relevantes, pontos de entrada e documentos vigentes. Indique
+`AGENTS.md` para agentes e `CONTRIBUTING.md` para o fluxo de contribuição.]
+
+## Verificar e operar
+
+[Testes, comportamento esperado, limitações e procedimentos que já funcionam.
+Inclua instalação/uso público e compatibilidade quando houver uma release.]
+
+## Próximos passos
+
+[Próxima ação e pré-requisitos reais para a fase atual; consulte a regra
+`.pbai4devs/rules/proximos-passos/RULE.md`.]

package/.pbai4devs/templates/release/TEMPLATE.md

@@ -0,0 +1,23 @@
+---
+description: Planejamento de uma release.
+status: rascunho
+---
+
+# Release
+
+## Objetivo e specs
+
+A definir.
+
+## Dependências e estado
+
+A definir.
+
+## Evidências e pendências
+
+Referencie os relatórios de revisão aprovados das entregas e os impedimentos.
+
+## Documentação da versão
+
+[Notas no CHANGELOG, compatibilidade/migração e instruções de uso/operação
+afetadas. Confira a política de segurança quando houver suporte público.]

package/.pbai4devs/templates/revisao-entrega/TEMPLATE.md

@@ -0,0 +1,41 @@
+---
+description: Contrato do relatório executável de revisão de uma entrega.
+status: modelo
+---
+
+# Revisão de entrega
+
+O relatório real é um único JSON em
+`.agent-tests/<referencia>/<execucao>/revisao.json`, sem outra cópia Markdown.
+Gere-o pelo script `revisar-entrega prepare --id <referencia>`, com `--spec`
+ou `--scope` conforme a mudança. Preserve o snapshot gerado pelo script.
+
+| Campo | Contrato |
+| --- | --- |
+| `version` | `1`. |
+| `reference`, `execution` | Identificadores da mudança e da execução. |
+| `spec` | Caminho da spec ou `null` para mudança sem spec. |
+| `snapshot` | Modo, HEAD, hashes, spec e documentos obrigatórios revisados. |
+| `baseline` | Caminho e hash do escopo original gerado por `prepare`. |
+| `documentation` | Caminho, decisão e justificativa por documento. |
+| `validation` | Critério AC-001, método, pré-requisito, assertiva e provas. |
+| `review` | Revisor, estado e achados do estado final. |
+
+Decisões de documentação: `pending`, `updated`, `no-impact`, `not-applicable`.
+Status de validação: `pending`, `passed`, `failed`, `not-run`, `not-applicable`.
+Toda ausência de impacto/aplicação precisa de justificativa. Evidências devem
+existir em caminhos relativos sob a pasta ignorada da execução; código de teste
+permanece versionado. Sem spec, defina critérios próprios com IDs AC-001.
+O gate só aprova critérios com `passed` e evidência. Um aceite não aplicável
+exige rever o escopo aprovado; marcar `not-applicable` não o dispensa.
+
+O revisor trabalha em leitura; o agente principal registra seus achados no
+JSON. `review.status` só passa de `pending` a `approved` após fechar achados
+`open` como `resolved` e revisar o estado final. Alterações posteriores exigem
+novo snapshot, verificações afetadas e nova revisão.
+
+Execute `revisar-entrega seal <relatorio>` após a aprovação independente e
+`revisar-entrega check <relatorio>` antes do commit/merge. `baseline.json` e
+`seal.json` são metadados gerados, sem edição manual. O script
+confere consistência, cobertura, arquivos e evidências; a revisão humana ou do
+agente revisor avalia a semântica e a qualidade do resultado.

package/.pbai4devs/templates/roadmap/TEMPLATE.md

@@ -0,0 +1,18 @@
+---
+description: Planejamento do projeto e de suas entregas.
+status: rascunho
+---
+
+# Roadmap
+
+## Objetivos e prioridades
+
+A definir.
+
+## Etapas e dependências
+
+A definir.
+
+## Entregas e pendências
+
+A definir.

package/.pbai4devs/templates/seguranca/TEMPLATE.md

@@ -0,0 +1,22 @@
+---
+description: Política de segurança condicionada a produto e suporte definidos.
+status: modelo
+---
+
+# Segurança
+
+## Versões atendidas
+
+[Versões e escopo de suporte realmente assumidos pela equipe.]
+
+## Relatar uma vulnerabilidade
+
+[Canal privado existente, confirmado pelo responsável, e informações úteis.
+Não invente endereço, programa de recompensas ou prazo de resposta.]
+
+## Tratamento
+
+[Expectativas que a equipe consegue cumprir e orientações de divulgação.]
+
+[Crie a política real quando houver produto distribuído e suporte definido.
+Enquanto isso, registre sua não aplicação ou a pendência na revisão.]

package/.pbai4devs/templates/spec/TEMPLATE.md

@@ -0,0 +1,61 @@
+---
+description: Especificação de um incremento.
+status: rascunho
+---
+
+# Nome da spec
+
+## Objetivo
+
+A definir.
+
+## Requisitos funcionais
+
+A definir.
+
+## Requisitos não funcionais
+
+A definir.
+
+## Escopo e fora de escopo
+
+A definir.
+
+## Restrições técnicas
+
+A definir.
+
+## Critérios de aceite
+
+| Critério | Resultado observável |
+| --- | --- |
+| AC-001 | A definir. |
+
+## Plano de verificação
+
+Defina a prova antes de implementar. Evidências ficam em
+`.agent-tests/<spec>/<execucao>/`; o código dos testes é versionado.
+
+| Critério | Método/comando | Pré-requisito | Assertiva | Evidência | Status |
+| --- | --- | --- | --- | --- | --- |
+| AC-001 | A definir | A definir | A definir | A definir | pending |
+
+Indique a URL/fluxo para web, a aplicação/ação para desktop ou o comando real
+para lógica/API. A assertiva descreve o que comprova o resultado; um código de
+saída isolado não comprova comportamento. Registre `passed`, `failed`,
+`not-run` ou `not-applicable` no relatório único de revisão.
+`not-applicable` não aprova um aceite: revise o escopo com o usuário antes de
+removê-lo. Todo critério mantido exige `passed` e evidência para concluir.
+
+## Impacto na documentação
+
+[Documentos e exemplos que deverão mudar; registre ausência de impacto com
+justificativa na revisão.]
+
+## Dependências de outras specs
+
+A definir.
+
+## Referências e aprovação
+
+PRD, UX/UI, design e configuração vigentes: a definir. Aprovação: pendente.

package/.pbai4devs/templates/tasks/TEMPLATE.md

@@ -0,0 +1,20 @@
+---
+description: Tarefas e progresso de uma spec.
+status: rascunho
+---
+
+# Tarefas da spec
+
+## Referências
+
+Spec e release: a definir.
+
+## Tarefas
+
+- [ ] T-001: a definir; critério AC-001; prova e dependências a definir.
+
+## Entrega
+
+Relatório único: `.agent-tests/<spec>/<execucao>/revisao.json`.
+Mantenha evidências e status detalhados nesse relatório. Registre aqui apenas
+as tarefas restantes e os impedimentos, sem duplicar resultados de testes.

package/.pbai4devs/templates/ux-ui/TEMPLATE.md

@@ -0,0 +1,26 @@
+---
+description: Experiência e interface do produto.
+status: rascunho
+---
+
+# UX e UI
+
+## Referência ao PRD
+
+A definir.
+
+## Usuários e jornadas
+
+A definir.
+
+## Interface e acessibilidade
+
+A definir.
+
+## Validação e pendências
+
+A definir.
+
+## Aprovação
+
+Pendente.

package/.pbai4devs/tools/README.md

@@ -0,0 +1,87 @@
+---
+description: Catálogo de CLIs e ferramentas condicionais para os agentes.
+---
+
+# Ferramentas
+
+Cada pasta mantém `TOOL.json`, `SCRIPT.mjs` e um guia.
+O catálogo local `catalog.json` relaciona essas definições aos comandos
+de instalação, atualização, verificação e execução. Ao editar definições,
+rode `sincronizar-agentes` e `--check`; versões instaladas ficam no estado local.
+O instalador comum consulta `latest` na origem oficial e instala com
+`--ignore-scripts`. Pacotes e estado ficam em `<nome>/.local/`; cache em
+`.cache/` e atalhos em `bin/`, todos ignorados. Tools ficam só em `.pbai4devs`.
+
+| CLI | Grupo | Uso |
+| --- | --- | --- |
+| [agent-browser][browser] | base | Automação web. |
+| [markdownlint-cli2][lint] | base | Lint de Markdown. |
+| [agent-desktop][desktop] | desktop | Automação desktop. |
+| [skills][skills] | discovery | Descoberta de skills. |
+| [just-bash][bash] | shell | Shell em sistema virtual. |
+| [opensrc][source] | source | Fontes de dependências. |
+| [webreel][video] | video | Roteiros e vídeos do navegador. |
+| [portless][proxy] | proxy | Proxy e URLs locais estáveis. |
+
+`setup` instala e verifica todos os CLIs compatíveis. O grupo `base` limita a
+seleção a navegador e lint; outros grupos permitem escolher por tarefa.
+Confira Node/npm pelo [primeiro uso][manager] antes de executar os scripts.
+O instalador usa o mesmo Node 24+ com npm em todos os sistemas. Plataformas aceitas
+ficam em cada `TOOL.json`; ausência de restrição npm não comprova teste do SO.
+
+```console
+node .pbai4devs/tools/skills/SCRIPT.mjs install
+node .pbai4devs/tools/skills/SCRIPT.mjs update
+node .pbai4devs/tools/skills/SCRIPT.mjs check
+node .pbai4devs/tools/skills/SCRIPT.mjs run --version
+```
+
+Use os mesmos comandos no macOS, Linux e Windows. `install` reutiliza
+uma instalação saudável; `update` consulta `latest`; `check` verifica sem rede;
+`run` executa sem instalar; `info` mostra a configuração. Sem ação, há ajuda.
+`unlock <nome>` no instalador recupera somente locks locais de processos
+comprovadamente encerrados; preserva locks ativos ou de origem incerta.
+O [instalador comum][manager] aceita nomes ou grupos, como `setup`, `install base`,
+`update video`, `check source` e `list`.
+
+O preparo verifica o CLI; fluxos de aplicação precisam de provas específicas.
+Skills usa descoberta sem importação automática ou symlinks. Portless é opt-in:
+o preparo não inicia proxy. Webreel exige executáveis explícitos para gravar
+sem baixar recursos em `~/.webreel`; seu guia lista os overrides. Use caminhos
+de estado suportados por `envPaths`, sem alterar `HOME`. Versione testes e
+roteiros; resultados, vídeos e capturas ficam em `.agent-tests/`.
+
+Outras candidatas ficam condicionadas à necessidade, com adoção após definir
+produto e arquitetura; esta configuração não adiciona dependências à aplicação.
+
+| Candidata | Quando considerar |
+| --- | --- |
+| [emulate][emulate] | Emular serviços usados pelas integrações e pelo CI. |
+| [agent-eval][eval] | Comparar agentes com credenciais e infraestrutura. |
+| [issue-graph][issues] | Consultar issues via `gh` ou Linear autenticado. |
+| [konsistent][consistency] | Aplicar padrões estruturais num projeto TS. |
+| [phase][performance] | Analisar performance de um frontend existente. |
+| [dev3000][debug] | Depurar servidor/browser com runtime e proxy preparados. |
+| [bash-tool][sdk], [AI SDK][ai] | Implementar agentes na stack aprovada. |
+
+`next-browser` está arquivado. `before-and-after` é uma skill no código atual;
+o antigo CLI npm não representa esse formato. As coleções `agent-skills` são
+fontes de skills, não CLIs adicionais. Importe recursos pelo fluxo do projeto.
+
+[browser]: agent-browser/README.md
+[lint]: markdownlint-cli2/README.md
+[desktop]: agent-desktop/README.md
+[skills]: skills/README.md
+[bash]: just-bash/README.md
+[source]: opensrc/README.md
+[video]: webreel/README.md
+[proxy]: portless/README.md
+[manager]: ../scripts/preparar-ferramentas/README.md
+[emulate]: https://github.com/vercel-labs/emulate
+[eval]: https://github.com/vercel-labs/agent-eval
+[issues]: https://github.com/vercel-labs/issue-graph
+[consistency]: https://github.com/vercel-labs/konsistent
+[performance]: https://github.com/vercel-labs/phase
+[debug]: https://github.com/vercel-labs/dev3000
+[sdk]: https://github.com/vercel-labs/bash-tool
+[ai]: https://github.com/vercel/ai

package/.pbai4devs/tools/agent-browser/README.md

@@ -0,0 +1,26 @@
+---
+description: Origem e uso local do agent-browser.
+---
+
+# Agent-browser
+
+Origem: [instalação oficial](https://agent-browser.dev/installation).
+O [TOOL.json](TOOL.json) define o pacote npm, canal `latest`, plataformas e probe.
+O campo `executables` declara os binários que recebem permissão de execução
+no preparo POSIX, sem habilitar scripts de instalação do pacote.
+
+```console
+node .pbai4devs/tools/agent-browser/SCRIPT.mjs install
+node .pbai4devs/tools/agent-browser/SCRIPT.mjs update
+node .pbai4devs/tools/agent-browser/SCRIPT.mjs run --version
+```
+
+Use `check` para conferir a instalação e `info` para ver sua configuração.
+O preparo exige Node 24+/npm. Use Chrome/Chromium existente por
+`run --executable-path <caminho> ...`; o script não baixa um navegador.
+O launcher publicado para Windows ARM64 pode usar o binário x64 em emulação.
+Antes da automação, leia `run skills get core` da versão instalada.
+Pacotes e registros de instalação ficam em `.local/`; o estado próprio do CLI
+pode usar `~/.agent-browser`, conforme a
+[configuração oficial](https://agent-browser.dev/configuration). O script não
+altera `HOME`. Os testes usam sessão própria e a encerram ao terminar.

package/.pbai4devs/tools/agent-browser/SCRIPT.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { main } from '../../scripts/preparar-ferramentas/SCRIPT.mjs';
+
+try { process.exitCode = await main(['--tool', "agent-browser", ...process.argv.slice(2)]); }
+catch (error) { console.error(error.message); process.exitCode = 1; }

package/.pbai4devs/tools/agent-browser/TOOL.json

@@ -0,0 +1,33 @@
+{
+  "name": "agent-browser",
+  "description": "Automacao e verificacao em navegador real.",
+  "group": "base",
+  "source": "https://agent-browser.dev/installation",
+  "download": {
+    "provider": "npm",
+    "package": "agent-browser",
+    "registry": "https://registry.npmjs.org/",
+    "repository": "vercel-labs/agent-browser",
+    "channel": "latest"
+  },
+  "platforms": [
+    "darwin-arm64",
+    "darwin-x64",
+    "linux-arm64",
+    "linux-x64",
+    "win32-arm64",
+    "win32-x64"
+  ],
+  "executables": {
+    "darwin-arm64": ["bin/agent-browser-darwin-arm64"],
+    "darwin-x64": ["bin/agent-browser-darwin-x64"],
+    "linux-arm64": ["bin/agent-browser-linux-arm64", "bin/agent-browser-linux-musl-arm64"],
+    "linux-x64": ["bin/agent-browser-linux-x64", "bin/agent-browser-linux-musl-x64"]
+  },
+  "scripts": {
+    "entry": "SCRIPT.mjs"
+  },
+  "probe": [
+    "--version"
+  ]
+}

package/.pbai4devs/tools/agent-desktop/README.md

@@ -0,0 +1,26 @@
+---
+description: Origem e uso local opcional do agent-desktop.
+---
+
+# Agent-desktop
+
+Origem: [instalação oficial](https://agent-browser.dev/desktop/installation).
+O [TOOL.json](TOOL.json) define o pacote npm, canal `latest`, plataformas e probe.
+
+```console
+node .pbai4devs/tools/agent-desktop/SCRIPT.mjs install
+node .pbai4devs/tools/agent-desktop/SCRIPT.mjs update
+node .pbai4devs/tools/agent-desktop/SCRIPT.mjs run status
+```
+
+Use `check` para conferir a instalação e `run version` para ver a versão.
+O script usa `AGENT_DESKTOP_HOME` em `.local/state`, sem alterar `HOME`.
+O preparo comum exige Node 24+/npm. A interação depende do SO:
+[macOS 13+ e permissões](https://agent-browser.dev/desktop/platforms/macos),
+[Linux com glibc e sessão AT-SPI](https://agent-browser.dev/desktop/platforms/linux)
+ou Windows compatível. Instalar não concede permissões nem abre aplicações.
+Antes de agir, leia `run skills get desktop` e `run skills get platform`.
+
+O teste [SMOKE_DESKTOP.mjs](../../scripts/preparar-ferramentas/tests/SMOKE_DESKTOP.mjs)
+abre um Chrome isolado e lê sua janela por acessibilidade, sem entrada física.
+Exige sessão gráfica, permissões e Chrome instalado; encerra sua própria sessão.

package/.pbai4devs/tools/agent-desktop/SCRIPT.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { main } from '../../scripts/preparar-ferramentas/SCRIPT.mjs';
+
+try { process.exitCode = await main(['--tool', "agent-desktop", ...process.argv.slice(2)]); }
+catch (error) { console.error(error.message); process.exitCode = 1; }

package/.pbai4devs/tools/agent-desktop/TOOL.json

@@ -0,0 +1,30 @@
+{
+  "name": "agent-desktop",
+  "description": "Automacao e verificacao de aplicativos desktop.",
+  "group": "desktop",
+  "source": "https://agent-browser.dev/desktop/installation",
+  "download": {
+    "provider": "npm",
+    "package": "agent-desktop",
+    "registry": "https://registry.npmjs.org/",
+    "repository": "vercel-labs/agent-desktop",
+    "channel": "latest"
+  },
+  "platforms": [
+    "darwin-arm64",
+    "darwin-x64",
+    "linux-arm64",
+    "linux-x64",
+    "win32-arm64",
+    "win32-x64"
+  ],
+  "scripts": {
+    "entry": "SCRIPT.mjs"
+  },
+  "envPaths": {
+    "AGENT_DESKTOP_HOME": "state"
+  },
+  "probe": [
+    "version"
+  ]
+}

package/.pbai4devs/tools/just-bash/README.md

@@ -0,0 +1,23 @@
+---
+description: Execução local de Bash em ambiente virtual.
+---
+
+# Just Bash
+
+Origem: [Vercel Labs][source]. Apache-2.0; Node 24+.
+Configuração e canal `latest`: [TOOL.json](TOOL.json).
+
+```console
+node .pbai4devs/tools/just-bash/SCRIPT.mjs install
+node .pbai4devs/tools/just-bash/SCRIPT.mjs run -c 'printf "ok\n"' --json
+```
+
+`--root <pasta>` lê arquivos do disco e bloqueia escritas por padrão.
+`--allow-write` habilita escritas em um OverlayFS em memória, descartadas ao
+final; os arquivos do host são preservados.
+Use este CLI para tarefas de shell compatíveis; verifique aplicações com seus
+testes e runtimes reais. Pacotes ficam em `.local/`.
+
+[Operações comuns e plataformas](../README.md).
+
+[source]: https://github.com/vercel-labs/just-bash/tree/main/packages/just-bash

package/.pbai4devs/tools/just-bash/SCRIPT.mjs

@@ -0,0 +1,5 @@
+#!/usr/bin/env node
+import { main } from '../../scripts/preparar-ferramentas/SCRIPT.mjs';
+
+try { process.exitCode = await main(['--tool', "just-bash", ...process.argv.slice(2)]); }
+catch (error) { console.error(error.message); process.exitCode = 1; }