@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.
Files changed (154) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +232 -2
  3. package/THIRD_PARTY_NOTICES.md +5907 -0
  4. package/jatai.cjs +7061 -0
  5. package/kit/brownfield-templates/AGENTS.md +421 -0
  6. package/kit/brownfield-templates/agents/discovery/arch-discoverer.agent.md +514 -0
  7. package/kit/brownfield-templates/agents/discovery/assessor.agent.md +1357 -0
  8. package/kit/brownfield-templates/agents/discovery/business-archeologist.agent.md +226 -0
  9. package/kit/brownfield-templates/agents/discovery/coding-archaeologist.agent.md +394 -0
  10. package/kit/brownfield-templates/agents/discovery/debt-analyst.agent.md +97 -0
  11. package/kit/brownfield-templates/agents/discovery/dependency-mapper.agent.md +223 -0
  12. package/kit/brownfield-templates/agents/discovery/design-archaeologist.agent.md +213 -0
  13. package/kit/brownfield-templates/agents/discovery/domain-extractor.agent.md +402 -0
  14. package/kit/brownfield-templates/agents/discovery/maturity-assessor.agent.md +142 -0
  15. package/kit/brownfield-templates/agents/discovery/quality-auditor.agent.md +96 -0
  16. package/kit/brownfield-templates/agents/discovery/security-auditor.agent.md +92 -0
  17. package/kit/brownfield-templates/agents/discovery/tech-mapper.agent.md +125 -0
  18. package/kit/brownfield-templates/agents/discovery/test-coverage-mapper.agent.md +92 -0
  19. package/kit/brownfield-templates/agents/execution/feature-adder.agent.md +143 -0
  20. package/kit/brownfield-templates/agents/execution/migration-agent.agent.md +99 -0
  21. package/kit/brownfield-templates/agents/execution/refactor-agent.agent.md +104 -0
  22. package/kit/brownfield-templates/agents/execution/test-backfill-agent.agent.md +91 -0
  23. package/kit/brownfield-templates/agents/maestro.agent.md +209 -0
  24. package/kit/brownfield-templates/agents/operation/devops.agent.md +75 -0
  25. package/kit/brownfield-templates/agents/operation/incident.agent.md +89 -0
  26. package/kit/brownfield-templates/agents/operation/observability.agent.md +65 -0
  27. package/kit/brownfield-templates/agents/operation/sustain.agent.md +67 -0
  28. package/kit/brownfield-templates/agents/planning/adr-recorder.agent.md +77 -0
  29. package/kit/brownfield-templates/agents/planning/modernization-planner.agent.md +214 -0
  30. package/kit/brownfield-templates/agents/planning/risk-prioritizer.agent.md +68 -0
  31. package/kit/brownfield-templates/chatmodes/maestro.chatmode.md +134 -0
  32. package/kit/brownfield-templates/claude-instructions.md +81 -0
  33. package/kit/brownfield-templates/copilot-instructions.md +85 -0
  34. package/kit/brownfield-templates/opencode-instructions.md +110 -0
  35. package/kit/brownfield-templates/skills/arch-clean-frontend/SKILL.md +209 -0
  36. package/kit/brownfield-templates/skills/arch-ddd-tactical/SKILL.md +289 -0
  37. package/kit/brownfield-templates/skills/arch-diagrams-drawio/SKILL.md +338 -0
  38. package/kit/brownfield-templates/skills/arch-diagrams-likec4/SKILL.md +223 -0
  39. package/kit/brownfield-templates/skills/arch-feature-based/SKILL.md +234 -0
  40. package/kit/brownfield-templates/skills/arch-hexagonal/SKILL.md +219 -0
  41. package/kit/brownfield-templates/skills/arch-layered/SKILL.md +234 -0
  42. package/kit/brownfield-templates/skills/arch-mvc/SKILL.md +221 -0
  43. package/kit/brownfield-templates/skills/arch-mvvm/SKILL.md +244 -0
  44. package/kit/brownfield-templates/skills/arch-pattern-detection/SKILL.md +113 -0
  45. package/kit/brownfield-templates/skills/arch-vertical-slice/SKILL.md +180 -0
  46. package/kit/brownfield-templates/skills/bdd-gherkin/SKILL.md +317 -0
  47. package/kit/brownfield-templates/skills/characterization-testing/SKILL.md +111 -0
  48. package/kit/brownfield-templates/skills/code-quality-audit/SKILL.md +120 -0
  49. package/kit/brownfield-templates/skills/codebase-enrichment/SKILL.md +160 -0
  50. package/kit/brownfield-templates/skills/coding-guidelines/SKILL.md +462 -0
  51. package/kit/brownfield-templates/skills/commit-assistant/SKILL.md +226 -0
  52. package/kit/brownfield-templates/skills/docs-writer/SKILL.md +268 -0
  53. package/kit/brownfield-templates/skills/domain-driven-design/SKILL.md +225 -0
  54. package/kit/brownfield-templates/skills/domain-extraction-from-code/SKILL.md +118 -0
  55. package/kit/brownfield-templates/skills/integration-testing/SKILL.md +165 -0
  56. package/kit/brownfield-templates/skills/legacy-modernization-patterns/SKILL.md +143 -0
  57. package/kit/brownfield-templates/skills/maturity-bsimm/SKILL.md +146 -0
  58. package/kit/brownfield-templates/skills/maturity-cmmi/SKILL.md +138 -0
  59. package/kit/brownfield-templates/skills/maturity-dora-4keys/SKILL.md +101 -0
  60. package/kit/brownfield-templates/skills/maturity-dora-capabilities/SKILL.md +133 -0
  61. package/kit/brownfield-templates/skills/maturity-iso-25010/SKILL.md +110 -0
  62. package/kit/brownfield-templates/skills/maturity-owasp-asvs/SKILL.md +116 -0
  63. package/kit/brownfield-templates/skills/maturity-owasp-samm/SKILL.md +112 -0
  64. package/kit/brownfield-templates/skills/maturity-space-devex/SKILL.md +147 -0
  65. package/kit/brownfield-templates/skills/maturity-spotify-health/SKILL.md +104 -0
  66. package/kit/brownfield-templates/skills/maturity-tech-radar/SKILL.md +118 -0
  67. package/kit/brownfield-templates/skills/qa-strategy/SKILL.md +116 -0
  68. package/kit/brownfield-templates/skills/safe-refactoring-recipes/SKILL.md +149 -0
  69. package/kit/brownfield-templates/skills/security-best-practices/SKILL.md +176 -0
  70. package/kit/brownfield-templates/skills/security-cve-checker/SKILL.md +183 -0
  71. package/kit/brownfield-templates/skills/task-manager/SKILL.md +292 -0
  72. package/kit/brownfield-templates/skills/tech-debt-mapping/SKILL.md +123 -0
  73. package/kit/brownfield-templates/skills/tech-stack-detection/SKILL.md +82 -0
  74. package/kit/brownfield-templates/skills/ui-ux-design-system/SKILL.md +317 -0
  75. package/kit/brownfield-templates/skills/ux-prototyping/SKILL.md +346 -0
  76. package/kit/brownfield-templates/skills/version-migration-playbook/SKILL.md +162 -0
  77. package/kit/brownfield-templates/skills/workflow-memory/SKILL.md +261 -0
  78. package/kit/templates/agents/downstream/backend-dotnet.agent.md +70 -0
  79. package/kit/templates/agents/downstream/backend-java.agent.md +72 -0
  80. package/kit/templates/agents/downstream/backend-python-agentic.agent.md +73 -0
  81. package/kit/templates/agents/downstream/backend-python-api.agent.md +81 -0
  82. package/kit/templates/agents/downstream/frontend-android.agent.md +62 -0
  83. package/kit/templates/agents/downstream/frontend-flutter.agent.md +62 -0
  84. package/kit/templates/agents/downstream/frontend-ios.agent.md +61 -0
  85. package/kit/templates/agents/downstream/frontend-react.agent.md +76 -0
  86. package/kit/templates/agents/downstream/reviewer.agent.md +132 -0
  87. package/kit/templates/agents/downstream/sprint-runner.agent.md +202 -0
  88. package/kit/templates/agents/guardian/arch-cross.agent.md +50 -0
  89. package/kit/templates/agents/guardian/stream-align.agent.md +45 -0
  90. package/kit/templates/agents/maestro.agent.md +303 -0
  91. package/kit/templates/agents/operation/devops.agent.md +51 -0
  92. package/kit/templates/agents/operation/incident.agent.md +49 -0
  93. package/kit/templates/agents/operation/observability.agent.md +49 -0
  94. package/kit/templates/agents/operation/release.agent.md +49 -0
  95. package/kit/templates/agents/operation/sustain.agent.md +47 -0
  96. package/kit/templates/agents/sidecar/docs.agent.md +26 -0
  97. package/kit/templates/agents/sidecar/integration-tests.agent.md +30 -0
  98. package/kit/templates/agents/sidecar/qa-tester.agent.md +28 -0
  99. package/kit/templates/agents/sidecar/quality.agent.md +26 -0
  100. package/kit/templates/agents/sidecar/security.agent.md +29 -0
  101. package/kit/templates/agents/upstream/architecture.agent.md +395 -0
  102. package/kit/templates/agents/upstream/bdd.agent.md +97 -0
  103. package/kit/templates/agents/upstream/business.agent.md +122 -0
  104. package/kit/templates/agents/upstream/domain-modeler.agent.md +136 -0
  105. package/kit/templates/agents/upstream/product.agent.md +119 -0
  106. package/kit/templates/agents/upstream/sprint-planner.agent.md +98 -0
  107. package/kit/templates/agents/upstream/ux-designer.agent.md +245 -0
  108. package/kit/templates/chatmodes/maestro.chatmode.md +143 -0
  109. package/kit/templates/docs/adr/0001-arquitetura-referencia-clean-hexagonal.md +52 -0
  110. package/kit/templates/docs/adr/README.md +34 -0
  111. package/kit/templates/docs/delivery-flow.md +160 -0
  112. package/kit/templates/docs/hierarchy.md +112 -0
  113. package/kit/templates/docs/routing-rules.md +116 -0
  114. package/kit/templates/features/support/README.md +94 -0
  115. package/kit/templates/scripts/jatai-mcp.cjs +30236 -0
  116. package/kit/templates/scripts/jatai-state.cjs +17076 -0
  117. package/kit/templates/skills/README.md +36 -0
  118. package/kit/templates/skills/ai-agent-author/SKILL.md +177 -0
  119. package/kit/templates/skills/arch-clean-frontend/SKILL.md +209 -0
  120. package/kit/templates/skills/arch-ddd-tactical/SKILL.md +289 -0
  121. package/kit/templates/skills/arch-diagrams-drawio/SKILL.md +338 -0
  122. package/kit/templates/skills/arch-feature-based/SKILL.md +234 -0
  123. package/kit/templates/skills/arch-hexagonal/SKILL.md +219 -0
  124. package/kit/templates/skills/arch-layered/SKILL.md +234 -0
  125. package/kit/templates/skills/arch-mvc/SKILL.md +221 -0
  126. package/kit/templates/skills/arch-mvvm/SKILL.md +244 -0
  127. package/kit/templates/skills/arch-vertical-slice/SKILL.md +180 -0
  128. package/kit/templates/skills/bdd-gherkin/SKILL.md +317 -0
  129. package/kit/templates/skills/codebase-enrichment/SKILL.md +160 -0
  130. package/kit/templates/skills/coding-guidelines/SKILL.md +462 -0
  131. package/kit/templates/skills/commit-assistant/SKILL.md +226 -0
  132. package/kit/templates/skills/docs-writer/SKILL.md +268 -0
  133. package/kit/templates/skills/domain-driven-design/SKILL.md +225 -0
  134. package/kit/templates/skills/integration-testing/SKILL.md +165 -0
  135. package/kit/templates/skills/lang-android/SKILL.md +270 -0
  136. package/kit/templates/skills/lang-dotnet/SKILL.md +278 -0
  137. package/kit/templates/skills/lang-flutter/SKILL.md +268 -0
  138. package/kit/templates/skills/lang-ios/SKILL.md +285 -0
  139. package/kit/templates/skills/lang-java-spring/SKILL.md +291 -0
  140. package/kit/templates/skills/lang-python-agentic/SKILL.md +244 -0
  141. package/kit/templates/skills/lang-python-api/SKILL.md +289 -0
  142. package/kit/templates/skills/lang-react/SKILL.md +262 -0
  143. package/kit/templates/skills/openapi-governance/SKILL.md +471 -0
  144. package/kit/templates/skills/pipeline-adapter/SKILL.md +330 -0
  145. package/kit/templates/skills/qa-strategy/SKILL.md +116 -0
  146. package/kit/templates/skills/registry.yaml +560 -0
  147. package/kit/templates/skills/security-best-practices/SKILL.md +176 -0
  148. package/kit/templates/skills/security-cve-checker/SKILL.md +183 -0
  149. package/kit/templates/skills/task-manager/SKILL.md +292 -0
  150. package/kit/templates/skills/ui-ux-design-system/SKILL.md +317 -0
  151. package/kit/templates/skills/ux-prototyping/SKILL.md +346 -0
  152. package/kit/templates/skills/workflow-memory/SKILL.md +261 -0
  153. package/kit/templates/skills/workspace-tools/SKILL.md +237 -0
  154. 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
- # Temporary Holding Version
1
+ # CLI do Jataí
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
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).