sdd-toolkit 1.1.0 → 1.5.0

package/src/lib/transformers.js

@@ -1,199 +1,246 @@
-/**
- * Converte definição do agente para TOML do Gemini CLI
- */
-function toGeminiTOML(agent) {
-    // Escapa aspas duplas na descrição
-    const description = (agent.description || agent.role).replace(/"/g, '\\"');
-    
-    // Constrói o prompt completo
-    const parts = [
-        `# Identity`,
-        `You are **${agent.name}** ${agent.emoji}`,
-        `Role: ${agent.role}\n`,
-        `# Core Instructions`,
-        agent.systemPrompt.trim(),
-        '\n'
-    ];
-
-    if (agent.rules && agent.rules.length > 0) {
-        parts.push(`# Rules & Guidelines`);
-        agent.rules.forEach(rule => parts.push(`- ${rule}`));
-        parts.push('\n');
-    }
-
-    const fullPrompt = parts.join('\n');
-    
-    // Escapa aspas triplas para o bloco multilinha TOML
-    const escapedPrompt = fullPrompt.replace(/"""/g, '\\"\\\"\\"');
-    
-    // Monta o TOML final
-    let toml = `description = "${description}"\n`;
-    toml += `prompt = """\n${escapedPrompt}\n"""\n`;
-    
-    // Mantém rules como array separado se a ferramenta suportar (Gemini CLI suporta)
-    if (agent.rules && agent.rules.length > 0) {
-        toml += 'rules = [\n';
-        agent.rules.forEach(rule => {
-            const escaped = rule.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
-            toml += `  "${escaped}",\n`;
-        });
-        toml += ']\n';
-    }
-
-    return toml;
-}
-
-/**
- * Converte para configuração de Custom Mode do Roo Code / Cline (JSON)
- */
-function toRooConfig(agent, slug) {
-    const promptParts = [
-        `# ${agent.name} (${agent.role})`,
-        `\n${agent.systemPrompt.trim()}\n`
-    ];
-
-    if (agent.rules && agent.rules.length > 0) {
-        promptParts.push(`## Rules & Guidelines`);
-        agent.rules.forEach(rule => promptParts.push(`- ${rule}`));
-    }
-
-    return {
-        slug: slug,
-        name: `${agent.emoji} ${agent.name}`,
-        roleDefinition: promptParts.join('\n'),
-        groups: ["read", "edit", "browser", "command", "mcp"]
-    };
-}
-
-/**
- * Converte para Markdown do Kilo Code
- */
-function toKiloMarkdown(agent) {
-    const parts = [
-        `<!--- Kilo Code Agent Config --->`,
-        `# ${agent.name} ${agent.emoji}`,
-        `**Role**: ${agent.role}\n`,
-        `## Instructions`,
-        agent.systemPrompt.trim(),
-        '\n'
-    ];
-
-    if (agent.rules && agent.rules.length > 0) {
-        parts.push(`## Constraints`);
-        agent.rules.forEach(rule => parts.push(`- ${rule}`));
-    }
-
-    return parts.join('\n');
-}
-
-/**
- * Converte para Instruções do GitHub Copilot (.github/copilot-instructions.md)
- */
-function toCopilotInstructions(agent) {
-    const parts = [
-        `<!-- GitHub Copilot Instructions for ${agent.name} -->`,
-        `# Identity and Role`,
-        `You are **${agent.name}** ${agent.emoji}.`,
-        `**Role**: ${agent.role}`,
-        `\n## Core Instructions`,
-        agent.systemPrompt.trim(),
-        '\n'
-    ];
-
-    if (agent.rules && agent.rules.length > 0) {
-        parts.push(`## Rules & Guidelines`);
-        agent.rules.forEach(rule => parts.push(`- ${rule}`));
-    }
-    
-    // Adiciona uma seção de estilo de resposta para garantir conformidade
-    parts.push(`\n## Response Style`);
-    parts.push(`- Be concise and objective.`);
-    parts.push(`- Use Portuguese (Brazil) unless told otherwise.`);
-    parts.push(`- Follow the project conventions defined in the workspace.`);
-
-    return parts.join('\n');
-}
-
-/**
- * Converte para Cursor Rules (.mdc)
- * Inclui Frontmatter para Contexto
- */
-function toCursorMDC(agent) {
-    // Tenta inferir globs baseados no papel do agente
-    let globs = "*";
-    const roleLower = agent.slug.toLowerCase();
-    
-    if (roleLower.includes('test') || roleLower.includes('qa')) globs = "*.test.*, *.spec.*, **/tests/**";
-    if (roleLower.includes('css') || roleLower.includes('style')) globs = "*.css, *.scss, *.tailwind";
-    if (roleLower.includes('sql') || roleLower.includes('db')) globs = "*.sql, *.prisma, *.schema";
-
-    return `---
-description: ${agent.description || agent.role}
-globs: ${globs}
----
-# ${agent.name} ${agent.emoji}
-
-Role: ${agent.role}
-
-## Instructions
-${agent.systemPrompt.trim()}
-
-${agent.rules && agent.rules.length > 0 ? '## Rules\n' + agent.rules.map(r => `- ${r}`).join('\n') : ''}
-`;
-}
-
-/**
- * Converte para Windsurf (.windsurfrules)
- */
-function toWindsurfRules(agent) {
-    return `# ${agent.name} ${agent.emoji} Rules
-
-Role: ${agent.role}
-
-## Core Logic
-${agent.systemPrompt.trim()}
-
-${agent.rules && agent.rules.length > 0 ? '## Guidelines\n' + agent.rules.map(r => `- ${r}`).join('\n') : ''}
-`;
-}
-
-/**
- * Converte para System Prompt Puro (OpenAI/Claude/Web)
- */
-function toPlainSystemPrompt(agent) {
-    return `You are ${agent.name} ${agent.emoji}
-Role: ${agent.role}
-
-[SYSTEM INSTRUCTIONS]
-${agent.systemPrompt.trim()}
-
-${agent.rules && agent.rules.length > 0 ? '[GUIDELINES]\n' + agent.rules.map(r => `- ${r}`).join('\n') : ''}
-`;
-}
-
-/**
- * Converte para Trae Instructions
- */
-function toTraeRules(agent) {
-    return `<!-- Trae Workspace Rules -->
-# ${agent.name} ${agent.emoji}
-
-**Role**: ${agent.role}
-
-## Context & Instructions
-${agent.systemPrompt.trim()}
-
-${agent.rules && agent.rules.length > 0 ? '## Constraints\n' + agent.rules.map(r => `- ${r}`).join('\n') : ''}
-`;
-}
-
-module.exports = { 
-    toGeminiTOML, 
-    toRooConfig, 
-    toKiloMarkdown, 
-    toCopilotInstructions,
-    toCursorMDC,
-    toWindsurfRules,
-    toPlainSystemPrompt,
-    toTraeRules
-};
+const { TRANSLATIONS } = require('./messages');
+
+/**
+ * Returns the language rule based on the locale
+ * @param {string} locale - 'en', 'pt-br', 'es', etc.
+ */
+function getLanguageRule(locale = 'en') {
+    const normalized = locale.toLowerCase().replace('-', '_');
+    
+    // Mapping locale slug to property key in messages
+    const keyMap = {
+        'en': 'EN',
+        'pt_br': 'PT_BR',
+        'es': 'ES'
+    };
+
+    const ruleKey = keyMap[normalized] || 'EN';
+    
+    // Get dictionary for the target locale or fallback to EN
+    const dict = TRANSLATIONS[normalized] || TRANSLATIONS['en'];
+    
+    return dict.LANGUAGE_RULES[ruleKey];
+}
+
+/**
+ * Converte definição do agente para TOML do Gemini CLI
+ */
+function toGeminiTOML(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    // Escapa aspas duplas na descrição
+    const description = (agent.description || agent.role).replace(/"/g, '\\"');
+    
+    // Constrói o prompt completo
+    const parts = [
+        `# Identity`,
+        `You are **${agent.name}** ${agent.emoji}`,
+        `Role: ${agent.role}\n`,
+        `# Core Instructions`,
+        agent.systemPrompt.trim(),
+        '\n'
+    ];
+
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    if (allRules.length > 0) {
+        parts.push(`# Rules & Guidelines`);
+        allRules.forEach(rule => parts.push(`- ${rule}`));
+        parts.push('\n');
+    }
+
+    const fullPrompt = parts.join('\n');
+    
+    // Escapa aspas triplas para o bloco multilinha TOML
+    const escapedPrompt = fullPrompt.replace(/"""/g, '\\"\\\"\\\"');
+    
+    // Monta o TOML final
+    let toml = `description = "${description}"\n`;
+    toml += `prompt = """\n${escapedPrompt}\n"""\n`;
+    
+    // Mantém rules como array separado se a ferramenta suportar (Gemini CLI suporta)
+    if (allRules.length > 0) {
+        toml += 'rules = [\n';
+        allRules.forEach(rule => {
+            const escaped = rule.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+            toml += `  "${escaped}",\n`;
+        });
+        toml += ']\n';
+    }
+
+    return toml;
+}
+
+/**
+ * Converte para configuração de Custom Mode do Roo Code / Cline (JSON)
+ */
+function toRooConfig(agent, slug, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const promptParts = [
+        `# ${agent.name} (${agent.role})`,
+        `\n${agent.systemPrompt.trim()}\n`
+    ];
+
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    if (allRules.length > 0) {
+        promptParts.push(`## Rules & Guidelines`);
+        allRules.forEach(rule => promptParts.push(`- ${rule}`));
+    }
+
+    return {
+        slug: slug,
+        name: `${agent.emoji} ${agent.name}`,
+        roleDefinition: promptParts.join('\n'),
+        groups: ["read", "edit", "browser", "command", "mcp"]
+    };
+}
+
+/**
+ * Converte para Markdown do Kilo Code
+ */
+function toKiloMarkdown(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const parts = [
+        `<!--- Kilo Code Agent Config --->`,
+        `# ${agent.name} ${agent.emoji}`,
+        `**Role**: ${agent.role}\n`,
+        `## Instructions`,
+        agent.systemPrompt.trim(),
+        '\n'
+    ];
+
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    if (allRules.length > 0) {
+        parts.push(`## Constraints`);
+        allRules.forEach(rule => parts.push(`- ${rule}`));
+    }
+
+    return parts.join('\n');
+}
+
+/**
+ * Converte para Instruções do GitHub Copilot (.github/copilot-instructions.md)
+ */
+function toCopilotInstructions(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const parts = [
+        `<!-- GitHub Copilot Instructions for ${agent.name} -->`,
+        `# Identity and Role`,
+        `You are **${agent.name}** ${agent.emoji}.`,
+        `**Role**: ${agent.role}`,
+        `\n## Core Instructions`,
+        agent.systemPrompt.trim(),
+        '\n'
+    ];
+
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    if (allRules.length > 0) {
+        parts.push(`## Rules & Guidelines`);
+        allRules.forEach(rule => parts.push(`- ${rule}`));
+    }
+    
+    // Adiciona uma seção de estilo de resposta para garantir conformidade
+    parts.push(`\n## Response Style`);
+    parts.push(`- Be concise and objective.`);
+    parts.push(`- Follow the project conventions defined in the workspace.`);
+
+    return parts.join('\n');
+}
+
+/**
+ * Converte para Cursor Rules (.mdc)
+ * Inclui Frontmatter para Contexto
+ */
+function toCursorMDC(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    // Tenta inferir globs baseados no papel do agente
+    let globs = "*";
+    const roleLower = agent.slug.toLowerCase();
+    
+    if (roleLower.includes('test') || roleLower.includes('qa')) globs = "*.test.*, *.spec.*, **/tests/**";
+    if (roleLower.includes('css') || roleLower.includes('style')) globs = "*.css, *.scss, *.tailwind";
+    if (roleLower.includes('sql') || roleLower.includes('db')) globs = "*.sql, *.prisma, *.schema";
+
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    return `--- 
+description: ${agent.description || agent.role}
+globs: ${globs}
+---
+# ${agent.name} ${agent.emoji}
+
+Role: ${agent.role}
+
+## Instructions
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '## Rules\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
+/**
+ * Converte para Windsurf (.windsurfrules)
+ */
+function toWindsurfRules(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    return `# ${agent.name} ${agent.emoji} Rules
+
+Role: ${agent.role}
+
+## Core Logic
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '## Guidelines\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
+/**
+ * Converte para System Prompt Puro (OpenAI/Claude/Web)
+ */
+function toPlainSystemPrompt(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+    
+    return `You are ${agent.name} ${agent.emoji}
+Role: ${agent.role}
+
+[SYSTEM INSTRUCTIONS]
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '[GUIDELINES]\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
+/**
+ * Converte para Trae Instructions
+ */
+function toTraeRules(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    return `<!-- Trae Workspace Rules -->
+# ${agent.name} ${agent.emoji}
+
+**Role**: ${agent.role}
+
+## Context & Instructions
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '## Constraints\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
+`;
+}
+
+module.exports = { 
+    toGeminiTOML, 
+    toRooConfig, 
+    toKiloMarkdown, 
+    toCopilotInstructions,
+    toCursorMDC,
+    toWindsurfRules,
+    toPlainSystemPrompt,
+    toTraeRules
+};

package/src/scripts/archive.js

@@ -0,0 +1,56 @@
+const fs = require('fs');
+const path = require('path');
+const readline = require('readline');
+
+const docsDir = path.join(process.cwd(), 'docs');
+const archiveDir = path.join(docsDir, 'archive');
+
+// Files to archive (Ephemeral context)
+const filesToArchive = ['spec.md', 'plan.md', 'audit_report.md'];
+
+// Files to keep (Long-term context)
+// - guidelines.md (Laws)
+// - context.md (Project Reality)
+// - work_log.md (History)
+
+const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout
+});
+
+console.log('📦 SDD SESSION ARCHIVER');
+console.log('This will move current Spec, Plan, and Audit reports to docs/archive/.');
+console.log('Your Work Log and Context will remain untouched.\n');
+
+// Check if there is anything to archive
+const existingFiles = filesToArchive.filter(f => fs.existsSync(path.join(docsDir, f)));
+
+if (existingFiles.length === 0) {
+    console.log('❌ No active session files found (spec.md, plan.md, etc). Nothing to archive.');
+    process.exit(0);
+}
+
+rl.question('Enter a name for this feature/session (e.g., "auth-system"): ', (name) => {
+    const safeName = (name || 'untitled').replace(/[^a-z0-9-_]/gi, '-').toLowerCase();
+    const timestamp = new Date().toISOString().split('T')[0];
+    const folderName = `${timestamp}_${safeName}`;
+    const targetDir = path.join(archiveDir, folderName);
+
+    if (!fs.existsSync(targetDir)) {
+        fs.mkdirSync(targetDir, { recursive: true });
+    }
+
+    console.log(`\nMoving files to: docs/archive/${folderName}/
+`);
+
+    existingFiles.forEach(file => {
+        const srcPath = path.join(docsDir, file);
+        const destPath = path.join(targetDir, file);
+        fs.renameSync(srcPath, destPath);
+        console.log(`✔ Archived: ${file}`);
+    });
+
+    console.log('\n✅ Session archived successfully!');
+    console.log('You are ready to start a new feature with /dev.spec');
+    rl.close();
+});

package/src/scripts/reset.js

@@ -0,0 +1,19 @@
+const fs = require('fs');
+const path = require('path');
+
+const docsDir = path.join(process.cwd(), 'docs');
+
+console.log('⚠️  WARNING: This will wipe all documentation (Spec, Plan, Context).');
+console.log('Your source code (src/) will NOT be touched.');
+console.log('Are you sure? (Run with --force to execute)');
+
+if (process.argv.includes('--force')) {
+    ['spec.md', 'plan.md', 'context.md', 'audit_report.md'].forEach(file => {
+        const p = path.join(docsDir, file);
+        if (fs.existsSync(p)) {
+            fs.unlinkSync(p);
+            console.log(`Deleted: docs/${file}`);
+        }
+    });
+    console.log('✅ Wipe complete. You can start fresh with /dev.explore');
+}

package/src/scripts/status.js

@@ -0,0 +1,58 @@
+const fs = require('fs');
+const path = require('path');
+
+// Tenta carregar picocolors se estiver disponível no projeto do usuário, senão usa fallback
+let pc = { 
+    green: s => s, 
+    blue: s => s, 
+    yellow: s => s, 
+    red: s => s, 
+    bold: s => s, 
+    bgBlue: s => s 
+};
+try { pc = require('picocolors'); } catch (e) {}
+
+const docsDir = path.join(process.cwd(), 'docs');
+
+function checkFile(name) {
+    const p = path.join(docsDir, name);
+    if (fs.existsSync(p)) {
+        const stats = fs.statSync(p);
+        return { exists: true, size: stats.size, mtime: stats.mtime };
+    }
+    return { exists: false };
+}
+
+console.clear();
+console.log(pc.bgBlue(pc.bold(' 📊 SDD PROJECT STATUS ')));
+console.log('');
+
+// 1. Spec Status
+const spec = checkFile('spec.md');
+if (spec.exists && spec.size > 100) {
+    console.log(`${pc.green('✔ Spec Defined')} (Last update: ${spec.mtime.toLocaleString()})`);
+} else {
+    console.log(`${pc.red('✖ Spec Missing')} (Run /dev.spec)`);
+}
+
+// 2. Plan Status
+const plan = checkFile('plan.md');
+if (plan.exists && plan.size > 100) {
+    console.log(`${pc.green('✔ Plan Active')} (Last update: ${plan.mtime.toLocaleString()})`);
+    
+    // Tenta ler progresso simples
+    try {
+        const content = fs.readFileSync(path.join(docsDir, 'plan.md'), 'utf-8');
+        const total = (content.match(/- \[ \]/g) || []).length + (content.match(/- \[x\]/g) || []).length;
+        const done = (content.match(/- \[x\]/g) || []).length;
+        if (total > 0) {
+            const percent = Math.round((done / total) * 100);
+            console.log(`   Progress: [${'#'.repeat(Math.floor(percent/10))}${'-'.repeat(10 - Math.floor(percent/10))}] ${percent}% (${done}/${total} tasks)`);
+        }
+    } catch (e) {}
+} else {
+    console.log(`${pc.yellow('⚠ Plan Missing')} (Run /dev.plan)`);
+}
+
+console.log('');
+console.log('Use /dev.build to continue work.');

package/templates/guidelines.md

@@ -0,0 +1,9 @@
+# 📜 Project Guidelines
+
+## 🏗️ Architecture Patterns
+
+## 💻 Code Conventions
+
+## 🛠️ Tech Stack & Versions
+
+## 🛡️ Security & Performance

package/templates/milestones.md

@@ -0,0 +1,14 @@
+---
+title: Development Roadmap
+source_spec: docs/project.md
+last_updated: 
+status: 
+---
+
+# Strategic Roadmap
+
+## 1. Strategy Summary
+
+## 2. Milestones Detail
+
+## 3. Risk Matrix

package/templates/project.md

@@ -0,0 +1,28 @@
+---
+title: 
+version: 
+status: 
+last_updated: 
+---
+
+# 
+
+## 1. Overview
+
+## 2. Business Objectives
+
+## 3. Actors and Personas
+
+## 4. Modules and Features Structure
+
+## 5. User Journey (Flow)
+
+## 6. Business Rules
+
+## 7. External Integrations
+
+## 8. Non-Functional Requirements & Constraints
+
+## 9. Data Definitions
+
+## 10. Project Principles (Constitution)

package/templates/requirements.md

@@ -0,0 +1,15 @@
+---
+title: Requirements and Architecture Specification
+scope: 
+last_updated: 
+---
+
+# Requirements and Stack Catalog
+
+## 1. Tech Stack and Standards (Tech Constraints)
+
+## 2. Functional Requirements (FR)
+
+## 3. Non-Functional Requirements (NFR)
+
+## 4. Data Model (Schema Draft)

package/templates/task.md

@@ -0,0 +1,11 @@
+---
+title: Tasks Sprint - 
+milestone_ref: 
+tech_stack: 
+---
+
+# Execution Backlog: 
+
+## Technical Summary
+
+## Tasks Checklist