sdd-toolkit 1.5.0 → 1.6.0

package/src/lib/transformers.js

@@ -1,246 +1,332 @@
-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
-};
+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 Workflow (.windsurf/workflows/*.md)
+ * Cascade reconhece esses arquivos como comandos de workflow
+ */
+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 Claude Code Command (.claude/commands/openspec/*.md)
+ */
+function toClaudeCommand(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    return `--- 
+name: OpenSpec: ${agent.name}
+description: ${agent.description || agent.role}
+category: OpenSpec
+---
+# ${agent.name} ${agent.emoji}
+
+Role: ${agent.role}
+
+## Instructions
+${agent.systemPrompt.trim()}
+
+${allRules.length > 0 ? '## Rules\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') : ''}
+`;
+}
+
+/**
+ * Converte para OpenCode Agent (.opencode/agent/*.md)
+ */
+function toOpenCodeAgent(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    // Configurar permissões baseado no tipo de agente
+    const isReadOnly = agent.slug.includes('review') || agent.slug.includes('audit') || agent.name.includes('Architect') || agent.role.includes('QA') || agent.role.includes('Review');
+    const tools = {
+        write: !isReadOnly,
+        edit: !isReadOnly,
+        bash: !isReadOnly
+    };
+
+    const frontmatter = {
+        description: agent.description || agent.role,
+        mode: 'subagent',
+        temperature: 0.3,
+        tools
+    };
+
+    const frontmatterStr = Object.entries(frontmatter)
+        .map(([key, value]) => `${key}: ${JSON.stringify(value)}`)
+        .join('\n');
+
+    return `---
+${frontmatterStr}
+---
+
+# ${agent.name} ${agent.emoji}
+
+**Role**: ${agent.role}
+
+${agent.systemPrompt.trim()}
+
+## Rules
+${allRules.map(rule => `- ${rule}`).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,
+    toClaudeCommand,
+    toPlainSystemPrompt,
+    toTraeRules,
+    toOpenCodeAgent
+};

package/src/scripts/archive.js

@@ -2,11 +2,11 @@ const fs = require('fs');
 const path = require('path');
 const readline = require('readline');
 
-const docsDir = path.join(process.cwd(), 'docs');
+const docsDir = path.join(process.cwd(), '.sdd-toolkit');
 const archiveDir = path.join(docsDir, 'archive');
 
 // Files to archive (Ephemeral context)
-const filesToArchive = ['spec.md', 'plan.md', 'audit_report.md'];
+const filesToArchive = ['project.md', 'task.md', 'audit_report.md', 'requirements.md', 'milestones.md'];
 
 // Files to keep (Long-term context)
 // - guidelines.md (Laws)
@@ -19,7 +19,7 @@ const rl = readline.createInterface({
 });
 
 console.log('📦 SDD SESSION ARCHIVER');
-console.log('This will move current Spec, Plan, and Audit reports to docs/archive/.');
+console.log('This will move current Spec, Plan, and Audit reports to .sdd-toolkit/archive/.');
 console.log('Your Work Log and Context will remain untouched.\n');
 
 // Check if there is anything to archive
@@ -40,7 +40,7 @@ rl.question('Enter a name for this feature/session (e.g., "auth-system"): ', (na
         fs.mkdirSync(targetDir, { recursive: true });
     }
 
-    console.log(`\nMoving files to: docs/archive/${folderName}/
+    console.log(`\nMoving files to: .sdd-toolkit/archive/${folderName}/
 `);
 
     existingFiles.forEach(file => {
@@ -51,6 +51,6 @@ rl.question('Enter a name for this feature/session (e.g., "auth-system"): ', (na
     });
 
     console.log('\n✅ Session archived successfully!');
-    console.log('You are ready to start a new feature with /dev.spec');
+    console.log('You are ready to start a new feature with /spec');
     rl.close();
 });

package/src/scripts/reset.js

@@ -1,19 +1,19 @@
 const fs = require('fs');
 const path = require('path');
 
-const docsDir = path.join(process.cwd(), 'docs');
+const docsDir = path.join(process.cwd(), '.sdd-toolkit');
 
 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 => {
+    ['project.md', 'task.md', 'requirements.md', 'milestones.md', 'guidelines.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(`Deleted: .sdd-toolkit/${file}`);
         }
     });
-    console.log('✅ Wipe complete. You can start fresh with /dev.explore');
+    console.log('✅ Wipe complete. You can start fresh with /explore');
 }