aiteam-x 0.8.1

package/README.md

@@ -0,0 +1,397 @@
+# AITeam Team Overview
+
+**Painel visual em estilo pixel art para orquestrar e monitorar agentes BMAD em tempo real.**
+
+[![Next.js](https://img.shields.io/badge/Next.js-15-black?logo=next.js)](https://nextjs.org/)
+[![React](https://img.shields.io/badge/React-19-61dafb?logo=react)](https://react.dev/)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5-3178c6?logo=typescript)](https://www.typescriptlang.org/)
+[![BMAD Method](https://img.shields.io/badge/BMAD-Method-ff6b6b)](https://github.com/bmad-method)
+[![License](https://img.shields.io/badge/License-Proprietary-red)]()
+
+---
+
+## Visao Geral
+
+O **AITeam Team Overview** e um dashboard interativo que transforma a gestao de agentes de IA em uma experiencia visual e intuitiva. Inspirado em jogos de simulacao tipo *sim manager*, o painel exibe agentes BMAD como personagens pixel art em um escritorio virtual, permitindo:
+
+- **Visualizar** o status e a localizacao de cada agente em tempo real
+- **Interagir** diretamente com agentes atraves de janelas de chat integradas
+- **Orquestrar** workflows como Party Mode e brainstorming sessions
+- **Monitorar** metricas de uso (mensagens, tokens in/out) por agente
+- **Persistir** contexto e memorias entre sessoes de trabalho com extracao via LLM
+
+O projeto utiliza o **BMAD Method** como framework de agentes, integrando-se nativamente com o **Cursor Agent CLI** para comunicacao bidirecional com LLMs.
+
+---
+
+## Screenshots
+
+### Dashboard Principal
+
+![Dashboard Principal](docs/screenshots/05-dashboard-clean.png)
+
+*Escritorio virtual com Jarvis Office, Kitchen e workspaces individuais. Barra inferior com avatares e progresso do sprint (14/14 — 100%).*
+
+---
+
+### Janela de Chat com Agente
+
+![Chat com Agente](docs/screenshots/03-chat-window.png)
+
+*Janela de conversa com BMad Master em tempo real. Cada agente responde com streaming de texto e suporte a Markdown.*
+
+---
+
+### Memory Vault
+
+![Memory Vault](docs/screenshots/02-memory-vault.png)
+
+*Painel de gerenciamento de memorias por agente. Categorias: decisions, lessons, tasks, projects, handoffs. Busca BM25 em tempo real.*
+
+---
+
+### Filtros de Agentes
+
+![Filtros](docs/screenshots/04-filters.png)
+
+*Filtros de Status (Todos / Trabalhando) e Modulo (BMGD / BMM / CORE) para visualizacao segmentada dos agentes.*
+
+---
+
+## Funcionalidades Principais
+
+### Dashboard Pixel Art
+- Salas compartilhadas: **Jarvis Office**, **Kitchen** — com contexto de atividade dos agentes
+- Grid de workspaces individuais por agente com indicadores de modulo (BMGD / BMM / CORE)
+- Avatares pixel art com status visual em tempo real
+- Barra inferior com avatares compactos e timeline do sprint com progresso granular por story
+- Ciclo dia/noite e efeitos de ambiente
+
+### Interacao com Agentes
+- Selecao de agente (click) ou multi-selecao (Ctrl+click) para comandos em lote
+- Janelas de conversa redimensionaveis com streaming SSE em tempo real
+- Bubble de "pensando" animado durante processamento
+- Rendering completo de Markdown nas respostas
+- Botao de stop para cancelar processamento em andamento
+- Historico de conversa persistido entre reloads
+- Sistema de z-index dinamico (bring-to-front ao clicar)
+- Selecao e copia de texto dentro das janelas
+
+### Seletor de Modelo e Filtros
+- **Model Bar**: selecao do modelo LLM aplicado a todos os agentes (Padrao do Cursor, Claude Sonnet, etc.)
+- **Filtro de Status**: Todos / Trabalhando — exibe contador em tempo real (ex: 14/14)
+- **Filtro de Modulo**: BMGD / BMM / CORE — segmenta agentes por area de atuacao
+
+### Orquestracao BMAD
+- Deteccao automatica de Party Mode e workflows ativos
+- Agentes se movem dinamicamente para salas conforme o workflow
+- Sessao de estado persistida em disco e sincronizada via SSE
+- Metricas de mensagens e tokens por agente
+
+### Sistema de Memoria Persistente (v2.1)
+- **Memory Vault**: painel visual completo com 5 categorias (decisions, lessons, tasks, projects, handoffs)
+- **Auto-extract via LLM**: ao fechar uma sessao, o sistema analisa a conversa e extrai memorias estruturadas automaticamente
+- **Badge 🤖 llm**: entradas extraidas automaticamente ficam marcadas por 10 minutos com opcao de veto
+- **Busca BM25**: busca semantica por relevancia dentro do vault de cada agente
+- **Injecao de contexto**: memorias relevantes injetadas automaticamente ao iniciar novas sessoes (budget de 2.000 tokens)
+- **Auto-save**: conversas salvas a cada 30s + save on unload via `sendBeacon`
+- **Checkpoint de sessao**: historico preservado mesmo em reinicios inesperados
+- **Memoria compartilhada**: `_project.md` injetado em todos os agentes como contexto global
+
+### Portabilidade e Instalacao (v1.0)
+- **Discovery dinamico**: detecta agentes BMAD automaticamente via CSV/YAML — sem hardcode
+- **Cross-platform**: funciona em Windows, macOS e Linux
+- **Wizard de setup web**: `/setup` no browser — 3 fases animadas: scan da maquina, revisao, configuracao passo a passo
+- **Wizard de setup CLI**: `npm run setup` — alternativa interativa no terminal (6 passos)
+- **Health gate**: se nao configurado, redireciona para `/setup` automaticamente
+- **Config flexivel**: `aiteam.config.json` local + `AITEAM_BMAD_ROOT` para instancias externas/CI
+
+---
+
+## Stack Tecnologico
+
+| Camada | Tecnologia | Versao |
+|--------|-----------|--------|
+| Framework | Next.js (App Router) | 15.x |
+| UI | React | 19.x |
+| Linguagem | TypeScript | 5.x |
+| Estilo | CSS custom (pixel art design system) | — |
+| Fonte | VT323 (Google Fonts) | — |
+| Backend | Next.js API Routes + SSE | — |
+| Busca | MiniSearch (BM25) | — |
+| Agentes | Cursor Agent CLI | latest |
+| Parsing | yaml (npm) | 2.8.x |
+| Framework de Agentes | BMAD Method | — |
+
+---
+
+## Inicio Rapido
+
+### Pre-requisitos
+
+| Requisito | Obrigatorio | Notas |
+|-----------|-------------|-------|
+| Node.js >= 18 | Sim | `node --version` |
+| BMAD Framework | Sim | Ver [Guia de Instalacao](docs/installation-guide.md) |
+| Cursor IDE | Sim | Gera o Cursor Agent CLI na primeira abertura |
+| Git | Sim | — |
+
+> **Plataformas suportadas:** Windows 10/11, macOS, Linux
+
+### Instalacao
+
+**Opcao 1 — Um comando (recomendado):**
+
+```bash
+npx aiteam-x@latest
+```
+
+Cria o projeto no diretorio atual (deve estar vazio). Ou especifique o nome da pasta:
+
+```bash
+npx aiteam-x@latest meu-projeto
+```
+
+O comando baixa o template, instala dependencias, executa o wizard de configuracao e inicia o servidor automaticamente.
+
+**Opcao 2 — Instalacao manual:**
+
+```bash
+# 1. Clonar o repositorio
+git clone https://github.com/INOSX/AITeam.git
+cd AITeam
+
+# 2. Instalar dependencias
+npm install
+
+# 3. Executar wizard de configuracao
+npm run setup
+
+# 4. Iniciar o servidor de desenvolvimento
+npm run dev
+```
+
+O painel estara disponivel em **http://localhost:3000**.
+
+> Se o setup nao foi concluido, o sistema redireciona automaticamente para `http://localhost:3000/setup` — um wizard animado que detecta o ambiente, mostra o que esta pronto e permite configurar tudo pelo browser.
+
+> **Alternativa CLI:** `npm run setup` executa o wizard interativo no terminal.
+
+### Scripts Disponiveis
+
+| Comando | Descricao |
+|---------|-----------|
+| `npm run setup` | **Wizard interativo de configuracao** (primeira instalacao) |
+| `npm run dev` | Inicia o servidor de desenvolvimento (porta 3000) |
+| `npm run build` | Gera o build de producao |
+| `npm run start` | Inicia o servidor de producao |
+| `npm run lint` | Executa o linter (ESLint) |
+
+### Scripts Utilitarios
+
+| Script | Descricao |
+|--------|-----------|
+| `node scripts/extract-memories.mjs --all` | Extrai memorias de conversas historicas via LLM |
+| `node scripts/extract-memories.mjs --agent bmad-master` | Extrai memorias de um agente especifico |
+| `node scripts/extract-memories.mjs --all --dry-run` | Simula extracao sem salvar |
+| `node scripts/import-conversations.mjs` | Importa historico de conversas para o vault |
+
+> Todos os scripts requerem o servidor rodando em `localhost:3000`.
+
+---
+
+## Estrutura do Projeto
+
+```
+AITeam/
+├── app/                          # Next.js App Router
+│   ├── api/                      # API Routes (backend)
+│   │   ├── agents/
+│   │   │   ├── route.ts          # GET: lista agentes com status
+│   │   │   └── command/route.ts  # POST: envia comando via SSE
+│   │   ├── config/route.ts       # GET: configuracao BMAD
+│   │   ├── memory/
+│   │   │   ├── route.ts          # GET/POST: memoria e conversas (legado)
+│   │   │   ├── vault/route.ts    # GET/POST/PUT/DELETE: vault estruturado
+│   │   │   ├── search/route.ts   # GET: busca BM25
+│   │   │   ├── checkpoint/route.ts # POST: checkpoint de sessao
+│   │   │   ├── sleep/route.ts    # POST: encerra sessao + enfileira extracao LLM
+│   │   │   └── extract/route.ts  # POST: trigger manual de extracao LLM
+│   │   ├── session/
+│   │   │   ├── route.ts          # GET/POST: sessao ativa
+│   │   │   └── stream/route.ts   # GET: SSE de mudancas de sessao
+│   │   ├── sprint/route.ts       # GET/POST: status do sprint
+│   │   └── workflows/route.ts    # GET: workflows disponiveis
+│   ├── actions/
+│   │   └── setup-save.ts         # Server Action: salva aiteam.config.json
+│   ├── setup/
+│   │   ├── page.tsx              # Pagina de setup (health gate + Server Component)
+│   │   └── SetupWizard.tsx       # Wizard animado 3 fases (Client Component)
+│   ├── globals.css               # Design system pixel art (800+ linhas)
+│   ├── layout.tsx                # Root layout (VT323, pt-BR)
+│   ├── error.tsx                 # Error boundary
+│   └── page.tsx                  # Pagina principal (health gate)
+│
+├── components/                   # Componentes React
+│   ├── rooms/                    # Salas do escritorio virtual
+│   │   ├── ConferenceRoom.tsx
+│   │   ├── JarvisOffice.tsx
+│   │   └── Kitchen.tsx
+│   ├── AgentsProvider.tsx        # Context Provider global
+│   ├── CommandPopup.tsx          # Popup multi-agente
+│   ├── FilterContext.tsx         # Context de filtros (status + modulo)
+│   ├── Layout.tsx                # Shell (TopBar + ModelBar + BottomBar)
+│   ├── MainContent.tsx           # Orquestrador principal (~500 linhas)
+│   ├── MarkdownRenderer.tsx      # Renderer custom de Markdown
+│   ├── MemoryVault.tsx           # Dashboard do Memory Vault (modal)
+│   ├── ModelBar.tsx              # Barra de selecao de modelo e filtros
+│   ├── PixelAvatar.tsx           # Avatar SVG pixel art
+│   ├── SpeechBubbleOverlay.tsx   # Sistema de chat overlay
+│   ├── ThinkingBubble.tsx        # Indicador de pensamento animado
+│   ├── WorkspaceCell.tsx         # Celula de workspace individual
+│   └── WorkspaceGrid.tsx         # Grid de workspaces
+│
+├── lib/                          # Logica de negocio e utilitarios
+│   ├── aiteam-config.ts          # Config loader (env var > arquivo > defaults)
+│   ├── health.ts                 # Health check: BMAD, Cursor CLI, config
+│   ├── setup-discovery.ts        # Discovery ampliado para o wizard web
+│   ├── bmad/                     # Integracao BMAD
+│   │   ├── discovery.ts          # Scanner dinamico BMAD + deteccao Cursor CLI
+│   │   ├── agent-mapping.ts      # Mapeamento BmadAgent -> Agent
+│   │   ├── chat-sessions.ts      # Persistencia de sessoes de chat
+│   │   ├── parse-agents.ts       # Parser do agent-manifest.csv
+│   │   ├── parse-config.ts       # Parser do config.yaml
+│   │   ├── parse-persona.ts      # Parser de persona (.mdc)
+│   │   ├── parse-session.ts      # Estado de sessao + SSE
+│   │   ├── parse-sprint.ts       # Parser do sprint-status.yaml
+│   │   └── parse-workflows.ts    # Parser de workflows
+│   ├── memory/                   # Sistema de memoria v2
+│   │   ├── extract.ts            # Motor de extracao LLM
+│   │   ├── inject.ts             # Injecao de contexto (BM25 + budget)
+│   │   ├── session.ts            # Ciclo de vida de sessao (sleep/recover)
+│   │   ├── types.ts              # Tipos do sistema de memoria
+│   │   └── vault.ts              # CRUD do vault estruturado
+│   ├── model-config.ts           # Opcoes de modelos LLM disponiveis
+│   └── types.ts                  # Tipos TypeScript globais
+│
+├── .memory/                      # Memory Bank (persistente, gitignored)
+│   ├── _project.md               # Contexto global — injetado em todos agentes
+│   ├── {agent-id}.md             # Memory bank individual por agente
+│   ├── conversations/            # Historico de conversas (JSON)
+│   └── .vault/                   # Vault estruturado e fila de extracao
+│
+├── docs/                         # Documentacao do projeto
+│   ├── screenshots/              # Screenshots da interface
+│   ├── installation-guide.md     # Guia completo de instalacao
+│   ├── architecture.md           # Arquitetura do sistema
+│   ├── api-reference.md          # Referencia completa da API
+│   ├── developer-guide.md        # Guia do desenvolvedor
+│   ├── user-guide.md             # Guia do usuario final
+│   ├── memory-system.md          # Arquitetura tecnica do sistema de memoria
+│   ├── memory-system-guide.md    # Guia funcional do sistema de memoria
+│   ├── agent-catalog.md          # Catalogo completo dos agentes BMAD
+│   └── sprint-status.yaml        # Status do sprint atual
+│
+├── scripts/                      # Scripts utilitarios
+│   ├── setup.mjs                 # Wizard de configuracao interativo (6 passos)
+│   ├── extract-memories.mjs      # Extracao em lote via LLM
+│   └── import-conversations.mjs  # Importacao de historico para o vault
+│
+├── aiteam.config.example.json    # Exemplo de configuracao (referencia)
+├── .cursor/                      # Regras e skills do Cursor IDE
+│   └── rules/bmad/               # Regras BMAD (.mdc): agentes e workflows
+│
+├── package.json
+├── tsconfig.json
+├── next.config.ts
+└── .gitignore
+```
+
+---
+
+## Documentacao
+
+| Documento | Nivel | Descricao |
+|-----------|-------|-----------|
+| [Guia de Instalacao](docs/installation-guide.md) | Iniciante | Instalacao passo a passo, wizard de setup, solucao de problemas |
+| [Arquitetura](docs/architecture.md) | Tecnico/Arquitetural | Diagramas, fluxos de dados, decisoes de design |
+| [Referencia da API](docs/api-reference.md) | Tecnico | Endpoints, parametros, exemplos de request/response |
+| [Guia do Desenvolvedor](docs/developer-guide.md) | Desenvolvedor | Setup, convencoes, como contribuir |
+| [Guia do Usuario](docs/user-guide.md) | Usuario Final | Como usar o painel, interagir com agentes, Memory Vault |
+| [Sistema de Memoria (tecnico)](docs/memory-system.md) | Tecnico/Conceitual | Arquitetura em camadas do sistema de memoria |
+| [Guia de Memoria (funcional)](docs/memory-system-guide.md) | Usuario Final | Como usar o Memory Vault, estudos de caso, boas praticas |
+| [Catalogo de Agentes](docs/agent-catalog.md) | Referencia | Todos os agentes, especialidades e como trabalhar com cada um |
+
+---
+
+## Agentes BMAD
+
+O sistema descobre agentes automaticamente a partir do `bmad/_cfg/agent-manifest.csv`. A instalacao padrao inclui 14 agentes:
+
+| Persona | Papel | Modulo |
+|---------|-------|--------|
+| **BMad Master** | Orquestrador principal, custodio de conhecimento | core |
+| **BMad Builder** | Criacao de modulos, agentes e workflows BMAD | core |
+| **Mary** | Business Analyst — pesquisa e requisitos de negocio | bmm |
+| **John** | Product Manager — PRD, epicos, gestao de produto | bmm |
+| **Winston** | Architect — arquitetura de sistemas e tech spec | bmm |
+| **Sally** | UX Designer — design de experiencia e interface | bmm |
+| **Bob** | Scrum Master — sprint planning e revisao de codigo | bmm |
+| **Amelia** | Developer — implementacao de stories e features | bmm |
+| **Murat** | Test Architect — estrategia e design de testes | bmm |
+| **Paige** | Tech Writer — documentacao tecnica e knowledge | bmm |
+| **Cloud Dragonborn** | Game Architect — arquitetura e sistemas de jogo | bmgd |
+| **Samus Shepard** | Game Designer — GDD, narrativa e design de jogo | bmgd |
+| **Link Freeman** | Game Developer — implementacao de jogo | bmgd |
+| **Max** | Game Scrum Master — gestao agil para game dev | bmgd |
+
+> Consulte o [Catalogo de Agentes](docs/agent-catalog.md) para detalhes sobre especialidades e comandos de cada agente.
+
+---
+
+## Configuracao
+
+O AITEAM-X usa um arquivo `aiteam.config.json` local (gitignored) gerado pelo `npm run setup`. Para configuracao avancada, crie um `.env.local`:
+
+```env
+# Caminho alternativo para a instalacao BMAD
+# Util para: BMAD em outro diretorio, CI/CD, multiplos projetos
+AITEAM_BMAD_ROOT=/caminho/para/seu/projeto-bmad
+
+# Sobrescreve o diretorio de memoria (util para testes)
+MEMORY_DIR_OVERRIDE=/caminho/customizado/.memory
+```
+
+**Prioridade de configuracao para `bmadRoot`:**
+```
+AITEAM_BMAD_ROOT (env var)  >  aiteam.config.json  >  "./" (padrao)
+```
+
+Consulte o [Guia de Instalacao](docs/installation-guide.md) para todos os cenarios de configuracao.
+
+---
+
+## Contribuindo
+
+1. Crie uma branch a partir de `develop`
+2. Faca suas alteracoes seguindo as convencoes do projeto
+3. Certifique-se de que `npm run lint` e `npm run build` passam
+4. Abra um Pull Request para `develop`
+
+Consulte o [Guia do Desenvolvedor](docs/developer-guide.md) para detalhes.
+
+---
+
+## Licenca
+
+Projeto proprietario — **INOSX, Inc.** Todos os direitos reservados.
+
+---
+
+## Autor
+
+**Mario Mayerle (MaMFLux)** — [INOSX](https://inosx.com)
+
+---
+
+*Construido com o BMAD Method — onde agentes de IA trabalham como um time.*

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "aiteam-x",
+  "version": "0.8.1",
+  "description": "Painel pixel art para orquestrar agentes BMAD em tempo real",
+  "keywords": [
+    "bmad",
+    "ai",
+    "agents",
+    "cursor",
+    "dashboard"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/INOSX/AITeam.git"
+  },
+  "license": "UNLICENSED",
+  "private": false,
+  "files": [
+    "scripts/cli.mjs"
+  ],
+  "bin": {
+    "aiteam-x": "./scripts/cli.mjs"
+  },
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "next lint",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "setup": "node scripts/setup.mjs"
+  },
+  "dependencies": {
+    "@react-three/drei": "^10.7.7",
+    "@react-three/fiber": "^9.5.0",
+    "minisearch": "^7.2.0",
+    "next": "^15.0.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0",
+    "three": "^0.183.2",
+    "three-pathfinding": "^1.3.0",
+    "yaml": "^2.8.2"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "@vitest/coverage-v8": "^4.1.0",
+    "eslint": "^9",
+    "eslint-config-next": "^15.0.0",
+    "typescript": "^5",
+    "vitest": "^4.1.0"
+  }
+}

package/scripts/cli.mjs

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+/**
+ * AITEAM-X CLI — Instalação simplificada via npx
+ *
+ * Uso:
+ *   npx aiteam-x@latest           → cria no diretório atual
+ *   npx aiteam-x@latest meu-projeto → cria em meu-projeto/
+ *
+ * Fluxo: degit (baixa template) → npm install → npm run setup → npm run dev
+ */
+
+import { execSync, spawn } from "child_process";
+import fs from "fs";
+import path from "path";
+import { fileURLToPath } from "url";
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const REPO = "INOSX/AITeam";
+
+const C = {
+  green: (s) => `\x1b[32m${s}\x1b[0m`,
+  yellow: (s) => `\x1b[33m${s}\x1b[0m`,
+  cyan: (s) => `\x1b[36m${s}\x1b[0m`,
+  bold: (s) => `\x1b[1m${s}\x1b[0m`,
+  dim: (s) => `\x1b[2m${s}\x1b[0m`,
+};
+
+function isDirEmpty(dir) {
+  if (!fs.existsSync(dir)) return true;
+  const entries = fs.readdirSync(dir);
+  return entries.length === 0;
+}
+
+function main() {
+  const targetDir = process.argv[2] || ".";
+  const cwd = process.cwd();
+  const absTarget = path.resolve(cwd, targetDir);
+
+  console.log("\n" + C.bold(C.cyan("╔══════════════════════════════════╗")));
+  console.log(C.bold(C.cyan("║  AITEAM-X — Instalação rápida       ║")));
+  console.log(C.bold(C.cyan("╚══════════════════════════════════╝")) + "\n");
+
+  // Se diretório atual, verificar se está vazio
+  if (targetDir === "." && !isDirEmpty(cwd)) {
+    console.log(C.yellow("  O diretório atual não está vazio."));
+    console.log(C.dim("  Use: npx aiteam-x@latest nome-do-projeto"));
+    console.log(C.dim("  Ou crie uma pasta vazia e execute o comando dentro dela.\n"));
+    process.exit(1);
+  }
+
+  if (targetDir !== "." && fs.existsSync(absTarget) && !isDirEmpty(absTarget)) {
+    console.log(C.yellow(`  O diretório "${targetDir}" já existe e não está vazio.\n`));
+    process.exit(1);
+  }
+
+  try {
+    // 1. Baixar template via degit
+    console.log(C.bold("1. Baixando template AITEAM-X..."));
+    execSync(`npx degit@latest ${REPO} ${targetDir}`, {
+      stdio: "inherit",
+      cwd,
+    });
+    console.log(C.green("   ✓ Template baixado\n"));
+
+    // 2. npm install
+    console.log(C.bold("2. Instalando dependências..."));
+    execSync("npm install", {
+      stdio: "inherit",
+      cwd: absTarget,
+    });
+    console.log(C.green("   ✓ Dependências instaladas\n"));
+
+    // 3. npm run setup
+    console.log(C.bold("3. Executando wizard de configuração..."));
+    execSync("npm run setup", {
+      stdio: "inherit",
+      cwd: absTarget,
+    });
+    console.log(C.green("   ✓ Configuração concluída\n"));
+
+    // 4. Iniciar servidor
+    console.log(C.bold("4. Iniciando servidor de desenvolvimento..."));
+    console.log(C.dim("   Acesse http://localhost:3000 quando estiver pronto.\n"));
+
+    const child = spawn("npm", ["run", "dev"], {
+      stdio: "inherit",
+      cwd: absTarget,
+      shell: true,
+    });
+
+    child.on("error", (err) => {
+      console.error(C.yellow("Erro ao iniciar:"), err);
+      process.exit(1);
+    });
+
+    child.on("exit", (code) => {
+      process.exit(code ?? 0);
+    });
+  } catch (err) {
+    if (err.status !== undefined) process.exit(err.status);
+    console.error("\n" + C.yellow("Erro:"), err.message);
+    process.exit(1);
+  }
+}
+
+main();