@specverse/engine-realize 3.5.3

package/assets/templates/default/manifests/implementation.yaml

@@ -0,0 +1,176 @@
+# 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"
+
+      # Backend Application Entry Point (generates backend/src/main.ts)
+      - capability: "app.entrypoint"
+        instanceFactory: "GenericApp"
+
+      # Frontend Application (generates frontend/index.html, App.tsx, etc.)
+      - capability: "app.frontend"
+        instanceFactory: "ReactApp"
+
+      # UI Components - React (views and components)
+      - capability: "ui.components"
+        instanceFactory: "ReactComponents"
+
+      - capability: "ui.views"
+        instanceFactory: "ReactComponents"
+
+      - capability: "ui.forms"
+        instanceFactory: "ReactComponents"
+
+    # v3.3: Configuration section
+    configuration:
+      # Project structure
+      outputStructure: "monorepo"
+      frontendDir: "frontend"
+      backendDir: "backend"
+
+      # API connection (for frontend)
+      apiBaseUrl: "http://localhost:3000"
+      # 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/default/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/default/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "{{projectNameKebab}}",
+  "version": "0.1.0",
+  "description": "{{projectName}} - SpecVerse Project",
+  "scripts": {
+    "_comment_workflow": "=== Main Workflow ===",
+    "genAll": "npm run realize:all && echo '\n✅ Code generation complete!\n' && echo '📦 Installing dependencies...\n' && cd generated/code && npm install && echo '\n🗄️  Setting up database...\n' && npm run db:setup && echo '\n✅ Setup complete! Next steps:\n' && echo '   npm run app:build  # Build the project' && echo '   npm run app:test   # Run tests' && echo '   npm run app:start  # Start production server' && echo '   npm run app:dev:backend   # Start backend dev server' && echo '   npm run app:dev:frontend  # Start frontend dev server\n'",
+    "app:build": "if [ -d generated/code ]; then cd generated/code && npm run build; else echo '❌ No generated code found. Run: npm run genAll'; exit 1; fi",
+    "app:test": "if [ -d generated/code ]; then cd generated/code && npm test; else echo '❌ No generated code found. Run: npm run genAll'; exit 1; fi",
+    "app:start": "if [ -d generated/code ]; then cd generated/code && npm start; else echo '❌ No generated code found. Run: npm run genAll'; exit 1; fi",
+    "app:dev": "echo '⚠️  Development mode requires 2 separate terminals:' && echo '' && echo '  Terminal 1: cd generated/code && npm run dev:backend' && echo '  Terminal 2: cd generated/code && npm run dev:frontend' && echo '' && echo 'Or use the shortcut commands:' && echo '  npm run app:dev:backend' && echo '  npm run app:dev:frontend'",
+    "app:dev:backend": "if [ -d generated/code ]; then cd generated/code && npm run dev:backend; else echo '❌ No generated code found. Run: npm run genAll'; exit 1; fi",
+    "app:dev:frontend": "if [ -d generated/code ]; then cd generated/code && npm run dev:frontend; else echo '❌ No generated code found. Run: npm run genAll'; exit 1; fi",
+
+    "_comment_validation": "=== Validation ===",
+    "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",
+
+    "_comment_inference": "=== AI Inference ===",
+    "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",
+
+    "_comment_generation": "=== Generation ===",
+    "generate:docs": "specverse gen docs specs/main.specly --output docs/main-docs.md",
+    "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:complete": "npm run infer && npm run infer:docs",
+
+    "_comment_inference_docs": "=== Inference Documentation ===",
+    "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",
+
+    "_comment_realization": "=== Code Realization (v3.3) ===",
+    "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",
+
+    "_comment_utilities": "=== Utilities ===",
+    "process": "specverse gen yaml specs/main.specly -o generated/{{projectNameKebab}}-processed.yaml",
+    "format": "specverse dev format specs/main.specly --write",
+
+    "_comment_testing": "=== Testing ===",
+    "test:all": "./scripts/test-all.sh",
+    "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'"
+  },
+  "keywords": ["specverse", "specification", "ai", "inference"],
+  "devDependencies": {
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}

package/assets/templates/default/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"