@aalis/runtime 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ace Nyan <ace@acenyan.com>
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createNodeModulesPluginLoader } from './node-modules-loader.js';
+export { createFsPluginLoader, createFsYamlConfigProvider, createProcessRespawnStrategy, } from './providers.js';
+export { type StartAalisOptions, startAalis } from './start.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAUA,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,KAAK,iBAAiB,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,13 @@
+// @aalis/runtime —— Aalis 独立部署运行时（node 宿主层）
+//
+// 提供两种部署模型的加载器与 YAML 配置/重启策略，以及一行启动 startAalis：
+//   - createNodeModulesPluginLoader：纯 npm 独立部署（从 node_modules 解析插件）
+//   - createFsPluginLoader：monorepo 自托管（扫描 packages/ 目录）
+//   - createFsYamlConfigProvider / createProcessRespawnStrategy：YAML 配置 + 进程级重启
+//   - startAalis：组装以上为独立实例并启动
+//
+// monorepo 的 src/runtime/providers.ts 从本包再导出 FS 系列，单一事实来源、零重复。
+export { createNodeModulesPluginLoader } from './node-modules-loader.js';
+export { createFsPluginLoader, createFsYamlConfigProvider, createProcessRespawnStrategy, } from './providers.js';
+export { startAalis } from './start.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAC5C,EAAE;AACF,gDAAgD;AAChD,oEAAoE;AACpE,yDAAyD;AACzD,gFAAgF;AAChF,8BAA8B;AAC9B,EAAE;AACF,+DAA+D;AAE/D,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EACL,oBAAoB,EACpB,0BAA0B,EAC1B,4BAA4B,GAC7B,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAA0B,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/node-modules-loader.d.ts

@@ -0,0 +1,18 @@
+import type { PluginLoader } from '@aalis/core';
+/**
+ * 判定一个已装依赖是否为可加载的 Aalis 插件。纯函数，便于单测。
+ * 排除核心/契约/前端/工具链标记；收录有 aalis-plugin 关键词或 @aalis/plugin-* 名或 service/subsystem。
+ */
+export declare function isLoadablePlugin(name: string, meta: Record<string, unknown>): boolean;
+/**
+ * 创建一个从项目 node_modules 解析插件的 PluginLoader。
+ *
+ * @param projectDir 项目根目录（含 package.json 与 node_modules），默认 process.cwd()
+ *
+ * - `discover()`：读 projectDir/package.json 的 dependencies + optionalDependencies，
+ *   用 require.resolve 定位每个依赖的 package.json，按标记过滤出可加载插件。
+ * - `load()`：用 `pathToFileURL(entry).href` 动态 import（entry = require.resolve(包名)）。
+ * - `reload()`：用入口文件 mtime 作 import URL query 强制 ESM 缓存失效。
+ */
+export declare function createNodeModulesPluginLoader(projectDir?: string): PluginLoader;
+//# sourceMappingURL=node-modules-loader.d.ts.map

package/dist/node-modules-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-modules-loader.d.ts","sourceRoot":"","sources":["../src/node-modules-loader.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAoB,YAAY,EAAgB,MAAM,aAAa,CAAC;AAyBhF;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAUrF;AAED;;;;;;;;;GASG;AACH,wBAAgB,6BAA6B,CAAC,UAAU,GAAE,MAAsB,GAAG,YAAY,CAqD9F"}

package/dist/node-modules-loader.js

@@ -0,0 +1,107 @@
+import { readFileSync } from 'node:fs';
+import { stat } from 'node:fs/promises';
+import { createRequire } from 'node:module';
+import { dirname, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+// ============================================================
+// NodeModulesPluginLoader —— 从 node_modules 解析并加载插件
+// ============================================================
+//
+// 独立部署（纯 npm 装 Aalis）用的加载器：不扫描 packages/ 目录，而是读项目
+// package.json 的 dependencies，逐个用 node 模块解析（require.resolve）定位已装的
+// @aalis 插件并 dynamic import。与 monorepo 的 createFsPluginLoader 是「两种部署
+// 模型的两个加载器」，非重复：前者扫目录，后者走 node 解析。
+//
+// 插件识别（正信号 + 排除标记）：
+//   - 排除：package.json 的 aalis.{core,types,client,tooling} 标记（核心/契约/前端/工具链）
+//   - 收录：keywords 含 'aalis-plugin'（市场约定）∪ 名称匹配 @aalis/plugin-* ∪ 有 aalis.service/subsystem
+// 这样 @aalis/core、各 *-api（types）、webui-client（client）、@aalis/runtime（tooling）
+// 与 express/yaml 等普通依赖都不会被误当插件加载。
+function readJson(path) {
+    try {
+        return JSON.parse(readFileSync(path, 'utf-8'));
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * 判定一个已装依赖是否为可加载的 Aalis 插件。纯函数，便于单测。
+ * 排除核心/契约/前端/工具链标记；收录有 aalis-plugin 关键词或 @aalis/plugin-* 名或 service/subsystem。
+ */
+export function isLoadablePlugin(name, meta) {
+    const aalis = (meta.aalis ?? {});
+    if (aalis.core || aalis.types || aalis.client || aalis.tooling)
+        return false;
+    const keywords = Array.isArray(meta.keywords) ? meta.keywords : [];
+    return (keywords.includes('aalis-plugin') ||
+        /^@aalis\/plugin-/.test(name) ||
+        aalis.service !== undefined ||
+        aalis.subsystem !== undefined);
+}
+/**
+ * 创建一个从项目 node_modules 解析插件的 PluginLoader。
+ *
+ * @param projectDir 项目根目录（含 package.json 与 node_modules），默认 process.cwd()
+ *
+ * - `discover()`：读 projectDir/package.json 的 dependencies + optionalDependencies，
+ *   用 require.resolve 定位每个依赖的 package.json，按标记过滤出可加载插件。
+ * - `load()`：用 `pathToFileURL(entry).href` 动态 import（entry = require.resolve(包名)）。
+ * - `reload()`：用入口文件 mtime 作 import URL query 强制 ESM 缓存失效。
+ */
+export function createNodeModulesPluginLoader(projectDir = process.cwd()) {
+    const root = resolve(projectDir);
+    // 以项目 package.json 为基准创建 require，确保从项目 node_modules 解析
+    const req = createRequire(pathToFileURL(resolve(root, 'package.json')));
+    return {
+        async discover() {
+            const rootPkg = readJson(resolve(root, 'package.json'));
+            if (!rootPkg)
+                return [];
+            const deps = {
+                ...(rootPkg.dependencies ?? {}),
+                ...(rootPkg.optionalDependencies ?? {}),
+            };
+            const discovered = [];
+            for (const dep of Object.keys(deps)) {
+                let metaPath;
+                try {
+                    metaPath = req.resolve(`${dep}/package.json`);
+                }
+                catch {
+                    continue; // 未安装或无法解析，跳过
+                }
+                const meta = readJson(metaPath);
+                if (!meta || !isLoadablePlugin(dep, meta))
+                    continue;
+                let entry;
+                try {
+                    entry = req.resolve(dep);
+                }
+                catch {
+                    continue; // 解析不到入口（如缺 main/exports），跳过
+                }
+                discovered.push({
+                    name: meta.name ?? dep,
+                    source: entry,
+                    metadata: { dir: dirname(metaPath) },
+                });
+            }
+            return discovered;
+        },
+        async load(desc) {
+            return (await import(pathToFileURL(desc.source).href));
+        },
+        async reload(desc) {
+            let cacheKey = '';
+            try {
+                cacheKey = `?t=${(await stat(desc.source)).mtimeMs}`;
+            }
+            catch {
+                /* stat 失败时用空 key，让 import 自己报错 */
+            }
+            return (await import(pathToFileURL(desc.source).href + cacheKey));
+        },
+    };
+}
+//# sourceMappingURL=node-modules-loader.js.map

package/dist/node-modules-loader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node-modules-loader.js","sourceRoot":"","sources":["../src/node-modules-loader.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACxC,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAGzC,+DAA+D;AAC/D,oDAAoD;AACpD,+DAA+D;AAC/D,EAAE;AACF,kDAAkD;AAClD,kEAAkE;AAClE,qEAAqE;AACrE,mCAAmC;AACnC,EAAE;AACF,oBAAoB;AACpB,2EAA2E;AAC3E,2FAA2F;AAC3F,6EAA6E;AAC7E,kCAAkC;AAElC,SAAS,QAAQ,CAAC,IAAY;IAC5B,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,IAAI,EAAE,OAAO,CAAC,CAA4B,CAAC;IAC5E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY,EAAE,IAA6B;IAC1E,MAAM,KAAK,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,CAA4B,CAAC;IAC5D,IAAI,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,IAAI,KAAK,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAC7E,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAE,IAAI,CAAC,QAAqB,CAAC,CAAC,CAAC,EAAE,CAAC;IACjF,OAAO,CACL,QAAQ,CAAC,QAAQ,CAAC,cAAc,CAAC;QACjC,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC;QAC7B,KAAK,CAAC,OAAO,KAAK,SAAS;QAC3B,KAAK,CAAC,SAAS,KAAK,SAAS,CAC9B,CAAC;AACJ,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,6BAA6B,CAAC,aAAqB,OAAO,CAAC,GAAG,EAAE;IAC9E,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACjC,uDAAuD;IACvD,MAAM,GAAG,GAAG,aAAa,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,CAAC;IAExE,OAAO;QACL,KAAK,CAAC,QAAQ;YACZ,MAAM,OAAO,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;YACxD,IAAI,CAAC,OAAO;gBAAE,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,GAAG;gBACX,GAAG,CAAE,OAAO,CAAC,YAAuC,IAAI,EAAE,CAAC;gBAC3D,GAAG,CAAE,OAAO,CAAC,oBAA+C,IAAI,EAAE,CAAC;aACpE,CAAC;YAEF,MAAM,UAAU,GAAuB,EAAE,CAAC;YAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpC,IAAI,QAAgB,CAAC;gBACrB,IAAI,CAAC;oBACH,QAAQ,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,GAAG,eAAe,CAAC,CAAC;gBAChD,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS,CAAC,cAAc;gBAC1B,CAAC;gBACD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC;gBAChC,IAAI,CAAC,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,EAAE,IAAI,CAAC;oBAAE,SAAS;gBACpD,IAAI,KAAa,CAAC;gBAClB,IAAI,CAAC;oBACH,KAAK,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC3B,CAAC;gBAAC,MAAM,CAAC;oBACP,SAAS,CAAC,6BAA6B;gBACzC,CAAC;gBACD,UAAU,CAAC,IAAI,CAAC;oBACd,IAAI,EAAG,IAAI,CAAC,IAAe,IAAI,GAAG;oBAClC,MAAM,EAAE,KAAK;oBACb,QAAQ,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,QAAQ,CAAC,EAAE;iBACrC,CAAC,CAAC;YACL,CAAC;YACD,OAAO,UAAU,CAAC;QACpB,CAAC;QAED,KAAK,CAAC,IAAI,CAAC,IAAI;YACb,OAAO,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,CAAiB,CAAC;QACzE,CAAC;QAED,KAAK,CAAC,MAAM,CAAC,IAAI;YACf,IAAI,QAAQ,GAAG,EAAE,CAAC;YAClB,IAAI,CAAC;gBACH,QAAQ,GAAG,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC;YACvD,CAAC;YAAC,MAAM,CAAC;gBACP,kCAAkC;YACpC,CAAC;YACD,OAAO,CAAC,MAAM,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,IAAI,GAAG,QAAQ,CAAC,CAAiB,CAAC;QACpF,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/providers.d.ts

@@ -0,0 +1,40 @@
+import type { AalisConfig, ConfigProvider, PluginLoader, RestartStrategy } from '@aalis/core';
+interface FsYamlConfigProviderResult {
+    /** 当前快照（用于 `new App({ config })`） */
+    config: AalisConfig;
+    /** Provider 实例（用于 `new App({ configProvider })`） */
+    provider: ConfigProvider;
+    /** 配置文件所在目录（用于 `new App({ dataDir })`） */
+    dataDir: string;
+}
+/**
+ * 创建一个基于 YAML 文件的 ConfigProvider。
+ *
+ * - 同步读取 + 解析 + 环境变量插值
+ * - `save()` 同步写回，并保护 `${ENV}` 占位符
+ * - `watch()` 用 `fs.watch` + 300ms debounce，并通过 lastWrittenYaml 去重避免自激
+ *
+ * 调用时一次性返回 config 快照、provider 和 dataDir 三件套，方便 src/index.ts 组装。
+ */
+export declare function createFsYamlConfigProvider(configPath?: string): FsYamlConfigProviderResult;
+/**
+ * 创建一个基于 packages 目录扫描的 PluginLoader。
+ *
+ * - `discover()`：读 dir 下每个子目录的 package.json，按 `aalis.{core,client,types}` 标记过滤
+ * - `load()`：用 `pathToFileURL(entry).href` 动态 import
+ * - `reload()`：用入口文件 mtime 作为 import URL 的 query 强制 ESM 缓存失效
+ */
+export declare function createFsPluginLoader(packagesDir?: string): PluginLoader;
+/**
+ * Node 进程重启策略：spawn 一个 detached 子进程沿用当前 argv，然后 `process.exit(0)`。
+ *
+ * 时序：
+ * 1. 等 500ms 让正在飞行的 HTTP/WS 响应有机会先返回客户端
+ * 2. 调 `stop()` 优雅停掉当前 App（关闭网关、断开适配器等）
+ * 3. spawn 新进程 + `process.exit(0)`
+ *
+ * 对 .ts 入口（开发模式）会优先使用本地 `tsx` 二进制。
+ */
+export declare function createProcessRespawnStrategy(): RestartStrategy;
+export {};
+//# sourceMappingURL=providers.d.ts.map

package/dist/providers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"providers.d.ts","sourceRoot":"","sources":["../src/providers.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EAEd,YAAY,EAEZ,eAAe,EAChB,MAAM,aAAa,CAAC;AA6FrB,UAAU,0BAA0B;IAClC,qCAAqC;IACrC,MAAM,EAAE,WAAW,CAAC;IACpB,oDAAoD;IACpD,QAAQ,EAAE,cAAc,CAAC;IACzB,0CAA0C;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;GAQG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,CAAC,EAAE,MAAM,GAAG,0BAA0B,CAmE1F;AAMD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,YAAY,CAkDvE;AAMD;;;;;;;;;GASG;AACH,wBAAgB,4BAA4B,IAAI,eAAe,CAyB9D"}

package/dist/providers.js

@@ -0,0 +1,270 @@
+import { spawn } from 'node:child_process';
+import { existsSync, watch as fsWatch, readFileSync, writeFileSync } from 'node:fs';
+import { readdir, stat } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { pathToFileURL } from 'node:url';
+import { parse as parseYaml, stringify as stringifyYaml } from 'yaml';
+// ============================================================
+// FsYamlConfigProvider —— 从 YAML 文件加载+持久化配置
+// ============================================================
+const DEFAULT_CONFIG_FILE = 'aalis.config.yaml';
+/**
+ * 把 `${ENV_VAR}` 替换为环境变量值（兼容老配置）。
+ */
+function interpolateEnvVars(text) {
+    return text.replace(/\$\{([^}]+)}/g, (_, varName) => {
+        return process.env[varName.trim()] ?? '';
+    });
+}
+const CORE_TOP_LEVEL_KEYS = new Set(['name', 'logLevel', 'plugins', 'disabledPlugins', 'servicePreferences']);
+/**
+ * 恢复 ${ENV} 占位符：对比当前值与原始 raw 值，若相等则保留 raw。
+ */
+function restoreEnvVars(current, raw) {
+    const result = {};
+    for (const [key, value] of Object.entries(current)) {
+        const rawVal = raw[key];
+        if (typeof rawVal === 'string' && /\$\{[^}]+}/.test(rawVal)) {
+            const expanded = interpolateEnvVars(rawVal);
+            if (expanded === value) {
+                result[key] = rawVal;
+                continue;
+            }
+        }
+        if (value &&
+            typeof value === 'object' &&
+            !Array.isArray(value) &&
+            rawVal &&
+            typeof rawVal === 'object' &&
+            !Array.isArray(rawVal)) {
+            result[key] = restoreEnvVars(value, rawVal);
+        }
+        else {
+            result[key] = value;
+        }
+    }
+    return result;
+}
+/**
+ * 把 AalisConfig 序列化为 YAML 文本，按固定顺序输出 core 字段，
+ * 透传其余顶层字段（业务字段，宿主不解释）。
+ */
+function buildSaveYaml(config, rawYaml) {
+    const obj = {
+        name: config.name,
+        logLevel: config.logLevel,
+    };
+    if (rawYaml) {
+        const rawParsed = parseYaml(rawYaml);
+        const rawPlugins = (rawParsed?.plugins ?? {});
+        const plugins = {};
+        for (const [name, conf] of Object.entries(config.plugins)) {
+            plugins[name] = restoreEnvVars(conf, rawPlugins[name] ?? {});
+        }
+        obj.plugins = plugins;
+    }
+    else {
+        obj.plugins = config.plugins;
+    }
+    obj.disabledPlugins = config.disabledPlugins ?? [];
+    const prefs = config.servicePreferences ?? {};
+    if (Object.keys(prefs).length > 0) {
+        obj.servicePreferences = prefs;
+    }
+    for (const [key, value] of Object.entries(config)) {
+        if (CORE_TOP_LEVEL_KEYS.has(key))
+            continue;
+        if (value === undefined)
+            continue;
+        if (Array.isArray(value)) {
+            if (value.length > 0)
+                obj[key] = value;
+        }
+        else if (value && typeof value === 'object') {
+            if (Object.keys(value).length > 0)
+                obj[key] = value;
+        }
+        else {
+            obj[key] = value;
+        }
+    }
+    return stringifyYaml(obj, { lineWidth: 0 });
+}
+/**
+ * 创建一个基于 YAML 文件的 ConfigProvider。
+ *
+ * - 同步读取 + 解析 + 环境变量插值
+ * - `save()` 同步写回，并保护 `${ENV}` 占位符
+ * - `watch()` 用 `fs.watch` + 300ms debounce，并通过 lastWrittenYaml 去重避免自激
+ *
+ * 调用时一次性返回 config 快照、provider 和 dataDir 三件套，方便 src/index.ts 组装。
+ */
+export function createFsYamlConfigProvider(configPath) {
+    const absPath = configPath ? resolve(configPath) : resolve(process.cwd(), DEFAULT_CONFIG_FILE);
+    const dataDir = dirname(absPath);
+    let rawYaml = null;
+    let lastWrittenYaml = null;
+    let watcher = null;
+    let debounceTimer = null;
+    function loadFromDisk() {
+        if (existsSync(absPath)) {
+            rawYaml = readFileSync(absPath, 'utf-8');
+            const interpolated = interpolateEnvVars(rawYaml);
+            const parsed = (parseYaml(interpolated) ?? {});
+            return parsed;
+        }
+        rawYaml = null;
+        return { name: 'Aalis', logLevel: 'info', plugins: {} };
+    }
+    const initialConfig = loadFromDisk();
+    const provider = {
+        save(config) {
+            const yaml = buildSaveYaml(config, rawYaml);
+            lastWrittenYaml = yaml;
+            writeFileSync(absPath, yaml, 'utf-8');
+            rawYaml = yaml;
+        },
+        watch(onChange) {
+            if (watcher)
+                return () => { };
+            if (!existsSync(absPath))
+                return () => { };
+            try {
+                watcher = fsWatch(absPath, () => {
+                    if (debounceTimer)
+                        clearTimeout(debounceTimer);
+                    debounceTimer = setTimeout(() => {
+                        debounceTimer = null;
+                        try {
+                            const current = readFileSync(absPath, 'utf-8');
+                            if (lastWrittenYaml !== null && current === lastWrittenYaml)
+                                return;
+                            lastWrittenYaml = null;
+                            rawYaml = current;
+                            const interpolated = interpolateEnvVars(current);
+                            const parsed = (parseYaml(interpolated) ?? {});
+                            onChange(parsed);
+                        }
+                        catch {
+                            /* 文件可能被部分写入，忽略 */
+                        }
+                    }, 300);
+                });
+            }
+            catch {
+                /* 平台不支持 watch */
+            }
+            return () => {
+                if (debounceTimer) {
+                    clearTimeout(debounceTimer);
+                    debounceTimer = null;
+                }
+                watcher?.close();
+                watcher = null;
+            };
+        },
+    };
+    return { config: initialConfig, provider, dataDir };
+}
+// ============================================================
+// FsPluginLoader —— 扫描目录 + dynamic import
+// ============================================================
+/**
+ * 创建一个基于 packages 目录扫描的 PluginLoader。
+ *
+ * - `discover()`：读 dir 下每个子目录的 package.json，按 `aalis.{core,client,types}` 标记过滤
+ * - `load()`：用 `pathToFileURL(entry).href` 动态 import
+ * - `reload()`：用入口文件 mtime 作为 import URL 的 query 强制 ESM 缓存失效
+ */
+export function createFsPluginLoader(packagesDir) {
+    const rootDir = packagesDir ?? resolve(process.cwd(), 'packages');
+    return {
+        async discover() {
+            let entries;
+            try {
+                const dirents = await readdir(rootDir, { withFileTypes: true });
+                entries = dirents.filter(d => d.isDirectory() || d.isSymbolicLink()).map(d => d.name);
+            }
+            catch {
+                return [];
+            }
+            const discovered = [];
+            for (const entry of entries) {
+                const pkgJsonPath = resolve(rootDir, entry, 'package.json');
+                let pkgJson;
+                try {
+                    pkgJson = JSON.parse(readFileSync(pkgJsonPath, 'utf-8'));
+                }
+                catch {
+                    continue;
+                }
+                const aalisMeta = pkgJson.aalis;
+                if (aalisMeta?.core || aalisMeta?.client || aalisMeta?.types || aalisMeta?.tooling)
+                    continue;
+                const main = pkgJson.main || 'dist/index.js';
+                discovered.push({
+                    name: pkgJson.name,
+                    source: resolve(rootDir, entry, main),
+                    metadata: { dir: resolve(rootDir, entry) },
+                });
+            }
+            return discovered;
+        },
+        async load(desc) {
+            const mod = (await import(pathToFileURL(desc.source).href));
+            return mod;
+        },
+        async reload(desc) {
+            let cacheKey = '';
+            try {
+                cacheKey = `?t=${(await stat(desc.source)).mtimeMs}`;
+            }
+            catch {
+                /* stat 失败时用空 key，让 import 自己报错 */
+            }
+            const mod = (await import(pathToFileURL(desc.source).href + cacheKey));
+            return mod;
+        },
+    };
+}
+// ============================================================
+// ProcessRespawnStrategy —— spawn 新 Node 进程然后退出当前
+// ============================================================
+/**
+ * Node 进程重启策略：spawn 一个 detached 子进程沿用当前 argv，然后 `process.exit(0)`。
+ *
+ * 时序：
+ * 1. 等 500ms 让正在飞行的 HTTP/WS 响应有机会先返回客户端
+ * 2. 调 `stop()` 优雅停掉当前 App（关闭网关、断开适配器等）
+ * 3. spawn 新进程 + `process.exit(0)`
+ *
+ * 对 .ts 入口（开发模式）会优先使用本地 `tsx` 二进制。
+ */
+export function createProcessRespawnStrategy() {
+    return {
+        async restart({ stop }) {
+            await new Promise(resolve => setTimeout(resolve, 500));
+            await stop();
+            const scriptFile = process.argv[1];
+            let exec;
+            let args;
+            if (scriptFile?.endsWith('.ts')) {
+                const tsxBin = resolve(process.cwd(), 'node_modules', '.bin', 'tsx');
+                exec = existsSync(tsxBin) ? tsxBin : 'tsx';
+                args = process.argv.slice(1);
+            }
+            else {
+                [exec, ...args] = process.argv;
+            }
+            const child = spawn(exec, args, {
+                cwd: process.cwd(),
+                stdio: 'inherit',
+                detached: true,
+                env: process.env,
+            });
+            child.unref();
+            process.exit(0);
+        },
+    };
+}
+//# sourceMappingURL=providers.js.map

package/dist/providers.js.map

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

package/dist/start.d.ts

@@ -0,0 +1,15 @@
+import { App } from '@aalis/core';
+export interface StartAalisOptions {
+    /** aalis.config.yaml 路径，默认 cwd 下的 aalis.config.yaml */
+    configPath?: string;
+    /** 项目根目录（含 package.json + node_modules），默认 process.cwd() */
+    projectDir?: string;
+    /** 应用层声明的必需服务（缺失则启动告警），默认空 */
+    requiredServices?: string[];
+}
+/**
+ * 启动一个独立部署的 Aalis 实例：YAML 配置 + node_modules 插件加载 + 进程级重启。
+ * 返回已启动的 App（便于测试或进一步操作）。
+ */
+export declare function startAalis(opts?: StartAalisOptions): Promise<App>;
+//# sourceMappingURL=start.d.ts.map

package/dist/start.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.d.ts","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAalC,MAAM,WAAW,iBAAiB;IAChC,uDAAuD;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,8BAA8B;IAC9B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAsB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,GAAG,CAAC,CA4B3E"}

package/dist/start.js

@@ -0,0 +1,34 @@
+import { App } from '@aalis/core';
+import { createNodeModulesPluginLoader } from './node-modules-loader.js';
+import { createFsYamlConfigProvider, createProcessRespawnStrategy } from './providers.js';
+/**
+ * 启动一个独立部署的 Aalis 实例：YAML 配置 + node_modules 插件加载 + 进程级重启。
+ * 返回已启动的 App（便于测试或进一步操作）。
+ */
+export async function startAalis(opts = {}) {
+    const { config, provider, dataDir } = createFsYamlConfigProvider(opts.configPath);
+    const app = new App({
+        config,
+        configProvider: provider,
+        dataDir,
+        pluginLoader: createNodeModulesPluginLoader(opts.projectDir),
+        restartStrategy: createProcessRespawnStrategy(),
+        // 宿主层决定 dev/prod；core 不读 process.env
+        devMode: process.env.NODE_ENV !== 'production',
+        requiredServices: opts.requiredServices ?? [],
+    });
+    await app.autoLoadPlugins();
+    await app.start();
+    let stopping = false;
+    const shutdown = async () => {
+        if (stopping)
+            return;
+        stopping = true;
+        await app.stop();
+        process.exit(0);
+    };
+    process.on('SIGINT', shutdown);
+    process.on('SIGTERM', shutdown);
+    return app;
+}
+//# sourceMappingURL=start.js.map

package/dist/start.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"start.js","sourceRoot":"","sources":["../src/start.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,aAAa,CAAC;AAClC,OAAO,EAAE,6BAA6B,EAAE,MAAM,0BAA0B,CAAC;AACzE,OAAO,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAoB1F;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,OAA0B,EAAE;IAC3D,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,EAAE,GAAG,0BAA0B,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IAElF,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC;QAClB,MAAM;QACN,cAAc,EAAE,QAAQ;QACxB,OAAO;QACP,YAAY,EAAE,6BAA6B,CAAC,IAAI,CAAC,UAAU,CAAC;QAC5D,eAAe,EAAE,4BAA4B,EAAE;QAC/C,qCAAqC;QACrC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY;QAC9C,gBAAgB,EAAE,IAAI,CAAC,gBAAgB,IAAI,EAAE;KAC9C,CAAC,CAAC;IAEH,MAAM,GAAG,CAAC,eAAe,EAAE,CAAC;IAC5B,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;IAElB,IAAI,QAAQ,GAAG,KAAK,CAAC;IACrB,MAAM,QAAQ,GAAG,KAAK,IAAI,EAAE;QAC1B,IAAI,QAAQ;YAAE,OAAO;QACrB,QAAQ,GAAG,IAAI,CAAC;QAChB,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC,CAAC;IACF,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;IAEhC,OAAO,GAAG,CAAC;AACb,CAAC"}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "@aalis/runtime",
+  "version": "0.1.1",
+  "license": "MIT",
+  "type": "module",
+  "description": "Aalis 独立部署运行时：node_modules 插件加载 + YAML 配置 + 一行启动 startAalis",
+  "keywords": [
+    "aalis",
+    "aalis-runtime"
+  ],
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "yaml": "^2.7.0"
+  },
+  "peerDependencies": {
+    "@aalis/core": "^0.1.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@types/node": "^22.0.0",
+    "@aalis/core": "0.1.1"
+  },
+  "aalis": {
+    "tooling": true
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch"
+  }
+}