sdd-toolkit 1.1.0 → 1.6.0

package/src/lib/transformers.js

@@ -1,9 +1,34 @@
+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) {
+function toGeminiTOML(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
     // Escapa aspas duplas na descrição
-    const description = (agent.description || agent.role).replace(/"/g, '\\"');
+    const description = (agent.description || agent.role).replace(/"/g, '\"');
     
     // Constrói o prompt completo
     const parts = [
@@ -15,26 +40,28 @@ function toGeminiTOML(agent) {
         '\n'
     ];
 
-    if (agent.rules && agent.rules.length > 0) {
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    if (allRules.length > 0) {
         parts.push(`# Rules & Guidelines`);
-        agent.rules.forEach(rule => parts.push(`- ${rule}`));
+        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, '\\"\\\"\\"');
+    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) {
+    if (allRules.length > 0) {
         toml += 'rules = [\n';
-        agent.rules.forEach(rule => {
-            const escaped = rule.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+        allRules.forEach(rule => {
+            const escaped = rule.replace(/\\/g, '\\\\').replace(/"/g, '\"');
             toml += `  "${escaped}",\n`;
         });
         toml += ']\n';
@@ -46,15 +73,18 @@ function toGeminiTOML(agent) {
 /**
  * Converte para configuração de Custom Mode do Roo Code / Cline (JSON)
  */
-function toRooConfig(agent, slug) {
+function toRooConfig(agent, slug, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
     const promptParts = [
         `# ${agent.name} (${agent.role})`,
         `\n${agent.systemPrompt.trim()}\n`
     ];
 
-    if (agent.rules && agent.rules.length > 0) {
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    if (allRules.length > 0) {
         promptParts.push(`## Rules & Guidelines`);
-        agent.rules.forEach(rule => promptParts.push(`- ${rule}`));
+        allRules.forEach(rule => promptParts.push(`- ${rule}`));
     }
 
     return {
@@ -68,7 +98,8 @@ function toRooConfig(agent, slug) {
 /**
  * Converte para Markdown do Kilo Code
  */
-function toKiloMarkdown(agent) {
+function toKiloMarkdown(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
     const parts = [
         `<!--- Kilo Code Agent Config --->`,
         `# ${agent.name} ${agent.emoji}`,
@@ -78,9 +109,11 @@ function toKiloMarkdown(agent) {
         '\n'
     ];
 
-    if (agent.rules && agent.rules.length > 0) {
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    if (allRules.length > 0) {
         parts.push(`## Constraints`);
-        agent.rules.forEach(rule => parts.push(`- ${rule}`));
+        allRules.forEach(rule => parts.push(`- ${rule}`));
     }
 
     return parts.join('\n');
@@ -89,7 +122,8 @@ function toKiloMarkdown(agent) {
 /**
  * Converte para Instruções do GitHub Copilot (.github/copilot-instructions.md)
  */
-function toCopilotInstructions(agent) {
+function toCopilotInstructions(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
     const parts = [
         `<!-- GitHub Copilot Instructions for ${agent.name} -->`,
         `# Identity and Role`,
@@ -100,15 +134,16 @@ function toCopilotInstructions(agent) {
         '\n'
     ];
 
-    if (agent.rules && agent.rules.length > 0) {
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    if (allRules.length > 0) {
         parts.push(`## Rules & Guidelines`);
-        agent.rules.forEach(rule => parts.push(`- ${rule}`));
+        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(`- Use Portuguese (Brazil) unless told otherwise.`);
     parts.push(`- Follow the project conventions defined in the workspace.`);
 
     return parts.join('\n');
@@ -118,7 +153,8 @@ function toCopilotInstructions(agent) {
  * Converte para Cursor Rules (.mdc)
  * Inclui Frontmatter para Contexto
  */
-function toCursorMDC(agent) {
+function toCursorMDC(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
     // Tenta inferir globs baseados no papel do agente
     let globs = "*";
     const roleLower = agent.slug.toLowerCase();
@@ -127,7 +163,9 @@ function toCursorMDC(agent) {
     if (roleLower.includes('css') || roleLower.includes('style')) globs = "*.css, *.scss, *.tailwind";
     if (roleLower.includes('sql') || roleLower.includes('db')) globs = "*.sql, *.prisma, *.schema";
 
-    return `---
+    const allRules = [languageRule, ...(agent.rules || [])];
+
+    return `--- 
 description: ${agent.description || agent.role}
 globs: ${globs}
 ---
@@ -138,14 +176,18 @@ Role: ${agent.role}
 ## Instructions
 ${agent.systemPrompt.trim()}
 
-${agent.rules && agent.rules.length > 0 ? '## Rules\n' + agent.rules.map(r => `- ${r}`).join('\n') : ''}
+${allRules.length > 0 ? '## Rules\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
 `;
 }
 
 /**
- * Converte para Windsurf (.windsurfrules)
+ * Converte para Windsurf Workflow (.windsurf/workflows/*.md)
+ * Cascade reconhece esses arquivos como comandos de workflow
  */
-function toWindsurfRules(agent) {
+function toWindsurfRules(agent, options = {}) {
+    const languageRule = getLanguageRule(options.locale);
+    const allRules = [languageRule, ...(agent.rules || [])];
+
     return `# ${agent.name} ${agent.emoji} Rules
 
 Role: ${agent.role}
@@ -153,28 +195,117 @@ Role: ${agent.role}
 ## Core Logic
 ${agent.systemPrompt.trim()}
 
-${agent.rules && agent.rules.length > 0 ? '## Guidelines\n' + agent.rules.map(r => `- ${r}`).join('\n') : ''}
+${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) {
+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()}
 
-${agent.rules && agent.rules.length > 0 ? '[GUIDELINES]\n' + agent.rules.map(r => `- ${r}`).join('\n') : ''}
+${allRules.length > 0 ? '[GUIDELINES]\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
 `;
 }
 
 /**
  * Converte para Trae Instructions
  */
-function toTraeRules(agent) {
+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}
 
@@ -183,17 +314,19 @@ function toTraeRules(agent) {
 ## Context & Instructions
 ${agent.systemPrompt.trim()}
 
-${agent.rules && agent.rules.length > 0 ? '## Constraints\n' + agent.rules.map(r => `- ${r}`).join('\n') : ''}
+${allRules.length > 0 ? '## Constraints\n' + allRules.map(r => `- ${r}`).join('\n') : ''}
 `;
 }
 
-module.exports = { 
-    toGeminiTOML, 
-    toRooConfig, 
-    toKiloMarkdown, 
+module.exports = {
+    toGeminiTOML,
+    toRooConfig,
+    toKiloMarkdown,
     toCopilotInstructions,
     toCursorMDC,
     toWindsurfRules,
+    toClaudeCommand,
     toPlainSystemPrompt,
-    toTraeRules
+    toTraeRules,
+    toOpenCodeAgent
 };

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(), '.sdd-toolkit');
+const archiveDir = path.join(docsDir, 'archive');
+
+// Files to archive (Ephemeral context)
+const filesToArchive = ['project.md', 'task.md', 'audit_report.md', 'requirements.md', 'milestones.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 .sdd-toolkit/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: .sdd-toolkit/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 /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(), '.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')) {
+    ['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: .sdd-toolkit/${file}`);
+        }
+    });
+    console.log('✅ Wipe complete. You can start fresh with /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(), '.sdd-toolkit');
+
+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('project.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 /project)`);
+}
+
+// 2. Plan Status
+const plan = checkFile('task.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, 'task.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 /tasks)`);
+}
+
+console.log('');
+console.log('Use /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: .sdd-toolkit/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

package/definitions/dev.auditor.yaml

@@ -1,54 +0,0 @@
-name: Auditor
-role: Blueprint Validator & Consistency Checker
-emoji: 🕵️
-systemPrompt: |
-  # SYSTEM ROLE & IDENTITY
-  You are the **Lead Auditor**.
-  Your role is to **prevent failure** by detecting gaps in planning BEFORE code is written.
-  You do not execute code. You analyze logical consistency between documents.
-
-  # INPUT CONTEXT
-  1. **Mandatory Reading:**
-     - `docs/requirements.md` (The Contract).
-     - `docs/task.md` (The Plan).
-     - `docs/milestones.md` (The Strategy).
-
-  # WORKFLOW (AUDIT PROCESS)
-  Execute a non-destructive analysis to verify if the Plan covers the Contract.
-
-  ## 1. Coverage Analysis
-  - Map every Requirement (FR-XX, BR-XX) to at least one Task (M1-TXX).
-  - **FLAG** any orphaned requirement (exists in docs but no task to implement it).
-
-  ## 2. Ambiguity Detection
-  - Scan `task.md` for vague terms: "Make it work", "Fix bugs", "improve".
-  - **Task Definition:** Every task MUST have a clear "DoD" (Definition of Done) or "Acceptance Criteria".
-
-  ## 3. Conflict Check
-  - Check if `task.md` contradicts `requirements.md` (e.g., Req says "Postgres", Task says "Install Mongo").
-
-  # OUTPUT STRUCTURE (docs/logs/audit_report.md)
-  
-  ---
-  **Audit Date:** [YYYY-MM-DD HH:MM]
-  **Status:** [PASS / WARN / FAIL]
-  
-  ## 1. Coverage Matrix
-  - [x] FR-01 -> M1-T02
-  - [ ] FR-02 -> **MISSING IN TASKS** (Critical)
-
-  ## 2. Issues Found
-  - **Critical:** Requirement [FR-02] has no implementation task.
-  - **Warning:** Task [M1-T04] mentions "Optimize" without specific metric.
-
-  ## 3. Recommendation
-  - [ ] Generate detailed tasks for FR-02.
-  - [ ] Proceed to code (only if Status is PASS).
-  ---
-
-  # INSTRUCTION
-  Read requirements and tasks. Generate the `audit_report.md`.
-rules:
-  - "**STRICTNESS:** If a Business Rule (BR) is ignored, Fail the audit."
-  - "**NO ASSUMPTIONS:** If a task suggests a library not in requirements, Flag it."
-  - "Language Adaptability: Respond in English by default. If the user speaks in another language, mirror their language."