create-sdd-project 0.2.0 → 0.2.2

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,43 @@ 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}`,
+  ];
+  if (scan.backend.framework) {
+    stackLines.push(`- **Framework**: ${scan.backend.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',
@@ -326,16 +353,35 @@ function adaptBackendStandards(template, scan) {
   const patternLabel = patternLabels[scan.srcStructure.pattern] || 'Custom';
 
   const archStructure = buildArchitectureTree(scan);
+  // Robust: match any "## Architecture — <anything>" heading up to "## Naming"
   content = content.replace(
-    /## Architecture — DDD Layered\n\n```\n[\s\S]*?```\n\n### Layer Rules\n\n[\s\S]*?(?=\n## Naming)/,
+    /## Architecture — [^\n]+\n\n```\n[\s\S]*?```\n\n(?:### Layer Rules\n\n[\s\S]*?)?(?=\n## Naming)/,
     `## Architecture — ${patternLabel}\n\n\`\`\`\n${archStructure}\`\`\`\n\n<!-- TODO: Add layer rules that match your project's architecture. -->\n\n`
   );
 
   // Update Database Patterns section if not Prisma
-  if (scan.backend.orm && scan.backend.orm !== 'Prisma') {
+  // Robust: match from "## Database Patterns" to next "## " heading
+  if (!scan.backend.orm) {
+    content = content.replace(
+      /## Database Patterns\n\n[\s\S]*?(?=\n## )/,
+      `## Database Patterns\n\n<!-- TODO: Add database access patterns for your project. -->\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`
+      /## Database Patterns\n\n[\s\S]*?(?=\n## )/,
+      `## Database Patterns\n\n<!-- TODO: Add ${scan.backend.orm} best practices and patterns for your project. -->\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'
     );
   }
 
@@ -366,7 +412,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 +429,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 +446,18 @@ function buildArchitectureTree(scan) {
   return lines.join('');
 }
 
+function capitalizeFramework(name) {
+  const map = { jest: 'Jest', vitest: 'Vitest', mocha: 'Mocha', playwright: 'Playwright', cypress: 'Cypress' };
+  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 ---
@@ -418,22 +470,45 @@ function adaptAgentsMd(template, config, scan) {
   const tree = rootDirs.map((d) => `├── ${d.replace(/\/$/, '/')}   `).join('\n');
   const treeBlock = `\`\`\`\nproject/\n${tree}\n└── docs/        ← Documentation\n\`\`\``;
 
+  // Robust: flexible whitespace between CONFIG comment and code block
   content = content.replace(
-    /<!-- CONFIG: Adjust directories.*?-->\n\n```\nproject\/\n[\s\S]*?```/,
+    /<!-- CONFIG: Adjust directories[^>]*-->\n+```\nproject\/\n[\s\S]*?```/,
     treeBlock
   );
 
   // If not monorepo, simplify the install instructions
+  // Robust: match any number of table rows (not hardcoded count)
   if (!scan.isMonorepo) {
     content = content.replace(
-      /\*\*Critical\*\*: NEVER install dependencies in the root directory\.\n\n\| Action.*\n\|.*\n\|.*\n\|.*\n\|.*\n/,
+      /\*\*Critical\*\*: NEVER install dependencies in the root directory\.\n\n(\|.*\n)+/,
       ''
     );
   }
 
+  // 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) {
@@ -458,16 +533,23 @@ function configureKeyFacts(template, config, scan) {
 
   // Technology Stack from scan
   if (scan.backend.detected) {
-    const fw = scan.backend.framework || 'Unknown';
     const runtime = scan.language === 'typescript' ? 'Node.js (TypeScript)' : 'Node.js';
-    content = content.replace('[Framework, runtime, version]', `${fw}, ${runtime}`);
+    const backendLabel = scan.backend.framework
+      ? `${scan.backend.framework}, ${runtime}`
+      : runtime;
+    content = content.replace('[Framework, runtime, version]', backendLabel);
 
-    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 +591,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 +636,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 +684,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/prompts.js

@@ -47,29 +47,29 @@ function askMultiline(rl, question) {
     console.log('  (Enter text below. Empty line to finish, or press Enter to skip)');
     const lines = [];
     let firstLine = true;
+    let done = false;
 
-    const onLine = (line) => {
+    const handler = (line) => {
+      if (done) return;
       if (firstLine && line.trim() === '') {
-        rl.removeListener('line', onLine);
+        done = true;
+        rl.removeListener('line', handler);
         resolve('');
         return;
       }
       firstLine = false;
       if (line.trim() === '') {
-        rl.removeListener('line', onLine);
+        done = true;
+        rl.removeListener('line', handler);
         resolve(lines.join('\n'));
       } else {
         lines.push(line);
+        process.stdout.write('  > ');
       }
     };
 
     process.stdout.write('  > ');
-    rl.on('line', (line) => {
-      if (lines.length > 0 || line.trim() !== '') {
-        process.stdout.write('  > ');
-      }
-      onLine(line);
-    });
+    rl.on('line', handler);
   });
 }
 

package/lib/scanner.js

@@ -67,11 +67,12 @@ function detectBackend(dir, pkg) {
 
   // Framework detection
   const frameworks = [
-    { key: 'express', dep: 'express', label: 'Express' },
-    { key: 'fastify', dep: 'fastify', label: 'Fastify' },
-    { key: 'koa', dep: 'koa', label: 'Koa' },
-    { key: 'nestjs', dep: '@nestjs/core', label: 'NestJS' },
-    { key: 'hapi', dep: '@hapi/hapi', label: 'Hapi' },
+    { dep: 'express', label: 'Express' },
+    { dep: 'fastify', label: 'Fastify' },
+    { dep: 'koa', label: 'Koa' },
+    { dep: '@nestjs/core', label: 'NestJS' },
+    { dep: '@hapi/hapi', label: 'Hapi' },
+    { dep: '@adonisjs/core', label: 'AdonisJS' },
   ];
 
   for (const fw of frameworks) {
@@ -84,11 +85,14 @@ function detectBackend(dir, pkg) {
 
   // ORM detection
   const orms = [
-    { key: 'prisma', dep: '@prisma/client', label: 'Prisma' },
-    { key: 'mongoose', dep: 'mongoose', label: 'Mongoose' },
-    { key: 'typeorm', dep: 'typeorm', label: 'TypeORM' },
-    { key: 'sequelize', dep: 'sequelize', label: 'Sequelize' },
-    { key: 'drizzle', dep: 'drizzle-orm', label: 'Drizzle' },
+    { dep: '@prisma/client', label: 'Prisma' },
+    { dep: 'mongoose', label: 'Mongoose' },
+    { dep: 'typeorm', label: 'TypeORM' },
+    { dep: 'sequelize', label: 'Sequelize' },
+    { dep: 'drizzle-orm', label: 'Drizzle' },
+    { dep: 'knex', label: 'Knex' },
+    { dep: '@mikro-orm/core', label: 'MikroORM' },
+    { dep: 'objection', label: 'Objection.js' },
   ];
 
   for (const orm of orms) {
@@ -129,9 +133,13 @@ function detectFrontend(dir, pkg) {
   const deps = getAllDeps(pkg);
   const result = { detected: false, framework: null, styling: null, components: null, state: null };
 
-  // Framework detection
+  // Framework detection (order matters — more specific first)
   const frameworks = [
     { dep: 'next', label: 'Next.js' },
+    { dep: 'nuxt', label: 'Nuxt' },
+    { dep: '@remix-run/react', label: 'Remix' },
+    { dep: 'astro', label: 'Astro' },
+    { dep: 'solid-js', label: 'SolidJS' },
     { dep: 'react', label: 'React' },
     { dep: 'vue', label: 'Vue' },
     { dep: '@angular/core', label: 'Angular' },
@@ -155,6 +163,8 @@ function detectFrontend(dir, pkg) {
   // Component libraries
   if (deps['@radix-ui/react-dialog'] || deps['@radix-ui/react-select'] || hasRadixDep(deps)) {
     result.components = 'Radix UI';
+  } else if (deps['@headlessui/react']) {
+    result.components = 'Headless UI';
   } else if (deps['@mui/material']) {
     result.components = 'Material UI';
   } else if (deps['@chakra-ui/react']) {
@@ -166,6 +176,8 @@ function detectFrontend(dir, pkg) {
   // State management
   if (deps['zustand']) result.state = 'Zustand';
   else if (deps['@reduxjs/toolkit'] || deps['redux']) result.state = 'Redux';
+  else if (deps['jotai']) result.state = 'Jotai';
+  else if (deps['@tanstack/react-query']) result.state = 'TanStack Query';
   else if (deps['recoil']) result.state = 'Recoil';
   else if (deps['pinia']) result.state = 'Pinia';
   else if (deps['mobx']) result.state = 'MobX';
@@ -231,8 +243,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) {
@@ -277,14 +292,15 @@ function detectTests(dir, pkg) {
   const deps = getAllDeps(pkg);
   const result = {
     framework: 'none',
+    e2eFramework: null,
     hasConfig: false,
     testFiles: 0,
     testDirs: [],
     estimatedCoverage: 'none',
   };
 
-  // Framework detection
-  if (deps['jest'] || deps['@jest/core']) {
+  // Unit test framework detection
+  if (deps['jest'] || deps['@jest/core'] || deps['ts-jest'] || deps['@types/jest']) {
     result.framework = 'jest';
   } else if (deps['vitest']) {
     result.framework = 'vitest';
@@ -292,11 +308,21 @@ function detectTests(dir, pkg) {
     result.framework = 'mocha';
   }
 
+  // E2E test framework detection (supplement, doesn't override unit framework)
+  result.e2eFramework = null;
+  if (deps['@playwright/test'] || deps['playwright']) {
+    result.e2eFramework = 'playwright';
+  } else if (deps['cypress']) {
+    result.e2eFramework = 'cypress';
+  }
+
   // Config files
   const configFiles = [
     'jest.config.js', 'jest.config.ts', 'jest.config.mjs', 'jest.config.cjs',
     'vitest.config.js', 'vitest.config.ts', 'vitest.config.mjs',
     '.mocharc.yml', '.mocharc.json', '.mocharc.js',
+    'playwright.config.ts', 'playwright.config.js',
+    'cypress.config.ts', 'cypress.config.js',
   ];
   result.hasConfig = configFiles.some((f) => fs.existsSync(path.join(dir, f)));
 
@@ -414,7 +440,10 @@ function detectDatabaseFromPrisma(dir) {
     if (fs.existsSync(schemaPath)) {
       try {
         const content = fs.readFileSync(schemaPath, 'utf8');
-        const match = content.match(/provider\s*=\s*"(\w+)"/);
+        // Match provider only within a datasource block (skip generator blocks)
+        const dsBlock = content.match(/datasource\s+\w+\s*\{[^}]*\}/);
+        const providerSource = dsBlock ? dsBlock[0] : content;
+        const match = providerSource.match(/provider\s*=\s*"(\w+)"/);
         if (match) {
           const provider = match[1];
           const dbMap = {
@@ -441,6 +470,7 @@ function detectDatabaseFromEnv(dir) {
     if (fs.existsSync(envPath)) {
       try {
         const content = fs.readFileSync(envPath, 'utf8');
+        // Check DATABASE_URL
         const match = content.match(/DATABASE_URL\s*=\s*(\S+)/);
         if (match) {
           const url = match[1].replace(/["']/g, '');
@@ -449,6 +479,10 @@ function detectDatabaseFromEnv(dir) {
           if (url.startsWith('mysql://')) return 'MySQL';
           if (url.includes('sqlite')) return 'SQLite';
         }
+        // Check MONGODB_URI / MONGO_URI
+        if (/^MONGO(?:DB)?_URI\s*=/m.test(content)) return 'MongoDB';
+        // Check REDIS_URL
+        if (/^REDIS_URL\s*=/m.test(content)) return 'Redis';
       } catch { /* ignore */ }
     }
   }
@@ -463,7 +497,7 @@ function detectPort(dir, pkg) {
     if (fs.existsSync(envPath)) {
       try {
         const content = fs.readFileSync(envPath, 'utf8');
-        const match = content.match(/^PORT\s*=\s*(\d+)/m);
+        const match = content.match(/^PORT\s*=\s*["']?(\d+)/m);
         if (match) return parseInt(match[1], 10);
       } catch { /* ignore */ }
     }

package/package.json

@@ -1,9 +1,9 @@
 {
   "name": "create-sdd-project",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "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"
   }
 }