@pathbit/agentdevkit 0.0.5 → 0.0.6
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/.pbai4devs/README.md +4 -1
- package/CHANGELOG.md +7 -0
- package/README.en.md +14 -3
- package/README.es.md +14 -3
- package/README.md +28 -22
- package/docs/guides/installation.md +10 -2
- package/docs/maintainers/packages.md +13 -2
- package/docs/product/design.md +10 -0
- package/docs/product/prd.md +8 -2
- package/docs/product/roadmap.md +4 -2
- package/docs/specs/README.md +1 -0
- package/docs/specs/v0.0.6/README.md +10 -0
- package/docs/specs/v0.0.6/SPEC.md +77 -0
- package/package.json +19 -4
- package/src/install.mjs +7 -1
package/.pbai4devs/README.md
CHANGED
|
@@ -33,10 +33,13 @@ Somente `SKILL.md`, `AGENT.md`, `COMMAND.md` e `RULE.md` em suas pastas
|
|
|
33
33
|
têm apontamentos nas ferramentas. A origem é agrupada; os destinos usam o
|
|
34
34
|
layout registrado. Veja a [compatibilidade](COMPATIBILIDADE.md) dos clientes.
|
|
35
35
|
Recursos auxiliares e guias ficam exclusivamente em `.pbai4devs`.
|
|
36
|
+
A licença do kit fica em `LICENSE` dentro deste hub após `init` ou `update`.
|
|
37
|
+
Ela vem do pacote e não substitui a licença do projeto consumidor.
|
|
36
38
|
Os testes das automações ficam em `scripts/<nome>/tests/`; seus resultados são
|
|
37
39
|
ignorados em `.agent-tests/`.
|
|
38
40
|
O `.gitignore` desta pasta controla sua árvore. As saídas nos clientes são
|
|
39
|
-
protegidas por regras locais geradas dos
|
|
41
|
+
protegidas por regras locais geradas dos
|
|
42
|
+
[modelos](templates/gitignore/TEMPLATE.md).
|
|
40
43
|
Um `.gitignore` não consegue ignorar irmãos com `../`; o gerador usa o local
|
|
41
44
|
correto do Git e preserva configurações humanas.
|
|
42
45
|
Os modelos acompanham cada fase. Após implementar, use `atualizar-documentacao`
|
package/CHANGELOG.md
CHANGED
|
@@ -4,6 +4,13 @@ description: Alterações verificáveis por versão do AgentDevKit.
|
|
|
4
4
|
|
|
5
5
|
# Changelog
|
|
6
6
|
|
|
7
|
+
## 0.0.6 — 2026-11-11
|
|
8
|
+
|
|
9
|
+
- Metadados npm com autoria PathBit, palavras-chave e licença MIT.
|
|
10
|
+
- README público sem frontmatter, com links absolutos para o GitHub.
|
|
11
|
+
- Licença canônica instalada no hub, preservando a licença do consumidor.
|
|
12
|
+
- Verificação de versão estável, consumo anônimo e atualização do router.
|
|
13
|
+
|
|
7
14
|
## 0.0.5 — 2026-11-11
|
|
8
15
|
|
|
9
16
|
- Documentação organizada em guias, produto e manutenção, com índices próprios.
|
package/README.en.md
CHANGED
|
@@ -7,6 +7,8 @@ language: en
|
|
|
7
7
|
|
|
8
8
|
[Português](README.md) · [Español](README.es.md) · [npm package][npm-package]
|
|
9
9
|
|
|
10
|
+
[![npm][npm-badge]][npm-package] [![MIT][license-badge]](LICENSE)
|
|
11
|
+
|
|
10
12
|
Organize work with coding agents, from planning to verification. Keep skills,
|
|
11
13
|
rules, commands and agent profiles in `.pbai4devs`; the kit generates the
|
|
12
14
|
references each client can discover. Code lives in `src/`, product tests in
|
|
@@ -32,7 +34,7 @@ Then open the project in your coding agent and ask:
|
|
|
32
34
|
|
|
33
35
|
See [installation](docs/guides/installation.md) for Windows, missing Node, previews
|
|
34
36
|
and updates. Install and update through the [public npm package][packages]; the
|
|
35
|
-
[v0.0.
|
|
37
|
+
[v0.0.6 release][release] retains artifacts and checksums for verification.
|
|
36
38
|
No global installation is required.
|
|
37
39
|
The CLI supports `pt`, `en` and `es`; it saves your selection per project.
|
|
38
40
|
|
|
@@ -60,7 +62,14 @@ tools are installed separately. Product documents follow your planning
|
|
|
60
62
|
decisions. Existing projects retain their code and decisions. Discovery
|
|
61
63
|
depends on the client; references alone do not prove a skill was loaded.
|
|
62
64
|
|
|
63
|
-
|
|
65
|
+
## License and authorship
|
|
66
|
+
|
|
67
|
+
Maintained by [PathBit](https://www.pathbit.com.br),
|
|
68
|
+
under the [MIT license](LICENSE).
|
|
69
|
+
Installation includes the kit license in `.pbai4devs/LICENSE` and preserves
|
|
70
|
+
your project's license and files.
|
|
71
|
+
|
|
72
|
+
[Changelog](CHANGELOG.md) · [Roadmap](docs/product/roadmap.md)
|
|
64
73
|
|
|
65
74
|
Found a bug or have an idea? [Open an issue][issues] using the contribution
|
|
66
75
|
forms. See [how to participate](docs/maintainers/community.md).
|
|
@@ -69,8 +78,10 @@ forms. See [how to participate](docs/maintainers/community.md).
|
|
|
69
78
|
agent to read `AGENTS.md`.
|
|
70
79
|
|
|
71
80
|
[clients]: .pbai4devs/COMPATIBILIDADE.md
|
|
72
|
-
[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.
|
|
81
|
+
[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.6
|
|
73
82
|
[npm-package]: https://www.npmjs.com/package/@pathbit/agentdevkit
|
|
83
|
+
[npm-badge]: https://img.shields.io/npm/v/%40pathbit%2Fagentdevkit
|
|
84
|
+
[license-badge]: https://img.shields.io/badge/license-MIT-blue
|
|
74
85
|
[tests]: docs/guides/tools-and-testing.md
|
|
75
86
|
[cli]: docs/guides/cli.md
|
|
76
87
|
[help]: docs/guides/troubleshooting.md
|
package/README.es.md
CHANGED
|
@@ -7,6 +7,8 @@ language: es
|
|
|
7
7
|
|
|
8
8
|
[Português](README.md) · [English](README.en.md) · [Paquete npm][npm-package]
|
|
9
9
|
|
|
10
|
+
[![npm][npm-badge]][npm-package] [![MIT][license-badge]](LICENSE)
|
|
11
|
+
|
|
10
12
|
Organiza el trabajo con agentes de código, desde la planificación hasta la
|
|
11
13
|
verificación. Mantén skills, reglas, comandos y perfiles en `.pbai4devs`;
|
|
12
14
|
el kit genera las referencias de cada [cliente compatible][clients].
|
|
@@ -33,7 +35,7 @@ Después, abre el proyecto en tu agente y pide:
|
|
|
33
35
|
La [guía de instalación](docs/guides/installation.md) incluye Windows, Node ausente,
|
|
34
36
|
simulación y actualización. Instala y actualiza mediante el
|
|
35
37
|
[paquete npm público][packages];
|
|
36
|
-
la [release v0.0.
|
|
38
|
+
la [release v0.0.6][release] conserva artefactos y checksums para verificarlos.
|
|
37
39
|
No requiere instalación global.
|
|
38
40
|
La CLI guarda el idioma `pt`, `en` o `es` por proyecto.
|
|
39
41
|
|
|
@@ -62,7 +64,14 @@ las herramientas se instalan por separado. Los documentos de producto siguen
|
|
|
62
64
|
las decisiones de planificación. Los proyectos existentes conservan su código.
|
|
63
65
|
Una referencia no demuestra que un cliente haya cargado la skill.
|
|
64
66
|
|
|
65
|
-
|
|
67
|
+
## Licencia y autoría
|
|
68
|
+
|
|
69
|
+
Mantenido por [PathBit](https://www.pathbit.com.br),
|
|
70
|
+
con licencia [MIT](LICENSE).
|
|
71
|
+
La instalación incluye la licencia del kit en `.pbai4devs/LICENSE` y conserva
|
|
72
|
+
la licencia y los archivos propios de tu proyecto.
|
|
73
|
+
|
|
74
|
+
[Changelog](CHANGELOG.md) · [Roadmap](docs/product/roadmap.md)
|
|
66
75
|
|
|
67
76
|
¿Encontraste un problema o tienes una idea? [Abre una issue][issues] con los
|
|
68
77
|
formularios. Consulta [cómo participar](docs/maintainers/community.md).
|
|
@@ -71,8 +80,10 @@ formularios. Consulta [cómo participar](docs/maintainers/community.md).
|
|
|
71
80
|
al agente que lea `AGENTS.md`.
|
|
72
81
|
|
|
73
82
|
[clients]: .pbai4devs/COMPATIBILIDADE.md
|
|
74
|
-
[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.
|
|
83
|
+
[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.6
|
|
75
84
|
[npm-package]: https://www.npmjs.com/package/@pathbit/agentdevkit
|
|
85
|
+
[npm-badge]: https://img.shields.io/npm/v/%40pathbit%2Fagentdevkit
|
|
86
|
+
[license-badge]: https://img.shields.io/badge/license-MIT-blue
|
|
76
87
|
[tests]: docs/guides/tools-and-testing.md
|
|
77
88
|
[cli]: docs/guides/cli.md
|
|
78
89
|
[help]: docs/guides/troubleshooting.md
|
package/README.md
CHANGED
|
@@ -1,18 +1,15 @@
|
|
|
1
|
-
---
|
|
2
|
-
description: Instruções e fluxo de trabalho para agentes de código.
|
|
3
|
-
language: pt
|
|
4
|
-
---
|
|
5
|
-
|
|
6
1
|
# AgentDevKit
|
|
7
2
|
|
|
8
|
-
[English](README.en.md) · [Español](README.es.md) · [Pacote npm][npm-package]
|
|
3
|
+
[English](https://github.com/pathbit/AgentDevKit/blob/master/README.en.md) · [Español](https://github.com/pathbit/AgentDevKit/blob/master/README.es.md) · [Pacote npm][npm-package]
|
|
4
|
+
|
|
5
|
+
[![npm][npm-badge]][npm-package] [![MIT][license-badge]](https://github.com/pathbit/AgentDevKit/blob/master/LICENSE)
|
|
9
6
|
|
|
10
7
|
Uma forma de organizar o trabalho com agentes de código, do planejamento à
|
|
11
8
|
verificação. Você mantém skills, regras, comandos e perfis em `.pbai4devs`;
|
|
12
9
|
o kit gera os apontamentos que cada cliente sabe encontrar.
|
|
13
10
|
|
|
14
11
|
Use com Codex, Claude, Cursor, Copilot, OpenCode e outros
|
|
15
|
-
[clientes compatíveis](.pbai4devs/COMPATIBILIDADE.md). Há uma origem;
|
|
12
|
+
[clientes compatíveis](https://github.com/pathbit/AgentDevKit/blob/master/.pbai4devs/COMPATIBILIDADE.md). Há uma origem;
|
|
16
13
|
cada cliente conserva seu formato de descoberta. No repositório, o código
|
|
17
14
|
fica em `src/`, os testes em `tests/` e os recursos compartilhados em
|
|
18
15
|
`.pbai4devs/`. Pastas nativas, entradas e preferências são geradas localmente.
|
|
@@ -34,8 +31,8 @@ Depois, abra o projeto no seu agente e peça:
|
|
|
34
31
|
> Leia AGENTS.md e use a skill proximos-passos para orientar meu trabalho.
|
|
35
32
|
|
|
36
33
|
Windows, instalação sem Node, simulação e atualização estão no
|
|
37
|
-
[guia de instalação](docs/guides/installation.md). A distribuição usa a
|
|
38
|
-
versão publicada no [npm público][packages] e na [release v0.0.
|
|
34
|
+
[guia de instalação](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/installation.md). A distribuição usa a
|
|
35
|
+
versão publicada no [npm público][packages] e na [release v0.0.6][release],
|
|
39
36
|
sem instalação global. Instalação e atualização usam o pacote do registro;
|
|
40
37
|
os arquivos da release servem para conferir os artefatos publicados.
|
|
41
38
|
O idioma da CLI pode ser `pt`, `en` ou `es`.
|
|
@@ -44,12 +41,12 @@ O idioma da CLI pode ser `pt`, `en` ou `es`.
|
|
|
44
41
|
|
|
45
42
|
| Quero… | Ler |
|
|
46
43
|
| --- | --- |
|
|
47
|
-
| Entender e começar | [Wiki](docs/README.md) |
|
|
48
|
-
| Planejar ou retomar um projeto | [Fluxo de trabalho](docs/guides/workflow.md) |
|
|
49
|
-
| Criar uma skill ou comando | [Recursos](docs/guides/resources.md) |
|
|
44
|
+
| Entender e começar | [Wiki](https://github.com/pathbit/AgentDevKit/blob/master/docs/README.md) |
|
|
45
|
+
| Planejar ou retomar um projeto | [Fluxo de trabalho](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/workflow.md) |
|
|
46
|
+
| Criar uma skill ou comando | [Recursos](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/resources.md) |
|
|
50
47
|
| Instalar ferramentas e comprovar uma entrega | [Ferramentas e testes][tests] |
|
|
51
48
|
| Consultar opções ou resolver um erro | [CLI][cli] · [Soluções][help] |
|
|
52
|
-
| Melhorar o próprio kit | [Contribuir](CONTRIBUTING.md) |
|
|
49
|
+
| Melhorar o próprio kit | [Contribuir](https://github.com/pathbit/AgentDevKit/blob/master/CONTRIBUTING.md) |
|
|
53
50
|
| Experimentar os cenários | [Exemplos](https://github.com/pathbit/AgentDevKit/tree/master/examples) |
|
|
54
51
|
|
|
55
52
|
## Desenvolver este repositório
|
|
@@ -65,25 +62,34 @@ npm run examples
|
|
|
65
62
|
|
|
66
63
|
Os exemplos aparecem em `examples/generated/`. Para testar todos os cenários,
|
|
67
64
|
use `npm run test:examples`; para verificar o pacote, `npm run verify`.
|
|
68
|
-
O [guia de desenvolvimento](docs/maintainers/development.md) explica a árvore
|
|
65
|
+
O [guia de desenvolvimento](https://github.com/pathbit/AgentDevKit/blob/master/docs/maintainers/development.md) explica a árvore
|
|
69
66
|
e os comandos.
|
|
70
67
|
|
|
71
68
|
Instalar o kit prepara instruções. As ferramentas são instaladas por uma ação
|
|
72
69
|
separada; PRD, design e specs surgem quando você inicia o planejamento.
|
|
73
70
|
Projetos existentes preservam seu código e suas decisões.
|
|
74
71
|
|
|
75
|
-
|
|
72
|
+
## Licença e autoria
|
|
73
|
+
|
|
74
|
+
Mantido pela [PathBit](https://www.pathbit.com.br),
|
|
75
|
+
sob a licença [MIT](https://github.com/pathbit/AgentDevKit/blob/master/LICENSE).
|
|
76
|
+
A instalação inclui a licença do kit em `.pbai4devs/LICENSE` e preserva
|
|
77
|
+
a licença e os arquivos próprios do seu projeto.
|
|
78
|
+
|
|
79
|
+
[Changelog](https://github.com/pathbit/AgentDevKit/blob/master/CHANGELOG.md) · [Roadmap](https://github.com/pathbit/AgentDevKit/blob/master/docs/product/roadmap.md)
|
|
76
80
|
|
|
77
81
|
Encontrou um problema ou tem uma ideia? [Abra uma issue][issues] pelos
|
|
78
|
-
[formulários de contribuição](docs/maintainers/community.md).
|
|
82
|
+
[formulários de contribuição](https://github.com/pathbit/AgentDevKit/blob/master/docs/maintainers/community.md).
|
|
79
83
|
|
|
80
|
-
**[ Próximo passo ]** Siga a [instalação](docs/guides/installation.md) e peça
|
|
84
|
+
**[ Próximo passo ]** Siga a [instalação](https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/installation.md) e peça
|
|
81
85
|
ao seu agente para ler `AGENTS.md`.
|
|
82
86
|
|
|
83
|
-
[tests]: docs/guides/tools-and-testing.md
|
|
84
|
-
[cli]: docs/guides/cli.md
|
|
85
|
-
[help]: docs/guides/troubleshooting.md
|
|
87
|
+
[tests]: https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/tools-and-testing.md
|
|
88
|
+
[cli]: https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/cli.md
|
|
89
|
+
[help]: https://github.com/pathbit/AgentDevKit/blob/master/docs/guides/troubleshooting.md
|
|
86
90
|
[issues]: https://github.com/pathbit/AgentDevKit/issues/new/choose
|
|
87
|
-
[packages]: docs/maintainers/packages.md
|
|
88
|
-
[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.
|
|
91
|
+
[packages]: https://github.com/pathbit/AgentDevKit/blob/master/docs/maintainers/packages.md
|
|
92
|
+
[release]: https://github.com/pathbit/AgentDevKit/releases/tag/v0.0.6
|
|
89
93
|
[npm-package]: https://www.npmjs.com/package/@pathbit/agentdevkit
|
|
94
|
+
[npm-badge]: https://img.shields.io/npm/v/%40pathbit%2Fagentdevkit
|
|
95
|
+
[license-badge]: https://img.shields.io/badge/license-MIT-blue
|
|
@@ -44,10 +44,13 @@ Sem escolha explícita ou salva, `all` mantém todos os clientes compatíveis.
|
|
|
44
44
|
| Índices, manifesto e seleção pessoal | Derivados locais ignorados. |
|
|
45
45
|
| Código, documentos e configurações humanas | Preservados. |
|
|
46
46
|
| Downloads e resultados de testes | Locais e ignorados. |
|
|
47
|
+
| `.pbai4devs/LICENSE` | Licença MIT do kit, copiada do pacote. |
|
|
47
48
|
|
|
48
49
|
O gerador completo permanece no pacote npm. Ele não copia `bin/`, `src/`,
|
|
49
50
|
`scripts/release/` ou os testes do produto para o projeto atendido.
|
|
50
51
|
Instalar o kit não inicia uma aplicação nem instala todas as ferramentas.
|
|
52
|
+
A licença existente na raiz do projeto não é substituída. A cópia do hub
|
|
53
|
+
identifica a licença dos recursos do AgentDevKit, sem redefinir a do projeto.
|
|
51
54
|
|
|
52
55
|
## Git e migração
|
|
53
56
|
|
|
@@ -69,10 +72,15 @@ continua válida; `agents` consulta e `agents codex,claude` altera a seleção.
|
|
|
69
72
|
`agents all` habilita todos. As pastas compartilhadas permanecem quando
|
|
70
73
|
necessárias para outro cliente, como `.agents` para Codex e Antigravity.
|
|
71
74
|
|
|
75
|
+
Confira a simulação antes de atualizar um projeto existente. Arquivos
|
|
76
|
+
gerenciados alterados geram conflito; use `--force` somente após revisar o
|
|
77
|
+
backup e o conteúdo que será substituído. Preserve os dados locais, as
|
|
78
|
+
configurações próprias e os commits do projeto.
|
|
79
|
+
|
|
72
80
|
O [fluxo de trabalho](workflow.md) orienta a próxima etapa do projeto.
|
|
73
81
|
Se houver erro, consulte [solução de problemas](troubleshooting.md).
|
|
74
82
|
|
|
75
|
-
[Wiki](../README.md) · [
|
|
83
|
+
[Wiki](../README.md) · [Spec v0.0.6][spec]
|
|
76
84
|
|
|
77
85
|
[bootstrap]: ../../.pbai4devs/scripts/preparar-ferramentas/BOOTSTRAP.md
|
|
78
|
-
[
|
|
86
|
+
[spec]: ../specs/v0.0.6/SPEC.md
|
|
@@ -8,6 +8,13 @@ O AgentDevKit é um único pacote: [`@pathbit/agentdevkit`][package]. Ele conté
|
|
|
8
8
|
a CLI e os recursos compartilhados; a instalação prepara os apontamentos dos
|
|
9
9
|
agentes escolhidos no projeto.
|
|
10
10
|
|
|
11
|
+
Os metadados identificam PathBit como autor, palavras-chave do kit e licença
|
|
12
|
+
MIT. O README público é gerado sem frontmatter e com links absolutos do GitHub;
|
|
13
|
+
a fonte versionada conserva o YAML. O `LICENSE` canônico acompanha o pacote e
|
|
14
|
+
é instalado em `.pbai4devs/LICENSE`, sem alterar a licença do consumidor.
|
|
15
|
+
Ferramentas de terceiros baixadas à parte mantêm suas próprias licenças e
|
|
16
|
+
não integram o TGZ do AgentDevKit.
|
|
17
|
+
|
|
11
18
|
## Instalar no projeto
|
|
12
19
|
|
|
13
20
|
Com Node.js 18+ e npm, execute na pasta do projeto. Não é necessário login:
|
|
@@ -16,7 +23,7 @@ Com Node.js 18+ e npm, execute na pasta do projeto. Não é necessário login:
|
|
|
16
23
|
npx @pathbit/agentdevkit init
|
|
17
24
|
```
|
|
18
25
|
|
|
19
|
-
Para
|
|
26
|
+
Para repetir uma instalação, fixe a versão desejada após o nome do pacote.
|
|
20
27
|
|
|
21
28
|
Acrescente `--agents codex,claude` para selecionar clientes, `--dry-run` para
|
|
22
29
|
simular ou use `update`, `doctor` e `sync --check` no lugar de `init`.
|
|
@@ -57,13 +64,17 @@ existir; a primeira publicação pode usar o secret `NPMJS_TOKEN`.
|
|
|
57
64
|
Para publicar somente o pacote de uma tag que já tem artefato aprovado:
|
|
58
65
|
|
|
59
66
|
```console
|
|
60
|
-
gh workflow run release.yml --ref master -f tag=v0.0.
|
|
67
|
+
gh workflow run release.yml --ref master -f tag=v0.0.6 -F package_only=true
|
|
61
68
|
```
|
|
62
69
|
|
|
63
70
|
Se o artefato expirou, reexecute o CI original da tag antes da publicação.
|
|
64
71
|
Depois do envio, o job usa um ambiente sem credenciais e cache novo para
|
|
65
72
|
executar `--version`, `init`, `doctor` e `sync --check` pelo nome e versão
|
|
66
73
|
publicados. Assim, a verificação comprova o acesso de um usuário comum.
|
|
74
|
+
Confirme também que `latest` aponta para a versão estável e que o tarball é
|
|
75
|
+
baixável; metadados visíveis sozinhos não comprovam uma instalação funcional.
|
|
76
|
+
Se o registro ainda não disponibilizar o pacote, aguarde a verificação sem
|
|
77
|
+
republicar automaticamente a mesma versão.
|
|
67
78
|
|
|
68
79
|
As versões antigas no [GitHub Packages][legacy] permanecem disponíveis;
|
|
69
80
|
o canal de instalação padrão é o npm público.
|
package/docs/product/design.md
CHANGED
|
@@ -39,6 +39,11 @@ as automações de release ou os testes exclusivos do produto. Os layouts dos
|
|
|
39
39
|
clientes vêm da [configuração declarativa][clients]. Os arquivos nativos são
|
|
40
40
|
pequenos apontamentos para o hub, sem symlinks.
|
|
41
41
|
|
|
42
|
+
O `LICENSE` da raiz do pacote é a fonte canônica da licença MIT do kit.
|
|
43
|
+
`init` e `update` copiam seus bytes para `.pbai4devs/LICENSE`; a licença da raiz
|
|
44
|
+
do projeto consumidor permanece intacta. Alterações na licença gerenciada
|
|
45
|
+
seguem a mesma proteção de conflitos e backup dos demais arquivos do hub.
|
|
46
|
+
|
|
42
47
|
A escolha salva determina as derivações. Atualizações e sincronizações não
|
|
43
48
|
reativam clientes desmarcados. `all` preserva a intenção de usar todos; estados
|
|
44
49
|
antigos sem escolha explícita mantêm esse comportamento.
|
|
@@ -74,6 +79,11 @@ O CI separa a suíte completa dos testes de portabilidade. A publicação usa um
|
|
|
74
79
|
artifact aprovado do mesmo commit e verifica versão, origem e checksum.
|
|
75
80
|
Não há novo empacotamento entre teste e publicação.
|
|
76
81
|
|
|
82
|
+
Antes de empacotar, o estágio de distribuição deriva o README público da
|
|
83
|
+
fonte: remove o frontmatter YAML e resolve links locais para URLs absolutas
|
|
84
|
+
do GitHub. O README versionado mantém seu YAML e seus links de trabalho.
|
|
85
|
+
O pacote identifica PathBit como autor, inclui palavras-chave e declara MIT.
|
|
86
|
+
|
|
77
87
|
O npm público recebe o mesmo tarball da release, como `@pathbit/agentdevkit`.
|
|
78
88
|
O workflow prioriza o secret `NPMJS_TOKEN` do repositório, recebido pela
|
|
79
89
|
variável interna `NPM_TOKEN`; sem token, usa OIDC. Confirma a integridade da
|
package/docs/product/prd.md
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
description: Requisitos da distribuição portátil AgentDevKit.
|
|
3
3
|
status: aprovado
|
|
4
|
-
version: 0.0.
|
|
4
|
+
version: 0.0.6
|
|
5
5
|
---
|
|
6
6
|
|
|
7
7
|
# PRD do AgentDevKit
|
|
@@ -37,6 +37,9 @@ extraído do projeto de origem como produto independente.
|
|
|
37
37
|
| FR-015 | Publicar no npm público, instalável via npx sem autenticação. |
|
|
38
38
|
| FR-016 | Organizar código e testes em `src/` e `tests/`, na raiz. |
|
|
39
39
|
| FR-017 | Gerar exemplos isolados e acessíveis por comandos documentados. |
|
|
40
|
+
| FR-018 | Publicar autoria PathBit, palavras-chave e licença MIT no npm. |
|
|
41
|
+
| FR-019 | Exibir README legível no npm sem alterar o Markdown fonte. |
|
|
42
|
+
| FR-020 | Levar a licença do kit ao hub sem alterar a licença do projeto. |
|
|
40
43
|
|
|
41
44
|
Execuções repetidas devem ser idempotentes; a CLI oferece simulação e JSON.
|
|
42
45
|
As instruções permanecem concisas, com detalhes opcionais em referências.
|
|
@@ -54,6 +57,8 @@ A entrega exige testes de projeto vazio e existente, preservação de arquivos,
|
|
|
54
57
|
atualização, idiomas, catálogos e distribuição sem artefatos locais.
|
|
55
58
|
Os aceites da distribuição ficam na [spec inicial](../specs/v0.0.1/SPEC.md);
|
|
56
59
|
a [spec de seleção](../specs/v0.0.2/SPEC.md) detalha a instalação por agente.
|
|
60
|
+
A [spec v0.0.6](../specs/v0.0.6/SPEC.md) trata a apresentação pública, a licença
|
|
61
|
+
distribuída e a atualização verificada do projeto de origem.
|
|
57
62
|
|
|
58
63
|
## Autorização
|
|
59
64
|
|
|
@@ -61,4 +66,5 @@ Escopo autorizado pela solicitação explícita de criação do AgentDevKit.
|
|
|
61
66
|
Este estado registra requisitos aceitos; testes e publicação têm validação
|
|
62
67
|
própria e não são considerados concluídos por esta aprovação.
|
|
63
68
|
|
|
64
|
-
[Wiki](../README.md) · [Design](design.md) ·
|
|
69
|
+
[Wiki](../README.md) · [Design](design.md) ·
|
|
70
|
+
[Fluxo de uso](../guides/workflow.md)
|
package/docs/product/roadmap.md
CHANGED
|
@@ -13,11 +13,12 @@ status: vigente
|
|
|
13
13
|
| Release v0.0.1 | Aceites e revisão | Pacote versionado e changelog. |
|
|
14
14
|
| Seleção de agentes v0.0.2 | CLI e adaptadores | [Spec][selection]. |
|
|
15
15
|
| Fontes e geração local v0.0.3 | Seleção e distribuição | [Spec][source]. |
|
|
16
|
-
| Pacote
|
|
16
|
+
| Pacote no GitHub Packages | Artefato aprovado | [Spec][packages]. |
|
|
17
17
|
| Estrutura e exemplos v0.0.4 | CLI, distribuição e gerador | [Spec][layout]. |
|
|
18
18
|
| Instalação pelo registro v0.0.5 | Pacote publicado | [Spec][registry]. |
|
|
19
|
+
| Apresentação e licença v0.0.6 | Distribuição e atualização | [Spec][public]. |
|
|
19
20
|
|
|
20
|
-
A primeira entrega segue a [spec v0.0.1](../specs/v0.0.1/SPEC.md)
|
|
21
|
+
A primeira entrega segue a [spec v0.0.1](../specs/v0.0.1/SPEC.md), disponível
|
|
21
22
|
na [release v0.0.1][release]. Os detalhes de mudanças estão no
|
|
22
23
|
[changelog](../../CHANGELOG.md), e o processo de publicação em
|
|
23
24
|
[manutenção](../maintainers/maintenance.md).
|
|
@@ -34,3 +35,4 @@ comportamento existente, sem alterar a versão de uma release já publicada.
|
|
|
34
35
|
[packages]: ../specs/github-packages/SPEC.md
|
|
35
36
|
[layout]: ../specs/v0.0.4/SPEC.md
|
|
36
37
|
[registry]: ../specs/v0.0.5/SPEC.md
|
|
38
|
+
[public]: ../specs/v0.0.6/SPEC.md
|
package/docs/specs/README.md
CHANGED
|
@@ -10,6 +10,7 @@ description: Incrementos verificáveis do AgentDevKit.
|
|
|
10
10
|
- [GitHub Packages](github-packages/SPEC.md): pacote npm instalável via npx.
|
|
11
11
|
- [v0.0.4](v0.0.4/SPEC.md): estrutura padrão e exemplos na raiz.
|
|
12
12
|
- [v0.0.5](v0.0.5/SPEC.md): instalação pelo registro em todos os fluxos.
|
|
13
|
+
- [v0.0.6](v0.0.6/SPEC.md): apresentação pública, licença e atualização segura.
|
|
13
14
|
|
|
14
15
|
Cada incremento vincula requisitos, critérios, testes e evidências locais.
|
|
15
16
|
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Apresentação pública e licença distribuída do AgentDevKit.
|
|
3
|
+
---
|
|
4
|
+
|
|
5
|
+
# Versão 0.0.6
|
|
6
|
+
|
|
7
|
+
A [spec](SPEC.md) define metadados, README e licença do pacote, consumo
|
|
8
|
+
anônimo da versão estável e atualização segura do projeto de origem.
|
|
9
|
+
|
|
10
|
+
[Specs](../README.md)
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
---
|
|
2
|
+
description: Apresentação pública, licença e atualização verificada do kit.
|
|
3
|
+
status: aprovado
|
|
4
|
+
version: 0.0.6
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
# Apresentação pública e licença
|
|
8
|
+
|
|
9
|
+
## Objetivo e autorização
|
|
10
|
+
|
|
11
|
+
Publicar uma versão estável do AgentDevKit com identificação clara no npm,
|
|
12
|
+
README legível e licença incluída no hub instalado. Depois da publicação,
|
|
13
|
+
atualizar o `talquee-ai-router` preservando seus arquivos e dados.
|
|
14
|
+
|
|
15
|
+
Escopo autorizado pela solicitação do usuário. A aprovação permite executar
|
|
16
|
+
o trabalho; testes, publicação e atualização exigem suas próprias provas.
|
|
17
|
+
Dependências: [PRD](../../product/prd.md), [design](../../product/design.md) e
|
|
18
|
+
[instalação pelo registro](../v0.0.5/SPEC.md).
|
|
19
|
+
|
|
20
|
+
## Contrato
|
|
21
|
+
|
|
22
|
+
- Declarar autor PathBit, palavras-chave relevantes e licença MIT no pacote.
|
|
23
|
+
- Derivar o README publicado da fonte sem alterar o arquivo versionado:
|
|
24
|
+
remover YAML e converter links locais para URLs absolutas do GitHub.
|
|
25
|
+
- Usar o `LICENSE` da raiz do pacote como fonte de `.pbai4devs/LICENSE`.
|
|
26
|
+
Preservar a licença da raiz do consumidor e proteger conflitos no hub.
|
|
27
|
+
- Manter Node 18+ no launcher e Node 24+ no núcleo; isolar credenciais e cache
|
|
28
|
+
nas provas de consumo público, sem instalar ferramentas implicitamente.
|
|
29
|
+
- Confirmar `latest`, integridade e download antes das provas anônimas.
|
|
30
|
+
- Simular a atualização do router, conferir propriedade e preservar dados,
|
|
31
|
+
configurações, ferramentas locais e commits humanos existentes.
|
|
32
|
+
|
|
33
|
+
Não criar documentos de produto no router, redefinir sua licença nem alterar
|
|
34
|
+
versões publicadas. A entrega não promete ausência total de bugs.
|
|
35
|
+
|
|
36
|
+
## Critérios de aceite
|
|
37
|
+
|
|
38
|
+
| ID | Resultado observável |
|
|
39
|
+
| --- | --- |
|
|
40
|
+
| AC-001 | Pacote identifica PathBit, palavras-chave e licença MIT. |
|
|
41
|
+
| AC-002 | README do TGZ não tem YAML; links locais tornam-se absolutos. |
|
|
42
|
+
| AC-003 | Hub recebe a licença canônica sem alterar a do consumidor. |
|
|
43
|
+
| AC-004 | Runtime e consumo público mantêm os contratos de ambiente. |
|
|
44
|
+
| AC-005 | Versão estável em `latest` instala e opera sem autenticação. |
|
|
45
|
+
| AC-006 | Router atualizado preserva arquivos, dados e commits anteriores. |
|
|
46
|
+
|
|
47
|
+
## Plano de verificação
|
|
48
|
+
|
|
49
|
+
Resultados ficam em `.agent-tests/public-package/`, separados desta spec.
|
|
50
|
+
O código dos testes é versionado. Cada prova registra comando, versão,
|
|
51
|
+
pré-requisitos, assertiva e caminho da evidência no relatório de revisão.
|
|
52
|
+
|
|
53
|
+
- **AC-001:** inspecionar o `package.json` do TGZ exato e os metadados do npm;
|
|
54
|
+
comparar autoria, palavras-chave, MIT e versão com a fonte aprovada.
|
|
55
|
+
- **AC-002:** testar empacotamento e extrair o TGZ; verificar a primeira linha,
|
|
56
|
+
links de arquivos/imagens e preservação dos bytes do README fonte.
|
|
57
|
+
- **AC-003:** executar testes de instalação e distribuição em projetos novos
|
|
58
|
+
e existentes; comparar as licenças, testar conflito, backup e diagnóstico.
|
|
59
|
+
- **AC-004:** executar testes do launcher, publicação e distribuição; provar
|
|
60
|
+
compatibilidade de runtime, cache isolado e ausência de tokens no consumidor.
|
|
61
|
+
- **AC-005:** publicar o artefato aprovado; consultar `latest` e baixar;
|
|
62
|
+
executar `--version`, `init`, `doctor` e `sync --check` em destino e cache
|
|
63
|
+
novos.
|
|
64
|
+
- **AC-006:** salvar hashes e estado Git do router, revisar `--dry-run`, aplicar
|
|
65
|
+
a versão fixada e repetir diagnóstico/sincronização; comparar arquivos
|
|
66
|
+
próprios, oito recibos de ferramentas e histórico com o estado anterior.
|
|
67
|
+
|
|
68
|
+
A revisão independente confere o relatório e os achados antes da conclusão.
|
|
69
|
+
Esta mudança exige terminal e registro npm; não altera interface web/desktop.
|
|
70
|
+
|
|
71
|
+
## Documentação afetada
|
|
72
|
+
|
|
73
|
+
Atualizar README público, guias de instalação/publicação, PRD, design, roadmap,
|
|
74
|
+
índice de specs, changelog e descrição da licença no hub. Revisar somente os
|
|
75
|
+
trechos do README do router afetados pela atualização, preservando seu contexto.
|
|
76
|
+
|
|
77
|
+
[Specs](../README.md) · [Pacote npm](../../maintainers/packages.md)
|
package/package.json
CHANGED
|
@@ -1,12 +1,13 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@pathbit/agentdevkit",
|
|
3
|
-
"version": "0.0.
|
|
4
|
-
"description": "
|
|
3
|
+
"version": "0.0.6",
|
|
4
|
+
"description": "Shared skills, specifications and workflows for AI coding agents.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"publishConfig": {
|
|
8
8
|
"registry": "https://registry.npmjs.org",
|
|
9
|
-
"access": "public"
|
|
9
|
+
"access": "public",
|
|
10
|
+
"tag": "latest"
|
|
10
11
|
},
|
|
11
12
|
"repository": {
|
|
12
13
|
"type": "git",
|
|
@@ -50,5 +51,19 @@
|
|
|
50
51
|
"ci:full": "node scripts/release/pipeline.mjs full",
|
|
51
52
|
"ci:portable": "node scripts/release/pipeline.mjs portable",
|
|
52
53
|
"ci:smoke": "node scripts/release/pipeline.mjs smoke"
|
|
53
|
-
}
|
|
54
|
+
},
|
|
55
|
+
"author": {
|
|
56
|
+
"name": "PathBit",
|
|
57
|
+
"url": "https://www.pathbit.com.br"
|
|
58
|
+
},
|
|
59
|
+
"keywords": [
|
|
60
|
+
"ai",
|
|
61
|
+
"coding-agents",
|
|
62
|
+
"agent-skills",
|
|
63
|
+
"spec-driven-development",
|
|
64
|
+
"developer-tools",
|
|
65
|
+
"codex",
|
|
66
|
+
"claude-code",
|
|
67
|
+
"github-copilot"
|
|
68
|
+
]
|
|
54
69
|
}
|
package/src/install.mjs
CHANGED
|
@@ -52,7 +52,7 @@ export function safePath(root, path) {
|
|
|
52
52
|
function resourceAllowed(path, directory = false) {
|
|
53
53
|
const parts = path.split('/');
|
|
54
54
|
const folders = new Set(['agents', 'commands', 'external-skills', 'rules', 'scripts', 'skills', 'templates', 'tools', 'estado']);
|
|
55
|
-
const files = new Set(['README.md', 'INSTRUCTIONS.md', 'COMPATIBILIDADE.md', '.gitignore']);
|
|
55
|
+
const files = new Set(['README.md', 'INSTRUCTIONS.md', 'COMPATIBILIDADE.md', 'LICENSE', '.gitignore']);
|
|
56
56
|
if (!folders.has(parts[0]) && !(parts.length === 1 && files.has(parts[0]))) return false;
|
|
57
57
|
if (parts[0] === 'estado') return directory && parts.length === 1 || path === 'estado/README.md';
|
|
58
58
|
if (isGeneratedOutput(path, directory) || parts.some(part => ignored.has(part)) || parts[0] === 'adapters' || path === 'estado/agentdevkit.json' || path === '.npmignore') return false;
|
|
@@ -178,6 +178,12 @@ export function planInstallation({ target, language = 'pt', mode = 'init', force
|
|
|
178
178
|
try {
|
|
179
179
|
const existing = copyResources(join(target, '.pbai4devs'), join(stage, '.pbai4devs'));
|
|
180
180
|
const bundled = mode === 'init' || mode === 'update' ? copyResources(join(packageRoot, '.pbai4devs'), join(stage, '.pbai4devs')) : [];
|
|
181
|
+
if (mode === 'init' || mode === 'update') {
|
|
182
|
+
const license = read(packageRoot, 'LICENSE');
|
|
183
|
+
if (!license?.length) fail('E_LICENSE', 'The AgentDevKit package is missing its LICENSE.');
|
|
184
|
+
write(stage, '.pbai4devs/LICENSE', license);
|
|
185
|
+
bundled.push('LICENSE');
|
|
186
|
+
}
|
|
181
187
|
const supplied = new Set(bundled);
|
|
182
188
|
const internal = new Set(['catalog.json', 'skills.json', 'agents.json', 'rules.json', 'espelhos.conf', '.gitignore', 'estado/README.md']);
|
|
183
189
|
if (bundled.length) for (const path of Object.keys(previous?.files || {})) {
|