ultra-dex 1.0.1 → 1.2.0

package/README.md

@@ -99,9 +99,9 @@ Next steps:
 
 ## Links
 
-- [Full Template](https://github.com/Srujan0798/Ultra-Dex/blob/main/%40%20Ultra%20DeX/Saas%20plan/Imp%20Template.md)
-- [Examples](https://github.com/Srujan0798/Ultra-Dex/tree/main/%40%20Ultra%20DeX/Saas%20plan/Examples)
-- [Methodology](https://github.com/Srujan0798/Ultra-Dex/blob/main/%40%20Ultra%20DeX/Saas%20plan/METHODOLOGY.md)
+- [Full Template](https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/04-Imp-Template.md)
+- [Examples](https://github.com/Srujan0798/Ultra-Dex/tree/main/@%20Ultra%20DeX/Saas%20plan/Examples)
+- [Methodology](https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/03-METHODOLOGY.md)
 
 ## License
 

package/bin/ultra-dex.js

@@ -50,9 +50,9 @@ const QUICK_START_TEMPLATE = `# {{PROJECT_NAME}} - Quick Start
 - {{PROBLEM_2}}
 - {{PROBLEM_3}}
 
-## 3. MVP Features (5 max)
+## 3. Core Production Features (5 max)
 
-| Feature | Priority | Why it's MVP? |
+| Feature | Priority | Justification |
 |---------|----------|---------------|
 | {{FEATURE_1}} | P0 | |
 | | P0 | |
@@ -103,7 +103,7 @@ Setting up the implementation plan.
 
 ## Resources
 - [Ultra-Dex Template](https://github.com/Srujan0798/Ultra-Dex)
-- [TaskFlow Example](https://github.com/Srujan0798/Ultra-Dex/blob/main/%40%20Ultra%20DeX/Saas%20plan/Examples/TaskFlow-Complete.md)
+- [TaskFlow Example](https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/Examples/TaskFlow-Complete.md)
 `;
 
 program
@@ -162,7 +162,7 @@ program
       {
         type: 'input',
         name: 'feature1',
-        message: 'Most important MVP feature:',
+        message: 'Critical production feature:',
         default: '',
       },
       {
@@ -195,6 +195,24 @@ program
         message: 'Hosting:',
         choices: ['Vercel', 'Railway', 'Fly.io', 'AWS', 'Other'],
       },
+      {
+        type: 'confirm',
+        name: 'includeCursorRules',
+        message: 'Include cursor-rules for AI assistants? (Cursor, Copilot)',
+        default: true,
+      },
+      {
+        type: 'confirm',
+        name: 'includeFullTemplate',
+        message: 'Copy full 34-section template locally?',
+        default: false,
+      },
+      {
+        type: 'confirm',
+        name: 'includeDocs',
+        message: 'Copy VERIFICATION.md & AGENT-INSTRUCTIONS.md to docs/?',
+        default: true,
+      },
     ]);
 
     const spinner = ora('Creating project files...').start();
@@ -255,27 +273,82 @@ ${answers.ideaWhat} for ${answers.ideaFor}.
 
 ## Resources
 
-- [Full Template](https://github.com/Srujan0798/Ultra-Dex/blob/main/%40%20Ultra%20DeX/Saas%20plan/Imp%20Template.md)
-- [TaskFlow Example](https://github.com/Srujan0798/Ultra-Dex/blob/main/%40%20Ultra%20DeX/Saas%20plan/Examples/TaskFlow-Complete.md)
-- [Methodology](https://github.com/Srujan0798/Ultra-Dex/blob/main/%40%20Ultra%20DeX/Saas%20plan/METHODOLOGY.md)
+- [Full Template](https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/04-Imp-Template.md)
+- [TaskFlow Example](https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/Examples/TaskFlow-Complete.md)
+- [Methodology](https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/03-METHODOLOGY.md)
 `;
 
       await fs.writeFile(path.join(outputDir, 'IMPLEMENTATION-PLAN.md'), planContent);
 
+      // Copy cursor-rules if requested
+      if (answers.includeCursorRules) {
+        const rulesDir = path.join(outputDir, '.cursor', 'rules');
+        await fs.mkdir(rulesDir, { recursive: true });
+
+        const cursorRulesPath = path.resolve(__dirname, '../../cursor-rules');
+        try {
+          const ruleFiles = await fs.readdir(cursorRulesPath);
+          for (const file of ruleFiles.filter(f => f.endsWith('.mdc'))) {
+            await fs.copyFile(
+              path.join(cursorRulesPath, file),
+              path.join(rulesDir, file)
+            );
+          }
+        } catch (err) {
+          // Cursor rules not available (npm package, not local)
+          console.log(chalk.yellow('\n  Note: cursor-rules not bundled. Download from GitHub:'));
+          console.log(chalk.blue('  https://github.com/Srujan0798/Ultra-Dex/tree/main/cursor-rules'));
+        }
+      }
+
+      // Copy full template if requested
+      if (answers.includeFullTemplate) {
+        const templatePath = path.resolve(__dirname, '../../@ Ultra DeX/Saas plan/04-Imp-Template.md');
+        try {
+          await fs.copyFile(templatePath, path.join(outputDir, 'docs', 'MASTER-PLAN.md'));
+        } catch (err) {
+          console.log(chalk.yellow('\n  Note: Full template not bundled. Download from GitHub:'));
+          console.log(chalk.blue('  https://github.com/Srujan0798/Ultra-Dex/blob/main/%40%20Ultra%20DeX/Saas%20plan/04-Imp-Template.md'));
+        }
+      }
+
+      // Copy docs if requested
+      if (answers.includeDocs) {
+        const verificationPath = path.resolve(__dirname, '../../VERIFICATION.md');
+        const agentPath = path.resolve(__dirname, '../../AGENT-INSTRUCTIONS.md');
+        try {
+          await fs.copyFile(verificationPath, path.join(outputDir, 'docs', 'CHECKLIST.md'));
+          await fs.copyFile(agentPath, path.join(outputDir, 'docs', 'AI-PROMPTS.md'));
+        } catch (err) {
+          console.log(chalk.yellow('\n  Note: Docs not bundled. Download from GitHub:'));
+          console.log(chalk.blue('  https://github.com/Srujan0798/Ultra-Dex'));
+        }
+      }
+
       spinner.succeed(chalk.green('Project created successfully!'));
 
       console.log('\n' + chalk.bold('Files created:'));
       console.log(chalk.gray(`  ${outputDir}/`));
       console.log(chalk.gray('  ├── QUICK-START.md'));
       console.log(chalk.gray('  ├── CONTEXT.md'));
-      console.log(chalk.gray('  └── IMPLEMENTATION-PLAN.md'));
+      console.log(chalk.gray('  ├── IMPLEMENTATION-PLAN.md'));
+      if (answers.includeFullTemplate) {
+        console.log(chalk.gray('  ├── docs/MASTER-PLAN.md (34 sections)'));
+      }
+      if (answers.includeDocs) {
+        console.log(chalk.gray('  ├── docs/CHECKLIST.md'));
+        console.log(chalk.gray('  ├── docs/AI-PROMPTS.md'));
+      }
+      if (answers.includeCursorRules) {
+        console.log(chalk.gray('  └── .cursor/rules/ (11 AI rule files)'));
+      }
 
       console.log('\n' + chalk.bold('Next steps:'));
       console.log(chalk.cyan(`  1. cd ${answers.projectName}`));
       console.log(chalk.cyan('  2. Open QUICK-START.md and complete it'));
       console.log(chalk.cyan('  3. Start building! 🚀'));
 
-      console.log('\n' + chalk.gray('Need the full template? Visit:'));
+      console.log('\n' + chalk.gray('Full Ultra-Dex repo:'));
       console.log(chalk.blue('  https://github.com/Srujan0798/Ultra-Dex'));
 
     } catch (error) {
@@ -285,6 +358,140 @@ ${answers.ideaWhat} for ${answers.ideaFor}.
     }
   });
 
+program
+  .command('audit')
+  .description('Audit your Ultra-Dex project for completeness')
+  .option('-d, --dir <directory>', 'Project directory to audit', '.')
+  .action(async (options) => {
+    console.log(chalk.cyan('\n🔍 Ultra-Dex Project Audit\n'));
+
+    const projectDir = path.resolve(options.dir);
+    let score = 0;
+    let maxScore = 0;
+    const results = [];
+
+    // Helper function to check file exists and has content
+    async function checkFile(filePath, description, points) {
+      maxScore += points;
+      try {
+        const content = await fs.readFile(path.join(projectDir, filePath), 'utf-8');
+        if (content.length > 50) {
+          score += points;
+          results.push({ status: '✅', item: description, points: `+${points}` });
+          return content;
+        } else {
+          results.push({ status: '⚠️', item: `${description} (empty/too short)`, points: '0' });
+          return null;
+        }
+      } catch {
+        results.push({ status: '❌', item: `${description} (missing)`, points: '0' });
+        return null;
+      }
+    }
+
+    // Helper to check content has section
+    function hasSection(content, sectionName, points) {
+      maxScore += points;
+      if (content && content.toLowerCase().includes(sectionName.toLowerCase())) {
+        score += points;
+        results.push({ status: '✅', item: `Has ${sectionName}`, points: `+${points}` });
+        return true;
+      } else {
+        results.push({ status: '❌', item: `Missing ${sectionName}`, points: '0' });
+        return false;
+      }
+    }
+
+    // Check core files
+    console.log(chalk.bold('Checking project files...\n'));
+
+    const quickStart = await checkFile('QUICK-START.md', 'QUICK-START.md', 10);
+    const context = await checkFile('CONTEXT.md', 'CONTEXT.md', 5);
+    const implPlan = await checkFile('IMPLEMENTATION-PLAN.md', 'IMPLEMENTATION-PLAN.md', 5);
+    const fullTemplate = await checkFile('04-Imp-Template.md', '04-Imp-Template.md', 10);
+
+    // Check for alternative file names
+    const readme = await checkFile('README.md', 'README.md', 5);
+
+    // Check content quality if QUICK-START exists
+    if (quickStart) {
+      hasSection(quickStart, 'idea', 5);
+      hasSection(quickStart, 'problem', 5);
+      hasSection(quickStart, 'mvp', 5);
+      hasSection(quickStart, 'tech stack', 10);
+      hasSection(quickStart, 'feature', 5);
+    }
+
+    // Check for implementation details
+    if (implPlan) {
+      hasSection(implPlan, 'database', 5);
+      hasSection(implPlan, 'api', 5);
+      hasSection(implPlan, 'auth', 5);
+    }
+
+    // Check for docs folder
+    try {
+      await fs.access(path.join(projectDir, 'docs'));
+      score += 5;
+      maxScore += 5;
+      results.push({ status: '✅', item: 'docs/ folder exists', points: '+5' });
+    } catch {
+      maxScore += 5;
+      results.push({ status: '⚠️', item: 'docs/ folder (optional)', points: '0' });
+    }
+
+    // Print results
+    console.log(chalk.bold('Audit Results:\n'));
+    results.forEach(r => {
+      const statusColor = r.status === '✅' ? chalk.green : r.status === '❌' ? chalk.red : chalk.yellow;
+      console.log(`  ${statusColor(r.status)} ${r.item} ${chalk.gray(r.points)}`);
+    });
+
+    // Calculate percentage
+    const percentage = Math.round((score / maxScore) * 100);
+
+    console.log('\n' + chalk.bold('─'.repeat(50)));
+    console.log(chalk.bold(`\nScore: ${score}/${maxScore} (${percentage}%)\n`));
+
+    // Grade
+    let grade, gradeColor, message;
+    if (percentage >= 90) {
+      grade = 'A';
+      gradeColor = chalk.green;
+      message = 'Excellent! Your project is well-documented.';
+    } else if (percentage >= 75) {
+      grade = 'B';
+      gradeColor = chalk.green;
+      message = 'Good! A few more sections would help.';
+    } else if (percentage >= 60) {
+      grade = 'C';
+      gradeColor = chalk.yellow;
+      message = 'Fair. Consider filling more sections before coding.';
+    } else if (percentage >= 40) {
+      grade = 'D';
+      gradeColor = chalk.yellow;
+      message = 'Needs work. Use QUICK-START.md to define your project.';
+    } else {
+      grade = 'F';
+      gradeColor = chalk.red;
+      message = 'Run "npx ultra-dex init" to get started properly.';
+    }
+
+    console.log(gradeColor(`Grade: ${grade}`));
+    console.log(chalk.gray(message));
+
+    // Suggestions
+    const missing = results.filter(r => r.status === '❌');
+    if (missing.length > 0) {
+      console.log(chalk.bold('\n📋 To improve your score:\n'));
+      missing.slice(0, 5).forEach(m => {
+        console.log(chalk.cyan(`  → Add ${m.item.replace(' (missing)', '')}`));
+      });
+    }
+
+    console.log('\n' + chalk.gray('Learn more: https://github.com/Srujan0798/Ultra-Dex\n'));
+  });
+
 program
   .command('examples')
   .description('List available examples')
@@ -295,17 +502,17 @@ program
       {
         name: 'TaskFlow',
         type: 'Task Management',
-        url: 'https://github.com/Srujan0798/Ultra-Dex/blob/main/%40%20Ultra%20DeX/Saas%20plan/Examples/TaskFlow-Complete.md',
+        url: 'https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/Examples/TaskFlow-Complete.md',
       },
       {
         name: 'InvoiceFlow',
         type: 'Invoicing',
-        url: 'https://github.com/Srujan0798/Ultra-Dex/blob/main/%40%20Ultra%20DeX/Saas%20plan/Examples/InvoiceFlow-Complete.md',
+        url: 'https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/Examples/InvoiceFlow-Complete.md',
       },
       {
         name: 'HabitStack',
         type: 'Habit Tracking',
-        url: 'https://github.com/Srujan0798/Ultra-Dex/blob/main/%40%20Ultra%20DeX/Saas%20plan/Examples/HabitStack-Complete.md',
+        url: 'https://github.com/Srujan0798/Ultra-Dex/blob/main/@%20Ultra%20DeX/Saas%20plan/Examples/HabitStack-Complete.md',
       },
     ];
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ultra-dex",
-  "version": "1.0.1",
+  "version": "1.2.0",
   "description": "CLI for Ultra-Dex SaaS Implementation Framework",
   "keywords": [
     "saas",
@@ -33,4 +33,4 @@
     "inquirer": "^9.2.12",
     "ora": "^8.0.1"
   }
-}
+}