@specverse/engines 4.1.18 → 4.1.20

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

@@ -34,7 +34,7 @@ function generatePackageJson(context) {
       "postcss": "^8.4.47",
       "tailwindcss": "^3.4.13",
       "typescript": "^5.2.0",
-      "vite": "^5.0.0",
+      "vite": "^6.0.0",
       "eslint": "^8.53.0",
       "@typescript-eslint/eslint-plugin": "^6.10.0",
       "@typescript-eslint/parser": "^6.10.0",

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

@@ -36,7 +36,7 @@ function generateRuntimePackageJson(context) {
       "postcss": "^8.4.47",
       "tailwindcss": "^3.4.13",
       "typescript": "^5.2.0",
-      "vite": "^5.0.0",
+      "vite": "^6.0.0",
       "eslint": "^8.53.0",
       "@typescript-eslint/eslint-plugin": "^6.10.0",
       "@typescript-eslint/parser": "^6.10.0",

package/dist/libs/instance-factories/controllers/templates/fastify/server-generator.js

@@ -13,9 +13,17 @@ function generateFastifyServer(context) {
   const specEvents = spec.events ? Object.keys(spec.events) : [];
   const hasEvents = specEvents.length > 0 || modelNames.length > 0;
   const servicesList = spec.services ? Object.keys(spec.services) : [];
-  const serviceImports = servicesList.map(
-    (name) => `import './${name.charAt(0).toLowerCase() + name.slice(1)}.js'; // Initialize ${name} event subscriptions`
-  );
+  const serviceSingletonImports = servicesList.map((name) => {
+    const lower = name.charAt(0).toLowerCase() + name.slice(1);
+    return `import ${lower} from './services/${name}.js';`;
+  }).join("\n");
+  const serviceRouteImports = servicesList.map(
+    (name) => `import ${name}Routes from './routes/${name}Routes.js';`
+  ).join("\n");
+  const serviceRouteRegistrations = servicesList.map((name) => {
+    const lower = name.charAt(0).toLowerCase() + name.slice(1);
+    return `  await fastify.register(${name}Routes, { prefix: '/api/services/${name}', services: { ${name}: ${lower} } });`;
+  }).join("\n");
   return `/**
  * Fastify Server
  * Generated from SpecVerse specification
@@ -60,11 +68,13 @@ fastify.get('/api/events', async () => eventBus.getHistory());` : ""}
 // Register routes
 ${routeImports}
 
-${serviceImports.length > 0 ? `// Initialize services (registers event subscriptions)
-${serviceImports.join("\n")}` : ""}
+${serviceSingletonImports ? `// Service singletons + their Fastify route files
+${serviceSingletonImports}
+${serviceRouteImports}` : ""}
 
 async function registerRoutes() {
 ${routeRegistrations}
+${serviceRouteRegistrations ? "\n  // Service operation routes (RPC-style under /api/services/{ServiceName})\n" + serviceRouteRegistrations : ""}
 }
 
 // Start server

package/dist/libs/instance-factories/services/templates/fastify/service-routes-generator.js

@@ -0,0 +1,87 @@
+function generateFastifyServiceRoutes(context) {
+  const { service } = context;
+  if (!service) {
+    throw new Error("Service is required in template context");
+  }
+  const serviceName = service.name;
+  if (!serviceName) {
+    throw new Error("Service must have a name");
+  }
+  const operationEntries = Array.isArray(service.operations) ? service.operations.map((op) => [op.name, op]) : Object.entries(service.operations || {});
+  if (operationEntries.length === 0) {
+    return `/**
+ * ${serviceName} \u2014 no operations declared, no routes generated.
+ */
+import type { FastifyInstance } from 'fastify';
+
+export default async function ${serviceName}Routes(_fastify: FastifyInstance, _options: any) {
+  // No operations declared on ${serviceName}.
+}
+`;
+  }
+  const routeHandlers = operationEntries.map(([opName, op]) => generateOperationRoute(opName, op, serviceName)).join("\n\n");
+  return `import type { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';
+
+/**
+ * ${serviceName} Routes
+ *
+ * Generated from SpecVerse specification \u2014 exposes service operations
+ * as HTTP endpoints under /api/services/${serviceName}/.
+ *
+ * Operations: ${operationEntries.map(([n]) => n).join(", ")}
+ */
+export default async function ${serviceName}Routes(
+  fastify: FastifyInstance,
+  options: any
+) {
+  const service = options.services.${serviceName};
+  if (!service) {
+    throw new Error('Service ${serviceName} not registered in options.services');
+  }
+
+${routeHandlers.split("\n").map((line) => "  " + line).join("\n")}
+}
+`;
+}
+function generateOperationRoute(opName, op, serviceName) {
+  const params = op?.parameters || {};
+  const paramNames = Object.keys(params);
+  const validations = [];
+  for (const [pName, pDef] of Object.entries(params)) {
+    const required = typeof pDef === "string" ? pDef.includes("required") : pDef?.required;
+    const typeStr = typeof pDef === "string" ? pDef.split(" ")[0] : pDef?.type || "String";
+    if (required) {
+      validations.push(`  if (body.${pName} === undefined || body.${pName} === null) errors.push({ field: '${pName}', message: '${pName} is required' });`);
+    }
+    if (typeStr === "UUID" || typeStr === "String" || typeStr === "Email") {
+      validations.push(`  if (body.${pName} !== undefined && typeof body.${pName} !== 'string') errors.push({ field: '${pName}', message: '${pName} must be a string' });`);
+    } else if (typeStr === "Integer" || typeStr === "Number" || typeStr === "Float") {
+      validations.push(`  if (body.${pName} !== undefined && typeof body.${pName} !== 'number') errors.push({ field: '${pName}', message: '${pName} must be a number' });`);
+    } else if (typeStr === "Boolean") {
+      validations.push(`  if (body.${pName} !== undefined && typeof body.${pName} !== 'boolean') errors.push({ field: '${pName}', message: '${pName} must be a boolean' });`);
+    }
+  }
+  const validationBlock = validations.length > 0 ? `  const errors: Array<{ field: string; message: string }> = [];
+${validations.join("\n")}
+  if (errors.length > 0) return reply.status(400).send({ error: 'Validation failed', details: errors });` : "";
+  const callExpression = paramNames.length > 0 ? `service.${opName}(${paramNames.map((p) => `body.${p}`).join(", ")})` : `service.${opName}(body)`;
+  return `// ${opName}${op?.description ? ` \u2014 ${op.description}` : ""}
+fastify.post('/${opName}', {
+  handler: async (request: FastifyRequest, reply: FastifyReply) => {
+    try {
+      const body = (request.body || {}) as Record<string, any>;
+${validationBlock}
+      const result = await ${callExpression};
+      return reply.send(result ?? { success: true });
+    } catch (error) {
+      return reply.status(400).send({
+        error: 'Failed to execute ${serviceName}.${opName}',
+        message: error instanceof Error ? error.message : String(error)
+      });
+    }
+  }
+});`;
+}
+export {
+  generateFastifyServiceRoutes as default
+};

package/dist/libs/instance-factories/tools/templates/vscode/vscode-extension-generator.js

@@ -195,7 +195,13 @@ function generatePackageJson(commands, _entityTypes, specVersion = "1.0.0") {
     devDependencies: {
       "@types/vscode": "^1.80.0",
       "@vscode/vsce": "^3.0.0",
-      esbuild: "^0.19.0"
+      esbuild: "^0.25.0"
+    },
+    overrides: {
+      // Force the patched version of lodash through @vscode/vsce →
+      // @secretlint → @textlint transitive chain (4.17.23 has a
+      // code-injection advisory in `_.template`).
+      lodash: "^4.18.1"
     }
   };
 }

package/dist/libs/instance-factories/tools/templates/vscode/vscode-extension-generator.js.bak

@@ -0,0 +1,244 @@
+import { existsSync, readdirSync, statSync, mkdirSync, writeFileSync, copyFileSync } from "fs";
+import { join, dirname } from "path";
+import { fileURLToPath } from "url";
+const __generatorDir = dirname(fileURLToPath(import.meta.url));
+function generateVSCodeExtension(context) {
+  const { spec, outputDir } = context;
+  const extensionDir = join(outputDir || ".", "tools", "vscode-extension");
+  if (!existsSync(extensionDir)) mkdirSync(extensionDir, { recursive: true });
+  const distribution = extractDistribution(spec);
+  let cliCommands = [];
+  if (distribution?.commands) {
+    cliCommands = distribution.commands.map((cmd) => {
+      const parts = (cmd.from || cmd.command || "").split(".");
+      const name = parts[parts.length - 1] || "unknown";
+      return {
+        command: `specverse.${name}`,
+        title: cmd.title || `${capitalize(name)}: ${cmd.description || ""}`,
+        category: "SpecVerse"
+      };
+    });
+  }
+  if (cliCommands.length === 0) {
+    cliCommands = extractCLICommands(spec);
+  }
+  if (cliCommands.length === 0) {
+    cliCommands = getStandardCommands();
+  }
+  const entityTypes = extractEntityTypes(spec);
+  const specVersion = distribution?.version || spec?.metadata?.version || spec?.version || "4.0.0";
+  const packageJson = generatePackageJson(cliCommands, entityTypes, specVersion);
+  if (distribution) {
+    if (distribution.displayName) packageJson.displayName = distribution.displayName;
+    if (distribution.publisher) packageJson.publisher = distribution.publisher;
+    if (distribution.description) packageJson.description = distribution.description;
+    if (distribution.languages && distribution.languages.length > 0) {
+      packageJson.contributes.languages = distribution.languages.map((lang) => ({
+        id: lang.id,
+        aliases: lang.aliases || [lang.id],
+        extensions: lang.extensions || [],
+        configuration: `./language-configuration.json`
+      }));
+      packageJson.contributes.grammars = distribution.languages.filter((lang) => lang.grammar).map((lang) => ({
+        language: lang.id,
+        scopeName: lang.grammar,
+        path: `./syntaxes/${lang.id}.tmLanguage.json`
+      }));
+    }
+    if (distribution.themes && distribution.themes.length > 0) {
+      packageJson.contributes.themes = distribution.themes.map((theme) => ({
+        label: theme.name,
+        uiTheme: theme.type === "dark" ? "vs-dark" : theme.type === "light" ? "vs" : "hc-black",
+        path: `./themes/${theme.name.toLowerCase().replace(/\s+/g, "-")}-theme.json`
+      }));
+    }
+  }
+  writeFileSync(join(extensionDir, "package.json"), JSON.stringify(packageJson, null, 2) + "\n");
+  let staticDir = join(__generatorDir, "static");
+  if (!existsSync(staticDir)) {
+    staticDir = join(__generatorDir.replace("/dist/libs/", "/libs/"), "static");
+  }
+  if (existsSync(staticDir)) {
+    copyRecursive(staticDir, extensionDir);
+  }
+  const srcDir = join(extensionDir, "src");
+  if (!existsSync(srcDir)) mkdirSync(srcDir, { recursive: true });
+  const extTs = join(staticDir, "extension.ts");
+  if (existsSync(extTs)) {
+    copyFileSync(extTs, join(srcDir, "extension.ts"));
+  }
+  const buildScript = `const esbuild = require('esbuild');
+esbuild.build({
+  entryPoints: ['src/extension.ts'],
+  bundle: true,
+  outfile: 'dist/extension.js',
+  external: ['vscode'],
+  format: 'cjs',
+  platform: 'node',
+}).catch(() => process.exit(1));
+`;
+  const scriptsDir = join(extensionDir, "scripts");
+  if (!existsSync(scriptsDir)) mkdirSync(scriptsDir, { recursive: true });
+  writeFileSync(join(scriptsDir, "build.js"), buildScript);
+  return `VSCode extension generated in: ${extensionDir}
+  ${cliCommands.length} commands, ${entityTypes.length} entity keywords`;
+}
+function extractDistribution(spec) {
+  const allDistributions = [];
+  if (spec?.distributions) {
+    const entries = Array.isArray(spec.distributions) ? spec.distributions : Object.entries(spec.distributions).map(([name, data]) => ({ name, ...data }));
+    allDistributions.push(...entries);
+  }
+  const components = spec?.components || {};
+  const componentList = Array.isArray(components) ? components : Object.values(components);
+  for (const comp of componentList) {
+    const distributions = comp?.distributions;
+    if (!distributions) continue;
+    const distEntries = Array.isArray(distributions) ? distributions : Object.entries(distributions).map(([name, data]) => ({ name, ...data }));
+    allDistributions.push(...distEntries);
+  }
+  for (const dist of allDistributions) {
+    if (dist.type === "ide") return dist;
+  }
+  return allDistributions.length > 0 ? allDistributions[0] : null;
+}
+function extractCLICommands(spec) {
+  const commands = [];
+  const components = spec?.components || {};
+  const componentList = Array.isArray(components) ? components : Object.entries(components).map(([name, data]) => ({ name, ...data }));
+  for (const comp of componentList) {
+    const cliCommands = comp?.commands;
+    if (!cliCommands) continue;
+    for (const [rootName, rootDef] of Object.entries(cliCommands)) {
+      const subcommands = rootDef?.subcommands || {};
+      for (const [subName, subDef] of Object.entries(subcommands)) {
+        const sub = subDef;
+        const nestedSubs = sub?.subcommands;
+        if (nestedSubs) {
+          for (const [nestedName, nestedDef] of Object.entries(nestedSubs)) {
+            commands.push({
+              command: `specverse.${subName}.${nestedName}`,
+              title: `${capitalize(subName)} ${capitalize(nestedName)}: ${nestedDef.description || ""}`,
+              category: "SpecVerse"
+            });
+          }
+        } else {
+          commands.push({
+            command: `specverse.${subName}`,
+            title: `${capitalize(subName)}: ${sub.description || ""}`,
+            category: "SpecVerse"
+          });
+        }
+      }
+    }
+  }
+  return commands;
+}
+function extractEntityTypes(spec) {
+  const types = /* @__PURE__ */ new Set();
+  const components = spec?.components || [];
+  for (const component of Array.isArray(components) ? components : Object.values(components)) {
+    const comp = component;
+    const models = comp?.models;
+    if (models) {
+      if (Array.isArray(models)) {
+        models.forEach((m) => types.add(m.name));
+      } else {
+        Object.keys(models).forEach((name) => types.add(name));
+      }
+    }
+  }
+  return [...types];
+}
+function generatePackageJson(commands, _entityTypes, specVersion = "1.0.0") {
+  return {
+    name: "specverse",
+    displayName: "SpecVerse",
+    description: "SpecVerse specification language support \u2014 syntax highlighting, validation, IntelliSense",
+    version: specVersion,
+    publisher: "specverse",
+    engines: { vscode: "^1.80.0" },
+    categories: ["Programming Languages", "Linters", "Snippets"],
+    activationEvents: ["onLanguage:specverse"],
+    main: "./dist/extension.js",
+    contributes: {
+      languages: [{
+        id: "specverse",
+        aliases: ["SpecVerse", "specly"],
+        extensions: [".specly", ".specverse"],
+        configuration: "./language-configuration.json"
+      }],
+      grammars: [{
+        language: "specverse",
+        scopeName: "source.specverse",
+        path: "./syntaxes/specverse.tmLanguage.json"
+      }],
+      jsonValidation: [{
+        fileMatch: ["*.specly", "*.specverse"],
+        url: "./schemas/specverse-v3-schema.json"
+      }],
+      themes: [
+        { label: "SpecVerse Dark", uiTheme: "vs-dark", path: "./themes/specverse-complete-theme.json" },
+        { label: "SpecVerse Basic", uiTheme: "vs-dark", path: "./themes/specverse-basic-theme.json" }
+      ],
+      commands: commands.map((c) => ({
+        command: c.command,
+        title: c.title,
+        category: c.category
+      }))
+    },
+    scripts: {
+      "vscode:prepublish": "npm run build",
+      build: "node scripts/build.js",
+      package: "npx @vscode/vsce package"
+    },
+    devDependencies: {
+      "@types/vscode": "^1.80.0",
+      "@vscode/vsce": "^3.0.0",
+      esbuild: "^0.25.0"
+    },
+    overrides: {
+      // Force the patched version of lodash through @vscode/vsce →
+      // @secretlint → @textlint transitive chain (4.17.23 has a
+      // code-injection advisory in `_.template`).
+      lodash: "^4.18.1"
+    }
+  };
+}
+function copyRecursive(src, dest) {
+  for (const entry of readdirSync(src)) {
+    if (entry === "extension.ts") continue;
+    const srcPath = join(src, entry);
+    const destPath = join(dest, entry);
+    if (statSync(srcPath).isDirectory()) {
+      if (!existsSync(destPath)) mkdirSync(destPath, { recursive: true });
+      copyRecursive(srcPath, destPath);
+    } else {
+      copyFileSync(srcPath, destPath);
+    }
+  }
+}
+function getStandardCommands() {
+  return [
+    { command: "specverse.validate", title: "Validate specification", category: "SpecVerse" },
+    { command: "specverse.infer", title: "Infer full architecture", category: "SpecVerse" },
+    { command: "specverse.realize", title: "Generate code from specification", category: "SpecVerse" },
+    { command: "specverse.init", title: "Initialize new project", category: "SpecVerse" },
+    { command: "specverse.gen.diagrams", title: "Generate Mermaid diagrams", category: "SpecVerse" },
+    { command: "specverse.gen.docs", title: "Generate documentation", category: "SpecVerse" },
+    { command: "specverse.gen.uml", title: "Generate UML diagrams", category: "SpecVerse" },
+    { command: "specverse.dev.format", title: "Format .specly file", category: "SpecVerse" },
+    { command: "specverse.dev.watch", title: "Watch and validate on change", category: "SpecVerse" },
+    { command: "specverse.dev.quick", title: "Quick validation", category: "SpecVerse" },
+    { command: "specverse.cache", title: "Manage import cache", category: "SpecVerse" },
+    { command: "specverse.ai.docs", title: "Generate AI implementation prompt", category: "SpecVerse" },
+    { command: "specverse.ai.suggest", title: "Get spec improvement suggestions", category: "SpecVerse" },
+    { command: "specverse.ai.template", title: "Load AI prompt template", category: "SpecVerse" }
+  ];
+}
+function capitalize(str) {
+  return str.charAt(0).toUpperCase() + str.slice(1);
+}
+export {
+  generateVSCodeExtension as default
+};

package/dist/realize/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realize/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMlE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AASnF,cAAM,sBAAuB,YAAW,aAAa;IACnD,IAAI,SAAa;IACjB,OAAO,SAAW;IAClB,YAAY,WAA+E;IAE3F,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAS;IAEtB,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjB,OAAO,IAAI,UAAU;IAIrB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG;IAK1B,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC;IAKvF;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAskB9F;;;OAGG;YACW,UAAU;IAwDxB,OAAO,CAAC,oBAAoB;CAuB7B;AAED,eAAO,MAAM,MAAM,wBAA+B,CAAC;AACnD,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/realize/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,cAAc,kBAAkB,CAAC;AAGjC,cAAc,kBAAkB,CAAC;AAGjC,cAAc,uBAAuB,CAAC;AAGtC,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AACpF,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAGvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAMlE,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AASnF,cAAM,sBAAuB,YAAW,aAAa;IACnD,IAAI,SAAa;IACjB,OAAO,SAAW;IAClB,YAAY,WAA+E;IAE3F,OAAO,CAAC,OAAO,CAAa;IAC5B,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,aAAa,CAAa;IAClC,OAAO,CAAC,QAAQ,CAAa;IAC7B,OAAO,CAAC,WAAW,CAAS;IAEtB,UAAU,CAAC,MAAM,CAAC,EAAE;QACxB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,IAAI,CAAC;IAkBjB,OAAO,IAAI,UAAU;IAIrB,OAAO,CAAC,UAAU,EAAE,MAAM,GAAG,GAAG;IAK1B,QAAQ,CAAC,QAAQ,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,GAAG,GAAG,OAAO,CAAC,eAAe,CAAC;IAKvF;;;OAGG;IACG,UAAU,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IA4lB9F;;;OAGG;YACW,UAAU;IAwDxB,OAAO,CAAC,oBAAoB;CAuB7B;AAED,eAAO,MAAM,MAAM,wBAA+B,CAAC;AACnD,eAAe,MAAM,CAAC;AACtB,OAAO,EAAE,sBAAsB,EAAE,CAAC"}

package/dist/realize/index.js

@@ -349,6 +349,27 @@ class SpecVerseRealizeEngine {
             }
             console.log(`   ✅ Routes: ${allModels.length} route handler(s)`);
         }
+        // 4.5 Service routes — HTTP endpoints for service operations
+        //     POST /api/services/{ServiceName}/{operationName}
+        //     Mirrors app-demo's dynamic runtime URL shape (see
+        //     specverse-app-demo/src/api/http-server.ts:611) so smoke-parity
+        //     tests can hit both backends identically.
+        if (routeResolved?.instanceFactory?.codeTemplates?.serviceRoutes && servicesList.length > 0) {
+            let svcRouteCount = 0;
+            for (const service of servicesList) {
+                try {
+                    const svcName = service.name || 'Service';
+                    const output = await this.codeGenerator.generateFromTemplate(routeResolved, 'serviceRoutes', { spec, service: { name: svcName, ...service }, models: allModels }, { outputDir });
+                    writeOutput(output);
+                    svcRouteCount++;
+                }
+                catch (e) {
+                    errors.push(`Service route ${service?.name}: ${e.message}`);
+                }
+            }
+            if (svcRouteCount > 0)
+                console.log(`   ✅ Service routes: ${svcRouteCount} file(s)`);
+        }
         // 5. Views, Forms, Hooks
         const viewsResolved = tryResolve('ui.components');
         if (viewsResolved && spec.views) {