@zintrust/core 0.4.9 → 0.4.10

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zintrust/core",
-  "version": "0.4.9",
+  "version": "0.4.10",
   "description": "Production-grade TypeScript backend framework for JavaScript",
   "homepage": "https://zintrust.com",
   "repository": {

package/src/cli/commands/RoutesCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"RoutesCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/RoutesCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAsSvF,eAAO,MAAM,aAAa;cACd,YAAY;EAatB,CAAC;AAEH,eAAe,aAAa,CAAC"}
+{"version":3,"file":"RoutesCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/RoutesCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAuVvF,eAAO,MAAM,aAAa;cACd,YAAY;EAatB,CAAC;AAEH,eAAe,aAAa,CAAC"}

package/src/cli/commands/RoutesCommand.js

@@ -6,6 +6,8 @@ import { BaseCommand } from '../BaseCommand.js';
 import { Env } from '../../config/env.js';
 import { Router } from '../../routes/Router.js';
 import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { isObject } from '../../helper/index.js';
+import { ProjectRuntime } from '../../runtime/ProjectRuntime.js';
 const parseGroupBy = (value) => {
     const raw = typeof value === 'string' ? value.trim().toLowerCase() : '';
     if (raw === '' || raw === 'group')
@@ -157,6 +159,37 @@ const renderTable = (rows) => {
     console.log(bottom);
     /* eslint-enable no-console */
 };
+const annotateManifestRoutes = (router, beforeCount, serviceId) => {
+    const routes = Router.getRoutes(router);
+    for (const route of routes.slice(beforeCount)) {
+        route.__zintrustServiceId = serviceId;
+    }
+};
+const getRouteServiceId = (route) => {
+    return route.__zintrustServiceId ?? '';
+};
+const registerManifestRoutes = async (router) => {
+    await ProjectRuntime.tryLoadNodeRuntime();
+    const serviceManifest = ProjectRuntime.getServiceManifest();
+    if (serviceManifest.length === 0)
+        return;
+    for (const entry of serviceManifest) {
+        if (entry.monolithEnabled === false || typeof entry.loadRoutes !== 'function')
+            continue;
+        try {
+            const beforeCount = Router.getRoutes(router).length;
+            // eslint-disable-next-line no-await-in-loop
+            const mod = await entry.loadRoutes();
+            if (isObject(mod) && typeof mod.registerRoutes === 'function') {
+                mod.registerRoutes(router);
+                annotateManifestRoutes(router, beforeCount, entry.id);
+            }
+        }
+        catch {
+            // Ignore broken optional service routes and keep listing what is available.
+        }
+    }
+};
 const buildRows = async (options) => {
     const groupBy = parseGroupBy(options.groupBy);
     const filterText = typeof options.filter === 'string' ? options.filter.trim().toLowerCase() : '';
@@ -174,12 +207,14 @@ const buildRows = async (options) => {
     catch {
         // routes/api.ts not found, continue with just core routes
     }
+    await registerManifestRoutes(router);
     const routes = Router.getRoutes(router);
     const rows = routes.map((route) => {
         const path = normalizePath(route.path);
+        const serviceId = getRouteServiceId(route);
         let group = '';
         if (groupBy === 'service') {
-            group = deriveService(path);
+            group = serviceId === '' ? deriveService(path) : serviceId;
         }
         else if (groupBy === 'group') {
             group = deriveGroup(path);

package/src/cli/commands/StartCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"StartCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/StartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAspBvF,eAAO,MAAM,YAAY;cACb,YAAY;EA6BtB,CAAC"}
+{"version":3,"file":"StartCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/StartCommand.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoC,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA2sBvF,eAAO,MAAM,YAAY;cACb,YAAY;EA6BtB,CAAC"}

package/src/cli/commands/StartCommand.js

@@ -168,8 +168,19 @@ const resolveCacheEnabledPreference = (options) => {
         return options.cache;
     return undefined;
 };
-const readPackageJson = (cwd) => {
-    const packagePath = path.join(cwd, 'package.json');
+const findNearestPackageJsonDir = (cwd) => {
+    let current = path.resolve(cwd);
+    while (true) {
+        if (existsSync(path.join(current, 'package.json')))
+            return current;
+        const parent = path.dirname(current);
+        if (parent === current)
+            return undefined;
+        current = parent;
+    }
+};
+const readPackageJsonFromDir = (dir) => {
+    const packagePath = path.join(dir, 'package.json');
     if (!existsSync(packagePath)) {
         throw ErrorFactory.createCliError("Error: No ZinTrust app found. Run 'zin new <project>' or ensure package.json exists.");
     }
@@ -181,6 +192,24 @@ const readPackageJson = (cwd) => {
         throw ErrorFactory.createTryCatchError('Failed to read package.json', error);
     }
 };
+const resolveStartContext = (cwd) => {
+    const projectRoot = findNearestPackageJsonDir(cwd) ?? cwd;
+    const packageDir = findNearestPackageJsonDir(cwd);
+    return {
+        cwd,
+        projectRoot,
+        ...(packageDir === undefined ? {} : { packageJson: readPackageJsonFromDir(packageDir) }),
+    };
+};
+const requirePackageJson = (context) => {
+    if (context.packageJson !== undefined)
+        return context.packageJson;
+    throw ErrorFactory.createCliError("Error: No ZinTrust app found. Run 'zin new <project>' or ensure package.json exists.");
+};
+const buildStartEnv = (projectRoot) => ({
+    ...process.env,
+    ZINTRUST_PROJECT_ROOT: projectRoot,
+});
 const isFrameworkRepo = (packageJson) => packageJson.name === '@zintrust/core';
 const hasDevScript = (packageJson) => {
     const scripts = packageJson.scripts;
@@ -263,14 +292,14 @@ const resolveNodeProdCommand = (cwd) => {
     }
     return { command: 'node', args: [compiled] };
 };
-const executeWranglerStart = async (cmd, cwd, port, runtime, envName, wranglerConfig) => {
+const executeWranglerStart = async (cmd, context, port, runtime, envName, wranglerConfig) => {
     if (runtime !== undefined) {
         throw ErrorFactory.createCliError('Error: --runtime is not supported with --wrangler (Wrangler controls Workers runtime).');
     }
     const normalizedConfig = typeof wranglerConfig === 'string' ? wranglerConfig.trim() : '';
-    const explicitConfigFullPath = normalizedConfig.length > 0 ? path.join(cwd, normalizedConfig) : undefined;
-    const configPath = explicitConfigFullPath ?? findWranglerConfig(cwd);
-    const entry = resolveWranglerEntry(cwd);
+    const explicitConfigFullPath = normalizedConfig.length > 0 ? path.join(context.cwd, normalizedConfig) : undefined;
+    const configPath = explicitConfigFullPath ?? findWranglerConfig(context.cwd);
+    const entry = resolveWranglerEntry(context.cwd);
     if (explicitConfigFullPath !== undefined) {
         if (existsSync(explicitConfigFullPath)) {
             // ok
@@ -300,7 +329,7 @@ const executeWranglerStart = async (cmd, cwd, port, runtime, envName, wranglerCo
     const exitCode = await SpawnUtil.spawnAndWait({
         command: 'wrangler',
         args: wranglerArgs,
-        env: process.env,
+        env: buildStartEnv(context.projectRoot),
     });
     process.exit(exitCode);
 };
@@ -321,92 +350,98 @@ const ensureTmpRunnerFile = (cwd, filename, content) => {
     }
     return fullPath;
 };
-const executeDenoStart = async (cmd, cwd, mode, watchEnabled, _port, runtime) => {
+const executeDenoStart = async (cmd, context, mode, watchEnabled, _port, runtime) => {
     if (runtime !== undefined) {
         throw ErrorFactory.createCliError('Error: --runtime cannot be used with --deno.');
     }
     if (mode === 'testing') {
         throw ErrorFactory.createCliError('Error: Cannot start server in testing mode. Use development or production.');
     }
-    const startModuleSpecifier = resolveRuntimeStartModuleSpecifier(cwd);
-    const denoRunner = ensureTmpRunnerFile(cwd, 'zin-start-deno.ts', createDenoRunnerSource(startModuleSpecifier));
+    const startModuleSpecifier = resolveRuntimeStartModuleSpecifier(context.cwd);
+    const denoRunner = ensureTmpRunnerFile(context.cwd, 'zin-start-deno.ts', createDenoRunnerSource(startModuleSpecifier));
     const args = [];
     if (mode === 'development' && watchEnabled)
         args.push('watch');
     args.push(denoRunner);
     cmd.info('Starting in Deno adapter mode...');
-    const exitCode = await SpawnUtil.spawnAndWait({ command: 'tsx', args, env: process.env });
+    const exitCode = await SpawnUtil.spawnAndWait({
+        command: 'tsx',
+        args,
+        env: buildStartEnv(context.projectRoot),
+    });
     process.exit(exitCode);
 };
-const executeLambdaStart = async (cmd, cwd, mode, watchEnabled, _port, runtime) => {
+const executeLambdaStart = async (cmd, context, mode, watchEnabled, _port, runtime) => {
     if (runtime !== undefined) {
         throw ErrorFactory.createCliError('Error: --runtime cannot be used with --lambda.');
     }
     if (mode === 'testing') {
         throw ErrorFactory.createCliError('Error: Cannot start server in testing mode. Use development or production.');
     }
-    const startModuleSpecifier = resolveRuntimeStartModuleSpecifier(cwd);
-    const lambdaRunner = ensureTmpRunnerFile(cwd, 'zin-start-lambda.ts', createLambdaRunnerSource(startModuleSpecifier));
+    const startModuleSpecifier = resolveRuntimeStartModuleSpecifier(context.cwd);
+    const lambdaRunner = ensureTmpRunnerFile(context.cwd, 'zin-start-lambda.ts', createLambdaRunnerSource(startModuleSpecifier));
     const args = [];
     if (mode === 'development' && watchEnabled)
         args.push('watch');
     args.push(lambdaRunner);
     cmd.info('Starting in Lambda adapter mode...');
-    const exitCode = await SpawnUtil.spawnAndWait({ command: 'tsx', args, env: process.env });
+    const exitCode = await SpawnUtil.spawnAndWait({
+        command: 'tsx',
+        args,
+        env: buildStartEnv(context.projectRoot),
+    });
     process.exit(exitCode);
 };
-const executeNodeStart = async (cmd, cwd, mode, watchEnabled, _port) => {
+const executeNodeStart = async (cmd, context, mode, watchEnabled, _port) => {
     if (mode === 'testing') {
         throw ErrorFactory.createCliError('Error: Cannot start server in testing mode. Use --force to override (not supported).');
     }
     if (mode === 'development') {
         if (!watchEnabled) {
             cmd.warn('Watch mode disabled; starting once.');
-            const bootstrap = resolveBootstrapEntryTs(cwd);
+            const bootstrap = resolveBootstrapEntryTs(context.cwd);
             const args = bootstrap === undefined ? ['src/index.ts'] : [bootstrap];
             const exitCode = await SpawnUtil.spawnAndWait({
                 command: 'tsx',
                 args,
                 forwardSignals: false,
-                env: process.env,
+                env: buildStartEnv(context.projectRoot),
             });
             process.exit(exitCode);
         }
-        const packageJson = readPackageJson(cwd);
-        const dev = resolveNodeDevCommand(cwd, packageJson);
+        const dev = resolveNodeDevCommand(context.cwd, requirePackageJson(context));
         cmd.info('Starting in development mode (watch enabled)...');
         const exitCode = await SpawnUtil.spawnAndWait({
             command: dev.command,
             args: dev.args,
             forwardSignals: false,
-            env: process.env,
+            env: buildStartEnv(context.projectRoot),
         });
         process.exit(exitCode);
     }
-    const prod = resolveNodeProdCommand(cwd);
+    const prod = resolveNodeProdCommand(context.cwd);
     cmd.info('Starting in production mode...');
     const exitCode = await SpawnUtil.spawnAndWait({
         command: prod.command,
         args: prod.args,
         forwardSignals: false,
-        env: process.env,
+        env: buildStartEnv(context.projectRoot),
     });
     process.exit(exitCode);
 };
-const executeSplitStart = async (cmd, cwd, _options) => {
+const executeSplitStart = async (cmd, context, _options) => {
     cmd.info('🚀 Starting in split mode (Producer + Consumer)...');
-    const packageJson = readPackageJson(cwd);
-    const webDev = resolveNodeDevCommand(cwd, packageJson);
+    const webDev = resolveNodeDevCommand(context.cwd, requirePackageJson(context));
     // Producer Environment
     const producerEnv = {
-        ...process.env,
+        ...buildStartEnv(context.projectRoot),
         WORKER_ENABLED: 'false',
         QUEUE_ENABLED: 'true',
         RUNTIME_MODE: 'node-server',
     };
     // Consumer Environment
     const consumerEnv = {
-        ...process.env,
+        ...buildStartEnv(context.projectRoot),
         WORKER_ENABLED: 'true',
         QUEUE_ENABLED: 'true',
         RUNTIME_MODE: 'containers',
@@ -417,10 +452,10 @@ const executeSplitStart = async (cmd, cwd, _options) => {
     };
     // Resolve Consumer Command (zintrust worker:start-all)
     // We try to use tsx against the source bin if possible
-    const workerArgs = existsSync(path.join(cwd, 'bin/zin.ts'))
+    const workerArgs = existsSync(path.join(context.projectRoot, 'bin/zin.ts'))
         ? ['bin/zin.ts', 'worker:start-all']
         : ['dist/bin/zin.js', 'worker:start-all'];
-    const workerCommand = existsSync(path.join(cwd, 'bin/zin.ts')) ? 'tsx' : 'node';
+    const workerCommand = existsSync(path.join(context.projectRoot, 'bin/zin.ts')) ? 'tsx' : 'node';
     cmd.info('-------------------------------------------');
     cmd.info('🔹 [Producer] Web Server starting...');
     cmd.info('🔸 [Consumer] Worker Process starting...');
@@ -428,12 +463,14 @@ const executeSplitStart = async (cmd, cwd, _options) => {
     const pProducer = SpawnUtil.spawnAndWait({
         command: webDev.command,
         args: webDev.args,
+        cwd: context.cwd,
         env: producerEnv,
         forwardSignals: true,
     });
     const pConsumer = SpawnUtil.spawnAndWait({
         command: workerCommand,
         args: workerArgs,
+        cwd: context.projectRoot,
         env: consumerEnv,
         forwardSignals: true,
     });
@@ -441,6 +478,7 @@ const executeSplitStart = async (cmd, cwd, _options) => {
 };
 const executeStart = async (options, cmd) => {
     const cwd = process.cwd();
+    const context = resolveStartContext(cwd);
     EnvFileLoader.ensureLoaded();
     const mode = resolveMode(options);
     const port = resolvePort(options);
@@ -454,7 +492,7 @@ const executeStart = async (options, cmd) => {
     if (variant === 'lambda')
         effectiveRuntime = 'lambda';
     if (mode === 'split') {
-        await executeSplitStart(cmd, cwd, options);
+        await executeSplitStart(cmd, context, options);
         return;
     }
     assertCompatibleStartVariant(variant, configuredRuntime);
@@ -469,7 +507,7 @@ const executeStart = async (options, cmd) => {
         const wranglerConfig = typeof options.wranglerConfig === 'string' && options.wranglerConfig.trim() !== ''
             ? options.wranglerConfig.trim()
             : undefined;
-        await executeWranglerStart(cmd, cwd, port, runtime, envName === '' ? undefined : envName, wranglerConfig);
+        await executeWranglerStart(cmd, context, port, runtime, envName === '' ? undefined : envName, wranglerConfig);
         return;
     }
     if (envName !== '') {
@@ -477,14 +515,14 @@ const executeStart = async (options, cmd) => {
     }
     const watchEnabled = resolveWatchPreference(options, mode);
     if (variant === 'deno') {
-        await executeDenoStart(cmd, cwd, mode, watchEnabled, port, runtime);
+        await executeDenoStart(cmd, context, mode, watchEnabled, port, runtime);
         return;
     }
     if (variant === 'lambda') {
-        await executeLambdaStart(cmd, cwd, mode, watchEnabled, port, runtime);
+        await executeLambdaStart(cmd, context, mode, watchEnabled, port, runtime);
         return;
     }
-    await executeNodeStart(cmd, cwd, mode, watchEnabled, port);
+    await executeNodeStart(cmd, context, mode, watchEnabled, port);
 };
 export const StartCommand = Object.freeze({
     create() {

package/src/cli/scaffolding/ServiceScaffolder.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ServiceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ServiceScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuB7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAGnF;AAED;;GAEG;AAEH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAiDhC;AAobD,eAAO,MAAM,iBAAiB;;;;EAI5B,CAAC"}
+{"version":3,"file":"ServiceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ServiceScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,QAAQ,GAAG,UAAU,CAAC;IACjC,IAAI,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAC7C,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB;AAUD;;GAEG;AAEH;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,cAAc,GAAG;IAAE,KAAK,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAA;CAAE,CAuB7F;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,MAAM,CAGnF;AAED;;GAEG;AAEH,wBAAgB,QAAQ,CACtB,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,cAAc,GACtB,OAAO,CAAC,qBAAqB,CAAC,CAiDhC;AA8bD,eAAO,MAAM,iBAAiB;;;;EAI5B,CAAC"}

package/src/cli/scaffolding/ServiceScaffolder.js

@@ -5,6 +5,10 @@
 import { FileGenerator } from '../scaffolding/FileGenerator.js';
 import { Logger } from '../../config/logger.js';
 import * as path from '../../node-singletons/path.js';
+const coreModuleSpecifier = ['@zintrust', 'core'].join('/');
+const coreStartModuleSpecifier = `${coreModuleSpecifier}/start`;
+const serviceManifestImportExpression = "import('./bootstrap/service-manifest.ts').catch(() => import('./bootstrap/service-manifest.js'))";
+const buildRouteImportExpression = (domain, serviceName) => `import('../services/${domain}/${serviceName}/routes/api.ts').catch(() => import('../services/${domain}/${serviceName}/routes/api.js'))`;
 /**
  * ServiceScaffolder generates microservices with all necessary files
  */
@@ -91,11 +95,12 @@ export function scaffold(projectRoot, options) {
 function ensureProjectRuntimeFiles(projectRoot, options) {
     const domain = options.domain ?? 'default';
     const serviceId = `${domain}/${options.name}`;
+    const routeImportExpression = buildRouteImportExpression(domain, options.name);
     const bootstrapDir = path.join(projectRoot, 'src', 'bootstrap');
     FileGenerator.createDirectory(bootstrapDir);
     const manifestPath = path.join(bootstrapDir, 'service-manifest.ts');
     if (!FileGenerator.fileExists(manifestPath)) {
-        const initialManifest = `import type { ServiceManifestEntry } from '../../index.js';
+        const initialManifest = `import type { ServiceManifestEntry } from '${coreModuleSpecifier}';
 
 export const serviceManifest: ReadonlyArray<ServiceManifestEntry> = [
   {
@@ -104,7 +109,7 @@ export const serviceManifest: ReadonlyArray<ServiceManifestEntry> = [
     name: '${options.name}',
     port: ${options.port ?? 3001},
     monolithEnabled: true,
-    loadRoutes: async () => import('../services/${domain}/${options.name}/routes/api'),
+    loadRoutes: async () => ${routeImportExpression},
   },
 ];
 
@@ -112,7 +117,9 @@ export default serviceManifest;
 `;
         FileGenerator.writeFile(manifestPath, initialManifest);
     }
-    const runtimeModule = `import serviceManifest from './bootstrap/service-manifest';
+    const runtimeModule = `const serviceManifestModule = await ${serviceManifestImportExpression};
+
+const serviceManifest = serviceManifestModule.default ?? serviceManifestModule.serviceManifest ?? [];
 
 export { serviceManifest };
 
@@ -128,6 +135,7 @@ export default Object.freeze({ serviceManifest });
 function updateServiceManifest(projectRoot, options) {
     const domain = options.domain ?? 'default';
     const serviceId = `${domain}/${options.name}`;
+    const routeImportExpression = buildRouteImportExpression(domain, options.name);
     const manifestPath = path.join(projectRoot, 'src', 'bootstrap', 'service-manifest.ts');
     if (!FileGenerator.fileExists(manifestPath))
         return;
@@ -141,7 +149,7 @@ function updateServiceManifest(projectRoot, options) {
     name: '${options.name}',
     port: ${options.port ?? 3001},
     monolithEnabled: true,
-    loadRoutes: async () => import('../services/${domain}/${options.name}/routes/api'),
+    loadRoutes: async () => ${routeImportExpression},
   },
 `;
     const marker = '];';
@@ -234,7 +242,7 @@ function generateServiceIndex(options) {
  * Auth: ${options.auth ?? 'api-key'}
  */
 
-import { bootStandaloneService } from '../../start.js';
+import { bootStandaloneService } from '${coreStartModuleSpecifier}';
 
 await bootStandaloneService(import.meta.url, {
   id: '${serviceId}',
@@ -244,7 +252,7 @@ await bootStandaloneService(import.meta.url, {
 });
 
 // Cloudflare Workers entry.
-export { default } from '../../start.js';
+export { default } from '${coreStartModuleSpecifier}';
 `;
 }
 /**
@@ -255,7 +263,7 @@ function generateServiceRoutes(options) {
  * ${options.name} Service Routes
  */
 
-import { Router, type IRequest, type IResponse, type IRouter } from '../../index.js';
+import { Router, type IRequest, type IResponse, type IRouter } from '${coreModuleSpecifier}';
 
 export function registerRoutes(router: IRouter): void {
   // Example route
@@ -326,8 +334,7 @@ function generateExampleController(options) {
  * Example Controller for ${options.name} Service
  */
 
-import { type IRequest, type IResponse, Controller } from '../../index.js';
-
+import { type IRequest, type IResponse, Controller } from '${coreModuleSpecifier}';
 const controller = Object.freeze({
   ...Controller,
 
@@ -389,7 +396,7 @@ function generateExampleModel(options) {
  * Example Model for ${options.name} Service
  */
 
-import { Model } from '../../index.js';
+import { Model } from '${coreModuleSpecifier}';
 
 export const Example = Model.define({
   table: '${options.name}',
@@ -447,6 +454,8 @@ function getServiceConfig(options) {
  */
 function generateServiceReadme(options) {
     const config = getServiceConfig(options);
+    const serviceDir = `src/services/${config.domain}/${options.name}`;
+    const serviceId = `${config.domain}/${options.name}`;
     return `# ${options.name} Service
 
 Microservice for ${config.domain} domain.
@@ -460,14 +469,19 @@ Microservice for ${config.domain} domain.
 ## Getting Started
 
 \`\`\`bash
-# Start service
-npm start
+# Start this service from its service directory (Node)
+cd ${serviceDir}
+zin s
+
+# Start this service with Cloudflare Workers dev
+cd ${serviceDir}
+zin s --wg
+
+# List this service routes from the project root
+MICROSERVICES=true SERVICES=${serviceId} zin routes
 
 # Run tests
 npm test
-
-# Run migrations
-npm run migrate
 \`\`\`
 
 ## Environment Variables

package/src/index.js

@@ -1,11 +1,11 @@
 /**
- * @zintrust/core v0.4.9
+ * @zintrust/core v0.4.10
  *
  * ZinTrust Framework - Production-Grade TypeScript Backend
  * Built for performance, type safety, and exceptional developer experience
  *
  * Build Information:
- *   Built: 2026-03-23T11:19:34.232Z
+ *   Built: 2026-03-23T12:53:44.665Z
  *   Node: >=20.0.0
  *   License: MIT
  *
@@ -21,7 +21,7 @@
  * Available at runtime for debugging and health checks
  */
 export const ZINTRUST_VERSION = '0.1.41';
-export const ZINTRUST_BUILD_DATE = '2026-03-23T11:19:34.198Z'; // Replaced during build
+export const ZINTRUST_BUILD_DATE = '2026-03-23T12:53:44.591Z'; // Replaced during build
 export { Application } from './boot/Application.js';
 export { AwsSigV4 } from './common/index.js';
 export { SignedRequest } from './security/SignedRequest.js';

package/src/runtime/OverrideValueMerge.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"OverrideValueMerge.d.ts","sourceRoot":"","sources":["../../../src/runtime/OverrideValueMerge.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,GAAI,MAAM,OAAO,EAAE,UAAU,OAAO,KAAG,OAYtE,CAAC;AAEF,eAAe,mBAAmB,CAAC"}
+{"version":3,"file":"OverrideValueMerge.d.ts","sourceRoot":"","sources":["../../../src/runtime/OverrideValueMerge.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,mBAAmB,GAAI,MAAM,OAAO,EAAE,UAAU,OAAO,KAAG,OAatE,CAAC;AAEF,eAAe,mBAAmB,CAAC"}

package/src/runtime/OverrideValueMerge.js

@@ -6,7 +6,8 @@ export const mergeOverrideValues = (base, override) => {
     const merged = { ...base };
     for (const [key, value] of Object.entries(override)) {
         const current = merged[key];
-        merged[key] = isObject(current) && isObject(value) ? mergeOverrideValues(current, value) : value;
+        merged[key] =
+            isObject(current) && isObject(value) ? mergeOverrideValues(current, value) : value;
     }
     return merged;
 };

package/src/templates/project/basic/src/zintrust.runtime.ts.tpl

@@ -1,4 +1,8 @@
-import serviceManifest from './bootstrap/service-manifest';
+const serviceManifestModule = await import('./bootstrap/service-manifest.ts').catch(() =>
+	import('./bootstrap/service-manifest.js')
+);
+
+const serviceManifest = serviceManifestModule.default ?? serviceManifestModule.serviceManifest ?? [];
 
 export { serviceManifest };
 

package/src/templates/project/basic/src/zintrust.runtime.wg.ts.tpl

@@ -1,4 +1,8 @@
-import serviceManifest from './bootstrap/service-manifest';
+const serviceManifestModule = await import('./bootstrap/service-manifest.ts').catch(() =>
+	import('./bootstrap/service-manifest.js')
+);
+
+const serviceManifest = serviceManifestModule.default ?? serviceManifestModule.serviceManifest ?? [];
 
 export { serviceManifest };