create-sdd-project 0.2.0 → 0.2.1

package/lib/init-generator.js

@@ -177,12 +177,15 @@ function generateInit(config) {
   // 8. Append to .gitignore
   appendGitignore(dest, skipped);
 
-  // 9. Copy .env.example if not present
-  copyFileIfNotExists(
-    path.join(templateDir, '.env.example'),
-    path.join(dest, '.env.example'),
-    skipped
-  );
+  // 9. Copy and adapt .env.example if not present
+  const envExamplePath = path.join(dest, '.env.example');
+  if (!fs.existsSync(envExamplePath)) {
+    let envContent = fs.readFileSync(path.join(templateDir, '.env.example'), 'utf8');
+    envContent = adaptEnvExample(envContent, config, scan);
+    fs.writeFileSync(envExamplePath, envContent, 'utf8');
+  } else {
+    skipped.push('.env.example');
+  }
 
   // Show skipped files
   if (skipped.length > 0) {
@@ -290,6 +293,12 @@ function safeDelete(filePath) {
 function adaptBackendStandards(template, scan) {
   let content = template;
 
+  // Update frontmatter description to be generic (not "Covers DDD architecture")
+  content = content.replace(
+    /description: Backend development standards.*?\n/,
+    'description: Backend development standards, best practices, and conventions.\n'
+  );
+
   // Add TODO marker after frontmatter
   content = content.replace(
     '<!-- CONFIG: This file defaults to Node.js/Express/Prisma/PostgreSQL. Adjust for your stack. -->',
@@ -298,25 +307,42 @@ function adaptBackendStandards(template, scan) {
 
   // Update globs in frontmatter
   const srcRoot = findSrcRootName(scan);
+  const globPattern = srcRoot ? `${srcRoot}/**/*.{ts,js,tsx,jsx}` : '**/*.{ts,js,tsx,jsx}';
   content = content.replace(
     /globs: \[.*?\]/,
-    `globs: ["${srcRoot}/**/*.{ts,js,tsx,jsx}"]`
+    `globs: ["${globPattern}"]`
   );
 
   // Update Technology Stack
   const framework = scan.backend.framework || 'Unknown';
-  const orm = scan.backend.orm || 'Unknown';
-  const db = scan.backend.db || 'Unknown';
+  const orm = scan.backend.orm;
+  const db = scan.backend.db;
   const lang = scan.language === 'typescript' ? 'TypeScript' : 'JavaScript';
 
+  const testFramework = scan.tests.framework !== 'none'
+    ? capitalizeFramework(scan.tests.framework)
+    : 'Not configured';
+
+  let stackLines = [
+    `- **Runtime**: Node.js with ${lang}`,
+    `- **Framework**: ${framework}`,
+  ];
+  if (orm) {
+    stackLines.push(`- **ORM**: ${orm}${db ? ` (${db})` : ''}`);
+  } else if (db) {
+    stackLines.push(`- **Database**: ${db}`);
+  }
+  stackLines.push(`- **Testing**: ${testFramework}`);
+
   content = content.replace(
     /## Technology Stack\n\n[\s\S]*?(?=\n## Architecture)/,
-    `## Technology Stack\n\n- **Runtime**: Node.js with ${lang}\n- **Framework**: ${framework}\n- **ORM**: ${orm} (${db})\n- **Testing**: ${scan.tests.framework !== 'none' ? scan.tests.framework : 'Not configured'}\n\n`
+    `## Technology Stack\n\n${stackLines.join('\n')}\n\n`
   );
 
   // Update Architecture section
   const patternLabels = {
     mvc: 'MVC',
+    layered: 'Layered',
     ddd: 'DDD Layered',
     'feature-based': 'Feature-Based',
     'handler-based': 'Handler-Based',
@@ -332,13 +358,30 @@ function adaptBackendStandards(template, scan) {
   );
 
   // Update Database Patterns section if not Prisma
-  if (scan.backend.orm && scan.backend.orm !== 'Prisma') {
+  if (!scan.backend.orm) {
+    content = content.replace(
+      /## Database Patterns\n\n### Prisma Best Practices[\s\S]*?### Repository Pattern[\s\S]*?```\n/,
+      `## Database Patterns\n\n<!-- TODO: Add database access patterns for your project. -->\n\n`
+    );
+  } else if (scan.backend.orm !== 'Prisma') {
     content = content.replace(
       /## Database Patterns\n\n### Prisma Best Practices[\s\S]*?### Repository Pattern[\s\S]*?```\n/,
       `## Database Patterns\n\n<!-- TODO: Add ${scan.backend.orm} best practices and patterns for your project. -->\n\n`
     );
   }
 
+  // Replace Prisma-specific references in Security and Performance sections
+  if (scan.backend.orm !== 'Prisma') {
+    content = content.replace(
+      '- Use parameterized queries (Prisma handles this)',
+      '- Use parameterized queries to prevent injection attacks'
+    );
+    content = content.replace(
+      '- Use Prisma `include` instead of N+1 queries',
+      '- Avoid N+1 queries — use eager loading or batch fetching'
+    );
+  }
+
   return content;
 }
 
@@ -366,7 +409,7 @@ function adaptFrontendStandards(template, scan) {
 
   content = content.replace(
     /## Technology Stack\n\n[\s\S]*?(?=\n## Project Structure)/,
-    `## Technology Stack\n\n- **Framework**: ${framework}\n- **Language**: ${lang}\n- **Styling**: ${styling}${components ? `\n- **Components**: ${components.slice(2)}` : ''}${state ? `\n- **State Management**: ${state.slice(2)}` : ''}\n- **Testing**: ${scan.tests.framework !== 'none' ? scan.tests.framework : 'Not configured'}\n\n`
+    `## Technology Stack\n\n- **Framework**: ${framework}\n- **Language**: ${lang}\n- **Styling**: ${styling}${components ? `\n- **Components**: ${components.slice(2)}` : ''}${state ? `\n- **State Management**: ${state.slice(2)}` : ''}\n- **Testing**: ${scan.tests.framework !== 'none' ? capitalizeFramework(scan.tests.framework) : 'Not configured'}\n\n`
   );
 
   // Update Project Structure
@@ -383,14 +426,15 @@ function adaptFrontendStandards(template, scan) {
 function buildArchitectureTree(scan) {
   const srcRoot = findSrcRootName(scan);
   const dirs = scan.srcStructure.dirs;
+  const rootLabel = srcRoot || 'project';
 
   if (dirs.length === 0) {
-    return `${srcRoot}/\n└── <!-- TODO: Map your project structure here -->\n`;
+    return `${rootLabel}/\n└── <!-- TODO: Map your project structure here -->\n`;
   }
 
   // Build a simple tree from detected directories (depth 1 only)
   const topLevel = dirs.filter((d) => !d.includes('/'));
-  const lines = [`${srcRoot}/\n`];
+  const lines = [`${rootLabel}/\n`];
   topLevel.forEach((dir, i) => {
     const prefix = i === topLevel.length - 1 ? '└── ' : '├── ';
     lines.push(`${prefix}${dir}/\n`);
@@ -399,13 +443,18 @@ function buildArchitectureTree(scan) {
   return lines.join('');
 }
 
+function capitalizeFramework(name) {
+  const map = { jest: 'Jest', vitest: 'Vitest', mocha: 'Mocha' };
+  return map[name] || name;
+}
+
 function findSrcRootName(scan) {
   // Determine the source root directory name from scan
   if (scan.rootDirs.includes('src/')) return 'src';
   if (scan.rootDirs.includes('app/')) return 'app';
   if (scan.rootDirs.includes('server/')) return 'server';
   if (scan.rootDirs.includes('lib/')) return 'lib';
-  return 'src';
+  return null; // No conventional source root — code is at project root
 }
 
 // --- AGENTS.md Adaptation ---
@@ -431,9 +480,30 @@ function adaptAgentsMd(template, config, scan) {
     );
   }
 
+  // Adapt Standards References descriptions
+  if (scan.backend.detected) {
+    const parts = [scan.srcStructure.pattern ? patternLabelFor(scan.srcStructure.pattern) : null, scan.backend.framework, scan.backend.orm].filter(Boolean);
+    content = content.replace(
+      'Backend patterns (DDD, Express, Prisma)',
+      `Backend patterns (${parts.join(', ')})`
+    );
+  }
+  if (scan.frontend.detected) {
+    const parts = [scan.frontend.framework, scan.frontend.styling, scan.frontend.components].filter(Boolean);
+    content = content.replace(
+      'Frontend patterns (Next.js, Tailwind, Radix)',
+      `Frontend patterns (${parts.join(', ')})`
+    );
+  }
+
   return content;
 }
 
+function patternLabelFor(pattern) {
+  const map = { mvc: 'MVC', layered: 'Layered', ddd: 'DDD', 'feature-based': 'Feature-Based', 'handler-based': 'Handler-Based', flat: 'Flat', unknown: null };
+  return map[pattern] || null;
+}
+
 // --- key_facts.md Configuration ---
 
 function configureKeyFacts(template, config, scan) {
@@ -462,12 +532,17 @@ function configureKeyFacts(template, config, scan) {
     const runtime = scan.language === 'typescript' ? 'Node.js (TypeScript)' : 'Node.js';
     content = content.replace('[Framework, runtime, version]', `${fw}, ${runtime}`);
 
-    const db = scan.backend.db || 'Unknown';
-    const port = scan.backend.port || config.backendPort;
-    content = content.replace('[Type, host, port]', `${db}, localhost, ${port}`);
+    if (scan.backend.db) {
+      content = content.replace('[Type, host, port]', scan.backend.db);
+    } else {
+      content = content.replace('- **Database**: [Type, host, port]\n', '');
+    }
 
-    const orm = scan.backend.orm || 'Unknown';
-    content = content.replace('[Name, version]', orm);
+    if (scan.backend.orm) {
+      content = content.replace('[Name, version]', scan.backend.orm);
+    } else {
+      content = content.replace('- **ORM**: [Name, version]\n', '');
+    }
   }
 
   if (scan.frontend.detected) {
@@ -509,6 +584,28 @@ function configureKeyFacts(template, config, scan) {
     content = content.replace('## Technology Stack', `${contextSection}\n## Technology Stack`);
   }
 
+  // Remove irrelevant Infrastructure lines based on project type
+  if (!scan.frontend.detected) {
+    content = content.replace('- **Frontend Hosting**: [e.g., Vercel]\n', '');
+  }
+  if (!scan.backend.detected) {
+    content = content.replace('- **Backend Hosting**: [e.g., Render]\n', '');
+    content = content.replace('- **Database Hosting**: [e.g., Neon, Supabase, RDS]\n', '');
+  }
+
+  // Adapt DB hosting examples based on detected database
+  if (scan.backend.db === 'MongoDB') {
+    content = content.replace('[e.g., Neon, Supabase, RDS]', '[e.g., MongoDB Atlas, Cosmos DB]');
+  }
+
+  // Remove irrelevant Reusable Components subsections
+  if (!scan.frontend.detected) {
+    content = content.replace('\n### Frontend\n- [List key components, hooks, stores as you build them]\n', '');
+  }
+  if (!scan.backend.detected) {
+    content = content.replace('\n### Backend\n- [List key services, middleware, validators as you build them]\n', '');
+  }
+
   // Prisma schema reference
   if (scan.existingDocs.hasPrismaSchema) {
     content = content.replace(
@@ -532,6 +629,20 @@ function configureSprintTracker(template, scan) {
   const end = endDate.toISOString().split('T')[0];
   content = content.replace(/\[YYYY-MM-DD\] to \[YYYY-MM-DD\]/, `${today} to ${end}`);
 
+  // Remove irrelevant task tables based on detected stack
+  if (!scan.frontend.detected) {
+    content = content.replace(
+      /\n### Frontend\n\n\| # \| Task \| Status \| Notes \|\n\|---\|------\|--------\|-------\|\n\| F0\.1 \| \[Task description\] \| ⬚ \| \|\n/,
+      ''
+    );
+  }
+  if (!scan.backend.detected) {
+    content = content.replace(
+      /\n### Backend\n\n\| # \| Task \| Status \| Notes \|\n\|---\|------\|--------\|-------\|\n\| B0\.1 \| \[Task description\] \| ⬚ \| \|\n/,
+      ''
+    );
+  }
+
   // Add retrofit testing tasks if coverage is low
   if (scan.tests.estimatedCoverage === 'none' || scan.tests.estimatedCoverage === 'low') {
     const retrofitSection = `\n### Retrofit Testing (recommended)\n\n| # | Task | Status | Notes |\n|---|------|--------|-------|\n| R0.1 | Audit existing test coverage | ⬚ | |\n| R0.2 | Add missing unit tests for critical paths | ⬚ | |\n| R0.3 | Set up CI test pipeline | ⬚ | |\n`;
@@ -566,6 +677,38 @@ function updateAutonomy(dest, config) {
   }
 }
 
+// --- .env.example Adaptation ---
+
+function adaptEnvExample(template, config, scan) {
+  let content = template;
+  const port = scan.backend.port || config.backendPort || 3010;
+
+  // Adapt port
+  content = content.replace('PORT=3010', `PORT=${port}`);
+  content = content.replace('localhost:3010', `localhost:${port}`);
+
+  // Adapt DATABASE_URL based on detected DB
+  if (scan.backend.db === 'MongoDB') {
+    content = content.replace(
+      'DATABASE_URL=postgresql://user:password@localhost:5432/dbname',
+      'MONGODB_URI=mongodb://localhost:27017/dbname'
+    );
+  }
+
+  // Remove frontend section if backend-only
+  if (!scan.frontend.detected) {
+    content = content.replace(/\n# Frontend\nNEXT_PUBLIC_API_URL=.*\n/, '\n');
+  }
+
+  // Remove backend section if frontend-only
+  if (!scan.backend.detected) {
+    content = content.replace(/# Backend\nNODE_ENV=.*\nPORT=.*\nDATABASE_URL=.*\n/, '');
+    content = content.replace(/# Backend\nNODE_ENV=.*\nPORT=.*\nMONGODB_URI=.*\n/, '');
+  }
+
+  return content;
+}
+
 // --- .gitignore ---
 
 function appendGitignore(dest, skipped) {

package/lib/scanner.js

@@ -231,8 +231,11 @@ function detectArchitecture(dir, pkg) {
   result.hasHandlers = dirNames.has('handlers') || dirNames.has('handler');
 
   // Determine pattern
+  const hasManagers = dirNames.has('managers') || dirNames.has('manager');
   if (result.hasDomain && (dirNames.has('application') || dirNames.has('infrastructure'))) {
     result.pattern = 'ddd';
+  } else if (result.hasHandlers && result.hasControllers && hasManagers) {
+    result.pattern = 'layered';
   } else if (result.hasControllers && result.hasModels) {
     result.pattern = 'mvc';
   } else if (result.hasFeatures) {
@@ -284,7 +287,7 @@ function detectTests(dir, pkg) {
   };
 
   // Framework detection
-  if (deps['jest'] || deps['@jest/core']) {
+  if (deps['jest'] || deps['@jest/core'] || deps['ts-jest'] || deps['@types/jest']) {
     result.framework = 'jest';
   } else if (deps['vitest']) {
     result.framework = 'vitest';

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "create-sdd-project",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Create a new SDD DevFlow project with AI-assisted development workflow",
   "bin": {
-    "create-sdd-project": "./bin/cli.js"
+    "create-sdd-project": "bin/cli.js"
   },
   "scripts": {
     "test": "node test/smoke.js",
@@ -36,6 +36,10 @@
   "license": "MIT",
   "repository": {
     "type": "git",
-    "url": "https://github.com/pbojeda/sdd-devflow.git"
+    "url": "git+https://github.com/pbojeda/sdd-devflow.git"
+  },
+  "homepage": "https://github.com/pbojeda/sdd-devflow#readme",
+  "bugs": {
+    "url": "https://github.com/pbojeda/sdd-devflow/issues"
   }
 }