@specverse/engine-realize 3.5.3

package/assets/templates/full-stack/manifests/implementation.yaml

@@ -0,0 +1,155 @@
+# SpecVerse v3.3 Implementation Manifest
+# Defines technology stack using implementation types and capability mappings
+
+manifests:
+  {{projectNameKebab}}Implementation:
+    specVersion: "3.3.0"
+    name: "{{projectNameKebab}}-implementation"
+    version: "1.0.0"
+    description: "Development implementation manifest for {{projectName}}"
+
+    # v3.3: Deployment reference
+    deployment:
+      deploymentSource: "../specs/main.specly"
+      deploymentName: "development"
+
+    # v3.3: Default technology stack mappings
+    defaultMappings:
+      storage: "PostgreSQL15"
+      controller: "PrismaServices"
+      service: "PrismaServices"
+      routing: "FastifyAPI"
+      orm: "PrismaORM"
+      communication: "EventEmitter"
+
+    # v3.3: Map deployment instance capabilities to implementation types
+    capabilityMappings:
+      # API Layer - Fastify REST API (routing)
+      - capability: "api.rest"
+        instanceFactory: "FastifyAPI"
+
+      # Business Logic Layer - PrismaServices (controllers + services)
+      - capability: "service.controller"
+        instanceFactory: "PrismaServices"
+
+      - capability: "service.business"
+        instanceFactory: "PrismaServices"
+
+      - capability: "service.crud"
+        instanceFactory: "PrismaServices"
+
+      # Data Layer - PostgreSQL + Prisma
+      - capability: "storage.database"
+        instanceFactory: "PostgreSQL15"
+
+      # ORM - Prisma (schema + client)
+      - capability: "orm.schema"
+        instanceFactory: "PrismaORM"
+
+      - capability: "orm.client"
+        instanceFactory: "PrismaORM"
+
+      - capability: "orm.prisma"
+        instanceFactory: "PrismaORM"
+
+      # Events - In-memory for development
+      - capability: "messaging.pubsub"
+        instanceFactory: "EventEmitter"
+
+      - capability: "messaging.events"
+        instanceFactory: "EventEmitter"
+
+      # Validation - Zod
+      - capability: "validation.runtime"
+        instanceFactory: "ZodValidation"
+
+      - capability: "validation.schema"
+        instanceFactory: "ZodValidation"
+
+      # Project Scaffolding (generates package.json, tsconfig.json, etc.)
+      - capability: "project.scaffold"
+        instanceFactory: "GenericScaffold"
+
+      # Application Entry Point (generates src/main.ts)
+      - capability: "app.entrypoint"
+        instanceFactory: "GenericApp"
+
+    # v3.3: Configuration section
+    configuration:
+      # Environment-specific settings
+      environments:
+        development:
+          database:
+            provider: "postgresql"
+            url: "postgresql://localhost:5432/{{projectNameKebab}}_dev"
+          server:
+            port: 3000
+            host: "localhost"
+            logLevel: "debug"
+          features:
+            hotReload: true
+            debugMode: true
+
+        test:
+          database:
+            provider: "postgresql"
+            url: "postgresql://localhost:5432/{{projectNameKebab}}_test"
+          server:
+            port: 3001
+            host: "localhost"
+            logLevel: "silent"
+
+        production:
+          database:
+            provider: "postgresql"
+            url: "${DATABASE_URL}"
+          server:
+            port: "${PORT:-8080}"
+            host: "0.0.0.0"
+            logLevel: "info"
+          middleware:
+            rateLimit:
+              max: 1000
+              timeWindow: "1 minute"
+            compression: true
+
+      # Authentication configuration
+      authentication:
+        enabled: true
+        provider: "jwt"
+        secret: "${JWT_SECRET}"
+        expiresIn: "7d"
+
+      # CORS configuration
+      cors:
+        origin: "*"  # Change to specific domains in production
+        credentials: true
+        methods: ["GET", "POST", "PUT", "DELETE", "PATCH"]
+
+      # Validation configuration
+      validation:
+        enabled: true
+        provider: "zod"
+        stripUnknown: true
+        abortEarly: false
+
+      # Logging configuration
+      logging:
+        level: "info"
+        pretty: true
+        destinations:
+          - type: "console"
+          - type: "file"
+            path: "logs/{{projectNameKebab}}.log"
+
+      # Code generation options
+      generation:
+        outputDir: "./generated/code"
+        typescript: true
+        validation: true
+        tests: false
+        documentation: true
+        metadata:
+          idStrategy: "uuid"
+          auditFields: true
+          softDeleteStrategy: "deletedAt"

package/assets/templates/full-stack/manifests/kubernetes.specly

@@ -0,0 +1,140 @@
+# Kubernetes Implementation Manifest
+# SpecVerse v3.3 manifest specification for Kubernetes deployment
+
+manifests:
+  KubernetesManifest:
+    specVersion: "3.3.0"
+    name: "{{componentName}}KubernetesManifest"
+    version: "1.0.0"
+    description: "Kubernetes implementation manifest for {{projectName}}"
+
+    # v3.3: Deployment reference (REQUIRED)
+    deployment:
+      deploymentSource: "./specs/main.specly"
+      deploymentName: "production"
+
+    # v3.3: Default technology mappings
+    defaultMappings:
+      storage: "PostgreSQL15"
+      controller: "KubernetesApp"
+
+    # v3.3: Capability to implementation factory mappings
+    capabilityMappings:
+      - capability: "api.*"
+        instanceFactory: "KubernetesController"
+
+      - capability: "database.*"
+        instanceFactory: "KubernetesDatabase"
+
+      - capability: "networking.*"
+        instanceFactory: "KubernetesService"
+
+    # v3.3: Instance-specific mappings (optional - for fine-grained control)
+    instanceMappings:
+      - instanceName: "webApp"
+        instanceFactory: "KubernetesController"
+
+      - instanceName: "appDatabase"
+        instanceFactory: "KubernetesDatabase"
+
+      - instanceName: "webService"
+        instanceFactory: "KubernetesService"
+
+    # v3.3: Platform-specific configuration
+    configuration:
+      # Kubernetes specific settings
+      clusterVersion: "v1.28"
+
+      # Implementation factory definitions
+      implementationFactories:
+        KubernetesController:
+          type: "controller"
+          technology: "kubernetes"
+          framework: "deployment"
+          config:
+            apiVersion: "apps/v1"
+            kind: "Deployment"
+            replicas: 3
+            image: "{{projectNameKebab}}:latest"
+            containerPort: 3000
+            resources:
+              requests:
+                memory: "128Mi"
+                cpu: "100m"
+              limits:
+                memory: "256Mi"
+                cpu: "200m"
+
+        KubernetesDatabase:
+          type: "database"
+          technology: "postgresql"
+          framework: "kubernetes-operator"
+          config:
+            apiVersion: "postgresql.cnpg.io/v1"
+            kind: "Cluster"
+            instances: 3
+            postgresql:
+              parameters:
+                max_connections: "100"
+                shared_buffers: "128MB"
+            storage:
+              size: "10Gi"
+              storageClass: "fast-ssd"
+
+        KubernetesService:
+          type: "service"
+          technology: "kubernetes"
+          framework: "service"
+          config:
+            apiVersion: "v1"
+            kind: "Service"
+            serviceType: "ClusterIP"
+            ports:
+              - port: 80
+                targetPort: 3000
+                protocol: "TCP"
+
+      # Horizontal Pod Autoscaling
+      scaling:
+        horizontal:
+          enabled: true
+          minReplicas: 3
+          maxReplicas: 10
+          targetCPUUtilization: 70
+
+      # Monitoring configuration
+      monitoring:
+        prometheus: true
+        grafana: true
+        alerts:
+          - name: "high-cpu"
+            threshold: "80%"
+          - name: "high-memory"
+            threshold: "85%"
+
+      # Namespace configuration
+      namespace:
+        strategy: "environment-based"
+        name: "{{projectNameKebab}}"
+        description: "Production application namespace"
+        isolation: "strict"
+        resourceLimits:
+          cpu: "2"
+          memory: "4Gi"
+          storage: "50Gi"
+        securityPolicy: "restricted"
+
+      # AI implementation instructions
+      aiInstructions: |
+        When implementing this Kubernetes deployment:
+
+        1. **Production Ready**: Configured for production with multiple replicas
+        2. **Resource Management**: CPU and memory limits defined
+        3. **Horizontal Scaling**: HPA configured for automatic scaling
+        4. **Database**: PostgreSQL with operator for high availability
+        5. **Networking**: ClusterIP service for internal communication
+        6. **Security**: Restricted security policy and namespace isolation
+        7. **Monitoring**: Prometheus and Grafana integration
+        8. **Storage**: Persistent volumes for database data
+        9. **Health Checks**: Configure readiness and liveness probes
+        10. **Secrets**: Use Kubernetes secrets for sensitive data

package/assets/templates/full-stack/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "{{projectNameKebab}}",
+  "version": "0.1.0",
+  "description": "{{projectName}} - SpecVerse Project",
+  "scripts": {
+    "validate": "specverse validate specs/main.specly",
+    "validate:all": "npm run validate && npm run validate:manifests",
+    "validate:manifests": "specverse validate manifests/docker-compose.specly && specverse validate manifests/kubernetes.specly",
+    "infer": "specverse infer specs/main.specly -o generated/{{projectNameKebab}}-complete.specly",
+    "infer:deployment": "specverse infer specs/main.specly --deployment --environment development -o generated/{{projectNameKebab}}-deployed.specly",
+    "infer:deployment:prod": "specverse infer specs/main.specly --deployment --environment production -o generated/{{projectNameKebab}}-deployed-prod.specly",
+    "infer:docs": "specverse gen docs generated/{{projectNameKebab}}-complete.specly --output generated/docs/complete-docs.md && specverse gen diagram generated/{{projectNameKebab}}-complete.specly --output generated/docs/complete-diagrams",
+    "infer:deployment:docs": "specverse gen docs generated/{{projectNameKebab}}-deployed.specly --output generated/docs/deployed-docs.md && specverse gen diagram generated/{{projectNameKebab}}-deployed.specly --output generated/docs/deployed-diagrams",
+    "infer:deployment:prod:docs": "specverse gen docs generated/{{projectNameKebab}}-deployed-prod.specly --output generated/docs/deployed-prod-docs.md && specverse gen diagram generated/{{projectNameKebab}}-deployed-prod.specly --output generated/docs/deployed-prod-diagrams",
+    "generate:diagrams": "specverse gen diagram specs/main.specly --output docs/diagrams",
+    "generate:diagram:er": "specverse gen diagram specs/main.specly -t er-diagram -o docs/diagrams/er-diagram.mmd",
+    "generate:diagram:event-flow": "specverse gen diagram specs/main.specly -t event-flow-layered -o docs/diagrams/event-flow-layered.mmd",
+    "generate:diagram:lifecycle": "specverse gen diagram specs/main.specly -t lifecycle -o docs/diagrams/lifecycle.mmd",
+    "generate:diagram:deployment": "specverse gen diagram specs/main.specly -t deployment-topology -o docs/diagrams/deployment.mmd",
+    "generate:diagram:architecture": "specverse gen diagram specs/main.specly -t model-architecture -o docs/diagrams/architecture.mmd",
+    "generate:docs": "specverse gen docs specs/main.specly --output docs/main-docs.md",
+    "generate:complete": "npm run infer && npm run infer:docs",
+    "process": "specverse gen yaml specs/main.specly -o generated/{{projectNameKebab}}-processed.yaml",
+    "format": "specverse dev format specs/main.specly --write",
+    "build": "npm run validate && npm run infer",
+    "build:full": "npm run validate && npm run infer:deployment && npm run generate:diagrams",
+    "build:complete": "npm run validate && npm run infer && npm run infer:deployment && npm run generate:diagrams && npm run generate:docs",
+    "dev": "npm run validate && npm run infer",
+    "test": "./scripts/test-all.sh",
+    "realize:orm": "specverse realize orm specs/main.specly -m manifests/implementation.yaml",
+    "realize:services": "specverse realize services specs/main.specly -m manifests/implementation.yaml",
+    "realize:routes": "specverse realize routes specs/main.specly -m manifests/implementation.yaml",
+    "realize:all": "specverse realize all specs/main.specly -m manifests/implementation.yaml -o generated/code",
+    "test:generated:compile": "cd generated/code && npx tsc --noEmit --skipLibCheck 2>&1 || echo 'TypeScript compilation check (some errors expected without npm install)'",
+    "test:generated:run": "cd generated/code && npm install && npm run db:generate && echo 'Generated code is ready to run with: npm run dev'",
+    "_comment_realize": "Use 'realize:all' to generate complete runnable project (ORM, services, routes, scaffolding, main.ts)",
+    "_comment_generated": "After realize:all, run 'test:generated:run' to set up the generated project"
+  },
+  "keywords": ["specverse", "specification", "ai", "inference"],
+  "devDependencies": {
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/assets/templates/full-stack/scripts/test-all.sh

@@ -0,0 +1,160 @@
+#!/bin/bash
+
+# SpecVerse Comprehensive Test Script
+# Tests all commands and validates generated specifications
+
+set -e  # Exit on any error
+
+echo "🚀 Starting comprehensive SpecVerse test..."
+
+# Create necessary directories
+mkdir -p generated docs/diagrams generated/docs generated/code
+
+# Step 1: Validate original specification
+echo "📋 Step 1: Validating original specification..."
+npm run validate
+
+# Step 2: Generate complete specification and validate it
+echo "🧠 Step 2: Generating and validating complete specification..."
+npm run infer
+specverse validate generated/{{projectNameKebab}}-complete.specly
+
+# Step 3: Generate development deployment and validate it
+echo "🏗️ Step 3: Generating and validating development deployment..."
+npm run infer:deployment
+specverse validate generated/{{projectNameKebab}}-deployed.specly
+
+# Step 4: Generate production deployment and validate it
+echo "🏭 Step 4: Generating and validating production deployment..."
+npm run infer:deployment:prod
+specverse validate generated/{{projectNameKebab}}-deployed-prod.specly
+
+# Step 5: Generate documentation and diagrams for original spec
+echo "📚 Step 5: Generating docs and diagrams for original specification..."
+npm run generate:docs
+npm run generate:diagrams
+
+# Step 6: Generate documentation for all inferred specifications
+echo "📖 Step 6: Generating docs for all inferred specifications..."
+npm run infer:docs
+npm run infer:deployment:docs
+npm run infer:deployment:prod:docs
+
+# Step 7: Test YAML processing
+echo "⚙️ Step 7: Testing YAML processing..."
+npm run process
+
+# Step 8: Test v3.3 Code Realization (NEW)
+echo "🔧 Step 8: Testing v3.3 code realization..."
+echo "   → Generating complete runnable project..."
+npm run realize:all
+
+# Verify generated project structure
+echo "   → Verifying generated project..."
+if [ -f "generated/code/package.json" ]; then
+  echo "   ✅ package.json generated"
+fi
+
+if [ -f "generated/code/tsconfig.json" ]; then
+  echo "   ✅ tsconfig.json generated"
+fi
+
+if [ -f "generated/code/.env.example" ]; then
+  echo "   ✅ .env.example generated"
+fi
+
+if [ -f "generated/code/README.md" ]; then
+  echo "   ✅ README.md generated"
+fi
+
+# Check for backend structure
+if [ -d "generated/code/backend" ]; then
+  echo "   ✅ Backend directory generated"
+
+  if [ -f "generated/code/backend/src/main.ts" ]; then
+    echo "   ✅ Backend entry point (backend/src/main.ts) generated"
+  fi
+
+  # Check for ORM schema (Prisma for default template)
+  if [ -f "generated/code/backend/prisma/schema.prisma" ]; then
+    echo "   ✅ Prisma ORM schema generated"
+  elif [ -d "generated/code/backend/src/entities" ] || [ -d "generated/code/backend/src/models" ]; then
+    echo "   ✅ ORM schema generated"
+  fi
+
+  if [ -d "generated/code/backend/src/controllers" ]; then
+    echo "   ✅ Controllers generated"
+  fi
+
+  if [ -d "generated/code/backend/src/routes" ]; then
+    echo "   ✅ Route handlers generated"
+  fi
+fi
+
+# Check for frontend structure
+if [ -d "generated/code/frontend" ]; then
+  echo "   ✅ Frontend directory generated"
+
+  if [ -f "generated/code/frontend/src/main.tsx" ]; then
+    echo "   ✅ Frontend entry point (frontend/src/main.tsx) generated"
+  fi
+
+  if [ -d "generated/code/frontend/src/components" ]; then
+    echo "   ✅ React components generated"
+  fi
+fi
+
+# Check for v3.3 CURVED features in generated code
+if [ -d "generated/code/backend/src/controllers" ]; then
+  # Check for unified validation method (v3.3)
+  if grep -q "validate(.*context.*operation" generated/code/backend/src/controllers/*.ts 2>/dev/null; then
+    echo "   ✅ v3.3 unified validation method present"
+  fi
+
+  # Check for delete operation (not destroy)
+  if grep -q "async delete(id:" generated/code/backend/src/controllers/*.ts 2>/dev/null; then
+    echo "   ✅ v3.3 delete operation present (CURVED)"
+  fi
+
+  # Check for retrieveAll method (list operation)
+  if grep -q "async retrieveAll" generated/code/backend/src/controllers/*.ts 2>/dev/null; then
+    echo "   ✅ v3.3 retrieveAll method present (CURVED)"
+  fi
+fi
+
+# Check for validate endpoint in routes
+if [ -d "generated/code/backend/src/routes" ]; then
+  if grep -q "'/validate'" generated/code/backend/src/routes/*.ts 2>/dev/null; then
+    echo "   ✅ v3.3 validate endpoint present (CURVED)"
+  fi
+fi
+
+echo ""
+echo "✅ All SpecVerse commands tested successfully!"
+echo "✅ All generated specifications are valid and documented."
+echo ""
+echo "📊 Test Summary:"
+echo "   - Original specification: validated"
+echo "   - Complete specification: generated and validated"
+echo "   - Development deployment: generated and validated"
+echo "   - Production deployment: generated and validated"
+echo "   - Documentation: generated for all specifications"
+echo "   - Diagrams: generated for all specifications"
+echo "   - YAML processing: tested"
+echo "   - v3.3 Code realization: tested"
+echo "   - Complete runnable project: generated"
+echo ""
+echo "🎉 SpecVerse workflow is fully functional!"
+echo ""
+echo "💡 Next steps:"
+echo "   To run the generated full-stack application:"
+echo "   1. cd /path/to/project (if not already there)"
+echo "   2. npm run genAll (if not already run - installs deps and sets up DB)"
+echo "   3. npm run app:build (build TypeScript)"
+echo "   4. npm run app:dev:backend (Terminal 1 - starts backend on :3000)"
+echo "   5. npm run app:dev:frontend (Terminal 2 - starts frontend on :5173)"
+echo ""
+echo "   Or run 'npm run app:dev' to see detailed instructions"
+echo ""
+echo "   Backend API: http://localhost:3000/api/{{componentNameKebab}}s"
+echo "   Frontend UI: http://localhost:5173"

package/assets/templates/full-stack/scripts/test-generated-code.sh

@@ -0,0 +1,165 @@
+#!/bin/bash
+
+# Test Generated Code Runtime Execution
+# Tests that generated code actually compiles and runs
+
+set -e  # Exit on any error
+
+echo "🧪 Testing Generated Code Execution..."
+echo ""
+
+# Check if code has been generated
+if [ ! -d "generated/code/services" ]; then
+  echo "⚠️  No generated code found. Running generators first..."
+  npm run generate:code
+fi
+
+echo "📦 Step 1: Setting up runtime environment..."
+
+# Create runtime package.json if it doesn't exist
+if [ ! -f "generated/code/package.json" ]; then
+  echo "   → Creating package.json for generated code..."
+  cat > generated/code/package.json << 'EOF'
+{
+  "name": "generated-code-runtime",
+  "version": "0.1.0",
+  "type": "module",
+  "dependencies": {
+    "@prisma/client": "^5.0.0",
+    "typeorm": "^0.3.17",
+    "reflect-metadata": "^0.1.13",
+    "better-sqlite3": "^9.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.2.0",
+    "tsx": "^3.12.0"
+  }
+}
+EOF
+fi
+
+# Create tsconfig.json if it doesn't exist
+if [ ! -f "generated/code/tsconfig.json" ]; then
+  echo "   → Creating tsconfig.json for generated code..."
+  cat > generated/code/tsconfig.json << 'EOF'
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "lib": ["ES2022"],
+    "moduleResolution": "node",
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "strict": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "outDir": "./dist",
+    "rootDir": ".",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true
+  },
+  "include": ["**/*.ts"],
+  "exclude": ["node_modules", "dist"]
+}
+EOF
+fi
+
+echo "   ✅ Runtime environment configured"
+echo ""
+
+echo "🔧 Step 2: Checking TypeScript compilation..."
+
+cd generated/code
+
+# Check if dependencies are installed
+if [ ! -d "node_modules" ]; then
+  echo "   → Installing dependencies (this may take a minute)..."
+  npm install --silent 2>&1 | grep -v "^npm WARN" || true
+fi
+
+# Try to compile TypeScript
+echo "   → Compiling TypeScript..."
+if npx tsc --noEmit 2>&1 | tee compile.log; then
+  echo "   ✅ TypeScript compilation successful"
+  COMPILE_STATUS="✅ PASSED"
+else
+  echo "   ⚠️  TypeScript compilation has errors (expected - missing runtime setup)"
+  echo "   📝 See generated/code/compile.log for details"
+  COMPILE_STATUS="⚠️  NEEDS SETUP"
+fi
+
+cd ../..
+
+echo ""
+echo "🔍 Step 3: Analyzing generated code quality..."
+
+# Check for v3.3 features in generated code
+echo "   → Checking for v3.3 features..."
+
+FEATURES_FOUND=0
+
+if grep -q "validate(data: any, context:" generated/code/services/*.ts 2>/dev/null; then
+  echo "   ✅ Unified validation method found"
+  ((FEATURES_FOUND++))
+fi
+
+if grep -q "version mismatch" generated/code/services/*.ts 2>/dev/null; then
+  echo "   ✅ Optimistic locking found"
+  ((FEATURES_FOUND++))
+fi
+
+if grep -q "deletedAt: null\|isDeleted: false" generated/code/services/*.ts 2>/dev/null; then
+  echo "   ✅ Soft delete filtering found"
+  ((FEATURES_FOUND++))
+fi
+
+if grep -q "createdAt\|updatedAt" generated/code/services/*.ts 2>/dev/null; then
+  echo "   ✅ Audit fields found"
+  ((FEATURES_FOUND++))
+fi
+
+if grep -q "EventBus\|eventBus" generated/code/services/*.ts 2>/dev/null; then
+  echo "   ✅ Event publishing found"
+  ((FEATURES_FOUND++))
+fi
+
+echo ""
+echo "📊 Step 4: Code Quality Report"
+echo "   ════════════════════════════════════════"
+
+# Count generated files
+SERVICE_COUNT=$(find generated/code/services -name "*.ts" 2>/dev/null | wc -l | tr -d ' ')
+ROUTE_COUNT=$(find generated/code/routes -name "*.js" -o -name "*.ts" 2>/dev/null | wc -l | tr -d ' ')
+
+echo "   Files Generated:"
+echo "      Services: $SERVICE_COUNT"
+echo "      Routes: $ROUTE_COUNT"
+echo ""
+echo "   v3.3 Features: $FEATURES_FOUND/5 detected"
+echo "   Compilation: $COMPILE_STATUS"
+echo ""
+
+# Show service structure
+if [ -d "generated/code/services" ] && [ -n "$(ls -A generated/code/services/*.ts 2>/dev/null)" ]; then
+  echo "   Service Structure:"
+  for file in generated/code/services/*.ts; do
+    if [ -f "$file" ]; then
+      SERVICE_NAME=$(basename "$file" .service.ts)
+      METHOD_COUNT=$(grep -c "async\s\+\w\+(.*)" "$file" || echo "0")
+      echo "      $(basename "$file"): $METHOD_COUNT methods"
+    fi
+  done
+  echo ""
+fi
+
+echo "✅ Generated Code Analysis Complete!"
+echo ""
+echo "📝 Next Steps to Run Generated Code:"
+echo "   1. cd generated/code"
+echo "   2. npm install"
+echo "   3. Set up database (Prisma: npx prisma generate && npx prisma migrate dev)"
+echo "   4. Create server entry point (services/index.ts)"
+echo "   5. npm run start:dev"
+echo ""
+echo "💡 Tip: See generated/code/compile.log for compilation details"