@zintrust/core 0.4.26 → 0.4.28

package/src/cli/commands/InitContainerCommand.js

@@ -6,14 +6,14 @@ import { join } from '../../node-singletons/path.js';
 const DOCKER_COMPOSE_WORKERS_TEMPLATE = `name: zintrust-workers
 
 services:
-  # Workers/Jobs API Service (Port 7772)
-  # Exposes the Workers API to create/manage jobs
+  # Worker runtime service (Port 7772)
+  # Boots the full ZinTrust server so the worker pages stay reachable while workers auto-start.
   workers-api:
-    image: \${WORKERS_IMAGE:-zintrust/zintrust-workers:latest}
+    image: \${WORKERS_IMAGE:-zintrust-workers-local:latest}
     build:
       context: .
-      dockerfile: Dockerfile
-    command: ["node", "--experimental-specifier-resolution=node", "dist/src/boot/bootstrap.js"]
+      dockerfile: Dockerfile.workers
+      target: worker
     environment:
       # Runtime
       - NODE_ENV=\${NODE_ENV:-development}
@@ -26,11 +26,10 @@ services:
       - APP_KEY=\${APP_KEY}
       - ENCRYPTION_CIPHER=\${ENCRYPTION_CIPHER:-aes-256-cbc}
       - LOG_LEVEL=\${LOG_LEVEL:-info}
-      - ZINTRUST_PROJECT_ROOT=/app/dist
 
       # Workers & Queue
-      - WORKER_ENABLED=\${WORKER_ENABLED:-false}
-      - WORKER_AUTO_START=\${WORKER_AUTO_START:-false}
+  - WORKER_ENABLED=\${WORKER_ENABLED:-true}
+  - WORKER_AUTO_START=\${WORKER_AUTO_START:-true}
       - QUEUE_ENABLED=true
       - QUEUE_MONITOR_ENABLED=\${QUEUE_MONITOR_ENABLED:-false}
       - QUEUE_MONITOR_MIDDLEWARE=\${QUEUE_MONITOR_MIDDLEWARE:-}
@@ -97,22 +96,61 @@ services:
       - '7772:7772'
 
 `;
-const DOCKERFILE_TEMPLATE = String.raw `FROM zintrust/zintrust:latest AS runtime
+const DOCKERFILE_TEMPLATE = String.raw `# Multi-stage worker overlay image.
+#
+# This compiles the local ZinTrust app first, then copies only the compiled worker-related
+# artifacts onto the published zintrust/zintrust runtime image.
+
+FROM node:20-alpine AS project-build
+
+WORKDIR /project
+
+ENV NPM_CONFIG_CACHE=/root/.npm
+ENV NPM_CONFIG_PREFER_OFFLINE=true
+
+RUN apk upgrade --no-cache \
+  && apk add --no-cache g++ git make python3
+
+COPY package.json package-lock.json ./
+
+RUN --mount=type=cache,target=/root/.npm,id=zintrust-worker-overlay-npm-cache,sharing=locked \
+  npm config set fetch-retries 5 \
+    && npm config set fetch-retry-mintimeout 20000 \
+    && npm config set fetch-retry-maxtimeout 120000 \
+    && npm ci
+
+COPY . .
+
+# Fresh projects always ship npm run build; do not depend on framework-internal build variants.
+RUN --mount=type=cache,target=/root/.npm,id=zintrust-worker-overlay-npm-cache,sharing=locked npm run build
+
+FROM project-build AS worker-overlay
+
+RUN set -eu; \
+  overlay_root=/overlay; \
+  mkdir -p "$overlay_root/dist"; \
+  if [ -d /project/dist/app ]; then cp -R /project/dist/app "$overlay_root/dist/app"; fi; \
+  mkdir -p "$overlay_root/dist/src"; \
+  if [ -f /project/dist/src/zintrust.workers.js ]; then cp /project/dist/src/zintrust.workers.js "$overlay_root/dist/src/zintrust.workers.js"; fi; \
+  if [ -f /project/dist/src/zintrust.workers.js.map ]; then cp /project/dist/src/zintrust.workers.js.map "$overlay_root/dist/src/zintrust.workers.js.map"; fi
+
+FROM zintrust/zintrust:latest AS runtime
 
 WORKDIR /app
 
-ENV NODE_ENV=production
-ENV PORT=7772
-ENV HOST=0.0.0.0
+COPY --from=worker-overlay --chown=nodejs:nodejs /overlay/dist/ /app/dist/
 
-USER nodejs
+FROM runtime AS worker
 
-HEALTHCHECK --interval=30s --timeout=10s --start-period=5s --retries=3 \
-  CMD node -e "require('node:http').get('http://localhost:7772/health', (r) => {if (r.statusCode !== 200) throw new Error(r.statusCode)})"
+ENV WORKER_ENABLED=true
+ENV WORKER_AUTO_START=true
+ENV QUEUE_ENABLED=true
+ENV HOST=0.0.0.0
+ENV PORT=7772
 
-EXPOSE 7772
+HEALTHCHECK NONE
 
-CMD ["node", "dist/src/boot/bootstrap.js"]
+CMD ["node", "--experimental-specifier-resolution=node", "dist/src/boot/bootstrap.js"]
 `;
 const backupSuffix = () => new Date().toISOString().replaceAll(/[:.]/g, '-');
 const backupFileIfExists = (filePath) => {
@@ -138,19 +176,18 @@ async function writeDockerComposeFile(cwd) {
     }
 }
 async function writeDockerfile(cwd) {
-    const dockerfilePath = join(cwd, 'Dockerfile');
+    const dockerfilePath = join(cwd, 'Dockerfile.workers');
     let shouldWrite = true;
     if (existsSync(dockerfilePath)) {
-        // Only ask if it's different or just generic confirm? Let's just ask.
-        shouldWrite = await PromptHelper.confirm('Dockerfile already exists. Overwrite with standard worker configuration?', false);
+        shouldWrite = await PromptHelper.confirm('Dockerfile.workers already exists. Overwrite with the ZinTrust worker overlay image?', false);
     }
     if (shouldWrite) {
         backupFileIfExists(dockerfilePath);
         writeFileSync(dockerfilePath, DOCKERFILE_TEMPLATE);
-        Logger.info('✅ Created Dockerfile');
+        Logger.info('✅ Created Dockerfile.workers');
     }
     else {
-        Logger.info('Skipped Dockerfile');
+        Logger.info('Skipped Dockerfile.workers');
     }
 }
 export const InitContainerCommand = Object.freeze({
@@ -165,7 +202,8 @@ export const InitContainerCommand = Object.freeze({
                 await writeDockerComposeFile(cwd);
                 await writeDockerfile(cwd);
                 Logger.info('✅ Container worker scaffolding complete.');
-                Logger.info('Run with: docker-compose -f docker-compose.workers.yml up');
+                Logger.info('Run with: docker compose -f docker-compose.workers.yml up');
+                Logger.info('Build worker runtime with: docker build -f Dockerfile.workers --target worker .');
                 await Promise.resolve();
             },
         });

package/src/cli/commands/KvProxyCommand.d.ts

@@ -0,0 +1,6 @@
+import type { IBaseCommand } from '../BaseCommand';
+export declare const KvProxyCommand: Readonly<{
+    create(): IBaseCommand;
+}>;
+export default KvProxyCommand;
+//# sourceMappingURL=KvProxyCommand.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"KvProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/KvProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA0KrE,eAAO,MAAM,cAAc;cACf,YAAY;EAmCtB,CAAC;AAEH,eAAe,cAAc,CAAC"}

package/src/cli/commands/KvProxyCommand.js

@@ -0,0 +1,158 @@
+import { BaseCommand } from '../BaseCommand.js';
+import { maybeRunProxyWatchMode } from '../commands/ProxyCommandUtils.js';
+import { SpawnUtil } from '../utils/spawn.js';
+import { Env } from '../../config/env.js';
+import { Logger } from '../../config/logger.js';
+import { ErrorFactory } from '../../exceptions/ZintrustError.js';
+import { isNonEmptyString } from '../../helper/index.js';
+import { existsSync, readFileSync, writeFileSync } from '../../node-singletons/fs.js';
+import { join } from '../../node-singletons/path.js';
+const DEFAULT_CONFIG = 'wrangler.jsonc';
+const DEFAULT_COMPATIBILITY_DATE = '2026-03-12';
+const DEFAULT_BINDING = 'ZIN_KV';
+const DEFAULT_NAMESPACE_ID = '<your-kv-namespace-id>';
+const trimOption = (value) => {
+    if (!isNonEmptyString(value))
+        return undefined;
+    const trimmed = value.trim();
+    return trimmed.length > 0 ? trimmed : undefined;
+};
+const resolveConfigPath = (raw) => trimOption(raw) ?? DEFAULT_CONFIG;
+const findQuotedValue = (content, key) => {
+    const pattern = new RegExp(String.raw `"${key}"\s*:\s*"([^"]+)"`);
+    const match = pattern.exec(content);
+    return trimOption(match?.[1]);
+};
+const resolveConfigValues = (content, options) => {
+    const fileContent = content ?? '';
+    const namespaceId = trimOption(options.namespaceId) ??
+        trimOption(Env.get('KV_NAMESPACE_ID', '')) ??
+        findQuotedValue(fileContent, 'preview_id') ??
+        findQuotedValue(fileContent, 'id') ??
+        DEFAULT_NAMESPACE_ID;
+    return {
+        binding: trimOption(options.binding) ??
+            trimOption(Env.get('KV_NAMESPACE', '')) ??
+            findQuotedValue(fileContent, 'KV_NAMESPACE') ??
+            findQuotedValue(fileContent, 'binding') ??
+            DEFAULT_BINDING,
+        namespaceId,
+        previewId: trimOption(options.previewId) ??
+            trimOption(Env.get('KV_NAMESPACE_PREVIEW_ID', '')) ??
+            findQuotedValue(fileContent, 'preview_id') ??
+            namespaceId,
+    };
+};
+const renderKvProxyEnvBlock = (values) => {
+    return [
+        '    "kv-proxy": {',
+        '      "name": "zintrust-kv-proxy",',
+        '      "main": "./src/proxy/kv/ZintrustKvProxy.ts",',
+        '      "compatibility_flags": ["nodejs_compat"],',
+        `      "compatibility_date": "${DEFAULT_COMPATIBILITY_DATE}",`,
+        '      "vars": {',
+        `        "KV_NAMESPACE": "${values.binding}",`,
+        '        "NODE_ENV": "development"',
+        '      },',
+        '      "kv_namespaces": [',
+        '        {',
+        `          "binding": "${values.binding}",`,
+        `          "id": "${values.namespaceId}",`,
+        `          "preview_id": "${values.previewId}",`,
+        '          "remote": false',
+        '        }',
+        '      ]',
+        '    }',
+    ].join('\n');
+};
+const renderDefaultWranglerConfig = (values) => {
+    return [
+        '{',
+        '  "name": "zintrust-api",',
+        '  "main": "./src/functions/cloudflare.ts",',
+        `  "compatibility_date": "${DEFAULT_COMPATIBILITY_DATE}",`,
+        '  "compatibility_flags": ["nodejs_compat"],',
+        '  "env": {',
+        renderKvProxyEnvBlock(values),
+        '  }',
+        '}',
+        '',
+    ].join('\n');
+};
+const injectEnvBlock = (content, block) => {
+    if (/"kv-proxy"\s*:\s*\{/.test(content))
+        return content;
+    if (/"env"\s*:\s*\{\s*\}/m.test(content)) {
+        return content.replace(/"env"\s*:\s*\{\s*\}/m, `"env": {\n${block}\n  }`);
+    }
+    if (/"env"\s*:\s*\{/m.test(content)) {
+        return content.replace(/"env"\s*:\s*\{/m, (match) => `${match}\n${block},`);
+    }
+    const closingIndex = content.lastIndexOf('}');
+    if (closingIndex < 0) {
+        throw ErrorFactory.createCliError('Invalid wrangler.jsonc: missing closing brace.');
+    }
+    const before = content.slice(0, closingIndex).trimEnd();
+    const suffix = before.endsWith('{') ? '\n' : ',\n';
+    return `${before}${suffix}  "env": {\n${block}\n  }\n}\n`;
+};
+const ensureWranglerConfig = (configPath, options) => {
+    if (!existsSync(configPath)) {
+        const values = resolveConfigValues(undefined, options);
+        writeFileSync(configPath, renderDefaultWranglerConfig(values), 'utf-8');
+        return { createdFile: true, insertedEnv: true, values };
+    }
+    const content = readFileSync(configPath, 'utf-8');
+    const values = resolveConfigValues(content, options);
+    const next = injectEnvBlock(content, renderKvProxyEnvBlock(values));
+    if (next !== content) {
+        writeFileSync(configPath, next, 'utf-8');
+        return { createdFile: false, insertedEnv: true, values };
+    }
+    return { createdFile: false, insertedEnv: false, values };
+};
+const warnOnPlaceholderNamespaceId = (values) => {
+    if (values.namespaceId !== DEFAULT_NAMESPACE_ID)
+        return;
+    Logger.warn('Could not resolve a KV namespace id automatically. Update wrangler.jsonc or pass --namespace-id before relying on the generated kv-proxy environment.');
+};
+const addOptions = (command) => {
+    command.option('-c, --config <path>', 'Wrangler config file', DEFAULT_CONFIG);
+    command.option('--watch', 'Auto-restart proxy on file changes');
+    command.option('--binding <name>', 'KV binding name', DEFAULT_BINDING);
+    command.option('--namespace-id <id>', 'Cloudflare KV namespace id');
+    command.option('--preview-id <id>', 'Cloudflare KV preview namespace id');
+};
+export const KvProxyCommand = Object.freeze({
+    create() {
+        return BaseCommand.create({
+            name: 'proxy:kv',
+            aliases: ['kv:proxy'],
+            description: 'Start the local Cloudflare KV proxy Worker via Wrangler and scaffold env.kv-proxy in wrangler.jsonc when missing',
+            addOptions,
+            execute: async (options) => {
+                await maybeRunProxyWatchMode(options.watch);
+                const cwd = process.cwd();
+                const configPath = join(cwd, resolveConfigPath(options.config));
+                const result = ensureWranglerConfig(configPath, options);
+                if (result.createdFile) {
+                    Logger.info(`Created ${configPath} with a default kv-proxy environment.`);
+                }
+                else if (result.insertedEnv) {
+                    Logger.info(`Added env.kv-proxy to ${configPath}.`);
+                }
+                warnOnPlaceholderNamespaceId(result.values);
+                const exitCode = await SpawnUtil.spawnAndWait({
+                    command: 'wrangler',
+                    args: ['dev', '--config', configPath, '--env', 'kv-proxy'],
+                    env: process.env,
+                    forwardSignals: false,
+                });
+                if (exitCode !== 0) {
+                    process.exit(exitCode);
+                }
+            },
+        });
+    },
+});
+export default KvProxyCommand;

package/src/cli/commands/MigrateCommand.js

@@ -215,7 +215,7 @@ const warnIfAdapterMissing = (cmd, conn) => {
     if (conn.driver === 'mysql' && DatabaseAdapterRegistry.get('mysql') === undefined) {
         cmd.warn('MySQL adapter is not installed/registered; migrations may not hit a real MySQL DB.');
         cmd.warn('Install via `zin plugin install adapter:mysql` (or `zin add db:mysql`).');
-        cmd.debug('[debug] Expected a side-effect import in src/zintrust.plugins.ts like: import "@zintrust/db-mysql/register";');
+        cmd.debug('[debug] Expected a side-effect import in src/zintrust.plugins.ts like: import "../../../packages/db-mysql/src/register";');
     }
     if (conn.driver === 'postgresql' && DatabaseAdapterRegistry.get('postgresql') === undefined) {
         cmd.warn('PostgreSQL adapter is not installed/registered; migrations may not hit a real PostgreSQL DB.');

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

@@ -1 +1 @@
-{"version":3,"file":"MigrateWorkerCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateWorkerCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAiNrE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAUtB,CAAC"}
+{"version":3,"file":"MigrateWorkerCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/MigrateWorkerCommand.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAuNrE,eAAO,MAAM,oBAAoB;cACrB,YAAY;EAUtB,CAAC"}

package/src/cli/commands/MigrateWorkerCommand.js

@@ -15,7 +15,12 @@ const isBuiltInDriver = (driver) => driver === 'sqlite' ||
     driver === 'sqlserver' ||
     driver === 'd1' ||
     driver === 'd1-remote';
-const getWorkerPersistenceConnectionName = () => {
+const getWorkerPersistenceConnectionName = (optionValue) => {
+    if (typeof optionValue === 'string') {
+        const trimmed = optionValue.trim();
+        if (trimmed.length > 0)
+            return trimmed;
+    }
     if (typeof process === 'undefined')
         return 'default';
     const raw = process.env?.['WORKER_PERSISTENCE_DB_CONNECTION'];
@@ -31,6 +36,7 @@ const addOptions = (command) => {
         .option('--step <number>', 'Number of batches to rollback (use with --rollback)', '1')
         .option('--force', 'Skip production confirmation (allow unsafe operations in production)')
         .option('--all', 'Run migrations for all configured database connections')
+        .option('--connection <name>', 'Use a specific database connection for worker migrations')
         .option('--no-interactive', 'Disable interactive prompts (useful for CI/CD)');
 };
 const getInteractive = (options) => options['interactive'] !== false;
@@ -137,7 +143,7 @@ const executeMigrateWorker = async (options, cmd) => {
         }
     }
     else {
-        const selected = getWorkerPersistenceConnectionName();
+        const selected = getWorkerPersistenceConnectionName(options['connection']);
         const hasSelected = selected.length > 0;
         const connections = databaseConfig.connections;
         const configured = hasSelected ? connections[selected] : undefined;

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

@@ -1 +1 @@
-{"version":3,"file":"ProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAMrE,OAAO,oBAAoB,CAAC;AAC5B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,0BAA0B,CAAC;AAClC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,sBAAsB,CAAC;AAyD9B,eAAO,MAAM,YAAY;cACb,YAAY;EAyBtB,CAAC;AAEH,eAAe,YAAY,CAAC"}
+{"version":3,"file":"ProxyCommand.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/ProxyCommand.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAkB,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAMrE,OAAO,oBAAoB,CAAC;AAC5B,OAAO,oBAAoB,CAAC;AAC5B,OAAO,uBAAuB,CAAC;AAC/B,OAAO,0BAA0B,CAAC;AAClC,OAAO,uBAAuB,CAAC;AAC/B,OAAO,sBAAsB,CAAC;AA2D9B,eAAO,MAAM,YAAY;cACb,YAAY;EAyBtB,CAAC;AAEH,eAAe,YAAY,CAAC"}

package/src/cli/commands/ProxyCommand.js

@@ -10,6 +10,8 @@ import '../../proxy/postgres/register.js';
 import '../../proxy/redis/register.js';
 import '../../proxy/smtp/register.js';
 const PROXY_TARGET_MAP = Object.freeze({
+    d1: 'proxy:d1',
+    kv: 'proxy:kv',
     mysql: 'proxy:mysql',
     my: 'proxy:mysql',
     postgres: 'proxy:postgres',

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

@@ -1 +1 @@
-{"version":3,"file":"WorkerCommands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/WorkerCommands.ts"],"names":[],"mappings":"AACA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAgiBrD;;GAEG;AACH,eAAO,MAAM,cAAc;mCApYS,YAAY;qCA4CV,YAAY;oCAiDb,YAAY;uCAkFT,YAAY;mCA0FhB,YAAY;sCAgCT,YAAY;sCAgCZ,YAAY;CAmElD,CAAC"}
+{"version":3,"file":"WorkerCommands.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/WorkerCommands.ts"],"names":[],"mappings":"AACA;;;GAGG;AAGH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AA0lBrD;;GAEG;AACH,eAAO,MAAM,cAAc;mCAtaS,YAAY;qCA4CV,YAAY;oCAiDb,YAAY;uCAqHT,YAAY;mCAyFhB,YAAY;sCAgCT,YAAY;sCAgCZ,YAAY;CAmElD,CAAC"}

package/src/cli/commands/WorkerCommands.js

@@ -7,14 +7,26 @@ import { ErrorFactory } from '../../exceptions/ZintrustError.js';
 import { BaseCommand } from '../BaseCommand.js';
 import { Env } from '../../config/env.js';
 import { Logger } from '../../config/logger.js';
+import { WorkerProjectAutoImports } from '../../runtime/WorkerProjectAutoImports.js';
 import { loadWorkersModule as loadWorkersRuntimeModule } from '../../runtime/WorkersModule.js';
 // Lazy initialization to prevent temporal dead zone issues
 let WorkerFactory;
 let WorkerRegistry;
 let HealthMonitor;
 let ResourceMonitor;
+let workerProjectEntrypointAttempted = false;
+const ensureProjectWorkerEntrypointLoaded = async () => {
+    if (workerProjectEntrypointAttempted)
+        return;
+    workerProjectEntrypointAttempted = true;
+    const result = await WorkerProjectAutoImports.tryImportProjectWorkerEntrypoint();
+    if (!result.ok && result.reason === 'import-failed') {
+        Logger.warn(`Project worker entrypoint import failed: ${result.errorMessage ?? 'Unknown error'}`);
+    }
+};
 const loadWorkersModule = async () => {
     try {
+        await ensureProjectWorkerEntrypointLoaded();
         return (await loadWorkersRuntimeModule());
     }
     catch (error) {
@@ -232,6 +244,32 @@ const isRegisteredWorkerRunning = async (workerLike) => {
     const isPaused = typeof pausedFn === 'function' ? pausedFn() : false;
     return isRunning && !isPaused;
 };
+const resolveAutoStartWorkerNames = async (factory, workersModule) => {
+    const persistedRecords = await factory.listPersistedRecords();
+    const fileRecords = typeof factory.listFileBackedRecords === 'function'
+        ? await factory.listFileBackedRecords()
+        : [];
+    if (typeof workersModule.selectAutoStartNames === 'function') {
+        return workersModule.selectAutoStartNames(persistedRecords, fileRecords, Logger.warn);
+    }
+    const persistedNames = persistedRecords
+        .filter((record) => record.activeStatus !== false && record.autoStart === true)
+        .map((record) => record.name);
+    if (persistedNames.length > 0) {
+        return { names: persistedNames, source: 'persisted' };
+    }
+    const seen = new Set();
+    const fileNames = [];
+    for (const record of fileRecords) {
+        if (record.activeStatus === false || record.autoStart !== true)
+            continue;
+        if (seen.has(record.name))
+            continue;
+        seen.add(record.name);
+        fileNames.push(record.name);
+    }
+    return { names: fileNames, source: fileNames.length > 0 ? 'file' : 'none' };
+};
 /**
  * Worker Start All Command
  */
@@ -244,17 +282,19 @@ const createWorkerStartAllCommand = () => {
                 return;
             }
             const factory = await getWorkerFactory();
-            const records = await factory.listPersistedRecords();
-            const autoStartRecords = records.filter((record) => record.activeStatus !== false && record.autoStart === true);
-            const workers = autoStartRecords.map((record) => record.name);
+            const workersModule = await loadWorkersModule();
+            const { names: workers, source } = await resolveAutoStartWorkerNames(factory, workersModule);
             if (workers.length === 0) {
-                Logger.info('No auto-start eligible persisted workers found.');
+                Logger.info('No auto-start eligible persisted or file-backed workers found.');
                 return;
             }
-            const discoveredWorkers = await pollForPersistedWorkers(factory);
-            const eligibleWorkers = workers.filter((name) => discoveredWorkers.includes(name));
+            let eligibleWorkers = workers;
+            if (source === 'persisted') {
+                const discoveredWorkers = await pollForPersistedWorkers(factory);
+                eligibleWorkers = workers.filter((name) => discoveredWorkers.includes(name));
+            }
             if (eligibleWorkers.length === 0) {
-                Logger.info('No auto-start eligible workers are currently persisted.');
+                Logger.info('No auto-start eligible workers are currently available.');
                 return;
             }
             const results = await Promise.all(eligibleWorkers.map(async (name) => {

package/src/cli/commands/index.d.ts

@@ -6,8 +6,10 @@ export { BroadcastWorkCommand } from '../commands/BroadcastWorkCommand';
 export { ConfigCommand } from '../commands/ConfigCommand';
 export { ContainerWorkersCommand } from '../commands/ContainerWorkersCommand';
 export { AddMigrationCommand, CreateCommand, CreateMigrationCommand, } from '../commands/CreateCommand';
+export { D1ProxyCommand } from '../commands/D1ProxyCommand';
 export { DebugCommand } from '../commands/DebugCommand';
 export { JwtDevCommand } from '../commands/JwtDevCommand';
+export { KvProxyCommand } from '../commands/KvProxyCommand';
 export { LogsCleanupCommand } from '../commands/LogsCleanupCommand';
 export { MakeMailTemplateCommand } from '../commands/MakeMailTemplateCommand';
 export { MakeNotificationTemplateCommand } from '../commands/MakeNotificationTemplateCommand';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,+BAA+B,EAAE,MAAM,+CAA+C,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/cli/commands/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EACL,mBAAmB,EACnB,aAAa,EACb,sBAAsB,GACvB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,kCAAkC,CAAC;AACtE,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,+BAA+B,EAAE,MAAM,+CAA+C,CAAC;AAChG,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AAChF,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,sCAAsC,CAAC;AAC9E,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,MAAM,gCAAgC,CAAC"}

package/src/cli/commands/index.js

@@ -6,8 +6,10 @@ export { BroadcastWorkCommand } from '../commands/BroadcastWorkCommand.js';
 export { ConfigCommand } from '../commands/ConfigCommand.js';
 export { ContainerWorkersCommand } from '../commands/ContainerWorkersCommand.js';
 export { AddMigrationCommand, CreateCommand, CreateMigrationCommand, } from '../commands/CreateCommand.js';
+export { D1ProxyCommand } from '../commands/D1ProxyCommand.js';
 export { DebugCommand } from '../commands/DebugCommand.js';
 export { JwtDevCommand } from '../commands/JwtDevCommand.js';
+export { KvProxyCommand } from '../commands/KvProxyCommand.js';
 export { LogsCleanupCommand } from '../commands/LogsCleanupCommand.js';
 export { MakeMailTemplateCommand } from '../commands/MakeMailTemplateCommand.js';
 export { MakeNotificationTemplateCommand } from '../commands/MakeNotificationTemplateCommand.js';

package/src/cli/index.d.ts

@@ -8,7 +8,9 @@ export { EXIT_CODES, ErrorHandler } from './ErrorHandler';
 export { PromptHelper, type PromptOptions } from './PromptHelper';
 export { AddCommand } from './commands/AddCommand';
 export { ConfigCommand } from './commands/ConfigCommand';
+export { D1ProxyCommand } from './commands/D1ProxyCommand';
 export { DebugCommand } from './commands/DebugCommand';
+export { KvProxyCommand } from './commands/KvProxyCommand';
 export { MigrateCommand } from './commands/MigrateCommand';
 export { MySqlProxyCommand } from './commands/MySqlProxyCommand';
 export { NewCommand } from './commands/NewCommand';

package/src/cli/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,GAAG,EAAE,MAAM,UAAU,CAAC;AAC/B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAC9D,OAAO,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC"}

package/src/cli/index.js

@@ -9,7 +9,9 @@ export { PromptHelper } from './PromptHelper.js';
 // Export commands
 export { AddCommand } from './commands/AddCommand.js';
 export { ConfigCommand } from './commands/ConfigCommand.js';
+export { D1ProxyCommand } from './commands/D1ProxyCommand.js';
 export { DebugCommand } from './commands/DebugCommand.js';
+export { KvProxyCommand } from './commands/KvProxyCommand.js';
 export { MigrateCommand } from './commands/MigrateCommand.js';
 export { MySqlProxyCommand } from './commands/MySqlProxyCommand.js';
 export { NewCommand } from './commands/NewCommand.js';

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

@@ -1 +1 @@
-{"version":3,"file":"GovernanceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/GovernanceScaffolder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAmBH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AA8RH,eAAO,MAAM,oBAAoB;0BAEhB,MAAM,YACV,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC;EA+DpC,CAAC;AAEH,eAAe,oBAAoB,CAAC"}
+{"version":3,"file":"GovernanceScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/GovernanceScaffolder.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAoBH,MAAM,MAAM,yBAAyB,GAAG,QAAQ,CAAC;IAC/C,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,QAAQ,CAAC;IAC9C,OAAO,EAAE,OAAO,CAAC;IACjB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC,CAAC;AAgTH,eAAO,MAAM,oBAAoB;0BAEhB,MAAM,YACV,yBAAyB,GACjC,OAAO,CAAC,wBAAwB,CAAC;EA+DpC,CAAC;AAEH,eAAe,oBAAoB,CAAC"}

package/src/cli/scaffolding/GovernanceScaffolder.js

@@ -6,6 +6,7 @@
  * - Architecture tests (Vitest)
  */
 import { FileGenerator } from '../scaffolding/FileGenerator.js';
+import { VersionChecker } from '../services/VersionChecker.js';
 import { SpawnUtil } from '../utils/spawn.js';
 import { resolvePackageManager } from '../../common/index.js';
 import { Logger } from '../../config/logger.js';
@@ -49,12 +50,28 @@ const ensureDevDependency = (devDependencies, name, version) => {
         devDependencies[name] = version;
     }
 };
+const toCompatibleGovernanceVersion = (value) => {
+    const match = /(\d+)\.(\d+)\.(\d+)/.exec(value);
+    if (match === null)
+        return undefined;
+    const [, major, minor] = match;
+    return `^${major}.${minor}.0`;
+};
 const inferGovernanceVersion = (pkg) => {
     const deps = getStringRecord(pkg.dependencies);
     const core = deps?.['@zintrust/core'];
-    if (typeof core === 'string' && core.trim() !== '')
-        return core;
-    return '^0.1.0';
+    if (typeof core === 'string' && core.trim() !== '') {
+        const compatibleFromCore = toCompatibleGovernanceVersion(core);
+        if (compatibleFromCore !== undefined)
+            return compatibleFromCore;
+    }
+    const currentVersion = VersionChecker.getCurrentVersion().trim();
+    if (currentVersion !== '' && currentVersion !== '0.0.0') {
+        const compatibleFromCli = toCompatibleGovernanceVersion(currentVersion);
+        if (compatibleFromCli !== undefined)
+            return compatibleFromCli;
+    }
+    return '^0.4.0';
 };
 const writeEslintConfig = (projectRoot) => {
     const eslintConfigPath = path.join(projectRoot, 'eslint.config.mjs');

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

@@ -1 +1 @@
-{"version":3,"file":"ProjectScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ProjectScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACpE,cAAc,IAAI,MAAM,CAAC;IACzB,sBAAsB,IAAI,OAAO,CAAC;IAClC,iBAAiB,IAAI,MAAM,CAAC;IAC5B,WAAW,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;IACtD,gBAAgB,IAAI,OAAO,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3E;AAodD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAsBrE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAsBA;AA6ID;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,GAAE,MAAsB,GAAG,kBAAkB,CAsB/F;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC"}
+{"version":3,"file":"ProjectScaffolder.d.ts","sourceRoot":"","sources":["../../../../src/cli/scaffolding/ProjectScaffolder.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,MAAM,WAAW,sBAAsB;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,MAAM,cAAc,GAAG,sBAAsB,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,KAAK,CAAC;CACf;AAED,MAAM,WAAW,kBAAkB;IACjC,cAAc,CAAC,OAAO,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACtD,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,eAAe,CAAC,YAAY,CAAC,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAAC;IACpE,cAAc,IAAI,MAAM,CAAC;IACzB,sBAAsB,IAAI,OAAO,CAAC;IAClC,iBAAiB,IAAI,MAAM,CAAC;IAC5B,WAAW,CAAC,OAAO,CAAC,EAAE,sBAAsB,GAAG,MAAM,CAAC;IACtD,gBAAgB,IAAI,OAAO,CAAC;IAC5B,aAAa,IAAI,OAAO,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC3E;AA8dD,wBAAgB,qBAAqB,IAAI,MAAM,EAAE,CAEhD;AAED,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,eAAe,GAAG,SAAS,CAsBrE;AAED,wBAAgB,eAAe,CAAC,OAAO,EAAE,sBAAsB,GAAG;IAChE,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,MAAM,EAAE,CAAC;CAClB,CAsBA;AA8ID;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,GAAE,MAAsB,GAAG,kBAAkB,CAsB/F;AAED,wBAAsB,eAAe,CACnC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,sBAAsB,GAC9B,OAAO,CAAC,qBAAqB,CAAC,CAEhC;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;;;;EAM5B,CAAC"}

package/src/cli/scaffolding/ProjectScaffolder.js

@@ -20,6 +20,14 @@ const loadCoreVersion = () => {
         return '0.0.0';
     }
 };
+const toCompatibleGovernanceVersion = (version) => {
+    const match = /(\d+)\.(\d+)\.(\d+)/.exec(version);
+    if (match !== null) {
+        const [, major, minor] = match;
+        return `^${major}.${minor}.0`;
+    }
+    return '^0.4.0';
+};
 const createDirectories = (projectPath, directories) => {
     let count = 0;
     if (!fs.existsSync(projectPath)) {
@@ -239,11 +247,11 @@ const readTemplateJson = (templateJsonPath) => {
     }
 };
 const resolveTemplateMetadata = (templateName, meta, fallback) => {
-    const name = typeof meta.name === 'string' ? meta.name : fallback?.name ?? templateName;
-    const description = typeof meta.description === 'string' ? meta.description : fallback?.description ?? '';
+    const name = typeof meta.name === 'string' ? meta.name : (fallback?.name ?? templateName);
+    const description = typeof meta.description === 'string' ? meta.description : (fallback?.description ?? '');
     const directories = Array.isArray(meta.directories)
         ? coerceStringArray(meta.directories)
-        : fallback?.directories ?? [];
+        : (fallback?.directories ?? []);
     return { name, description, directories };
 };
 const loadTemplateFiles = (templateDir) => {
@@ -451,6 +459,8 @@ const prepareContext = (state, options) => {
         .replaceAll(/[-:T.Z]/g, '')
         .slice(0, 14);
     state.variables = {
+        coreVersion: loadCoreVersion(),
+        governanceVersion: toCompatibleGovernanceVersion(loadCoreVersion()),
         projectName: options.name,
         projectSlug: options.name,
         author: options.author ?? 'Your Name',
@@ -459,7 +469,6 @@ const prepareContext = (state, options) => {
         database: options.database ?? 'sqlite',
         template: state.templateName,
         migrationTimestamp,
-        coreVersion: loadCoreVersion(),
     };
 };
 const createDirectoriesForState = (state) => {