sdd-toolkit 1.9.2 → 2.0.1

package/src/scripts/archive.js

@@ -1,56 +1,55 @@
-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();
-});
+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, 'logs', '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)
+// - context.md (Project Reality)
+// - system.md (System State)
+
+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/logs/archive/.');
+console.log('Your Context and System files 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/logs/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 /feature');
+    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(), '.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');
-}
+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, System).');
+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', 'requirements.md', 'guidelines.md', 'context.md', 'system.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 /project');
+}

package/src/scripts/status.js

@@ -1,58 +1,50 @@
-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.');
+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 - Check for new structure
+const contextFile = checkFile('context.md');
+const stateFiles = fs.readdirSync(path.join(docsDir, 'features')).filter(f => f.endsWith('state.md'));
+const featuresCount = stateFiles.length;
+
+if (featuresCount > 0) {
+    console.log(`${pc.green('✔ Features Active')} (${featuresCount} features)`);
+} else {
+    console.log(`${pc.yellow('⚠ No Features Found')} (Run /feature)`);
+}
+
+console.log('');
+console.log('Use /coder <Task_ID> to continue work.');

package/templates/context.md

@@ -0,0 +1,22 @@
+# 🗺️ Project Context
+
+## Executive Summary
+- **Architecture:** [To be defined]
+- **Database:** [To be defined]
+- **Auth:** [To be defined]
+
+## Features Matrix
+| Feature | Status | Active Milestone | Progress |
+|---------|--------|------------------|----------|
+| None created yet | - | - | - |
+
+## Key Dependencies
+None defined yet.
+
+## System State
+- Database migrations: TBD
+- Test coverage: TBD
+- Last deployment: TBD
+
+## Quick Access
+- [All Features](features/)

package/templates/guidelines.md

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

package/templates/project.md

@@ -1,28 +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)
+---
+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

@@ -1,15 +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)
+---
+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/system.md

@@ -0,0 +1,20 @@
+# 🖥️ System State
+
+## Database
+- Current Migration: TBD
+- Pending Migrations: None
+- Database Size: TBD
+
+## Configuration
+- Environment: development
+- API Version: v1
+- Auth Provider: TBD
+
+## Integrations
+None configured yet.
+
+## Known Issues
+None reported yet.
+
+## Deployments
+No deployments yet.

package/templates/task.md

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