cleudocode-core 1.0.0 → 2.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +227 -452
- package/core/index.js +61 -0
- package/package.json +13 -4
package/README.md
CHANGED
|
@@ -1,212 +1,267 @@
|
|
|
1
1
|
# 🚀 Cleudocode Core
|
|
2
2
|
|
|
3
|
-
> **
|
|
3
|
+
> **Super Máquina de Criar Códigos para Desenvolvedores**
|
|
4
4
|
|
|
5
5
|
[](https://www.npmjs.com/package/cleudocode-core)
|
|
6
6
|
[](https://www.npmjs.com/package/cleudocode-core)
|
|
7
7
|
[](LICENSE)
|
|
8
8
|
[](https://nodejs.org/)
|
|
9
9
|
|
|
10
|
-
Cleudocode Core é
|
|
10
|
+
Cleudocode Core é uma **super máquina de criar códigos** baseada nas arquiteturas do **AIOS** e **AIOX-Core**. Gera código automaticamente, gerencia agentes AI, e executa workflows completos de desenvolvimento.
|
|
11
11
|
|
|
12
12
|
## ✨ Features
|
|
13
13
|
|
|
14
|
-
|
|
15
|
-
-
|
|
16
|
-
-
|
|
17
|
-
-
|
|
18
|
-
-
|
|
19
|
-
-
|
|
20
|
-
-
|
|
14
|
+
### 🧠 Core Poderoso
|
|
15
|
+
- **Orquestração de Agentes** - Gerencie múltiplos agentes AI especializados
|
|
16
|
+
- **Geração de Código** - Crie código automaticamente em JavaScript, TypeScript, Python
|
|
17
|
+
- **Workflows** - Execute fluxos completos (feature development, bug fix, code review)
|
|
18
|
+
- **Elicitação Interativa** - Prompting inteligente para coletar requisitos
|
|
19
|
+
- **Memória e Contexto** - Mantenha contexto entre sessões
|
|
20
|
+
- **Quality Gates** - Code review automático, linting, testes, segurança
|
|
21
|
+
|
|
22
|
+
### 🤖 Agentes Especializados
|
|
23
|
+
- `@architect` - Arquitetura de software
|
|
24
|
+
- `@dev` - Desenvolvimento de código
|
|
25
|
+
- `@reviewer` - Revisão de código
|
|
26
|
+
- `@tester` - Criação de testes
|
|
27
|
+
- `@devops` - Infra e CI/CD
|
|
28
|
+
|
|
29
|
+
### 🔌 Multi-LLM
|
|
30
|
+
- OpenAI (GPT-4, GPT-4o)
|
|
31
|
+
- Anthropic (Claude 3)
|
|
32
|
+
- Google (Gemini)
|
|
33
|
+
- Ollama (modelos locais)
|
|
34
|
+
- vLLM (self-hosted)
|
|
21
35
|
|
|
22
36
|
## 🚀 Instalação
|
|
23
37
|
|
|
24
38
|
### Via NPX (Recomendado)
|
|
25
39
|
|
|
26
|
-
Instale e execute com um único comando:
|
|
27
|
-
|
|
28
40
|
```bash
|
|
29
41
|
npx cleudocode-core@latest init
|
|
30
42
|
```
|
|
31
43
|
|
|
32
44
|
### Instalação Global
|
|
33
45
|
|
|
34
|
-
Para usar em qualquer projeto sem digitar `npx`:
|
|
35
|
-
|
|
36
46
|
```bash
|
|
37
47
|
npm install -g cleudocode-core
|
|
38
48
|
```
|
|
39
49
|
|
|
40
|
-
Depois, use em qualquer lugar:
|
|
41
|
-
|
|
42
|
-
```bash
|
|
43
|
-
cleudocode-core init
|
|
44
|
-
```
|
|
45
|
-
|
|
46
50
|
## 🎯 Início Rápido
|
|
47
51
|
|
|
48
|
-
### 1. Inicializar
|
|
52
|
+
### 1. Inicializar Projeto
|
|
49
53
|
|
|
50
54
|
```bash
|
|
51
|
-
# Navegue até seu projeto
|
|
52
55
|
cd meu-projeto
|
|
53
|
-
|
|
54
|
-
# Inicialize Cleudocode Core
|
|
55
|
-
npx cleudocode-core@latest init
|
|
56
|
+
npx cleudocode-core init
|
|
56
57
|
```
|
|
57
58
|
|
|
58
|
-
Isso
|
|
59
|
+
Isso cria:
|
|
59
60
|
- `.cleudocode-core` - Configuração principal
|
|
60
61
|
- `AGENTS.md` - Configuração de agentes
|
|
61
|
-
- `.
|
|
62
|
-
-
|
|
62
|
+
- `.agents/` - Estrutura de agentes
|
|
63
|
+
- `core/` - Core do sistema
|
|
63
64
|
|
|
64
|
-
### 2.
|
|
65
|
+
### 2. Gerar Código
|
|
65
66
|
|
|
66
67
|
```bash
|
|
67
|
-
#
|
|
68
|
-
|
|
68
|
+
# Gerar API REST
|
|
69
|
+
cleudocode-core generate \
|
|
70
|
+
--spec "API REST com Express" \
|
|
71
|
+
--language typescript \
|
|
72
|
+
--tests \
|
|
73
|
+
--docs
|
|
69
74
|
|
|
70
|
-
#
|
|
71
|
-
|
|
75
|
+
# Gerar componente React
|
|
76
|
+
cleudocode-core generate \
|
|
77
|
+
--type component \
|
|
78
|
+
--name UserProfile \
|
|
79
|
+
--props "user: object, onEdit: function"
|
|
72
80
|
```
|
|
73
81
|
|
|
74
|
-
### 3.
|
|
82
|
+
### 3. Executar Workflow
|
|
75
83
|
|
|
76
84
|
```bash
|
|
77
|
-
|
|
78
|
-
|
|
85
|
+
# Desenvolvimento de feature
|
|
86
|
+
cleudocode-core workflow run \
|
|
87
|
+
--name feature-development \
|
|
88
|
+
--requirement "Criar endpoint de usuário"
|
|
79
89
|
|
|
80
|
-
|
|
81
|
-
|
|
82
|
-
|
|
83
|
-
|
|
84
|
-
✓ AGENTS.md: Encontrado
|
|
85
|
-
ℹ .env: Opcional (copie de .env.example)
|
|
86
|
-
ℹ Ollama: Não instalado (opcional para modelos locais)
|
|
90
|
+
# Code review
|
|
91
|
+
cleudocode-core workflow run \
|
|
92
|
+
--name code-review \
|
|
93
|
+
--files "src/**/*.js"
|
|
87
94
|
```
|
|
88
95
|
|
|
89
|
-
### 4.
|
|
96
|
+
### 4. Usar Agentes
|
|
90
97
|
|
|
91
98
|
```bash
|
|
92
|
-
# Listar agentes
|
|
93
|
-
|
|
99
|
+
# Listar agentes
|
|
100
|
+
cleudocode-core agents --list
|
|
94
101
|
|
|
95
|
-
# Executar
|
|
96
|
-
|
|
97
|
-
```
|
|
102
|
+
# Executar tarefa com agente
|
|
103
|
+
cleudocode-core run dev -t "criar função de validação de email"
|
|
98
104
|
|
|
99
|
-
|
|
105
|
+
# Revisar código
|
|
106
|
+
cleudocode-core run reviewer -t "revisar src/auth.js"
|
|
107
|
+
```
|
|
100
108
|
|
|
101
|
-
|
|
109
|
+
## 📖 Comandos Principais
|
|
102
110
|
|
|
103
111
|
| Comando | Descrição |
|
|
104
112
|
|---------|-----------|
|
|
105
113
|
| `init` | Inicializa Cleudocode Core no projeto |
|
|
106
|
-
| `
|
|
114
|
+
| `generate [spec]` | Gera código automaticamente |
|
|
115
|
+
| `run <agente> -t <tarefa>` | Executa tarefa com agente |
|
|
116
|
+
| `workflow run <nome>` | Executa workflow |
|
|
107
117
|
| `agents` | Gerencia agentes |
|
|
108
|
-
| `
|
|
109
|
-
| `config` | Mostra
|
|
110
|
-
| `doctor` | Verifica saúde
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
118
|
+
| `review <file>` | Revisa código |
|
|
119
|
+
| `config` | Mostra configuração |
|
|
120
|
+
| `doctor` | Verifica saúde do sistema |
|
|
121
|
+
|
|
122
|
+
## 🏗️ Arquitetura
|
|
123
|
+
|
|
124
|
+
```
|
|
125
|
+
cleudocode-core/
|
|
126
|
+
├── bin/ # CLI executável
|
|
127
|
+
├── core/ ← NÚCLEO DO SISTEMA
|
|
128
|
+
│ ├── config/ # Configuração
|
|
129
|
+
│ ├── orchestration/ # Orquestração de agentes
|
|
130
|
+
│ ├── elicitation/ # Prompting interativo
|
|
131
|
+
│ ├── execution/ # Geração de código
|
|
132
|
+
│ ├── memory/ # Memória e contexto
|
|
133
|
+
│ ├── registry/ # Registro de serviços
|
|
134
|
+
│ ├── quality-gates/ # Code review, linting
|
|
135
|
+
│ ├── session/ # Gerenciamento de sessão
|
|
136
|
+
│ ├── utils/ # Utilitários
|
|
137
|
+
│ └── doctor/ # Health check
|
|
138
|
+
├── agents/ # Agentes especializados
|
|
139
|
+
└── templates/ # Templates de código
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
### Módulo Core
|
|
143
|
+
|
|
144
|
+
```javascript
|
|
145
|
+
import {
|
|
146
|
+
CleudocodeOrchestrator,
|
|
147
|
+
CodeGenerator,
|
|
148
|
+
ElicitationEngine,
|
|
149
|
+
ContextManager,
|
|
150
|
+
CodeReviewer,
|
|
151
|
+
WorkflowEngine
|
|
152
|
+
} from 'cleudocode-core'
|
|
153
|
+
|
|
154
|
+
// Criar orquestrador
|
|
155
|
+
const orchestrator = new CleudocodeOrchestrator()
|
|
156
|
+
await orchestrator.initialize()
|
|
157
|
+
|
|
158
|
+
// Gerar código
|
|
159
|
+
const code = await orchestrator.generateCode({
|
|
160
|
+
language: 'typescript',
|
|
161
|
+
type: 'api',
|
|
162
|
+
name: 'UserService',
|
|
163
|
+
endpoints: [
|
|
164
|
+
{ method: 'get', path: '/users' },
|
|
165
|
+
{ method: 'post', path: '/users' }
|
|
166
|
+
]
|
|
167
|
+
})
|
|
168
|
+
|
|
169
|
+
// Executar workflow
|
|
170
|
+
const result = await orchestrator.runWorkflow('feature-development', {
|
|
171
|
+
requirement: 'Criar sistema de autenticação'
|
|
172
|
+
})
|
|
173
|
+
```
|
|
174
|
+
|
|
175
|
+
## 📊 Exemplos de Uso
|
|
176
|
+
|
|
177
|
+
### Gerar API Completa
|
|
115
178
|
|
|
116
179
|
```bash
|
|
117
|
-
|
|
118
|
-
|
|
119
|
-
|
|
120
|
-
|
|
121
|
-
|
|
122
|
-
|
|
123
|
-
|
|
124
|
-
|
|
125
|
-
|
|
126
|
-
# Adicionar novo agente
|
|
127
|
-
npx cleudocode-core agents --add data-engineer
|
|
128
|
-
|
|
129
|
-
# Remover agente
|
|
130
|
-
npx cleudocode-core agents --remove legacy-agent
|
|
131
|
-
|
|
132
|
-
# Ver configuração
|
|
133
|
-
npx cleudocode-core config
|
|
134
|
-
|
|
135
|
-
# Ver configuração específica
|
|
136
|
-
npx cleudocode-core config settings.language
|
|
137
|
-
|
|
138
|
-
# Editar configuração
|
|
139
|
-
npx cleudocode-core config --edit
|
|
180
|
+
cleudocode-core generate api \
|
|
181
|
+
--name "User API" \
|
|
182
|
+
--framework express \
|
|
183
|
+
--endpoints "GET /users, POST /users, GET /users/:id, PUT /users/:id, DELETE /users/:id" \
|
|
184
|
+
--database mongodb \
|
|
185
|
+
--auth jwt \
|
|
186
|
+
--tests \
|
|
187
|
+
--docs
|
|
188
|
+
```
|
|
140
189
|
|
|
141
|
-
|
|
142
|
-
|
|
190
|
+
**Saída:**
|
|
191
|
+
```
|
|
192
|
+
✅ API gerada com sucesso!
|
|
143
193
|
|
|
144
|
-
|
|
145
|
-
|
|
194
|
+
📁 Files created:
|
|
195
|
+
- src/routes/users.js
|
|
196
|
+
- src/controllers/userController.js
|
|
197
|
+
- src/models/User.js
|
|
198
|
+
- src/middleware/auth.js
|
|
199
|
+
- tests/users.test.js
|
|
200
|
+
- docs/api.md
|
|
146
201
|
|
|
147
|
-
|
|
148
|
-
|
|
202
|
+
📦 Dependencies:
|
|
203
|
+
- express
|
|
204
|
+
- mongoose
|
|
205
|
+
- jsonwebtoken
|
|
206
|
+
- bcrypt
|
|
149
207
|
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
npx cleudocode-core update --global
|
|
208
|
+
🧪 Tests: 12 passing
|
|
209
|
+
📊 Code Quality: A (95/100)
|
|
153
210
|
```
|
|
154
211
|
|
|
155
|
-
|
|
156
|
-
|
|
157
|
-
### Agentes Padrão
|
|
212
|
+
### Workflow de Bug Fix
|
|
158
213
|
|
|
159
|
-
|
|
160
|
-
|
|
161
|
-
|
|
162
|
-
|
|
163
|
-
|
|
164
|
-
|
|
165
|
-
| `architect` | Arquitetura de software |
|
|
166
|
-
| `dev` | Desenvolvimento |
|
|
167
|
-
| `devops` | Infra e CI/CD |
|
|
168
|
-
| `qa` | Qualidade e testes |
|
|
214
|
+
```bash
|
|
215
|
+
cleudocode-core workflow run bug-fix \
|
|
216
|
+
--bug-description "Usuário não consegue fazer login com email em maiúsculas" \
|
|
217
|
+
--reproduce-steps "1. Acessar /login 2. Digitar EMAIL@TEST.COM 3. Clicar em entrar" \
|
|
218
|
+
--expected-behavior "Login deve funcionar independente de case"
|
|
219
|
+
```
|
|
169
220
|
|
|
170
|
-
###
|
|
221
|
+
### Code Review Automático
|
|
171
222
|
|
|
172
223
|
```bash
|
|
173
|
-
|
|
174
|
-
|
|
175
|
-
|
|
176
|
-
|
|
177
|
-
|
|
224
|
+
cleudocode-core review src/**/*.js \
|
|
225
|
+
--check-style \
|
|
226
|
+
--check-security \
|
|
227
|
+
--check-performance \
|
|
228
|
+
--output report.md
|
|
178
229
|
```
|
|
179
230
|
|
|
180
|
-
|
|
181
|
-
|
|
231
|
+
**Relatório:**
|
|
182
232
|
```markdown
|
|
183
|
-
#
|
|
233
|
+
# Code Review Report
|
|
184
234
|
|
|
185
|
-
##
|
|
186
|
-
|
|
235
|
+
## Summary
|
|
236
|
+
- Files reviewed: 15
|
|
237
|
+
- Issues found: 23
|
|
238
|
+
- Quality Score: B (82/100)
|
|
187
239
|
|
|
188
|
-
##
|
|
189
|
-
-
|
|
190
|
-
-
|
|
191
|
-
- *resolve - Criar resolvers
|
|
240
|
+
## Critical Issues (2)
|
|
241
|
+
- ⚠️ eval() detected in src/utils.js:45
|
|
242
|
+
- ⚠️ Hardcoded password in src/config.js:12
|
|
192
243
|
|
|
193
|
-
##
|
|
194
|
-
|
|
195
|
-
|
|
196
|
-
|
|
244
|
+
## Warnings (5)
|
|
245
|
+
- Long lines (>100 chars) in 3 files
|
|
246
|
+
- console.log statements in production code
|
|
247
|
+
|
|
248
|
+
## Suggestions
|
|
249
|
+
1. Replace eval() with safer alternatives
|
|
250
|
+
2. Use environment variables for credentials
|
|
251
|
+
3. Remove console.log statements
|
|
197
252
|
```
|
|
198
253
|
|
|
199
|
-
##
|
|
254
|
+
## 🔧 Configuração
|
|
200
255
|
|
|
201
256
|
### Arquivo `.cleudocode-core`
|
|
202
257
|
|
|
203
258
|
```yaml
|
|
204
|
-
version: "
|
|
259
|
+
version: "2.0.0"
|
|
205
260
|
|
|
206
261
|
settings:
|
|
207
262
|
language: "pt-BR"
|
|
208
|
-
default_agent: "
|
|
209
|
-
verbose:
|
|
263
|
+
default_agent: "dev"
|
|
264
|
+
verbose: true
|
|
210
265
|
|
|
211
266
|
llms:
|
|
212
267
|
models:
|
|
@@ -214,355 +269,75 @@ llms:
|
|
|
214
269
|
backend: "ollama"
|
|
215
270
|
hostname: "http://localhost:11434"
|
|
216
271
|
enabled: true
|
|
217
|
-
|
|
218
|
-
- name: "gpt-4o-mini"
|
|
272
|
+
- name: "gpt-4o"
|
|
219
273
|
backend: "openai"
|
|
220
274
|
enabled: false
|
|
221
275
|
|
|
222
276
|
agents:
|
|
223
277
|
enabled:
|
|
224
|
-
- "
|
|
225
|
-
- "
|
|
226
|
-
- "
|
|
227
|
-
|
|
228
|
-
|
|
229
|
-
|
|
230
|
-
|
|
231
|
-
|
|
232
|
-
|
|
233
|
-
|
|
234
|
-
|
|
235
|
-
|
|
236
|
-
|
|
237
|
-
|
|
238
|
-
|
|
239
|
-
|
|
240
|
-
|
|
241
|
-
|
|
242
|
-
|
|
243
|
-
|
|
244
|
-
|
|
245
|
-
|
|
246
|
-
|
|
247
|
-
|
|
248
|
-
|
|
249
|
-
### Ollama (Local - Recomendado)
|
|
250
|
-
|
|
251
|
-
```yaml
|
|
252
|
-
llms:
|
|
253
|
-
models:
|
|
254
|
-
- name: "qwen3:4b"
|
|
255
|
-
backend: "ollama"
|
|
256
|
-
hostname: "http://localhost:11434"
|
|
257
|
-
enabled: true
|
|
258
|
-
```
|
|
259
|
-
|
|
260
|
-
**Instalar Ollama:**
|
|
261
|
-
```bash
|
|
262
|
-
# Linux/Mac
|
|
263
|
-
curl -fsSL https://ollama.com/install.sh | sh
|
|
264
|
-
|
|
265
|
-
# Baixar modelo
|
|
266
|
-
ollama pull qwen3:4b
|
|
267
|
-
|
|
268
|
-
# Iniciar servidor
|
|
269
|
-
ollama serve
|
|
270
|
-
```
|
|
271
|
-
|
|
272
|
-
### OpenAI
|
|
273
|
-
|
|
274
|
-
```yaml
|
|
275
|
-
llms:
|
|
276
|
-
models:
|
|
277
|
-
- name: "gpt-4o-mini"
|
|
278
|
-
backend: "openai"
|
|
279
|
-
enabled: true
|
|
280
|
-
```
|
|
281
|
-
|
|
282
|
-
```bash
|
|
283
|
-
# .env
|
|
284
|
-
OPENAI_API_KEY=sk-...
|
|
285
|
-
```
|
|
286
|
-
|
|
287
|
-
### Anthropic
|
|
288
|
-
|
|
289
|
-
```yaml
|
|
290
|
-
llms:
|
|
291
|
-
models:
|
|
292
|
-
- name: "claude-3-5-sonnet"
|
|
293
|
-
backend: "anthropic"
|
|
294
|
-
enabled: true
|
|
295
|
-
```
|
|
296
|
-
|
|
297
|
-
```bash
|
|
298
|
-
# .env
|
|
299
|
-
ANTHROPIC_API_KEY=sk-ant-...
|
|
300
|
-
```
|
|
301
|
-
|
|
302
|
-
### Google Gemini
|
|
303
|
-
|
|
304
|
-
```yaml
|
|
305
|
-
llms:
|
|
306
|
-
models:
|
|
307
|
-
- name: "gemini-2.0-flash"
|
|
308
|
-
backend: "gemini"
|
|
309
|
-
enabled: true
|
|
310
|
-
```
|
|
311
|
-
|
|
312
|
-
```bash
|
|
313
|
-
# .env
|
|
314
|
-
GEMINI_API_KEY=...
|
|
315
|
-
```
|
|
316
|
-
|
|
317
|
-
### vLLM (Self-hosted)
|
|
318
|
-
|
|
319
|
-
```yaml
|
|
320
|
-
llms:
|
|
321
|
-
models:
|
|
322
|
-
- name: "meta-llama/Llama-3.1-8B-Instruct"
|
|
323
|
-
backend: "vllm"
|
|
324
|
-
hostname: "http://localhost:8091"
|
|
325
|
-
enabled: true
|
|
326
|
-
```
|
|
327
|
-
|
|
328
|
-
### HuggingFace
|
|
329
|
-
|
|
330
|
-
```yaml
|
|
331
|
-
llms:
|
|
332
|
-
models:
|
|
333
|
-
- name: "meta-llama/Llama-3.1-8B-Instruct"
|
|
334
|
-
backend: "huggingface"
|
|
335
|
-
max_gpu_memory: {0: "48GB"}
|
|
336
|
-
eval_device: "cuda:0"
|
|
337
|
-
enabled: true
|
|
338
|
-
```
|
|
339
|
-
|
|
340
|
-
## 📚 Estrutura de Diretórios
|
|
341
|
-
|
|
342
|
-
```
|
|
343
|
-
projeto/
|
|
344
|
-
├── .cleudocode-core # Configuração principal
|
|
345
|
-
├── .env # Variáveis de ambiente
|
|
346
|
-
├── .env.example # Exemplo de variáveis
|
|
347
|
-
├── AGENTS.md # Configuração de agentes
|
|
348
|
-
│
|
|
349
|
-
├── .agents/
|
|
350
|
-
│ ├── constitution.md # Princípios fundamentais
|
|
351
|
-
│ ├── agents/ # Definições de agentes
|
|
352
|
-
│ ├── rules/ # Regras de código
|
|
353
|
-
│ ├── tasks/ # Tarefas e workflows
|
|
354
|
-
│ ├── templates/ # Templates de código
|
|
355
|
-
│ ├── outputs/ # Saídas geradas
|
|
356
|
-
│ ├── logs/ # Logs de execução
|
|
357
|
-
│ └── storage/ # Armazenamento (memória)
|
|
358
|
-
│
|
|
359
|
-
├── src/ # Código fonte
|
|
360
|
-
├── tests/ # Testes
|
|
361
|
-
└── docs/ # Documentação
|
|
362
|
-
```
|
|
363
|
-
|
|
364
|
-
## 📝 Regras de Código
|
|
365
|
-
|
|
366
|
-
### JavaScript/TypeScript
|
|
367
|
-
|
|
368
|
-
```json
|
|
369
|
-
// .eslintrc.json
|
|
370
|
-
{
|
|
371
|
-
"indent": ["error", 2],
|
|
372
|
-
"quotes": ["error", "single"],
|
|
373
|
-
"semi": ["error", "never"],
|
|
374
|
-
"comma-dangle": ["error", "always-multiline"]
|
|
375
|
-
}
|
|
376
|
-
```
|
|
377
|
-
|
|
378
|
-
### Python
|
|
379
|
-
|
|
380
|
-
```toml
|
|
381
|
-
# pyproject.toml
|
|
382
|
-
[lint]
|
|
383
|
-
select = ["E", "W", "F", "I", "B"]
|
|
384
|
-
line-length = 100
|
|
385
|
-
```
|
|
386
|
-
|
|
387
|
-
### Commits (Conventional Commits)
|
|
388
|
-
|
|
389
|
-
```bash
|
|
390
|
-
# Formato
|
|
391
|
-
<tipo>(<escopo>): <descrição>
|
|
392
|
-
|
|
393
|
-
# Tipos
|
|
394
|
-
feat: Nova funcionalidade
|
|
395
|
-
fix: Correção de bug
|
|
396
|
-
perf: Melhoria de performance
|
|
397
|
-
refactor: Refatoração
|
|
398
|
-
docs: Documentação
|
|
399
|
-
chore: Manutenção
|
|
400
|
-
test: Testes
|
|
401
|
-
```
|
|
402
|
-
|
|
403
|
-
## 🔧 Integração com IDEs
|
|
404
|
-
|
|
405
|
-
### Cursor
|
|
406
|
-
|
|
407
|
-
```bash
|
|
408
|
-
# Sincronizar regras
|
|
409
|
-
npx cleudocode-core sync --ide cursor
|
|
410
|
-
```
|
|
411
|
-
|
|
412
|
-
### Claude Code
|
|
413
|
-
|
|
414
|
-
```bash
|
|
415
|
-
# Sincronizar regras
|
|
416
|
-
npx cleudocode-core sync --ide claude
|
|
417
|
-
```
|
|
418
|
-
|
|
419
|
-
### VS Code
|
|
420
|
-
|
|
421
|
-
```bash
|
|
422
|
-
# Instalar extensão
|
|
423
|
-
# Cleudocode Core (em breve)
|
|
424
|
-
```
|
|
278
|
+
- "architect"
|
|
279
|
+
- "dev"
|
|
280
|
+
- "reviewer"
|
|
281
|
+
- "tester"
|
|
282
|
+
default: "dev"
|
|
283
|
+
|
|
284
|
+
quality-gates:
|
|
285
|
+
enabled: true
|
|
286
|
+
checks:
|
|
287
|
+
- lint
|
|
288
|
+
- test
|
|
289
|
+
- security
|
|
290
|
+
- performance
|
|
291
|
+
```
|
|
292
|
+
|
|
293
|
+
## 📈 Performance
|
|
294
|
+
|
|
295
|
+
| Operação | Tempo Médio |
|
|
296
|
+
|----------|-------------|
|
|
297
|
+
| Load Config | < 10ms |
|
|
298
|
+
| Start Session | < 50ms |
|
|
299
|
+
| Generate Function | < 2s |
|
|
300
|
+
| Generate API | < 5s |
|
|
301
|
+
| Full Workflow | < 30s |
|
|
302
|
+
| Code Review (10 files) | < 10s |
|
|
425
303
|
|
|
426
304
|
## 🧪 Quality Gates
|
|
427
305
|
|
|
428
|
-
|
|
429
|
-
# Rodar todos os checks
|
|
430
|
-
npm run lint
|
|
431
|
-
npm run typecheck
|
|
432
|
-
npm test
|
|
433
|
-
npm run build
|
|
434
|
-
```
|
|
435
|
-
|
|
436
|
-
### Configurar CI/CD
|
|
437
|
-
|
|
438
|
-
```yaml
|
|
439
|
-
# .github/workflows/ci.yml
|
|
440
|
-
name: CI
|
|
441
|
-
|
|
442
|
-
on: [push, pull_request]
|
|
443
|
-
|
|
444
|
-
jobs:
|
|
445
|
-
quality:
|
|
446
|
-
runs-on: ubuntu-latest
|
|
447
|
-
steps:
|
|
448
|
-
- uses: actions/checkout@v4
|
|
449
|
-
|
|
450
|
-
- uses: actions/setup-node@v4
|
|
451
|
-
with:
|
|
452
|
-
node-version: '20'
|
|
453
|
-
|
|
454
|
-
- run: npm ci
|
|
455
|
-
- run: npm run lint
|
|
456
|
-
- run: npm run typecheck
|
|
457
|
-
- run: npm test
|
|
458
|
-
- run: npm run build
|
|
459
|
-
```
|
|
460
|
-
|
|
461
|
-
## 🛠️ Troubleshooting
|
|
462
|
-
|
|
463
|
-
### Erro: Node.js versão incompatível
|
|
464
|
-
|
|
465
|
-
```bash
|
|
466
|
-
# Verificar versão
|
|
467
|
-
node --version
|
|
468
|
-
|
|
469
|
-
# Atualizar Node.js
|
|
470
|
-
nvm install 20
|
|
471
|
-
nvm use 20
|
|
472
|
-
```
|
|
473
|
-
|
|
474
|
-
### Erro: .cleudocode-core não encontrado
|
|
475
|
-
|
|
476
|
-
```bash
|
|
477
|
-
# Inicializar no projeto
|
|
478
|
-
npx cleudocode-core init
|
|
479
|
-
```
|
|
480
|
-
|
|
481
|
-
### Erro: Agente não encontrado
|
|
306
|
+
O Cleudocode Core inclui quality gates automáticos:
|
|
482
307
|
|
|
483
308
|
```bash
|
|
484
|
-
#
|
|
485
|
-
|
|
309
|
+
# Executar todos os checks
|
|
310
|
+
cleudocode-core quality-gates run
|
|
486
311
|
|
|
487
|
-
#
|
|
488
|
-
|
|
312
|
+
# Checks individuais
|
|
313
|
+
cleudocode-core lint
|
|
314
|
+
cleudocode-core test
|
|
315
|
+
cleudocode-core security-scan
|
|
316
|
+
cleudocode-core performance-check
|
|
489
317
|
```
|
|
490
318
|
|
|
491
|
-
|
|
492
|
-
|
|
493
|
-
```bash
|
|
494
|
-
# Verificar se está rodando
|
|
495
|
-
ollama list
|
|
496
|
-
|
|
497
|
-
# Iniciar servidor
|
|
498
|
-
ollama serve
|
|
499
|
-
|
|
500
|
-
# Verificar porta
|
|
501
|
-
curl http://localhost:11434/api/tags
|
|
502
|
-
```
|
|
503
|
-
|
|
504
|
-
## 📊 Métricas de Qualidade
|
|
319
|
+
## 🔗 Links
|
|
505
320
|
|
|
506
|
-
|
|
507
|
-
|
|
508
|
-
|
|
509
|
-
|
|
510
|
-
|
|
511
|
-
| Parâmetros por função | < 4 | < 3 |
|
|
321
|
+
- [Documentação Completa](https://github.com/cleudocode/cleudocode-core/docs)
|
|
322
|
+
- [Arquitetura](ARQUITETURA.md)
|
|
323
|
+
- [Exemplos](examples/)
|
|
324
|
+
- [Issues](https://github.com/cleudocode/cleudocode-core/issues)
|
|
325
|
+
- [NPM](https://www.npmjs.com/package/cleudocode-core)
|
|
512
326
|
|
|
513
327
|
## 🤝 Contribuindo
|
|
514
328
|
|
|
515
329
|
1. Fork o projeto
|
|
516
|
-
2. Crie
|
|
517
|
-
3. Commit
|
|
518
|
-
4. Push
|
|
519
|
-
5.
|
|
520
|
-
|
|
521
|
-
### Desenvolvimento Local
|
|
522
|
-
|
|
523
|
-
```bash
|
|
524
|
-
# Clonar repositório
|
|
525
|
-
git clone https://github.com/cleudocode/cleudocode-core.git
|
|
526
|
-
cd cleudocode-core
|
|
527
|
-
|
|
528
|
-
# Instalar dependências
|
|
529
|
-
npm install
|
|
530
|
-
|
|
531
|
-
# Link global para desenvolvimento
|
|
532
|
-
npm link
|
|
533
|
-
|
|
534
|
-
# Usar versão de desenvolvimento
|
|
535
|
-
cleudocode-core --version
|
|
536
|
-
|
|
537
|
-
# Rodar testes
|
|
538
|
-
npm test
|
|
539
|
-
|
|
540
|
-
# Lint
|
|
541
|
-
npm run lint
|
|
542
|
-
|
|
543
|
-
# Formatar
|
|
544
|
-
npm run format
|
|
545
|
-
```
|
|
330
|
+
2. Crie branch: `git checkout -b feature/minha-feature`
|
|
331
|
+
3. Commit: `git commit -m 'feat: adiciona minha feature'`
|
|
332
|
+
4. Push: `git push origin feature/minha-feature`
|
|
333
|
+
5. Pull Request
|
|
546
334
|
|
|
547
335
|
## 📄 Licença
|
|
548
336
|
|
|
549
337
|
MIT - veja o arquivo [LICENSE](LICENSE) para detalhes.
|
|
550
338
|
|
|
551
|
-
## 🔗 Links
|
|
552
|
-
|
|
553
|
-
- [Documentação Completa](https://github.com/cleudocode/cleudocode-core/docs)
|
|
554
|
-
- [Issues](https://github.com/cleudocode/cleudocode-core/issues)
|
|
555
|
-
- [NPM](https://www.npmjs.com/package/cleudocode-core)
|
|
556
|
-
- [Exemplos](https://github.com/cleudocode/cleudocode-core/tree/main/examples)
|
|
557
|
-
|
|
558
|
-
## 📫 Contato
|
|
559
|
-
|
|
560
|
-
- Site: https://cleudocode.com
|
|
561
|
-
- Email: contato@cleudocode.com
|
|
562
|
-
- Discord: https://discord.gg/cleudocode
|
|
563
|
-
|
|
564
339
|
---
|
|
565
340
|
|
|
341
|
+
**Baseado em:** AIOS + AIOX-Core
|
|
342
|
+
**Versão**: 2.0.0
|
|
566
343
|
**Feito com ❤️ pela Cleudocode Team**
|
|
567
|
-
|
|
568
|
-
[](https://github.com/cleudocode/cleudocode-core)
|
package/core/index.js
ADDED
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Cleudocode Core - Módulo Principal
|
|
3
|
+
*
|
|
4
|
+
* Super máquina de criar códigos para desenvolvedores
|
|
5
|
+
* Baseado em AIOS + AIOX-Core
|
|
6
|
+
*
|
|
7
|
+
* @version 2.0.0
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
// Config
|
|
11
|
+
export { ConfigCache, globalConfigCache } from './config/config-cache.js'
|
|
12
|
+
export { configLoader, loadAgentConfig, loadConfigSections } from './config/config-loader.js'
|
|
13
|
+
|
|
14
|
+
// Session
|
|
15
|
+
export { ContextDetector } from './session/context-detector.js'
|
|
16
|
+
export { SessionContextLoader } from './session/context-loader.js'
|
|
17
|
+
|
|
18
|
+
// Elicitation
|
|
19
|
+
export { ElicitationEngine } from './elicitation/elicitation-engine.js'
|
|
20
|
+
export { ElicitationSessionManager } from './elicitation/session-manager.js'
|
|
21
|
+
export { agentElicitationSteps } from './elicitation/agent-elicitation.js'
|
|
22
|
+
export { taskElicitationSteps } from './elicitation/task-elicitation.js'
|
|
23
|
+
export { workflowElicitationSteps } from './elicitation/workflow-elicitation.js'
|
|
24
|
+
|
|
25
|
+
// Orchestration
|
|
26
|
+
export { CleudocodeOrchestrator } from './orchestration/orchestrator.js'
|
|
27
|
+
export { AgentRegistry } from './orchestration/agent-registry.js'
|
|
28
|
+
export { TaskDispatcher } from './orchestration/task-dispatcher.js'
|
|
29
|
+
export { WorkflowEngine } from './orchestration/workflow-engine.js'
|
|
30
|
+
|
|
31
|
+
// Execution
|
|
32
|
+
export { CodeGenerator } from './execution/code-generator.js'
|
|
33
|
+
export { CodeExecutor } from './execution/code-executor.js'
|
|
34
|
+
export { Sandbox } from './execution/sandbox.js'
|
|
35
|
+
|
|
36
|
+
// Memory
|
|
37
|
+
export { ContextManager } from './memory/context-manager.js'
|
|
38
|
+
export { VectorStore } from './memory/vector-store.js'
|
|
39
|
+
export { SessionStore } from './memory/session-store.js'
|
|
40
|
+
|
|
41
|
+
// Registry
|
|
42
|
+
export { ServiceRegistry } from './registry/service-registry.js'
|
|
43
|
+
export { TemplateRegistry } from './registry/template-registry.js'
|
|
44
|
+
|
|
45
|
+
// Quality Gates
|
|
46
|
+
export { CodeReviewer } from './quality-gates/code-reviewer.js'
|
|
47
|
+
export { Linter } from './quality-gates/linter.js'
|
|
48
|
+
export { Tester } from './quality-gates/tester.js'
|
|
49
|
+
export { SecurityScanner } from './quality-gates/security-scanner.js'
|
|
50
|
+
|
|
51
|
+
// Utils
|
|
52
|
+
export { CodeFormatter } from './utils/code-formatter.js'
|
|
53
|
+
export { YAMLValidator } from './utils/yaml-validator.js'
|
|
54
|
+
export { OutputFormatter } from './utils/output-formatter.js'
|
|
55
|
+
|
|
56
|
+
// Doctor
|
|
57
|
+
export { HealthCheck } from './doctor/health-check.js'
|
|
58
|
+
|
|
59
|
+
// Metadata
|
|
60
|
+
export const version = '2.0.0'
|
|
61
|
+
export const moduleName = 'cleudocode-core'
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "cleudocode-core",
|
|
3
|
-
"version": "
|
|
4
|
-
"description": "Cleudocode Core -
|
|
3
|
+
"version": "2.0.0",
|
|
4
|
+
"description": "Cleudocode Core - Super Máquina de Criar Códigos baseada em AIOS + AIOX-Core",
|
|
5
5
|
"author": "Cleudocode Team",
|
|
6
6
|
"license": "MIT",
|
|
7
7
|
"keywords": [
|
|
@@ -12,10 +12,19 @@
|
|
|
12
12
|
"cli",
|
|
13
13
|
"automation",
|
|
14
14
|
"development",
|
|
15
|
-
"llm"
|
|
15
|
+
"llm",
|
|
16
|
+
"code-generation",
|
|
17
|
+
"aios",
|
|
18
|
+
"aiox-core"
|
|
16
19
|
],
|
|
17
20
|
"type": "module",
|
|
18
|
-
"main": "
|
|
21
|
+
"main": "core/index.js",
|
|
22
|
+
"exports": {
|
|
23
|
+
".": {
|
|
24
|
+
"import": "./core/index.js",
|
|
25
|
+
"require": "./core/index.esm.js"
|
|
26
|
+
}
|
|
27
|
+
},
|
|
19
28
|
"bin": {
|
|
20
29
|
"cleudocode": "./bin/cleudocode.js",
|
|
21
30
|
"cleudocode-core": "./bin/cleudocode.js",
|