@zhin.js/scaffold-wizard 1.1.1 → 1.1.3

package/lib/database.js

@@ -1,4 +1,23 @@
 import inquirer from 'inquirer';
+import { DATABASE_DIALECT_DEFINITIONS, databaseChoiceLabel, getDatabaseDialectDefinition, validateDatabaseConfig, } from './database-definitions.js';
+function schemaDefault(dialect, ...path) {
+    let schema = getDatabaseDialectDefinition(dialect)?.schema;
+    for (const segment of path) {
+        const properties = schema?.properties;
+        schema = properties?.[segment];
+    }
+    return schema?.default;
+}
+function parseIntegerInput(input, minimum, maximum = Number.MAX_SAFE_INTEGER) {
+    const raw = String(input).trim();
+    if (!/^\d+$/u.test(raw))
+        return `请输入有效的整数 (${minimum}-${maximum})`;
+    const value = Number(raw);
+    if (!Number.isSafeInteger(value) || value < minimum || value > maximum) {
+        return `请输入有效的整数 (${minimum}-${maximum})`;
+    }
+    return value;
+}
 // 配置数据库选项
 export async function configureDatabaseOptions() {
     const { dialect } = await inquirer.prompt([
@@ -6,30 +25,41 @@ export async function configureDatabaseOptions() {
             type: 'select',
             name: 'dialect',
             message: '选择数据库类型:',
-            choices: [
-                { name: 'SQLite (推荐, 零配置)', value: 'sqlite' },
-                { name: 'MySQL', value: 'mysql' },
-                { name: 'PostgreSQL', value: 'pg' },
-                { name: 'MongoDB', value: 'mongodb' },
-                { name: 'Redis', value: 'redis' }
-            ],
+            choices: DATABASE_DIALECT_DEFINITIONS.map((definition) => ({
+                name: databaseChoiceLabel(definition),
+                value: definition.dialect,
+            })),
             default: 'sqlite'
         }
     ]);
+    let config;
     switch (dialect) {
         case 'sqlite':
-            return await configureSQLite();
+            config = await configureSQLite();
+            break;
         case 'mysql':
-            return await configureMySQL();
+            config = await configureMySQL();
+            break;
         case 'pg':
-            return await configurePostgreSQL();
+            config = await configurePostgreSQL();
+            break;
         case 'mongodb':
-            return await configureMongoDB();
+            config = await configureMongoDB();
+            break;
         case 'redis':
-            return await configureRedis();
+            config = await configureRedis();
+            break;
+        case 'memory':
+            config = { dialect: 'memory' };
+            break;
         default:
             throw new Error(`未支持的数据库类型: ${dialect}`);
     }
+    const issues = validateDatabaseConfig(config);
+    if (issues.length > 0) {
+        throw new TypeError(`数据库配置不符合 Schema：${issues.map((issue) => issue.message).join('；')}`);
+    }
+    return config;
 }
 // SQLite 配置
 async function configureSQLite() {
@@ -38,7 +68,7 @@ async function configureSQLite() {
             type: 'input',
             name: 'filename',
             message: 'SQLite 数据库文件路径:',
-            default: './data/bot.db',
+            default: schemaDefault('sqlite', 'filename'),
             validate: (input) => {
                 if (!input.trim())
                     return '文件路径不能为空';
@@ -54,7 +84,7 @@ async function configureSQLite() {
                 { name: 'DELETE (默认)', value: 'delete' },
                 { name: 'MEMORY (内存数据库)', value: 'memory' }
             ],
-            default: 'wal'
+            default: schemaDefault('sqlite', 'mode')
         }
     ]);
     return {
@@ -70,26 +100,23 @@ async function configureMySQL() {
             type: 'input',
             name: 'host',
             message: 'MySQL 主机地址:',
-            default: 'localhost'
+            default: schemaDefault('mysql', 'host')
         },
         {
             type: 'input',
             name: 'port',
             message: 'MySQL 端口:',
-            default: '3306',
+            default: String(schemaDefault('mysql', 'port')),
             validate: (input) => {
-                const port = parseInt(input);
-                if (isNaN(port) || port < 1 || port > 65535) {
-                    return '请输入有效的端口号 (1-65535)';
-                }
-                return true;
+                const value = parseIntegerInput(input, 1, 65535);
+                return typeof value === 'number' ? true : value;
             }
         },
         {
             type: 'input',
             name: 'user',
             message: 'MySQL 用户名:',
-            default: 'root'
+            default: schemaDefault('mysql', 'user')
         },
         {
             type: 'password',
@@ -100,7 +127,7 @@ async function configureMySQL() {
             type: 'input',
             name: 'database',
             message: 'MySQL 数据库名:',
-            default: 'zhin_bot',
+            default: schemaDefault('mysql', 'database'),
             validate: (input) => {
                 if (!input.trim())
                     return '数据库名不能为空';
@@ -111,7 +138,7 @@ async function configureMySQL() {
     return {
         dialect: 'mysql',
         host: config.host,
-        port: parseInt(config.port),
+        port: Number(config.port),
         user: config.user,
         password: config.password,
         database: config.database
@@ -124,26 +151,23 @@ async function configurePostgreSQL() {
             type: 'input',
             name: 'host',
             message: 'PostgreSQL 主机地址:',
-            default: 'localhost'
+            default: schemaDefault('pg', 'host')
         },
         {
             type: 'input',
             name: 'port',
             message: 'PostgreSQL 端口:',
-            default: '5432',
+            default: String(schemaDefault('pg', 'port')),
             validate: (input) => {
-                const port = parseInt(input);
-                if (isNaN(port) || port < 1 || port > 65535) {
-                    return '请输入有效的端口号 (1-65535)';
-                }
-                return true;
+                const value = parseIntegerInput(input, 1, 65535);
+                return typeof value === 'number' ? true : value;
             }
         },
         {
             type: 'input',
             name: 'user',
             message: 'PostgreSQL 用户名:',
-            default: 'postgres'
+            default: schemaDefault('pg', 'user')
         },
         {
             type: 'password',
@@ -154,7 +178,7 @@ async function configurePostgreSQL() {
             type: 'input',
             name: 'database',
             message: 'PostgreSQL 数据库名:',
-            default: 'zhin_bot',
+            default: schemaDefault('pg', 'database'),
             validate: (input) => {
                 if (!input.trim())
                     return '数据库名不能为空';
@@ -165,7 +189,7 @@ async function configurePostgreSQL() {
     return {
         dialect: 'pg',
         host: config.host,
-        port: parseInt(config.port),
+        port: Number(config.port),
         user: config.user,
         password: config.password,
         database: config.database
@@ -178,7 +202,7 @@ async function configureMongoDB() {
             type: 'input',
             name: 'url',
             message: 'MongoDB 连接字符串:',
-            default: 'mongodb://localhost:27017',
+            default: schemaDefault('mongodb', 'url'),
             validate: (input) => {
                 if (!input.trim())
                     return '连接字符串不能为空';
@@ -192,7 +216,7 @@ async function configureMongoDB() {
             type: 'input',
             name: 'dbName',
             message: 'MongoDB 数据库名:',
-            default: 'zhin_bot',
+            default: schemaDefault('mongodb', 'dbName'),
             validate: (input) => {
                 if (!input.trim())
                     return '数据库名不能为空';
@@ -213,19 +237,16 @@ async function configureRedis() {
             type: 'input',
             name: 'host',
             message: 'Redis 主机地址:',
-            default: 'localhost'
+            default: schemaDefault('redis', 'socket', 'host')
         },
         {
             type: 'input',
             name: 'port',
             message: 'Redis 端口:',
-            default: '6379',
+            default: String(schemaDefault('redis', 'socket', 'port')),
             validate: (input) => {
-                const port = parseInt(input);
-                if (isNaN(port) || port < 1 || port > 65535) {
-                    return '请输入有效的端口号 (1-65535)';
-                }
-                return true;
+                const value = parseIntegerInput(input, 1, 65535);
+                return typeof value === 'number' ? true : value;
             }
         },
         {
@@ -237,13 +258,10 @@ async function configureRedis() {
             type: 'input',
             name: 'db',
             message: 'Redis 数据库索引:',
-            default: '0',
+            default: String(schemaDefault('redis', 'database')),
             validate: (input) => {
-                const db = parseInt(input);
-                if (isNaN(db) || db < 0) {
-                    return '请输入有效的数据库索引 (>= 0)';
-                }
-                return true;
+                const value = parseIntegerInput(input, 0);
+                return typeof value === 'number' ? true : '请输入有效的数据库索引 (>= 0)';
             }
         }
     ]);
@@ -251,10 +269,10 @@ async function configureRedis() {
         dialect: 'redis',
         socket: {
             host: config.host,
-            port: parseInt(config.port)
+            port: Number(config.port)
         },
         password: config.password || undefined,
-        database: parseInt(config.db)
+        database: Number(config.db)
     };
 }
 //# sourceMappingURL=database.js.map

package/lib/database.js.map

@@ -1 +1 @@
-{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAGhC,UAAU;AACV,MAAM,CAAC,KAAK,UAAU,wBAAwB;IAC5C,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACxC;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,UAAU;YACnB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,kBAAkB,EAAE,KAAK,EAAE,QAAQ,EAAE;gBAC7C,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;gBACjC,EAAE,IAAI,EAAE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE;gBACnC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE;gBACrC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE;aAClC;YACD,OAAO,EAAE,QAAQ;SAClB;KACF,CAAC,CAAC;IAEH,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,QAAQ;YACX,OAAO,MAAM,eAAe,EAAE,CAAC;QACjC,KAAK,OAAO;YACV,OAAO,MAAM,cAAc,EAAE,CAAC;QAChC,KAAK,IAAI;YACP,OAAO,MAAM,mBAAmB,EAAE,CAAC;QACrC,KAAK,SAAS;YACZ,OAAO,MAAM,gBAAgB,EAAE,CAAC;QAClC,KAAK,OAAO;YACV,OAAO,MAAM,cAAc,EAAE,CAAC;QAChC;YACE,MAAM,IAAI,KAAK,CAAC,cAAc,OAAO,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,YAAY;AACZ,KAAK,UAAU,eAAe;IAC5B,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QAC/C;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,iBAAiB;YAC1B,OAAO,EAAE,eAAe;YACxB,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;oBAAE,OAAO,UAAU,CAAC;gBACrC,OAAO,IAAI,CAAC;YACd,CAAC;SACF;QACD;YACE,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,YAAY;YACrB,OAAO,EAAE;gBACP,EAAE,IAAI,EAAE,iBAAiB,EAAE,KAAK,EAAE,KAAK,EAAE;gBACzC,EAAE,IAAI,EAAE,aAAa,EAAE,KAAK,EAAE,QAAQ,EAAE;gBACxC,EAAE,IAAI,EAAE,gBAAgB,EAAE,KAAK,EAAE,QAAQ,EAAE;aAC5C;YACD,OAAO,EAAE,KAAK;SACf;KACF,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,QAAQ;QACjB,QAAQ;QACR,IAAI;KACL,CAAC;AACJ,CAAC;AAED,WAAW;AACX,KAAK,UAAU,cAAc;IAC3B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACnC;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,aAAa;YACtB,OAAO,EAAE,WAAW;SACrB;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,WAAW;YACpB,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC7B,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;oBAC5C,OAAO,qBAAqB,CAAC;gBAC/B,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;SACF;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,YAAY;YACrB,OAAO,EAAE,MAAM;SAChB;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,WAAW;SACrB;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,aAAa;YACtB,OAAO,EAAE,UAAU;YACnB,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;oBAAE,OAAO,UAAU,CAAC;gBACrC,OAAO,IAAI,CAAC;YACd,CAAC;SACF;KACF,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AAED,gBAAgB;AAChB,KAAK,UAAU,mBAAmB;IAChC,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACnC;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,kBAAkB;YAC3B,OAAO,EAAE,WAAW;SACrB;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,gBAAgB;YACzB,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC7B,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;oBAC5C,OAAO,qBAAqB,CAAC;gBAC/B,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;SACF;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,iBAAiB;YAC1B,OAAO,EAAE,UAAU;SACpB;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,gBAAgB;SAC1B;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,kBAAkB;YAC3B,OAAO,EAAE,UAAU;YACnB,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;oBAAE,OAAO,UAAU,CAAC;gBACrC,OAAO,IAAI,CAAC;YACd,CAAC;SACF;KACF,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,IAAI;QACb,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;QAC3B,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;AACJ,CAAC;AAED,aAAa;AACb,KAAK,UAAU,gBAAgB;IAC7B,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QAC5C;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,KAAK;YACX,OAAO,EAAE,gBAAgB;YACzB,OAAO,EAAE,2BAA2B;YACpC,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;oBAAE,OAAO,WAAW,CAAC;gBACtC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;oBAC3E,OAAO,sBAAsB,CAAC;gBAChC,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;SACF;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,eAAe;YACxB,OAAO,EAAE,UAAU;YACnB,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC1B,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE;oBAAE,OAAO,UAAU,CAAC;gBACrC,OAAO,IAAI,CAAC;YACd,CAAC;SACF;KACF,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,SAAS;QAClB,GAAG;QACH,MAAM;KACP,CAAC;AACJ,CAAC;AAED,WAAW;AACX,KAAK,UAAU,cAAc;IAC3B,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACnC;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,aAAa;YACtB,OAAO,EAAE,WAAW;SACrB;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,MAAM;YACZ,OAAO,EAAE,WAAW;YACpB,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC7B,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,GAAG,CAAC,IAAI,IAAI,GAAG,KAAK,EAAE,CAAC;oBAC5C,OAAO,qBAAqB,CAAC;gBAC/B,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;SACF;QACD;YACE,IAAI,EAAE,UAAU;YAChB,IAAI,EAAE,UAAU;YAChB,OAAO,EAAE,gBAAgB;SAC1B;QACD;YACE,IAAI,EAAE,OAAO;YACb,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,cAAc;YACvB,OAAO,EAAE,GAAG;YACZ,QAAQ,EAAE,CAAC,KAAa,EAAE,EAAE;gBAC1B,MAAM,EAAE,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC;gBAC3B,IAAI,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,EAAE,CAAC;oBACxB,OAAO,oBAAoB,CAAC;gBAC9B,CAAC;gBACD,OAAO,IAAI,CAAC;YACd,CAAC;SACF;KACF,CAAC,CAAC;IAEH,OAAO;QACL,OAAO,EAAE,OAAO;QAChB,MAAM,EAAE;YACN,IAAI,EAAE,MAAM,CAAC,IAAI;YACjB,IAAI,EAAE,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC;SAC5B;QACD,QAAQ,EAAE,MAAM,CAAC,QAAQ,IAAI,SAAS;QACtC,QAAQ,EAAE,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;KAC9B,CAAC;AACJ,CAAC"}
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"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"}

package/lib/decisions.d.ts

@@ -0,0 +1,16 @@
+export declare const TYPESAFE_DECISION_PACKAGE = "@zhin.js/service-typesafe";
+export interface TypeSafeSetupConfig {
+    readonly instanceKey: string;
+    readonly apiKey: string;
+    readonly model: string;
+    readonly mode: 'shadow' | 'active';
+    readonly envVar?: string;
+}
+/** An explicitly requested optional integration. Existing AI configuration is preserved. */
+export declare function configureTypeSafeDecisions(config: Readonly<Record<string, unknown>>): Promise<TypeSafeSetupConfig>;
+/** Plan data separately from writes so secrets cannot enter the configuration document. */
+export declare function applyTypeSafeDecisionsToConfig(config: Record<string, unknown>, setup: TypeSafeSetupConfig): void;
+export declare function saveTypeSafeSetupDependencies(projectDir: string, setup: TypeSafeSetupConfig): Promise<void>;
+/** Local checks only; never sends a paid API request or returns credential values. */
+export declare function diagnoseDecisionConfig(config: Readonly<Record<string, unknown>>, packageJson: unknown): string[];
+//# sourceMappingURL=decisions.d.ts.map

package/lib/decisions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.d.ts","sourceRoot":"","sources":["../src/decisions.ts"],"names":[],"mappings":"AAQA,eAAO,MAAM,yBAAyB,8BAA8B,CAAC;AACrE,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAWD,4FAA4F;AAC5F,wBAAsB,0BAA0B,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAaxH;AAWD,2FAA2F;AAC3F,wBAAgB,8BAA8B,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,mBAAmB,GAAG,IAAI,CAkBhH;AAED,wBAAsB,6BAA6B,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CAiBjH;AAED,sFAAsF;AACtF,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,GAAG,MAAM,EAAE,CAuChH"}

package/lib/decisions.js

@@ -0,0 +1,140 @@
+import inquirer from 'inquirer';
+import chalk from 'chalk';
+import fs from 'fs-extra';
+import path from 'node:path';
+import { formatEnvValue, mergeEnvText } from './env.js';
+import { clonePluginConfigurationMap, mergeDependenciesIntoPackageJson, mergePluginManifestIntoPackageJson } from './apply.js';
+import { isAiEnabledInConfig } from './project-deps.js';
+export const TYPESAFE_DECISION_PACKAGE = '@zhin.js/service-typesafe';
+function hasChatAgent(config) {
+    if (!isAiEnabledInConfig(config))
+        return false;
+    const binding = record(record(record(config.ai).agents).zhin);
+    return typeof binding.provider === 'string' && !!binding.provider.trim()
+        && typeof binding.model === 'string' && !!binding.model.trim();
+}
+function record(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : {};
+}
+/** An explicitly requested optional integration. Existing AI configuration is preserved. */
+export async function configureTypeSafeDecisions(config) {
+    if (!hasChatAgent(config))
+        throw new Error('先运行 zhin setup --ai 配置聊天模型，再运行 zhin setup --decisions。Jev 决策模型不能替代聊天模型。');
+    console.log(chalk.blue('\nTypeSafe Jev：选择 Agent / Skill / Tool 的可选决策服务。'));
+    console.log(chalk.gray('shadow 仅记录建议，不改变已有行为；active 启用推荐。审核默认关闭。调用会向外部服务发送经过权限过滤的请求与候选描述。'));
+    const answers = await inquirer.prompt([
+        { type: 'input', name: 'instanceKey', message: '决策插件实例名', default: 'typesafe', validate: (value) => /^[a-z][a-z0-9-]*$/.test(value) || '使用小写字母、数字和连字符，字母开头' },
+        { type: 'password', name: 'apiKey', message: 'TypeSafe API Key（仅写入 .env）', mask: '*', validate: (value) => value.trim().length > 0 || '请输入 API Key' },
+        { type: 'input', name: 'model', message: 'Jev 模型（生产校准后建议固定版本）', default: 'jev-latest', validate: (value) => value.trim().length > 0 || '请输入模型名称' },
+        { type: 'select', name: 'mode', message: 'Skill / Tool 推荐运行方式', default: 'shadow', choices: [{ name: 'shadow：观察建议，评估后再启用', value: 'shadow' }, { name: 'active：启用推荐，权限仍由 Zhin 校验', value: 'active' }] },
+    ]);
+    const reference = record(record(config.plugins)[answers.instanceKey]).apiKey;
+    const existingVariable = typeof reference === 'string' ? /^\$\{([A-Za-z_][A-Za-z0-9_]*)\}$/.exec(reference)?.[1] : undefined;
+    return { ...answers, envVar: existingVariable ?? decisionKeyVariable(answers.instanceKey) };
+}
+function decisionKeyVariable(instanceKey) {
+    return instanceKey === 'typesafe' ? 'TYPESAFE_API_KEY' : `TYPESAFE_${instanceKey.toUpperCase().replace(/-/g, '_')}_API_KEY`;
+}
+function envVariable(setup) {
+    const name = setup.envVar ?? decisionKeyVariable(setup.instanceKey);
+    if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name))
+        throw new Error('Invalid TypeSafe environment variable name.');
+    return name;
+}
+/** Plan data separately from writes so secrets cannot enter the configuration document. */
+export function applyTypeSafeDecisionsToConfig(config, setup) {
+    if (!hasChatAgent(config))
+        throw new Error('TypeSafe decisions require existing AI configuration; run zhin setup --ai first.');
+    if (!/^[a-z][a-z0-9-]*$/.test(setup.instanceKey) || !setup.model.trim() || !setup.apiKey.trim())
+        throw new Error('Invalid TypeSafe setup configuration.');
+    const plugins = clonePluginConfigurationMap(config);
+    const existing = record(plugins[setup.instanceKey]);
+    plugins[setup.instanceKey] = { ...existing, apiKey: '${' + envVariable(setup) + '}', model: setup.model.trim(), timeoutMs: 10000, maxRetries: 2, enabled: true };
+    config.plugins = plugins;
+    const ai = record(config.ai);
+    const previousDecisions = record(ai.decisions);
+    config.ai = { ...ai, decisions: {
+            ...previousDecisions,
+            provider: `root/${setup.instanceKey}`,
+            skills: { ...record(previousDecisions.skills), mode: setup.mode },
+            tools: { ...record(previousDecisions.tools), mode: setup.mode },
+            agents: previousDecisions.agents ?? { mode: 'off' },
+            memory: previousDecisions.memory ?? { mode: 'off' },
+            approval: previousDecisions.approval ?? { mode: 'off' },
+        } };
+}
+export async function saveTypeSafeSetupDependencies(projectDir, setup) {
+    const variable = envVariable(setup);
+    const pkgPath = path.join(projectDir, 'package.json');
+    const pkg = await fs.readJson(pkgPath);
+    const existingManifest = record(pkg.zhin).plugins;
+    if (Array.isArray(existingManifest) && existingManifest.some(entry => record(entry).instanceKey === setup.instanceKey && record(entry).package !== TYPESAFE_DECISION_PACKAGE)) {
+        throw new Error('Decision plugin instance already belongs to another package; choose a different instanceKey.');
+    }
+    await mergePluginManifestIntoPackageJson(projectDir, [{ package: TYPESAFE_DECISION_PACKAGE, instanceKey: setup.instanceKey }]);
+    await mergeDependenciesIntoPackageJson(projectDir, { [TYPESAFE_DECISION_PACKAGE]: '^1.0.0' });
+    const envPath = path.join(projectDir, '.env');
+    const envExists = await fs.pathExists(envPath);
+    const previous = envExists ? await fs.readFile(envPath, 'utf8') : '';
+    // writeFile's mode applies only when creating a file. Restrict existing files
+    // before adding credentials; Windows access control is not POSIX file modes.
+    if (envExists && process.platform !== 'win32')
+        await fs.chmod(envPath, 0o600);
+    await fs.writeFile(envPath, mergeEnvText(previous, `${variable}=${formatEnvValue(setup.apiKey)}\n`), { mode: 0o600 });
+}
+/** Local checks only; never sends a paid API request or returns credential values. */
+export function diagnoseDecisionConfig(config, packageJson) {
+    const ai = record(config.ai);
+    if (!Object.hasOwn(ai, 'decisions'))
+        return [];
+    const decisions = record(ai.decisions);
+    const issues = [];
+    const taskNames = ['skills', 'tools', 'memory', 'agents', 'approval'];
+    if (Object.keys(decisions).some(key => !['provider', ...taskNames].includes(key)))
+        issues.push('ai.decisions 含有未知配置字段。');
+    const provider = decisions.provider;
+    if (typeof provider !== 'string' || !/^root(?:\/[a-z0-9][a-z0-9-]*)+$/.test(provider))
+        return [...issues, 'ai.decisions.provider 必须是精确插件 owner，例如 root/typesafe。'];
+    for (const name of taskNames) {
+        if (!Object.hasOwn(decisions, name))
+            continue;
+        const task = record(decisions[name]);
+        if (Object.keys(task).some(key => !['mode', 'timeoutMs', 'minConfidence', 'topK', 'maxCandidates', 'maxSelections'].includes(key)))
+            issues.push(`ai.decisions.${name} 含有未知配置字段。`);
+        if (typeof task.mode !== 'string' || !['off', 'shadow', 'active'].includes(task.mode))
+            issues.push(`ai.decisions.${name}.mode 必须是 off、shadow 或 active。`);
+        for (const field of ['timeoutMs', 'topK', 'maxCandidates', 'maxSelections']) {
+            if (task[field] !== undefined && (!Number.isSafeInteger(task[field]) || Number(task[field]) <= 0 || field === 'timeoutMs' && Number(task[field]) > 2147483647))
+                issues.push(`ai.decisions.${name}.${field} 必须是正整数。`);
+        }
+        if (task.minConfidence !== undefined && (typeof task.minConfidence !== 'number' || !Number.isFinite(task.minConfidence) || task.minConfidence < 0 || task.minConfidence > 1))
+            issues.push(`ai.decisions.${name}.minConfidence 必须在 0 到 1 之间。`);
+    }
+    if (!hasChatAgent(config))
+        issues.push('决策服务需要已启用的 AI Agent；运行 zhin setup --ai。');
+    const enabled = taskNames.some(name => ['shadow', 'active'].includes(String(record(decisions[name]).mode)));
+    if (!enabled)
+        return issues;
+    const key = provider.slice('root/'.length);
+    // Nested Plugin owners are resolved from the actual runtime graph during activation.
+    if (key.includes('/'))
+        return issues;
+    const pkg = record(packageJson);
+    const manifest = record(pkg.zhin).plugins;
+    const entries = Array.isArray(manifest) ? manifest.filter(entry => record(entry).instanceKey === key) : [];
+    if (entries.length !== 1) {
+        issues.push('决策插件实例未在 package.json#zhin.plugins 唯一声明。');
+        return issues;
+    }
+    if (record(entries[0]).package === TYPESAFE_DECISION_PACKAGE) {
+        const configForProvider = record(record(config.plugins)[key]);
+        if (configForProvider.enabled === false)
+            issues.push('绑定的 TypeSafe 插件已禁用。');
+        if (typeof configForProvider.apiKey !== 'string' || !configForProvider.apiKey.trim())
+            issues.push('TypeSafe 插件缺少 apiKey 环境变量引用。');
+        if (!Object.hasOwn({ ...record(pkg.dependencies), ...record(pkg.devDependencies) }, TYPESAFE_DECISION_PACKAGE))
+            issues.push('package.json 缺少 @zhin.js/service-typesafe 依赖。');
+    }
+    return issues;
+}
+//# sourceMappingURL=decisions.js.map

package/lib/decisions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decisions.js","sourceRoot":"","sources":["../src/decisions.ts"],"names":[],"mappings":"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"}

package/lib/env.d.ts

@@ -11,4 +11,10 @@ export declare function formatEnvValue(value: unknown): string;
 export declare function mergeEnvText(existing: string, extra: string): string;
 /** 生成数据库连接环境变量（连接参数落 .env，配置文件只引用 ${VAR}）。 */
 export declare function generateDatabaseEnvVars(config: DatabaseConfig): string;
+/**
+ * Generate a version-control-safe database section for `.env.example`.
+ * User-entered passwords and credential-bearing connection URLs are never
+ * copied from the interactive wizard.
+ */
+export declare function generateDatabaseEnvExample(config: DatabaseConfig): string;
 //# sourceMappingURL=env.d.ts.map

package/lib/env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQrD;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAwCpE;AAED,8CAA8C;AAC9C,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA+CtE"}
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAQrD;AAID;;;GAGG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAwCpE;AAED,8CAA8C;AAC9C,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CAgDtE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,cAAc,GAAG,MAAM,CA4CzE"}

package/lib/env.js

@@ -80,10 +80,61 @@ export function generateDatabaseEnvVars(config) {
             envVars.push('# Redis 数据库配置', `REDIS_HOST=${formatEnvValue(config.socket?.host || 'localhost')}`, `REDIS_PORT=${formatEnvValue(config.socket?.port || 6379)}`, `REDIS_PASSWORD=${formatEnvValue(config.password || '')}`, `REDIS_DB=${formatEnvValue(config.database ?? 0)}`);
             break;
         case 'sqlite':
+        case 'memory':
         default:
             // SQLite 不需要额外的环境变量
             break;
     }
     return envVars.length > 0 ? `\n\n${envVars.join('\n')}` : '';
 }
+/**
+ * Generate a version-control-safe database section for `.env.example`.
+ * User-entered passwords and credential-bearing connection URLs are never
+ * copied from the interactive wizard.
+ */
+export function generateDatabaseEnvExample(config) {
+    let lines = [];
+    switch (config.dialect) {
+        case 'mysql':
+            lines = [
+                '# MySQL 数据库配置',
+                'DB_HOST=127.0.0.1',
+                'DB_PORT=3306',
+                'DB_USER=root',
+                'DB_PASSWORD=change-me',
+                'DB_DATABASE=zhin_bot',
+            ];
+            break;
+        case 'pg':
+            lines = [
+                '# PostgreSQL 数据库配置',
+                'DB_HOST=127.0.0.1',
+                'DB_PORT=5432',
+                'DB_USER=postgres',
+                'DB_PASSWORD=change-me',
+                'DB_DATABASE=zhin_bot',
+            ];
+            break;
+        case 'mongodb':
+            lines = [
+                '# MongoDB 数据库配置',
+                'DB_URL=mongodb://127.0.0.1:27017',
+                'DB_NAME=zhin_bot',
+            ];
+            break;
+        case 'redis':
+            lines = [
+                '# Redis 数据库配置',
+                'REDIS_HOST=127.0.0.1',
+                'REDIS_PORT=6379',
+                'REDIS_PASSWORD=',
+                'REDIS_DB=0',
+            ];
+            break;
+        case 'sqlite':
+        case 'memory':
+            return '';
+    }
+    return `\n\n${lines.join('\n')}`;
+}
 //# sourceMappingURL=env.js.map

package/lib/env.js.map

@@ -1 +1 @@
-{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,MAAM,GAAG,GAAG,KAAK,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/C,IAAI,GAAG,KAAK,EAAE,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,GAAG,CAAC;IACrD,OAAO,IAAI,GAAG;SACX,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC;SACpB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC;SACrB,OAAO,CAAC,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC;AAC9B,CAAC;AAED,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAElD;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,QAAgB,EAAE,KAAa;IAC1D,MAAM,OAAO,GAA2D,EAAE,CAAC;IAC3E,IAAI,cAAkC,CAAC;IACvC,KAAK,MAAM,OAAO,IAAI,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI;YAAE,SAAS;QACpB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACzB,cAAc,GAAG,IAAI,CAAC;YACtB,SAAS;QACX,CAAC;QACD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK;YAAE,SAAS;QACrB,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,EAAE,cAAc,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/D,cAAc,GAAG,SAAS,CAAC;IAC7B,CAAC;IACD,MAAM,GAAG,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAC5D,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC;IAClE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,GAAG,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACnD,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC;QACnD,IAAI,KAAK,IAAI,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACjC,GAAG,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAE,CAAC,IAAI,CAAC;YACvC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IACD,MAAM,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAClE,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACrB,OAAO,GAAG,CAAC,MAAM,GAAG,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE;YAAE,GAAG,CAAC,GAAG,EAAE,CAAC;QACtE,IAAI,GAAG,CAAC,MAAM,GAAG,CAAC;YAAE,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACjC,IAAI,WAA+B,CAAC;QACpC,KAAK,MAAM,KAAK,IAAI,KAAK,EAAE,CAAC;YAC1B,IAAI,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,KAAK,WAAW;gBAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5E,WAAW,GAAG,KAAK,CAAC,OAAO,CAAC;YAC5B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QACvB,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,IAAI,CAAC;AACnD,CAAC;AAED,8CAA8C;AAC9C,MAAM,UAAU,uBAAuB,CAAC,MAAsB;IAC5D,MAAM,OAAO,GAAa,EAAE,CAAC;IAE7B,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,OAAO;YACV,OAAO,CAAC,IAAI,CACV,eAAe,EACf,WAAW,cAAc,CAAC,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC,EAAE,EACvD,WAAW,cAAc,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAChD,WAAW,cAAc,CAAC,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,EAClD,eAAe,cAAc,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,EACtD,eAAe,cAAc,CAAC,MAAM,CAAC,QAAQ,IAAI,UAAU,CAAC,EAAE,CAC/D,CAAC;YACF,MAAM;QACR,KAAK,IAAI;YACP,OAAO,CAAC,IAAI,CACV,oBAAoB,EACpB,WAAW,cAAc,CAAC,MAAM,CAAC,IAAI,IAAI,WAAW,CAAC,EAAE,EACvD,WAAW,cAAc,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,EAChD,WAAW,cAAc,CAAC,MAAM,CAAC,IAAI,IAAI,UAAU,CAAC,EAAE,EACtD,eAAe,cAAc,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,EACtD,eAAe,cAAc,CAAC,MAAM,CAAC,QAAQ,IAAI,UAAU,CAAC,EAAE,CAC/D,CAAC;YACF,MAAM;QACR,KAAK,SAAS;YACZ,OAAO,CAAC,IAAI,CACV,iBAAiB,EACjB,UAAU,cAAc,CAAC,MAAM,CAAC,GAAG,IAAI,2BAA2B,CAAC,EAAE,EACrE,WAAW,cAAc,CAAC,MAAM,CAAC,MAAM,IAAI,UAAU,CAAC,EAAE,CACzD,CAAC;YACF,MAAM;QACR,KAAK,OAAO;YACV,OAAO,CAAC,IAAI,CACV,eAAe,EACf,cAAc,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,WAAW,CAAC,EAAE,EAClE,cAAc,cAAc,CAAC,MAAM,CAAC,MAAM,EAAE,IAAI,IAAI,IAAI,CAAC,EAAE,EAC3D,kBAAkB,cAAc,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,EAAE,EACzD,YAAY,cAAc,CAAC,MAAM,CAAC,QAAQ,IAAI,CAAC,CAAC,EAAE,CACnD,CAAC;YACF,MAAM;QACR,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ,CAAC;QACd;YACE,oBAAoB;YACpB,MAAM;IACV,CAAC;IAED,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;AAC/D,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CAAC,MAAsB;IAC/D,IAAI,KAAK,GAAa,EAAE,CAAC;IACzB,QAAQ,MAAM,CAAC,OAAO,EAAE,CAAC;QACvB,KAAK,OAAO;YACV,KAAK,GAAG;gBACN,eAAe;gBACf,mBAAmB;gBACnB,cAAc;gBACd,cAAc;gBACd,uBAAuB;gBACvB,sBAAsB;aACvB,CAAC;YACF,MAAM;QACR,KAAK,IAAI;YACP,KAAK,GAAG;gBACN,oBAAoB;gBACpB,mBAAmB;gBACnB,cAAc;gBACd,kBAAkB;gBAClB,uBAAuB;gBACvB,sBAAsB;aACvB,CAAC;YACF,MAAM;QACR,KAAK,SAAS;YACZ,KAAK,GAAG;gBACN,iBAAiB;gBACjB,kCAAkC;gBAClC,kBAAkB;aACnB,CAAC;YACF,MAAM;QACR,KAAK,OAAO;YACV,KAAK,GAAG;gBACN,eAAe;gBACf,sBAAsB;gBACtB,iBAAiB;gBACjB,iBAAiB;gBACjB,YAAY;aACb,CAAC;YACF,MAAM;QACR,KAAK,QAAQ,CAAC;QACd,KAAK,QAAQ;YACX,OAAO,EAAE,CAAC;IACd,CAAC;IACD,OAAO,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACnC,CAAC"}

package/lib/index.d.ts

@@ -1,15 +1,17 @@
 export type { InitOptions, DatabaseConfig } from './types.js';
-export { DATABASE_PACKAGES } from './types.js';
+export { DATABASE_DRIVER_VERSIONS, DATABASE_PACKAGES } from './types.js';
+export { DATABASE_DIALECT_DEFINITIONS, databaseChoiceLabel, getDatabaseDialectDefinition, validateDatabaseConfig, } from './database-definitions.js';
+export type { DatabaseDialect, DatabaseDialectDefinition, DatabaseDriverDefinition, DatabaseSchemaIssue, } from './database-definitions.js';
 export type { AdapterSetupResult, AdapterPluginInstance, AdapterDefinition } from './adapter.js';
 export { ADAPTERS, findAdapterByPackage, configureAdapters, buildFieldBasedInstanceConfig, generateAdapterEnvVars, collectAdapterPluginConfigs, collectAdapterPluginManifest, getAdapterDependencies, getAdapterSetupNotes, } from './adapter.js';
 export { ADAPTERS_DOCS_URL, ADAPTERS_INDEX_URL, ADAPTERS_ESSENTIALS_URL, adapterDocsUrl, } from './adapter-configurers.js';
 export type { AISetupConfig } from './ai.js';
 export { configureAI, generateAIEnvVars, generateAIConfigYaml, generateAIConfigJSON, RECOMMENDED_AI_DEFAULTS, } from './ai.js';
 export { configureDatabaseOptions } from './database.js';
-export { formatEnvValue, mergeEnvText, generateDatabaseEnvVars, } from './env.js';
+export { formatEnvValue, mergeEnvText, generateDatabaseEnvExample, generateDatabaseEnvVars, } from './env.js';
 export { AI_STACK_VERSIONS, MCP_SDK_VERSION, getAIDependencies, listAIDependencyNames, formatAIDependencyHint, isAiEnabledInConfig, resolveAgentProviderFromConfig, getRequiredAIDependenciesForConfig, diagnoseAIDependencies, formatAIDependencyFixCommand, packagesNeedingAiStackFix, findOutdatedAiStackInPackageJson, findInstalledAiStackIncompatibilities, ensureDatabaseForAI, ensureDatabaseForAdapters, } from './project-deps.js';
 export type { AiStackIncompatibility } from './project-deps.js';
-export { ZHIN_STACK_VERSIONS, DEFAULT_CREATE_BOT_HTTP_PORT, CREATE_BOT_NPMRC, getCreateBotBaseDependencies, getCreateBotPnpmConfig, getRequiredZhinDependenciesForConfig, diagnoseZhinStackDependencies, formatZhinStackFixCommand, packagesNeedingZhinStackFix, findOutdatedZhinStackInPackageJson, findInstalledZhinStackIncompatibilities, } from './zhin-stack-deps.js';
+export { ZHIN_STACK_VERSIONS, DEFAULT_CREATE_BOT_HTTP_PORT, CREATE_BOT_PACKAGE_MANAGER, getCreateBotBaseDependencies, getCreateBotPnpmWorkspaceConfig, getRequiredZhinDependenciesForConfig, diagnoseZhinStackDependencies, formatZhinStackFixCommand, packagesNeedingZhinStackFix, findOutdatedZhinStackInPackageJson, findInstalledZhinStackIncompatibilities, } from './zhin-stack-deps.js';
 export type { ZhinStackDiagnosis, ZhinStackIncompatibility } from './zhin-stack-deps.js';
 export { SPEECH_PACKAGE, HTML_RENDERER_PACKAGE, ADAPTERS_PREFER_HTML_IMAGE, diagnoseOptionalPeers, formatOptionalPeerFixCommand, getOptionalPeerDependencies, } from './optional-peers.js';
 export type { OptionalPeerDiagnosis, OptionalPeersDiagnosis } from './optional-peers.js';
@@ -18,4 +20,6 @@ export type { UpgradeToL4Diagnosis } from './upgrade-l4.js';
 export { loadProjectConfig, createProjectConfigPlan, renderProjectConfigPatch, applyProjectConfigPlan, migrateAiLegacyConfig, diagnoseConsoleConfig, applyConsoleConfigFixes, packageToInstanceKey, } from './project-config-plan.js';
 export type { LoadedProjectConfig, ProjectConfigFormat, ProjectConfigPlan, ProjectConfigPlanOptions, ConsoleConfigDiagnosis, } from './project-config-plan.js';
 export { applyDatabaseToConfig, applyAdaptersToConfig, applyAIToConfig, appendWizardEnvVars, collectWizardDependencies, collectWizardFeatures, mergeDependenciesIntoPackageJson, mergeFeaturesIntoPackageJson, mergePluginManifestIntoPackageJson, finalizeWizardOptions, applyWizardOptionsToConfig, clonePluginConfigurationMap, materializeDatabaseConfig, buildRuntimeConfigDocument, serializeRuntimeConfig, } from './apply.js';
+export { TYPESAFE_DECISION_PACKAGE, configureTypeSafeDecisions, applyTypeSafeDecisionsToConfig, saveTypeSafeSetupDependencies, diagnoseDecisionConfig, } from './decisions.js';
+export type { TypeSafeSetupConfig } from './decisions.js';
 //# sourceMappingURL=index.d.ts.map