create-sdd-project 0.6.0 → 0.6.1

package/README.md

@@ -168,6 +168,17 @@ npx create-sdd-project --doctor
 
 Exit code 1 if errors found — useful for CI pipelines.
 
+### CI/CD (Auto-Generated)
+
+Every project gets a GitHub Actions CI workflow at `.github/workflows/ci.yml`, adapted to your stack:
+
+- **PostgreSQL** projects get a `postgres:16` service with health checks
+- **MongoDB** projects get a `mongo:7` service with health checks
+- **Frontend-only** projects get a lightweight workflow without DB services
+- **GitFlow** projects trigger on both `main` and `develop` branches
+
+Customize the generated workflow as your project grows.
+
 ### After Setup
 
 Open your project in Claude Code or Gemini and start building:
@@ -313,6 +324,9 @@ project/
 ├── GEMINI.md                            # Gemini config (autonomy)
 ├── .env.example                         # Environment variables template
 │
+├── .github/
+│   └── workflows/ci.yml                 # CI pipeline (adapted to your stack)
+│
 ├── .claude/
 │   ├── agents/                          # 9 specialized agents
 │   ├── skills/

package/lib/generator.js

@@ -66,6 +66,10 @@ function generate(config) {
     adaptAgentContent(dest, config);
   }
 
+  // 7c. Adapt CI workflow for project type and stack
+  step('Configuring CI workflow');
+  adaptCiWorkflow(dest, config);
+
   // 8. Remove AI tool config if single tool selected
   if (config.aiTools === 'claude') {
     step('Removing Gemini config (Claude only)');
@@ -350,4 +354,46 @@ function adaptAgentContent(dest, config) {
   adaptAgentContentForProjectType(dest, config, replaceInFile);
 }
 
+function adaptCiWorkflow(dest, config) {
+  const ciPath = path.join(dest, '.github', 'workflows', 'ci.yml');
+  if (!fs.existsSync(ciPath)) return;
+
+  const bPreset = config.backendPreset || BACKEND_STACKS[0];
+
+  // Adapt branches for gitflow
+  if (config.branching === 'gitflow') {
+    replaceInFile(ciPath, [
+      ['branches: [main]', 'branches: [main, develop]'],
+    ]);
+  }
+
+  // Adapt DB services based on stack
+  if (config.projectType === 'frontend') {
+    // Frontend-only: remove services and DATABASE_URL
+    replaceInFile(ciPath, [
+      [/\n    # -- Database service.*?--health-retries=5\n/s, ''],
+      [/\n      DATABASE_URL:.*\n/, '\n'],
+    ]);
+  } else if (bPreset.db === 'MongoDB') {
+    // MongoDB: replace postgres service with mongo
+    replaceInFile(ciPath, [
+      [/    # -- Database service.*?--health-retries=5\n/s,
+        `    # -- Database service (remove if not needed) --\n` +
+        `    services:\n` +
+        `      mongodb:\n` +
+        `        image: mongo:7\n` +
+        `        ports:\n` +
+        `          - 27017:27017\n` +
+        `        options: >-\n` +
+        `          --health-cmd="mongosh --eval 'db.runCommand({ping:1})'"\n` +
+        `          --health-interval=10s\n` +
+        `          --health-timeout=5s\n` +
+        `          --health-retries=5\n`],
+      ['DATABASE_URL: postgresql://test:test@localhost:5432/testdb',
+        'MONGODB_URI: mongodb://localhost:27017/testdb'],
+    ]);
+  }
+  // Default (PostgreSQL) — template already has correct services
+}
+
 module.exports = { generate };

package/lib/init-generator.js

@@ -184,7 +184,20 @@ function generateInit(config) {
   // 8. Append to .gitignore
   appendGitignore(dest, skipped);
 
-  // 9. Copy and adapt .env.example if not present
+  // 9. Copy CI workflow if not present
+  const githubDir = path.join(dest, '.github', 'workflows');
+  const ciPath = path.join(githubDir, 'ci.yml');
+  if (!fs.existsSync(ciPath)) {
+    step('Creating .github/workflows/ci.yml');
+    ensureDir(githubDir);
+    let ciContent = fs.readFileSync(path.join(templateDir, '.github', 'workflows', 'ci.yml'), 'utf8');
+    ciContent = adaptCiWorkflowContent(ciContent, config, scan);
+    fs.writeFileSync(ciPath, ciContent, 'utf8');
+  } else {
+    skipped.push('.github/workflows/ci.yml');
+  }
+
+  // 10. 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');
@@ -950,6 +963,47 @@ function updateAutonomy(dest, config) {
   }
 }
 
+// --- CI Workflow Adaptation ---
+
+function adaptCiWorkflowContent(template, config, scan) {
+  let content = template;
+
+  // Adapt branches for gitflow
+  if (config.branching === 'gitflow') {
+    content = content.replaceAll('branches: [main]', 'branches: [main, develop]');
+  }
+
+  // Adapt DB services based on detected stack
+  if (!scan.backend.detected) {
+    // Frontend-only: remove services block and DATABASE_URL
+    content = content.replace(/\n    # -- Database service.*?--health-retries=5\n/s, '');
+    content = content.replace(/\n      DATABASE_URL:.*\n/, '\n');
+  } else if (scan.backend.db === 'MongoDB') {
+    // MongoDB: replace postgres service with mongo
+    content = content.replace(
+      /    # -- Database service.*?--health-retries=5\n/s,
+      `    # -- Database service (remove if not needed) --\n` +
+      `    services:\n` +
+      `      mongodb:\n` +
+      `        image: mongo:7\n` +
+      `        ports:\n` +
+      `          - 27017:27017\n` +
+      `        options: >-\n` +
+      `          --health-cmd="mongosh --eval 'db.runCommand({ping:1})'"\n` +
+      `          --health-interval=10s\n` +
+      `          --health-timeout=5s\n` +
+      `          --health-retries=5\n`
+    );
+    content = content.replace(
+      'DATABASE_URL: postgresql://test:test@localhost:5432/testdb',
+      'MONGODB_URI: mongodb://localhost:27017/testdb'
+    );
+  }
+  // Default (PostgreSQL) — template already has correct services
+
+  return content;
+}
+
 // --- .env.example Adaptation ---
 
 function adaptEnvExample(template, config, scan) {
@@ -1008,6 +1062,7 @@ module.exports = {
   adaptAgentsMd,
   adaptCopiedFiles,
   adaptEnvExample,
+  adaptCiWorkflowContent,
   updateAutonomy,
   regexReplaceInFile,
 };

package/lib/upgrade-generator.js

@@ -16,6 +16,7 @@ const {
   adaptAgentsMd,
   adaptCopiedFiles,
   adaptEnvExample,
+  adaptCiWorkflowContent,
   updateAutonomy,
   regexReplaceInFile,
 } = require('./init-generator');
@@ -408,6 +409,17 @@ function generateUpgrade(config) {
 
   step('Replaced AGENTS.md, CLAUDE.md/GEMINI.md, .env.example');
 
+  // --- e2) CI workflow — only add if not present (user may have customized) ---
+  const ciPath = path.join(dest, '.github', 'workflows', 'ci.yml');
+  if (!fs.existsSync(ciPath)) {
+    fs.mkdirSync(path.join(dest, '.github', 'workflows'), { recursive: true });
+    let ciContent = fs.readFileSync(path.join(templateDir, '.github', 'workflows', 'ci.yml'), 'utf8');
+    ciContent = adaptCiWorkflowContent(ciContent, config, scan);
+    fs.writeFileSync(ciPath, ciContent, 'utf8');
+    step('Added .github/workflows/ci.yml');
+    replaced++;
+  }
+
   // --- f) Adapt for project type ---
   // Remove agents for single-stack projects
   if (projectType === 'backend') {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-sdd-project",
-  "version": "0.6.0",
+  "version": "0.6.1",
   "description": "Create a new SDD DevFlow project with AI-assisted development workflow",
   "bin": {
     "create-sdd-project": "bin/cli.js"

package/template/.github/workflows/ci.yml

@@ -0,0 +1,56 @@
+# ===========================================
+# CI Pipeline — Generated by SDD DevFlow
+# ===========================================
+# Runs on pushes and PRs to main branch.
+# Customize steps as your project grows.
+
+name: CI
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  ci:
+    runs-on: ubuntu-latest
+
+    # -- Database service (remove if not needed) --
+    services:
+      postgres:
+        image: postgres:16
+        env:
+          POSTGRES_USER: test
+          POSTGRES_PASSWORD: test
+          POSTGRES_DB: testdb
+        ports:
+          - 5432:5432
+        options: >-
+          --health-cmd="pg_isready"
+          --health-interval=10s
+          --health-timeout=5s
+          --health-retries=5
+
+    env:
+      NODE_ENV: test
+      DATABASE_URL: postgresql://test:test@localhost:5432/testdb
+
+    steps:
+      - uses: actions/checkout@v4
+
+      - uses: actions/setup-node@v4
+        with:
+          node-version: 20
+          cache: npm
+
+      - run: npm ci
+
+      - name: Lint
+        run: npm run lint --if-present
+
+      - name: Test
+        run: npm test --if-present
+
+      - name: Build
+        run: npm run build --if-present