sdd-toolkit 1.0.0 → 1.5.0

package/definitions/dev.tasks.yaml

@@ -1,70 +1,84 @@
-name: Task Planner
-role: Generates technical tasks
-emoji: 📋
-systemPrompt: |
-  # SYSTEM ROLE & IDENTITY
-  You are the **Engineering Planning Lead**.
-  Your function is to transform Milestones (What) and Requirements (How/Rules) into an execution checklist for developers.
-  You strictly follow Tech Stack defined in `docs/requirements.md`.
-
-  # INPUT CONTEXT & WORKFLOW
-  1. **Context Reading (Mandatory):**
-     - Read `docs/milestones.md` (To know which phase to attack).
-     - Read `docs/requirements.md` (To know LIBS, DATABASE, and RULES).
-     - *If `docs/requirements.md` not found:* Warn user and ask for stack manually.
-
-  2. **Selection:**
-     - List Milestones.
-     - Ask: "Which Milestone shall we detail?"
-
-  3. **Task Generation (Tech-Aware):**
-     - When creating a task, consult "Tech Stack" section of `docs/requirements.md`.
-     - **Example:** If requirement asks for validation and stack says "Zod", task MUST be "Implement Zod schema", not just "Validate data".
-     - **Linking:** If possible, cite requirement ID in task (e.g., "Verify rule [BR-01]").
-
-  # OUTPUT STRUCTURE (docs/task.md)
-  The file must be formatted as Markdown Checklist.
-
-  ---
-  title: Tasks Sprint - [Milestone Name]
-  milestone_ref: [Name]
-  tech_stack: [Stack Summary read in docs/requirements.md]
-  ---
-
-  # Execution Backlog: [Milestone Name]
-
-  ## Technical Summary
-  (Target Stack: [e.g., Next.js + Prisma + Zod])
-
-  ## Tasks Checklist
-
-  - [ ] **[M1-T01] Initial Environment Setup**
-    - [ ] Install dependencies ([List libs from docs/requirements.md])
-    - [ ] Configure Database connection ([Cite database from docs/requirements.md])
-    - **DoD:** Environment running and connected.
-
-  - [ ] **[M1-T02] Implement [Feature Name]**
-    - [ ] Create Data Model (According to Schema in docs/requirements.md)
-    - [ ] Implement Business Logic (Meeting BR-XX)
-    - [ ] **Create Tests (Using [Defined Test Lib])**
-    - **Acceptance Criteria:**
-      - [ ] Must pass success flow [FR-XX]
-      - [ ] Must handle error [Cite error scenario from docs/requirements.md]
-
-  ...
-
-  ---
-
-  # HANDOFF & NEXT STEPS (Workflow Link)
-  At the end of the response (in chat, not in file), you MUST instruct the user on the logical next step:
-  "✅ **Task backlog created.** The next step is to start development.
-  👉 **Execute command: `/dev:coder <Task_ID>`** to start coding the first task."
-
-  # INSTRUCTION
-  Analyze `docs/milestones.md` and `docs/requirements.md`. Ask target milestone, generate technical tasks and link to command `/dev:coder`.
-rules:
-  - "**CONSISTENCY:** If `docs/requirements.md` says \"PostgreSQL\", NEVER create a task to \"Configure MongoDB\"."
-  - "**TRACEABILITY:** Try to link tasks to Requirement IDs (FR-01, BR-02) whenever context allows."
-  - "**TESTING:** Always include test subtasks using library specified in requirements."
-  - "**FILE OPS:** Save strictly as `docs/task.md`."
-  - "Language Adaptability: Respond in English by default. If the user speaks in another language, mirror their language."
+name: Task Planner
+role: Generates technical tasks
+emoji: 📋
+systemPrompt: |
+  # Identity
+  You are **Task Planner** 📋
+  Role: Generates technical tasks
+
+  # Core Instructions
+  # SYSTEM ROLE & IDENTITY
+  You are the **Engineering Planning Lead**.
+  Your function is to transform Milestones (What) and Requirements (How/Rules) into an execution checklist for developers.
+  You strictly follow Tech Stack defined in `docs/requirements.md`.
+
+  # INPUT CONTEXT & WORKFLOW
+  1. **Context Reading (Mandatory):**
+     - Read `docs/milestones.md` (To know which phase to attack).
+     - Read `docs/requirements.md` (To know LIBS, DATABASE, and RULES).
+     - *If `docs/requirements.md` not found:* Warn user and ask for stack manually.
+
+  2. **Selection:**
+     - List Milestones.
+     - Ask: "Which Milestone shall we detail?"
+
+  3. **Task Generation (Tech-Aware):**
+     - When creating a task, consult "Tech Stack" section of `docs/requirements.md`.
+     - **Example:** If requirement asks for validation and stack says "Zod", task MUST be "Implement Zod schema", not just "Validate data".
+     - **Linking:** If possible, cite requirement ID in task (e.g., "Verify rule [BR-01]").
+
+  # OUTPUT STRUCTURE (docs/task.md)
+  The file must be formatted as Markdown Checklist.
+
+  ---
+  title: Tasks Sprint - [Milestone Name]
+  milestone_ref: [Name]
+  tech_stack: [Stack Summary read in docs/requirements.md]
+  ---
+
+  # Execution Backlog: [Milestone Name]
+
+  ## Technical Summary
+  (Target Stack: [e.g., Next.js + Prisma + Zod])
+
+  ## Tasks Checklist
+
+  - [ ] **[M1-T01] Initial Environment Setup**
+    - [ ] Install dependencies ([List libs from docs/requirements.md])
+    - [ ] Configure Database connection ([Cite database from docs/requirements.md])
+    - **DoD:** Environment running and connected.
+
+  - [ ] **[M1-T02] Implement [Feature Name]**
+    - [ ] Create Data Model (According to Schema in docs/requirements.md)
+    - [ ] Implement Business Logic (Meeting BR-XX)
+    - [ ] **Create Tests (Using [Defined Test Lib])**
+    - **Acceptance Criteria:**
+      - [ ] Must pass success flow [FR-XX]
+      - [ ] Must handle error [Cite error scenario from docs/requirements.md]
+
+  ...
+
+  ---
+
+  # HANDOFF & NEXT STEPS (Workflow Link)
+  At the end of the response (in chat, not in file), you MUST instruct the user on the logical next step:
+  "✅ **Task backlog created.** The next step is to start development.
+  👉 **Execute command: `/dev:coder <Task_ID>`** to start coding the first task."
+
+  # INSTRUCTION
+  Analyze `docs/milestones.md` and `docs/requirements.md`. Ask target milestone, generate technical tasks and link to command `/dev:coder`.
+
+
+  # Rules & Guidelines
+  - **CONSISTENCY:** If `docs/requirements.md` says "PostgreSQL", NEVER create a task to "Configure MongoDB".
+  - **TRACEABILITY:** Try to link tasks to Requirement IDs (FR-01, BR-02) whenever context allows.
+  - **TESTING:** Always include test subtasks using library specified in requirements.
+  - **FILE OPS:** Save strictly as `docs/task.md`.
+  - Language Adaptability: Respond in English by default. If the user speaks in another language, mirror their language.
+
+rules:
+  - "**CONSISTENCY:** If `docs/requirements.md` says \"PostgreSQL\", NEVER create a task to \"Configure MongoDB\"."
+  - "**TRACEABILITY:** Try to link tasks to Requirement IDs (FR-01, BR-02) whenever context allows."
+  - "**TESTING:** Always include test subtasks using library specified in requirements."
+  - "**FILE OPS:** Save strictly as `docs/task.md\"."
+  - "Language Adaptability: Respond in English by default. If the user speaks in another language, mirror their language."

package/package.json

@@ -1,40 +1,41 @@
-{
-    "name": "sdd-toolkit",
-    "version": "1.0.0",
-    "description": "Instalador automático dos agentes de desenvolvimento",
-    "main": "src/index.js",
-    "bin": {
-        "sdd-toolkit": "./src/index.js"
-    },
-    "scripts": {
-        "start": "node src/index.js",
-        "test": "echo \"Error: no test specified\" && exit 1"
-    },
-    "dependencies": {
-        "@clack/prompts": "^0.7.0",
-        "js-yaml": "^4.1.0",
-        "picocolors": "^1.0.0",
-        "zod": "^4.2.1"
-    },
-    "author": "",
-    "license": "MIT",
-    "files": [
-        "src",
-        "definitions",
-        "README.md"
-    ],
-    "keywords": [
-        "ai",
-        "agents",
-        "cli",
-        "dev-tools",
-        "llm",
-        "gemini",
-        "roo-code",
-        "cline"
-    ],
-    "repository": {
-        "type": "git",
-        "url": "https://github.com/filipeoliveira93/agents.dev"
-    }
-}
+{
+    "name": "sdd-toolkit",
+    "version": "1.5.0",
+    "description": "Instalador automático dos agentes de desenvolvimento",
+    "main": "src/index.js",
+    "bin": {
+        "sdd-toolkit": "./src/index.js"
+    },
+    "scripts": {
+        "start": "node src/index.js",
+        "test": "echo \"Error: no test specified\" && exit 1"
+    },
+    "dependencies": {
+        "@clack/prompts": "^0.7.0",
+        "js-yaml": "^4.1.0",
+        "picocolors": "^1.0.0",
+        "zod": "^4.2.1"
+    },
+    "author": "",
+    "license": "MIT",
+    "files": [
+        "src",
+        "definitions",
+        "templates",
+        "README.md"
+    ],
+    "keywords": [
+        "ai",
+        "agents",
+        "cli",
+        "dev-tools",
+        "llm",
+        "gemini",
+        "roo-code",
+        "cline"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/filipeoliveira93/agents.dev"
+    }
+}

package/src/index.js

@@ -3,11 +3,13 @@
 const fs = require('fs');
 const fsp = require('fs/promises');
 const path = require('path');
-const { intro, outro, multiselect, spinner, note } = require('@clack/prompts');
+const { intro, outro, multiselect, spinner, note, select, text } = require('@clack/prompts');
 const pc = require('picocolors');
 
-// Módulos Internos
+// Internal Modules
 const { loadAgents } = require('./lib/agents');
+const { STACK_PROFILES } = require('./lib/profiles');
+const { setLocale, t, getLocale } = require('./lib/i18n');
 const { 
     toGeminiTOML, 
     toRooConfig, 
@@ -22,67 +24,166 @@ const { generateWorkflowGuide } = require('./lib/docs');
 
 async function main() {
     console.clear();
-    intro(pc.bgMagenta(pc.white(' UNIVERSAL SPEC CLI ')));
+    
+    const args = process.argv.slice(2);
+    const isUpgrade = args.includes('upgrade') || args.includes('--upgrade');
 
-    // 1. Scaffold Automático (Sempre executa)
-    const created = generateWorkflowGuide(process.cwd());
-    if (created) {
-        console.log(pc.green('✔ Estrutura de pastas (docs/) verificada.'));
+    // 0. Language Selection (Always first unless forced upgrade silent mode - but upgrade has interaction)
+    // We show this before Upgrade title to ensure upgrade messages are localized too if possible
+    // But typically flags like --lang would be better. For now, interactive.
+    
+    if (!isUpgrade) {
+        intro(pc.bgMagenta(pc.white(' UNIVERSAL SPEC CLI ')));
+        
+        const lang = await select({
+            message: 'Select Language / Selecione o Idioma / Seleccione el Idioma',
+            options: [
+                { value: 'en', label: 'English' },
+                { value: 'pt_br', label: 'Português (Brasil)' },
+                { value: 'es', label: 'Español' }
+            ]
+        });
+
+        if (typeof lang === 'symbol') {
+            outro(pc.yellow('Operation cancelled.'));
+            process.exit(0);
+        }
+        
+        setLocale(lang);
+    } else {
+        // Default EN for upgrade for now
+        setLocale('en'); 
+    }
+
+    if (isUpgrade) {
+        intro(pc.bgBlue(pc.white(t('INTRO.UPGRADE_TITLE'))));
+        
+        // Detecção de Ferramentas Existentes
+        const tools = [];
+        if (fs.existsSync(path.join(process.cwd(), '.gemini'))) tools.push('gemini');
+        if (fs.existsSync(path.join(process.cwd(), '.roo'))) tools.push('roo');
+        if (fs.existsSync(path.join(process.cwd(), '.cline'))) tools.push('cline');
+        if (fs.existsSync(path.join(process.cwd(), '.cursor'))) tools.push('cursor');
+        if (fs.existsSync(path.join(process.cwd(), '.windsurfrules'))) tools.push('windsurf');
+        if (fs.existsSync(path.join(process.cwd(), '.trae'))) tools.push('trae');
+        if (fs.existsSync(path.join(process.cwd(), '.kilo'))) tools.push('kilo');
+        if (fs.existsSync(path.join(process.cwd(), '.github'))) tools.push('copilot'); // Assume copilot se .github existir
+        if (fs.existsSync(path.join(process.cwd(), '.opencode'))) tools.push('opencode');
+        if (fs.existsSync(path.join(process.cwd(), 'prompts'))) tools.push('web');
+
+        if (tools.length === 0) {
+            note(t('UPGRADE.NO_CONFIG'), t('UPGRADE.NO_CONFIG_TITLE'));
+        } else {
+            note(t('UPGRADE.DETECTED_TOOLS', tools.join(', ')), t('UPGRADE.DETECTED_TITLE'));
+            await processAgentsInstallation(tools, { locale: getLocale() });
+            outro(pc.green(t('UPGRADE.SUCCESS')));
+            process.exit(0);
+        }
+    } 
+
+    // 1. Automatic Scaffold
+    const s = spinner();
+    s.start(t('SCAFFOLD.LOADING'));
+    
+    try {
+        const stats = generateWorkflowGuide(process.cwd());
+        if (stats.created > 0) {
+            s.stop(`${t('SCAFFOLD.SUCCESS')} (${stats.created} new, ${stats.verified} verified)`);
+        } else {
+            s.stop(t('SCAFFOLD.ALREADY_EXISTS'));
+        }
+    } catch (e) {
+        s.stop(pc.red(t('SCAFFOLD.ERROR')));
     }
 
-    // 2. Seleção de Ferramentas (Múltipla escolha)
+    // 2. Feature 5: Stack Selection (Profile)
+    const stackOptions = Object.entries(STACK_PROFILES).map(([key, profile]) => ({
+        value: key,
+        label: profile.label
+    }));
+
+    const stackProfile = await select({
+        message: t('SETUP.STACK_SELECT'),
+        options: stackOptions,
+        initialValue: 'generic'
+    });
+
+    if (typeof stackProfile === 'symbol') { 
+        outro(pc.yellow(t('GENERAL.CANCELLED')));
+        process.exit(0); 
+    }
+
+    // 3. Feature 3: Global Rules (Optional)
+    const globalRules = await text({
+        message: t('SETUP.GLOBAL_RULES'),
+        placeholder: t('SETUP.GLOBAL_RULES_HINT'),
+        required: false
+    });
+
+    if (typeof globalRules === 'symbol') {
+        outro(pc.yellow(t('GENERAL.CANCELLED')));
+        process.exit(0);
+    }
+
+    // 4. Tool Selection (Multiple choice)
     const tools = await multiselect({
-        message: 'Para quais ferramentas você deseja instalar os Agentes?',
+        message: t('SETUP.TOOL_SELECT'),
         options: [
-            { value: 'gemini', label: 'Gemini CLI', hint: '.gemini/commands/dev' },
-            { value: 'roo', label: 'Roo Code', hint: '.roo/ & custom_modes.json' },
-            { value: 'cline', label: 'Cline', hint: '.cline/ & custom_modes.json' },
-            { value: 'cursor', label: 'Cursor', hint: '.cursor/rules/*.mdc' },
-            { value: 'windsurf', label: 'Windsurf', hint: '.windsurfrules' },
-            { value: 'trae', label: 'Trae IDE', hint: '.trae/instructions.md' },
-            { value: 'kilo', label: 'Kilo Code', hint: '.kilo/prompts/*.md' },
-            { value: 'copilot', label: 'GitHub Copilot', hint: '.github/copilot-instructions.md' },
-            { value: 'web', label: 'OpenAI / Claude', hint: 'prompts/*.txt' },
-            { value: 'opencode', label: 'OpenCode', hint: '.opencode/*.md' },
+            { value: 'gemini', label: t('TOOLS.GEMINI'), hint: '.gemini/commands/dev' },
+            { value: 'roo', label: t('TOOLS.ROO'), hint: '.roo/ & custom_modes.json' },
+            { value: 'cline', label: t('TOOLS.CLINE'), hint: '.cline/ & custom_modes.json' },
+            { value: 'cursor', label: t('TOOLS.CURSOR'), hint: '.cursor/rules/*.mdc' },
+            { value: 'windsurf', label: t('TOOLS.WINDSURF'), hint: '.windsurfrules' },
+            { value: 'trae', label: t('TOOLS.TRAE'), hint: '.trae/instructions.md' },
+            { value: 'kilo', label: t('TOOLS.KILO'), hint: '.kilo/prompts/*.md' },
+            { value: 'copilot', label: t('TOOLS.COPILOT'), hint: '.github/copilot-instructions.md' },
+            { value: 'web', label: t('TOOLS.WEB'), hint: 'prompts/*.txt' },
+            { value: 'opencode', label: t('TOOLS.OPENCODE'), hint: '.opencode/*.md' },
         ],
         required: true,
-        hint: 'Espaço para selecionar, Enter para confirmar'
+        hint: t('SETUP.TOOL_HINT')
     });
 
+    if (typeof tools === 'symbol') {
+        outro(pc.yellow(t('GENERAL.CANCELLED')));
+        process.exit(0);
+    }
+
     if (!tools || tools.length === 0) {
-        outro('Nenhuma ferramenta selecionada. Operação cancelada.');
+        outro(t('SETUP.NO_TOOLS'));
         process.exit(0);
     }
 
-    await processAgentsInstallation(tools);
+    // Pass locale to installation process
+    await processAgentsInstallation(tools, { stackProfile, globalRules, locale: getLocale() });
 
-    outro(pc.green('Configuração concluída com sucesso! 🚀'));
+    outro(pc.green(t('SETUP.SUCCESS')));
 }
 
-async function processAgentsInstallation(tools) {
+async function processAgentsInstallation(tools, options) {
     const s = spinner();
-    s.start('Carregando definições...');
+    s.start(t('INSTALL.LOADING'));
 
     try {
-        const validAgents = await loadAgents();
+        const validAgents = await loadAgents(options);
 
         if (validAgents.length === 0) {
-            s.stop('Nenhum agente válido encontrado.');
+            s.stop(t('INSTALL.NO_AGENTS'));
             return;
         }
 
-        s.message(`Instalando agentes para: ${tools.join(', ')}...`);
+        s.message(t('INSTALL.INSTALLING', tools.join(', ')));
 
-        // Itera sobre cada ferramenta selecionada
+        // Iterate over each selected tool
         for (const tool of tools) {
             
-            // Instalação Específica por Ferramenta
+            // Tool-Specific Installation
             if (tool === 'gemini') {
                 const targetDir = path.join(process.cwd(), '.gemini', 'commands', 'dev');
                 await fsp.mkdir(targetDir, { recursive: true });
 
                 await Promise.all(validAgents.map(agent => {
-                    const toml = toGeminiTOML(agent);
+                    const toml = toGeminiTOML(agent, options);
                     const fileName = `${agent.originalName}.toml`; 
                     return fsp.writeFile(path.join(targetDir, fileName), toml);
                 }));
@@ -93,11 +194,11 @@ async function processAgentsInstallation(tools) {
                 await fsp.mkdir(targetDir, { recursive: true });
 
                 await Promise.all(validAgents.map(agent => {
-                    const md = toKiloMarkdown(agent);
+                    const md = toKiloMarkdown(agent, options);
                     return fsp.writeFile(path.join(targetDir, `${agent.slug}.md`), md);
                 }));
 
-                const modes = validAgents.map(agent => toRooConfig(agent, agent.slug));
+                const modes = validAgents.map(agent => toRooConfig(agent, agent.slug, options));
                 const jsonContent = JSON.stringify({ customModes: modes }, null, 2);
                 const fileName = `${tool}_custom_modes.json`;
                 await fsp.writeFile(path.join(process.cwd(), fileName), jsonContent);
@@ -107,7 +208,7 @@ async function processAgentsInstallation(tools) {
                 await fsp.mkdir(targetDir, { recursive: true });
 
                 await Promise.all(validAgents.map(agent => {
-                    const md = toKiloMarkdown(agent);
+                    const md = toKiloMarkdown(agent, options);
                     return fsp.writeFile(path.join(targetDir, `${agent.slug}.md`), md);
                 }));
             }
@@ -117,12 +218,12 @@ async function processAgentsInstallation(tools) {
                 await fsp.mkdir(agentsDir, { recursive: true });
 
                 await Promise.all(validAgents.map(agent => {
-                    const md = toCopilotInstructions(agent);
+                    const md = toCopilotInstructions(agent, options);
                     return fsp.writeFile(path.join(agentsDir, `${agent.slug}.md`), md);
                 }));
 
                 const mainAgent = validAgents.find(a => a.slug.includes('coder')) || validAgents[0];
-                const mainInstructions = toCopilotInstructions(mainAgent);
+                const mainInstructions = toCopilotInstructions(mainAgent, options);
                 await fsp.writeFile(path.join(githubDir, 'copilot-instructions.md'), mainInstructions);
             }
             else if (tool === 'cursor') {
@@ -130,13 +231,13 @@ async function processAgentsInstallation(tools) {
                 await fsp.mkdir(rulesDir, { recursive: true });
 
                 await Promise.all(validAgents.map(agent => {
-                    const mdc = toCursorMDC(agent);
+                    const mdc = toCursorMDC(agent, options);
                     return fsp.writeFile(path.join(rulesDir, `${agent.slug}.mdc`), mdc);
                 }));
             }
             else if (tool === 'windsurf') {
                 const mainAgent = validAgents.find(a => a.slug.includes('coder')) || validAgents[0];
-                const rules = toWindsurfRules(mainAgent);
+                const rules = toWindsurfRules(mainAgent, options);
                 await fsp.writeFile(path.join(process.cwd(), '.windsurfrules'), rules);
             }
             else if (tool === 'trae') {
@@ -144,7 +245,7 @@ async function processAgentsInstallation(tools) {
                 await fsp.mkdir(traeDir, { recursive: true });
                 
                 const mainAgent = validAgents.find(a => a.slug.includes('coder')) || validAgents[0];
-                const rules = toTraeRules(mainAgent);
+                const rules = toTraeRules(mainAgent, options);
                 await fsp.writeFile(path.join(traeDir, 'instructions.md'), rules);
             }
             else if (tool === 'web') {
@@ -152,7 +253,7 @@ async function processAgentsInstallation(tools) {
                 await fsp.mkdir(targetDir, { recursive: true });
 
                 await Promise.all(validAgents.map(agent => {
-                    const txt = toPlainSystemPrompt(agent);
+                    const txt = toPlainSystemPrompt(agent, options);
                     return fsp.writeFile(path.join(targetDir, `${agent.slug}.txt`), txt);
                 }));
             }
@@ -161,22 +262,22 @@ async function processAgentsInstallation(tools) {
                 await fsp.mkdir(targetDir, { recursive: true });
 
                 await Promise.all(validAgents.map(agent => {
-                    const md = toKiloMarkdown(agent);
+                    const md = toKiloMarkdown(agent, options);
                     return fsp.writeFile(path.join(targetDir, `${agent.slug}.md`), md);
                 }));
             }
         }
         
-        s.stop('Instalação finalizada!');
+        s.stop(t('INSTALL.FINISHED'));
         
-        // Feedback consolidado
+        // Consolidated feedback
         if (tools.includes('roo') || tools.includes('cline')) {
-            note('Lembre-se de configurar os Custom Modes no settings.json para Roo/Cline.', 'Aviso');
+            note(t('INSTALL.ROO_WARNING'), t('INSTALL.ROO_WARNING_TITLE'));
         }
 
     } catch (e) {
-        s.stop('Falha');
-        console.error(pc.red(e.message));
+        s.stop(pc.red(`${t('INSTALL.FAILED')}: ${e.message}`));
+        process.exit(1);
     }
 }