@specverse/engines 4.1.25 → 4.1.27

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

@@ -54,9 +54,9 @@ function generateBackendPackageJson(context) {
       "prisma": "^5.7.0",
       "vitest": "^3.0.0",
       "@vitest/coverage-v8": "^3.0.0",
-      "eslint": "^8.55.0",
-      "@typescript-eslint/eslint-plugin": "^6.15.0",
-      "@typescript-eslint/parser": "^6.15.0"
+      "eslint": "^9.0.0",
+      "@typescript-eslint/eslint-plugin": "^8.0.0",
+      "@typescript-eslint/parser": "^8.0.0"
     },
     engines: {
       node: ">=20.0.0"

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,16 @@ 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 / whitespace, capitalize each segment, join.
+        // 'audit-backend-only' -> 'AuditBackendOnly', 'my_app' -> 'MyApp', 'foo' -> 'Foo'.
+        // NOTE: regex char class is double-escaped because this whole handler
+        // is embedded as a string in the generator template \u2014 \\s here ends
+        // up as s in the emitted source.
+        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 +490,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

@@ -73,9 +73,9 @@ export default function generateBackendPackageJson(context: TemplateContext): st
       'prisma': '^5.7.0',
       'vitest': '^3.0.0',
       '@vitest/coverage-v8': '^3.0.0',
-      'eslint': '^8.55.0',
-      '@typescript-eslint/eslint-plugin': '^6.15.0',
-      '@typescript-eslint/parser': '^6.15.0'
+      'eslint': '^9.0.0',
+      '@typescript-eslint/eslint-plugin': '^8.0.0',
+      '@typescript-eslint/parser': '^8.0.0'
     },
 
     engines: {

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,16 @@ 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 / whitespace, capitalize each segment, join.
+        // 'audit-backend-only' -> 'AuditBackendOnly', 'my_app' -> 'MyApp', 'foo' -> 'Foo'.
+        // NOTE: regex char class is double-escaped because this whole handler
+        // is embedded as a string in the generator template — \\s here ends
+        // up as \s in the emitted source.
+        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 +545,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/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@specverse/engines",
-  "version": "4.1.25",
-  "description": "SpecVerse toolchain — parser, inference, realize, generators, AI, registry",
+  "version": "4.1.27",
+  "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"
-}
+}