@evolve.labs/devflow 0.8.0

package/.gitignore-template

@@ -0,0 +1,84 @@
+# DevFlow .gitignore
+
+# Node modules (se usar JavaScript/TypeScript)
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Local settings (não distribuir)
+*.local.json
+settings.local.json
+
+# IDE específicos
+.vscode/*
+!.vscode/settings.json
+!.vscode/tasks.json
+!.vscode/launch.json
+!.vscode/extensions.json
+.idea/
+*.swp
+*.swo
+*~
+
+# OS específicos
+.DS_Store
+Thumbs.db
+
+# Build outputs
+dist/
+build/
+*.tsbuildinfo
+
+# Logs
+logs/
+*.log
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+
+# Python (se usar)
+__pycache__/
+*.py[cod]
+*$py.class
+.Python
+venv/
+env/
+
+# Arquivos grandes ou sensíveis
+*.zip
+*.tar.gz
+*.rar
+
+# Mantenha estas pastas (não ignore)
+# Importante: queremos versionar a documentação!
+!.devflow/
+!docs/
+!planning/
+!architecture/
+!CHANGELOG.md
+
+# Snapshots podem ser grandes, você decide se quer versionar
+# Descomente a linha abaixo se NÃO quiser versionar snapshots:
+# docs/snapshots/*.json
+
+# DevFlow Development (não incluir no release)
+build-release.sh  # Script de build fica apenas no dev
+
+# Web IDE build artifacts (users run npm install themselves)
+web/.next/
+web/node_modules/
+web/CHANGELOG.md
+web/README.md
+
+# Releases geradas (versionadas separadamente)
+# Mantenha release/ versionado para distribuição
+!release/
+web/.devflow/

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Evolve Labs
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,249 @@
+# DevFlow v0.7.0 - Sistema Multi-Agentes + Web IDE
+
+Sistema de multi-agentes especializados para desenvolvimento de software, com **6 agentes** e **Web IDE** integrada.
+
+[![Version](https://img.shields.io/badge/version-0.7.0-blue.svg)](docs/CHANGELOG.md)
+[![npm](https://img.shields.io/npm/v/devflow-agents.svg)](https://www.npmjs.com/package/devflow-agents)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+
+## Screenshots
+
+![DevFlow Hero](docs/images/hero.png)
+
+![Dashboard](docs/images/dashboard.png)
+
+![Editor](docs/images/editor.png)
+
+![Terminal](docs/images/terminal.png)
+
+![Specs Panel](docs/images/specs.png)
+
+---
+
+## 🆕 Novidades v0.7.0
+
+### System Designer Agent (6th agent)
+- System Design Documents (SDDs) com back-of-the-envelope calculations
+- RFCs, capacity planning, trade-off analysis
+- SLA/SLO/SLI definitions e reliability patterns
+
+### npm Package
+- `npx devflow-agents init` para instalacao rapida
+- `devflow update` para atualizacoes
+- Flag `--web` para incluir Web IDE
+
+### Web IDE (Opcional)
+Interface visual completa para gerenciar seu projeto DevFlow:
+
+- **Terminal Integrado** - Interface principal via xterm.js + node-pty
+- **Dashboard** - Metricas do projeto, health check, status dos agentes
+- **Specs Panel** - Visualize requirements, design decisions e tasks
+- **File Explorer** - Navegue pelo codigo com preview de markdown/mermaid
+- **Editor Monaco** - Editor profissional com syntax highlighting
+- **Settings** - Configure tema, fonte, terminal
+
+---
+
+## 🚀 Instalacao
+
+### Via npm (Recomendado)
+
+```bash
+# Instala DevFlow no seu projeto (sem instalar nada globalmente)
+npx devflow-agents init
+
+# Ou instale globalmente para usar em multiplos projetos
+npm install -g devflow-agents
+devflow init /caminho/para/seu-projeto
+
+# Opcoes de instalacao
+devflow init                    # Agentes + estrutura de docs (padrao)
+devflow init --agents-only      # Apenas agentes (minimo)
+devflow init --full             # Tudo incluindo .gitignore
+devflow init --web              # Inclui Web IDE (opcional)
+devflow init --full --web       # Tudo + Web IDE
+
+# Atualizar instalacao existente
+devflow update
+```
+
+### Via bash script (Alternativa)
+
+```bash
+git clone https://github.com/evolve-labs-cloud/devflow.git
+cd devflow
+./install.sh /caminho/para/seu-projeto
+```
+
+### Requisitos
+
+- **Claude Code CLI** (`npm i -g @anthropic-ai/claude-code`)
+- **Node.js 18+** (para o CLI npm)
+- **Git** (recomendado)
+
+### Dependências por Sistema
+
+#### Debian/Ubuntu
+```bash
+sudo apt-get update
+sudo apt-get install -y build-essential python3 git
+curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
+sudo apt-get install -y nodejs
+npm install -g @anthropic-ai/claude-code
+```
+
+#### Fedora
+```bash
+sudo dnf groupinstall -y "Development Tools"
+sudo dnf install -y python3 git nodejs npm
+npm install -g @anthropic-ai/claude-code
+```
+
+#### RHEL/CentOS/Rocky
+```bash
+sudo dnf groupinstall -y "Development Tools"
+sudo dnf install -y python3 git
+curl -fsSL https://rpm.nodesource.com/setup_20.x | sudo bash -
+sudo dnf install -y nodejs
+npm install -g @anthropic-ai/claude-code
+```
+
+#### macOS
+```bash
+xcode-select --install
+brew install node
+npm install -g @anthropic-ai/claude-code
+```
+
+#### Windows (WSL)
+```powershell
+# PowerShell como Admin
+wsl --install
+```
+Depois siga as instruções de Debian/Ubuntu no terminal WSL.
+
+### Web IDE (Opcional)
+```bash
+cd devflow/web
+npm install
+npm run dev
+# Acesse http://localhost:3000
+```
+
+---
+
+## 🤖 Os 6 Agentes
+
+| # | Agente | Funcao | Uso |
+|---|--------|--------|-----|
+| 1 | **/agents:strategist** | Planejamento & Produto | Requisitos, PRDs, user stories |
+| 2 | **/agents:architect** | Design & Arquitetura | Decisoes tecnicas, ADRs, APIs |
+| 3 | **/agents:system-designer** | System Design & Escala | SDDs, RFCs, capacity planning, SLOs |
+| 4 | **/agents:builder** | Implementacao | Codigo, reviews, refactoring |
+| 5 | **/agents:guardian** | Qualidade & Seguranca | Testes, security, performance |
+| 6 | **/agents:chronicler** | Documentacao & Memoria | CHANGELOG, snapshots, stories |
+
+### Fluxo de Trabalho
+
+```
+strategist → architect → system-designer → builder → guardian → chronicler
+```
+
+Cada agente tem **hard stops** — limites rigidos que impedem de fazer trabalho de outros agentes.
+
+---
+
+## 🖥️ Web IDE Features
+
+### Dashboard
+- Métricas do projeto (specs, decisões, tasks)
+- Health check (Claude CLI, .devflow, git)
+- Status em tempo real
+
+### Specs Panel
+- **Requirements** - User stories com acceptance criteria
+- **Design** - Architecture Decision Records (ADRs)
+- **Tasks** - Tarefas de implementação
+
+### Editor
+- Monaco Editor (VS Code engine)
+- Syntax highlighting para 50+ linguagens
+- Preview de Markdown com Mermaid diagrams
+- Múltiplas tabs com indicador de dirty state
+
+### Terminal
+- Terminal integrado via xterm.js + node-pty
+- WebGL rendering para displays de alta resolução
+- Histórico de comandos
+- Resize responsivo
+
+---
+
+## 📁 Estrutura do Projeto
+
+```
+devflow/
+├── .claude/            # Comandos e agentes
+│   └── commands/       # Skills dos 6 agentes
+│       └── agents/     # Definições dos agentes
+│
+├── .devflow/           # Configuração do projeto
+│   ├── snapshots/      # Histórico do projeto
+│   └── project.yaml    # Estado do projeto
+│
+├── docs/               # Documentação
+│   ├── decisions/      # ADRs
+│   ├── planning/       # Stories e specs
+│   └── images/         # Screenshots
+│
+└── web/                # Web IDE
+    ├── app/            # Next.js pages
+    ├── components/     # React components
+    └── lib/            # Utilities
+```
+
+---
+
+## 📊 Versões
+
+| Versão | Features |
+|--------|----------|
+| v0.1.0 | Multi-agent system, Documentation automation |
+| v0.2.0 | Structured metadata, Knowledge graph |
+| v0.3.0 | Hard stops, Mandatory delegation |
+| v0.4.0 | Web IDE completa |
+| v0.5.0 | Terminal como interface principal, WSL support |
+| v0.6.0 | Permission mode configuration |
+| **v0.7.0** | **System Designer agent (6th), npm package, token optimization** |
+
+---
+
+## 📚 Documentação
+
+- **[Quick Start](docs/QUICKSTART.md)** - Comece em 5 minutos
+- **[Instalação](docs/INSTALLATION.md)** - Guia detalhado
+- **[Arquitetura](docs/ARCHITECTURE.md)** - Como funciona
+- **[Changelog](docs/CHANGELOG.md)** - Histórico de mudanças
+
+---
+
+## 🛠️ Tech Stack (Web IDE)
+
+- **Next.js 15** - Framework React
+- **TypeScript** - Type safety
+- **Tailwind CSS** - Styling
+- **Monaco Editor** - Code editing
+- **xterm.js** - Terminal emulator
+- **node-pty** - PTY para terminal real
+- **Zustand** - State management
+- **Lucide Icons** - Iconografia
+
+---
+
+## 📜 Licença
+
+MIT License - veja [LICENSE](LICENSE) para detalhes.
+
+---
+
+**DevFlow v0.7.0** - Desenvolvido por [Evolve Labs](https://evolvelabs.cloud)

package/bin/devflow.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+
+const { Command } = require('commander');
+const { VERSION } = require('../lib/constants');
+const { initCommand } = require('../lib/init');
+const { updateCommand } = require('../lib/update');
+const { webCommand } = require('../lib/web');
+const { autopilotCommand } = require('../lib/autopilot');
+
+const program = new Command();
+
+program
+  .name('devflow')
+  .description('DevFlow - Multi-agent system for software development with Claude Code')
+  .version(VERSION, '-v, --version');
+
+program
+  .command('init')
+  .description('Initialize DevFlow in a project directory')
+  .argument('[path]', 'target project directory', '.')
+  .option('--agents-only', 'install only agents (minimal setup)')
+  .option('--full', 'full installation including .gitignore')
+  .option('--web', 'include Web IDE source files')
+  .option('-f, --force', 'overwrite existing installation without asking')
+  .option('--skip-deps', 'skip dependency checking')
+  .action(initCommand);
+
+program
+  .command('update')
+  .description('Update an existing DevFlow installation')
+  .argument('[path]', 'target project directory', '.')
+  .option('-f, --force', 'update without confirmation')
+  .action(updateCommand);
+
+program
+  .command('web')
+  .description('Start the DevFlow Web Dashboard')
+  .option('-p, --port <port>', 'port number', '3000')
+  .option('--project <path>', 'initial project path (defaults to current directory)')
+  .option('--dev', 'run in development mode')
+  .option('--no-open', 'do not open browser automatically')
+  .action(webCommand);
+
+program
+  .command('autopilot')
+  .description('Run autopilot agents on a spec file')
+  .argument('<spec-file>', 'path to the spec markdown file')
+  .option('--phases <list>', 'comma-separated agent IDs to run', 'strategist,architect,system-designer,builder,guardian,chronicler')
+  .option('--project <path>', 'project directory (default: current directory)')
+  .option('--no-update', 'do not auto-update tasks in spec file')
+  .option('--verbose', 'show detailed output')
+  .action(autopilotCommand);
+
+program.parse();

package/lib/autopilot.js

@@ -0,0 +1,235 @@
+const { spawn } = require('node:child_process');
+const path = require('node:path');
+const fs = require('node:fs');
+const {
+  VALID_AGENTS,
+  DEFAULT_PHASES,
+  AGENT_TIMEOUTS,
+  TASK_TRACKING_AGENTS,
+  loadAgentDefinitionSync,
+  buildPrompt,
+  autoUpdateSpecTasks,
+} = require('./autopilotConstants');
+
+// ANSI color helpers
+const c = {
+  reset: '\x1b[0m',
+  bold: '\x1b[1m',
+  dim: '\x1b[2m',
+  red: '\x1b[31m',
+  green: '\x1b[32m',
+  yellow: '\x1b[33m',
+  blue: '\x1b[34m',
+  magenta: '\x1b[35m',
+  cyan: '\x1b[36m',
+  white: '\x1b[37m',
+  gray: '\x1b[90m',
+};
+
+const AGENT_COLORS = {
+  strategist: c.blue,
+  architect: c.magenta,
+  'system-designer': c.cyan,
+  builder: c.yellow,
+  guardian: c.green,
+  chronicler: c.red,
+};
+
+/**
+ * Execute a single agent phase via claude --print with streaming output.
+ * Returns the captured output.
+ */
+function executePhase(agent, fullPrompt, projectPath, timeoutSec) {
+  return new Promise((resolve, reject) => {
+    let output = '';
+    const timeoutMs = timeoutSec * 1000;
+
+    const child = spawn('claude', ['--print'], {
+      cwd: projectPath,
+      env: { ...process.env },
+      stdio: ['pipe', 'pipe', 'pipe'],
+    });
+
+    // Write the prompt to stdin
+    child.stdin.write(fullPrompt);
+    child.stdin.end();
+
+    // Stream stdout in real-time
+    child.stdout.on('data', (data) => {
+      const text = data.toString();
+      output += text;
+      process.stdout.write(text);
+    });
+
+    // Stream stderr
+    child.stderr.on('data', (data) => {
+      process.stderr.write(c.dim + data.toString() + c.reset);
+    });
+
+    // Timeout
+    const timer = setTimeout(() => {
+      child.kill('SIGTERM');
+      reject(new Error(`Timeout: ${agent} exceeded ${timeoutSec}s`));
+    }, timeoutMs);
+
+    child.on('close', (code) => {
+      clearTimeout(timer);
+      if (code === 0) {
+        resolve(output.trim());
+      } else {
+        reject(new Error(`Agent ${agent} exited with code ${code}`));
+      }
+    });
+
+    child.on('error', (err) => {
+      clearTimeout(timer);
+      if (err.code === 'ENOENT') {
+        reject(new Error('Claude CLI not found. Install with: npm i -g @anthropic-ai/claude-code'));
+      } else {
+        reject(err);
+      }
+    });
+  });
+}
+
+/**
+ * Format duration in seconds to human-readable string.
+ */
+function formatDuration(ms) {
+  const secs = Math.floor(ms / 1000);
+  if (secs < 60) return `${secs}s`;
+  const mins = Math.floor(secs / 60);
+  const remainSecs = secs % 60;
+  return `${mins}m ${remainSecs}s`;
+}
+
+/**
+ * devflow autopilot <spec-file> - Run autopilot agents on a spec file
+ */
+async function autopilotCommand(specFile, options) {
+  // 1. Validate spec file
+  const resolvedSpec = path.resolve(specFile);
+  if (!fs.existsSync(resolvedSpec)) {
+    console.error(`${c.red}Error: Spec file not found: ${resolvedSpec}${c.reset}`);
+    process.exit(1);
+  }
+
+  // 2. Read spec content
+  const specContent = fs.readFileSync(resolvedSpec, 'utf-8');
+  if (!specContent.trim()) {
+    console.error(`${c.red}Error: Spec file is empty${c.reset}`);
+    process.exit(1);
+  }
+
+  // 3. Determine project path
+  const projectPath = path.resolve(options.project || process.cwd());
+  if (!fs.existsSync(projectPath)) {
+    console.error(`${c.red}Error: Project path not found: ${projectPath}${c.reset}`);
+    process.exit(1);
+  }
+
+  // 4. Parse phases
+  const phasesStr = options.phases || VALID_AGENTS.join(',');
+  const selectedPhases = phasesStr.split(',').map(p => p.trim()).filter(Boolean);
+
+  // Validate phase names
+  for (const phase of selectedPhases) {
+    if (!VALID_AGENTS.includes(phase)) {
+      console.error(`${c.red}Error: Unknown agent: ${phase}${c.reset}`);
+      console.error(`Valid agents: ${VALID_AGENTS.join(', ')}`);
+      process.exit(1);
+    }
+  }
+
+  // 5. Print header
+  const specName = path.basename(resolvedSpec);
+  console.log(`\n${c.bold}${c.magenta}  DevFlow Autopilot${c.reset}`);
+  console.log(`${c.gray}${'─'.repeat(50)}${c.reset}`);
+  console.log(`${c.gray}  Spec:${c.reset}    ${specName}`);
+  console.log(`${c.gray}  Project:${c.reset} ${path.basename(projectPath)}`);
+  console.log(`${c.gray}  Phases:${c.reset}  ${selectedPhases.length} agents`);
+  console.log(`${c.gray}${'─'.repeat(50)}${c.reset}\n`);
+
+  // 6. Execute phases
+  const results = [];
+  let previousOutputs = [];
+  const totalStart = Date.now();
+  let hasFailure = false;
+
+  for (let i = 0; i < selectedPhases.length; i++) {
+    const agentId = selectedPhases[i];
+    const phaseInfo = DEFAULT_PHASES.find(p => p.id === agentId);
+    const phaseName = phaseInfo ? phaseInfo.name : agentId;
+    const color = AGENT_COLORS[agentId] || c.white;
+
+    console.log(`${c.bold}${color}═══ Phase ${i + 1}/${selectedPhases.length}: ${phaseName} (@${agentId}) ═══${c.reset}\n`);
+
+    // Load the full agent definition from the project
+    const agentDef = loadAgentDefinitionSync(projectPath, agentId);
+    if (!agentDef && options.verbose) {
+      console.log(`${c.dim}  (agent definition not found at ${projectPath}/.claude/commands/agents/${agentId}.md)${c.reset}`);
+    }
+
+    const fullPrompt = buildPrompt(agentId, specContent, previousOutputs, agentDef);
+    const timeout = AGENT_TIMEOUTS[agentId] || 600;
+    const phaseStart = Date.now();
+
+    try {
+      const output = await executePhase(agentId, fullPrompt, projectPath, timeout);
+      const duration = Date.now() - phaseStart;
+
+      previousOutputs.push(output);
+
+      // Auto-update tasks
+      let tasksCompleted = [];
+      if (options.update !== false && TASK_TRACKING_AGENTS.includes(agentId) && output.length > 0) {
+        tasksCompleted = await autoUpdateSpecTasks(resolvedSpec, output);
+      }
+
+      results.push({ agent: agentId, name: phaseName, status: 'completed', duration, tasksCompleted });
+
+      console.log(`\n${c.green}✓ ${phaseName} completed in ${formatDuration(duration)}${c.reset}`);
+      if (tasksCompleted.length > 0) {
+        console.log(`${c.green}  Tasks auto-completed:${c.reset}`);
+        for (const task of tasksCompleted) {
+          console.log(`${c.green}    ✓ ${task}${c.reset}`);
+        }
+      }
+      console.log('');
+
+    } catch (error) {
+      const duration = Date.now() - phaseStart;
+      const errorMessage = error.message || 'Unknown error';
+
+      results.push({ agent: agentId, name: phaseName, status: 'failed', duration, error: errorMessage });
+
+      console.error(`\n${c.red}✗ ${phaseName} failed after ${formatDuration(duration)}${c.reset}`);
+      console.error(`${c.red}  Error: ${errorMessage}${c.reset}\n`);
+
+      hasFailure = true;
+      break; // Stop on failure
+    }
+  }
+
+  // 7. Print summary
+  const totalDuration = Date.now() - totalStart;
+  const completedCount = results.filter(r => r.status === 'completed').length;
+  const totalTasks = results.reduce((acc, r) => acc + (r.tasksCompleted?.length || 0), 0);
+
+  console.log(`${c.gray}${'═'.repeat(50)}${c.reset}`);
+  console.log(`${c.bold}  Summary${c.reset}`);
+  console.log(`${c.gray}${'─'.repeat(50)}${c.reset}`);
+  console.log(`  ${c.gray}Status:${c.reset}    ${hasFailure ? `${c.red}Failed${c.reset}` : `${c.green}Completed${c.reset}`}`);
+  console.log(`  ${c.gray}Phases:${c.reset}    ${completedCount}/${selectedPhases.length} completed`);
+  console.log(`  ${c.gray}Duration:${c.reset}  ${formatDuration(totalDuration)}`);
+  if (totalTasks > 0) {
+    console.log(`  ${c.gray}Tasks:${c.reset}     ${totalTasks} auto-completed`);
+  }
+  console.log(`${c.gray}${'═'.repeat(50)}${c.reset}\n`);
+
+  if (hasFailure) {
+    process.exit(1);
+  }
+}
+
+module.exports = { autopilotCommand };