@ai-partner-x/aiko-boot-cli 0.1.4 → 0.1.5

package/dist/usecases/env.usecase.js

@@ -0,0 +1,284 @@
+import path from 'path';
+import fs from 'fs-extra';
+import { loadProjectConfig } from '../core/project-config.js';
+function modeToNodeEnv(mode) {
+    return mode === 'dev' ? 'development' : 'production';
+}
+function setOrReplaceKey(text, key, value) {
+    const re = new RegExp(`^${key}=.*$`, 'm');
+    if (re.test(text))
+        return text.replace(re, `${key}=${value}`);
+    const prefix = text.endsWith('\n') ? '' : '\n';
+    return `${text}${prefix}${key}=${value}\n`;
+}
+function patchFrontendEnv(text, mode) {
+    let patched = setOrReplaceKey(text, 'APP_ENV', mode);
+    // Vite 不支持通过前端 .env 覆盖 NODE_ENV；移除避免警告/行为不一致
+    patched = patched.replace(/^NODE_ENV=.*$/m, '');
+    return patched;
+}
+function patchApiEnv(text, mode) {
+    const nodeEnv = modeToNodeEnv(mode);
+    let patched = setOrReplaceKey(text, 'APP_ENV', mode);
+    patched = setOrReplaceKey(patched, 'NODE_ENV', nodeEnv);
+    return patched;
+}
+function buildPnpmRootDevScript(args) {
+    const filters = args.pkgs.map((p) => `--filter "${p}"`).join(' ');
+    return `pnpm -r --parallel ${filters} dev:${args.mode}`;
+}
+function buildApiDevScript(mode) {
+    return `cross-env APP_ENV=${mode} NODE_ENV=${modeToNodeEnv(mode)} concurrently -n codegen,server -c blue,green "pnpm codegen:watch" "node --import @swc-node/register/esm-register --watch src/server.ts"`;
+}
+function buildApiStartScript(mode) {
+    return `cross-env APP_ENV=${mode} NODE_ENV=${modeToNodeEnv(mode)} node dist/server.js`;
+}
+function buildAdminDevScript(mode) {
+    return `vite --mode ${mode}`;
+}
+function buildAdminBuildScript(mode) {
+    return `tsc && vite build --mode ${mode}`;
+}
+function buildMobileDevScript(mode) {
+    return `vite --mode ${mode} --port 3002`;
+}
+function buildMobileBuildScript(mode) {
+    return `tsc --noEmit && vite build --mode ${mode}`;
+}
+export function createEnvUseCase(deps) {
+    const { logger } = deps;
+    function extractModesFromDirFiles(files) {
+        const modes = [];
+        for (const file of files) {
+            const m = file.match(/^\.env\.(.+)$/);
+            if (!m)
+                continue;
+            const suffix = m[1];
+            // .env.example 不符合这个正则，但我们也防御一下
+            if (!suffix || suffix === 'example')
+                continue;
+            modes.push(suffix);
+        }
+        return modes;
+    }
+    async function getTargets(rootDir) {
+        const config = await loadProjectConfig(rootDir);
+        if (!config) {
+            throw new Error('未找到 .aiko-boot.json，当前目录似乎不是脚手架根目录，请在 create 生成的根目录下执行。');
+        }
+        const scope = config.scope ?? 'scaffold';
+        const targets = [];
+        for (const api of config.apis ?? []) {
+            targets.push({ kind: 'api', name: api.name, relDir: api.path });
+        }
+        for (const app of config.apps ?? []) {
+            targets.push({
+                kind: 'app',
+                type: app.type,
+                name: app.name,
+                relDir: app.path,
+            });
+        }
+        return { config, scope, targets };
+    }
+    async function list(args) {
+        const { scope, targets } = await getTargets(args.rootDir);
+        void scope;
+        const modes = new Set();
+        const existence = {};
+        const targetKeys = targets.map((t) => `${t.kind}:${t.name}`);
+        for (const target of targets) {
+            const dir = path.join(args.rootDir, target.relDir);
+            const files = (await fs.pathExists(dir)) ? await fs.readdir(dir) : [];
+            const envModes = extractModesFromDirFiles(files);
+            for (const m of envModes)
+                modes.add(m);
+        }
+        const sorted = Array.from(modes).sort();
+        for (const m of sorted) {
+            existence[m] = {};
+            for (const key of targetKeys)
+                existence[m][key] = false;
+            for (const target of targets) {
+                const dir = path.join(args.rootDir, target.relDir);
+                const file = path.join(dir, `.env.${m}`);
+                const key = `${target.kind}:${target.name}`;
+                if (await fs.pathExists(file))
+                    existence[m][key] = true;
+            }
+        }
+        logger.info('Available environments:');
+        for (const m of sorted) {
+            const parts = targets.map((t) => {
+                const key = `${t.kind}:${t.name}`;
+                return `${key}=${existence[m][key] ? 'yes' : 'no'}`;
+            });
+            logger.info(`- ${m}: ${parts.join(', ')}`);
+        }
+        if (sorted.length === 0) {
+            logger.info('- (none found)');
+        }
+        return sorted;
+    }
+    async function add(args) {
+        const { scope, targets } = await getTargets(args.rootDir);
+        const mode = args.mode;
+        const injectScripts = args.injectScripts ?? true;
+        const onExisting = args.onExisting ?? 'error';
+        const rootPkgPath = path.join(args.rootDir, 'package.json');
+        if (!(await fs.pathExists(rootPkgPath))) {
+            throw new Error(`未找到根 package.json：${rootPkgPath}`);
+        }
+        const rootPkg = await fs.readJson(rootPkgPath);
+        rootPkg.scripts = rootPkg.scripts ?? {};
+        const pkgsToRun = [];
+        for (const target of targets) {
+            const packageName = `@${scope}/${target.name}`;
+            if (target.kind === 'api')
+                pkgsToRun.push(packageName);
+            if (target.kind === 'app' && (target.type === 'admin' || target.type === 'mobile')) {
+                pkgsToRun.push(packageName);
+            }
+        }
+        // 1) env 文件生成
+        for (const target of targets) {
+            const dir = path.join(args.rootDir, target.relDir);
+            const templatePath = path.join(dir, '.env.example');
+            const outPath = path.join(dir, `.env.${mode}`);
+            if ((await fs.pathExists(outPath)) && !args.force) {
+                if (onExisting === 'skip') {
+                    logger.info(`ℹ️ Skip existing env for ${target.kind}:${target.name} (${mode})`);
+                    continue;
+                }
+                throw new Error(`目标 env 已存在：${outPath}（可用 --force 覆盖）`);
+            }
+            if (args.dryRun) {
+                logger.info(`[dry-run] Generate: ${path.relative(args.rootDir, outPath)}`);
+                continue;
+            }
+            if (!(await fs.pathExists(templatePath))) {
+                throw new Error(`缺少 .env.example：${templatePath}（请先在该应用/服务目录补齐环境模板文件）`);
+            }
+            let text = await fs.readFile(templatePath, 'utf8');
+            text = target.kind === 'api' ? patchApiEnv(text, mode) : patchFrontendEnv(text, mode);
+            await fs.writeFile(outPath, text, 'utf8');
+            logger.info(`✅ Generated: ${path.relative(args.rootDir, outPath)}`);
+        }
+        // 2) 脚本注入：根目录 dev:<mode>（不包含 dev 这个模式）
+        if (injectScripts) {
+            if (mode !== 'dev' && pkgsToRun.length > 0) {
+                rootPkg.scripts[`dev:${mode}`] = buildPnpmRootDevScript({
+                    pkgs: pkgsToRun,
+                    mode,
+                });
+            }
+            if (!args.dryRun) {
+                await fs.writeJson(rootPkgPath, rootPkg, { spaces: 2 });
+            }
+            // 3) 脚本注入：各包 dev:<mode> / build:<mode> / start:<mode>
+            for (const target of targets) {
+                if (target.kind === 'api') {
+                    const pkgPath = path.join(args.rootDir, target.relDir, 'package.json');
+                    if (!(await fs.pathExists(pkgPath)))
+                        continue;
+                    const pkg = await fs.readJson(pkgPath);
+                    pkg.scripts = pkg.scripts ?? {};
+                    pkg.scripts[`dev:${mode}`] = buildApiDevScript(mode);
+                    pkg.scripts[`start:${mode}`] = buildApiStartScript(mode);
+                    if (!args.dryRun) {
+                        await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+                    }
+                }
+                else if (target.type === 'admin') {
+                    const pkgPath = path.join(args.rootDir, target.relDir, 'package.json');
+                    if (!(await fs.pathExists(pkgPath)))
+                        continue;
+                    const pkg = await fs.readJson(pkgPath);
+                    pkg.scripts = pkg.scripts ?? {};
+                    pkg.scripts[`dev:${mode}`] = buildAdminDevScript(mode);
+                    pkg.scripts[`build:${mode}`] = buildAdminBuildScript(mode);
+                    if (!args.dryRun) {
+                        await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+                    }
+                }
+                else if (target.type === 'mobile') {
+                    const pkgPath = path.join(args.rootDir, target.relDir, 'package.json');
+                    if (!(await fs.pathExists(pkgPath)))
+                        continue;
+                    const pkg = await fs.readJson(pkgPath);
+                    pkg.scripts = pkg.scripts ?? {};
+                    pkg.scripts[`dev:${mode}`] = buildMobileDevScript(mode);
+                    pkg.scripts[`build:${mode}`] = buildMobileBuildScript(mode);
+                    if (!args.dryRun) {
+                        await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+                    }
+                }
+                else {
+                    logger.warn(`跳过未知应用类型（无法自动注入脚本）：${target.kind}:${target.name} type=${target.type}`);
+                }
+            }
+        }
+    }
+    async function remove(args) {
+        const { scope, targets } = await getTargets(args.rootDir);
+        const mode = args.mode;
+        const rootPkgPath = path.join(args.rootDir, 'package.json');
+        if (!(await fs.pathExists(rootPkgPath))) {
+            throw new Error(`未找到根 package.json：${rootPkgPath}`);
+        }
+        const rootPkg = await fs.readJson(rootPkgPath);
+        rootPkg.scripts = rootPkg.scripts ?? {};
+        if (mode !== 'dev' && rootPkg.scripts[`dev:${mode}`]) {
+            delete rootPkg.scripts[`dev:${mode}`];
+        }
+        if (!args.dryRun) {
+            await fs.writeJson(rootPkgPath, rootPkg, { spaces: 2 });
+        }
+        for (const target of targets) {
+            const dir = path.join(args.rootDir, target.relDir);
+            const envPath = path.join(dir, `.env.${mode}`);
+            if (!(await fs.pathExists(envPath))) {
+                if (!args.force) {
+                    throw new Error(`目标 env 不存在：${path.relative(args.rootDir, envPath)}`);
+                }
+            }
+            else if (args.dryRun) {
+                logger.info(`[dry-run] Remove: ${path.relative(args.rootDir, envPath)}`);
+            }
+            else {
+                await fs.remove(envPath);
+                logger.info(`🗑️ Removed: ${path.relative(args.rootDir, envPath)}`);
+            }
+            const pkgPath = path.join(dir, 'package.json');
+            if (!(await fs.pathExists(pkgPath)))
+                continue;
+            const pkg = await fs.readJson(pkgPath);
+            pkg.scripts = pkg.scripts ?? {};
+            if (target.kind === 'api') {
+                // api 的默认 dev 通常依赖 dev:dev（如 dev: "pnpm dev:dev"）
+                // 因此 mode=dev 时不要删除 dev:dev/start:dev 脚本，避免破坏 pnpm dev。
+                if (mode !== 'dev') {
+                    delete pkg.scripts[`dev:${mode}`];
+                    delete pkg.scripts[`start:${mode}`];
+                }
+            }
+            else if (target.type === 'admin') {
+                delete pkg.scripts[`dev:${mode}`];
+                delete pkg.scripts[`build:${mode}`];
+            }
+            else if (target.type === 'mobile') {
+                delete pkg.scripts[`dev:${mode}`];
+                delete pkg.scripts[`build:${mode}`];
+            }
+            if (!args.dryRun) {
+                await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+            }
+        }
+        void scope;
+    }
+    return {
+        list,
+        add,
+        remove,
+    };
+}

package/dist/usecases/init-scaffold.usecase.d.ts

@@ -3,11 +3,10 @@ import type { Prompter } from '../core/prompts.js';
 export type InitScaffoldInput = {
     targetDir?: string;
     name?: string;
+    withAdminSuite: boolean;
+    db?: string;
+    features?: string;
     empty: boolean;
-    withAdmin: boolean;
-    withMobile: boolean;
-    withApi: boolean;
-    templateDir?: string;
     dryRun: boolean;
 };
 export type InitScaffoldDeps = {

package/dist/usecases/init-scaffold.usecase.js

@@ -1,13 +1,9 @@
 import path from 'path';
-import { fileURLToPath } from 'url';
 import fs from 'fs-extra';
 import { saveProjectConfig, } from '../core/project-config.js';
 import { syncRootPackageJson } from '../core/workspace.js';
 import { createAddApiUseCase } from './add-api.usecase.js';
 import { createAddAppUseCase } from './add-app.usecase.js';
-// 在 ESM 环境中模拟 __dirname，兼容打包到 dist 后的运行时
-const __filename = fileURLToPath(import.meta.url);
-const __dirname = path.dirname(__filename);
 export function createInitUseCase(deps) {
     const { logger, prompter } = deps;
     async function resolveInput(input) {
@@ -28,31 +24,25 @@ export function createInitUseCase(deps) {
         }
         const resolvedName = name;
         const resolvedTargetDir = targetDir;
-        // 默认使用包内置模板：templates/scaffold-default
-        // 这样发布到 npm 后也可以直接使用，而无需依赖仓库根目录的 ./scaffold。
-        const defaultTemplateDir = path.resolve(__dirname, '../../templates/scaffold-default');
-        const templateDir = input.templateDir ?? defaultTemplateDir;
         return {
             targetDir: resolvedTargetDir,
             name: resolvedName,
-            templateDir,
             options: {
+                withAdminSuite: input.withAdminSuite,
+                db: input.db,
+                features: input.features,
                 empty: input.empty,
-                withAdmin: input.withAdmin,
-                withMobile: input.withMobile,
-                withApi: input.withApi,
                 dryRun: input.dryRun,
             },
         };
     }
     async function execute(input) {
-        const { targetDir, name, templateDir, options } = await resolveInput(input);
+        const { targetDir, name, options } = await resolveInput(input);
         if (options.dryRun) {
             logger.info('[dry-run] 将会创建脚手架：');
             logger.info(`  name: ${name}`);
             logger.info(`  targetDir: ${targetDir}`);
-            logger.info(`  templateDir: ${templateDir}`);
-            logger.info(`  empty: ${options.empty}, withAdmin: ${options.withAdmin}, withMobile: ${options.withMobile}, withApi: ${options.withApi}`);
+            logger.info(`  empty: ${options.empty}, withAdminSuite: ${options.withAdminSuite}, db: ${options.db ?? '(default)'}, features: ${options.features ?? '(none)'}`);
             return;
         }
         logger.info(`创建 aiko-boot 脚手架到：${targetDir}`);
@@ -86,42 +76,39 @@ export function createInitUseCase(deps) {
             apis: [],
         };
         await saveProjectConfig(targetDir, config);
-        // 步骤 3: 如果指定了 --with-api/--with-admin/--with-mobile，复用 add-api/add-app 的逻辑
-        if (!options.empty) {
+        if (options.empty && options.withAdminSuite) {
+            throw new Error('--empty 和 --with-admin-suite 不能同时使用。');
+        }
+        // 步骤 3: with-admin-suite 时复用 add-api/add-app 逻辑，自动创建 admin+mobile+system(api)
+        if (options.withAdminSuite) {
             const addApiUseCase = createAddApiUseCase({ logger, prompter });
             const addAppUseCase = createAddAppUseCase({ logger, prompter });
-            // 默认模板目录：使用内置的 scaffold-default（如果用户没指定）
-            const defaultTemplateRoot = templateDir;
-            if (options.withApi) {
-                logger.info('正在添加 API 服务端...');
-                await addApiUseCase.execute({
-                    name: 'api',
-                    db: 'sqlite',
-                    rootDir: targetDir,
-                    templateDir: undefined, // 使用 add-api 的默认内置模板 api-base
-                    dryRun: false,
-                });
-            }
-            if (options.withAdmin) {
-                logger.info('正在添加 Admin 应用...');
-                await addAppUseCase.execute({
-                    name: 'admin',
-                    type: 'admin',
-                    rootDir: targetDir,
-                    templateDir: defaultTemplateRoot, // 从 scaffold-default/packages/admin 复制
-                    dryRun: false,
-                });
-            }
-            if (options.withMobile) {
-                logger.info('正在添加 Mobile 应用...');
-                await addAppUseCase.execute({
-                    name: 'mobile',
-                    type: 'mobile',
-                    rootDir: targetDir,
-                    templateDir: defaultTemplateRoot, // 从 scaffold-default/packages/mobile 复制
-                    dryRun: false,
-                });
-            }
+            logger.info('正在添加 System API 服务端...');
+            const shouldPromptApiOptions = options.db === undefined || options.features === undefined;
+            await addApiUseCase.execute({
+                name: 'system',
+                preset: 'system',
+                db: options.db,
+                features: options.features,
+                yes: false,
+                interactive: shouldPromptApiOptions,
+                rootDir: targetDir,
+                dryRun: false,
+            });
+            logger.info('正在添加 Admin 应用...');
+            await addAppUseCase.execute({
+                name: 'admin',
+                type: 'admin',
+                rootDir: targetDir,
+                dryRun: false,
+            });
+            logger.info('正在添加 Mobile 应用...');
+            await addAppUseCase.execute({
+                name: 'mobile',
+                type: 'mobile',
+                rootDir: targetDir,
+                dryRun: false,
+            });
         }
         // 最后统一同步根 package.json（scripts / pnpm.onlyBuiltDependencies 等）
         await syncRootPackageJson(targetDir);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-partner-x/aiko-boot-cli",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "CLI to create aiko-boot scaffold project (monorepo with api, admin, mobile, shared)",
   "type": "module",
   "main": "./dist/index.js",
@@ -19,6 +19,7 @@
     "templates"
   ],
   "dependencies": {
+    "@inquirer/prompts": "^8.3.2",
     "commander": "^12.1.0",
     "fs-extra": "^11.2.0"
   },
@@ -37,7 +38,11 @@
   "scripts": {
     "build": "tsc",
     "dev": "tsc --watch",
-    "sync:templates:scaffold-default": "node ./scripts/sync-scaffold-default.mjs",
-    "sync:templates:scaffold-default:dry": "node ./scripts/sync-scaffold-default.mjs --dry-run"
+    "sync:templates:api-system": "node ./scripts/sync-api-system.mjs",
+    "sync:templates:api-system:dry": "node ./scripts/sync-api-system.mjs --dry-run",
+    "sync:templates:api-clean": "node ./scripts/sync-api-clean.mjs",
+    "sync:templates:api-clean:dry": "node ./scripts/sync-api-clean.mjs --dry-run",
+    "sync:templates:apps": "node ./scripts/sync-app-templates.mjs",
+    "sync:templates:apps:dry": "node ./scripts/sync-app-templates.mjs --dry-run"
   }
 }

package/templates/api-clean/.env.example

@@ -0,0 +1,3 @@
+NODE_ENV=production
+APP_ENV=prod
+PORT=3001

package/templates/api-clean/app.config.ts

@@ -0,0 +1,19 @@
+import type { AppConfig } from '@ai-partner-x/aiko-boot';
+
+export default {
+  server: {
+    port: Number(process.env.PORT) || 3001,
+    servlet: {
+      contextPath: '/api',
+    },
+    shutdown: 'graceful',
+  },
+  database: {
+    type: 'sqlite',
+    filename: './data/app.db',
+  },
+  validation: {
+    enabled: true,
+    failFast: false,
+  },
+} satisfies AppConfig;

package/templates/{scaffold-default/packages/api → api-clean}/examples/security/README.md

@@ -247,7 +247,7 @@ export class UserController {
 
 ## 更多信息
 
-- [Aiko Boot 官方文档](https://github.com/ai-partner-x/aiko-boot)
+- [Aiko Boot 官方文档](../../../../../docs/)
 - [项目分析报告](../../../../../项目分析报告.md)
 - [Security Starter README](../../../../../packages/aiko-boot-starter-security/README.md)
 
@@ -660,5 +660,5 @@ server {
 
 - [项目结构说明](complete/PROJECT_STRUCTURE.md)
 - [测试报告](complete/tests/TEST_REPORT.md)
-- [Aiko Boot 官方文档](https://github.com/ai-partner-x/aiko-boot)
+- [Aiko Boot 官方文档](../../../../../docs/)
 - [Security Starter README](../../../../../packages/aiko-boot-starter-security/README.md)

package/templates/{scaffold-default/packages/api → api-clean}/examples/security/complete/README.md

@@ -842,6 +842,6 @@ export class HealthController {
 
 ## 更多信息
 
-- [Aiko Boot 官方文档](https://github.com/ai-partner-x/aiko-boot)
+- [Aiko Boot 官方文档](../../../../../docs/)
 - [项目分析报告](../../../../../项目分析报告.md)
 - [Security Starter README](../../../../../packages/aiko-boot-starter-security/README.md)

package/templates/{scaffold-default/packages/api → api-clean}/package.json

@@ -10,7 +10,7 @@
     }
   },
   "scripts": {
-    "dev": "concurrently -n codegen,server -c blue,green \"pnpm codegen:watch\" \"node --import @swc-node/register/esm-register --watch src/server.ts\"",
+    "dev": "node --import @swc-node/register/esm-register --watch src/server.ts",
     "dev:server": "node --import @swc-node/register/esm-register --watch src/server.ts",
     "codegen:watch": "node scripts/codegen.cjs --watch",
     "init-db": "node --import @swc-node/register/esm-register src/scripts/init-db.ts",
@@ -23,23 +23,14 @@
     "@ai-partner-x/aiko-boot": "workspace:*",
     "@ai-partner-x/aiko-boot-codegen": "workspace:*",
     "@ai-partner-x/aiko-boot-starter-orm": "workspace:*",
-    "@ai-partner-x/aiko-boot-starter-cache": "workspace:*",
     "@ai-partner-x/aiko-boot-starter-validation": "workspace:*",
     "@ai-partner-x/aiko-boot-starter-web": "workspace:*",
-    "@ai-partner-x/aiko-boot-starter-security": "workspace:*",
-    "@ai-partner-x/aiko-boot-starter-storage": "workspace:*",
-    "@ai-partner-x/aiko-boot-starter-mq": "workspace:*",
-    "@ai-partner-x/aiko-boot-starter-log": "workspace:*",
-    "bcryptjs": "^2.4.3",
-    "jsonwebtoken": "^9.0.2",
     "better-sqlite3": "^12.6.2",
-    "ioredis": "^5.4.2",
     "cors": "^2.8.5",
-    "date-fns": "^4.1.0",
     "express": "^4.18.0",
     "axios": "^1.6.0",
-    "multer": "^1.4.5-lts.1",
-    "reflect-metadata": "^0.2.1"
+    "reflect-metadata": "^0.2.1",
+    "dotenv": "^17.2.3"
   },
   "devDependencies": {
     "concurrently": "^9.2.1",
@@ -47,12 +38,9 @@
     "@swc-node/register": "^1.11.1",
     "@swc/core": "^1.15.18",
     "@ai-partner-x/eslint-plugin-aiko-boot": "workspace:*",
-    "@types/bcryptjs": "^2.4.6",
     "@types/better-sqlite3": "^7.6.13",
     "@types/cors": "^2.8.17",
     "@types/express": "^4.17.21",
-    "@types/jsonwebtoken": "^9.0.5",
-    "@types/multer": "^1.4.12",
     "@types/node": "^20.11.0",
     "@typescript-eslint/parser": "^6.21.0",
     "eslint": "^8.57.1",
@@ -60,4 +48,4 @@
     "tsx": "^4.7.0",
     "typescript": "^5.3.0"
   }
-}
+}

package/templates/api-clean/src/scripts/init-db.ts

@@ -0,0 +1,50 @@
+/**
+ * Initialize a clean database for api-clean template.
+ * Run: pnpm init-db
+ */
+import 'reflect-metadata';
+import { fileURLToPath } from 'url';
+import { dirname, join } from 'path';
+import { mkdirSync, existsSync } from 'fs';
+import { createKyselyDatabase, getKyselyDatabase } from '@ai-partner-x/aiko-boot-starter-orm';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const dbPath = join(__dirname, '../../data/app.db');
+const dir = dirname(dbPath);
+
+if (!existsSync(dir)) {
+  mkdirSync(dir, { recursive: true });
+}
+
+await createKyselyDatabase({
+  type: 'sqlite',
+  filename: dbPath,
+});
+
+const db = getKyselyDatabase();
+await db.schema
+  .createTable('app_health')
+  .ifNotExists()
+  .addColumn('id', 'integer', (col: any) => col.primaryKey().autoIncrement())
+  .addColumn('status', 'varchar(32)', (col: any) => col.notNull())
+  .addColumn('created_at', 'datetime', (col: any) => col.notNull())
+  .execute();
+
+const exists = await db
+  .selectFrom('app_health')
+  .selectAll()
+  .where('status', '=', 'ok')
+  .executeTakeFirst();
+
+if (!exists) {
+  await db
+    .insertInto('app_health')
+    .values({
+      status: 'ok',
+      created_at: new Date().toISOString(),
+    })
+    .execute();
+}
+
+console.log('Database initialized at:', dbPath);
+process.exit(0);

package/templates/{scaffold-default/packages/api → api-clean}/src/server.ts

@@ -1,30 +1,34 @@
 import 'reflect-metadata';
 import express from 'express';
 import { createApp } from '@ai-partner-x/aiko-boot';
-import { autoInit, getLogger } from '@ai-partner-x/aiko-boot-starter-log';
-
-autoInit();
-const logger = getLogger('server');
-
-logger.info('Starting API server...');
-
+import { config as loadDotenv } from 'dotenv';
+import { existsSync } from 'fs';
 import { join } from 'path';
 
 const projectDir = process.cwd();
+const appEnv = process.env.APP_ENV || 'dev';
+const envFile = join(projectDir, `.env.${appEnv}`);
+if (existsSync(envFile)) {
+  loadDotenv({ path: envFile, override: false });
+  console.log(`Loaded env file: ${envFile}`);
+} else {
+  console.warn(`Env file not found: ${envFile}`);
+}
+
 const srcDir = join(projectDir, 'src'); // Framework scans for controller/service/mapper relative to srcDir
 const configPath = projectDir; // configPath should point to the directory with node_modules
 const context = await createApp({ srcDir, configPath, verbose: true });
 
 if (!context) {
-  logger.warn('ApplicationContext not available');
+  console.warn('ApplicationContext not available');
 } else {
-  logger.info('Security enabled: ' + context.config.get('security.enabled', true));
+  console.log('Application context is ready');
 }
 
 const expressApp = await import('@ai-partner-x/aiko-boot-starter-web').then(m => m.getExpressApp());
 
 if (!expressApp) {
-  logger.error('Express app not available');
+  console.error('Express app not available');
   process.exit(1);
 }
 
@@ -33,6 +37,6 @@ expressApp.use(express.json());
 const port = context.config.get('server.port', 3001);
 
 expressApp.listen(port, () => {
-  logger.info('API Server started on port ' + port);
+  console.log('API Server started on port ' + port);
   console.log('📡 API: http://localhost:' + port + '/api');
 });