@specverse/engine-realize 3.5.3

package/assets/templates/backend-only/generated/docs/README.md

@@ -0,0 +1,49 @@
+# Generated Documentation
+
+This directory contains documentation and diagrams automatically generated from inferred SpecVerse specifications.
+
+## Content Types
+
+### Documentation Files
+- **`*-complete-docs.md`**: Complete documentation from AI-inferred specifications
+- **`*-deployed-docs.md`**: Documentation for deployment specifications
+- **`*-deployed-prod-docs.md`**: Production deployment documentation
+
+### Diagram Files  
+- **`*-complete-diagrams.md`**: UML diagrams (ER, sequence, class) for complete specifications
+- **`*-deployed-diagrams.md`**: Deployment diagrams for development environment
+- **`*-deployed-prod-diagrams.md`**: Deployment diagrams for production environment
+
+## Auto-Generation
+
+These files are automatically generated when you run:
+
+```bash
+# Generates both specification and documentation
+npm run infer                    # → creates complete docs + diagrams
+npm run infer:deployment         # → creates development deployment docs + diagrams  
+npm run infer:deployment:prod    # → creates production deployment docs + diagrams
+```
+
+## Manual Generation
+
+You can also generate documentation for existing specifications:
+
+```bash
+# Generate docs for specific files
+npm run infer:docs                        # docs for complete specification
+npm run infer:deployment:docs             # docs for development deployment
+npm run infer:deployment:prod:docs        # docs for production deployment
+```
+
+## File Organization
+
+Files follow this naming pattern:
+- `{project-name}-complete-docs.md` - Documentation for AI-inferred complete specification
+- `{project-name}-complete-diagrams.md` - UML diagrams for complete specification  
+- `{project-name}-deployed-docs.md` - Documentation for development deployment
+- `{project-name}-deployed-diagrams.md` - Deployment diagrams for development
+- `{project-name}-deployed-prod-docs.md` - Documentation for production deployment
+- `{project-name}-deployed-prod-diagrams.md` - Deployment diagrams for production
+
+All files are automatically regenerated when you run infer commands.

package/assets/templates/backend-only/gitignore

@@ -0,0 +1,54 @@
+# Dependencies
+node_modules/
+package-lock.json
+yarn.lock
+#pnpm-lock.yaml
+
+# Generated files
+generated/
+dist/
+build/
+
+# IDE files
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+
+# OS files
+.DS_Store
+Thumbs.db
+
+# Logs
+*.log
+logs/
+
+# Environment
+.env
+.env.local
+.env.*.local
+
+# Temporary files
+tmp/
+temp/
+*.tmp
+
+# SpecVerse generated files
+specs/*-complete.specly
+specs/*-enhanced.specly
+specs/*-deployed.specly
+specs/*-deployed-prod.specly
+specs/*-processed.yaml
+docs/diagrams/
+docs/generated/
+
+# Database files (for development)
+*.db
+*.sqlite
+*.sqlite3
+dev.db
+
+# Test coverage
+coverage/
+.nyc_output/

package/assets/templates/backend-only/manifests/README.md

@@ -0,0 +1,72 @@
+# Implementation Manifests
+
+This directory contains **SpecVerse v3.3 Implementation Manifests** that show how to deploy your component specifications to real infrastructure.
+
+## What are Manifests?
+
+Manifests bridge the gap between your logical SpecVerse specifications and concrete technology implementations. They define:
+
+- **Implementation Types**: How logical components map to specific technologies
+- **Behavior Mappings**: How model behaviors translate to actual code/API calls
+- **Capability Mappings**: How logical capabilities map to implementation types
+- **Communication Channels**: How components communicate in the real deployment
+- **Technology Configuration**: Framework-specific settings and parameters
+
+## Available Manifests
+
+### `implementation.yaml` ⭐ NEW - v3.3 Code Generation
+- **Purpose**: Technology stack configuration for code generation
+- **Features**: ORM selection, server framework, metadata strategies
+- **Use Case**: Generate production-ready code (services, routes, ORM schemas)
+- **Commands**:
+  ```bash
+  npm run generate:code        # Generate all code
+  npm run test:generators      # Generate and verify
+  ```
+
+### `docker-compose.specly`
+- **Target**: Local development and staging
+- **Technology**: Docker Compose
+- **Database**: SQLite (development-friendly)
+- **Use Case**: Quick local testing and development
+
+### `kubernetes.specly`
+- **Target**: Production deployment
+- **Technology**: Kubernetes with operators
+- **Database**: PostgreSQL with high availability
+- **Use Case**: Scalable production deployments
+
+## How to Use
+
+1. **Choose a manifest** that matches your deployment target
+2. **Customize the configuration** section for your specific needs
+3. **Reference your component** by updating the component source
+4. **Deploy using the specified tools** (docker-compose, kubectl, etc.)
+
+## Extending Manifests
+
+You can create additional manifests for other technologies:
+
+- **Cloud Providers**: AWS EKS, GCP GKE, Azure AKS
+- **Serverless**: AWS Lambda, Vercel, Netlify
+- **Traditional**: VM-based deployments, bare metal
+- **Container Platforms**: OpenShift, Rancher, Docker Swarm
+
+## Commands
+
+```bash
+# Validate a manifest
+specverse validate manifests/docker-compose.specly
+
+# Process a manifest with component context
+specverse gen yaml manifests/kubernetes.specly
+
+# Generate deployment documentation
+specverse gen docs manifests/kubernetes.specly
+```
+
+## Learn More
+
+- **SpecVerse Manifests Documentation**: See the main docs for comprehensive manifest features
+- **Examples**: Check `examples/06-deploy/` for more complex manifest patterns
+- **Best Practices**: Review the `aiInstructions` in each manifest for implementation guidance

package/assets/templates/backend-only/manifests/docker-compose.specly

@@ -0,0 +1,91 @@
+# Docker Compose Implementation Manifest
+# SpecVerse v3.3 manifest specification for Docker Compose deployment
+
+manifests:
+  DockerComposeManifest:
+    specVersion: "3.3.0"
+    name: "{{componentName}}DockerComposeManifest"
+    version: "1.0.0"
+    description: "Docker Compose implementation manifest for {{projectName}}"
+
+    # v3.3: Deployment reference (REQUIRED)
+    deployment:
+      deploymentSource: "./specs/main.specly"
+      deploymentName: "development"
+
+    # v3.3: Default technology mappings
+    defaultMappings:
+      storage: "SQLite"
+      controller: "DockerNodeApp"
+
+    # v3.3: Capability to implementation factory mappings
+    capabilityMappings:
+      - capability: "api.*"
+        instanceFactory: "DockerWebApp"
+
+      - capability: "database.*"
+        instanceFactory: "DockerDatabase"
+
+    # v3.3: Platform-specific configuration
+    configuration:
+      # Docker Compose specific settings
+      composeVersion: "3.8"
+
+      networks:
+        default:
+          driver: "bridge"
+
+      volumes:
+        app_data:
+          driver: "local"
+
+      # Implementation type definitions
+      implementationFactories:
+        DockerWebApp:
+          type: "controller"
+          technology: "docker"
+          framework: "compose"
+          config:
+            image: "node:18-alpine"
+            build:
+              context: "."
+              dockerfile: "Dockerfile"
+            ports:
+              - "3000:3000"
+            environment:
+              NODE_ENV: "development"
+              DATABASE_URL: "sqlite:./data/app.db"
+            volumes:
+              - "./src:/app/src"
+              - "./data:/app/data"
+            restart: "unless-stopped"
+
+        DockerDatabase:
+          type: "database"
+          technology: "sqlite"
+          framework: "docker"
+          config:
+            image: "alpine:latest"
+            volumes:
+              - "./data:/data"
+            command: "tail -f /dev/null"
+
+      # Namespace configuration
+      namespace:
+        strategy: "single"
+        name: "{{projectNameKebab}}"
+        description: "Main application namespace"
+        isolation: "permissive"
+
+      # AI implementation instructions
+      aiInstructions: |
+        When implementing this Docker Compose deployment:
+
+        1. **Development Focus**: This manifest is optimized for local development
+        2. **Live Reload**: Source code is mounted for immediate changes
+        3. **Data Persistence**: SQLite database with volume mounting
+        4. **Port Mapping**: Application accessible on localhost:3000
+        5. **Environment**: Configure environment variables in docker-compose.yml
+        6. **Networking**: Uses default bridge network for container communication
+        7. **Database**: Simple SQLite setup for development (upgrade to PostgreSQL for production)
+        8. **Restart Policy**: Containers restart unless manually stopped

package/assets/templates/backend-only/manifests/implementation.yaml

@@ -0,0 +1,100 @@
+# SpecVerse v3.3 Implementation Manifest - Backend Only
+# Generates standalone backend API without frontend
+
+manifests:
+  {{projectNameKebab}}Implementation:
+    specVersion: "3.3.0"
+    name: "{{projectNameKebab}}-backend"
+    version: "1.0.0"
+    description: "Backend API implementation for {{projectName}}"
+
+    # v3.3: Deployment reference
+    deployment:
+      deploymentSource: "../specs/main.specly"
+      deploymentName: "development"
+
+    # v3.3: Configuration for standalone backend
+    configuration:
+      outputStructure: "standalone"
+      backendDir: "."
+      
+      apiPort: 3000
+      apiHost: "0.0.0.0"
+      corsOrigins: "${CORS_ORIGINS:-*}"
+
+      # Environment-specific settings
+      environments:
+        development:
+          database:
+            provider: "postgresql"
+            url: "postgresql://localhost:5432/{{projectNameKebab}}_dev"
+          server:
+            port: 3000
+            host: "localhost"
+            logLevel: "debug"
+          cors:
+            origins: ["http://localhost:5173", "http://localhost:3000"]
+
+        production:
+          database:
+            provider: "postgresql"
+            url: "${DATABASE_URL}"
+          server:
+            port: "${PORT:-8080}"
+            host: "0.0.0.0"
+            logLevel: "info"
+          cors:
+            origins: "${CORS_ORIGINS}"
+          middleware:
+            rateLimit:
+              max: 1000
+              timeWindow: "1 minute"
+            compression: true
+
+    # v3.3: Backend-only capability mappings
+    capabilityMappings:
+      # Database Layer
+      - capability: "orm.schema"
+        instanceFactory: "PrismaORM"
+        configuration:
+          outputStructure: "standalone"
+          backendDir: "."
+
+      # Business Logic Layer
+      - capability: "service.controller"
+        instanceFactory: "PrismaServices"
+        configuration:
+          outputStructure: "standalone"
+          backendDir: "."
+
+      # API Layer
+      - capability: "api.rest"
+        instanceFactory: "FastifyAPI"
+        configuration:
+          outputStructure: "standalone"
+          backendDir: "."
+          server:
+            cors:
+              enabled: true
+
+      # Application Entry Point
+      - capability: "app.entrypoint"
+        instanceFactory: "GenericApp"
+        configuration:
+          outputStructure: "standalone"
+          backendDir: "."
+
+      # Project Scaffolding
+      - capability: "project.scaffold"
+        instanceFactory: "GenericScaffold"
+        configuration:
+          outputStructure: "standalone"
+          includeReadme: true
+
+      # Validation
+      - capability: "validation.runtime"
+        instanceFactory: "ZodValidation"
+
+      # Events (in-memory for development)
+      - capability: "messaging.events"
+        instanceFactory: "EventEmitter"

package/assets/templates/backend-only/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/backend-only/package.json

@@ -0,0 +1,59 @@
+{
+  "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    # Start development 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": "if [ -d generated/code ]; then cd generated/code && npm run dev; 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"
+  }
+}