@specverse/engines 4.1.24 → 4.1.26

package/dist/libs/instance-factories/applications/templates/generic/backend-package-json-generator.js

@@ -37,11 +37,11 @@ function generateBackendPackageJson(context) {
     },
     dependencies: {
       "@prisma/client": "^5.7.0",
-      "fastify": "^4.25.0",
-      "@fastify/cors": "^8.4.0",
-      "@fastify/helmet": "^11.1.1",
-      "@fastify/rate-limit": "^9.1.0",
-      "@fastify/websocket": "^10.0.0",
+      "fastify": "^5.8.3",
+      "@fastify/cors": "^10.0.0",
+      "@fastify/helmet": "^12.0.0",
+      "@fastify/rate-limit": "^10.0.0",
+      "@fastify/websocket": "^11.0.0",
       "eventemitter3": "^5.0.0",
       "zod": "^3.22.0",
       "dotenv": "^16.3.0",
@@ -52,14 +52,14 @@ function generateBackendPackageJson(context) {
       "@types/node": "^20.10.0",
       "tsx": "^4.7.0",
       "prisma": "^5.7.0",
-      "vitest": "^1.0.0",
-      "@vitest/coverage-v8": "^1.0.0",
-      "eslint": "^8.55.0",
-      "@typescript-eslint/eslint-plugin": "^6.15.0",
-      "@typescript-eslint/parser": "^6.15.0"
+      "vitest": "^3.0.0",
+      "@vitest/coverage-v8": "^3.0.0",
+      "eslint": "^9.0.0",
+      "@typescript-eslint/eslint-plugin": "^8.0.0",
+      "@typescript-eslint/parser": "^8.0.0"
     },
     engines: {
-      node: ">=18.0.0"
+      node: ">=20.0.0"
     }
   };
   return JSON.stringify(pkg, null, 2);

package/dist/libs/instance-factories/applications/templates/generic/main-generator.js

@@ -99,6 +99,9 @@ ${serviceMap}
       credentials: true
     });
 
+    // Health check \u2014 used by smoke tests, container probes, monitors
+    app.get('/health', async () => ({ status: 'ok', timestamp: new Date().toISOString() }));
+
     // Spec endpoint \u2014 serves the specification for the runtime frontend
     app.get('/api/spec', async () => spec);
 

package/dist/libs/instance-factories/applications/templates/react/package-json-generator.js

@@ -35,10 +35,10 @@ function generatePackageJson(context) {
       "tailwindcss": "^3.4.13",
       "typescript": "^5.2.0",
       "vite": "^6.0.0",
-      "eslint": "^8.53.0",
-      "@typescript-eslint/eslint-plugin": "^6.10.0",
-      "@typescript-eslint/parser": "^6.10.0",
-      "eslint-plugin-react-hooks": "^4.6.0",
+      "eslint": "^9.0.0",
+      "@typescript-eslint/eslint-plugin": "^8.0.0",
+      "@typescript-eslint/parser": "^8.0.0",
+      "eslint-plugin-react-hooks": "^5.0.0",
       "eslint-plugin-react-refresh": "^0.4.4"
     }
   };

package/dist/libs/instance-factories/applications/templates/react/runtime-package-json-generator.js

@@ -37,10 +37,10 @@ function generateRuntimePackageJson(context) {
       "tailwindcss": "^3.4.13",
       "typescript": "^5.2.0",
       "vite": "^6.0.0",
-      "eslint": "^8.53.0",
-      "@typescript-eslint/eslint-plugin": "^6.10.0",
-      "@typescript-eslint/parser": "^6.10.0",
-      "eslint-plugin-react-hooks": "^4.6.0",
+      "eslint": "^9.0.0",
+      "@typescript-eslint/eslint-plugin": "^8.0.0",
+      "@typescript-eslint/parser": "^8.0.0",
+      "eslint-plugin-react-hooks": "^5.0.0",
       "eslint-plugin-react-refresh": "^0.4.4"
     }
   };

package/dist/libs/instance-factories/cli/templates/commander/command-generator.js

@@ -424,7 +424,10 @@ import { fileURLToPath } from 'url';`,
         }
 
         const projectName = name || 'my-project';
-        const templateName = options.template || 'default';
+        // Commander applies the --template default ("full-stack"); the
+        // fallback here only fires if a caller invoked the action handler
+        // directly without going through commander.
+        const templateName = options.template || 'full-stack';
         const templateDir = join(templatesDir, templateName);
 
         if (!existsSync(templateDir)) {
@@ -443,7 +446,13 @@ import { fileURLToPath } from 'url';`,
 
         // Copy template with variable substitution
         const kebab = projectName.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
-        const component = projectName.charAt(0).toUpperCase() + projectName.slice(1);
+        // PascalCase: split on hyphens / underscores / spaces, capitalize each segment, join.
+        // 'audit-backend-only' -> 'AuditBackendOnly', 'my_app' -> 'MyApp', 'foo' -> 'Foo'.
+        const component = projectName
+          .split(/[-_s]+/)
+          .filter(Boolean)
+          .map((s: string) => s.charAt(0).toUpperCase() + s.slice(1))
+          .join('');
         const vars: Record<string, string> = {
           '{{PROJECT_NAME}}': projectName,
           '{{projectName}}': projectName,
@@ -478,11 +487,29 @@ import { fileURLToPath } from 'url';`,
         console.log('Project created: ' + destDir);
         console.log('Template: ' + templateName);
         console.log('');
+
+        // Build the "Next steps" hint from the actual scripts the
+        // chosen template ships, so we never tell the user to run a
+        // command that doesn't exist in their package.json.
+        const destPkgPath = join(destDir, 'package.json');
+        const destPkg = existsSync(destPkgPath)
+          ? JSON.parse(readFileSync(destPkgPath, 'utf8'))
+          : { scripts: {} };
+        const scripts = destPkg.scripts || {};
         console.log('Next steps:');
         console.log('  cd ' + projectName);
-        console.log('  npm run setup          # validate, generate code, install deps, setup db');
-        console.log('  npm run dev:backend    # start backend (terminal 1)');
-        console.log('  npm run dev:frontend   # start frontend (terminal 2)');`
+        if (scripts.setup) {
+          console.log('  npm run setup          # validate, generate code, install deps, setup db');
+        }
+        if (scripts['dev:backend'] && scripts['dev:frontend']) {
+          console.log('  npm run dev:backend    # start backend (terminal 1)');
+          console.log('  npm run dev:frontend   # start frontend (terminal 2)');
+        } else if (scripts.dev) {
+          console.log('  npm run dev            # start dev server');
+        }
+        if (scripts['test:e2e']) {
+          console.log('  npm run test:e2e       # run end-to-end tests (after starting dev servers)');
+        }`
   },
   // === gen subcommands ===
   "gen.diagrams": {

package/libs/instance-factories/applications/templates/generic/backend-package-json-generator.ts

@@ -55,11 +55,11 @@ export default function generateBackendPackageJson(context: TemplateContext): st
 
     dependencies: {
       '@prisma/client': '^5.7.0',
-      'fastify': '^4.25.0',
-      '@fastify/cors': '^8.4.0',
-      '@fastify/helmet': '^11.1.1',
-      '@fastify/rate-limit': '^9.1.0',
-      '@fastify/websocket': '^10.0.0',
+      'fastify': '^5.8.3',
+      '@fastify/cors': '^10.0.0',
+      '@fastify/helmet': '^12.0.0',
+      '@fastify/rate-limit': '^10.0.0',
+      '@fastify/websocket': '^11.0.0',
       'eventemitter3': '^5.0.0',
       'zod': '^3.22.0',
       'dotenv': '^16.3.0',
@@ -71,15 +71,15 @@ export default function generateBackendPackageJson(context: TemplateContext): st
       '@types/node': '^20.10.0',
       'tsx': '^4.7.0',
       'prisma': '^5.7.0',
-      'vitest': '^1.0.0',
-      '@vitest/coverage-v8': '^1.0.0',
-      'eslint': '^8.55.0',
-      '@typescript-eslint/eslint-plugin': '^6.15.0',
-      '@typescript-eslint/parser': '^6.15.0'
+      'vitest': '^3.0.0',
+      '@vitest/coverage-v8': '^3.0.0',
+      'eslint': '^9.0.0',
+      '@typescript-eslint/eslint-plugin': '^8.0.0',
+      '@typescript-eslint/parser': '^8.0.0'
     },
 
     engines: {
-      node: '>=18.0.0'
+      node: '>=20.0.0'
     }
   };
 

package/libs/instance-factories/applications/templates/generic/main-generator.ts

@@ -132,6 +132,9 @@ ${serviceMap}
       credentials: true
     });
 
+    // Health check — used by smoke tests, container probes, monitors
+    app.get('/health', async () => ({ status: 'ok', timestamp: new Date().toISOString() }));
+
     // Spec endpoint — serves the specification for the runtime frontend
     app.get('/api/spec', async () => spec);
 

package/libs/instance-factories/applications/templates/react/package-json-generator.ts

@@ -45,10 +45,10 @@ export default function generatePackageJson(context: TemplateContext): string {
       "tailwindcss": "^3.4.13",
       "typescript": "^5.2.0",
       "vite": "^6.0.0",
-      "eslint": "^8.53.0",
-      "@typescript-eslint/eslint-plugin": "^6.10.0",
-      "@typescript-eslint/parser": "^6.10.0",
-      "eslint-plugin-react-hooks": "^4.6.0",
+      "eslint": "^9.0.0",
+      "@typescript-eslint/eslint-plugin": "^8.0.0",
+      "@typescript-eslint/parser": "^8.0.0",
+      "eslint-plugin-react-hooks": "^5.0.0",
       "eslint-plugin-react-refresh": "^0.4.4"
     }
   };

package/libs/instance-factories/applications/templates/react/runtime-package-json-generator.ts

@@ -54,10 +54,10 @@ export default function generateRuntimePackageJson(context: TemplateContext): st
       "tailwindcss": "^3.4.13",
       "typescript": "^5.2.0",
       "vite": "^6.0.0",
-      "eslint": "^8.53.0",
-      "@typescript-eslint/eslint-plugin": "^6.10.0",
-      "@typescript-eslint/parser": "^6.10.0",
-      "eslint-plugin-react-hooks": "^4.6.0",
+      "eslint": "^9.0.0",
+      "@typescript-eslint/eslint-plugin": "^8.0.0",
+      "@typescript-eslint/parser": "^8.0.0",
+      "eslint-plugin-react-hooks": "^5.0.0",
       "eslint-plugin-react-refresh": "^0.4.4"
     }
   };

package/libs/instance-factories/cli/templates/commander/command-generator.ts

@@ -479,7 +479,10 @@ import { fileURLToPath } from 'url';`,
         }
 
         const projectName = name || 'my-project';
-        const templateName = options.template || 'default';
+        // Commander applies the --template default ("full-stack"); the
+        // fallback here only fires if a caller invoked the action handler
+        // directly without going through commander.
+        const templateName = options.template || 'full-stack';
         const templateDir = join(templatesDir, templateName);
 
         if (!existsSync(templateDir)) {
@@ -498,7 +501,13 @@ import { fileURLToPath } from 'url';`,
 
         // Copy template with variable substitution
         const kebab = projectName.replace(/([a-z])([A-Z])/g, '$1-$2').toLowerCase();
-        const component = projectName.charAt(0).toUpperCase() + projectName.slice(1);
+        // PascalCase: split on hyphens / underscores / spaces, capitalize each segment, join.
+        // 'audit-backend-only' -> 'AuditBackendOnly', 'my_app' -> 'MyApp', 'foo' -> 'Foo'.
+        const component = projectName
+          .split(/[-_\s]+/)
+          .filter(Boolean)
+          .map((s: string) => s.charAt(0).toUpperCase() + s.slice(1))
+          .join('');
         const vars: Record<string, string> = {
           '{{PROJECT_NAME}}': projectName,
           '{{projectName}}': projectName,
@@ -533,11 +542,29 @@ import { fileURLToPath } from 'url';`,
         console.log('Project created: ' + destDir);
         console.log('Template: ' + templateName);
         console.log('');
+
+        // Build the "Next steps" hint from the actual scripts the
+        // chosen template ships, so we never tell the user to run a
+        // command that doesn't exist in their package.json.
+        const destPkgPath = join(destDir, 'package.json');
+        const destPkg = existsSync(destPkgPath)
+          ? JSON.parse(readFileSync(destPkgPath, 'utf8'))
+          : { scripts: {} };
+        const scripts = destPkg.scripts || {};
         console.log('Next steps:');
         console.log('  cd ' + projectName);
-        console.log('  npm run setup          # validate, generate code, install deps, setup db');
-        console.log('  npm run dev:backend    # start backend (terminal 1)');
-        console.log('  npm run dev:frontend   # start frontend (terminal 2)');`
+        if (scripts.setup) {
+          console.log('  npm run setup          # validate, generate code, install deps, setup db');
+        }
+        if (scripts['dev:backend'] && scripts['dev:frontend']) {
+          console.log('  npm run dev:backend    # start backend (terminal 1)');
+          console.log('  npm run dev:frontend   # start frontend (terminal 2)');
+        } else if (scripts.dev) {
+          console.log('  npm run dev            # start dev server');
+        }
+        if (scripts['test:e2e']) {
+          console.log('  npm run test:e2e       # run end-to-end tests (after starting dev servers)');
+        }`
   },
   // === gen subcommands ===
   'gen.diagrams': {

package/libs/instance-factories/controllers/fastify.yaml

@@ -96,8 +96,8 @@ requirements:
   dependencies:
     npm:
       dependencies:
-        "fastify": "^4.24.0"
-        "@fastify/cors": "^8.4.0"
+        "fastify": "^5.8.3"
+        "@fastify/cors": "^10.0.0"
         "yaml": "^2.3.0"
       devDependencies:
         "tsx": "^4.0.0"

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@specverse/engines",
-  "version": "4.1.24",
-  "description": "SpecVerse toolchain — parser, inference, realize, generators, AI, registry",
+  "version": "4.1.26",
+  "description": "SpecVerse toolchain \u2014 parser, inference, realize, generators, AI, registry",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -65,4 +65,4 @@
     "access": "public"
   },
   "license": "MIT"
-}
+}