@rafael_nicoleti/jatai 0.0.0-stage → 1.2.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/LICENSE +21 -0
- package/README.md +232 -2
- package/THIRD_PARTY_NOTICES.md +5907 -0
- package/jatai.cjs +7061 -0
- package/kit/brownfield-templates/AGENTS.md +421 -0
- package/kit/brownfield-templates/agents/discovery/arch-discoverer.agent.md +514 -0
- package/kit/brownfield-templates/agents/discovery/assessor.agent.md +1357 -0
- package/kit/brownfield-templates/agents/discovery/business-archeologist.agent.md +226 -0
- package/kit/brownfield-templates/agents/discovery/coding-archaeologist.agent.md +394 -0
- package/kit/brownfield-templates/agents/discovery/debt-analyst.agent.md +97 -0
- package/kit/brownfield-templates/agents/discovery/dependency-mapper.agent.md +223 -0
- package/kit/brownfield-templates/agents/discovery/design-archaeologist.agent.md +213 -0
- package/kit/brownfield-templates/agents/discovery/domain-extractor.agent.md +402 -0
- package/kit/brownfield-templates/agents/discovery/maturity-assessor.agent.md +142 -0
- package/kit/brownfield-templates/agents/discovery/quality-auditor.agent.md +96 -0
- package/kit/brownfield-templates/agents/discovery/security-auditor.agent.md +92 -0
- package/kit/brownfield-templates/agents/discovery/tech-mapper.agent.md +125 -0
- package/kit/brownfield-templates/agents/discovery/test-coverage-mapper.agent.md +92 -0
- package/kit/brownfield-templates/agents/execution/feature-adder.agent.md +143 -0
- package/kit/brownfield-templates/agents/execution/migration-agent.agent.md +99 -0
- package/kit/brownfield-templates/agents/execution/refactor-agent.agent.md +104 -0
- package/kit/brownfield-templates/agents/execution/test-backfill-agent.agent.md +91 -0
- package/kit/brownfield-templates/agents/maestro.agent.md +209 -0
- package/kit/brownfield-templates/agents/operation/devops.agent.md +75 -0
- package/kit/brownfield-templates/agents/operation/incident.agent.md +89 -0
- package/kit/brownfield-templates/agents/operation/observability.agent.md +65 -0
- package/kit/brownfield-templates/agents/operation/sustain.agent.md +67 -0
- package/kit/brownfield-templates/agents/planning/adr-recorder.agent.md +77 -0
- package/kit/brownfield-templates/agents/planning/modernization-planner.agent.md +214 -0
- package/kit/brownfield-templates/agents/planning/risk-prioritizer.agent.md +68 -0
- package/kit/brownfield-templates/chatmodes/maestro.chatmode.md +134 -0
- package/kit/brownfield-templates/claude-instructions.md +81 -0
- package/kit/brownfield-templates/copilot-instructions.md +85 -0
- package/kit/brownfield-templates/opencode-instructions.md +110 -0
- package/kit/brownfield-templates/skills/arch-clean-frontend/SKILL.md +209 -0
- package/kit/brownfield-templates/skills/arch-ddd-tactical/SKILL.md +289 -0
- package/kit/brownfield-templates/skills/arch-diagrams-drawio/SKILL.md +338 -0
- package/kit/brownfield-templates/skills/arch-diagrams-likec4/SKILL.md +223 -0
- package/kit/brownfield-templates/skills/arch-feature-based/SKILL.md +234 -0
- package/kit/brownfield-templates/skills/arch-hexagonal/SKILL.md +219 -0
- package/kit/brownfield-templates/skills/arch-layered/SKILL.md +234 -0
- package/kit/brownfield-templates/skills/arch-mvc/SKILL.md +221 -0
- package/kit/brownfield-templates/skills/arch-mvvm/SKILL.md +244 -0
- package/kit/brownfield-templates/skills/arch-pattern-detection/SKILL.md +113 -0
- package/kit/brownfield-templates/skills/arch-vertical-slice/SKILL.md +180 -0
- package/kit/brownfield-templates/skills/bdd-gherkin/SKILL.md +317 -0
- package/kit/brownfield-templates/skills/characterization-testing/SKILL.md +111 -0
- package/kit/brownfield-templates/skills/code-quality-audit/SKILL.md +120 -0
- package/kit/brownfield-templates/skills/codebase-enrichment/SKILL.md +160 -0
- package/kit/brownfield-templates/skills/coding-guidelines/SKILL.md +462 -0
- package/kit/brownfield-templates/skills/commit-assistant/SKILL.md +226 -0
- package/kit/brownfield-templates/skills/docs-writer/SKILL.md +268 -0
- package/kit/brownfield-templates/skills/domain-driven-design/SKILL.md +225 -0
- package/kit/brownfield-templates/skills/domain-extraction-from-code/SKILL.md +118 -0
- package/kit/brownfield-templates/skills/integration-testing/SKILL.md +165 -0
- package/kit/brownfield-templates/skills/legacy-modernization-patterns/SKILL.md +143 -0
- package/kit/brownfield-templates/skills/maturity-bsimm/SKILL.md +146 -0
- package/kit/brownfield-templates/skills/maturity-cmmi/SKILL.md +138 -0
- package/kit/brownfield-templates/skills/maturity-dora-4keys/SKILL.md +101 -0
- package/kit/brownfield-templates/skills/maturity-dora-capabilities/SKILL.md +133 -0
- package/kit/brownfield-templates/skills/maturity-iso-25010/SKILL.md +110 -0
- package/kit/brownfield-templates/skills/maturity-owasp-asvs/SKILL.md +116 -0
- package/kit/brownfield-templates/skills/maturity-owasp-samm/SKILL.md +112 -0
- package/kit/brownfield-templates/skills/maturity-space-devex/SKILL.md +147 -0
- package/kit/brownfield-templates/skills/maturity-spotify-health/SKILL.md +104 -0
- package/kit/brownfield-templates/skills/maturity-tech-radar/SKILL.md +118 -0
- package/kit/brownfield-templates/skills/qa-strategy/SKILL.md +116 -0
- package/kit/brownfield-templates/skills/safe-refactoring-recipes/SKILL.md +149 -0
- package/kit/brownfield-templates/skills/security-best-practices/SKILL.md +176 -0
- package/kit/brownfield-templates/skills/security-cve-checker/SKILL.md +183 -0
- package/kit/brownfield-templates/skills/task-manager/SKILL.md +292 -0
- package/kit/brownfield-templates/skills/tech-debt-mapping/SKILL.md +123 -0
- package/kit/brownfield-templates/skills/tech-stack-detection/SKILL.md +82 -0
- package/kit/brownfield-templates/skills/ui-ux-design-system/SKILL.md +317 -0
- package/kit/brownfield-templates/skills/ux-prototyping/SKILL.md +346 -0
- package/kit/brownfield-templates/skills/version-migration-playbook/SKILL.md +162 -0
- package/kit/brownfield-templates/skills/workflow-memory/SKILL.md +261 -0
- package/kit/templates/agents/downstream/backend-dotnet.agent.md +70 -0
- package/kit/templates/agents/downstream/backend-java.agent.md +72 -0
- package/kit/templates/agents/downstream/backend-python-agentic.agent.md +73 -0
- package/kit/templates/agents/downstream/backend-python-api.agent.md +81 -0
- package/kit/templates/agents/downstream/frontend-android.agent.md +62 -0
- package/kit/templates/agents/downstream/frontend-flutter.agent.md +62 -0
- package/kit/templates/agents/downstream/frontend-ios.agent.md +61 -0
- package/kit/templates/agents/downstream/frontend-react.agent.md +76 -0
- package/kit/templates/agents/downstream/reviewer.agent.md +132 -0
- package/kit/templates/agents/downstream/sprint-runner.agent.md +202 -0
- package/kit/templates/agents/guardian/arch-cross.agent.md +50 -0
- package/kit/templates/agents/guardian/stream-align.agent.md +45 -0
- package/kit/templates/agents/maestro.agent.md +303 -0
- package/kit/templates/agents/operation/devops.agent.md +51 -0
- package/kit/templates/agents/operation/incident.agent.md +49 -0
- package/kit/templates/agents/operation/observability.agent.md +49 -0
- package/kit/templates/agents/operation/release.agent.md +49 -0
- package/kit/templates/agents/operation/sustain.agent.md +47 -0
- package/kit/templates/agents/sidecar/docs.agent.md +26 -0
- package/kit/templates/agents/sidecar/integration-tests.agent.md +30 -0
- package/kit/templates/agents/sidecar/qa-tester.agent.md +28 -0
- package/kit/templates/agents/sidecar/quality.agent.md +26 -0
- package/kit/templates/agents/sidecar/security.agent.md +29 -0
- package/kit/templates/agents/upstream/architecture.agent.md +395 -0
- package/kit/templates/agents/upstream/bdd.agent.md +97 -0
- package/kit/templates/agents/upstream/business.agent.md +122 -0
- package/kit/templates/agents/upstream/domain-modeler.agent.md +136 -0
- package/kit/templates/agents/upstream/product.agent.md +119 -0
- package/kit/templates/agents/upstream/sprint-planner.agent.md +98 -0
- package/kit/templates/agents/upstream/ux-designer.agent.md +245 -0
- package/kit/templates/chatmodes/maestro.chatmode.md +143 -0
- package/kit/templates/docs/adr/0001-arquitetura-referencia-clean-hexagonal.md +52 -0
- package/kit/templates/docs/adr/README.md +34 -0
- package/kit/templates/docs/delivery-flow.md +160 -0
- package/kit/templates/docs/hierarchy.md +112 -0
- package/kit/templates/docs/routing-rules.md +116 -0
- package/kit/templates/features/support/README.md +94 -0
- package/kit/templates/scripts/jatai-mcp.cjs +30236 -0
- package/kit/templates/scripts/jatai-state.cjs +17076 -0
- package/kit/templates/skills/README.md +36 -0
- package/kit/templates/skills/ai-agent-author/SKILL.md +177 -0
- package/kit/templates/skills/arch-clean-frontend/SKILL.md +209 -0
- package/kit/templates/skills/arch-ddd-tactical/SKILL.md +289 -0
- package/kit/templates/skills/arch-diagrams-drawio/SKILL.md +338 -0
- package/kit/templates/skills/arch-feature-based/SKILL.md +234 -0
- package/kit/templates/skills/arch-hexagonal/SKILL.md +219 -0
- package/kit/templates/skills/arch-layered/SKILL.md +234 -0
- package/kit/templates/skills/arch-mvc/SKILL.md +221 -0
- package/kit/templates/skills/arch-mvvm/SKILL.md +244 -0
- package/kit/templates/skills/arch-vertical-slice/SKILL.md +180 -0
- package/kit/templates/skills/bdd-gherkin/SKILL.md +317 -0
- package/kit/templates/skills/codebase-enrichment/SKILL.md +160 -0
- package/kit/templates/skills/coding-guidelines/SKILL.md +462 -0
- package/kit/templates/skills/commit-assistant/SKILL.md +226 -0
- package/kit/templates/skills/docs-writer/SKILL.md +268 -0
- package/kit/templates/skills/domain-driven-design/SKILL.md +225 -0
- package/kit/templates/skills/integration-testing/SKILL.md +165 -0
- package/kit/templates/skills/lang-android/SKILL.md +270 -0
- package/kit/templates/skills/lang-dotnet/SKILL.md +278 -0
- package/kit/templates/skills/lang-flutter/SKILL.md +268 -0
- package/kit/templates/skills/lang-ios/SKILL.md +285 -0
- package/kit/templates/skills/lang-java-spring/SKILL.md +291 -0
- package/kit/templates/skills/lang-python-agentic/SKILL.md +244 -0
- package/kit/templates/skills/lang-python-api/SKILL.md +289 -0
- package/kit/templates/skills/lang-react/SKILL.md +262 -0
- package/kit/templates/skills/openapi-governance/SKILL.md +471 -0
- package/kit/templates/skills/pipeline-adapter/SKILL.md +330 -0
- package/kit/templates/skills/qa-strategy/SKILL.md +116 -0
- package/kit/templates/skills/registry.yaml +560 -0
- package/kit/templates/skills/security-best-practices/SKILL.md +176 -0
- package/kit/templates/skills/security-cve-checker/SKILL.md +183 -0
- package/kit/templates/skills/task-manager/SKILL.md +292 -0
- package/kit/templates/skills/ui-ux-design-system/SKILL.md +317 -0
- package/kit/templates/skills/ux-prototyping/SKILL.md +346 -0
- package/kit/templates/skills/workflow-memory/SKILL.md +261 -0
- package/kit/templates/skills/workspace-tools/SKILL.md +237 -0
- package/package.json +37 -4
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Rafael Nicoleti
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
CHANGED
|
@@ -1,3 +1,233 @@
|
|
|
1
|
-
#
|
|
1
|
+
# CLI do Jataí
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
A CLI headless instala e mantém o kit de agentes da Jataí em um projeto que já
|
|
4
|
+
existe, sem precisar abrir o VS Code. É a mesma estrutura que o Wizard instala:
|
|
5
|
+
os mesmos agentes, skills, `AGENTS.md`, comando de entrada, MCP e
|
|
6
|
+
`.github/kit.lock.json` — porque usa o mesmo `KitInstaller` da extensão.
|
|
7
|
+
|
|
8
|
+
> A CLI é uma frente de **instalação e manutenção**. O Cockpit, o mapa e o
|
|
9
|
+
> Wizard continuam na extensão do VS Code. A CLI não abre uma interface gráfica.
|
|
10
|
+
|
|
11
|
+
## Requisitos
|
|
12
|
+
|
|
13
|
+
- **Node.js 20+**.
|
|
14
|
+
- Um projeto existente (brownfield) ou uma pasta de workspace. O CLI do MVP
|
|
15
|
+
instala em projeto existente; para criar um projeto novo, use o Wizard.
|
|
16
|
+
- A extensão do VS Code aberta no workspace é necessária para o Cockpit e para
|
|
17
|
+
o State Service local. O CLI e o `jatai-state` funcionam sem a extensão; o
|
|
18
|
+
MCP precisa do State Service.
|
|
19
|
+
|
|
20
|
+
## Instalação
|
|
21
|
+
|
|
22
|
+
```sh
|
|
23
|
+
npx @rafael_nicoleti/jatai --version
|
|
24
|
+
```
|
|
25
|
+
|
|
26
|
+
Não é preciso instalar globalmente. Se quiser instalar:
|
|
27
|
+
|
|
28
|
+
```sh
|
|
29
|
+
npm install --global @rafael_nicoleti/jatai
|
|
30
|
+
jatai --version
|
|
31
|
+
```
|
|
32
|
+
|
|
33
|
+
O binário continua sendo `jatai`. O pacote tem escopo porque o npm bloqueia o
|
|
34
|
+
nome sem escopo `jatai` por semelhança com `jotai` e `jiti`.
|
|
35
|
+
|
|
36
|
+
Para desenvolver a própria CLI, o pacote pode ser montado do repositório:
|
|
37
|
+
|
|
38
|
+
```sh
|
|
39
|
+
npm run build:cli-kit
|
|
40
|
+
node dist/cli-package/jatai.cjs --version
|
|
41
|
+
```
|
|
42
|
+
|
|
43
|
+
## Uso rápido
|
|
44
|
+
|
|
45
|
+
```sh
|
|
46
|
+
cd /caminho/do/meu-projeto
|
|
47
|
+
|
|
48
|
+
# 1. escolha o harness e instale o kit
|
|
49
|
+
npx @rafael_nicoleti/jatai init --harness opencode
|
|
50
|
+
|
|
51
|
+
# 2. confira o workspace
|
|
52
|
+
npx @rafael_nicoleti/jatai doctor
|
|
53
|
+
|
|
54
|
+
# 3. a partir daqui, abra o OpenCode no projeto e rode /jatai
|
|
55
|
+
```
|
|
56
|
+
|
|
57
|
+
`init` pergunta o harness se você não passar `--harness`. Em pasta não vazia,
|
|
58
|
+
pede confirmação; em CI, use `--yes`.
|
|
59
|
+
|
|
60
|
+
## Comandos
|
|
61
|
+
|
|
62
|
+
### `jatai init`
|
|
63
|
+
|
|
64
|
+
Instala o kit no projeto existente (brownfield), sem modificar o código.
|
|
65
|
+
|
|
66
|
+
```sh
|
|
67
|
+
jatai init --harness opencode
|
|
68
|
+
jatai init --harness claude --dir ./outro-projeto --name outro-projeto
|
|
69
|
+
jatai init --harness copilot --maturity dora-4keys,space-devex
|
|
70
|
+
jatai init --harness opencode --dry-run
|
|
71
|
+
jatai init --harness opencode --yes --json
|
|
72
|
+
```
|
|
73
|
+
|
|
74
|
+
| Flag | O que faz |
|
|
75
|
+
|---|---|
|
|
76
|
+
| `--harness <id>` | `copilot`, `claude` ou `opencode`; se omitido, pergunta |
|
|
77
|
+
| `--dir <pasta>` | diretório do workspace (default: atual) |
|
|
78
|
+
| `--name <nome>` | nome do projeto no config (default: basename em kebab-case) |
|
|
79
|
+
| `--maturity <lista>` | frameworks de maturidade separados por vírgula |
|
|
80
|
+
| `--dry-run` | mostra o que seria gravado; não escreve no alvo |
|
|
81
|
+
| `--yes` | não pede confirmação (CI) |
|
|
82
|
+
| `--json` | saída de máquina; stdout só JSON |
|
|
83
|
+
|
|
84
|
+
Em um workspace Jataí existente, `init` completa o que falta e **não troca o
|
|
85
|
+
harness**. Para atualizar o kit, use `update`.
|
|
86
|
+
|
|
87
|
+
### `jatai doctor`
|
|
88
|
+
|
|
89
|
+
Diagnóstico somente-leitura do workspace:
|
|
90
|
+
|
|
91
|
+
- Node, config, modo (brownfield/greenfield), harness detectado;
|
|
92
|
+
- `kit_version`, lock, arquivos do kit ausentes e edições do time;
|
|
93
|
+
- orquestrador, instruções, bundles do CLI/MCP;
|
|
94
|
+
- entrada MCP em `.mcp.json`, `.vscode/mcp.json` ou `opencode.json(c)`;
|
|
95
|
+
- `repos/` e `docs/input/`.
|
|
96
|
+
|
|
97
|
+
```sh
|
|
98
|
+
jatai doctor
|
|
99
|
+
jatai doctor --json
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
Sai com código 1 se houver erro. Avisos (versão defasada, arquivo editado pelo
|
|
103
|
+
time) não derrubam o comando.
|
|
104
|
+
|
|
105
|
+
### `jatai update`
|
|
106
|
+
|
|
107
|
+
Atualiza o kit do workspace detectado.
|
|
108
|
+
|
|
109
|
+
```sh
|
|
110
|
+
jatai update
|
|
111
|
+
jatai update --dry-run
|
|
112
|
+
jatai update --yes # necessário se o workspace não tem kit.lock.json
|
|
113
|
+
```
|
|
114
|
+
|
|
115
|
+
- Arquivo do kit editado pelo time é preservado; a versão nova vai para
|
|
116
|
+
`<arquivo>.kit-new`.
|
|
117
|
+
- Arquivo do kit que saiu da versão nova é removido apenas se estava intacto.
|
|
118
|
+
- `--dry-run` roda numa cópia mínima e mostra adicionados, alterados e
|
|
119
|
+
removidos; não toca no alvo.
|
|
120
|
+
|
|
121
|
+
### `jatai uninstall`
|
|
122
|
+
|
|
123
|
+
Remove só o que o kit instalou, usando o `kit.lock.json`.
|
|
124
|
+
|
|
125
|
+
```sh
|
|
126
|
+
jatai uninstall
|
|
127
|
+
jatai uninstall --dry-run
|
|
128
|
+
jatai uninstall --yes
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
- Arquivo do kit editado pelo time **fica** e é listado.
|
|
132
|
+
- Nunca toca em `agents/domain/`, `skills/coding-guidelines-*`,
|
|
133
|
+
`.github/artifacts/`, `docs/input/`, `repos/`, `.git/` ou `node_modules/`.
|
|
134
|
+
- Remove a entrada MCP da marca das configurações, preservando outros servidores
|
|
135
|
+
e comentários.
|
|
136
|
+
- No Claude Code, remove só os hooks do kit do `.claude/settings.json`.
|
|
137
|
+
- Preserva o config, os artefatos, o domínio e as skills do cliente.
|
|
138
|
+
- Sem `kit.lock.json`, o comando recusa; rode `update --yes` para criar o lock
|
|
139
|
+
ou remova manualmente.
|
|
140
|
+
|
|
141
|
+
### `jatai harness list`
|
|
142
|
+
|
|
143
|
+
Lista os harnesses suportados e o que cada um instala (pasta de agentes,
|
|
144
|
+
orquestrador, skills, instruções, comandos, MCP e atividade).
|
|
145
|
+
|
|
146
|
+
```sh
|
|
147
|
+
jatai harness list
|
|
148
|
+
jatai harness list --json
|
|
149
|
+
```
|
|
150
|
+
|
|
151
|
+
### `jatai state`
|
|
152
|
+
|
|
153
|
+
Delega ao CLI de estado instalado no workspace
|
|
154
|
+
(`.github/scripts/<marca>-state.cjs`). É o mesmo motor que os agentes usam;
|
|
155
|
+
a CLI de instalação não reimplementa os verbos.
|
|
156
|
+
|
|
157
|
+
```sh
|
|
158
|
+
jatai state initiatives list
|
|
159
|
+
jatai state gates approve --help
|
|
160
|
+
```
|
|
161
|
+
|
|
162
|
+
### `--json` e exit codes
|
|
163
|
+
|
|
164
|
+
`--json` escreve só JSON no stdout; logs e avisos vão para stderr. Os códigos
|
|
165
|
+
de saída são estáveis para CI:
|
|
166
|
+
|
|
167
|
+
| Código | Significado |
|
|
168
|
+
|---|---|
|
|
169
|
+
| 0 | sucesso (ou nada a fazer) |
|
|
170
|
+
| 1 | erro de uso/entrada (flag, harness, nome, diretório) |
|
|
171
|
+
| 2 | ambiente bloqueado (Node antigo, config de outro host, pasta não vazia, confirmação ausente) |
|
|
172
|
+
| 3 | erro interno (exceção do instalador) |
|
|
173
|
+
|
|
174
|
+
## O que o kit instala
|
|
175
|
+
|
|
176
|
+
| Harness | Agentes | Instruções | MCP |
|
|
177
|
+
|---|---|---|---|
|
|
178
|
+
| GitHub Copilot | `.github/agents/` | `.github/copilot-instructions.md` + `AGENTS.md` | `.mcp.json` + `.vscode/mcp.json` |
|
|
179
|
+
| Claude Code | `.claude/agents/` | `CLAUDE.md` + `AGENTS.md` | `.mcp.json` + `.vscode/mcp.json` |
|
|
180
|
+
| OpenCode | `.opencode/agents/` (plano) | `AGENTS.md` | `opencode.json(c)` |
|
|
181
|
+
|
|
182
|
+
Além dos agentes e skills, o kit cria `.github/artifacts/`, `.github/scripts/`
|
|
183
|
+
(CLI de estado e servidor MCP), `repos/`, `docs/input/`, `jatai.config.yaml` e
|
|
184
|
+
`.github/kit.lock.json`.
|
|
185
|
+
|
|
186
|
+
## Segurança e consentimento
|
|
187
|
+
|
|
188
|
+
- A CLI só escreve no `--dir`/diretório atual. Nunca em `~/.jatai`,
|
|
189
|
+
`/usr/local` ou fora do workspace.
|
|
190
|
+
- Sem `postinstall`, sem telemetria e sem rede na instalação: o kit vai embutido
|
|
191
|
+
no pacote.
|
|
192
|
+
- `init` em pasta não vazia pede confirmação; `--yes` é explícito.
|
|
193
|
+
- `update` e `uninstall` usam o lock e preservam o que o time editou.
|
|
194
|
+
- O `uninstall` não remove config, artefatos, domínio, skills do cliente nem
|
|
195
|
+
repositórios.
|
|
196
|
+
- O CLI não imprime conteúdo de secrets; o `doctor` só reporta presença.
|
|
197
|
+
|
|
198
|
+
## Limites desta versão
|
|
199
|
+
|
|
200
|
+
- **Brownfield primeiro.** Projeto novo continua no Wizard da extensão.
|
|
201
|
+
- **Um harness por workspace.** `jatai add` para instalar OpenCode ao lado de
|
|
202
|
+
Claude/Copilot é uma decisão futura.
|
|
203
|
+
- **OpenCode 2.x** no harness; o V1 fica para uma decisão futura.
|
|
204
|
+
- **Sem Cockpit.** O mapa, os gates e as decisões humanas continuam no VS Code.
|
|
205
|
+
- **Windows:** o produto funciona; o job de Windows do CI da suíte histórica é
|
|
206
|
+
experimental. O smoke da CLI roda nos três sistemas.
|
|
207
|
+
|
|
208
|
+
## Problemas comuns
|
|
209
|
+
|
|
210
|
+
| Sintoma | O que conferir |
|
|
211
|
+
|---|---|
|
|
212
|
+
| `npx @rafael_nicoleti/jatai` não encontra o pacote | veja se a versão foi publicada no npm; para desenvolvimento, use `node dist/cli-package/jatai.cjs` |
|
|
213
|
+
| `init` recusa a pasta | pasta não vazia sem `--yes`, ou já é um workspace Jataí com outro harness |
|
|
214
|
+
| `doctor` aponta arquivo ausente | o kit foi editado/removido; rode `jatai update` ou reinstale |
|
|
215
|
+
| MCP não conecta | a extensão/State Service precisa estar no ar; `opencode mcp list` / `doctor` |
|
|
216
|
+
| `uninstall` recusa | sem `kit.lock.json`; rode `update --yes` para criar o lock |
|
|
217
|
+
| `update`/`uninstall` preservam um arquivo | o time editou o arquivo do kit; ele fica, e a versão nova vai para `.kit-new` |
|
|
218
|
+
|
|
219
|
+
## Desenvolvimento
|
|
220
|
+
|
|
221
|
+
```sh
|
|
222
|
+
npm run build:cli-kit # monta dist/cli-package
|
|
223
|
+
node scripts/cli-kit-check.mjs
|
|
224
|
+
npx vitest run tests/cli-kit
|
|
225
|
+
```
|
|
226
|
+
|
|
227
|
+
O pacote é autocontido: `jatai.cjs` + `kit/` + `package.json`, sem
|
|
228
|
+
`node_modules` e sem `postinstall`. A publicação é feita pelo workflow de
|
|
229
|
+
release com provenance.
|
|
230
|
+
|
|
231
|
+
## Licença
|
|
232
|
+
|
|
233
|
+
MIT. Veja [LICENSE](LICENSE) e [THIRD_PARTY_NOTICES](THIRD_PARTY_NOTICES.md).
|