devflow-agents 0.7.0

package/.gitignore-template

@@ -0,0 +1,83 @@
+# 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/

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,244 @@
+# 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.5.0 - Terminal como Interface Principal
+
+### Web IDE
+Interface visual completa para gerenciar seu projeto DevFlow:
+
+- **Terminal Integrado** - Interface principal via xterm.js + node-pty
+- **Dashboard** - Métricas do projeto, health check, status dos agentes
+- **Specs Panel** - Visualize requirements, design decisions e tasks
+- **File Explorer** - Navegue pelo código com preview de markdown/mermaid
+- **Editor Monaco** - Editor profissional com syntax highlighting
+- **Settings** - Configure tema, fonte, terminal
+
+### Melhorias v0.5.0
+- Terminal substituiu Chat como interface principal
+- WebGL addon para renderização nítida em displays retina
+- Toast notifications para feedback de operações
+- Skeleton loaders para estados de carregamento
+- Suporte a Windows via WSL
+
+---
+
+## 🚀 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
+
+# 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,32 @@
+#!/usr/bin/env node
+
+const { Command } = require('commander');
+const { VERSION } = require('../lib/constants');
+const { initCommand } = require('../lib/init');
+const { updateCommand } = require('../lib/update');
+
+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('-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.parse();

package/lib/constants.js

@@ -0,0 +1,75 @@
+const path = require('node:path');
+
+const VERSION = '0.7.0';
+
+// Root of the installed npm package (where source files live)
+const PACKAGE_ROOT = path.resolve(__dirname, '..');
+
+// Directories to create in all install modes
+const BASE_DIRS = [
+  '.claude/commands',
+  '.devflow/agents',
+  '.devflow/memory',
+  '.devflow/sessions',
+  'docs/snapshots',
+  'docs/system-design/sdd',
+  'docs/system-design/rfc',
+  'docs/system-design/capacity',
+  'docs/system-design/trade-offs',
+];
+
+// Additional directories for default/full modes
+const DOCS_DIRS = [
+  'docs/planning/stories',
+  'docs/architecture/diagrams',
+  'docs/decisions',
+  'docs/security',
+  'docs/performance',
+  'docs/api',
+  'docs/migration',
+];
+
+// Directories that should have .gitkeep files
+const GITKEEP_DIRS = [
+  'docs/planning',
+  'docs/planning/stories',
+  'docs/architecture',
+  'docs/architecture/diagrams',
+  'docs/decisions',
+  'docs/security',
+  'docs/performance',
+  'docs/api',
+  'docs/migration',
+  'docs/snapshots',
+  'docs/system-design/sdd',
+  'docs/system-design/rfc',
+  'docs/system-design/capacity',
+  'docs/system-design/trade-offs',
+  '.devflow/sessions',
+];
+
+// Files and directories to copy during init
+const AGENTS_COPY = [
+  { src: '.claude/commands/agents',          dest: '.claude/commands/agents',          type: 'dir' },
+  { src: '.claude/commands/quick',           dest: '.claude/commands/quick',           type: 'dir' },
+  { src: '.claude/commands/devflow-help.md', dest: '.claude/commands/devflow-help.md', type: 'file' },
+  { src: '.claude/commands/devflow-status.md', dest: '.claude/commands/devflow-status.md', type: 'file' },
+  { src: '.claude_project',                  dest: '.claude_project',                  type: 'file' },
+  { src: '.devflow/project.yaml',            dest: '.devflow/project.yaml',            type: 'file' },
+  { src: '.devflow/agents',                  dest: '.devflow/agents',                  type: 'dir' },
+];
+
+// Doc files to copy in default/full modes
+const DOC_FILES = [
+  'docs/decisions/000-template.md',
+];
+
+module.exports = {
+  VERSION,
+  PACKAGE_ROOT,
+  BASE_DIRS,
+  DOCS_DIRS,
+  GITKEEP_DIRS,
+  AGENTS_COPY,
+  DOC_FILES,
+};

package/lib/init.js

@@ -0,0 +1,162 @@
+const fs = require('node:fs');
+const path = require('node:path');
+const {
+  VERSION,
+  PACKAGE_ROOT,
+  BASE_DIRS,
+  DOCS_DIRS,
+  GITKEEP_DIRS,
+  AGENTS_COPY,
+  DOC_FILES,
+} = require('./constants');
+const {
+  printHeader,
+  success,
+  error,
+  warn,
+  info,
+  printSuccess,
+  confirm,
+  checkDependencies,
+  copyDir,
+  copyFile,
+  ensureDirs,
+  createGitkeep,
+  pathExists,
+  resolveTarget,
+} = require('./utils');
+
+async function initCommand(targetArg, options) {
+  printHeader(VERSION);
+
+  const targetDir = resolveTarget(targetArg);
+
+  // 1. Check dependencies
+  if (!options.skipDeps) {
+    checkDependencies();
+  }
+
+  // 2. Validate/create target directory
+  if (!(await pathExists(targetDir))) {
+    info(`Directory does not exist: ${targetDir}`);
+    const shouldCreate = options.force || await confirm('Create this directory?');
+    if (!shouldCreate) {
+      error('Installation cancelled.');
+      process.exit(1);
+    }
+    await fs.promises.mkdir(targetDir, { recursive: true });
+    success(`Directory created: ${targetDir}`);
+  }
+
+  info(`Installing DevFlow in: ${targetDir}`);
+  console.log();
+
+  // 3. Check for existing installation
+  if (await pathExists(path.join(targetDir, '.devflow'))) {
+    warn('.devflow/ already exists in target directory!');
+    if (!options.force) {
+      const shouldOverwrite = await confirm('Overwrite existing installation?');
+      if (!shouldOverwrite) {
+        error('Installation cancelled.');
+        process.exit(1);
+      }
+    }
+    console.log();
+  }
+
+  // 4. Determine install mode
+  let mode = 'default';
+  if (options.agentsOnly) mode = 'agents-only';
+  if (options.full) mode = 'full';
+
+  const modeLabels = {
+    'agents-only': 'Agents only (minimal)',
+    'default': 'Agents + documentation structure',
+    'full': 'Full installation',
+  };
+  info(`Install mode: ${modeLabels[mode]}`);
+  console.log();
+
+  // 5. Create base directory structure
+  await ensureDirs(targetDir, BASE_DIRS);
+
+  // 6. Copy agent files and core config
+  for (const item of AGENTS_COPY) {
+    const src = path.join(PACKAGE_ROOT, item.src);
+    const dest = path.join(targetDir, item.dest);
+    try {
+      if (item.type === 'dir') {
+        await copyDir(src, dest);
+      } else {
+        await copyFile(src, dest);
+      }
+    } catch (err) {
+      warn(`Could not copy ${item.src}: ${err.message}`);
+    }
+  }
+
+  success('Agents installed (.claude/commands/agents/)');
+  success('Quick commands installed (.claude/commands/quick/)');
+  success('.claude_project orchestration rules installed');
+  success('.devflow/ structure created');
+
+  // 7. Default/full: create docs structure with gitkeep files
+  if (mode === 'default' || mode === 'full') {
+    await ensureDirs(targetDir, DOCS_DIRS);
+    await createGitkeep(targetDir, GITKEEP_DIRS);
+
+    // Copy doc template files
+    for (const file of DOC_FILES) {
+      const src = path.join(PACKAGE_ROOT, file);
+      const dest = path.join(targetDir, file);
+      try {
+        if (!(await pathExists(dest))) {
+          await copyFile(src, dest);
+        }
+      } catch { /* skip if source missing */ }
+    }
+
+    success('Documentation structure created (docs/)');
+  }
+
+  // 8. Full: copy .gitignore
+  if (mode === 'full') {
+    const gitignoreSrc = path.join(PACKAGE_ROOT, '.gitignore-template');
+    const gitignoreDest = path.join(targetDir, '.gitignore');
+
+    if (await pathExists(gitignoreSrc)) {
+      if (await pathExists(gitignoreDest)) {
+        warn('.gitignore already exists - appending DevFlow entries');
+        const existing = await fs.promises.readFile(gitignoreDest, 'utf8');
+        if (!existing.includes('# DevFlow')) {
+          const devflowIgnore = await fs.promises.readFile(gitignoreSrc, 'utf8');
+          await fs.promises.appendFile(
+            gitignoreDest,
+            `\n\n# --- DevFlow entries ---\n${devflowIgnore}`
+          );
+        }
+        success('.gitignore updated with DevFlow entries');
+      } else {
+        await copyFile(gitignoreSrc, gitignoreDest);
+        success('.gitignore created');
+      }
+    }
+  }
+
+  // 9. Success output
+  printSuccess(VERSION);
+  info('Next steps:');
+  console.log();
+  console.log('1. Open the project in Claude Code:');
+  console.log(`   cd ${targetDir}`);
+  console.log('   claude');
+  console.log();
+  console.log('2. In Claude Code, test an agent:');
+  console.log('   /agents:strategist Hello! Introduce yourself');
+  console.log();
+  console.log('3. Create your first feature:');
+  console.log('   /agents:strategist I want to create [your feature]');
+  console.log();
+}
+
+module.exports = { initCommand };